Shape Schnittstelle

Definition

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Stellt ein Objekt in der Zeichnungsebene, wie beispielsweise eine AutoForm, Freihandform, OLE-Objekt, ActiveX-Steuerelement oder Bild.

public interface class Shape

[System.Runtime.InteropServices.Guid("000209A0-0000-0000-C000-000000000046")]
public interface Shape

type Shape = interface

Public Interface Shape

Attribute

GuidAttribute

Hinweise

Das Shape -Objekt ist ein Element der Shapes Auflistung, die alle Formen im Standard Story eines Dokuments oder in allen Kopf- und Fußzeilen eines Dokuments enthält.

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; die ShapeRange Auflistung, die eine angegebene Teilmenge der Formen in einem Dokument darstellt (z. B. könnte ein ShapeRange Objekt die Formen 1 und vier im Dokument oder alle ausgewählten Formen im Dokument darstellen); das Shape Objekt, , das eine einzelne Form in einem Dokument darstellt. Wenn Sie mit mehreren Formen gleichzeitig oder mit Shapes innerhalb der Auswahl arbeiten möchten, verwenden Sie eine ShapeRange Auflistung.

Verwenden Sie Shapes(index), wobei index der Name oder die Indexnummer ist, um ein einzelnes Shape Objekt zurückzugeben.

Jedes Shape erhält einen Standardnamen erstellt wird. Angenommen, wenn Sie drei verschiedene Formen zu einem Dokument hinzufügen, sie möglicherweise werden mit dem Namen "Rechteck 2", "Textfeld 3" und "Oval 4". Legen Sie die -Eigenschaft fest, um einem Shape einen aussagekräftigeren Name Namen zu geben.

Verwenden Sie Selection.ShapeRange(index), wobei index der Name oder die Indexnummer ist, um ein Shape Objekt zurückzugeben, das eine Form innerhalb einer Auswahl darstellt.

Um der Auflistung von Shapes für das angegebene Dokument ein Shape -Objekt hinzuzufügen und ein Shape Objekt zurückzugeben, das die neu erstellte Form darstellt, verwenden Sie eine der folgenden Methoden der Shapes Auflistung: AddCallout(MsoCalloutType, Single, Single, Single, Single, Object), AddCurve(Object, Object), , AddLabel(MsoTextOrientation, Single, Single, Single, Single, Object), AddOLEControl(Object, Object, Object, Object, Object, Object)AddLine(Single, Single, Single, Single, Object), , AddPolyline(Object, Object)AddTextbox(MsoTextOrientation, Single, Single, Single, Single, Object)AddTextEffect(MsoPresetTextEffect, String, String, Single, MsoTriState, MsoTriState, Single, Single, Object)AddOLEObject(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)AddShape(Int32, Single, Single, Single, Single, Object)oder .BuildFreeform(MsoEditingType, Single, Single)

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 Group() - oder Regroup() -Methode, um einen Bereich von Formen zu gruppieren und ein einzelnes Shape Objekt zurückzugeben, 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 in 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 Eigenschaften und bestimmen die vertikale und Left horizontale Position des ShapesTop. Die Eigenschaften und RelativeVerticalPosition des Shapes RelativeHorizontalPosition bestimmen, ob die Position aus dem Verankerungsabsatz, der Spalte, die den Verankerungsabsatz enthält, dem 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, das Sie zum Formatieren eines Schattens verwenden. Verwenden Sie die Line -Eigenschaft, um das LineFormat -Objekt zurückzugeben, das Eigenschaften und Methoden zum Formatieren von Linien und Pfeilen enthält. Die TextEffect -Eigenschaft gibt das TextEffectFormat -Objekt zurück, das Sie zum Formatieren von WordArt verwenden. Die Callout -Eigenschaft gibt das CalloutFormat -Objekt zurück, das Sie zum Formatieren von Zeilenbeschriftungen verwenden. Die WrapFormat -Eigenschaft gibt das WrapFormat -Objekt zurück, das Sie verwenden, um zu definieren, wie Text um Formen umbrochen wird. Die ThreeD -Eigenschaft gibt das ThreeDFormat -Objekt zurück, das Sie zum Erstellen von 3D-Shapes verwenden. Sie können die PickUp() -Methode und Apply() die -Methode verwenden, um formatierungen von einer Form auf eine andere zu übertragen.

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

Verwenden Sie die Type -Eigenschaft, um den Typ der Form anzugeben: Freihandform, AutoForm, OLE-Objekt, Legende oder verknüpftes Bild für instance. Verwenden Sie die AutoShapeType -Eigenschaft, um den Typ der AutoForm anzugeben: Oval, Rechteck oder Sprechblase für instance.

Verwenden Sie die Width Eigenschaften 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 Verknüpfen des Texts zwischen Textrahmen enthält.

Shape -Objekte sind an einem Textbereich verankert, sind aber frei schwebend und können an einer beliebigen Stelle auf der Seite positioniert werden. InlineShape -Objekte werden wie Zeichen behandelt und als Zeichen innerhalb einer Textzeile positioniert. Sie können die ConvertToInlineShape() -Methode und die ConvertToShape() -Methode verwenden, um Shapes von einem Typ in den anderen zu konvertieren. Nur Bilder, OLE-Objekte und ActiveX-Steuerelemente können in Inlineformen konvertiert werden.

Eigenschaften

Adjustments	Gibt ein Adjustments -Objekt zurück, das Anpassungswerte für alle Anpassungen im angegebenen Shape Objekt enthält, das eine AutoForm oder WordArt darstellt.
AlternativeText	Gibt den alternativen Text zurück, der einer Form in einer Webpräsentation zugeordnet ist, oder legt den Text fest.
Anchor	Gibt ein Range -Objekt zurück, das den Verankerungsbereich für die angegebene Form darstellt.
AnchorID	Stellt ein Objekt in der Zeichnungsebene, wie beispielsweise eine AutoForm, Freihandform, OLE-Objekt, ActiveX-Steuerelement oder Bild.
Application	Gibt ein Application -Objekt zurück, das die Microsoft Word-Anwendung darstellt.
AutoShapeType	Gibt den Formtyp für das angegebene Shape Objekt zurück, das eine andere AutoForm als eine Linien- oder Freihandform-Zeichnung darstellen muss, oder legt den Formtyp fest.
BackgroundStyle	Ruft den Hintergrundstil der angegebenen Form ab oder legt diese fest.
Callout	Gibt ein CalloutFormat -Objekt zurück, das Beschriftungsformatierungseigenschaften für die angegebene Form enthält.
CanvasItems	Gibt ein CanvasShapes -Objekt zurück, das eine Auflistung von Formen in einem Zeichenbereich darstellt.
Chart	Gibt ein Chart -Objekt zurück, das ein Diagramm innerhalb der Auflistung von Formen in einem Dokument darstellt. Schreibgeschützt.
Child	Bestimmt, ob es sich bei der Form um eine untergeordnete Form handelt.
ConnectionSiteCount	Für die interne Verwendung reserviert.
Connector	Für die interne Verwendung reserviert.
ConnectorFormat	Für die interne Verwendung reserviert.
Creator	Gibt eine 32-Bit-Ganzzahl, die die Anwendung angibt, in der das angegebene Objekt erstellt wurde.
Diagram	Gibt ein Diagram Objekt zurück, zu dem ein Diagrammknoten gehört.
DiagramNode	Gibt ein DiagramNode -Objekt zurück, das einen Knoten in einem Diagramm darstellt.
EditID	Stellt ein Objekt in der Zeichnungsebene, wie beispielsweise eine AutoForm, Freihandform, OLE-Objekt, ActiveX-Steuerelement oder Bild.
Fill	Gibt ein FillFormat -Objekt zurück, das Füllformatierungseigenschaften für die angegebene Form enthält.
Glow	Gibt ein GlowFormat -Objekt zurück, das die Leuchtformatierung für eine Form darstellt. Schreibgeschützt.
GroupItems	Gibt ein GroupShapes -Objekt zurück, das die einzelnen Formen in der angegebenen Gruppe darstellt.
HasChart	True, wenn die angegebene Form ein Diagramm aufweist. Schreibgeschützt.
HasDiagram	Bestimmt, ob eine Form ein Diagramm ist.
HasDiagramNode	Bestimmt, ob ein Shape ein Diagrammknoten ist.
HasSmartArt	Ruft True ab, wenn in der Form ein SmartArt-Diagramm vorhanden ist.
Height	Gibt die Höhe der angegebenen Form in Punkt zurück oder legt sie fest.
HeightRelative	Gibt einen Wert vom Typ Single zurück, der den Prozentsatz der relativen Höhe einer Form darstellt, oder legt diesen wert fest. Lese-/Schreibzugriff.
HorizontalFlip	Gibt an, dass eine Form horizontal gekippt wurde.
Hyperlink	Gibt ein Hyperlink -Objekt zurück, das den Link darstellt, der der angegebenen Form zugeordnet ist.
ID	Gibt den Typ für das angegebene Objekt zurück.
LayoutInCell	Gibt einen Integer-Wert zurück, der angibt, ob eine Form in einer Tabelle innerhalb oder außerhalb der Tabelle angezeigt wird.
Left	Gibt einen Wert vom Typ Single zurück, der die horizontale Position (gemessen in Punkten) der angegebenen Form oder des Formbereichs darstellt, oder legt diesen fest.
LeftRelative	Gibt einen Wert vom Typ Single zurück, der die relative linke Position einer Form darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
Line	Gibt ein LineFormat -Objekt zurück, das Linienformatierungseigenschaften für die angegebene Form enthält.
LinkFormat	Gibt ein LinkFormat -Objekt zurück, das die Linkoptionen der angegebenen Form darstellt, die mit einer Datei verknüpft ist.
LockAnchor	Bestimmt, ob der Anker des angegebenen Shape Objekts für den Verankerungsbereich gesperrt ist.
LockAspectRatio	Bestimmt, ob Sie die Höhe und Breite der Form unabhängig voneinander ändern können, wenn Sie ihre Größe ändern oder ob die ursprünglichen Proportionen beibehalten werden.
Name	Gibt den Namen des angegebenen Objekts zurück oder legt ihn fest.
Nodes	Gibt eine ShapeNodes Auflistung zurück, die die geometrische Beschreibung der angegebenen Form darstellt.
OLEFormat	Gibt ein OLEFormat -Objekt zurück, das die OLE-Merkmale (mit Ausnahme der Verknüpfung) für die angegebene Form darstellt.
Parent	Gibt ein Objekt zurück, das das übergeordnete Objekt des angegebenen Objekts darstellt.
ParentGroup	Gibt ein Shape -Objekt zurück, das die allgemeine übergeordnete Form einer untergeordneten Form darstellt.
PictureFormat	Gibt ein PictureFormat -Objekt zurück, das Bildformatierungseigenschaften für das angegebene Objekt enthält.
Reflection	Gibt ein ReflectionFormat -Objekt zurück, das die Reflektionsformatierung für eine Form darstellt. Schreibgeschützt.
RelativeHorizontalPosition	Gibt an, was die horizontale Position eines Shapes relativ ist.
RelativeHorizontalSize	Gibt eine WdRelativeHorizontalSize Konstante zurück, die das Objekt darstellt, zu dem ein Bereich von Formen relativ ist, oder legt diese Konstante fest. Lese-/Schreibzugriff.
RelativeVerticalPosition	Gibt an, was die vertikale Position einer Form relativ ist.
RelativeVerticalSize	Gibt eine WdRelativeVerticalSize Konstante zurück, die die relative vertikale Größe einer Form darstellt, oder legt sie fest. Lese-/Schreibzugriff.
Rotation	Gibt die Gradzahl zurück, um die die angegebene Form um die Z-Achse gedreht wird, oder legt diese Gradzahl fest.
RTF	Für die interne Verwendung reserviert.
Script	Gibt ein Script -Objekt zurück, das einen Skript- oder Codeblock auf der angegebenen Webseite darstellt.
Shadow	Gibt ein ShadowFormat -Objekt zurück, das die Schattenformatierung für die angegebene Form darstellt.
ShapeStyle	Ruft die Formart für die angegebene Form ab oder legt sie fest.
SmartArt	Ruft ein SmartArt -Objekt ab, das eine Möglichkeit zum Arbeiten mit der SmartArt bietet, die der angegebenen Form zugeordnet ist.
SoftEdge	Gibt ein SoftEdgeFormat -Objekt zurück, das die Formatierung der weichen Kante für eine Form darstellt. Schreibgeschützt.
TextEffect	Gibt ein TextEffectFormat -Objekt zurück, das Texteffekt-Formatierungseigenschaften für die angegebene Form enthält.
TextFrame	Gibt ein TextFrame -Objekt zurück, das den Text für die angegebene Form enthält.
TextFrame2	Gibt ein TextFrame2 -Objekt zurück, das den Text für die angegebene Form enthält. Schreibgeschützt.
ThreeD	Gibt ein ThreeDFormat -Objekt zurück, das Formatierungseigenschaften des dreidimensionalen Effekts für die angegebene Form enthält.
Title	Ruft eine Zeichenfolge ab, die einen Titel für die angegebene Form enthält, oder legt diese fest.
Top	Gibt die vertikale Position der angegebenen Form in Punkt zurück oder legt sie fest.
TopRelative	Gibt einen Wert vom Typ Single zurück, der die relative obere Position einer Form darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
Type	Gibt den Typ der Form zurück.
VerticalFlip	Bestimmt, ob die angegebene Form um die vertikale Achse gedreht wird.
Vertices	Gibt die Koordinaten der Scheitelpunkte der angegebenen Freihandform (und der Kontrollpunkte für Bézierkurven) als Folge von Koordinatenpaaren zurück.
Visible	Bestimmt, ob das angegebene Objekt oder die darauf angewendete Formatierung sichtbar ist.
Width	Gibt die Breite des angegebenen Objekts (in Punkten) zurück oder legt sie fest.
WidthRelative	Gibt einen Wert vom Typ Single zurück, der die relative Breite einer Form darstellt, oder legt diesen Wert fest. Lese-/Schreibzugriff.
WrapFormat	Gibt ein WrapFormat -Objekt zurück, das die Eigenschaften zum Umschließen von Text um die angegebene Form enthält.
ZOrderPosition	Gibt die Position der angegebenen Form in der Z-Ordnung zurück.

Methoden

Activate()	Aktiviert das angegebene Objekt.
Apply()	Gilt für die angegebene Formformatierung, die mit der PickUp() -Methode kopiert wurde.
CanvasCropBottom(Single)	Schneidet einen prozentualen Anteil der Höhe eines Zeichenbereichs vom unteren Rand des Zeichenbereichs ab.
CanvasCropLeft(Single)	Schneidet einen prozentualen Anteil der Breite eines Zeichenbereichs vom linken Rand des Zeichenbereichs ab.
CanvasCropRight(Single)	Schneidet einen prozentualen Anteil der Breite eines Zeichenbereichs vom rechten Rand des Zeichenbereichs ab.
CanvasCropTop(Single)	Schneidet einen prozentualen Anteil der Höhe eines Zeichenbereichs vom oberen Rand des Zeichenbereichs ab.
ConvertToFrame()	Konvertiert die angegebene Form in einen Rahmen.
ConvertToInlineShape()	Konvertiert die angegebene Form in der Zeichnungsebene eines Dokuments in eine Inlineform in der Textebene.
Delete()	Löscht das angegebene Objekt.
Duplicate()	Erstellt ein Duplikat des angegebenen Shape Objekts, fügt der Auflistung den Shapes neuen Formenbereich mit einem Standardoffset von den ursprünglichen Formen hinzu und gibt dann das neue Shape-Objekt zurück.
Flip(MsoFlipCmd)	Kippt eine Form horizontal oder vertikal.
IncrementLeft(Single)	Verschiebt die angegebene Form horizontal um die angegebene Punktanzahl.
IncrementRotation(Single)	Ändert die Drehung der angegebenen Form um die z-Achse um die angegebene Gradzahl.
IncrementTop(Single)	Verschiebt die angegebene Form vertikal um die angegebene Anzahl von Punkten.
PickUp()	Kopiert die Formatierung der angegebenen Form.
RerouteConnections()	Für die interne Verwendung reserviert.
ScaleHeight(Single, MsoTriState, MsoScaleFrom)	Skaliert die Höhe der Form anhand eines angegebenen Faktors.
ScaleWidth(Single, MsoTriState, MsoScaleFrom)	Skaliert die Breite der Form anhand eines angegebenen Faktors.
Select(Object)	Markiert das angegebene Objekt.
SetShapesDefaultProperties()	Wendet die Formatierung der angegebenen Form auf ein Standard-Shape für dieses Dokument an. Neue Formen erben viele Attribute von der Standardform.
Ungroup()	Hebt die Gruppierung von gruppierten Formen in der angegebenen Form auf.
ZOrder(MsoZOrderCmd)	Verschiebt die angegebene Form vor oder hinter andere Formen in der Sammlung (d. h. ändert die Position der Form in der Z-Reihenfolge).