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 de votre choix, sélectionnées 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 utiliser 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 les noms ou les numéros d’index des formes, pour renvoyer une collection ShapeRange qui représente un ensemble de formes dans un document. Vous pouvez utiliser par programme un tableau pour construire un tableau de noms ou de numéros d’index.

Bien que vous puissiez utiliser la Range(Object) méthode pour renvoyer n’importe quel nombre de formes, il est plus simple d’utiliser la Item[Object] méthode si vous ne souhaitez renvoyer qu’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) Distribute(MsoDistributeCmd, Int32) méthode, ou ZOrder(MsoZOrderCmd) pour positionner un ensemble de formes par rapport aux autres ou par rapport au document.

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

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

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

Propriétés

Adjustments

Renvoie un Adjustments objet qui contient les valeurs d’ajustement pour tous les ajustements dans l' ShapeRange objet spécifié 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 Object qui représente la plage d’ancrage de la plage de formes spécifiée.

Application

Renvoie un Application Object qui représente l’application Microsoft Word.

AutoShapeType

Cette propriété renvoie ou définit le type de forme pour l' ShapeRange objet spécifié, qui doit représenter une forme automatique autre qu’un trait ou une 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 les propriétés de mise en forme de la légende pour l' ShapeRange objet spécifié qui représente les légendes.

CanvasItems

Renvoie un CanvasShapes Object qui représente une collection de formes dans une zone de dessin.

Child

True si toutes les formes d’une plage de formes sont des formes enfants du même parent.

ConnectionSiteCount

Réservé à un usage interne.

Connector

Réservé à un usage interne.

ConnectorFormat

Réservé à un usage interne.

Count

Renvoie 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 les propriétés de mise en forme du remplissage pour la forme spécifiée.

Glow

Renvoie un GlowFormat Object qui représente la mise en forme de lumière pour une plage de formes. En lecture seule.

GroupItems

Renvoie un GroupShapes Object qui représente les formes individuelles dans l' ShapeRange objet spécifié qui représente des formes groupées.

HasDiagram

MsoTrue si une forme est un diagramme.

HasDiagramNode

MsoTrue si une forme est un nœud de diagramme.

Height

Cette propriété 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 en fonction de laquelle la plage de formes est dimensionnée. En lecture/écriture

HorizontalFlip

Indique qu'une forme a été retournée horizontalement.

Hyperlink

Renvoie un WdShapePosition Object qui représente le lien hypertexte associé à l' ShapeRange objet spécifié.

ID

Renvoie 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 dans un tableau s’affiche à l’intérieur ou à l’extérieur du tableau. La valeur True indique que l'image spécifiée s'affiche à l'intérieur du tableau. La valeur false indique que l’image spécifiée est affichée en dehors du tableau.

Left

Cette propriété renvoie ou définit une valeur unique qui représente la position horizontale, exprimée en points, de la plage de formes spécifiée. Peut également être n’importe quelle WdShapePosition constante valide.

LeftRelative

Cette propriété renvoie ou définit une valeur unique qui représente la position gauche relative d’une plage de formes. En lecture/écriture

Line

Renvoie un LineFormat objet qui contient les propriétés de mise en forme du trait pour la forme spécifiée.

LockAnchor

True si l' ShapeRange ancrage de l’objet spécifié est verrouillé à 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 Object qui représente la forme parente commune d’une plage de formes enfants.

PictureFormat

Renvoie un PictureFormat objet qui contient les propriétés de mise en forme de l' ShapeRange objet spécifié qui représente une image ou un objet OLE.

Reflection

Renvoie un ReflectionFormat Object qui représente la mise en forme de réflexion pour une plage de formes. En lecture seule.

RelativeHorizontalPosition

Indique la position relative de la position horizontale d’une plage de formes.

RelativeHorizontalSize

Cette propriété renvoie ou définit une WdRelativeHorizontalSize constante qui représente l’objet auquel une plage de formes est relative. En lecture/écriture

RelativeVerticalPosition

Indique la position relative de la position verticale d’une plage de formes.

RelativeVerticalSize

Cette propriété renvoie ou définit une WdRelativeVerticalSize constante qui représente l’objet auquel une plage de formes est relative. En 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 Object qui représente la mise en forme de l’ombre de la forme spécifiée.

ShapeStyle

Obtient ou définit le style de forme des formes dans la plage de formes spécifiée.

SoftEdge

Renvoie un SoftEdgeFormat Object qui représente la mise en forme de bordure arrondie pour une plage de formes. En lecture seule.

TextEffect

Renvoie un TextEffectFormat objet qui contient les propriétés de mise en forme des effets de texte pour l' ShapeRange objet spécifié qui représente l’objet 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 les propriétés de mise en forme des effets 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

Cette propriété 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. En 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. En lecture/écriture

WrapFormat

Renvoie un WrapFormat objet qui contient les propriétés d’habillage du 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 la 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’une zone de dessin à partir du haut de la zone de dessin.

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 Object 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()

Cette méthode crée une copie de l' ShapeRange objet spécifié, ajoute la nouvelle plage de formes à la Shapes collection à un décalage standard par rapport aux formes d’origine, puis renvoie le nouvel Shape objet.

Flip(MsoFlipCmd)

Fait pivoter une forme à l'horizontale ou à la verticale.

GetEnumerator()
Group()

Regroupe les formes dans la plage spécifiée. Renvoie les formes groupées sous la forme d’un Shape objet unique.

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. Renvoie les formes regroupées sous la forme d’un Shape objet unique.

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. Renvoie les formes dissociées en tant qu' ShapeRange objet unique.

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 à