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

La classe Shape représente un objet dans la couche dessin, tel qu’une forme automatique, une forme libre, un objet OLE, un contrôle ActiveX ou une image.

Les classes suivantes donnent accès à la classe Shape

Pour utiliser une variable de classe Shape, elle doit d'abord être instanciée, par exemple

Dim shp as Shape
Set shp = ActiveDocument.Background
Les procédures suivantes peuvent être utilisés pour définir des variables de la classe Shape : CanvasShapes.AddCallout, CanvasShapes.AddConnector, CanvasShapes.AddCurve, CanvasShapes.AddLabel, CanvasShapes.AddLine, CanvasShapes.AddPicture, CanvasShapes.AddPolyline, CanvasShapes.AddShape, CanvasShapes.AddTextbox, CanvasShapes.AddTextEffect, CanvasShapes.Item, Document.Background, FreeformBuilder.ConvertToShape, GroupShapes.Item ...Hyperlink.Shape, InlineShape.ConvertToShape, Duplicate, ParentGroup, ShapeRange.Group, ShapeRange.Item, ShapeRange.ParentGroup, Shapes.Add3DModel, Shapes.AddCallout, Shapes.AddCanvas, Shapes.AddChart2, Shapes.AddCurve, Shapes.AddLabel, Shapes.AddLine, Shapes.AddOLEControl, Shapes.AddOLEObject, Shapes.AddPicture, Shapes.AddPolyline, Shapes.AddShape, Shapes.AddSmartArt, Shapes.AddTextbox, Shapes.AddTextEffect, Shapes.AddWebVideo, Shapes.Item, TextFrame.Parent, Window.RangeFromPoint.

For Each

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

Dim shpCanvasItem As Shape
For Each shpCanvasItem In CanvasItems
	
Next shpCanvasItem

Méthodes

Apply - S'applique à la mise en forme de la forme spécifiée qui a été copiée à l'aide de la méthode PickUp.

CanvasCropBottom - Rogne un pourcentage de la hauteur d’une zone de dessin à partir du bas du dessin.

CanvasCropLeft - Rogne un pourcentage de la largeur d’une zone de dessin à partir du côté gauche du dessin.

CanvasCropRight - Rogne un pourcentage de la largeur d’une zone de dessin à partir du côté droit du dessin.

CanvasCropTop - Rogne un pourcentage de la hauteur d’une zone de dessin à partir du haut du dessin.

ConvertToInlineShape - Convertit la forme spécifiée de la couche de dessin d'un document en forme insérée dans la couche de texte.

Delete - Supprime le nœud spécifié de la forme.

Duplicate - Cette méthode crée une copie de l’objet Shape spécifié, ajoute la nouvelle forme à la collection Shapes à un décalage standard par rapport aux formes d’origine, puis renvoie le nouvel objet Shape .

Flip - Fait pivoter une forme à l’horizontale ou à la verticale.

IncrementLeft - Déplace horizontalement la forme spécifiée selon le nombre de points indiqué.

IncrementRotation - Fait pivoter la forme spécifiée, selon le nombre de degrés spécifié, autour de l'axe z.

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

ScaleHeight - Cette méthode met la hauteur d'une forme à l'échelle suivant le facteur indiqué.

ScaleWidth - Cette méthode met la largeur d'une forme à l'échelle suivant le facteur indiqué.

Select - Sélectionne la forme spécifiée.

SetShapesDefaultProperties - Applique la mise en forme de la forme par défaut d'un document à la forme spécifiée.

Ungroup - Dissocie toutes les formes groupées dans la forme 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 l’objet Shape spécifié qui représente une forme automatique ou un objet WordArt.

AlternativeText Cette propriété renvoie ou définit le texte de remplacement associé à une forme dans une page Web.

Anchor Renvoie un objet Range qui représente la plage d’ancrage de la forme spécifiée ou la plage de formes.

AutoShapeType Cette propriété renvoie ou définit le type de forme pour l’objet Shape spécifié, qui doit représenter une forme automatique autre qu’un trait ou une forme libre.

BackgroundStyle Renvoie ou définit le style d'arrière-plan de la forme spécifiée.

Callout Cette propriété renvoie un objet CalloutFormat qui contient des propriétés de mise en forme de légende pour la forme spécifiée.

CanvasItems Renvoie un objet CanvasShapes qui représente une collection de formes dans une zone de dessin.

Chart Renvoie un objet Chart qui représente un graphique dans la collection de formes dans un document.

Child True si la forme est une forme enfant ou si toutes les formes dans une plage de formes sont des formes enfants du même parent.

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

Fill Renvoie un objet FillFormat qui contient les propriétés de mise en forme du remplissage pour la forme spécifiée.

Glow Renvoie un objet GlowFormat qui représente la mise en forme de luminosité pour une forme.

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

GroupItems Renvoie un objet GroupShapes qui représente les formes individuelles dans le groupe spécifié.

HasChart True si la forme spécifiée est un graphique.

HasSmartArt Renvoie la valeur true s’il existe un diagramme SmartArt présent sur la forme.

Height Renvoie ou définit la hauteur (en points) de la forme spécifiée.

HeightRelative Cette propriété renvoie ou définit une valeur unique qui représente le pourcentage de la hauteur relative d’une forme.

HorizontalFlip Indique qu'une forme a été retournée horizontalement.

Hyperlink Renvoie un objet Hyperlink qui représente le lien hypertexte associé à un objet Shape .

ID Renvoie le type d'identification pour la forme spécifiée.

LayoutInCell Renvoie un type long qui indique si une forme d’un tableau s’affiche à l’intérieur ou à l’extérieur du tableau.

Left Cette propriété renvoie ou définit une valeur unique qui représente la position horizontale, exprimée en points, de la forme spécifiée ou d’une plage de formes.

LeftRelative Cette propriété renvoie ou définit une valeur unique qui représente la position gauche relative d’une forme.

Line Renvoie un objet LineFormat qui contient les propriétés de mise en forme du trait pour la forme spécifiée.

LinkFormat Renvoie un objet LinkFormat qui représente les options de liaison d’une forme liée à un fichier.

LockAnchor Cette propriété a la valeur True si l'ancrage d'un objet Shape est verrouillé dans la plage d'ancrage.

LockAspectRatio MsoTrue si la forme spécifiée conserve ses proportions d'origine lorsque vous la redimensionnez.

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

Name Cette propriété renvoie ou définit le nom de l'objet spécifié.

Nodes Renvoie une collection ShapeNodes qui représente la description géométrique de la forme spécifiée.

OLEFormat Renvoie un objet OLEFormat qui représente les caractéristiques OLE (autres que les caractéristiques de liaison) de la forme, de la forme insérée ou du champ spécifié.

ParentGroup 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 l’objet spécifié.

Reflection Renvoie un objet ReflectionFormat qui représente la mise en forme de la réflexion pour une forme.

RelativeHorizontalPosition Spécifie la position horizontale relative d’une forme.

RelativeHorizontalSize Cette propriété renvoie ou définit une constante WdRelativeVerticalSize qui représente l’objet auquel une plage de formes est relative.

RelativeVerticalPosition Spécifie la position verticale relative d'une forme.

RelativeVerticalSize Cette propriété renvoie ou définit une constante WdRelativeVerticalSize qui représente la taille verticale relative d’une forme.

Rotation Cette propriété renvoie ou définit le nombre de degrés de que rotation de la forme spécifiée autour de l'axe z.

Script Renvoie un objet script qui représente un bloc de script ou de code pour une image sur une page Web.

Shadow Renvoie un objet ShadowFormat qui représente la mise en forme ombrée pour la forme spécifiée.

ShapeStyle Cette propriété renvoie ou définit le style de forme de la forme spécifiée.

SmartArt Renvoie un objet SmartArt qui fournit un moyen de travailler avec le graphique SmartArt associé à la forme spécifiée.

SoftEdge Renvoie un objet SoftEdgeFormat qui représente la mise en forme de bordure arrondie pour une forme.

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.

TextFrame Renvoie un objet TextFrame qui contient le texte de la forme spécifiée.

TextFrame2 Renvoie un objet TextFrame2 qui contient le texte de la forme spécifiée.

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

Title Cette propriété renvoie ou définit une chaîne qui contient un titre pour la forme spécifiée.

Top Cette propriété renvoie ou définit la position verticale de la forme spécifiée ou d'une plage de formes en points.

TopRelative Cette propriété renvoie ou définit une valeur unique qui représente la position supérieure relative d’une forme.

Type Renvoie le type de forme insérée.

VerticalFlip Cette propriété a la valeur True si la forme spécifiée est retournée autour de l’axe vertical.

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.

Visible True si l'objet spécifié, ou la mise en forme appliquée, apparaît.

Width Cette propriété renvoie ou définit la largeur, exprimée en points, de la forme spécifiée.

WidthRelative Cette propriété renvoie ou définit une valeur unique qui représente la largeur relative d’une forme.

WrapFormat Renvoie un objet WrapFormat qui contient les propriétés d’habillage du texte autour de la forme spécifiée.

ZOrderPosition Renvoie un type long qui représente la position de la forme spécifiée dans l’ordre de plan.

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

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

CanvasShapes - Utilisez la propriété CanvasItems, d’un objet Shape ou ShapeRange pour renvoyer une collection CanvasShapes .

Chart - Représente un graphique dans un document.

FillFormat - Représente la mise en forme du remplissage d'une forme.

GlowFormat - Représente la mise en forme lumineuse définie pour une forme ou une plage de formes.

GroupShapes - Représente les formes individuelles d'une forme groupée.

Hyperlink - Représente un lien hypertexte.

InlineShape - Représente un objet situé dans la couche de texte d'un document.

LineFormat - Représente la ligne et la mise en forme de la pointe de flèche.

LinkFormat - Représente les caractéristiques de liaison d'un objet ou d'une image OLE.

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

OLEFormat - Représente les caractéristiques OLE (autres que les caractéristiques de liaison) d'un objet OLE, d'un contrôle ActiveX ou d'un champ.

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

Range - Représente une zone contiguë dans un document.

ReflectionFormat - Représente la mise en forme de réflexion définie pour une forme ou une plage de formes.

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, constituée d'un ensemble de formes sur un document.

SoftEdgeFormat - Représente la mise en forme avec des bordures arrondies définie pour une forme ou une plage de formes.

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

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

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

WrapFormat - Représente toutes les propriétés d'ajustement d'un texte autour d'une forme ou d'une plage de formes.