ShapeRange Schnittstelle

Definition

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

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

GuidAttribute

Implementiert

IEnumerable

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