Shape Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

GuidAttribute

Remarques

L’objet Shape est un membre de la Shapes collection, qui inclut toutes les formes de l’histoire main d’un document ou dans 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 l’ancre.

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 des formes un et quatre sur le document, ou il peut représenter toutes les formes sélectionnées sur le document) ; l’objet Shape , qui représente une forme unique sur 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 propriété .

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 du 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)AddShape(Int32, Single, Single, Single, Single, Object)AddPolyline(Object, Object)AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, 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 du groupe, pour renvoyer un objet Shape qui représente une forme unique dans une forme groupée.

Utilisez la Group() méthode ou Regroup() pour regrouper une plage de formes et renvoyer un seul Shape objet qui représente le groupe nouvellement formé. 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’ancre elle-même en définissant la ShowObjectAnchors propriété sur True. Les propriétés et Left de la Top forme déterminent ses positions verticales et horizontales. Les propriétés et RelativeVerticalPosition de la RelativeHorizontalPosition forme 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’ancre de sa position sur la page.

Utilisez la Fill propriété pour renvoyer l’objet FillFormat , qui contient toutes les propriétés et méthodes permettant de mettre en forme le remplissage d’une forme fermée. La Shadow propriété retourne l’objet ShadowFormat que vous utilisez pour mettre en forme une ombre. Utilisez la Line propriété pour renvoyer l’objet LineFormat , qui contient des propriétés et des méthodes pour la mise en forme des lignes et des flèches. La TextEffect propriété renvoie l’objet TextEffectFormat que vous utilisez pour mettre en forme WordArt. La Callout propriété renvoie l’objet CalloutFormat que vous utilisez pour mettre en forme les légendes de ligne. La WrapFormat propriété renvoie l’objet WrapFormat , que vous utilisez pour définir la façon dont le texte s’enroule autour des formes. La ThreeD propriété renvoie l’objet ThreeDFormat que vous utilisez pour créer des formes 3D. Vous pouvez utiliser les méthodes et Apply() pour transférer la PickUp() 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 du 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, pour instance. Utilisez la AutoShapeType propriété pour spécifier le type de forme automatique : ovale, rectangle ou bulle, pour instance.

Utilisez les Width propriétés et Height pour spécifier la taille de la forme.

La TextFrame propriété renvoie l’objet TextFrame , 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.

Shape Les objets sont ancrés à une plage de texte, mais ils sont flottants et peuvent être positionnés n’importe où sur la page. InlineShape Les objets sont traités comme des caractères et sont positionnés en tant que caractères 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 des valeurs d’ajustement pour tous les ajustements dans l’objet spécifié Shape 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 objet qui représente la plage d’ancrage de la forme spécifiée.
AnchorID	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.
Application	Renvoie un Application objet qui représente l’application Microsoft Word.
AutoShapeType	Cette propriété renvoie ou définit le type de forme de l’objet spécifié Shape , qui doit représenter une forme automatique autre qu’un dessin de trait ou de 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 des propriétés de mise en forme de légende pour la forme spécifiée.
CanvasItems	Renvoie un CanvasShapes objet qui représente une collection de formes dans un canevas de dessin.
Chart	Renvoie un Chart objet qui représente un graphique dans la collection de formes d’un document. En lecture seule.
Child	Détermine si la forme est une forme enfant.
ConnectionSiteCount	Réservé à une utilisation interne.
Connector	Réservé à une utilisation interne.
ConnectorFormat	Réservé à une utilisation interne.
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé.
Diagram	Retourne 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	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.
Fill	Renvoie un FillFormat objet qui contient des propriétés de mise en forme de remplissage pour la forme spécifiée.
Glow	Renvoie un GlowFormat objet qui représente la mise en forme de l’éclat d’une forme. En lecture seule.
GroupItems	Renvoie un GroupShapes objet qui représente les formes individuelles du 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	Obtient True si un diagramme SmartArt est présent sur la forme.
Height	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. Lecture-écriture.
HorizontalFlip	Indique qu'une forme a été retournée horizontalement.
Hyperlink	Renvoie un Hyperlink objet qui représente le lien hypertexte associé à la forme spécifiée.
ID	Retourne le type de l’objet spécifié.
LayoutInCell	Renvoie un entier qui indique si une forme d’un tableau est affichée à l’intérieur ou à l’extérieur de la table.
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. Lecture-écriture.
Line	Renvoie un LineFormat objet qui contient des propriétés de mise en forme de ligne pour la forme spécifiée.
LinkFormat	Renvoie un LinkFormat objet qui représente les options de lien de la forme spécifiée liée à un fichier.
LockAnchor	Détermine si l’ancre de l’objet spécifié Shape est verrouillée à la plage d’ancrage.
LockAspectRatio	Détermine si vous pouvez modifier la hauteur et la largeur de la forme indépendamment les unes des autres lorsque vous la redimensionnez ou si 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 objet qui représente les caractéristiques OLE (autres que la liaison) pour 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 objet qui représente la forme parente commune d’une forme enfant.
PictureFormat	Renvoie un PictureFormat objet qui contient des propriétés de mise en forme d’image pour l’objet spécifié.
Reflection	Renvoie un ReflectionFormat objet qui représente la mise en forme de réflexion d’une forme. En lecture seule.
RelativeHorizontalPosition	Spécifie à quelle position horizontale d’une forme est relative.
RelativeHorizontalSize	Renvoie ou définit une WdRelativeHorizontalSize constante qui représente l’objet auquel une plage de formes est relative. Lecture-écriture.
RelativeVerticalPosition	Spécifie la position verticale d’une forme relative.
RelativeVerticalSize	Renvoie ou définit une WdRelativeVerticalSize constante qui représente la taille verticale relative d’une forme. 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 objet qui représente la mise en forme de l’ombre pour 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 d’utiliser l’objet SmartArt associé à la forme spécifiée.
SoftEdge	Renvoie un SoftEdgeFormat objet qui représente la mise en forme des bords souples d’une forme. En lecture seule.
TextEffect	Renvoie un TextEffectFormat objet qui contient des propriétés de mise en forme d’effet de texte pour 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 tridimensionnel pour la forme spécifiée.
Title	Obtient ou définit une chaîne qui contient un titre pour la forme spécifiée.
Top	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. Lecture-écriture.
Type	Renvoie le type de forme.
VerticalFlip	Détermine si la forme spécifiée est retournée autour de 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. Lecture-écriture.
WrapFormat	Renvoie un WrapFormat objet qui contient les propriétés permettant d’encapsuler le 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 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()	Crée un doublon de l’objet spécifié Shape , ajoute la nouvelle plage de formes à la Shapes collection à un décalage standard par rapport aux formes d’origine, puis retourne 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).