ShapeRange Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Représente une plage de formes, constituée d'un ensemble de formes sur un document.

public interface class ShapeRange : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("000209B5-0000-0000-C000-000000000046")]
public interface ShapeRange : System.Collections.IEnumerable

type ShapeRange = interface
    interface IEnumerable

Public Interface ShapeRange
Implements IEnumerable

Attributs

GuidAttribute

Implémente

IEnumerable

Remarques

Une plage de formes peut contenir d'une à toutes les formes d'un document. Vous pouvez inclure les formes souhaitées (choisies parmi toutes les formes du document ou toutes les formes de la sélection) pour construire une plage de formes. Par exemple, vous pouvez construire une collection ShapeRange qui contient les trois premières formes dans un document, toutes les formes sélectionnées dans un document ou toutes les formes libres d'un document.

Note La plupart des opérations que vous pouvez effectuer avec un Shape objet, vous pouvez également le faire avec un objet ShapeRange qui ne contient qu’une seule forme. Certaines opérations sont effectuées sur un objet ShapeRange qui contienne plusieurs formes, provoquent une erreur.

Utilisez Shapes.Range(index), où index est le nom ou le numéro d’index de la forme ou un tableau qui contient des noms ou des numéros d’index de formes, pour renvoyer une collection ShapeRange qui représente un ensemble de formes sur un document. Vous pouvez utiliser un tableau par programmation pour construire un tableau de noms ou de numéros d’index.

Bien que vous puissiez utiliser la Range(Object) méthode pour renvoyer un nombre quelconque de formes, il est plus simple d’utiliser la Item[Object] méthode si vous souhaitez retourner un seul membre de la collection. Par exemple, Shapes(1) est plus simple que Shapes.Range(1).

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

Utilisez la Align(MsoAlignCmd, Int32)méthode , Distribute(MsoDistributeCmd, Int32)ou ZOrder(MsoZOrderCmd) pour positionner un ensemble de formes les unes par rapport aux autres ou par rapport au document.

Utilisez la Group()méthode , Regroup()ou Ungroup() pour créer et utiliser une seule forme formée à partir d’une plage de formes. La GroupItems propriété d’un objet Shape renvoie l’objet GroupShapes , qui représente toutes les formes qui ont été regroupées pour former une seule forme.

L’enregistreur utilise toujours la propriété lors de l’enregistrement ShapeRange des formes.

Un objet ShapeRange n’inclut pas d’objets InlineShape .

Propriétés

Adjustments	Renvoie un Adjustments objet qui contient des valeurs d’ajustement pour tous les ajustements dans l’objet spécifié ShapeRange 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 Range objet qui représente la plage d’ancrage pour la plage de formes spécifiée.
Application	Renvoie un Application objet qui représente l’application Microsoft Word.
AutoShapeType	Cette propriété renvoie ou définit le type de forme de l’objet spécifié ShapeRange , qui doit représenter une forme automatique autre qu’un dessin de trait ou de forme libre.
BackgroundStyle	Obtient ou définit le style d’arrière-plan des formes dans la plage de formes spécifiée.
Callout	Renvoie un CalloutFormat objet qui contient des propriétés de mise en forme de légende pour l’objet spécifié ShapeRange qui représente des légendes.
CanvasItems	Renvoie un CanvasShapes objet qui représente une collection de formes dans un canevas de dessin.
Child	True si toutes les formes d’une plage de formes sont des formes enfants du même parent.
ConnectionSiteCount	Réservé à une utilisation interne.
Connector	Réservé à une utilisation interne.
ConnectorFormat	Réservé à une utilisation interne.
Count	Retourne le nombre d’éléments dans la collection spécifiée.
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle l'objet spécifié a été créé.
Diagram	Renvoie un objet Diagram auquel appartient un nœud de diagramme.
DiagramNode	Renvoie un DiagramNode objet qui représente un nœud dans un diagramme.
Fill	Renvoie un FillFormat objet qui contient des propriétés de mise en forme de remplissage pour la forme spécifiée.
Glow	Renvoie un GlowFormat objet qui représente la mise en forme de l’éclat d’une plage de formes. En lecture seule.
GroupItems	Renvoie un GroupShapes objet qui représente les formes individuelles dans l’objet spécifié ShapeRange qui représente les formes groupées.
HasDiagram	MsoTrue si une forme est un diagramme.
HasDiagramNode	MsoTrue si une forme est un nœud de diagramme.
Height	Renvoie ou définit la hauteur de l’objet spécifié en points.
HeightRelative	Renvoie ou définit une valeur de type Single qui représente le pourcentage de la forme cible à laquelle la plage de formes est dimensionnée. Lecture-écriture.
HorizontalFlip	Indique qu'une forme a été retournée horizontalement.
Hyperlink	Renvoie un WdShapePosition objet qui représente le lien hypertexte associé à l’objet spécifié ShapeRange .
ID	Retourne le type de l’objet spécifié.
Item[Object]	Renvoie un objet spécifique appartenant à une collection.
LayoutInCell	Renvoie un entier qui indique si une forme d’un tableau est affichée à l’intérieur ou à l’extérieur de la table. La valeur True indique que l'image spécifiée s'affiche à l'intérieur du tableau. False indique qu’une image spécifiée est affichée en dehors de la table.
Left	Renvoie ou définit une valeur de type Single qui représente la position horizontale, exprimée en points, de la plage de formes spécifiée. Peut également être n’importe quelle constante valide WdShapePosition .
LeftRelative	Cette propriété renvoie ou définit une valeur unique qui représente la position gauche relative d'une plage de formes. Lecture-écriture.
Line	Renvoie un LineFormat objet qui contient des propriétés de mise en forme de ligne pour la forme spécifiée.
LockAnchor	True si l’ancre de l’objet spécifié ShapeRange est verrouillée à la plage d’ancrage.
LockAspectRatio	MsoTrue si la forme spécifiée conserve ses proportions d'origine lorsque vous la redimensionnez. MsoFalse si vous pouvez modifier la hauteur et la largeur de la forme indépendamment une de l'autre lorsque vous la redimensionnez.
Name	Cette propriété renvoie ou définit le nom de l'objet spécifié.
Nodes	Renvoie une ShapeNodes collection qui représente la description géométrique de la forme spécifiée.
Parent	Cette propriété renvoie un objet qui représente l'objet parent de l'objet spécifié.
ParentGroup	Renvoie un Shape objet qui représente la forme parente commune d’une plage de formes enfants.
PictureFormat	Renvoie un PictureFormat objet qui contient des propriétés de mise en forme d’image pour l’objet spécifié ShapeRange qui représente une image ou un objet OLE.
Reflection	Renvoie un ReflectionFormat objet qui représente la mise en forme de réflexion d’une plage de formes. En lecture seule.
RelativeHorizontalPosition	Spécifie la position horizontale d’une plage de formes relative.
RelativeHorizontalSize	Renvoie ou définit une WdRelativeHorizontalSize constante qui représente l’objet auquel une plage de formes est relative. Lecture-écriture.
RelativeVerticalPosition	Spécifie la position verticale d’une plage de formes relative.
RelativeVerticalSize	Renvoie ou définit une WdRelativeVerticalSize constante qui représente l’objet auquel une plage de formes est relative. Lecture-écriture.
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. Une valeur positive indique une rotation vers la droite ; une valeur négative indique une rotation dans le sens inverse.
RTF	Réservé à une utilisation interne.
Shadow	Renvoie un ShadowFormat objet qui représente la mise en forme de l’ombre pour la forme spécifiée.
ShapeStyle	Obtient ou définit le style de forme des formes de la plage de formes spécifiée.
SoftEdge	Renvoie un SoftEdgeFormat objet qui représente la mise en forme des bords souples pour une plage de formes. En lecture seule.
TextEffect	Renvoie un TextEffectFormat objet qui contient des propriétés de mise en forme d’effet de texte pour l’objet spécifié ShapeRange qui représente WordArt.
TextFrame	Renvoie un TextFrame objet qui contient le texte de la forme spécifiée.
TextFrame2	Renvoie un TextFrame2 objet qui contient le texte de la plage de formes 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.
Title	Obtient ou définit une chaîne qui contient un titre pour les formes dans la plage de formes spécifiée.
Top	Renvoie ou définit la position verticale de la plage de formes spécifiée en points.
TopRelative	Cette propriété renvoie ou définit une valeur unique qui représente la position supérieure relative d'une plage de formes. Lecture-écriture.
Type	Renvoie 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.
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	Renvoie ou définit la largeur de l’objet spécifié, en points.
WidthRelative	Cette propriété renvoie ou définit une valeur unique qui représente la largeur relative d'une plage de formes. Lecture-écriture.
WrapFormat	Renvoie un WrapFormat objet qui contient les propriétés permettant d’encapsuler le texte autour de la plage de formes spécifiée.
ZOrderPosition	Cette propriété renvoie la position de la forme spécifiée dans l'ordre de superposition.

Méthodes

Activate()	Active l'objet spécifié.
Align(MsoAlignCmd, Int32)	Aligne les formes contenues dans la plage de formes spécifiée.
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)	Rogne un pourcentage de la hauteur d'une zone de dessin à partir du bas du dessin.
CanvasCropLeft(Single)	Rogne un pourcentage de la largeur d'une zone de dessin à partir du côté gauche du dessin.
CanvasCropRight(Single)	Rogne un pourcentage de la largeur d'une zone de dessin à partir du côté droit du dessin.
CanvasCropTop(Single)	Rogne un pourcentage de la largeur d’un canevas de dessin à partir du haut du canevas.
ConvertToFrame()	Convertit la forme spécifiée en cadre. Renvoie un Frame objet qui représente le nouveau cadre.
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. Renvoie un InlineShape objet qui représente l’image ou l’objet OLE.
Delete()	Cette méthode supprime l'objet spécifié.
Distribute(MsoDistributeCmd, Int32)	Répartit uniformément les formes dans la plage de formes spécifiée.
Duplicate()	Crée un doublon de l’objet spécifié ShapeRange , ajoute la nouvelle plage de formes à la Shapes collection à un décalage standard par rapport aux formes d’origine, puis retourne le nouvel Shape objet.
Flip(MsoFlipCmd)	Fait pivoter une forme à l'horizontale ou à la verticale.
GetEnumerator()	Représente une plage de formes, constituée d'un ensemble de formes sur un document.
Group()	Regroupe les formes dans la plage spécifiée. Retourne les formes groupées sous la forme d’un seul Shape objet.
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.
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.
Regroup()	Cette méthode reforme le groupe auquel la plage de formes spécifiée appartenait auparavant. Retourne les formes regroupées sous la forme d’un objet unique Shape .
RerouteConnections()	Réservé à une utilisation interne.
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	Met la hauteur de la forme à l’échelle en utilisant un facteur spécifié.
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	Met la largeur de la forme à l’échelle en utilisant un facteur spécifié.
Select(Object)	Sélectionne l'objet spécifié.
SetShapesDefaultProperties()	Applique la mise en forme de la forme spécifiée à une forme par défaut pour ce document. Les nouvelles formes reçoivent un grand nombre des attributs de la forme 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. 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).