Shape-Objekt (Excel)

  • Artikel

Repräsentiert ein Objekt in der Zeichnungsschicht wie eine AutoForm, eine Freihandform, ein OLE-Objekt oder ein Bild.

HinwBemerkungeneise

Das Shape-Objekt ist ein Element der Shapes-Auflistung . Die Sammlung Shapes enthält alle Formen in einer Arbeitsmappe.

Hinweis

Es gibt drei Objekte, die Formen darstellen: die Shapes-Auflistung , die alle Formen in einer Arbeitsmappe darstellt; die ShapeRange-Auflistung , die eine angegebene Teilmenge der Formen in einer Arbeitsmappe darstellt (z. B. könnte ein ShapeRange-Objekt die Shapes 1 und vier in der Arbeitsmappe darstellen oder alle ausgewählten Formen in der Arbeitsmappe darstellen); und das Shape-Objekt , das eine einzelne Form auf einem Arbeitsblatt darstellt. Wenn Sie mit mehreren Formen gleichzeitig oder mit Formen innerhalb einer Auswahl arbeiten möchten, verwenden Sie eine Sammlung ShapeRange.

Rückzukehren... Verwenden...
Ein Shape-Objekt , das eine der durch einen Verbinder angefügten Formen darstellt. Die BeginConnectedShape - oder EndConnectedShape-Eigenschaft des ConnectorFormat-Objekts .
Ein neu erstelltes Freihandformular Die Methoden BuildFreeform und AddNodes definieren die Geometrie einer neuen Freihandform und verwenden die ConvertToShape-Methode , um die Freihandform zu erstellen und das Shape-Objekt zurückzugeben, das sie darstellt.
Ein Shape-Objekt , das eine einzelne Form in einer gruppierten Form darstellt GroupItems (Index), wobei index der Name der Form oder die Indexnummer innerhalb der Gruppe ist.
Eine neu gebildete Gruppe von Formen Die Group- oder Regroup-Methode des ShapeRange-Objekts , um einen Bereich von Formen zu gruppieren und ein einzelnes Shape-Objekt zurückzugeben, das die neu gebildete Gruppe darstellt. Nachdem eine Gruppe gebildet wurde, können Sie mit der Gruppe genauso arbeiten wie mit jeder anderen Form.
Ein Shape-Objekt , das eine vorhandene Form darstellt Shapes (Index), wobei index der Name der Form oder die Indexnummer ist.
Ein Shape-Objekt , das eine Form innerhalb der Auswahl darstellt Auswahl. ShapeRange (Index), wobei index der Shape-Name oder die Indexnummer ist.

Beispiel

In dem folgenden Beispiel wird Form 1 und die Form "Rectangle 1" in myDocument horizontal gespiegelt.

Set myDocument = Worksheets(1) 
myDocument.Shapes(1).Flip msoFlipHorizontal 
myDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal

Jeder Form wird ein Standardname zugewiesen, wenn Sie sie der Sammlung Shapes hinzufügen. Um der Form einen transparenteren Namen zuzuweisen, verwenden Sie die Eigenschaft Name. Im folgenden Beispiel wird myDocument ein Rechteck hinzugefügt, ihm der Name Rotes Quadrat zugewiesen, und anschließend wird die Vordergrundfarbe und linienart festgelegt.

Set myDocument = Worksheets(1) 
With myDocument.Shapes.AddShape(msoShapeRectangle, _ 
 144, 144, 72, 72) 
 .Name = "Red Square" 
 .Fill.ForeColor.RGB = RGB(255, 0, 0) 
 .Line.DashStyle = msoLineDashDot 
End With

Im folgenden Beispiel wird die Füllung für die erste Form in der Auswahl im aktiven Fenster festgelegt, wobei davon ausgegangen wird, dass sich mindestens eine Form in der Auswahl befindet.

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

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.