ShapeRange-Objekt (Word)

  • Artikel

Repräsentiert einen Formenbereich, eine Gruppe von Formen in einem Dokument ist. Ein Formbereich muss mindestens eine Form und kann höchstens alle Formen in einem Dokument enthalten.

HinwBemerkungeneise

Sie können die gewünschten Shapes – aus allen Formen im Dokument oder aus 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 ein Shape -Objekt möglich, auch mit einem ShapeRange -Objekt möglich, die 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 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. Verwenden Sie die Array-Funktion von Visual Basic, um ein Array von Namen oder Indexnummern zu erstellen. Im folgenden Beispiel wird das Füllmuster für die Formen 1 und 3 im aktiven Dokument festgelegt.

ActiveDocument.Shapes.Range(Array(1, 3)).Fill.Patterned _ 
 msoPatternHorizontalBrick

Im folgenden Beispiel werden die Formen Oval 4 und Rechteck 5 im aktiven Dokument ausgewählt.

ActiveDocument.Shapes.Range(Array("Oval 4", "Rectangle 5")).Select

Obwohl Sie eine beliebige Anzahl von Shapes zurückgeben die Range -Methode verwenden können, ist es einfacher, die Item -Methode verwenden können, wenn Sie nur ein einzelnes Element der Auflistung zurückgeben möchten. ist beispielsweise Shapes(1) einfacher als Shapes.Range(1).

Verwenden Sie ShapeRange (Index), wobei index der Name oder die Indexnummer ist, um ein Shape-Objekt zurückzugeben, das eine Form innerhalb einer Auswahl darstellt. Das folgende Beispiel legt die Füllung für die erste Form in der Auswahl, vorausgesetzt, dass die Auswahl mindestens eine Form enthält.

Selection.ShapeRange(1).Fill.ForeColor.RGB = RGB(255, 0, 0)

In diesem Beispiel werden alle Formen im ersten Abschnitt des aktiven Dokuments markiert.

Set myRange = ActiveDocument.Sections(1).Range 
myRange.ShapeRange.Select

Verwenden Sie die Align-, Distributed- oder ZOrder-Methode , um eine Reihe von Formen relativ zueinander oder relativ zum Dokument zu positionieren.

Verwenden Sie die Group-, Regroup- oder UnGroup-Methode , um eine einzelne Form zu erstellen und zu verwenden, die aus einem Formbereich gebildet wurde. Mit der GroupItems -Eigenschaft für ein Shape -Objekt wird das GroupShapes -Objekt zurückgegeben, das alle Formen darstellt, die gruppiert wurden, um eine Form zu bilden.

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

Hinweis

Ein ShapeRange-Objekt enthält keine InlineShape-Objekte .

Methoden

Eigenschaften

Siehe auch

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.