Objet Shape (Excel)

Représente un objet du calque de dessin, comme une forme automatique, une forme libre, un objet OLE ou une image.

Remarques

L’objet Shape est membre de la collection Shapes. La collection Shapes contient toutes les formes d’un classeur.

Notes

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

Pour renvoyer... Utilisez...
Objet Shape qui représente l’une des formes attachées par un connecteur Propriété BeginConnectedShape ou EndConnectedShape de l’objet ConnectorFormat .
Une forme libre nouvellement créée Les méthodes BuildFreeform et AddNodes pour définir la géométrie d’une nouvelle forme libre et utiliser la méthode ConvertToShape pour créer la forme libre et renvoyer l’objet Shape qui la représente.
Objet Shape qui représente une seule forme dans une forme groupée GroupItems (index), où index est le nom de la forme ou le numéro d’index dans le groupe.
Groupe de formes nouvellement formé Méthode Group ou Regroup de l’objet ShapeRange pour regrouper une plage de formes et renvoyer un seul objet Shape qui représente le groupe nouvellement formé. Une fois qu’un groupe a été formé, vous pouvez travailler avec le groupe de la même façon que pour n’importe quelle autre forme.
Objet Shape qui représente une forme existante Formes (index), où index est le nom de la forme ou le numéro d’index.
Objet Shape qui représente une forme dans la sélection Sélection. ShapeRange (index), où index est le nom de la forme ou le numéro d’index.

Exemple

L’exemple suivant permet de faire pivoter horizontalement la forme 1 et la forme nommée « Rectangle 1 » dans myDocument.

Set myDocument = Worksheets(1) 
myDocument.Shapes(1).Flip msoFlipHorizontal 
myDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal

Chaque forme reçoit un nom par défaut lorsque vous l’ajoutez à la collection Shapes. Pour nommer la forme de manière plus explicite, utilisez la propriété Name. L’exemple suivant ajoute un rectangle à myDocument, lui donne le nom Carré rouge, puis définit sa couleur de premier plan et son style de trait.

Set myDocument = Worksheets(1) 
With myDocument.Shapes.AddShape(msoShapeRectangle, _ 
 144, 144, 72, 72) 
 .Name = "Red Square" 
 .Fill.ForeColor.RGB = RGB(255, 0, 0) 
 .Line.DashStyle = msoLineDashDot 
End With

L’exemple suivant montre comment définir le remplissage de la première forme de la sélection dans la fenêtre active, en supposant qu’il existe au moins une forme dans la sélection.

ActiveWindow.Selection.ShapeRange(1).Fill.ForeColor.RGB = _ 
 RGB(255, 0, 0)

Méthodes

Propriétés

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.