Partager via


Shape Interface

Définition

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’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).

S’applique à