Freigeben über


Shape Schnittstelle

Definition

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

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).

Gilt für: