Shape Schnittstelle

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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 Sammlung Shapes enthält alle Formen 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 Formen-Auflistung , die alle Formen in einem Dokument darstellt; die ShapeRange Sammlung, die eine bestimmte Teilmenge der Shapes in einem Dokument darstellt (z. B. kann ein ShapeRange-Objekt die Shapes eins und vier oder alle ausgewählten Shapes im Dokument darstellen); und das Shape-Objekt , das eine einzelne Shape 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 Name Eigenschaft, um dem Shape einen aussagekräftigeren Namen zu geben.

Zurückgeben einer Form innerhalb einer Sammlung

Verwenden Sie Selection.ShapeRange(index), wobei index der Name der Form 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 eines der durch einen Verbinder verbundenen Shapes darstellt, verwenden Sie die BeginConnectedShape EndConnectedShape OR-Eigenschaft.

Zurückgeben einer neu erstellten Freihandform

Verwenden Sie die BuildFreeform(MsoEditingType, Single, Single) und-Methode AddNodes(MsoSegmentType, MsoEditingType, Single, Single, Object, Object, Object, Object) , um die Geometrie einer neuen Freiform 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 Name der Form oder die Indexnummer innerhalb der Gruppe ist, um ein Shape-Objekt zurückzugeben, das ein einzelnes Shape in einem gruppierten Shape darstellt.

Zurückgeben einer neu gebildeten Gruppe von Formen

Verwenden Sie die Group() oder-Methode Regroup() , 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

Name	Beschreibung
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 Shape-Typ für das angegebene Shape Objekt zurück oder legt ihn fest, der eine andere AutoForm als eine Linie, eine Freiformzeichnung oder einen Verbinder darstellen muss. Lesen/Schreiben 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. Lesen/Schreiben 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 Formatierungseigenschaften mit Zusatzinformationen für die angegebene Form enthält. Gilt für Shape Objekte, die Linienbeschriftungen darstellen. Schreibgeschützt.
CanvasItems	Für die interne Verwendung reserviert.
Chart	Gibt ein Objekt zurück, das den _Chart in der Shape. 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 Verbinderformatierungseigenschaften enthält. Gilt für Shape Objekte, die Verbinder darstellen. Schreibgeschützt.
ControlFormat	Gibt ein Objekt zurück, das Eigenschaften des ControlFormat Microsoft Excel-Steuerelements 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üllformatierungseigenschaften 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, das leuchtende Formatierungseigenschaften für diese Form enthält. Schreibgeschützt.
GroupItems	Gibt ein GroupShapes Objekt zurück, das die einzelnen Shapes 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 darüber zurück, ob a 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 einem bestimmten Shape oder Formbereich vorhanden ist. Schreibgeschützt MsoTriState.
HasSmartArt	Ruft ab, ob auf 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 der Spalte A (in einem Arbeitsblatt) oder zum linken Rand der Diagrammfläche (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. Lesen/Schreiben 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 Sammlung 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 das gemeinsame übergeordnete Shape eines untergeordneten Shapes oder einen Bereich untergeordneter Shapes 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, in der das Objekt an die darunter liegenden Zellen angefügt wird, oder legt diese fest. Lesen/Schreiben XlPlacement.
Reflection	Gibt ein Objekt zurück, das Eigenschaften zur Reflexionsformatierung für das Shape 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 einen Wert zurück oder legt einen fest MsoShapeStyleIndex , 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, das Formatierungseigenschaften mit weichen Kanten enthält. Schreibgeschützt.
TextEffect	Gibt ein TextEffectFormat Objekt zurück, das Formatierungseigenschaften für Texteffekte 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 eine 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 Alternativtextes ab, der der angegebenen Form zugeordnet ist, oder legt ihn fest.
Top	Der Abstand vom oberen Rand des obersten Shapes im Formbereich bis 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 ihn 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. Lesen/Schreiben 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

Name	Beschreibung
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 ein anderes Shape 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 ein 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:

Feedback

War diese Seite hilfreich?