Shape-Objekt (Excel)Shape object (Excel)

Repräsentiert ein Objekt in der Zeichnungsschicht wie eine AutoForm, eine Freihandform, ein OLE-Objekt oder ein Bild.Represents an object in the drawing layer, such as an AutoShape, freeform, OLE object, or picture.

BemerkungenRemarks

Das Shape -Objekt ist ein Element der Shapes -Auflistung.The Shape object is a member of the Shapes collection. Die Sammlung Shapes enthält alle Formen in einer Arbeitsmappe.The Shapes collection contains all the shapes in a workbook.

Hinweis

Es gibt drei Objekte, die Shapes darstellen: die Shapes -Auflistung, die alle Formen in einer Arbeitsmappe darstellt. die ShapeRange -Auflistung, die eine angegebene Teilmenge der Formen in einer Arbeitsmappe darstellt (beispielsweise kann ein ShapeRange -Objekt die Formen 1 und 4 in der Arbeitsmappe darstellen oder alle markierten Formen in der Arbeitsmappe darstellen); und das Shape -Objekt, das eine einzelne Form in einem Arbeitsblatt darstellt.There are three objects that represent shapes: the Shapes collection, which represents all the shapes on a workbook; the ShapeRange collection, which represents a specified subset of the shapes on a workbook (for example, a ShapeRange object could represent shapes one and four in the workbook, or it could represent all the selected shapes in the workbook); and the Shape object, which represents a single shape on a worksheet. Wenn Sie mit mehreren Formen gleichzeitig oder mit Formen innerhalb einer Auswahl arbeiten möchten, verwenden Sie eine Sammlung ShapeRange.If you want to work with several shapes at the same time or with shapes within the selection, use a ShapeRange collection.

Zurückgeben...To return... Verwenden Sie...Use...
Ein Shape -Objekt, das eine der Formen darstellt, die mit einem Verbinder verbunden sind.A Shape object that represents one of the shapes attached by a connector Die BeginConnectedShape -oder die EndConnectedShape -Eigenschaft des ConnectorFormat -Objekts.The BeginConnectedShape or EndConnectedShape property of the ConnectorFormat object.
Eine neu erstellte FreihandformA newly created freeform Die Methoden BuildFreeform und AddNodes, um die Geometrie einer neuen Freihandform zu definieren, und verwenden Sie die ConvertToShape -Methode, um die Freihandform zu erstellen und das Shape -Objekt zurückzugeben, das Sie darstellt. The BuildFreeform and AddNodes methods to define the geometry of a new freeform, and use the ConvertToShape method to create the freeform and return the Shape object that represents it.
Ein Shape -Objekt, das eine einzelne Form in einer gruppierten Form darstelltA Shape object that represents a single shape in a grouped shape GroupItems (Index), wobei Index der Name der Form oder die Indexnummer innerhalb der Gruppe ist.GroupItems (index), where index is the shape name or the index number within the group.
Eine neu gebildete Gruppe von FormenA newly formed group of shapes 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.The Group or Regroup method of the ShapeRange object to group a range of shapes and return a single Shape object that represents the newly formed group. Nachdem eine Gruppe gebildet wurde, können Sie mit der Gruppe auf die gleiche Weise wie mit jeder anderen Form arbeiten.After a group has been formed, you can work with the group the same way that you work with any other shape.
Ein Shape -Objekt, das eine vorhandene Form darstelltA Shape object that represents an existing shape Formen (Index), wobei Index der Name der Form oder die Indexnummer ist.Shapes (index), where index is the shape name or the index number.
Ein Shape -Objekt, das eine Form innerhalb der Markierung darstellt.A Shape object that represents a shape within the selection _Auswahl_aus. ShapeRange (Index), wobei Index der Name der Form oder die Indexnummer ist.Selection.ShapeRange (index), where index is the shape name or the index number.

BeispielExample

In dem folgenden Beispiel wird Form 1 und die Form "Rectangle 1" in myDocument horizontal gespiegelt.The following example horizontally flips shape one and the shape named Rectangle 1 on myDocument.

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.Each shape is assigned a default name when you add it to the Shapes collection. Um der Form einen transparenteren Namen zuzuweisen, verwenden Sie die Eigenschaft Name.To give the shape a more meaningful name, use the Name property. Im folgenden Beispiel wird myDocument ein __ Rechteck hinzugefügt, dem Namen das rote Quadrat zugewiesen, und dann wird dessen Vordergrundfarbe und Linienart festgelegt.The following example adds a rectangle to myDocument, gives it the name Red Square, and then sets its foreground color and line style.

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, vorausgesetzt, es ist mindestens eine Form in der Markierung vorhanden.The following example sets the fill for the first shape in the selection in the active window, assuming that there's at least one shape in the selection.

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

MethodenMethods

EigenschaftenProperties

Siehe auchSee also

Support und FeedbackSupport and feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation?Have questions or feedback about Office VBA or this documentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.