Classe Shape - un objet du calque de dessin (Excel VBA)

La classe Shape représente un objet du calque de dessin, comme une forme automatique, une forme libre, un objet OLE ou une image.

Les classes suivantes donnent accès à la classe Shape

For Each

Voici un exemple de traitement des éléments Shape dans une collection

For Each s In Worksheets(1).Shapes 
    If s.HorizontalFlip Then s.Flip msoFlipHorizontal 
    If s.VerticalFlip Then s.Flip msoFlipVertical 
Next

Méthodes

Apply - expression. Application

Copy - Cette méthode copie l'objet dans le Presse-papiers.

CopyPicture - Cette méthode copie l'objet sélectionné dans le Presse-papiers en tant qu'image.

Cut - Cette méthode coupe l'objet et le place dans le Presse-papiers.

Delete - Cette méthode supprime l'objet.

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

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

IncrementLeft - Cette méthode déplace la forme spécifiée horizontalement selon le nombre de pointsspécifié.

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

IncrementTop - Cette méthode déplace la forme spécifiée verticalement selon le nombre de pointsspécifié.

PickUp - Copie la mise en forme de la forme indiquée. La méthode Apply permet d'appliquer à une autre forme la mise en forme copiée.

RerouteConnections - Cette méthode redirige tous les connecteurs attachés à la forme spécifiée; Si la forme spécifiée est un connecteur, elle est redirigée.

ScaleHeight - Met la hauteur de la forme à l’échelle en utilisant un facteur spécifié. Pour les images et les objets OLE, vous pouvez indiquer si vous souhaitez mettre la forme à l'échelle par rapport à la taille d'origine ou actuelle. Les formes qui ne sont ni des images ni des objets OLE sont toujours mises à l'échelle par rapport à leur hauteur actuelle.

ScaleWidth - Met la largeur de la forme à l’échelle en utilisant un facteur spécifié. Pour les images et les objets OLE, vous pouvez indiquer si vous souhaitez mettre la forme à l'échelle par rapport à la taille d'origine ou la taille actuelle. Les formes qui ne sont ni des images ni des objets OLE sont toujours mises à l'échelle par rapport à la largeur actuelle.

Select - Cette méthode 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. Elle dissocie les images et les objets OLE d'une forme ou d'une plage de formes spécifiée.

ZOrder - Cette méthode amène la forme spécifiée devant ou derrière d'autres formes de la collection (c'est-à-dire qu'elle modifie la position de la forme dans l'ordre de plan).

Propriétés

Adjustments Renvoie un objet Adjustments qui contient les valeurs d’ajustement pour tous les ajustements dans la forme spécifiée. S’applique à tout objet Shape qui représente une forme automatique, un objet WordArt ou un connecteur.

AlternativeText Cette propriété renvoie ou définit la chaîne de texte descriptive (de remplacement) d’un objet Shape lors de l’enregistrement de l’objet dans une page Web. String en lecture/écriture.

AutoShapeType Cette propriété renvoie ou définit le type de forme pour l’objet Shape ou ShapeRange spécifié, qui doit représenter une forme automatique autre qu’un trait, un dessin de forme libre ou un connecteur. Type de données MsoAutoShapeType en lecture-écriture.

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

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 objet Range qui représente la cellule située sous le coin inférieur droit de l’objet. En lecture seule.

Callout Renvoie un objet CalloutFormat qui contient des propriétés de mise en forme de légende pour la forme spécifiée. Elle s'applique à un objet Shape qui représente des traits de légende. En lecture seule.

Chart Renvoie un objet Chart qui représente le graphique contenu dans la forme. 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. Renvoie msoFalse si la forme sélectionnée n’est pas une forme enfant. Renvoie msoTriStateMixed si seule une partie des formes sélectionnées est une forme enfant. En lecture seule MsoTriState.

ConnectionSiteCount Renvoie le nombre de sites de connexion sur la forme spécifiée. Type de données Long 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 Renvoie un objet ConnectorFormat qui contient les propriétés de mise en forme du connecteur. S’applique à un objet Shape qui représente des connecteurs. En lecture seule.

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

Decorative Définit ou renvoie l’indicateur décoratif de l’objet spécifié. Lecture-écriture.

Fill Cette propriété renvoie un objet FillFormat pour une forme spécifiée ou un objet ChartFillFormat pour un graphique spécifique qui contient des propriétés de mise en forme de remplissage pour la forme ou le graphique. En lecture seule.

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

Glow Cette propriété renvoie un objet GlowFormat pour une forme spécifiée qui contient des propriétés de mise en forme de lumière pour la forme. En lecture seule.

GraphicStyle Cette propriété renvoie ou définit une constante MsoGraphicStyleIndex qui représente le style d’un graphique SVG. Lecture-écriture.

GroupItems Renvoie un objet GroupShapes qui représente les formes individuelles dans le groupe spécifié. Utilisez la méthode Item de l’objet GroupShapes pour renvoyer une seule forme à partir du groupe. Cette propriété s'applique à un objet Shape représente les formes groupées. En lecture seule.

HasChart Cette propriété renvoie une valeur indiquant si une forme contient un graphique. En lecture seule MsoTriState.

HasSmartArt Renvoie une valeur qui indique si un graphique SmartArt est présent sur la forme spécifiée. En lecture seule.

Height Cette propriété renvoie ou définit une valeur unique qui représente la hauteur de l’objet, exprimée en points.

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 objet Hyperlink qui représente le lien hypertexte de la forme.

ID Cette propriété renvoie une valeur de type Long qui représente le type d'objet spécifié.

Left Cette propriété renvoie ou définit une valeur unique qui représente la distance en pointsentre le bord gauche de l’objet et le bord gauche de colonne a (dans une feuille de calcul) ou le bord gauche de la zone de graphique (dans un graphique).

Line Renvoie un objet LineFormat qui contient les propriétés de la forme spécifiée la mise en forme du trait. (Pour une ligne, l’objet LineFormat représente la ligne ; pour une forme avec bordure, l’objet LineFormat représente la bordure.) En lecture seule.

LinkFormat Renvoie un objet LinkFormat 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 Cette propriété renvoie ou définit une valeur de type Boolean qui indique si l'objet est verrouillé.

Model3D Renvoie un objet Model3DFormat qui contient les propriétés Model3D. En lecture seule.

Name Cette propriété renvoie ou définit une valeur de type String qui représente le nom de l'objet.

Nodes Renvoie une collection ShapeNodes qui constitue la description géométrique de la forme indiquée.

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

OnAction Cette propriété renvoie ou définit le nom d’une macro exécutée lors de la sélection de l’objet spécifié. String en lecture/écriture.

ParentGroup Cette propriété renvoie un objet Shape qui représente la forme du parent ordinaire d'une forme enfant ou d'une plage de formes enfant.

PictureFormat Renvoie un objet PictureFormat qui contient les propriétés de la forme spécifiée. S’applique à un objet Shape qui représente des images ou des objets OLE. En lecture seule.

Placement Cette propriété renvoie ou définit une valeur XlPlacement qui représente le mode d’attachement de l’objet aux cellules qui se trouvent en-dessous.

Reflection Renvoie un objet ReflectionFormat pour une forme spécifiée qui contient des propriétés de mise en forme de la réflexion pour la forme. En lecture seule.

Rotation Cette propriété renvoie ou définit la rotation de la forme, estimée en degrés. String en lecture/écriture.

Shadow Renvoie un objet ShadowFormat en lecture seule qui contient des propriétés de mise en forme de l’ombre pour la ou les formes spécifiées.

ShapeStyle Cette propriété renvoie ou définit une valeur MsoShapeStyleIndex qui représente le style de forme de la plage de formes. Lecture-écriture.

SmartArt Renvoie un Object qui représente le graphique SmartArt associé à la forme. En lecture seule.

SoftEdge Cette propriété renvoie un objet SoftEdgeFormat pour une forme spécifiée qui contient des propriétés de mise en forme de bordure arrondie pour la forme. En lecture seule.

TextEffect Renvoie un objet TextEffectFormat qui contient les propriétés de mise en forme des effets de texte pour la forme spécifiée. En lecture seule.

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

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

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

Title Cette propriété renvoie ou définit le titre du texte de remplacement associé à la forme spécifiée. Lecture-écriture.

Top Cette propriété renvoie ou définit une valeur unique qui représente la distance en pointsentre le bord supérieur de la forme la plus haute dans la plage de formes et le bord supérieur de la feuille de calcul.

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

Type Cette propriété renvoie ou définit une valeur MsoShapeType qui représente le type de forme.

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. Vous pouvez utiliser le tableau renvoyé par cette propriété comme argument de la méthode AddCurve ou AddPolyline . Type de données Variant en lecture seule.

Visible Cette propriété renvoie ou définit une valeur MsoTriState qui détermine si l’objet est visible. Lecture-écriture.

Width Cette propriété renvoie ou définit une valeur unique qui représente la largeur, exprimée en points, de l’objet.

ZOrderPosition Cette propriété renvoie la position de la forme spécifiée dans l'ordre de superposition. Type de données Long en lecture seule.

Related Classes

Adjustments - Contient une collection de valeurs d’ajustement pour la forme automatique, l’objet WordArt ou le connecteur spécifié.

CalloutFormat - Cet objet contient des propriétés et méthodes qui s'appliquent aux légendes encadrées.

Chart - Représente un graphique dans un classeur.

ConnectorFormat - Contient des propriétés et des méthodes qui s’appliquent aux connecteurs.

ControlFormat - Cet objet contient les propriétés de contrôle Microsoft Excel.

FillFormat - Cet objet représente la mise en forme du remplissage d'une forme.

GroupShapes - Cet objet représente les formes individuelles d'une forme groupée.

Hyperlink - Cet objet représente un lien hypertexte.

LineFormat - Cet objet représente la mise en forme des lignes et des têtes de flèche.

LinkFormat - Cet objet contient les propriétés des objets OLE liés.

Model3DFormat - Représente les propriétés d'une forme de modèle 3D.

OLEFormat - Cet objet contient les propriétés d'un objet OLE.

PictureFormat - Cet objet contient les propriétés et méthodes qui s'appliquent aux images et aux objets OLE.

Range - Cette collection représente une cellule, une ligne, une colonne ou une sélection de cellules contenant un ou plusieurs blocs contigus de cellules ou une plage 3D.

ShadowFormat - Représente la mise en forme de l'ombrage d'une forme.

ShapeNodes - Une collection de tous les modules de ShapeNode objets dans la forme libre.

ShapeRange - Représente une plage de formes, qui correspond à un ensemble de formes dans un document.

TextEffectFormat - Contient les propriétés et méthodes applicables aux objets WordArt.

TextFrame - Représente le cadre de texte dans un objet Shape.

TextFrame2 - Représente le cadre de texte dans un objet Shape, ShapeRange ou ChartFormat .

ThreeDFormat - Représente la mise en forme en trois dimensions de la forme.