Classe Shape - un objet du calque de dessin (PowerPoint 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

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

Dim shp as Shape
Set shp = Dim lngX As Long: lngX = 
Dim lngY As Long: lngY = 
ActiveWindow.RangeFromPoint(X:=lngX, Y:=lngY)
Les procédures suivantes peuvent être utilisés pour définir des variables de la classe Shape : Cell.Shape, ConnectorFormat.BeginConnectedShape, ConnectorFormat.EndConnectedShape, DocumentWindow.RangeFromPoint, Effect.Shape, FreeformBuilder.ConvertToShape, GroupShapes.Item, Placeholders.FindByName, Placeholders.Item, Presentation.DefaultShape, ResampleMediaTask.Shape, ParentGroup, ShapeRange.Group, ShapeRange.Item ...ShapeRange.ParentGroup, ShapeRange.Regroup, Shapes.Add3DModel, Shapes.AddCallout, Shapes.AddChart2, Shapes.AddConnector, Shapes.AddCurve, Shapes.AddInkShapeFromXML, Shapes.AddLabel, Shapes.AddLine, Shapes.AddMediaObject2, Shapes.AddMediaObjectFromEmbedTag, Shapes.AddOLEObject, Shapes.AddPicture, Shapes.AddPicture2, Shapes.AddPlaceholder, Shapes.AddPolyline, Shapes.AddShape, Shapes.AddSmartArt, Shapes.AddTable, Shapes.AddTextbox, Shapes.AddTextEffect, Shapes.AddTitle, Shapes.Item, Shapes.Title, Timing.TriggerShape.

Méthodes

Apply - expression. Application

ApplyAnimation - Applique la dernière animation sélectionnée à l’objet Shape .

ConvertTextToSmartArt - Convertit le texte d’un objet Shape en un graphique SmartArt.

Copy - Copie l’objet spécifié dans le Presse-papiers.

Cut - Supprime l’objet spécifié et le place dans le Presse-papiers.

Delete - Supprime l’objet Shape spécifié.

Duplicate - Cette méthode crée une copie de l’objet Shape spécifié, ajoute la nouvelle forme à la collection Shapes , puis renvoie un nouvel objet ShapeRange . Les objets dupliqués sont placés à la fin de la collection Shapes.

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

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

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 - 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. Utilisez la méthode apply pour appliquer la mise en forme copiée à une autre forme.

PickupAnimation - Sélectionne toutes les animations de l’objet Shape .

RerouteConnections - Redirige les connecteurs afin qu'ils prennent le chemin le plus court possible entre les formes qu'ils se connectent. Pour ce faire, la méthode RerouteConnections peut détacher les extrémités d’un connecteur et les rattacher à différents sites de connexion sur les formes connectées.

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

ScaleWidth - Redimensionne la largeur de la forme en fonction d'un facteur défini. Pour les images et les objets OLE, vous pouvez indiquer si vous voulez mettre à l’échelle la forme par rapport à sa taille d’origine ou sa taille actuelle. Les formes autres que les objets OLE sont toujours mis à l’échelle sur la base de leur largeur actuelle.

Select - Sélectionne l'objet spécifié.

SetShapesDefaultProperties - Applique le format de la forme spécifiée à la forme par défaut. Les formes créées après utilisation de cette méthode appliqueront ce format par défaut.

Ungroup - Dissocie toutes les formes groupées dans la forme ou la plage de formes spécifiée. Sépare les images et les objets OLE dans la forme ou plage de formes spécifiée. Cette propriété renvoie les formes dissociées en tant qu’objet ShapeRange unique.

UpgradeMedia - Convertit un objet multimédia hérité en un objet multimédia mis à jour.

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

ActionSettings Renvoie un objet ActionSettings qui contient des informations sur l’action qui se produit lorsque l’utilisateur clique ou déplace la souris sur la forme ou la plage de texte spécifiée au cours d’un diaporama. En lecture seule.

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 dessin WordArt ou un connecteur. En lecture seule.

AlternativeText Renvoie ou définit le texte de remplacement associé à une forme dans une présentation Web. Lecture-écriture.

AnimationSettings Renvoie un objet AnimationSettings qui représente tous les effets spéciaux que vous pouvez appliquer à l’animation de la forme spécifiée. En lecture seule.

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, un dessin de forme libre ou un connecteur. Lecture-écriture.

BackgroundStyle Renvoie ou définit le style d’arrière-plan de l’objet spécifié. Lecture-écriture.

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

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 Shape ou ShapeRange qui représentent des légendes de trait. En lecture seule.

Chart Renvoie un objet Chart de l’objet Shape actif. En lecture seule.

Child Prend la valeur MsoTrue si la forme est une forme enfant ou si toutes les formes d’une plage sont des formes enfants du même parent. En lecture seule.

ConnectionSiteCount Renvoie le nombre de sites de connexion sur la forme spécifiée. En lecture seule.

Connector Détermine si la forme spécifiée est un connecteur. En lecture seule.

ConnectorFormat Renvoie un objet ConnectorFormat qui contient les propriétés de mise en forme du connecteur. S'applique aux objets Shape ou ShapeRange qui représentent des connecteurs. En lecture seule.

CustomerData Renvoie un objet CustomerData . En lecture seule.

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

Fill Renvoie un objet FillFormat qui contient les propriétés de mise en forme du remplissage appliqué à la forme spécifiée. En lecture seule.

Glow Renvoie le format de la lumière pour la forme spécifiée. 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. En lecture seule.

HasChart Indique si la forme représentée par l’objet spécifié contient un diagramme. En lecture seule.

HasInkXML Renvoie une valeur d’énumération MsoTriState qui indique si la forme spécifiée contient les données Ink XML qui peuvent être extraites via la propriété Shape.InkXML. En lecture seule.

HasSectionZoom

HasSmartArt Renvoie la valeur true si l’objet Shape actif contient un diagramme SmartArt. En lecture seule.

HasTable Indique si la forme spécifiée est un tableau. En lecture seule.

HasTextFrame Indique si la forme spécifiée contient un cadre de texte. En lecture seule.

Height Renvoie ou définit la hauteur de l’objet spécifié, en points. Lecture-écriture.

HorizontalFlip Indique si la forme spécifiée est retournée autour de son axe horizontal. En lecture seule.

Id Renvoie un type de données Long qui identifie la forme ou plage de formes. En lecture seule.

InkXML Renvoie une Chaîne contenant la propriété InkActionML associée à la forme spécifiée. En lecture seule.

IsNarration Indique si la plage de formes spécifiée contient une narration. Lecture-écriture.

Left Renvoie ou définit une valeur de type Single qui représente la distance en points entre le bord gauche du cadre englobant de la forme et le bord gauche de la diapositive. Lecture-écriture.

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

LinkFormat Renvoie un objet LinkFormat qui contient les propriétés qui sont spécifiques aux objets OLE liés. En lecture seule.

LockAspectRatio Détermine si la forme spécifiée conserve ses proportions d’origine lors de son redimensionnement. Lecture-écriture.

MediaFormat Donne accès au nouvel objet audio ou vidéo. En lecture seule.

MediaType Renvoie le type de média OLE. En lecture seule.

Model3D Renvoie un objet Model3DFormat qui représente les propriétés 3D d'un objet de modèle 3D. En lecture seule.

Name Lors de la création d’une forme, Microsoft PowerPoint lui attribue automatiquement un nom sous la forme Numéro Typedeforme, où Typedeforme identifie le type de forme ou de forme automatique, et le nombre est un entier unique dans la collection de formes de la diapositive. Par exemple, les noms générés automatiquement pour les formes d’une diapositive pourraient être EspaceRéservé 1, Ovale 2 et Rectangle 3. Pour éviter tout conflit avec les noms automatiquement assignés, n’utilisez pas la forme TypeForme Numéro pour des noms définis par l’utilisateur, où TypeForme est une valeur utilisée pour les noms générés automatiquement, et Numéro est un entier positif. Une étendue de forme doit contenir exactement une forme. Lecture-écriture.

Nodes Renvoie une collection ShapeNodes qui constitue la description géométrique de la forme indiquée. S’applique aux objets Shape qui représentent des dessins en forme libre.

OLEFormat Renvoie un objet OLEFormat qui contient les propriétés de la forme spécifiée la mise en forme de OLE. S'applique aux objets Shape ou ShapeRange qui représentent des objets OLE. En lecture seule.

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. En lecture seule.

PlaceholderFormat Renvoie un objet PlaceholderFormat qui contient les propriétés propres aux espaces réservés. En lecture seule.

Reflection Renvoie le format du reflet pour la forme spécifiée. En lecture seule.

Rotation Renvoie ou définit le nombre de degrés pour la rotation de la forme spécifiée autour de l’axe des ordonnées (Z). Lecture-écriture.

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

ShapeStyle Renvoie ou définit l’index de style de forme de l’objet spécifié. Lecture-écriture.

SmartArt Renvoie un objet SmartArt Microsoft Office qui représente le diagramme SmartArt de l’objet Shape . En lecture seule.

SoftEdge Renvoie le format de bordures arrondies pour la plage spécifiée. En lecture seule.

Table Renvoie un objet table qui représente un tableau dans une forme ou dans une plage de formes. En lecture seule.

Tags Renvoie un objet Tags qui représente les balises de l’objet spécifié. 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 ou du style de texte du masque.

TextFrame2 Renvoie l’objet TextFrame2 associé à l’objet Shape spécifié qui contient les propriétés d’alignement et d’ancrage 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 Renvoie un objet Shape qui représente le titre de la diapositive. En lecture seule.

Top Renvoie ou définit une valeur de type Single qui représente la distance entre le bord supérieur du cadre englobant de la plage de formes et le bord supérieur du document. Lecture-écriture.

Type Renvoie le type de la ou des formes d'une plage de formes. En lecture seule.

VerticalFlip Détermine si la forme spécifiée est retournée autour de l’axe vertical. En lecture seule.

Vertices Renvoie les coordonnées des sommets des dessins à main levée spécifiés (et des points de contrôles des courbes de Bézier) sous la forme d’une série de paires de coordonnées. En lecture seule.

Visible Renvoie ou définit la visibilité de l’objet spécifié ou la mise en forme qui lui est appliquée. Lecture-écriture.

Width Renvoie ou définit la largeur de l’objet spécifié, en points. Lecture-écriture.

ZOrderPosition Cette propriété renvoie la position de la forme spécifiée dans l'ordre de superposition. En lecture seule.

ActionSettings - Collection contenant les deux objets ActionSetting d’une forme ou d’une plage de texte. L’un des objets ActionSetting représente la manière dont l’objet spécifié réagit lorsque l’utilisateur clique dessus en cours de diaporama, et l’autre objet ActionSetting représente la manière dont l’objet spécifié réagit lorsque l’utilisateur déplace pointeur de la souris sur celui-ci en cours de diaporama.

Adjustments - Cet objet contient des valeurs de réglage pour la forme automatique, l'objet WordArt ou le connecteur spécifié.

AnimationSettings - Représente les effets spéciaux appliqués à l’animation de la forme spécifiée en cours de diaporama.

CalloutFormat - Contient des propriétés et des méthodes qui s’appliquent aux légendes.

Chart - Représente un graphique dans une présentation.

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

CustomerData - Stocke des informations sur un client (par exemple, le nom, l’adresse, le numéro de téléphone, etc.) ou d’autres informations au format XML, sous la forme d’une collection d’objets CustomXMLPart associés à un objet Microsoft PowerPoint.

FillFormat - Représente la mise en forme du remplissage d'une forme. Ce remplissage peut être uni, dégradé, à texture, à motif, à image ou semi-transparent.

GroupShapes - Représente les formes individuelles d'une forme groupée. Chaque forme est représentée par une forme objet. À l’aide de la méthode Itemavec cet objet, vous pouvez travailler avec des formes individuelles dans un groupe sans avoir à les dissocier.

LineFormat - Représente la ligne et la mise en forme de la pointe de flèche. Pour un trait, l’objet LineFormat contient des informations de mise en forme pour le trait lui-même; pour une forme avec une bordure, cet objet contient des informations de mise en forme pour la bordure de la forme.

LinkFormat - Contient des propriétés et des méthodes qui s’appliquent aux objets liés OLE, aux images liées et aux objets multimédias IIRC.

MediaFormat - Contient les méthodes et les propriétés qui permettent d’accéder aux médias audio et vidéo et de les contrôler.

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

OLEFormat - Contient des propriétés et des méthodes qui s’appliquent aux objets OLE.

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

PlaceholderFormat - Contient les propriétés spécifiques aux espaces réservés telles que le type d’espace réservé.

ShadowFormat - Représente la mise en forme des ombres pour une forme.

ShapeNodes - Collection de tous les objets ShapeNode de la forme libre spécifiée.

ShapeRange - Représente un groupe de formes dans un document. Un groupe de formes peut contenir une seule forme ou toutes les formes d’un document.

Table - Représente une forme de tableau dans une diapositive. L’objet Table est un membre de la collection Shapes. L’objet table contient la collection Columns et la collection Rows .

Tags - Représente une étiquette ou une propriété personnalisée que vous pouvez créer pour une forme, une diapositive ou une présentation.

TextEffectFormat - Contient des propriétés et des méthodes qui s’appliquent aux objets WordArt.

TextFrame - Représente le cadre de texte d'un objet Shape. Contient le texte dans le cadre de texte ainsi que les propriétés et les méthodes qui contrôlent l’alignement et l’ancrage du cadre de texte.

TextFrame2 - Représente le cadre de texte d’un objet Shape ou ShapeRange . Contient le texte dans le cadre de texte et affiche les propriétés et méthodes qui contrôlent l’alignement et l’ancrage du cadre de texte.

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