Shapes-Objekt (Word)

Eine Auflistung von Shape-Objekten , die alle Formen in einem Dokument oder alle Formen in allen Kopf- und Fußzeilen in einem Dokument darstellen. Jedes Shape-Objekt stellt ein Objekt in der Zeichnungsebene dar, z. B. eine AutoForm, eine Freihandform, ein OLE-Objekt oder ein Bild.

HinwBemerkungeneise

Wenn Sie mit einer Teilmenge der Formen in einem Dokument arbeiten möchten , z. B. um nur die AutoFormen im Dokument oder nur die ausgewählten Formen zu verwenden, müssen Sie eine ShapeRange-Auflistung erstellen, die die Shapes enthält, mit denen Sie arbeiten möchten.

Mit der Shapes-Eigenschaft können Sie die Shapes-Auflistung zurückgeben. Im folgenden Beispiel werden alle Formen im aktiven Dokument markiert.

ActiveDocument.Shapes.SelectAll

Hinweis

Wenn Sie eine Aktion (z. B. Löschen oder Festlegen einer Eigenschaft) für alle Formen in einem Dokument gleichzeitig ausführen möchten, verwenden Sie die Range-Methode , um ein ShapeRange-Objekt zu erstellen, das alle Shapes in der Shapes-Auflistung enthält, und wenden Sie dann die entsprechende Eigenschaft oder Methode auf das ShapeRange-Objekt an.

Verwenden Sie eine der folgenden Methoden der Shapes-Auflistung : Add3DModel, AddCallout, AddCurve, AddLabel, AddLine, AddOleControl, AddOleObject, AddPolyline, AddShape, AddTextbox, AddTextEffect oder BuildFreeForm , um einem Dokument ein Shape-Objekt hinzuzufügen , das die neu erstellte Form darstellt. Im folgenden Beispiel wird das aktive Dokument ein Rechteck hinzugefügt.

ActiveDocument.Shapes.AddShape msoShapeRectangle, 50, 50, 100, 200

Verwenden Sie Shapes (Index), wobei Index der Name oder die Indexnummer ist, um ein einzelnes Shape-Objekt zurückzugeben. Im folgenden Beispiel wird die Form 1 im aktiven Dokument horizontal gespiegelt.

ActiveDocument.Shapes(1).Flip msoFlipHorizontal

This example horizontally flips the shape named "Rectangle 1" on the active document.

ActiveDocument.Shapes("Rectangle 1").Flip msoFlipHorizontal

Jedes Shape erhält einen Standardnamen erstellt wird. Wenn Sie einem Dokument z. B. drei verschiedene Formen hinzufügen, können sie "Rechteck 2", "TextBox 3" und "Oval 4" heißen. Um einem Shape einen aussagekräftigeren Namen zu geben, legen Sie die Name-Eigenschaft fest.

Die Shapes-Auflistung enthält keine InlineShape-Objekte . InlineShape -Objekte werden wie Zeichen behandelt und innerhalb einer Textzeile wie Zeichen positioniert. Shape -Objekte sind an einem Textbereich verankert, können jedoch auf der Seite frei bewegt und positioniert werden. Verwenden Sie die ConvertToInlineShape-Methode und die ConvertToShape-Methode , um Shapes von einem Typ in den anderen zu konvertieren. Nur Bilder, OLE-Objekte und ActiveX-Steuerelemente können in Inlineformen konvertiert werden.

Die Count-Eigenschaft gibt für diese Auflistung in einem Dokument nur die Anzahl der Elemente im Hauptartikel zurück. Zum Zählen der Formen in den Kopf- und Fußzeilen verwenden Sie die Shapes-Auflistung mit einem beliebigen HeaderFooter-Objekt.

Methoden

Name
AddCallout
AddCanvas
AddChart2
AddCurve
AddLabel
AddLine
AddOLEControl
AddOLEObject
AddPicture
AddPolyline
AddShape
AddSmartArt
AddTextbox
AddTextEffect
Add3DModel
AddWebVideo
BuildFreeform
Element
Range
SelectAll

Eigenschaften

Name
Anwendung
Count
Creator
Parent

Siehe auch

Referenz zum Word-Objektmodell

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.