Partager via


PowerPoint.Interfaces.ShapeData interface

Interface décrivant les données retournées en appelant shape.toJSON().

Propriétés

altTextDescription

Description du texte de remplacement de la forme.

Le texte de remplacement fournit des représentations textuelles alternatives des informations contenues dans la forme. Cette information est utile pour les personnes malvoyantes ou cognitives qui peuvent ne pas être en mesure de voir ou de comprendre la forme.

altTextTitle

Titre du texte de remplacement de la forme.

Le texte de remplacement fournit des représentations textuelles alternatives des informations contenues dans la forme. Cette information est utile pour les personnes malvoyantes ou cognitives qui peuvent ne pas être en mesure de voir ou de comprendre la forme. Un titre peut être lu à une personne handicapée et est utilisé pour déterminer si elle souhaite entendre la description du contenu.

creationId

Obtient l’ID de création de la forme. Retourne null si la forme n’a pas d’ID de création.

height

Spécifie la hauteur, en points, de la forme. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

id

Obtient l’ID unique de la forme.

isDecorative

Représente si la forme est décorative ou non.

Les objets décoratifs ajoutent un intérêt visuel, mais ne sont pas informatifs (par exemple, bordures stylistiques). Personnes utilisant des lecteurs d’écran entendront qu’ils sont décoratifs afin qu’ils sachent qu’ils ne manquent aucune information importante.

left

Distance, en points, entre le côté gauche de la forme et le côté gauche de la diapositive.

level

Retourne le niveau de la forme spécifiée.

  • Un niveau de 0 signifie que la forme ne fait pas partie d’un groupe.

  • Un niveau de 1 signifie que la forme fait partie d’un groupe de niveau supérieur.

  • Un niveau supérieur à 1 indique que la forme est un groupe imbriqué.

name

Spécifie le nom de cette forme.

rotation

Spécifie la rotation, en degrés, de la forme autour de l’axe z. Une valeur positive indique une rotation dans le sens des aiguilles d’une montre, et une valeur négative indique une rotation dans le sens inverse des aiguilles d’une montre.

top

Distance, en points, entre le bord supérieur de la forme et le bord supérieur de la diapositive.

type

Renvoie le type de cette forme. Pour plus d’informations , voir PowerPoint.ShapeType .

visible

Spécifie si la forme est visible.

width

Spécifie la largeur, en points, de la forme. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

zOrderPosition

Retourne la position de l’ordre de plan de la forme, avec 0 représentant le bas de la pile de commandes. Chaque forme d’une diapositive a un ordre de plan unique, mais chaque diapositive a également une pile d’ordre de plan unique, de sorte que deux formes sur des diapositives distinctes peuvent avoir le même numéro d’ordre de plan.

Détails de la propriété

altTextDescription

Description du texte de remplacement de la forme.

Le texte de remplacement fournit des représentations textuelles alternatives des informations contenues dans la forme. Cette information est utile pour les personnes malvoyantes ou cognitives qui peuvent ne pas être en mesure de voir ou de comprendre la forme.

altTextDescription?: string;

Valeur de la propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

altTextTitle

Titre du texte de remplacement de la forme.

Le texte de remplacement fournit des représentations textuelles alternatives des informations contenues dans la forme. Cette information est utile pour les personnes malvoyantes ou cognitives qui peuvent ne pas être en mesure de voir ou de comprendre la forme. Un titre peut être lu à une personne handicapée et est utilisé pour déterminer si elle souhaite entendre la description du contenu.

altTextTitle?: string;

Valeur de la propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

creationId

Obtient l’ID de création de la forme. Retourne null si la forme n’a pas d’ID de création.

creationId?: string | null;

Valeur de la propriété

string | null

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

height

Spécifie la hauteur, en points, de la forme. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

height?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

id

Obtient l’ID unique de la forme.

id?: string;

Valeur de la propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

isDecorative

Représente si la forme est décorative ou non.

Les objets décoratifs ajoutent un intérêt visuel, mais ne sont pas informatifs (par exemple, bordures stylistiques). Personnes utilisant des lecteurs d’écran entendront qu’ils sont décoratifs afin qu’ils sachent qu’ils ne manquent aucune information importante.

isDecorative?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

left

Distance, en points, entre le côté gauche de la forme et le côté gauche de la diapositive.

left?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

level

Retourne le niveau de la forme spécifiée.

  • Un niveau de 0 signifie que la forme ne fait pas partie d’un groupe.

  • Un niveau de 1 signifie que la forme fait partie d’un groupe de niveau supérieur.

  • Un niveau supérieur à 1 indique que la forme est un groupe imbriqué.

level?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

name

Spécifie le nom de cette forme.

name?: string;

Valeur de la propriété

string

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

rotation

Spécifie la rotation, en degrés, de la forme autour de l’axe z. Une valeur positive indique une rotation dans le sens des aiguilles d’une montre, et une valeur négative indique une rotation dans le sens inverse des aiguilles d’une montre.

rotation?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

top

Distance, en points, entre le bord supérieur de la forme et le bord supérieur de la diapositive.

top?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

type

Renvoie le type de cette forme. Pour plus d’informations , voir PowerPoint.ShapeType .

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

Valeur de la propriété

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

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

visible

Spécifie si la forme est visible.

visible?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

width

Spécifie la largeur, en points, de la forme. Lève une exception lorsqu’elle InvalidArgument est définie avec une valeur négative.

width?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

zOrderPosition

Retourne la position de l’ordre de plan de la forme, avec 0 représentant le bas de la pile de commandes. Chaque forme d’une diapositive a un ordre de plan unique, mais chaque diapositive a également une pile d’ordre de plan unique, de sorte que deux formes sur des diapositives distinctes peuvent avoir le même numéro d’ordre de plan.

zOrderPosition?: number;

Valeur de la propriété

number

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]