Objet Shape (Excel)
Représente un objet du calque de dessin, comme une forme automatique, une forme libre, un objet OLE ou une image.
L’objet Shape est membre de la collection Shapes . La collection Shapes contient toutes les formes d’un classeur.
Notes
Trois objets représentent des formes : la collection Shapes , qui représente toutes les formes d’un classeur ; la collection ShapeRange , qui représente un sous-ensemble spécifié des formes d’un classeur (par exemple, un objet ShapeRange peut représenter des formes un et quatre dans le classeur, ou il peut représenter toutes les formes sélectionnées dans le classeur) ; et l’objet Shape , qui représente une forme unique 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 revenir... | Utiliser... |
---|---|
Objet Shape qui représente l’une des formes attachées par un connecteur | Propriété BeginConnectedShape ou EndConnectedShape de l’objet ConnectorFormat . |
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 forme unique dans une forme groupée | GroupItems (index), où index est le nom de la forme ou le numéro d’index dans le groupe. |
Un 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 vous utilisez 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. |
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)
- Apply
- Copy
- CopyPicture
- Cut
- Supprimer
- Duplicate
- Flip
- IncrementLeft
- IncrementRotation
- IncrementTop
- PickUp
- RerouteConnections
- ScaleHeight
- ScaleWidth
- Select
- SetShapesDefaultProperties
- Ungroup
- ZOrder
- Adjustments
- AlternativeText
- Application
- AutoShapeType
- BackgroundStyle
- BlackWhiteMode
- BottomRightCell
- Callout
- Chart
- Child
- ConnectionSiteCount
- Connector
- ConnectorFormat
- ControlFormat
- Creator
- Decorative
- Fill
- FormControlType
- Glow
- GraphicStyle
- GroupItems
- HasChart
- HasSmartArt
- Height
- HorizontalFlip
- Hyperlink
- ID
- Left
- Line
- LinkFormat
- LockAspectRatio
- Locked
- Model3D
- Name
- Nodes
- OLEFormat
- OnAction
- Parent
- ParentGroup
- PictureFormat
- Placement
- Reflection
- Rotation
- Shadow
- ShapeStyle
- SmartArt
- SoftEdge
- TextEffect
- TextFrame
- TextFrame2
- ThreeD
- Titre
- Top
- TopLeftCell
- Type
- VerticalFlip
- Vertices
- Visible
- Width
- ZOrderPosition
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.