ShapeRange-Objekt (PowerPoint)

  • Artikel

Stellt einen Formbereich dar, der eine Reihe von Formen eines Dokuments umfasst. Ein Formbereich kann nur eine Form oder sämtliche Formen eines Dokuments enthalten.

HinwBemerkungeneise

Sie können die gewünschten Shapes einschließen – aus allen Formen im Dokument oder allen Formen in der Auswahl ausgewählt – um einen Formbereich zu erstellen. So können Sie z. B. eine Sammlung ShapeRange erstellen, die die ersten drei Formen in einem Dokument, alle ausgewählten Formen in einem Dokument oder alle Freihandformen in einem Dokument enthält.

Eine Übersicht darüber, wie Sie mit einer einzelnen Form oder mit mehreren Shapes gleichzeitig arbeiten, finden Sie unter Arbeiten mit Shapes (Zeichnungsobjekte).

Im folgenden Beispiel werden folgende Aktionen beschrieben:

  • Gibt einen Satz von Shapes zurück, die Sie anhand des Namens oder der Indexnummer angeben.

  • Zurückgeben aller oder einiger der ausgewählten Formen eines Dokuments

Beispiel

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. Verwenden Sie die Array-Funktion , um ein Array von Namen oder Indexnummern zu erstellen. Im folgenden Beispiel wird das Füllmuster für die Formen 1 und 3 in myDocument gesetzt.

Set myDocument = ActivePresentation.Slides(1)

myDocument.Shapes.Range(Array(1, 3)).Fill _

    .Patterned msoPatternHorizontalBrick

Im folgenden Beispiel wird das Füllmuster für die Formen namens "Oval 4" und "Rectangle 5" in myDocument gesetzt.

Set myDocument = ActivePresentation.Slides(1)

Set myRange = myDocument.Shapes _

    .Range(Array("Oval 4", "Rectangle 5"))

myRange.Fill.Patterned msoPatternHorizontalBrick

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

Verwenden Sie die ShapeRange-Eigenschaft des Selection-Objekts , um alle Formen in der Auswahl zurückzugeben. Im folgenden Beispiel wird die Vordergrundfarbe für alle Formen in der Auswahl in Fenster 1 festgelegt, wobei davon ausgegangen wird, dass mindestens eine Form in der Auswahl vorhanden ist.

Windows(1).Selection.ShapeRange.Fill.ForeColor _

    .RGB = RGB(255, 0, 255)

Verwenden Sie Selection.ShapeRange (Index), wobei index der Name der Form oder die Indexnummer ist, um eine einzelne Form innerhalb der Auswahl zurückzugeben. Im folgenden Beispiel wird die Vordergrundfüllfarbe für Form 2 in der Sammlung von ausgewählten Formen in Fenster 1 gesetzt, wobei davon ausgegangen wird, dass sich mindestens zwei Formen in der Auswahl befinden.

Windows(1).Selection.ShapeRange(2).Fill.ForeColor _

    .RGB = RGB(255, 0, 255)

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.