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.
Hinweise
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 beispielsweise 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
Eigenschaften
Name |
---|
Application |
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.