Shape-Objekt (Word)

Stellt ein Objekt in der Zeichnungsebene dar, z. B. eine AutoForm, eine Freihandform, ein OLE-Objekt, ein ActiveX-Steuerelement oder eine Grafik. Das Shape-Objekt ist ein Element der Shapes-Auflistung , die alle Shapes im Hauptabschnitt eines Dokuments oder in allen Kopf- und Fußzeilen eines Dokuments enthält.

HinwBemerkungeneise

Eine Form ist immer mit einem Verankerungsbereich verbunden. Sie können das Shape an einer beliebigen Stelle auf dem Zeichenblatt positionieren, das den Anker enthält.

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

Verwenden Sie Shapes (Index), wobei index der Name oder die Indexnummer ist, um ein einzelnes Shape-Objekt zurückzugeben. Das folgende Beispiel kippt die Form 1 im aktiven Dokument horizontal.

ActiveDocument.Shapes(1).Flip msoFlipHorizontal

Im folgenden Beispiel wird die Form "Rectangle 1" im aktiven Dokument horizontal umgedreht.

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

Jedes Shape erhält einen Standardnamen erstellt wird. Wenn Sie z. B. einem Dokument drei verschiedene Formen hinzufügen, können diese als Rechteck 2, Textfeld 3 und Oval 4 bezeichnet werden. Mit der Name-Eigenschaft können Sie einer Form einen aussagekräftigeren Namen geben.

Verwenden Sie ShapeRange (Index), wobei index der Name oder die Indexnummer ist, um ein Shape-Objekt zurückzugeben, das eine Form innerhalb einer Auswahl darstellt. Das folgende Beispiel legt die Füllung für die erste Form in der Auswahl, vorausgesetzt, dass die Auswahl mindestens eine Form enthält.

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

Im folgenden Beispiel wird die Füllung für alle Formen in der Auswahl festgelegt. Voraussetzung dafür ist, dass sich in der Auswahl mindestens eine Form befindet.

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

Um ein Shape-Objekt der Auflistung der Formen im angegebenen Dokument hinzuzufügen oder ein Shape-Objekt zurückzugeben, das die neu erstellte Form darstellt, verwenden Sie eine der folgenden Methoden der Shapes-Auflistung: AddCallout, AddCurve, AddLabel, AddLine, AddOleControl, AddOleObject, AddPolyline, AddShape, AddTextbox, AddTextEffect oder BuildFreeForm. Im folgenden Beispiel wird dem aktiven Dokument ein Rechteck hinzugefügt.

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

Verwenden Sie GroupItems (Index), wobei index der Shape-Name oder die Indexnummer innerhalb der Gruppe ist, um ein Shape-Objekt zurückzugeben, das eine einzelne Form in einer gruppierten Form darstellt.

Verwenden Sie die Gruppe oder Regroup -Methode einen Bereich von Formen gruppieren und zurückgeben ein einzelnes Shape -Objekt, das die neu gebildete Gruppe darstellt. Nach dem bilden einer Gruppe können Sie arbeiten mit der Gruppe der gleichen Weise wie Arbeit mit einem anderen Shape.

Jedes Shape-Objekt ist mit einem Textbereich verankert. Eine Form ist mit dem Anfang des ersten Absatzes verankert, der den Verankerungsbereich enthält. Die Form verbleibt immer auf der gleichen Seite wie ihr Anker.

Sie können den Anker selbst anzeigen, indem Sie die ShowObjectAnchors-Eigenschaft auf True festlegen. Die Top- und Left-Eigenschaften der Form bestimmen die horizontale und vertikale Position. Die RelativeHorizontalPosition- und RelativeVerticalPosition-Eigenschaften der Form bestimmen, ob die Position der Verankerung am Absatz, der Spalte, die den Verankerungsabsatz enthält, am Rand oder dem Rand der Seite gemessen wird.

Wenn die LockAnchor-Eigenschaft für das Shape auf True festgelegt ist, können Sie den Anker nicht von seiner Position auf dem Zeichenblatt ziehen.

Verwenden Sie die Fill-Eigenschaft , um das FillFormat-Objekt zurückzugeben, das alle Eigenschaften und Methoden zum Formatieren der Füllung einer geschlossenen Form enthält.

Die Shadow -Eigenschaft gibt das ShadowFormat -Objekt zurück, mit dem Sie einen Schatten formatieren.

Mit der Line -Eigenschaft geben Sie das LineFormat -Objekt zurück, das alle Eigenschaften und Methoden zum Formatieren von Linien und Pfeilen enthält.

Die TextEffect -Eigenschaft gibt das TextEffectFormat -Objekt zurück, mit dem Sie WordArt formatieren.

Die Callout -Eigenschaft gibt das CalloutFormat -Objekt zurück, mit dem Sie Legenden mit Linien formatieren.

Die WrapFormat -Eigenschaft gibt das WrapFormat -Objekt zurück, mit dem Sie festlegen, wie Text Formen umfließt.

Die ThreeD-Eigenschaft gibt das ThreeDFormat-Objekt zurück, das Sie zum Erstellen von 3D-Shapes verwenden.

Verwenden Sie die Methoden PickUp und Apply , um formatierungen von einer Form auf eine andere zu übertragen.

Verwenden Sie die SetShapesDefaultProperties -Methode für ein Shape -Objekt, um die Formatierung der Standardform für das Dokument. Neue Formen erben viele Attribute von der Standardform.

Verwenden Sie die Type-Eigenschaft , um den Typ der Form anzugeben: z. B. Freihandform, AutoForm, OLE-Objekt, Legende oder verknüpfte Grafik. Verwenden Sie die AutoShapeType-Eigenschaft , um den Typ der AutoForm anzugeben: z. B. Oval, Rechteck oder Sprechblase.

Verwenden Sie die Eigenschaften Width und Height, um die Größe der Form anzugeben.

Die TextFrame-Eigenschaft gibt das TextFrame-Objekt zurück, das alle Eigenschaften und Methoden zum Anfügen von Text an Formen und zum Verknüpfen des Texts zwischen Textrahmen enthält.

Shape -Objekte sind an einen Textbereich verankert, können jedoch auf der Seite frei bewegt und positioniert werden. InlineShape -Objekte werden wie Zeichen behandelt und innerhalb einer Textzeile wie Zeichen positioniert. 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.

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.