Partager via


ShapeRange Interface

Définition

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
Implémente

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

S’applique à