Classe ShapeRange - une plage de formes (Excel VBA)

La classe ShapeRange représente une plage de formes, qui correspond à un ensemble de formes dans un document.

Les classes suivantes donnent accès à la classe ShapeRange

Dim sre as ShapeRange
Set sre = Application.ActiveChart.OLEObjects

Méthodes

Align - Aligne les formes contenues dans la plage de formes spécifiée.

Apply - expression. Application

Delete - Cette méthode supprime l'objet.

Distribute - Cette méthode distribue les formes horizontalement ou verticalement dans la plage des formes spécifiée.

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.

Group - Cette méthode groupe les formes dans la plage spécifiée.

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é.

Item - Cette méthode renvoie un seul objet d'une collection.

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.

Regroup - Cette méthode reforme le groupe auquel la plage de formes spécifiée appartenait auparavant. Renvoie les formes regroupées sous la forme d’un seul objet Shape .

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 à n’importe quel objet ShapeRange 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 ShapeRange 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.

Callout Renvoie un objet CalloutFormat qui contient des propriétés de mise en forme de légende pour la forme spécifiée. S’applique aux objets ShapeRange qui représentent des légendes. En lecture seule.

Chart Renvoie un objet Chart qui représente le graphique contenu dans la plage de formes. 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 aux objets ShapeRange qui représentent des connecteurs. En lecture seule.

Count Cette propriété renvoie une valeur de type Long qui représente le nombre d’objets de la collection.

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.

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

GraphicStyle Cette propriété renvoie ou définit une constante MsoGraphicStyleIndex qui représente le style d’une plage de formes contenant un ou plusieurs graphiques 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 ShapeRange qui représente les formes groupées. En lecture seule.

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

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.

ID Renvoie une valeur de type long qui représente le type de l’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.

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.

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.

ParentGroup Cette propriété renvoie un objet Shape qui représente la forme parente commune d'une forme enfant ou d'une plage de formes enfants.

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

Reflection Renvoie un objet ReflectionFormat pour une plage de formes spécifiée qui contient des propriétés de mise en forme de la réflexion pour la plage de formes. 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.

SoftEdge Renvoie un objet SoftEdgeFormat pour une plage de formes spécifiée qui contient des propriétés de mise en forme de bordure arrondie pour la plage de formes. 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 pour la plage de formes 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 plage de formes 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.

Type Renvoie 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.