Shapes Interface
Définition
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' Shape objets qui représentent toutes les formes d’un document ou 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
- Implémente
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 utiliser un sous-ensemble des formes d’un document (par exemple, pour effectuer une opération uniquement sur les formes automatiques du document ou sur les formes sélectionnées), vous devez créer une ShapeRange collection contenant les formes avec lesquelles vous voulez travailler.
Utilisez la Shapes propriété pour renvoyer la collection Shapes .
Note Si vous souhaitez effectuer une action (par exemple, supprimer ou définir une propriété) sur toutes les formes d’un document simultanément, 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) AddLine(Single, Single, Single, Single, Object) AddOLEControl(Object, Object, Object, Object, Object, Object) AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object) AddPolyline(Object, Object) AddShape(Int32, Single, Single, Single, Single, Object) AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object) AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object) ou BuildFreeform(MsoEditingType, Single, Single) pour ajouter une forme à un document et renvoyer un objet Shape qui représente la nouvelle forme.
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 .
La collection Shapes n’inclut pas d' InlineShape objets. 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 le nombre d’éléments dans l’article principal uniquement. 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 Object qui représente l’application Microsoft Word. |
| Count |
Renvoie 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 sans bordure à un document. Renvoie un Shape Object 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 Object qui représente un nouveau diagramme dans un document. |
| AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object) |
Ajoute une étiquette de texte à un document. Renvoie un Shape Object 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' Shape objet 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' Shape objet 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 Object 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 Object 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 telle qu’elle est créée. |
| GetEnumerator() | |
| Range(Object) |
Renvoie un ShapeRange objet. |
| SelectAll() |
Sélectionne toutes les formes de l’article principal, d’une zone de dessin ou des en-têtes et pieds de page d’un document. |