Utilisation des animations
Cette rubrique décrit la classe Open XML SDK pour Office Animate et sa relation avec le schéma PresentationML au format de fichier Open XML. Pour plus d’informations sur la structure complète des composants et des éléments qui constituent un document PresentationML, voir Structure d’un document PresentationML.
Animation en PresentationML
La spécification ISO/IEC 29500 décrit la section de l'animation de l'infrastructure PresentationML Open XML comme suit :
La section de l'animation de l'infrastructure PresentationML stocke les informations relatives au mouvement et aux aspects connexes des objets. Ce schéma est basé de manière assez libre sur la syntaxe et les concepts du langage SMIL (Synchronized Multimedia Integration Language), une recommandation du W3C en matière de description des présentations multimédias en XML. Le schéma décrit l'ensemble des effets d'animation d'une diapositive, ainsi que l'animation qui se produit entre chaque diapositive (transition). Les animations d'une diapositive sont basées de manière inhérente sur le temps et comprennent les effets d'animation d'un objet ou d'un texte. Toutefois, les transitions entre diapositives ne suivent pas ce concept et se produisent toujours avant une animation de diapositive. Tous les éléments décrits dans ce schéma sont contenus dans le fichier XML de diapositive. Plus précisément, ils se trouvent dans la <transition> et l’élément <de minutage> , comme indiqué ci-dessous :
<p:sld>
<p:cSld> … </p:cSld>
<p:clrMapOvr> … </p:clrMapOvr>
<p:transition> … </p:transition>
<p:timing> … </p:timing>
</p:sld>
L’animation se compose de plusieurs comportements, dont le plus simple est le comportement Animate, représenté par l’élément <anim> . La spécification ISO/IEC 29500 décrit l’élément anim> PresentationML <Open XML utilisé pour représenter le comportement d’animation de base dans un document PresentationML comme suit :
Cet élément est un élément d’animation générique qui nécessite peu ou pas de compréhension sémantique de l’attribut animé. Il peut animer du texte dans une forme ou même dans la forme elle-même. [Exemple : Essayez de mettre en évidence le texte d’une forme en modifiant la taille de sa police de 150 %. L’élément <anim> doit être utilisé comme suit :
<p:anim to="1.5" calcmode="lin" valueType="num">
<p:cBhvr override="childStyle">
<p:cTn id="1" dur="2000" fill="hold">
<p:tgtEl>
<p:spTgt spid="1">
<p:txEl>
<p:charRg st="1" end="4">
</p:txEl>
</p:spTgt>
</p:tgtEl>
<p:attrNameLst>
<p:attrName>style.fontSize</p:attrName>
</p:attrNameLst>
</p:cBhvr>
</p:anim>
Le tableau suivant répertorie les éléments enfants de l’élément anim> utilisés lors de l’utilisation <de l’animation et les classes du Kit de développement logiciel (SDK) Open XML qui leur correspondent.
Élément PresentationML | Classe du Kit de développement logiciel (SDK) Open XML |
---|---|
<cBhvr> | Commonbehavior |
<tavLst> | Timeanimatevaluelist |
Le tableau suivant de la spécification ISO/IEC 29500 décrit les attributs de l’élément <anim> .
Attributs | Description |
---|---|
Par | Cet attribut spécifie une valeur de décalage relative pour l’animation par rapport à sa position avant le début de l’animation. Les valeurs possibles pour cet attribut sont définies par le type de données de chaîne de schéma XML W3C. |
calcmode | Cet attribut spécifie le mode d’interpolation de l’animation. Les valeurs possibles pour cet attribut sont définies par le type simple ST_TLAnimateBehaviorCalcMode (§19.7.20). |
de | Cet attribut spécifie la valeur de départ de l’animation. Les valeurs possibles pour cet attribut sont définies par le type de données de chaîne de schéma XML W3C. |
au | Cet attribut spécifie la valeur de fin de l’animation sous forme de pourcentage. Les valeurs possibles pour cet attribut sont définies par le type de données de chaîne de schéma XML W3C. |
Valuetype | Cet attribut spécifie le type de valeur de propriété. Les valeurs possibles pour cet attribut sont définies par le type simple ST_TLAnimateBehaviorValueType (§19.7.21). |
Classe Animate du Kit de développement logiciel (SDK) Open XML
La classe Animate du Kit de développement logiciel (SDK) OXML représente l’élément <anim> défini dans le schéma de format de fichier Open XML pour les documents PresentationML. Utilisez la classe Animate pour manipuler des éléments anim> individuels <dans un document PresentationML.
Les classes qui représentent des éléments enfants de l’élément <anim> et qui sont donc couramment associées à la classe Animate sont indiquées dans la liste suivante.
Classe CommonBehavior
La classe CommonBehavior correspond à l’élément <cBhvr> . Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément <cBhvr>:
Cet élément décrit les comportements usuels des animations.
Essayez de mettre en évidence le texte d’une forme en modifiant la taille de sa police. L’élément <anim> doit être utilisé comme suit :
<p:anim to="1.5" calcmode="lin" valueType="num">
<p:cBhvr override="childStyle">
<p:cTn id="6" dur="2000" fill="hold">
<p:tgtEl>
<p:spTgt spid="3">
<p:txEl>
<p:charRg st="4294967295" end="4294967295"/>
</p:txEl>
</p:spTgt>
</p:tgtEl>
<p:attrNameLst>
<p:attrName>style.fontSize</p:attrName>
</p:attrNameLst>
</p:cBhvr>
</p:anim>
Classe TimeAnimateValueList
La classe TimeAnimateValueList correspond à l’élément <tavLst> . Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément <tavLst> :
Cet élément spécifie une liste d'éléments de valeur dont l'animation est basée sur le temps.
Exemple : prenons une forme avec une animation « fly-in ». L’élément <tav> doit être utilisé comme suit :
<p:anim calcmode="lin" valueType="num">
<p:cBhvr additive="base"> … </p:cBhvr>
<p:tavLst>
<p:tav tm="0">
<p:val>
<p:strVal val="1+#ppt_h/2"/>
</p:val>
</p:tav>
<p:tav tm="100000">
<p:val>
<p:strVal val="#ppt_y"/>
</p:val>
</p:tav>
</p:tavLst>
</p:anim>
Utilisation de la classe Animate
La classe Animate , qui représente l’élément <anim> , est donc également associée à d’autres classes qui représentent les éléments enfants de l’élément <anim> , notamment la classe CommonBehavior , qui décrit les comportements d’animation courants, et la classe TimeAnimateValueList , qui spécifie une liste d’éléments de valeur animés dans le temps, comme indiqué dans le code XML précédent. Les autres classes associées à la classe Animate sont la classe Timing , qui spécifie les informations de minutage de toutes les animations de la diapositive, et la classe TargetElement , qui spécifie les éléments enfants cibles auxquels les effets d’animation sont appliqués.
Voir aussi
À propos du Kit de développement logiciel (SDK) Open XML pour OfficeProcédure : créer une présentation en fournissant un nom de fichierProcédure : insérer une nouvelle diapositive dans une présentationProcédure : supprimer une diapositive d’une présentationProcédure : appliquer un thème à une présentation