Shape Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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

GuidAttribute InterfaceTypeAttribute

Remarques

Trois objets représentent des formes : la collection Shapes , 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 objet ShapeRange 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) et l’objet Shape , qui représente une seule forme sur un 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(index), où index est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme.

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

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

Utilisez Selection.ShapeRange(index), où index est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme dans la 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 propriété ou EndConnectedShape .

Renvoi d’une nouvelle forme libre

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

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

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.

Renvoi d’un groupe de formes nouvellement constitué

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

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 (alternative) d’un Shape objet lorsque l’objet est enregistré dans une page Web. String en lecture/écriture.
Application	Renvoie un Application objet qui représente l’application Microsoft Excel. En lecture seule.
AutoShapeType	Renvoie ou définit le type de forme de l’objet spécifié Shape , qui doit représenter une forme automatique autre qu’un trait, un dessin de forme libre ou un connecteur. En lecture/écriture MsoAutoShapeType.
BackgroundStyle	Cette propriété renvoie ou définit le style d'arrière-plan. 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 lecture/écriture MsoBlackWhiteMode.
BottomRightCell	Renvoie un Range objet qui représente la cellule qui se trouve sous le coin inférieur droit de l’objet. En lecture seule.
Callout	Renvoie un CalloutFormat objet qui contient des propriétés de mise en forme de légende pour la forme spécifiée. S’applique aux Shape objets qui représentent des légendes de ligne. En lecture seule.
CanvasItems	Réservé à une utilisation interne.
Chart	Retourne un objet qui représente le _Chart contenu dans .Shape 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 seule MsoTriState.
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 seule MsoTriState.
ConnectorFormat	Retourne un ConnectorFormat objet qui contient les propriétés de mise en forme du connecteur. S’applique aux Shape objets qui représentent des connecteurs. En lecture seule.
ControlFormat	Retourne un ControlFormat objet qui contient les propriétés de contrôle Microsoft Excel. 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 seule XlCreator.
Diagram	Retourne 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 FillFormat objet qui contient des propriétés de mise en forme de remplissage pour le graphique ou la forme spécifié. En lecture seule.
FormControlType	Cette propriété renvoie le type de contrôle Microsoft Excel. En lecture seule XlFormControl.
Glow	Renvoie un objet pour une forme spécifiée qui contient les propriétés de mise en forme de la lumière pour cette forme. En lecture seule.
GroupItems	Renvoie un GroupShapes objet qui représente les formes individuelles du groupe spécifié. Utilisez la Item(Object) méthode de l’objet GroupShapes pour renvoyer une forme unique à partir du groupe. S’applique aux Shape objets qui représentent des formes groupées. En lecture seule.
HasChart	Retourne des informations sur si un Shape contient un graphique. En lecture seule.
HasDiagram	Renvoie une valeur indiquant si une forme ou une plage de formes contient un diagramme. En lecture seule MsoTriState.
HasDiagramNode	Retourne une valeur indiquant si un nœud de diagramme existe dans une forme ou une plage de formes donnée. En lecture seule MsoTriState.
HasSmartArt	Obtient si un diagramme SmartArt est présent 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 seule MsoTriState.
Hyperlink	Renvoie un Hyperlink objet qui représente le lien hypertexte de la forme.
ID	Retourne 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 LineFormat objet qui contient des propriétés de mise en forme de ligne pour la forme spécifiée. En lecture seule.
LinkFormat	Retourne un LinkFormat objet qui contient les propriétés de l’objet OLE lié. 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 lecture/écriture MsoTriState.
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. String en lecture/écriture.
Nodes	Renvoie une ShapeNodes collection qui représente la description géométrique de la forme spécifiée. S’applique aux Shape 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é. String en lecture/écriture.
Parent	Renvoie l’objet parent pour l’objet spécifié. En lecture seule.
ParentGroup	Renvoie un Shape objet qui représente la forme parente commune d’une forme enfant ou d’une plage de formes enfants.
PictureFormat	Renvoie un PictureFormat objet qui contient des propriétés de mise en forme d’image pour la forme spécifiée. S’applique aux Shape 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 situées en dessous. En lecture/écriture XlPlacement.
Reflection	Renvoie un objet qui contient des 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 la page ne contient pas de script, aucune valeur n'est renvoyée.
Shadow	True si l’objet a une ombre. Boolean (en lecture/écriture).
ShapeStyle	Renvoie ou définit un MsoShapeStyleIndex qui représente le style de forme de la forme. Lecture-écriture.
SmartArt	Obtient un objet qui représente l’objet SmartArt associé à la forme.
SoftEdge	Renvoie un SoftEdgeFormat objet pour une forme spécifiée qui contient des propriétés de mise en forme de bord souple pour la 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. S’applique aux objets T :Microsoft.Office.Interop.Excel.Shape qui représentent 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 ThreeDFormat objet qui contient des propriétés de mise en forme 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 Range objet qui représente la cellule située sous le coin supérieur gauche de l’objet spécifié. En lecture seule.
Type	Renvoie ou définit le type de forme. En lecture seule MsoShapeType.
VerticalFlip	Cette propriété a la valeur True si la forme spécifiée est retournée autour de l’axe vertical. En lecture seule MsoTriState.
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 lecture/écriture MsoTriState.
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é à une utilisation interne.
CanvasCropLeft(Single)	Réservé à une utilisation interne.
CanvasCropRight(Single)	Réservé à une utilisation interne.
CanvasCropTop(Single)	Réservé à une utilisation 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. Retourne les formes non groupées sous la forme d’un objet unique ShapeRange .
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).