Shape Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 collection, qui représente un sous-ensemble spécifié des formes d’un document (par exemple, un objet ShapeRange peut représenter les formes 1 et 4 du document ou toutes les formes sélectionnées sur le document) ; et l’objet Shape, qui représente une seule forme d’un ShapeRange 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( ), où est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape index qui représente une index forme.
Chaque forme reçoit un nom par défaut lorsque vous l’ajoutez à la collection Shapes. Pour donner à la forme un nom plus significatif, utilisez la Name propriété.
Renvoi d’une forme au sein de la sélection
Utilisez Selection.ShapeRange( ), où est le nom de la forme ou le numéro d’index, pour renvoyer un objet Shape qui représente une forme index dans la index 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 ou la EndConnectedShape propriété.
Renvoi d’une nouvelle forme libre
Utilisez les méthodes et les méthodes pour définir la géométrie d’une nouvelle forme libre et utilisez la méthode pour créer la forme libre et renvoyer l’objet Shape qui BuildFreeform(MsoEditingType, Single, Single) AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) la ConvertToShape() représente.
Renvoi d’une seule forme au sein d’un groupe
Utilisez GroupItems( ), où est le nom de la forme ou le numéro d’index dans le groupe, pour renvoyer un objet Shape qui représente une seule forme dans une index forme index groupée.
Renvoi d’un groupe de formes nouvellement constitué
Utilisez la ou méthode pour grouper une plage de formes et renvoyer un seul objet Shape qui Group() Regroup() 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 (de remplacement) d’un objet lorsque l’objet Shape est enregistré dans une page Web. String en lecture/écriture. |
| Application |
Renvoie un Application objet qui représente l’application Microsoft Excel’application. En lecture seule. |
| AutoShapeType |
Renvoie ou définit le type de forme de l’objet spécifié, qui doit représenter une forme automatique autre qu’un trait, une forme libre ou Shape un connecteur. En MsoAutoShapeType lecture/écriture. |
| BackgroundStyle |
Cette propriété renvoie ou définit le style d'arrière-plan. En 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 MsoBlackWhiteMode lecture/écriture. |
| BottomRightCell |
Renvoie un objet qui représente la cellule qui se trouve sous le coin inférieur Range droit de l’objet. En lecture seule. |
| Callout |
Renvoie un objet qui contient les propriétés de mise en forme de CalloutFormat la forme spécifiée. S’applique Shape aux objets qui représentent des traits de ligne. En lecture seule. |
| CanvasItems |
Réservé à un usage interne. |
| Chart |
Renvoie un objet qui représente le _Chart contenu dans Shape le . 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 MsoTriState seule. |
| 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 MsoTriState seule. |
| ConnectorFormat |
Renvoie un ConnectorFormat objet qui contient les propriétés de mise en forme du connecteur. ShapeS’applique aux objets qui représentent des connecteurs. En lecture seule. |
| ControlFormat |
Renvoie un ControlFormat objet qui contient des propriétés Microsoft Excel contrôle. 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 XlCreator seule. |
| Diagram |
Renvoie 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 objet qui contient les propriétés de mise en forme de FillFormat remplissage pour le graphique ou la forme spécifiée. En lecture seule. |
| FormControlType |
Cette propriété renvoie le type de contrôle Microsoft Excel. En lecture XlFormControl seule. |
| Glow |
Renvoie un objet pour une forme spécifiée qui contient les propriétés de mise en forme de lumière pour cette forme. En lecture seule. |
| GroupItems |
Renvoie un GroupShapes objet qui représente les formes individuelles dans le groupe spécifié. Utilisez la Item(Object) méthode de l’objet GroupShapes pour renvoyer une seule forme du groupe. S’applique Shape aux objets qui représentent des formes groupées. En lecture seule. |
| HasChart |
Renvoie des informations sur le cas Shape où un graphique est contenu. En lecture seule. |
| HasDiagram |
Renvoie si une forme ou une plage de formes contient un diagramme. En lecture MsoTriState seule. |
| HasDiagramNode |
Renvoie une valeur indiquant si un nœud de diagramme existe dans une forme ou une plage de formes donnée. En lecture MsoTriState seule. |
| HasSmartArt |
Obtient une indication de présence d’un diagramme SmartArt 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 MsoTriState seule. |
| Hyperlink |
Renvoie un Hyperlink objet qui représente le lien hypertexte de la forme. |
| ID |
Renvoie 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 objet qui contient les propriétés de mise en forme LineFormat de trait pour la forme spécifiée. En lecture seule. |
| LinkFormat |
Renvoie un LinkFormat objet qui contient des propriétés d’objet OLE liées. 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 MsoTriState lecture/écriture. |
| 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. Type de données String en lecture-écriture. |
| Nodes |
Renvoie une ShapeNodes collection qui représente la description géométrique de la forme spécifiée. ShapeS’applique aux 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é. Type de données String en lecture/écriture. |
| Parent |
Renvoie l'objet parent de l'objet spécifié. En lecture seule. |
| ParentGroup |
Renvoie un objet qui représente la forme parente commune d’une forme enfant ou Shape d’une plage de formes enfants. |
| PictureFormat |
Renvoie un objet qui contient les propriétés de mise en forme PictureFormat d’image pour la forme spécifiée. ShapeS’applique aux 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 en dessous. En XlPlacement lecture/écriture. |
| Reflection |
Renvoie un objet qui contient les 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 aucun script n'est associé à la page, aucun objet n'est renvoyé. |
| Shadow |
True si l’objet a une ombre. Boolean (en lecture/écriture). |
| ShapeStyle |
Renvoie ou définit une MsoShapeStyleIndex qui représente le style de forme de la forme. En lecture/écriture |
| SmartArt |
Obtient un objet qui représente l’objet SmartArt associé à la forme. |
| SoftEdge |
Renvoie un objet pour une forme spécifiée qui contient les propriétés de mise en forme de bordures SoftEdgeFormat souples pour la forme. En lecture seule. |
| TextEffect |
Renvoie un objet qui contient les propriétés de mise en forme TextEffectFormat d’effet de texte pour la forme spécifiée. S’applique à T:Microsoft.Office. Interop. Excel. Objets Shape qui représentent des objets 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 objet qui contient des propriétés de mise en forme ThreeDFormat 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 objet qui représente la cellule qui se trouve sous le coin supérieur gauche Range de l’objet spécifié. En lecture seule. |
| Type |
Renvoie ou définit le type de forme. En lecture MsoShapeType seule. |
| VerticalFlip |
Cette propriété a la valeur True si la forme spécifiée est retournée autour de l’axe vertical. En lecture MsoTriState seule. |
| 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 MsoTriState lecture/écriture. |
| 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é à un usage interne. |
| CanvasCropLeft(Single) |
Réservé à un usage interne. |
| CanvasCropRight(Single) |
Réservé à un usage interne. |
| CanvasCropTop(Single) |
Réservé à un usage 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. Renvoie les formes non groupées sous la forme d’un ShapeRange seul objet. |
| 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). |