Utilisation des mises en page de diapositive
Cette rubrique décrit la classe Du Kit de développement logiciel (SDK) Open XML pour Office SlideLayout et comment elle est liée au schéma PresentationML au format de fichier Open XML.
Mises en page de diapositive dans PresentationML
La spécification ISO/IEC 29500 décrit l’élément Open XML PresentationML <sldLayout> utilisé pour représenter les dispositions de diapositives dans un document PresentationML comme suit :
Cet élément spécifie une instance de mise en page de diapositive. La mise en page de diapositive contient par essence une conception de diapositive modèle applicable à toute diapositive existante. Lorsqu’elle est appliquée à une diapositive existante, tout le contenu correspondant est mappé à cette nouvelle mise en page.
L’élément <sldLayout> est l’élément racine du composant PresentationML Slide Layout. 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.
Le tableau suivant répertorie les éléments enfants de l’élément <sldLayout> utilisé lors de l’utilisation de mises en page de diapositives et des 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 |
|---|---|
| <clrMapOvr> | Colormapoverride |
| <cSld> | Commonslidedata |
| <extLst> | Extensionlistwithmodification |
| <Hf> | HeaderFooter |
| <Timing> | Timing |
| <Transition> | Transition |
Le tableau suivant de la spécification ISO/IEC 29500 décrit les attributs de l’élément <sldLayout> .
| Attributs | Description |
|---|---|
| matchingName (nom correspondant) | Spécifie un nom à utiliser au lieu de l’attribut name de l’élément cSld . Il sert à la correspondance de mise en page en réponse aux modifications de mise en page et aux applications de modèle. Les valeurs possibles de cet attribut sont définies par le type de données string du schéma W3C XML. |
| preserve (conserver la mise en page de diapositive) | Spécifie si la mise en page des diapositives correspondante est supprimée lorsque toutes les diapositives basées sur cette mise en page sont supprimées. Si cet attribut n’est pas spécifié, la valeur false doit être prise en compte par l’application de génération. Cela signifie que la diapositive est supprimée, si elle n’a aucun lien avec d’autres diapositives de la présentation. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML. |
| showMasterPhAnim (afficher les animations d’espace réservé du masque) | Spécifie si des animations doivent être affichées ou non sur des espaces réservés de la diapositive principale. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML. |
| showMasterSp (afficher les formes principales) | Spécifie si les formes figurant sur la diapositive principale doivent être affichées ou non sur les diapositives. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML. |
| type (type de mise en page de diapositive) | Spécifie le type de mise en page utilisé par cette diapositive. Les valeurs possibles de cet attribut sont définies par le type simple ST_SlideLayoutType (§19.7.15). |
| userDrawn (est dessiné par l’utilisateur) | Spécifie si l’objet correspondant a été dessiné par l’utilisateur, auquel cas il ne doit pas être supprimé. Cela permet de marquer les diapositives ayant du contenu dessiné par l’utilisateur. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML. |
Classe SlideLayout du Kit de développement logiciel (SDK) Open XML
La classe SlideLayout du Kit de développement logiciel (SDK) OXML représente l’élément <sldLayout> défini dans le schéma de format de fichier Open XML pour les documents PresentationML. Utilisez la classe SlideLayout pour manipuler des éléments sldLayout> individuels <dans un document PresentationML.
Les classes qui représentent des éléments enfants de l’élément <sldLayout> et qui sont donc couramment associées à la classe SlideLayout sont présentées dans la liste suivante.
Classe ColorMapOverride
La classe ColorMapOverride correspond à l’élément <clrMapOvr> . Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément <clrMapOvr> :
Cet élément fournit un mécanisme avec lequel remplacer les jeux de couleurs répertoriés dans l’élément <ClrMap> . Si l’élément <enfant masterClrMapping> est présent, le jeu de couleurs défini par le master est utilisé. Si l’élément <enfant overrideClrMapping> est présent, il définit un nouveau jeu de couleurs spécifique à la diapositive de notes parente, à la diapositive de présentation ou à la disposition des diapositives.
Classe CommonSlideData
La classe CommonSlideData correspond à l’élément <cSld> . Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément <cSld> :
Cet élément spécifie un conteneur pour le type d’informations de diapositive relatif à l’ensemble des types de diapositives. Toutes les diapositives partagent un ensemble commun de propriétés indépendantes du type de diapositive ; la description de ces propriétés pour une diapositive particulière est stockée dans le conteneur cSld> de <la diapositive. Les données de diapositive spécifiques au type de diapositive indiqué par l’élément parent sont stockées ailleurs.
Les données réelles dans <cSld> décrivent uniquement la diapositive parente particulière ; il s’agit uniquement du type d’informations stockées qui est commun à toutes les diapositives.
Classe ExtensionListWithModification
La classe ExtensionListWithModification correspond à l’élément <extLst>. Les informations suivantes de la spécification ISO/IEC 29500 introduisent l’élément <extLst> :
Cet élément spécifie la liste d’extensions avec possibilité de modification dans laquelle toutes les extensions futures de type <d’élément ext> sont définies. La liste des extensions et les extensions futures correspondantes sont utilisées pour étendre les possibilités de stockage de l’infrastructure PresentationML. Ceci permet à différents nouveaux types de données d’être stockés en mode natif dans l’infrastructure.
Remarque
L’utilisation de cet élément extLst permet à l’application de génération de stocker si cette propriété d’extension a été modifiée.
Classe HeaderFooter
La classe HeaderFooter correspond à l’élément <hf> . Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément <hf> :
Cet élément spécifie les informations d’en-tête et de pied de page d’une diapositive. Les en-têtes et les pieds de page contiennent des espaces réservés au texte dont la cohérence doit être assurée dans l’ensemble des diapositives et types de diapositives, par exemple une date et heure, un numéro de diapositive, ainsi que du texte d’en-tête et de pied de page personnalisé.
Classe Timing
La classe Timing correspond à l’élément <minutage> . Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément <de minutage> :
Cet élément spécifie les informations de minutage pour la gestion de l’ensemble des animations et des événements minutés dans la diapositive correspondante. Ces informations sont suivies par le biais de nœuds de temps dans l’élément <de minutage> . Pour plus d’informations sur les spécificités relatives aux nœuds de temps et sur leur définition, voir la section de l’animation de l’infrastructure PresentationML.
Classe Transition
La classe Transition correspond à l’élément transition<>. Les informations suivantes de la spécification ISO/IEC 29500 présentent l’élément de <transition> :
Cet élément spécifie le type de transition à utiliser entre la diapositive actuelle et la diapositive précédente. En d’autres termes, les informations de transition sont stockées dans la diapositive qui s’affiche à l’issue de la transition.
Utilisation de la classe SlideLayout
Comme indiqué dans l’exemple de code du Kit de développement logiciel (SDK) Open XML qui suit, chaque instance de la classe SlideLayout est associée à un instance de la classe SlideLayoutPart, qui représente un composant de disposition de diapositive, l’une des parties requises d’un package de fichier de présentation PresentationML. Chaque classe SlideLayout instance doit également être associée à des instances des classes SlideMaster et Slide, qui sont à leur tour associées à des parties de présentation requises de même nom, représentées par les classes SlideMasterPart et SlidePart.
La classe SlideLayout , qui représente l’élément <sldLayout> , est donc également associée à une série d’autres classes qui représentent les éléments enfants de l’élément <sldLayout> . Parmi ces classes, comme indiqué dans l’exemple de code suivant, figurent la classe CommonSlideData , la classe ColorMapOverride , la classe ShapeTree et la classe Shape .
Exemple de code du Kit de développement logiciel (SDK) Open XML
La méthode suivante de l’article Guide pratique pour créer un document de présentation en fournissant un nom de fichier ajoute un nouveau composant de mise en page de diapositive à une présentation existante et crée un instance d’une classeSlideLayout du Kit de développement logiciel (SDK) Open XML dans le nouveau composant De mise en page des diapositives. Le constructeur de classe SlideLayout crée des instances de la classe CommonSlideData et de la classe ColorMapOverride. Le constructeur de classe CommonSlideData crée un instance de la classe ShapeTree, dont le constructeur crée à son tour des instances de classe supplémentaires : une instance de la classe [NonVisualGroupShapeProperties (https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.nonvisualgroupshapeproperties.aspx) classe , un instance de la classe GroupShapeProperties et un instance de la classe Shape.
L’espace de noms représenté par la lettre P dans le code est l’espace de noms [DocumentFormat.OpenXml.Presentation (https://msdn.microsoft.com/library/office/documentformat.openxml.presentation.aspx) .
using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Drawing;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Presentation;
using P = DocumentFormat.OpenXml.Presentation;
static SlideLayoutPart CreateSlideLayoutPart(SlidePart slidePart1)
{
SlideLayoutPart slideLayoutPart1 = slidePart1.AddNewPart<SlideLayoutPart>("rId1");
SlideLayout slideLayout = new SlideLayout(
new CommonSlideData(new ShapeTree(
new P.NonVisualGroupShapeProperties(
new P.NonVisualDrawingProperties() { Id = (UInt32Value)1U, Name = "" },
new P.NonVisualGroupShapeDrawingProperties(),
new ApplicationNonVisualDrawingProperties()),
new GroupShapeProperties(new TransformGroup()),
new P.Shape(
new P.NonVisualShapeProperties(
new P.NonVisualDrawingProperties() { Id = (UInt32Value)2U, Name = "" },
new P.NonVisualShapeDrawingProperties(new ShapeLocks() { NoGrouping = true }),
new ApplicationNonVisualDrawingProperties(new PlaceholderShape())),
new P.ShapeProperties(),
new P.TextBody(
new BodyProperties(),
new ListStyle(),
new Paragraph(new EndParagraphRunProperties()))))),
new ColorMapOverride(new MasterColorMapping()));
slideLayoutPart1.SlideLayout = slideLayout;
return slideLayoutPart1;
}