Shape Interface

Définition

Cet objet représente un objet sur le calque de dessin, par exemple une forme automatique, une forme libre, un objet OLE ou une image. L’objet Shape est membre de la Shapes collection. La collection Shapes contient toutes les formes d’une diapositive.

public interface class Shape
[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape
Public Interface Shape
Attributs

Remarques

Trois objets représentent des formes : la collection Shapes, qui représente toutes les formes d’un document ; la collection, qui représente un sous-ensemble spécifié des formes d’un document (par exemple, un objet ShapeRange peut représenter les formes 1 et 4 du document ou toutes les formes sélectionnées sur le document) ; et l’objet Shape, qui représente une seule forme d’un ShapeRange document. Pour utiliser plusieurs formes simultanément ou des formes faisant partie de la sélection, utilisez une collection ShapeRange.

Cette section décrit comment :

  • renvoyer une forme existante ;
  • renvoyer une forme de la sélection.
  • renvoyer les formes attachées aux extrémités d’un connecteur ;
  • renvoyer une nouvelle forme libre ;
  • renvoyer une seule forme au sein d’un groupe ;
  • renvoyer un nouveau groupe de formes ;

Renvoi d’une forme existante

Utilisez Shapes( ), où est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape index qui représente une index forme.

Chaque forme reçoit un nom par défaut lorsque vous l’ajoutez à la collection Shapes. Pour donner à la forme un nom plus significatif, utilisez la Name propriété.

Renvoi d’une forme au sein de la sélection

Utilisez Selection.ShapeRange( ), où est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme index dans la index sélection.

Renvoi des formes attachées aux extrémités d’un connecteur.

Pour renvoyer un objet Shape qui représente l’une des formes attachées par un connecteur, utilisez la BeginConnectedShape ou la EndConnectedShape propriété.

Renvoi d’une nouvelle forme libre

Utilisez les méthodes et les méthodes pour définir la géométrie d’une nouvelle forme libre et utilisez la méthode pour créer la forme libre et renvoyer l’objet Shape qui BuildFreeform(MsoEditingType, Single, Single) AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) la ConvertToShape() représente.

Renvoi d’une seule forme au sein d’un groupe

Utilisez GroupItems( ), où est le nom de la forme ou le numéro d’index dans le groupe, pour renvoyer un objet Shape qui représente une seule forme dans une index forme index groupée.

Renvoi d’un groupe de formes nouvellement constitué

Utilisez la ou méthode pour grouper une plage de formes et renvoyer un seul objet Shape qui Group() Regroup() 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.

Propriétés

Adjustments

Renvoie un Adjustments objet qui contient des valeurs d’ajustement pour tous les ajustements dans la forme spécifiée. En lecture seule.

AlternativeText

Renvoie ou définit la chaîne de texte descriptive (de remplacement) d’un objet lorsque l’objet Shape est enregistré dans une page Web. String en lecture/écriture.

Application

Renvoie un Application objet qui représente l’application Microsoft Excel’application. En lecture seule.

AutoShapeType

Renvoie ou définit le type de forme de l’objet spécifié, qui doit représenter une forme automatique autre qu’un trait, une forme libre ou Shape un connecteur. En MsoAutoShapeType lecture/écriture.

BackgroundStyle

Cette propriété renvoie ou définit le style d'arrière-plan. En lecture/écriture

BlackWhiteMode

Renvoie ou définit une valeur qui indique comment la forme spécifiée s’affiche lorsque la présentation est affichée en mode noir et blanc. En MsoBlackWhiteMode lecture/écriture.

BottomRightCell

Renvoie un objet qui représente la cellule qui se trouve sous le coin inférieur Range droit de l’objet. En lecture seule.

Callout

Renvoie un objet qui contient les propriétés de mise en forme de CalloutFormat la forme spécifiée. S’applique Shape aux objets qui représentent des traits de ligne. En lecture seule.

CanvasItems

Réservé à un usage interne.

Chart

Renvoie un objet qui représente le _Chart contenu dans Shape le . En lecture seule.

Child

Cette propriété renvoie la valeur msoTrue si la forme spécifiée est une forme enfant ou si toutes les formes contenues dans une plage de formes sont des formes enfants du même parent. En lecture MsoTriState seule.

ConnectionSiteCount

Renvoie le nombre de sites de connexion sur la forme spécifiée. Entier en lecture seule.

Connector

Cette propriété a la valeur True si la forme spécifiée est un connecteur. En lecture MsoTriState seule.

ConnectorFormat

Renvoie un ConnectorFormat objet qui contient les propriétés de mise en forme du connecteur. ShapeS’applique aux objets qui représentent des connecteurs. En lecture seule.

ControlFormat

Renvoie un ControlFormat objet qui contient des propriétés Microsoft Excel contrôle. En lecture seule.

Creator

Renvoie un nombre entier de 32 bits qui indique l’application dans laquelle cet objet a été créé. Si l'objet a été créé dans Microsoft Excel, cette propriété renvoie la chaîne XCEL, qui équivaut au nombre hexadécimal 5843454C. En lecture XlCreator seule.

Diagram

Renvoie un Diagram objet représentant un diagramme.

DiagramNode

Renvoie un DiagramNode objet qui représente un nœud dans un diagramme.

DrawingObject

Réservé à une utilisation interne.

Fill

Renvoie un objet qui contient les propriétés de mise en forme de FillFormat remplissage pour le graphique ou la forme spécifiée. En lecture seule.

FormControlType

Cette propriété renvoie le type de contrôle Microsoft Excel. En lecture XlFormControl seule.

Glow

Renvoie un objet pour une forme spécifiée qui contient les propriétés de mise en forme de lumière pour cette forme. En lecture seule.

GroupItems

Renvoie un GroupShapes objet qui représente les formes individuelles dans le groupe spécifié. Utilisez la Item(Object) méthode de l’objet GroupShapes pour renvoyer une seule forme du groupe. S’applique Shape aux objets qui représentent des formes groupées. En lecture seule.

HasChart

Renvoie des informations sur le cas Shape où un graphique est contenu. En lecture seule.

HasDiagram

Renvoie si une forme ou une plage de formes contient un diagramme. En lecture MsoTriState seule.

HasDiagramNode

Renvoie une valeur indiquant si un nœud de diagramme existe dans une forme ou une plage de formes donnée. En lecture MsoTriState seule.

HasSmartArt

Obtient une indication de présence d’un diagramme SmartArt sur la forme spécifiée.

Height

Hauteur de l’objet. En lecture/écriture unique.

HorizontalFlip

Cette propriété a la valeur True si la forme spécifiée est retournée autour de l'axe horizontal. En lecture MsoTriState seule.

Hyperlink

Renvoie un Hyperlink objet qui représente le lien hypertexte de la forme.

ID

Renvoie le type de l’objet spécifié. Entier en lecture seule.

Left

Distance entre le bord gauche de l’objet et le bord gauche de la colonne A (dans une feuille de calcul) ou le bord gauche de la zone de graphique (sur un graphique). En lecture/écriture unique.

Line

Renvoie un objet qui contient les propriétés de mise en forme LineFormat de trait pour la forme spécifiée. En lecture seule.

LinkFormat

Renvoie un LinkFormat objet qui contient des propriétés d’objet OLE liées. En lecture seule.

LockAspectRatio

Cette propriété renvoie la valeur True si la forme spécifiée conserve ses proportions d'origine lorsque vous la redimensionnez. Elle renvoie la valeur False si vous pouvez modifier la hauteur et la largeur de la forme indépendamment l'une de l'autre lorsque vous la redimensionnez. En MsoTriState lecture/écriture.

Locked

True si l’objet est verrouillé, False si l’objet peut être modifié lorsque la feuille est protégée. Boolean (en lecture/écriture).

Name

Cette propriété renvoie ou définit le nom de l'objet. Type de données String en lecture-écriture.

Nodes

Renvoie une ShapeNodes collection qui représente la description géométrique de la forme spécifiée. ShapeS’applique aux objets qui représentent des dessins de forme libre.

OLEFormat

Renvoie un OLEFormat objet qui contient les propriétés de l’objet OLE. En lecture seule.

OnAction

Renvoie ou définit le nom d’une macro exécutée quand un utilisateur clique sur l’objet spécifié. Type de données String en lecture/écriture.

Parent

Renvoie l'objet parent de l'objet spécifié. En lecture seule.

ParentGroup

Renvoie un objet qui représente la forme parente commune d’une forme enfant ou Shape d’une plage de formes enfants.

PictureFormat

Renvoie un objet qui contient les propriétés de mise en forme PictureFormat d’image pour la forme spécifiée. ShapeS’applique aux objets qui représentent des images ou des objets OLE. En lecture seule.

Placement

Renvoie ou définit la façon dont l’objet est attaché aux cellules en dessous. En XlPlacement lecture/écriture.

Reflection

Renvoie un objet qui contient les propriétés de mise en forme de réflexion pour la forme. En lecture seule.

Rotation

Renvoie ou définit la rotation de la forme en degrés. En lecture/écriture unique.

Script

Cette propriété renvoie l'objet Script qui représente un bloc de script ou de code dans la page Web spécifiée. Si aucun script n'est associé à la page, aucun objet n'est renvoyé.

Shadow

True si l’objet a une ombre. Boolean (en lecture/écriture).

ShapeStyle

Renvoie ou définit une MsoShapeStyleIndex qui représente le style de forme de la forme. En lecture/écriture

SmartArt

Obtient un objet qui représente l’objet SmartArt associé à la forme.

SoftEdge

Renvoie un objet pour une forme spécifiée qui contient les propriétés de mise en forme de bordures SoftEdgeFormat souples pour la forme. En lecture seule.

TextEffect

Renvoie un objet qui contient les propriétés de mise en forme TextEffectFormat d’effet de texte pour la forme spécifiée. S’applique à T:Microsoft.Office. Interop. Excel. Objets Shape qui représentent des objets WordArt. En lecture seule.

TextFrame

Renvoie un TextFrame objet qui contient les propriétés d’alignement et d’ancrage de la forme spécifiée. En lecture seule.

TextFrame2

Renvoie un objet qui contient la mise en forme du texte pour la forme spécifiée. En lecture seule.

ThreeD

Renvoie un objet qui contient des propriétés de mise en forme ThreeDFormat d’effet 3D pour la forme spécifiée. En lecture seule.

Title

Obtient ou définit le titre du texte de remplacement associé à la forme spécifiée.

Top

Distance entre le bord supérieur de la forme la plus haute de la plage de formes et le bord supérieur de la feuille de calcul. En lecture/écriture unique.

TopLeftCell

Renvoie un objet qui représente la cellule qui se trouve sous le coin supérieur gauche Range de l’objet spécifié. En lecture seule.

Type

Renvoie ou définit le type de forme. En lecture MsoShapeType seule.

VerticalFlip

Cette propriété a la valeur True si la forme spécifiée est retournée autour de l’axe vertical. En lecture MsoTriState seule.

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. En lecture seule Object.

Visible

Cette propriété détermine si l'objet est visible. En MsoTriState lecture/écriture.

Width

Largeur de l’objet. En lecture/écriture unique.

ZOrderPosition

Cette propriété renvoie la position de la forme spécifiée dans l'ordre de superposition. Entier en lecture seule.

Méthodes

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)

Réservé à un usage interne.

CanvasCropLeft(Single)

Réservé à un usage interne.

CanvasCropRight(Single)

Réservé à un usage interne.

CanvasCropTop(Single)

Réservé à un usage interne.

Copy()

Copie l'objet dans le Presse-papiers.

CopyPicture(Object, Object)

Copie l'objet sélectionné dans le Presse-papiers, sous forme d'image.

Cut()

Cette méthode coupe l'objet et le place dans le Presse-papiers ou colle l'objet à l'emplacement spécifié.

Delete()

Supprime l'objet.

Duplicate()

Cette méthode duplique l'objet et renvoie une référence à la nouvelle copie.

Flip(MsoFlipCmd)

Cette méthode retourne la forme spécifiée horizontalement ou verticalement.

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. Utilisez la Rotation propriété pour définir la rotation absolue de la forme.

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. Utilisez la Apply() méthode pour appliquer la mise en forme copiée à une autre forme.

RerouteConnections()

Redirige les connecteurs afin qu'ils prennent le chemin le plus court possible entre les formes qu'ils se connectent.

ScaleHeight(Single, MsoTriState, Object)

Met la hauteur de la forme à l’échelle en utilisant un facteur spécifié.

ScaleWidth(Single, MsoTriState, Object)

Met la largeur de la forme à l’échelle en utilisant un facteur spécifié.

Select(Object)

Sélectionne l'objet.

SetShapesDefaultProperties()

Cette méthode fait de la mise en forme de la forme spécifiée la mise en forme par défaut de la forme.

Ungroup()

Dissocie toutes les formes groupées dans la forme ou la plage de formes spécifiée. Désassemble les images et les objets OLE dans la forme spécifiée. Renvoie les formes non groupées sous la forme d’un ShapeRange seul objet.

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 à