ShapeRange-Objekt (PowerPoint)

Repräsentiert einen Formenbereich, eine Gruppe von Formen in einem Dokument ist. Ein Formbereich kann nur eine Form oder sämtliche Formen eines Dokuments enthalten.

Hinweise

Um einen Formenbereich zu erstellen, können Sie die gewünschten Shapes einbeziehen – aus allen Shapes im Dokument oder aus allen Shapes in der Auswahl. 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 über das Arbeiten mit einem einzelnen Shape oder mit mehreren Shapes gleichzeitig finden Sie unter Arbeiten mit Shapes (Zeichnungsobjekten).

Im folgenden Beispiel werden folgende Aktionen beschrieben:

  • Geben Sie eine Reihe von Formen zurück, die Sie anhand ihres Namens oder ihrer 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 des Shapes ist, oder ein Array, das entweder Namen oder Indexnummern von Shapes enthält, um eine ShapeRange-Auflistung zurückzugeben, die eine Gruppe von Shapes in einem Dokument darstellt. Verwenden Sie die Matrix-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

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

Verwenden Sie die ShapeRange-Eigenschaft des Selection-Objekts , um alle Shapes in der Auswahl zurückzugeben. Im folgenden Beispiel wird die Vordergrundfarbe der Füllung für alle Shapes in der Auswahl im ersten Fenster festgelegt, wobei davon ausgegangen wird, dass die Auswahl mindestens ein Shape enthält.

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

    .RGB = RGB(255, 0, 255)

Verwenden Sie Selection.ShapeRange (index), wobei index der Name des Shapes oder die Indexnummer ist, um ein einzelnes Shape 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.

  • Last updated on