ShapeRange-Objekt (Excel)

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

Hinweise

Ein Formbereich kann nur eine Form oder sämtliche Formen eines Dokuments enthalten. 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.

Beispiel

Zurückgeben einer Reihe von Shapes, die Sie anhand des Namens oder der Indexnummer angeben

Verwenden Sie 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 = Worksheets(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.

Obwohl Sie mit der Eigenschaft Rangeeine beliebige Anzahl an Formen oder Folien zurückgeben können, ist es einfacher, die Methode Item zu verwenden, wenn Sie nur ein einzelnes Element der Sammlung zurückgeben möchten. Ist z. B. Shapes(1) einfacher als Shapes.Range(1).

Set myDocument = Worksheets(1) 
Set myRange = myDocument.Shapes.Range(Array("Oval 4", _ 
 "Rectangle 5")) 
myRange.Fill.Patterned msoPatternHorizontalBrick

Alle oder einige der ausgewählten Shapes in einem Dokument zurückgeben

Verwenden Sie die Eigenschaft ShapeRange des Objekts Selection, um alle Formen 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 die Auswahl. 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