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

S’applique à