ShapeRange-Objekt (Excel)

  • Artikel

Repräsentiert einen Formenbereich, wobei es sich um eine Formengruppe in einem Dokument handelt.

HinwBemerkungeneise

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

Beispiel

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

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 , 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 beispielsweise 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

Zurückgeben aller oder einiger ausgewählter Formen in einem Dokument

Verwenden Sie die Eigenschaft ShapeRange des Objekts Selection, 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)

Auswahl verwenden. 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.