Partager via


PowerPoint.Interfaces.ShapeLoadOptions interface

Représente une forme unique dans la diapositive.

Remarques

[ Ensemble d’API : PowerPointApi 1.3 ]

Propriétés

$all

La spécification des options de $all chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).

adjustments

Retourne un Adjustments objet qui contient des valeurs d’ajustement pour tous les ajustements de cette forme.

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.

fill

Renvoie la mise en forme de remplissage de cette forme.

group

Retourne le ShapeGroup associé à la forme. Si le type de forme n’est pas group, cette méthode retourne l’erreur GeneralException .

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é.

lineFormat

Renvoie la mise en forme de ligne de cette forme.

name

Spécifie le nom de cette forme.

parentGroup

Renvoie le groupe parent de cette forme. Si la forme ne fait pas partie d’un groupe, cette méthode retourne l’erreur GeneralException .

placeholderFormat

Retourne les propriétés qui s’appliquent spécifiquement à cet espace réservé. Si le type de forme n’est pas placeholder, cette méthode retourne l’erreur GeneralException .

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.

textFrame

Renvoie l’objet PowerPoint.TextFrame de ce Shape. Lève une InvalidArgument exception si la forme ne prend pas en charge un TextFrame.

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é

$all

La spécification des options de $all chargement charge toutes les propriétés scalaires (telles que Range.address) mais pas les propriétés de navigation (telles que Range.format.fill.color).

$all?: boolean;

Valeur de la propriété

boolean

adjustments

Retourne un Adjustments objet qui contient des valeurs d’ajustement pour tous les ajustements de cette forme.

adjustments?: PowerPoint.Interfaces.AdjustmentsLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

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?: boolean;

Valeur de la propriété

boolean

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?: boolean;

Valeur de la propriété

boolean

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?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

fill

Renvoie la mise en forme de remplissage de cette forme.

fill?: PowerPoint.Interfaces.ShapeFillLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

group

Retourne le ShapeGroup associé à la forme. Si le type de forme n’est pas group, cette méthode retourne l’erreur GeneralException .

group?: PowerPoint.Interfaces.ShapeGroupLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

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?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

id

Obtient l’ID unique de la forme.

id?: boolean;

Valeur de la propriété

boolean

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?: boolean;

Valeur de la propriété

boolean

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?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

lineFormat

Renvoie la mise en forme de ligne de cette forme.

lineFormat?: PowerPoint.Interfaces.ShapeLineFormatLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

name

Spécifie le nom de cette forme.

name?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

parentGroup

Renvoie le groupe parent de cette forme. Si la forme ne fait pas partie d’un groupe, cette méthode retourne l’erreur GeneralException .

parentGroup?: PowerPoint.Interfaces.ShapeLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

placeholderFormat

Retourne les propriétés qui s’appliquent spécifiquement à cet espace réservé. Si le type de forme n’est pas placeholder, cette méthode retourne l’erreur GeneralException .

placeholderFormat?: PowerPoint.Interfaces.PlaceholderFormatLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]

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?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.10 ]

textFrame

Renvoie l’objet PowerPoint.TextFrame de ce Shape. Lève une InvalidArgument exception si la forme ne prend pas en charge un TextFrame.

textFrame?: PowerPoint.Interfaces.TextFrameLoadOptions;

Valeur de la propriété

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

top

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

top?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.4 ]

type

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

type?: boolean;

Valeur de la propriété

boolean

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?: boolean;

Valeur de la propriété

boolean

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?: boolean;

Valeur de la propriété

boolean

Remarques

[ Ensemble d’API : PowerPointApi 1.8 ]