Shape 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.
Représente un objet dans la couche dessin, comme une forme automatique, une forme libre, un objet OLE, un contrôle ActiveX ou une image.
public interface class Shape
[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape
type Shape = interface
Public Interface Shape
- Attributs
Remarques
L' Shape objet est un membre de la Shapes collection, qui inclut toutes les formes dans l’article principal d’un document ou tous les en-têtes et pieds de page d’un document.
Une forme est toujours attachée à une plage d’ancrage. Vous pouvez positionner la forme n’importe où sur la page qui contient le point d’ancrage.
Il existe trois objets qui représentent des formes : la Shapes collection, qui représente toutes les formes d’un document ; la ShapeRange collection, qui représente un sous-ensemble spécifié des formes d’un document (par exemple, un ShapeRange objet peut représenter les formes un et quatre du document, ou il peut représenter toutes les formes sélectionnées dans le document); Shape objet, qui représente une seule forme d’un document. Si vous souhaitez travailler avec plusieurs formes en même temps ou avec des formes dans la sélection, utilisez une ShapeRange collection.
Utilisez Shapes( index ), où index est le nom ou le numéro d’index, pour renvoyer un seul Shape objet.
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 .
Utilisez Selection. ShapeRange( index ), où index est le nom ou le numéro d’index, pour renvoyer un Shape objet qui représente une forme dans une sélection.
Pour ajouter un Shape objet à la collection de formes pour le document spécifié et renvoyer un Shape objet qui représente la forme nouvellement créée, utilisez l’une des méthodes suivantes de la Shapes collection : 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) .
Utilisez GroupItems( index ), où index est le nom de la forme ou le numéro d’index au sein du groupe, pour renvoyer un objet Shape qui représente une seule forme d’une forme groupée.
Utilisez la Group() Regroup() méthode ou pour regrouper une plage de formes et renvoyer un seul Shape objet qui représente le groupe nouvellement constitué. Une fois un groupe a été créé, vous pouvez travailler avec le groupe de la même façon que vous travaillez avec n'importe quel autre forme.
Chaque Shape objet est ancré à une plage de texte. Une forme est ancrée au début du premier paragraphe contenant la plage d'ancrage. Une forme se trouve toujours sur la page contenant son ancrage.
Vous pouvez afficher l’ancrage proprement dit en définissant la ShowObjectAnchors propriété sur true. Les propriétés de la forme Top Left déterminent ses positions verticales et horizontales. Les propriétés et de la forme RelativeHorizontalPosition RelativeVerticalPosition déterminent si la position est mesurée à partir du paragraphe d’ancrage, de la colonne qui contient le paragraphe d’ancrage, de la marge ou du bord de la page.
Si la LockAnchor propriété de la forme est définie sur true, vous ne pouvez pas faire glisser l’ancrage à partir de sa position sur la page.
Utilisez la Fill propriété pour renvoyer l' FillFormat objet, qui contient toutes les propriétés et méthodes de mise en forme du remplissage d’une forme fermée. La Shadow propriété renvoie l' ShadowFormat objet que vous utilisez pour mettre en forme une ombre. Utilisez la Line propriété pour renvoyer l' LineFormat objet, qui contient les propriétés et les méthodes de mise en forme des lignes et des flèches. La TextEffect propriété renvoie l' TextEffectFormat objet que vous utilisez pour mettre en forme un objet WordArt. La Callout propriété renvoie l' CalloutFormat objet que vous utilisez pour mettre en forme les légendes de lignes. La WrapFormat propriété renvoie l' WrapFormat objet que vous utilisez pour définir l’habillage de texte autour des formes. La ThreeD propriété renvoie l' ThreeDFormat objet que vous utilisez pour créer des formes 3D. Vous pouvez utiliser les PickUp() Apply() méthodes et pour transférer la mise en forme d’une forme à une autre.
Utilisez la SetShapesDefaultProperties() méthode d’un Shape objet pour définir la mise en forme de la forme par défaut pour le document. Les nouvelles formes reçoivent un grand nombre des attributs de la forme par défaut.
Utilisez la Type propriété pour spécifier le type de forme : forme libre, forme automatique, objet OLE, légende ou image liée, par exemple. Utilisez la AutoShapeType propriété pour spécifier le type de forme automatique : ovale, Rectangle ou bulle, par exemple.
Utilisez les Width Height Propriétés et pour spécifier la taille de la forme.
La TextFrame propriété renvoie l' TextFrame objet qui contient toutes les propriétés et méthodes permettant d’attacher du texte à des formes et de lier le texte entre les cadres de texte.
Shapeles objets sont ancrés à une plage de texte mais sont flottants et peuvent être placés n’importe où sur la page. InlineShapeles objets sont traités comme des caractères et, en tant que tels, placés dans une ligne de texte. Vous pouvez utiliser la ConvertToInlineShape() méthode et la ConvertToShape() 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.
Propriétés
| Adjustments |
Renvoie un Adjustments objet qui contient les valeurs d’ajustement pour tous les ajustements dans l' Shape objet spécifié qui représente une forme automatique ou un objet WordArt. |
| AlternativeText |
Cette propriété renvoie ou définit le texte de remplacement associé à une forme dans une page Web. |
| Anchor |
Renvoie un Range Object qui représente la plage d’ancrage de la forme spécifiée. |
| AnchorID | |
| Application |
Renvoie un Application Object qui représente l’application Microsoft Word. |
| AutoShapeType |
Cette propriété renvoie ou définit le type de forme pour l' Shape objet spécifié, qui doit représenter une forme automatique autre qu’un trait ou une forme libre. |
| BackgroundStyle |
Obtient ou définit le style d’arrière-plan de la forme spécifiée. |
| Callout |
Renvoie un CalloutFormat objet qui contient les propriétés de mise en forme de la légende pour la forme spécifiée. |
| CanvasItems |
Renvoie un CanvasShapes Object qui représente une collection de formes dans une zone de dessin. |
| Chart |
Renvoie un Chart objet qui représente un graphique dans la collection de formes dans un document. En lecture seule. |
| Child |
Détermine si la forme est une forme enfant. |
| ConnectionSiteCount |
Réservé à un usage interne. |
| Connector |
Réservé à un usage interne. |
| ConnectorFormat |
Réservé à un usage interne. |
| Creator |
Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé. |
| Diagram |
Renvoie un Diagram objet auquel appartient un nœud de diagramme. |
| DiagramNode |
Renvoie un DiagramNode objet qui représente un nœud dans un diagramme. |
| EditID | |
| Fill |
Renvoie un FillFormat objet qui contient les propriétés de mise en forme du remplissage pour la forme spécifiée. |
| Glow |
Renvoie un GlowFormat Object qui représente la mise en forme de la lumière pour une forme. En lecture seule. |
| GroupItems |
Renvoie un GroupShapes Object qui représente les formes individuelles dans le groupe spécifié. |
| HasChart |
True si la forme spécifiée est un graphique. En lecture seule. |
| HasDiagram |
Détermine si une forme est un diagramme. |
| HasDiagramNode |
Détermine si une forme est un nœud de diagramme. |
| HasSmartArt |
Renvoie la valeur true si un diagramme SmartArt est présent sur la forme. |
| Height |
Cette propriété renvoie ou définit la hauteur de la forme spécifiée en points. |
| HeightRelative |
Cette propriété renvoie ou définit une valeur unique qui représente le pourcentage de la hauteur relative d’une forme. En lecture/écriture |
| HorizontalFlip |
Indique qu'une forme a été retournée horizontalement. |
| Hyperlink |
Renvoie un Hyperlink Object qui représente le lien hypertexte associé à la forme spécifiée. |
| ID |
Renvoie le type de l’objet spécifié. |
| LayoutInCell |
Renvoie un entier qui indique si une forme dans un tableau s’affiche à l’intérieur ou à l’extérieur du tableau. |
| Left |
Cette propriété renvoie ou définit une valeur unique qui représente la position horizontale, exprimée en points, de la forme spécifiée ou d'une plage de formes. |
| LeftRelative |
Cette propriété renvoie ou définit une valeur unique qui représente la position gauche relative d’une forme. En lecture/écriture |
| Line |
Renvoie un LineFormat objet qui contient les propriétés de mise en forme du trait pour la forme spécifiée. |
| LinkFormat |
Renvoie un LinkFormat Object qui représente les options de liaison de la forme spécifiée liée à un fichier. |
| LockAnchor |
Détermine si l' Shape ancrage de l’objet spécifié est verrouillé à la plage d’ancrage. |
| LockAspectRatio |
Détermine si vous pouvez modifier la hauteur et la largeur de la forme indépendamment l’une de l’autre lorsque vous la redimensionnez ou qu’elle conserve ses proportions d’origine. |
| Name |
Cette propriété renvoie ou définit le nom de l'objet spécifié. |
| Nodes |
Renvoie une ShapeNodes collection qui représente la description géométrique de la forme spécifiée. |
| OLEFormat |
Renvoie un OLEFormat Object qui représente les caractéristiques OLE (autres que la liaison) de la forme spécifiée. |
| Parent |
Cette propriété renvoie un objet qui représente l'objet parent de l'objet spécifié. |
| ParentGroup |
Renvoie un Shape Object qui représente la forme parente commune d’une forme enfant. |
| PictureFormat |
Renvoie un PictureFormat objet qui contient les propriétés de mise en forme de l’objet spécifié. |
| Reflection |
Renvoie un ReflectionFormat Object qui représente la mise en forme de la réflexion pour une forme. En lecture seule. |
| RelativeHorizontalPosition |
Indique la position horizontale d’une forme par rapport. |
| RelativeHorizontalSize |
Cette propriété renvoie ou définit une WdRelativeHorizontalSize constante qui représente l’objet auquel une plage de formes est relative. En lecture/écriture |
| RelativeVerticalPosition |
Indique la position verticale d’une forme par rapport. |
| RelativeVerticalSize |
Cette propriété renvoie ou définit une WdRelativeVerticalSize constante qui représente la taille verticale relative d’une forme. En lecture/écriture |
| Rotation |
Cette propriété renvoie ou définit le nombre de degrés de que rotation de la forme spécifiée autour de l'axe z. |
| RTF |
Réservé à une utilisation interne. |
| Script |
Renvoie un Script objet qui représente un bloc de script ou de code sur la page Web spécifiée. |
| Shadow |
Renvoie un ShadowFormat Object qui représente la mise en forme de l’ombre de la forme spécifiée. |
| ShapeStyle |
Obtient ou définit le style de forme de la forme spécifiée. |
| SmartArt |
Obtient un SmartArt objet qui fournit un moyen de travailler avec le SmartArt associé à la forme spécifiée. |
| SoftEdge |
Renvoie un SoftEdgeFormat Object qui représente la mise en forme de bordure arrondie d’une forme. En lecture seule. |
| TextEffect |
Renvoie un TextEffectFormat objet qui contient les propriétés de mise en forme des effets de texte de la forme spécifiée. |
| TextFrame |
Renvoie un TextFrame objet qui contient le texte de la forme spécifiée. |
| TextFrame2 |
Renvoie un TextFrame2 objet qui contient le texte de la forme spécifiée. En lecture seule. |
| ThreeD |
Renvoie un ThreeDFormat objet qui contient les propriétés de mise en forme de l’effet 3D appliqué à la forme spécifiée. |
| Title |
Obtient ou définit une chaîne qui contient un titre pour la forme spécifiée. |
| Top |
Cette propriété renvoie ou définit la position verticale de la forme spécifiée en points. |
| TopRelative |
Cette propriété renvoie ou définit une valeur unique qui représente la position supérieure relative d'une forme. En lecture-écriture. |
| Type |
Renvoie le type de forme. |
| VerticalFlip |
Détermine si la forme spécifiée est retournée par rapport à l’axe vertical. |
| Vertices |
Renvoie les coordonnées des sommets du dessin de la forme libre spécifiée (et les points de contrôle pour les courbes de Bézier) sous forme de paires de coordonnées. |
| Visible |
Détermine si l’objet spécifié, ou la mise en forme qui lui est appliquée, est visible. |
| Width |
Renvoie ou définit la largeur de l’objet spécifié, en points. |
| WidthRelative |
Renvoie ou définit une valeur de type Single qui représente la largeur relative d'une forme. En lecture/écriture |
| WrapFormat |
Renvoie un WrapFormat objet qui contient les propriétés d’habillage du texte autour de la forme spécifiée. |
| ZOrderPosition |
Cette propriété renvoie la position de la forme spécifiée dans l'ordre de superposition. |
Méthodes
| Activate() |
Active l'objet spécifié. |
| Apply() |
S’applique à la mise en forme de la forme spécifiée qui a été copiée à l’aide de la PickUp() méthode. |
| CanvasCropBottom(Single) |
Rogne un pourcentage de la hauteur d'une zone de dessin à partir du bas du dessin. |
| CanvasCropLeft(Single) |
Rogne un pourcentage de la largeur d'une zone de dessin à partir du côté gauche du dessin. |
| CanvasCropRight(Single) |
Rogne un pourcentage de la largeur d'une zone de dessin à partir du côté droit du dessin. |
| CanvasCropTop(Single) |
Rogne un pourcentage de la hauteur d'une zone de dessin à partir du haut du dessin. |
| ConvertToFrame() |
Convertit la forme spécifiée en cadre. |
| ConvertToInlineShape() |
Convertit la forme spécifiée de la couche de dessin d'un document en forme insérée dans la couche de texte. |
| Delete() |
Cette méthode supprime l'objet spécifié. |
| Duplicate() |
Cette méthode crée une copie de l' Shape objet spécifié, ajoute la nouvelle plage de formes à la Shapes collection à un décalage standard par rapport aux formes d’origine, puis renvoie le nouvel objet Shape . |
| Flip(MsoFlipCmd) |
Fait pivoter une forme à l'horizontale ou à la verticale. |
| IncrementLeft(Single) |
Déplace horizontalement la forme spécifiée selon le nombre de points indiqué. |
| IncrementRotation(Single) |
Cette méthode modifie la rotation de la forme spécifiée autour de l’axe z selon le nombre de degrés spécifiés. |
| IncrementTop(Single) |
Décale vers le haut la forme spécifiée selon le nombre de points spécifié. |
| PickUp() |
Copie la mise en forme de la forme indiquée. |
| RerouteConnections() |
Réservé à une utilisation interne. |
| ScaleHeight(Single, MsoTriState, MsoScaleFrom) |
Met la hauteur de la forme à l’échelle en utilisant un facteur spécifié. |
| ScaleWidth(Single, MsoTriState, MsoScaleFrom) |
Met la largeur de la forme à l’échelle en utilisant un facteur spécifié. |
| Select(Object) |
Sélectionne l'objet spécifié. |
| SetShapesDefaultProperties() |
Applique la mise en forme de la forme spécifiée à une forme par défaut pour ce document. Les nouvelles formes reçoivent un grand nombre des attributs de la forme par défaut. |
| Ungroup() |
Dissocie toutes les formes groupées dans la forme spécifiée. |
| ZOrder(MsoZOrderCmd) |
Déplace la forme spécifiée devant ou derrière les autres formes dans la collection de (autrement dit, modifie position de la forme dans l’ordre z). |