Freigeben über


ShapeRange Schnittstelle

Definition

Repräsentiert einen Formenbereich, eine Gruppe von Formen in einem Dokument ist.

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
Attribute
Implementiert

Hinweise

Ein Formbereich kann nur eine Form oder alle Formen im Dokument enthalten. Sie können die gewünschten Shapes – aus allen Formen im Dokument oder allen Formen in der Auswahl – auswählen, um einen Formbereich zu erstellen. Beispielsweise können Sie eine ShapeRange -Auflistung erstellen, die die ersten drei Formen in einem Dokument, alle markierten Formen in einem Dokument oder alle Freihandformen in einem Dokument enthält.

Hinweis Die meisten Vorgänge, die Sie mit einem Shape -Objekt ausführen können, können Sie auch mit einem ShapeRange-Objekt ausführen, das nur eine Form enthält. Bei einigen Vorgängen, wenn auf ein ShapeRange -Objekt durchgeführt werden, die mehr als eine Form enthält verursacht einen Fehler.

Verwenden Sie Shapes.Range(index), wobei index der Name oder die Indexnummer der Form oder ein Array ist, das entweder Namen oder Indexnummern von Formen enthält, um eine ShapeRange-Auflistung zurückzugeben, die eine Gruppe von Formen in einem Dokument darstellt. Sie können ein Array programmgesteuert verwenden, um ein Array von Namen oder Indexnummern zu erstellen.

Obwohl Sie die Range(Object) -Methode verwenden können, um eine beliebige Anzahl von Formen zurückzugeben, ist es einfacher, die Item[Object] -Methode zu verwenden, wenn Sie nur ein einzelnes Element der Auflistung zurückgeben möchten. Z. B. ist Shapes(1) einfacher als Shapes.Range(1).

Verwenden Sie Selection.ShapeRange(index), wobei index der Name oder die Indexnummer ist, um ein Shape-Objekt zurückzugeben, das eine Form innerhalb einer Auswahl darstellt.

Verwenden Sie die Align(MsoAlignCmd, Int32)-, Distribute(MsoDistributeCmd, Int32)- oder ZOrder(MsoZOrderCmd) -Methode, um eine Gruppe von Formen relativ zueinander oder relativ zum Dokument zu positionieren.

Verwenden Sie die Group()-, Regroup()- oder Ungroup() -Methode, um eine einzelne Form aus einem Formbereich zu erstellen und damit zu arbeiten. Die GroupItems -Eigenschaft für ein Shape-Objekt gibt das GroupShapes -Objekt zurück, das alle Formen darstellt, die zu einer Form gruppiert wurden.

Der Rekorder verwendet beim Aufzeichnen von Shapes immer die ShapeRange -Eigenschaft.

Ein ShapeRange-Objekt enthält InlineShape keine Objekte.

Eigenschaften

Adjustments

Gibt ein Adjustments -Objekt zurück, das Anpassungswerte für alle Anpassungen im angegebenen ShapeRange Objekt enthält, das eine AutoForm oder WordArt darstellt.

AlternativeText

Gibt den alternativen Text zurück, der einer Form in einer Webpräsentation zugeordnet ist, oder legt den Text fest.

Anchor

Gibt ein Range -Objekt zurück, das den Verankerungsbereich für den angegebenen Formbereich darstellt.

Application

Gibt ein Application -Objekt zurück, das die Microsoft Word-Anwendung darstellt.

AutoShapeType

Gibt den Formtyp für das angegebene ShapeRange Objekt zurück, das eine andere AutoForm als eine Linien- oder Freihandform-Zeichnung darstellen muss, oder legt den Formtyp fest.

BackgroundStyle

Ruft die Hintergrundformatvorlage der Formen im angegebenen Formbereich ab oder legt sie fest.

Callout

Gibt ein CalloutFormat -Objekt zurück, das Beschriftungsformatierungseigenschaften für das angegebene ShapeRange Objekt enthält, das Legenden darstellt.

CanvasItems

Gibt ein CanvasShapes -Objekt zurück, das eine Auflistung von Formen in einem Zeichenbereich darstellt.

Child

True, wenn alle Formen in einem Formenbereich untergeordnete Shapes desselben übergeordneten Elements sind.

ConnectionSiteCount

Für die interne Verwendung reserviert.

Connector

Für die interne Verwendung reserviert.

ConnectorFormat

Für die interne Verwendung reserviert.

Count

Gibt die Anzahl der Elemente in der angegebenen Auflistung zurück.

Creator

Gibt eine 32-Bit-Ganzzahl, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde.

Diagram

Gibt ein Diagram-Objekt zurück, zu dem ein Diagrammknoten gehört.

DiagramNode

Gibt ein DiagramNode -Objekt zurück, das einen Knoten in einem Diagramm darstellt.

Fill

Gibt ein FillFormat -Objekt zurück, das Füllformatierungseigenschaften für die angegebene Form enthält.

Glow

Gibt ein GlowFormat -Objekt zurück, das die Leuchtformatierung für einen Formenbereich darstellt. Schreibgeschützt.

GroupItems

Gibt ein GroupShapes -Objekt zurück, das die einzelnen Formen im angegebenen ShapeRange Objekt darstellt, das gruppierte Formen darstellt.

HasDiagram

MsoTrue , wenn eine Form ein Diagramm ist.

HasDiagramNode

MsoTrue , wenn ein Shape ein Diagrammknoten ist.

Height

Gibt die Höhe des angegebenen Objekts in Punkt zurück oder legt sie fest.

HeightRelative

Gibt einen Wert vom Typ Single zurück, der den Prozentsatz der Zielform darstellt, auf die der Formenbereich ausgerichtet ist, oder legt diesen Wert fest. Lese-/Schreibzugriff.

HorizontalFlip

Gibt an, dass eine Form horizontal gekippt wurde.

Hyperlink

Gibt ein WdShapePosition -Objekt zurück, das den Link darstellt, der dem angegebenen ShapeRange Objekt zugeordnet ist.

ID

Gibt den Typ für das angegebene Objekt zurück.

Item[Object]

Gibt ein einzelnes Objekt in einer Auflistung zurück.

LayoutInCell

Gibt einen Integer-Wert zurück, der angibt, ob eine Form in einer Tabelle innerhalb oder außerhalb der Tabelle angezeigt wird. True gibt an, dass eine angegebene Grafik innerhalb der Tabelle angezeigt wird. False gibt an, dass ein angegebenes Bild außerhalb der Tabelle angezeigt wird.

Left

Gibt einen Wert vom Typ Single zurück, der die horizontale Position des angegebenen Formbereichs (gemessen in Punkt) darstellt, oder legt diesen Wert fest. Kann auch eine beliebige gültige WdShapePosition Konstante sein.

LeftRelative

Gibt einen Wert vom Typ Single zurück, der die relative linke Position eines Formenbereichs darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.

Line

Gibt ein LineFormat -Objekt zurück, das Linienformatierungseigenschaften für die angegebene Form enthält.

LockAnchor

True , wenn der Anker des angegebenen ShapeRange Objekts für den Verankerungsbereich gesperrt ist.

LockAspectRatio

MsoTrue, wenn die angegebene Form beim Ändern ihrer Größe die ursprünglichen Proportionen beibehält. MsoFalse, wenn man bei der Größenänderung die Höhe und Breite der Form unabhängig voneinander ändern kann.

Name

Gibt den Namen des angegebenen Objekts zurück oder legt ihn fest.

Nodes

Gibt eine ShapeNodes Auflistung zurück, die die geometrische Beschreibung der angegebenen Form darstellt.

Parent

Gibt ein Objekt zurück, das das übergeordnete Objekt des angegebenen Objekts darstellt.

ParentGroup

Gibt ein Shape -Objekt zurück, das die allgemeine übergeordnete Form eines Bereichs von untergeordneten Formen darstellt.

PictureFormat

Gibt ein PictureFormat Objekt zurück, das Bildformatierungseigenschaften für das angegebene ShapeRange Objekt enthält, das ein Bild oder OLE-Objekt darstellt.

Reflection

Gibt ein ReflectionFormat -Objekt zurück, das die Reflektionsformatierung für einen Bereich von Formen darstellt. Schreibgeschützt.

RelativeHorizontalPosition

Gibt an, was die horizontale Position eines Formbereichs relativ ist.

RelativeHorizontalSize

Gibt eine WdRelativeHorizontalSize Konstante zurück, die das Objekt darstellt, zu dem ein Bereich von Formen relativ ist, oder legt diese Konstante fest. Lese-/Schreibzugriff.

RelativeVerticalPosition

Gibt an, was die vertikale Position eines Formbereichs relativ ist.

RelativeVerticalSize

Gibt eine WdRelativeVerticalSize Konstante zurück, die das Objekt darstellt, zu dem ein Bereich von Formen relativ ist, oder legt diese Konstante fest. Lese-/Schreibzugriff.

Rotation

Gibt die Gradzahl zurück, um die die angegebene Form um die z-Achse gedreht wird, oder legt diese Gradzahl fest. Ein positiver Wert bedeutet Drehung im Uhrzeigersinn; ein negativer Wert bedeutet Drehung gegen den Uhrzeigersinn.

RTF

Für die interne Verwendung reserviert.

Shadow

Gibt ein ShadowFormat -Objekt zurück, das die Schattenformatierung für die angegebene Form darstellt.

ShapeStyle

Ruft die Formart für die Formen im angegebenen Formenbereich ab oder legt diese fest.

SoftEdge

Gibt ein SoftEdgeFormat -Objekt zurück, das die Formatierung der weichen Kante für einen Bereich von Formen darstellt. Schreibgeschützt.

TextEffect

Gibt ein TextEffectFormat -Objekt zurück, das Texteffekt-Formatierungseigenschaften für das angegebene ShapeRange Objekt enthält, das WordArt darstellt.

TextFrame

Gibt ein TextFrame -Objekt zurück, das den Text für die angegebene Form enthält.

TextFrame2

Gibt ein TextFrame2 -Objekt zurück, das den Text für den angegebenen Formenbereich enthält. Schreibgeschützt.

ThreeD

Gibt ein ThreeDFormat Objekt zurück, das 3D -Effektformatierungseigenschaften für die angegebene Form enthält.

Title

Ruft eine Zeichenfolge ab, die einen Titel für die Formen im angegebenen Formbereich enthält, oder legt diese fest.

Top

Gibt die vertikale Position des angegebenen Formbereichs in Punkt zurück oder legt diese fest.

TopRelative

Gibt einen Wert vom Typ Single zurück, der die relative oberste Position eines Formenbereichs darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.

Type

Gibt den Typ der Form zurück.

VerticalFlip

True, wenn die angegebene Form um die vertikale Achse gedreht wurde.

Vertices

Gibt die Koordinaten der Scheitelpunkte der angegebenen Freihandform (und der Kontrollpunkte für Bézierkurven) als Folge von Koordinatenpaaren zurück.

Visible

True, wenn das angegebene Objekt oder die ihm zugewiesene Formatierung sichtbar ist.

Width

Gibt die Breite des angegebenen Objekts (in Punkten) zurück oder legt sie fest.

WidthRelative

Gibt einen Wert vom Typ Single zurück, der die relative Breite eines Formenbereichs darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.

WrapFormat

Gibt ein WrapFormat -Objekt zurück, das die Eigenschaften zum Umschließen von Text um den angegebenen Formbereich enthält.

ZOrderPosition

Gibt die Position der angegebenen Form in der Z-Ordnung zurück.

Methoden

Activate()

Aktiviert das angegebene Objekt.

Align(MsoAlignCmd, Int32)

Richtet die Formen im angegebenen Formenbereich aus.

Apply()

Gilt für die angegebene Formformatierung, die mit der PickUp() -Methode kopiert wurde.

CanvasCropBottom(Single)

Schneidet einen prozentualen Anteil der Höhe eines Zeichenbereichs vom unteren Rand des Zeichenbereichs ab.

CanvasCropLeft(Single)

Schneidet einen prozentualen Anteil der Breite eines Zeichenbereichs vom linken Rand des Zeichenbereichs ab.

CanvasCropRight(Single)

Schneidet einen prozentualen Anteil der Breite eines Zeichenbereichs vom rechten Rand des Zeichenbereichs ab.

CanvasCropTop(Single)

Schneidet einen Prozentsatz der Breite eines Zeichenbereichs vom oberen Rand des Zeichenbereichs ab.

ConvertToFrame()

Konvertiert die angegebene Form in einen Rahmen. Gibt ein Frame -Objekt zurück, das den neuen Frame darstellt.

ConvertToInlineShape()

Konvertiert die angegebene Form in der Zeichnungsebene eines Dokuments in eine Inlineform in der Textebene. Gibt ein InlineShape Objekt zurück, das das Bild oder ole-Objekt darstellt.

Delete()

Löscht das angegebene Objekt.

Distribute(MsoDistributeCmd, Int32)

Verteilt die Formen im angegebenen Formenbereich gleichmäßig.

Duplicate()

Erstellt ein Duplikat des angegebenen ShapeRange Objekts, fügt der Auflistung den Shapes neuen Formenbereich mit einem Standardoffset von den ursprünglichen Formen hinzu und gibt dann das neue Shape Objekt zurück.

Flip(MsoFlipCmd)

Kippt eine Form horizontal oder vertikal.

GetEnumerator()

Repräsentiert einen Formenbereich, eine Gruppe von Formen in einem Dokument ist.

Group()

Gruppiert die Formen im angegebenen Bereich. Gibt die gruppierten Formen als einzelnes Shape Objekt zurück.

IncrementLeft(Single)

Verschiebt die angegebene Form horizontal um die angegebene Punktanzahl.

IncrementRotation(Single)

Ändert die Drehung der angegebenen Form um die z-Achse um die angegebene Gradzahl.

IncrementTop(Single)

Verschiebt die angegebene Form vertikal um die angegebene Anzahl von Punkten.

PickUp()

Kopiert die Formatierung der angegebenen Form.

Regroup()

Stellt die Gruppe wieder her, der der angegebene Formbereich zuvor angehörte. Gibt die neu gruppierten Formen als einzelnes Shape Objekt zurück.

RerouteConnections()

Für die interne Verwendung reserviert.

ScaleHeight(Single, MsoTriState, MsoScaleFrom)

Skaliert die Höhe der Form anhand eines angegebenen Faktors.

ScaleWidth(Single, MsoTriState, MsoScaleFrom)

Skaliert die Breite der Form anhand eines angegebenen Faktors.

Select(Object)

Markiert das angegebene Objekt.

SetShapesDefaultProperties()

Wendet die Formatierung der angegebenen Form auf ein Standard-Shape für dieses Dokument an. Neue Formen erben viele Attribute von der Standardform.

Ungroup()

Hebt die Gruppierung aller gruppierten Formen in der angegebenen Form oder einen Bereich von Formen. Zerlegt Bilder und OLE-Objekte innerhalb der angegebenen Form oder einen Bereich von Formen. Gibt die nicht gruppierten Formen als einzelnes ShapeRange Objekt zurück.

ZOrder(MsoZOrderCmd)

Verschiebt die angegebene Form vor oder hinter andere Formen in der Sammlung (d. h. ändert die Position der Form in der Z-Reihenfolge).

Gilt für: