Freigeben über


PowerPoint.Interfaces.ShapeData interface

Eine Schnittstelle, die die durch Aufrufen shape.toJSON()von zurückgegebenen Daten beschreibt.

Eigenschaften

altTextDescription

Die Alternativtextbeschreibung der Form.

Alternativtext stellt alternative, textbasierte Darstellungen der in der Form enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Seh- oder kognitiven Beeinträchtigungen, die die Form möglicherweise nicht sehen oder verstehen können.

altTextTitle

Der Alternativtexttitel des Shapes.

Alternativtext stellt alternative, textbasierte Darstellungen der in der Form enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Seh- oder kognitiven Beeinträchtigungen, die die Form möglicherweise nicht sehen oder verstehen können. Ein Titel kann einer Person mit einer Behinderung vorgelesen werden und wird verwendet, um zu bestimmen, ob sie die Beschreibung des Inhalts hören möchte.

creationId

Ruft die Erstellungs-ID des Shapes ab. Gibt zurück null , wenn das Shape keine Erstellungs-ID aufweist.

height

Gibt die Höhe der Form in Punkt an. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

id

Ruft die eindeutige ID des Shapes ab.

isDecorative

Gibt an, ob die Form dekorativ ist oder nicht.

Dekorative Objekte erhöhen visuelles Interesse, sind aber nicht informativ (z. B. stilistische Rahmen). Personen die Verwendung von Sprachausgaben hören, dass diese dekorativ sind, sodass sie wissen, dass keine wichtigen Informationen fehlen.

left

Der Abstand in Punkt von der linken Seite der Form zur linken Seite der Folie.

level

Gibt die Ebene der angegebenen Form zurück.

  • Die Ebene 0 bedeutet, dass die Form nicht Teil einer Gruppe ist.

  • Die Ebene 1 bedeutet, dass die Form Teil einer Gruppe der obersten Ebene ist.

  • Eine Ebene größer als 1 gibt an, dass die Form eine geschachtelte Gruppe ist.

name

Gibt den Namen dieser Form an.

rotation

Gibt die Drehung der Form um die Z-Achse in Grad an. Ein positiver Wert gibt eine Drehung im Uhrzeigersinn und ein negativer Wert eine Drehung gegen den Uhrzeigersinn an.

top

Der Abstand in Punkt vom oberen Rand der Form bis zum oberen Rand der Folie.

type

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

visible

Gibt an, ob die Form sichtbar ist.

width

Gibt die Breite der Form in Punkt an. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

zOrderPosition

Gibt die Z-Reihenfolge-Position der Form zurück, wobei 0 den unteren Rand des Auftragsstapels darstellt. Jede Form auf einer Folie verfügt über eine eindeutige Z-Reihenfolge, aber jede Folie verfügt auch über einen eindeutigen Stapel der Z-Reihenfolge, sodass zwei Formen auf separaten Folien die gleiche Z-Reihenfolge-Nummer haben können.

Details zur Eigenschaft

altTextDescription

Die Alternativtextbeschreibung der Form.

Alternativtext stellt alternative, textbasierte Darstellungen der in der Form enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Seh- oder kognitiven Beeinträchtigungen, die die Form möglicherweise nicht sehen oder verstehen können.

altTextDescription?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

altTextTitle

Der Alternativtexttitel des Shapes.

Alternativtext stellt alternative, textbasierte Darstellungen der in der Form enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Seh- oder kognitiven Beeinträchtigungen, die die Form möglicherweise nicht sehen oder verstehen können. Ein Titel kann einer Person mit einer Behinderung vorgelesen werden und wird verwendet, um zu bestimmen, ob sie die Beschreibung des Inhalts hören möchte.

altTextTitle?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

creationId

Ruft die Erstellungs-ID des Shapes ab. Gibt zurück null , wenn das Shape keine Erstellungs-ID aufweist.

creationId?: string | null;

Eigenschaftswert

string | null

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

height

Gibt die Höhe der Form in Punkt an. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

height?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

id

Ruft die eindeutige ID des Shapes ab.

id?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: PowerPointApi 1.3 ]

isDecorative

Gibt an, ob die Form dekorativ ist oder nicht.

Dekorative Objekte erhöhen visuelles Interesse, sind aber nicht informativ (z. B. stilistische Rahmen). Personen die Verwendung von Sprachausgaben hören, dass diese dekorativ sind, sodass sie wissen, dass keine wichtigen Informationen fehlen.

isDecorative?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

left

Der Abstand in Punkt von der linken Seite der Form zur linken Seite der Folie.

left?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

level

Gibt die Ebene der angegebenen Form zurück.

  • Die Ebene 0 bedeutet, dass die Form nicht Teil einer Gruppe ist.

  • Die Ebene 1 bedeutet, dass die Form Teil einer Gruppe der obersten Ebene ist.

  • Eine Ebene größer als 1 gibt an, dass die Form eine geschachtelte Gruppe ist.

level?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.8 ]

name

Gibt den Namen dieser Form an.

name?: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

rotation

Gibt die Drehung der Form um die Z-Achse in Grad an. Ein positiver Wert gibt eine Drehung im Uhrzeigersinn und ein negativer Wert eine Drehung gegen den Uhrzeigersinn an.

rotation?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

top

Der Abstand in Punkt vom oberen Rand der Form bis zum oberen Rand der Folie.

top?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

type

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

type?: PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox";

Eigenschaftswert

PowerPoint.ShapeType | "Unsupported" | "Image" | "GeometricShape" | "Group" | "Line" | "Table" | "Callout" | "Chart" | "ContentApp" | "Diagram" | "Freeform" | "Graphic" | "Ink" | "Media" | "Model3D" | "Ole" | "Placeholder" | "SmartArt" | "TextBox"

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

visible

Gibt an, ob die Form sichtbar ist.

visible?: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: PowerPointApi 1.10 ]

width

Gibt die Breite der Form in Punkt an. Löst eine InvalidArgument Ausnahme aus, wenn mit einem negativen Wert festgelegt wird.

width?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.4 ]

zOrderPosition

Gibt die Z-Reihenfolge-Position der Form zurück, wobei 0 den unteren Rand des Auftragsstapels darstellt. Jede Form auf einer Folie verfügt über eine eindeutige Z-Reihenfolge, aber jede Folie verfügt auch über einen eindeutigen Stapel der Z-Reihenfolge, sodass zwei Formen auf separaten Folien die gleiche Z-Reihenfolge-Nummer haben können.

zOrderPosition?: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: PowerPointApi 1.8 ]