Excel.Interfaces.ShapeLoadOptions interface

  • Referenz
Paket:
excel

Stellt ein generisches Formobjekt im Arbeitsblatt dar. Eine Form kann eine geometrische Form, eine Linie, eine Gruppe von Formen usw. sein. Weitere Informationen zum Shape-Objektmodell finden Sie unter Arbeiten mit Shapes mithilfe der Excel-JavaScript-API.

Hinweise

[ API-Satz: ExcelApi 1.9 ]

Eigenschaften

$all

Wenn Sie $all für die Ladeoptionen angeben, werden alle skalaren Eigenschaften (zRange.address. B. ) geladen, aber nicht die Navigationseigenschaften (zRange.format.fill.color. B. ).
altTextDescription

Gibt den alternativen Beschreibungstext für ein Shape -Objekt an.
altTextTitle

Gibt den alternativen Titeltext für ein Shape -Objekt an.
connectionSiteCount

Gibt die Anzahl der Verbindungsseiten für diese Form zurück.
displayName

Ruft den Anzeigenamen der Form ab. Ein neu erstelltes Shape verfügt über einen generierten Namen, der lokalisiert ist und möglicherweise nicht mit seinem nameübereinstimmt. In diesem Szenario können Sie diese API verwenden, um den Namen abzurufen, der auf der Benutzeroberfläche angezeigt wird.
fill

Gibt die Füllungsformatierung dieser Form zurück.
geometricShape

Gibt die der Form zugeordnete geometrische Form zurück. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "GeometricShape" ist.
geometricShapeType

Gibt den geometrischen Formtyp dieser geometrischen Form an. Weitere Informationen finden Sie unter Excel.GeometricShapeType . Gibt zurück null , wenn der Formtyp nicht "GeometricShape" ist.
group

Gibt die der Form zugeordnete Formgruppe zurück. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "GroupShape" ist.
height

Gibt die Höhe der Form in Punkt an. Löst eine Ausnahme aus InvalidArgument , wenn als Eingabe mit einem negativen Wert oder 0 (null) festgelegt wird.
id

Gibt den Shape-Bezeichner an.
image

Gibt das Bild zurück, das der Form zugeordnet ist. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "Image" ist.
left

Der Abstand in Punkten von der linken Seite der Form zur linken Seite des Arbeitsblatts. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert als Eingabe festgelegt wird.
level

Gibt die Ebene der angegebenen Form an. Beispielsweise bedeutet die Ebene 0, dass die Form nicht Teil von Gruppen ist, die Ebene 1 bedeutet, die Form ist Teil einer Gruppe der obersten Ebene, und die Ebene 2 bedeutet, dass die Form Teil einer Untergruppe der obersten Ebene ist.
line

Gibt die Linie zurück, die der Form zugeordnet ist. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "Line" ist.
lineFormat

Gibt die Linienformatierung dieser Form zurück.
lockAspectRatio

Gibt an, ob das Seitenverhältnis dieser Form gesperrt ist.
name

Gibt den Namen der Form an.
parentGroup

Gibt die übergeordnete Gruppe dieser Form an.
placement

Stellt dar, wie das Objekt an die Zellen darunter angefügt ist.
rotation

Gibt die Drehung der Form in Grad an.
textFrame

Gibt das textFrame-Objekt dieser Form zurück.
top

Der Abstand in Punkten zwischen der oberen Kante der Form und der oberen Kante der Arbeitsmappe. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert als Eingabe festgelegt wird.
type

Gibt den Typ dieser Form zurück. Weitere Informationen finden Sie unter Excel.ShapeType .
visible

Gibt an, ob die Form sichtbar ist.
width

Gibt die Breite der Form in Punkt an. Löst eine Ausnahme aus InvalidArgument , wenn als Eingabe mit einem negativen Wert oder 0 (null) festgelegt wird.
zOrderPosition

Gibt die Position der angegebenen Form in der Z-Reihenfolge an, wobei 0 den Boden des Reihenfolgestapels darstellt.

Details zur Eigenschaft

$all

Wenn Sie $all für die Ladeoptionen angeben, werden alle skalaren Eigenschaften (zRange.address. B. ) geladen, aber nicht die Navigationseigenschaften (zRange.format.fill.color. B. ).

$all?: boolean;

Eigenschaftswert

boolean

altTextDescription

Gibt den alternativen Beschreibungstext für ein Shape -Objekt an.

altTextDescription?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

altTextTitle

Gibt den alternativen Titeltext für ein Shape -Objekt an.

altTextTitle?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

connectionSiteCount

Gibt die Anzahl der Verbindungsseiten für diese Form zurück.

connectionSiteCount?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

displayName

Ruft den Anzeigenamen der Form ab. Ein neu erstelltes Shape verfügt über einen generierten Namen, der lokalisiert ist und möglicherweise nicht mit seinem nameübereinstimmt. In diesem Szenario können Sie diese API verwenden, um den Namen abzurufen, der auf der Benutzeroberfläche angezeigt wird.

displayName?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.15 ]

fill

Gibt die Füllungsformatierung dieser Form zurück.

fill?: Excel.Interfaces.ShapeFillLoadOptions;

Eigenschaftswert

Excel.Interfaces.ShapeFillLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

geometricShape

Gibt die der Form zugeordnete geometrische Form zurück. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "GeometricShape" ist.

geometricShape?: Excel.Interfaces.GeometricShapeLoadOptions;

Eigenschaftswert

Excel.Interfaces.GeometricShapeLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

geometricShapeType

Gibt den geometrischen Formtyp dieser geometrischen Form an. Weitere Informationen finden Sie unter Excel.GeometricShapeType . Gibt zurück null , wenn der Formtyp nicht "GeometricShape" ist.

geometricShapeType?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

group

Gibt die der Form zugeordnete Formgruppe zurück. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "GroupShape" ist.

group?: Excel.Interfaces.ShapeGroupLoadOptions;

Eigenschaftswert

Excel.Interfaces.ShapeGroupLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

height

Gibt die Höhe der Form in Punkt an. Löst eine Ausnahme aus InvalidArgument , wenn als Eingabe mit einem negativen Wert oder 0 (null) festgelegt wird.

height?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

id

Gibt den Shape-Bezeichner an.

id?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

image

Gibt das Bild zurück, das der Form zugeordnet ist. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "Image" ist.

image?: Excel.Interfaces.ImageLoadOptions;

Eigenschaftswert

Excel.Interfaces.ImageLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

left

Der Abstand in Punkten von der linken Seite der Form zur linken Seite des Arbeitsblatts. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert als Eingabe festgelegt wird.

left?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

level

Gibt die Ebene der angegebenen Form an. Beispielsweise bedeutet die Ebene 0, dass die Form nicht Teil von Gruppen ist, die Ebene 1 bedeutet, die Form ist Teil einer Gruppe der obersten Ebene, und die Ebene 2 bedeutet, dass die Form Teil einer Untergruppe der obersten Ebene ist.

level?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

line

Gibt die Linie zurück, die der Form zugeordnet ist. Es wird ein Fehler ausgelöst, wenn der Formtyp nicht "Line" ist.

line?: Excel.Interfaces.LineLoadOptions;

Eigenschaftswert

Excel.Interfaces.LineLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

lineFormat

Gibt die Linienformatierung dieser Form zurück.

lineFormat?: Excel.Interfaces.ShapeLineFormatLoadOptions;

Eigenschaftswert

Excel.Interfaces.ShapeLineFormatLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

lockAspectRatio

Gibt an, ob das Seitenverhältnis dieser Form gesperrt ist.

lockAspectRatio?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

name

Gibt den Namen der Form an.

name?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

parentGroup

Gibt die übergeordnete Gruppe dieser Form an.

parentGroup?: Excel.Interfaces.ShapeLoadOptions;

Eigenschaftswert

Excel.Interfaces.ShapeLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

placement

Stellt dar, wie das Objekt an die Zellen darunter angefügt ist.

placement?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.10 ]

rotation

Gibt die Drehung der Form in Grad an.

rotation?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

textFrame

Gibt das textFrame-Objekt dieser Form zurück.

textFrame?: Excel.Interfaces.TextFrameLoadOptions;

Eigenschaftswert

Excel.Interfaces.TextFrameLoadOptions

Hinweise

[ API-Satz: ExcelApi 1.9 ]

top

Der Abstand in Punkten zwischen der oberen Kante der Form und der oberen Kante der Arbeitsmappe. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert als Eingabe festgelegt wird.

top?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

type

Gibt den Typ dieser Form zurück. Weitere Informationen finden Sie unter Excel.ShapeType .

type?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

visible

Gibt an, ob die Form sichtbar ist.

visible?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

width

Gibt die Breite der Form in Punkt an. Löst eine Ausnahme aus InvalidArgument , wenn als Eingabe mit einem negativen Wert oder 0 (null) festgelegt wird.

width?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

zOrderPosition

Gibt die Position der angegebenen Form in der Z-Reihenfolge an, wobei 0 den Boden des Reihenfolgestapels darstellt.

zOrderPosition?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]