Shapes Interface

Référence

Définition

Espace de noms:: Microsoft.Office.Interop.Word

Assembly:: Microsoft.Office.Interop.Word.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Collection d’objets Shape qui représentent toutes les formes d’un document ou toutes les formes de tous les en-têtes et pieds de page d’un document.

public interface class Shapes : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("0002099F-0000-0000-C000-000000000046")]
public interface Shapes : System.Collections.IEnumerable

type Shapes = interface
    interface IEnumerable

Public Interface Shapes
Implements IEnumerable

Attributs: GuidAttribute

Implémente: IEnumerable

Remarques

Chaque objet Shape représente un objet dans la couche dessin, comme une forme automatique, une forme libre, un objet OLE ou une image.

Note Si vous souhaitez travailler avec un sous-ensemble des formes d’un document, par exemple, pour effectuer une opération uniquement sur les formes automatiques du document ou uniquement sur les formes sélectionnées, vous devez construire une ShapeRange collection qui contient les formes que vous souhaitez utiliser.

Utilisez la Shapes propriété pour renvoyer la collection Shapes .

Note Si vous souhaitez effectuer une opération (par exemple supprimer ou définir une propriété) sur toutes les formes d’un document en même temps, utilisez la Range(Object) méthode pour créer un objet ShapeRange qui contient toutes les formes de la collection Shapes , puis appliquez la propriété ou la méthode appropriée à l’objet ShapeRange .

Utilisez l’une des méthodes suivantes de la collection Shapes : AddCallout(MsoCalloutType, Single, Single, Single, Single, Object), AddCurve(Object, Object), AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object), AddOLEControl(Object, Object, Object, Object, Object, Object)AddPolyline(Object, Object)AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)AddShape(Int32, Single, Single, Single, Single, Object)AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)AddLine(Single, Single, Single, Single, Object)ou BuildFreeform(MsoEditingType, Single, Single) pour ajouter une forme à un document et renvoyer un objet Shape qui représente la forme nouvellement créée.

Utilisez Shapes(index), où index est le nom ou le numéro d’index, pour renvoyer un seul objet Shape .

Chaque forme reçoit un nom par défaut lors de sa création. Par exemple, si vous ajoutez trois formes différentes à un document, elles peuvent être nommées « Rectangle 2 », « TextBox 3 » et « Ovale 4 ». Pour donner à une forme un nom plus explicite, définissez la Name propriété .

La collection Shapes n’inclut pas d’objets InlineShape . Les objets InlineShape sont traités comme des caractères et, en tant que tels, insérés dans une ligne de texte. Les objets Shape sont ancrés à une plage de texte mais sont flottants et peuvent être placés n'importe où sur la page. Vous pouvez utiliser la ConvertToInlineShape() méthode et la ConvertToShape(Object) méthode pour convertir des formes d’un type à l’autre. Seuls les objets OLE, les images et les contrôles ActiveX peuvent être convertis en formes insérées.

La Count propriété de cette collection dans un document renvoie uniquement le nombre d’éléments dans l’article main. Pour compter les formes dans tous les en-têtes et pieds de page, utilisez la collection Shapes avec n’importe quel HeaderFooter objet.

Propriétés

Application	Renvoie un Application objet qui représente l’application Microsoft Word.
Count	Retourne le nombre d’éléments dans la collection spécifiée.
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé.
Item[Object]	Renvoie un objet spécifique appartenant à une collection.
Parent	Cette propriété renvoie un objet qui représente l'objet parent de l'objet spécifié.

Méthodes

AddCallout(MsoCalloutType, Single, Single, Single, Single, Object)	Ajoute une légende de ligne sans bordure à un document. Renvoie un Shape objet qui représente la légende et l’ajoute à la Shapes collection.
AddCanvas(Single, Single, Single, Single, Object)	Ajoute une zone de dessin à un document. Renvoie un Shape objet qui représente la zone de dessin et l’ajoute à la Shapes collection.
AddChart(XlChartType, Object, Object, Object, Object, Object)	Cet objet, ce membre ou cette énumération est déconseillé et n’est pas destiné à être utilisé dans votre code.
AddChart2(Int32, XlChartType, Object, Object, Object, Object, Object, Object)	Ajoute un graphique au document. Renvoie un Shape objet qui représente un graphique et l’ajoute à la collection spécifiée.
AddConnector(MsoConnectorType, Single, Single, Single, Single)	Réservé à une utilisation interne.
AddCurve(Object, Object)	Renvoie un Shape objet qui représente une courbe de Bézier dans un document.
AddDiagram(MsoDiagramType, Single, Single, Single, Single, Object)	Renvoie un Shape objet qui représente un diagramme nouvellement créé dans un document.
AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object)	Ajoute une étiquette de texte à un document. Renvoie un Shape objet qui représente l’étiquette de texte et l’ajoute à la Shapes collection.
AddLine(Single, Single, Single, Single, Object)	Ajoute une ligne à un document. Renvoie un Shape objet qui représente la ligne et l’ajoute à la AddCallout(MsoCalloutType, Single, Single, Single, Single, Object) collection.
AddOLEControl(Object, Object, Object, Object, Object, Object)	Crée un contrôle ActiveX (anciennement contrôle OLE). Renvoie l’objet Shape qui représente le nouveau contrôle ActiveX.
AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Crée un objet OLE. Renvoie l’objet Shape qui représente le nouvel objet OLE.
AddPicture(String, Object, Object, Object, Object, Object, Object, Object)	Ajoute une image à un document. Renvoie un Shape objet qui représente l’image et l’ajoute à la Shapes collection.
AddPolyline(Object, Object)	Ajoute un polygone ouvert ou fermé à un document. Renvoie un Shape objet qui représente le polygone et l’ajoute à la Shapes collection.
AddShape(Int32, Single, Single, Single, Single, Object)	Ajoute une forme automatique à un document. Renvoie un Shape objet qui représente la forme automatique et l’ajoute à la Shapes collection.
AddSmartArt(SmartArtLayout, Object, Object, Object, Object, Object)	Insère le graphique SmartArt spécifié dans le document actif.
AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)	Ajoute une zone de texte à un document. Renvoie un Shape objet qui représente la zone de texte et l’ajoute à la Shapes collection.
AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)	Ajoute une forme WordArt à un document. Renvoie un Shape objet qui représente l’objet WordArt et l’ajoute à la Shapes collection.
AddWebVideo(String, Object, Object, Object, Object, Object, Object, Object, Object, Object)	Ajoute une nouvelle vidéo web au document.
BuildFreeform(MsoEditingType, Single, Single)	Crée une forme libre. Renvoie un FreeformBuilder objet qui représente la forme libre au fur et à mesure de sa génération.
GetEnumerator()	Collection d’objets Shape qui représentent toutes les formes d’un document ou toutes les formes de tous les en-têtes et pieds de page d’un document.
Range(Object)	Retourne un ShapeRange objet .
SelectAll()	Sélectionne toutes les formes dans l’article main, dans un canevas ou dans les en-têtes et pieds de page d’un document.

S’applique à