Freigeben über


Shape Schnittstelle

Definition

Stellt ein Objekt in der Zeichnungsebene dar, z. B. eine AutoForm, eine Freihandform, ein OLE-Objekt oder eine Grafik. Das Shape-Objekt ist ein Element der Shapes Auflistung. Die Shapes-Auflistung enthält alle Shapes auf einer Folie.

public interface class Shape
[System.Runtime.InteropServices.Guid("00024439-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface Shape
Public Interface Shape
Attribute

Hinweise

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

Dieser Abschnitt wird beschrieben, wie Sie:

  • vorhandene Form zurückgegeben wird.
  • eine Form innerhalb einer Auswahl zurückgegeben wird.
  • Formen zurückgegeben werden, die am Ende eines Verbinders angefügt sind.
  • eine neu erstellte Freihandform zurückgegeben wird.
  • Zurückgeben einer einzelnen Form innerhalb einer Gruppe.
  • Zurückgeben einer neu gebildeten Gruppe von Formen.

Zurückgeben einer vorhandenen Form

Verwenden Sie Shapes(index), wobei index der Name der Form oder die Indexnummer ist, um ein Shape-Objekt zurückzugeben, das eine Form darstellt.

Jeder Form wird ein Standardname zugewiesen, wenn Sie sie der Sammlung Shapes hinzufügen. Verwenden Sie die -Eigenschaft, um der Form einen aussagekräftigeren Name Namen zu geben.

Zurückgeben einer Form innerhalb einer Sammlung

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

Zurückgeben von Formen, die am Ende eines Verbinders angefügt sind

Um ein Shape-Objekt zurückzugeben, das eine der durch einen Verbinder angefügten Formen darstellt, verwenden Sie die - oder EndConnectedShape -BeginConnectedShapeEigenschaft.

Zurückgeben einer neu erstellten Freihandform

Verwenden Sie die BuildFreeform(MsoEditingType, Single, Single) Methoden und AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) , um die Geometrie einer neuen Freihandform zu definieren, und verwenden Sie die ConvertToShape() -Methode, um die Freihandform zu erstellen und das Shape-Objekt zurückzugeben, das sie darstellt.

Zurückgeben einer einzelnen Form aus einer Gruppe

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.

Zurückgeben einer neu gebildeten Gruppe von Formen

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.

Eigenschaften

Adjustments

Gibt ein Adjustments -Objekt zurück, das Anpassungswerte für alle Anpassungen in der angegebenen Form enthält. Schreibgeschützt.

AlternativeText

Gibt die beschreibende (alternative) Textzeichenfolge für ein Shape Objekt zurück oder legt sie fest, wenn das Objekt auf einer Webseite gespeichert wird. Zeichenfolge mit Lese-/Schreibzugriff.

Application

Gibt ein Application Objekt zurück, das die Microsoft Excel-Anwendung darstellt. Schreibgeschützt.

AutoShapeType

Gibt den Formtyp für das angegebene Shape Objekt zurück, das eine andere AutoForm als eine Linie, Freihandformzeichnung oder Verbinder darstellen muss, oder legt den Formtyp fest. Lese-/Schreibzugriff MsoAutoShapeType.

BackgroundStyle

Gibt das Hintergrundformat zurück oder legt es fest. Lese-/Schreibzugriff.

BlackWhiteMode

Gibt einen Wert zurück, der angibt, wie die angegebene Form angezeigt wird, wenn die Präsentation im Schwarzweißmodus betrachtet wird, oder legt diesen fest. Lese-/Schreibzugriff MsoBlackWhiteMode.

BottomRightCell

Gibt ein Range -Objekt zurück, das die Zelle darstellt, die sich unter der unteren rechten Ecke des Objekts befindet. Schreibgeschützt.

Callout

Gibt ein CalloutFormat -Objekt zurück, das Beschriftungsformatierungseigenschaften für die angegebene Form enthält. Gilt für Shape Objekte, die Linienanrufe darstellen. Schreibgeschützt.

CanvasItems

Für die interne Verwendung reserviert.

Chart

Gibt ein -Objekt zurück, das die _Chart in der Shapedarstellt. Schreibgeschützt.

Child

Gibt msoTrue zurück, wenn die angegebene Form eine untergeordnete Form ist oder alle Formen in einem Formenbereich untergeordnete Formen derselben übergeordneten Form sind. Schreibgeschützt MsoTriState.

ConnectionSiteCount

Gibt die Anzahl der Verbindungsseiten der angegebenen Form zurück. Schreibgeschützte ganze Zahl.

Connector

True, wenn es sich bei der angegebenen Form um eine Verbindung handelt. Schreibgeschützt MsoTriState.

ConnectorFormat

Gibt ein ConnectorFormat -Objekt zurück, das Connectorformatierungseigenschaften enthält. Gilt für Shape Objekte, die Connectors darstellen. Schreibgeschützt.

ControlFormat

Gibt ein ControlFormat Objekt zurück, das Microsoft Excel-Steuerelementeigenschaften enthält. Schreibgeschützt.

Creator

Gibt einen ganzzahligen 32-Bit-Wert zurück, der die Anwendung angibt, in der dieses Objekt erstellt wurde. Wenn das Objekt in Microsoft Excel erstellt wurde, gibt die Eigenschaft die Zeichenfolge XCEL zurück, die der Hexadezimalzahl 5843454C entspricht. Schreibgeschützt XlCreator.

Diagram

Gibt ein Diagram Objekt zurück, das ein Diagramm darstellt.

DiagramNode

Gibt ein DiagramNode -Objekt zurück, das einen Knoten in einem Diagramm darstellt.

DrawingObject

Für die interne Verwendung reserviert.

Fill

Gibt ein FillFormat Objekt zurück, das Füllformateigenschaften für das angegebene Diagramm oder die angegebene Form enthält. Schreibgeschützt.

FormControlType

Gibt den Typ eines Microsoft Excel-Steuerelements zurück. Schreibgeschützt XlFormControl.

Glow

Gibt ein Objekt für eine angegebene Form zurück, die leuchtende Formatierungseigenschaften für diese Form enthält. Schreibgeschützt.

GroupItems

Gibt ein GroupShapes -Objekt zurück, das die einzelnen Formen in der angegebenen Gruppe darstellt. Verwenden Sie die Item(Object) -Methode des GroupShapes-Objekts , um eine einzelne Form aus der Gruppe zurückzugeben. Gilt für Shape Objekte, die gruppierte Formen darstellen. Schreibgeschützt.

HasChart

Gibt Informationen zu zurück, wenn ein Shape ein Diagramm enthält. Schreibgeschützt.

HasDiagram

Gibt zurück, ob eine Form oder ein Formbereich ein Diagramm enthält. Schreibgeschützt MsoTriState.

HasDiagramNode

Gibt einen Wert zurück, der angibt, ob ein Diagrammknoten in einer bestimmten Form oder einem bestimmten Formbereich vorhanden ist. Schreibgeschützt MsoTriState.

HasSmartArt

Ruft ab, ob in der angegebenen Form ein SmartArt-Diagramm vorhanden ist.

Height

Die Höhe des Objekts. Lese-/Schreibzugriff einzelnen.

HorizontalFlip

True, wenn die angegebene Form um die horizontale Achse gekippt ist. Schreibgeschützt MsoTriState.

Hyperlink

Gibt ein Hyperlink -Objekt zurück, das den Link für die Form darstellt.

ID

Gibt den Typ für das angegebene Objekt zurück. Schreibgeschützte ganze Zahl.

Left

Der Abstand vom linken Rand des Objekts zum linken Rand von Spalte A (auf einem Arbeitsblatt) oder vom linken Rand des Diagrammbereichs (in einem Diagramm). Lese-/Schreibzugriff einzelnen.

Line

Gibt ein LineFormat -Objekt zurück, das Linienformatierungseigenschaften für die angegebene Form enthält. Schreibgeschützt.

LinkFormat

Gibt ein LinkFormat -Objekt zurück, das verknüpfte OLE-Objekteigenschaften enthält. Schreibgeschützt.

LockAspectRatio

True, wenn für die angegebene Form bei einer Größenänderung deren ursprüngliche Proportionen beibehalten werden. False, wenn Sie bei einer Größenänderung die Höhe und Breite der Form unabhängig voneinander ändern können. Lese-/Schreibzugriff MsoTriState.

Locked

True , wenn das Objekt gesperrt ist, False , wenn das Objekt geändert werden kann, wenn das Blatt geschützt ist. Boolescher Wert mit Lese-/Schreibzugriff.

Name

Gibt den Namen des Objekts zurück oder legt ihn fest. Zeichenfolge mit Lese-/Schreibzugriff.

Nodes

Gibt eine ShapeNodes Auflistung zurück, die die geometrische Beschreibung der angegebenen Form darstellt. Gilt für Shape Objekte, die Freihandzeichnungen darstellen.

OLEFormat

Gibt ein OLEFormat Objekt zurück, das OLE-Objekteigenschaften enthält. Schreibgeschützt.

OnAction

Gibt den Namen des Makros zurück, das ausgeführt wird, wenn auf das angegebene Objekt geklickt wird, oder legt den Namen fest. Zeichenfolge mit Lese-/Schreibzugriff.

Parent

Gibt das übergeordnete Objekt für das angegebene Objekt zurück. Schreibgeschützt.

ParentGroup

Gibt ein Shape -Objekt zurück, das die allgemeine übergeordnete Form einer untergeordneten Form oder eines Bereichs von untergeordneten Formen darstellt.

PictureFormat

Gibt ein PictureFormat -Objekt zurück, das Bildformatierungseigenschaften für die angegebene Form enthält. Gilt für Shape Objekte, die Bilder oder OLE-Objekte darstellen. Schreibgeschützt.

Placement

Gibt die Art und Weise zurück, wie das Objekt an die darunter liegenden Zellen angefügt wird, oder legt sie fest. Lese-/Schreibzugriff XlPlacement.

Reflection

Gibt ein Objekt zurück, das Reflektionsformatierungseigenschaften für die Form enthält. Schreibgeschützt.

Rotation

Gibt die Drehung der Form in Grad zurück oder legt sie fest. Lese-/Schreibzugriff einzelnen.

Script

Gibt das Script-Objekt zurück, das einen Skript- oder Codeblock auf der angegebenen Webseite darstellt. Wenn die Seite kein Skript enthält, erfolgt keine Rückgabe.

Shadow

True , wenn das Objekt einen Schatten aufweist. Boolescher Wert mit Lese-/Schreibzugriff.

ShapeStyle

Gibt zurück oder legt einen MsoShapeStyleIndex fest, der die Formart der Form darstellt. Lese-/Schreibzugriff.

SmartArt

Ruft ein -Objekt ab, das die smartArt darstellt, die der Form zugeordnet ist.

SoftEdge

Gibt ein SoftEdgeFormat -Objekt für eine angegebene Form zurück, die Formatierungseigenschaften für weiche Kanten für die Form enthält. Schreibgeschützt.

TextEffect

Gibt ein TextEffectFormat -Objekt zurück, das Texteffekt-Formatierungseigenschaften für die angegebene Form enthält. Gilt für T:Microsoft.Office.Interop.Excel.Shape-Objekte , die WordArt darstellen. Schreibgeschützt.

TextFrame

Gibt ein TextFrame -Objekt zurück, das die Ausrichtungs- und Verankerungseigenschaften für die angegebene Form enthält. Schreibgeschützt.

TextFrame2

Gibt ein Objekt zurück, das Textformatierung für die angegebene Form enthält. Schreibgeschützt.

ThreeD

Gibt ein ThreeDFormat Objekt zurück, das 3D -Effektformatierungseigenschaften für die angegebene Form enthält. Schreibgeschützt.

Title

Ruft den Titel des alternativen Texts ab, der der angegebenen Form zugeordnet ist, oder legt den Titel fest.

Top

Der Abstand vom oberen Rand der obersten Form im Formenbereich zum oberen Rand des Arbeitsblatts. Lese-/Schreibzugriff einzelnen.

TopLeftCell

Gibt ein Range -Objekt zurück, das die Zelle darstellt, die sich unter der oberen linken Ecke des angegebenen Objekts befindet. Schreibgeschützt.

Type

Gibt den Formtyp zurück oder legt den Typ fest. Schreibgeschützt MsoShapeType.

VerticalFlip

True, wenn die angegebene Form um die vertikale Achse gedreht wurde. Schreibgeschützt MsoTriState.

Vertices

Gibt die Koordinaten der Scheitelpunkte der angegebenen Freihandform (und der Kontrollpunkte für Bézierkurven) als Folge von Koordinatenpaaren zurück. Read-only- Objekt.

Visible

Bestimmt, ob das Objekt sichtbar ist. Lese-/Schreibzugriff MsoTriState.

Width

Die Breite des Objekts. Lese-/Schreibzugriff einzelnen.

ZOrderPosition

Gibt die Position der angegebenen Form in der Z-Ordnung zurück. Schreibgeschützte ganze Zahl.

Methoden

Apply()

Gilt für die angegebene Formformatierung, die mithilfe der PickUp() -Methode kopiert wurde.

CanvasCropBottom(Single)

Für die interne Verwendung reserviert.

CanvasCropLeft(Single)

Für die interne Verwendung reserviert.

CanvasCropRight(Single)

Für die interne Verwendung reserviert.

CanvasCropTop(Single)

Für die interne Verwendung reserviert.

Copy()

Kopiert das Objekt in die Zwischenablage.

CopyPicture(Object, Object)

Kopiert das ausgewählte Objekt als Bild in die Zwischenablage.

Cut()

Schneidet das Objekt aus, legt es in die Zwischenablage oder fügt es an einer angegebenen Stelle ein.

Delete()

Löscht das Objekt.

Duplicate()

Dupliziert das Objekt und gibt einen Bezug auf die neue Kopie zurück.

Flip(MsoFlipCmd)

Spiegelt die angegebene Form an ihrer horizontalen oder vertikalen Achse.

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. Verwenden Sie die Rotation -Eigenschaft, um die absolute Drehung der Form festzulegen.

IncrementTop(Single)

Verschiebt die angegebene Form vertikal um die angegebene Anzahl von Punkten.

PickUp()

Kopiert die Formatierung der angegebenen Form. Verwenden Sie die Apply() -Methode, um die kopierte Formatierung auf eine andere Form anzuwenden.

RerouteConnections()

Leitet Connectors, damit sie den kürzesten möglichen Weg zwischen den Shapes nutzen, die sie verbinden.

ScaleHeight(Single, MsoTriState, Object)

Skaliert die Höhe der Form anhand eines angegebenen Faktors.

ScaleWidth(Single, MsoTriState, Object)

Skaliert die Breite der Form anhand eines angegebenen Faktors.

Select(Object)

Markiert das Objekt.

SetShapesDefaultProperties()

Übernimmt die Formatierung der angegebenen Form als Standardformatierung für die Form.

Ungroup()

Hebt die Gruppierung aller gruppierten Formen in der angegebenen Form oder einen Bereich von Formen. Disassembliert Bilder und OLE-Objekte innerhalb der angegebenen Form. Gibt die nicht gruppierten Formen als einzelnes ShapeRange Objekt zurück.

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: