PowerPoint.Interfaces.ShapeData interface

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

Hinweise

Verwendet von

Eigenschaften

altTextDescription

Die Alternativtextbeschreibung der Form.

Alternativtext stellt alternative, textbasierte Darstellungen der im Shape enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Sehkraft 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 im Shape enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Sehkraft 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 festzustellen, ob sie die Beschreibung des Inhalts hören möchte.

creationId

Ruft die Erstellungs-ID der Form ab. Gibt zurück null , wenn das Shape keine Erstellungs-ID hat.

height

Gibt die Höhe des Shapes in Punkten an. Löst eine InvalidArgument Ausnahme aus, wenn sie mit einem negativen Wert festgelegt wird.

id

Ruft die eindeutige ID des Shapes ab.

isDecorative

Stellt dar, ob die Form dekorativ ist oder nicht.

Dekorative Objekte machen etwas visuell interessanter, sind aber nicht informativ (z. B. dekorative Rahmen). People, die Sprachausgaben verwenden, können hören, dass diese Objekte dekorativ sind, und wissen dann, dass ihnen keine wichtigen Informationen entgehen.

left

Der Abstand in Punkten von der linken Seite des Shapes zur linken Seite der Folie.

level

Gibt die Höhe der angegebenen Form zurück.

  • Der Wert 0 bedeutet, dass die Form nicht Teil einer Gruppe ist.

  • Eine Ebene von 1 bedeutet, dass das Shape Teil einer Gruppe der obersten Ebene ist.

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

name

Gibt den Namen dieses Shapes an.

rotation

Gibt die Drehung des Shapes um die Z-Achse in Grad an. Ein positiver Wert zeigt eine Drehung im Uhrzeigersinn und ein negativer Wert eine Drehung gegen den Uhrzeigersinn an.

top

Der Abstand in Punkten vom oberen Rand des Shapes 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 das Shape sichtbar ist.

width

Gibt die Breite des Shapes in Punkten an. Löst eine InvalidArgument Ausnahme aus, wenn sie mit einem negativen Wert festgelegt wird.

zOrderPosition

Gibt die Z-Reihenfolge-Position der Form zurück, wobei 0 den unteren Rand des Ordnungsstapels darstellt. Jedes Shape auf einer Folie hat eine eindeutige Z-Reihenfolge, aber jede Folie hat auch einen eindeutigen Z-Reihenfolge-Stapel, sodass zwei Shapes auf getrennten Folien die gleiche Z-Reihenfolge-Nummer haben können.

Details zur Eigenschaft

altTextDescription

Die Alternativtextbeschreibung der Form.

Alternativtext stellt alternative, textbasierte Darstellungen der im Shape enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Sehkraft 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 im Shape enthaltenen Informationen bereit. Diese Informationen sind nützlich für Personen mit Sehkraft 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 festzustellen, 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 der Form ab. Gibt zurück null , wenn das Shape keine Erstellungs-ID hat.

creationId?: string | null;

Eigenschaftswert

string | null

Hinweise

API-Satz: PowerPointApi 1.10

height

Gibt die Höhe des Shapes in Punkten an. Löst eine InvalidArgument Ausnahme aus, wenn sie 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

Stellt dar, ob die Form dekorativ ist oder nicht.

Dekorative Objekte machen etwas visuell interessanter, sind aber nicht informativ (z. B. dekorative Rahmen). People, die Sprachausgaben verwenden, können hören, dass diese Objekte dekorativ sind, und wissen dann, dass ihnen keine wichtigen Informationen entgehen.

isDecorative?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: PowerPointApi 1.10

left

Der Abstand in Punkten von der linken Seite des Shapes zur linken Seite der Folie.

left?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi 1.4

level

Gibt die Höhe der angegebenen Form zurück.

  • Der Wert 0 bedeutet, dass die Form nicht Teil einer Gruppe ist.

  • Eine Ebene von 1 bedeutet, dass das Shape Teil einer Gruppe der obersten Ebene ist.

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

level?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi 1.8

name

Gibt den Namen dieses Shapes an.

name?: string;

Eigenschaftswert

string

Hinweise

API-Satz: PowerPointApi 1.4

rotation

Gibt die Drehung des Shapes um die Z-Achse in Grad an. Ein positiver Wert zeigt 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 Punkten vom oberen Rand des Shapes 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 das Shape sichtbar ist.

visible?: boolean;

Eigenschaftswert

boolean

Hinweise

API-Satz: PowerPointApi 1.10

width

Gibt die Breite des Shapes in Punkten an. Löst eine InvalidArgument Ausnahme aus, wenn sie 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 Ordnungsstapels darstellt. Jedes Shape auf einer Folie hat eine eindeutige Z-Reihenfolge, aber jede Folie hat auch einen eindeutigen Z-Reihenfolge-Stapel, sodass zwei Shapes auf getrennten Folien die gleiche Z-Reihenfolge-Nummer haben können.

zOrderPosition?: number;

Eigenschaftswert

number

Hinweise

API-Satz: PowerPointApi 1.8