Partager via


Shape Interface

Définition

Cet objet représente un objet sur le calque de dessin, par exemple une forme automatique, une forme libre, un objet OLE ou une image. L’objet Shape est membre de la Shapes collection. La collection Shapes contient toutes les formes d’une diapositive.

public interface class Shape
[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape
Public Interface Shape
Attributs

Remarques

Trois objets représentent des formes : la collection Shapes , qui représente toutes les formes d’un document ; la ShapeRange collection, qui représente un sous-ensemble spécifié des formes d’un document (par exemple, un objet ShapeRange peut représenter des formes un et quatre sur le document, ou il peut représenter toutes les formes sélectionnées sur le document) et l’objet Shape , qui représente une seule forme sur un document. Pour utiliser plusieurs formes simultanément ou des formes faisant partie de la sélection, utilisez une collection ShapeRange.

Cette section décrit comment :

  • renvoyer une forme existante ;
  • renvoyer une forme de la sélection.
  • renvoyer les formes attachées aux extrémités d’un connecteur ;
  • renvoyer une nouvelle forme libre ;
  • renvoyer une seule forme au sein d’un groupe ;
  • renvoyer un nouveau groupe de formes ;

Renvoi d’une forme existante

Utilisez Shapes(index), où index est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme.

Chaque forme reçoit un nom par défaut lorsque vous l’ajoutez à la collection Shapes. Pour donner à la forme un nom plus explicite, utilisez la Name propriété .

Renvoi d’une forme au sein de la sélection

Utilisez Selection.ShapeRange(index), où index est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme dans la sélection.

Renvoi des formes attachées aux extrémités d’un connecteur.

Pour renvoyer un objet Shape qui représente l’une des formes attachées par un connecteur, utilisez la BeginConnectedShape propriété ou EndConnectedShape .

Renvoi d’une nouvelle forme libre

Utilisez les BuildFreeform(MsoEditingType, Single, Single) méthodes et AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) pour définir la géométrie d’une nouvelle forme libre, puis utilisez la ConvertToShape() méthode pour créer la forme libre et renvoyer l’objet Shape qui la représente.

Renvoi d’une seule forme au sein d’un groupe

Utilisez GroupItems(index), où index est le nom de la forme ou le numéro d’index du groupe, pour renvoyer un objet Shape qui représente une forme unique dans une forme groupée.

Renvoi d’un groupe de formes nouvellement constitué

Utilisez la Group() méthode ou Regroup() pour regrouper une plage de formes et renvoyer un seul objet Shape qui représente le groupe nouvellement formé. Une fois un groupe a été créé, vous pouvez travailler avec le groupe de la même façon que vous travaillez avec n'importe quel autre forme.

Propriétés

Adjustments

Renvoie un Adjustments objet qui contient des valeurs d’ajustement pour tous les ajustements dans la forme spécifiée. En lecture seule.

AlternativeText

Renvoie ou définit la chaîne de texte descriptive (alternative) d’un Shape objet lorsque l’objet est enregistré dans une page Web. String en lecture/écriture.

Application

Renvoie un Application objet qui représente l’application Microsoft Excel. En lecture seule.

AutoShapeType

Renvoie ou définit le type de forme de l’objet spécifié Shape , qui doit représenter une forme automatique autre qu’un trait, un dessin de forme libre ou un connecteur. En lecture/écriture MsoAutoShapeType.

BackgroundStyle

Cette propriété renvoie ou définit le style d'arrière-plan. 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. En lecture/écriture MsoBlackWhiteMode.

BottomRightCell

Renvoie un Range objet qui représente la cellule qui se trouve sous le coin inférieur droit de l’objet. En lecture seule.

Callout

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

CanvasItems

Réservé à une utilisation interne.

Chart

Retourne un objet qui représente le _Chart contenu dans .Shape 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. En lecture seule MsoTriState.

ConnectionSiteCount

Renvoie le nombre de sites de connexion sur la forme spécifiée. Entier 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

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

ControlFormat

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

Creator

Renvoie un nombre entier de 32 bits qui indique l’application dans laquelle cet objet a été créé. Si l'objet a été créé dans Microsoft Excel, cette propriété renvoie la chaîne XCEL, qui équivaut au nombre hexadécimal 5843454C. En lecture seule XlCreator.

Diagram

Retourne un Diagram objet représentant un diagramme.

DiagramNode

Renvoie un DiagramNode objet qui représente un nœud dans un diagramme.

DrawingObject

Réservé à une utilisation interne.

Fill

Renvoie un FillFormat objet qui contient des propriétés de mise en forme de remplissage pour le graphique ou la forme spécifié. En lecture seule.

FormControlType

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

Glow

Renvoie un objet pour une forme spécifiée qui contient les propriétés de mise en forme de la lumière pour cette forme. En lecture seule.

GroupItems

Renvoie un GroupShapes objet qui représente les formes individuelles du groupe spécifié. Utilisez la Item(Object) méthode de l’objet GroupShapes pour renvoyer une forme unique à partir du groupe. S’applique aux Shape objets qui représentent des formes groupées. En lecture seule.

HasChart

Retourne des informations sur si un Shape contient un graphique. En lecture seule.

HasDiagram

Renvoie une valeur indiquant si une forme ou une plage de formes contient un diagramme. En lecture seule MsoTriState.

HasDiagramNode

Retourne une valeur indiquant si un nœud de diagramme existe dans une forme ou une plage de formes donnée. En lecture seule MsoTriState.

HasSmartArt

Obtient si un diagramme SmartArt est présent sur la forme spécifiée.

Height

Hauteur de l’objet. En lecture/écriture unique.

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

ID

Retourne le type de l’objet spécifié. Entier en lecture seule.

Left

Distance entre le bord gauche de l’objet et le bord gauche de la colonne A (dans une feuille de calcul) ou le bord gauche de la zone de graphique (sur un graphique). En lecture/écriture unique.

Line

Renvoie un LineFormat objet qui contient des propriétés de mise en forme de ligne pour la forme spécifiée. En lecture seule.

LinkFormat

Retourne un LinkFormat objet 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

True si l’objet est verrouillé, False si l’objet peut être modifié lorsque la feuille est protégée. Boolean (en lecture/écriture).

Name

Cette propriété renvoie ou définit le nom de l'objet. String en lecture/écriture.

Nodes

Renvoie une ShapeNodes collection qui représente la description géométrique de la forme spécifiée. S’applique aux Shape objets qui représentent des dessins de forme libre.

OLEFormat

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

OnAction

Renvoie ou définit le nom d’une macro exécutée quand un utilisateur clique sur l’objet spécifié. String en lecture/écriture.

Parent

Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

ParentGroup

Renvoie un Shape objet qui représente la forme parente commune d’une forme enfant ou d’une plage de formes enfants.

PictureFormat

Renvoie un PictureFormat objet qui contient des propriétés de mise en forme d’image pour la forme spécifiée. S’applique aux Shape objets qui représentent des images ou des objets OLE. En lecture seule.

Placement

Renvoie ou définit la façon dont l’objet est attaché aux cellules situées en dessous. En lecture/écriture XlPlacement.

Reflection

Renvoie un objet qui contient des propriétés de mise en forme de réflexion pour la forme. En lecture seule.

Rotation

Renvoie ou définit la rotation de la forme en degrés. En lecture/écriture unique.

Script

Cette propriété renvoie l'objet Script qui représente un bloc de script ou de code dans la page Web spécifiée. Si la page ne contient pas de script, aucune valeur n'est renvoyée.

Shadow

True si l’objet a une ombre. Boolean (en lecture/écriture).

ShapeStyle

Renvoie ou définit un MsoShapeStyleIndex qui représente le style de forme de la forme. Lecture-écriture.

SmartArt

Obtient un objet qui représente l’objet SmartArt associé à la forme.

SoftEdge

Renvoie un SoftEdgeFormat objet pour une forme spécifiée qui contient des propriétés de mise en forme de bord souple pour la forme. En lecture seule.

TextEffect

Renvoie un TextEffectFormat objet qui contient des propriétés de mise en forme d’effet de texte pour la forme spécifiée. S’applique aux objets T :Microsoft.Office.Interop.Excel.Shape qui représentent WordArt. En lecture seule.

TextFrame

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

TextFrame2

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

ThreeD

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

Title

Obtient ou définit le titre du texte de remplacement associé à la forme spécifiée.

Top

Distance entre le bord supérieur de la forme la plus haute de la plage de formes et le bord supérieur de la feuille de calcul. En lecture/écriture unique.

TopLeftCell

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

Type

Renvoie ou définit le type de forme. En lecture seule MsoShapeType.

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

Visible

Cette propriété détermine si l'objet est visible. En lecture/écriture MsoTriState.

Width

Largeur de l’objet. En lecture/écriture unique.

ZOrderPosition

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

Méthodes

Apply()

S’applique à la mise en forme de forme spécifiée qui a été copiée à l’aide de la PickUp() méthode .

CanvasCropBottom(Single)

Réservé à une utilisation interne.

CanvasCropLeft(Single)

Réservé à une utilisation interne.

CanvasCropRight(Single)

Réservé à une utilisation interne.

CanvasCropTop(Single)

Réservé à une utilisation interne.

Copy()

Copie l'objet dans le Presse-papiers.

CopyPicture(Object, Object)

Copie l'objet sélectionné dans le Presse-papiers, sous forme d'image.

Cut()

Cette méthode coupe l'objet et le place dans le Presse-papiers ou colle l'objet à l'emplacement spécifié.

Delete()

Supprime l'objet.

Duplicate()

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

Flip(MsoFlipCmd)

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

IncrementLeft(Single)

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

IncrementRotation(Single)

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

IncrementTop(Single)

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

RerouteConnections()

Redirige les connecteurs afin qu'ils prennent le chemin le plus court possible entre les formes qu'ils se connectent.

ScaleHeight(Single, MsoTriState, Object)

Met la hauteur de la forme à l’échelle en utilisant un facteur spécifié.

ScaleWidth(Single, MsoTriState, Object)

Met la largeur de la forme à l’échelle en utilisant un facteur spécifié.

Select(Object)

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. Désassemble les images et les objets OLE dans la forme spécifiée. Retourne les formes non groupées sous la forme d’un objet unique ShapeRange .

ZOrder(MsoZOrderCmd)

Déplace la forme spécifiée devant ou derrière les autres formes dans la collection de (autrement dit, modifie position de la forme dans l’ordre z).

S’applique à