Shape Schnittstelle

Definition

Namespace:

Microsoft.Office.Interop.Excel

Assembly:

Microsoft.Office.Interop.Excel.dll

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

GuidAttribute InterfaceTypeAttribute

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