API publique et changements incompatibles rétroactifs dans Aspose.Slides pour .NET 14.4.0

API publique et changements incompatibles rétroactifs

Interfaces, classes, méthodes et propriétés ajoutées

Propriété Aspose.Slides.ILayoutSlide.HasDependingSlides ajoutée

La propriété Aspose.Slides.ILayoutSlide.HasDependingSlides renvoie true s’il existe au moins une diapositive qui dépend de cette diapositive de mise en page. Par exemple :

 ILayoutSlide layout = ...;

if (!layout.HasDependingSlides)

    layout.Remove();

Méthode Aspose.Slides.ILayoutSlide.Remove()

La méthode Aspose.Slides.ILayoutSlide.Remove() vous permet de supprimer une mise en page d’une présentation avec un minimum de code. Par exemple :

 ILayoutSlide layout = ...;

if (!layout.HasDependingSlides)

    layout.Remove();

Méthode Aspose.Slides.ILayoutSlideCollection.Remove(ILayoutSlide)

La méthode Aspose.Slides.ILayoutSlideCollection.Remove(ILayoutSlide) vous permet de supprimer une mise en page de la collection. Exemples de code :

 ILayoutSlide layout = ...;

if (!layout.HasDependingSlides)

    presentation.LayoutSlides.Remove(layout);

ou

 IMasterSlide masterSlide = ...;

ILayoutSlide layout = ...;

if (!layout.HasDependingSlides)

    masterSlide.LayoutSlides.Remove(layout);

Aspose.Slides.ILayoutSlideCollection.RemoveUnused()

La méthode Aspose.Slides.ILayoutSlideCollection.RemoveUnused() vous permet de supprimer les diapositives de mise en page inutilisées (les diapositives de mise en page dont HasDependingSlides est false). Exemples de code :

 presentation.LayoutSlides.RemoveUnused();

ou

 IMasterSlide masterSlide = ...;

masterSlide.LayoutSlides.RemoveUnused();

Propriété Aspose.Slides.IMasterSlide.HasDependingSlides

La propriété Aspose.Slides.IMasterSlide.HasDependingSlides renvoie true s’il existe au moins une diapositive qui dépend de cette diapositive maîtresse. Par exemple :

 IMasterSlide masterSlide = ...;

if (!masterSlide.HasDependingSlides)

    presentation.Masters.Remove(masterSlide);

Méthode Aspose.Slides.ISlide.Remove()

La méthode Aspose.Slides.ISlide.Remove() vous permet de supprimer une diapositive d’une présentation avec un minimum de code. Par exemple :

 ISlide slide = ...;

slide.Remove();

Aspose.Slides.SmartArt.ISmartArtNode.BulletFillFormat

La propriété Aspose.Slides.SmartArt.ISmartArtNode.BulletFillFormat renvoie IFillFormat pour le puce d’un nœud SmartArt si la mise en page fournit des puces. Elle peut être utilisée pour définir l’image de la puce.

Propriété Aspose.Slides.SmartArt.ISmartArtNode.Level

La propriété Aspose.Slides.SmartArt.ISmartArtNode.Level renvoie le niveau imbriqué des nœuds SmartArt.

 ISmartArtNode node = diagram.AllNodes[0];

if(node.Level == 1)

    node.TextFrame.Text = "First level";

Propriété Aspose.Slides.SmartArt.ISmartArtNode.Position

La propriété Aspose.Slides.SmartArt.ISmartArtNode.Position renvoie la position d’un nœud parmi ses frères et sœurs.

 ISmartArtNode node = diagram.AllNodes[0];

if (node.ChildNodes.Count > 3)

    node.ChildNodes[0].Position++;

Méthode Aspose.Slides.SmartArt.ISmartArtNode.Remove() ajoutée

La méthode Aspose.Slides.SmartArt.ISmartArtNode.Remove() permet la suppression d’un nœud d’un diagramme.

 ISmartArt node = diagram.AllNodes[0];

node.Remove();

Interface IGlobalLayoutSlideCollection et classe GlobalLayoutSlideCollection

L’interface IGlobalLayoutSlideCollection et la classe GlobalLayoutSlideCollection ont été ajoutées dans l’espace de noms Aspose.Slides.

La classe GlobalLayoutSlideCollection implémente l’interface IGlobalLayoutSlideCollection.

L’interface IGlobalLayoutSlideCollection représente une collection de toutes les diapositives de mise en page d’une présentation. La propriété IPresentation.LayoutSlides est de type IGlobalLayoutSlideCollection. IGlobalLayoutSlideCollection étend l’interface ILayoutSlideCollection avec des méthodes d’ajout et de clonage de diapositives de mise en page dans le contexte d’union des collections individuelles de diapositives de mise en page du maître :

• ILayoutSlide AddClone(ILayoutSlide sourceLayout); – Peut être utilisée pour ajouter une copie d’une diapositive de mise en page spécifiée à la présentation. Cette méthode conserve le formatage source (lors du clonage d’une mise en page entre différentes présentations, le maître de la mise en page peut également être cloné. Le registre interne est utilisé pour suivre les maîtres clonés automatiquement afin d’éviter la création de plusieurs clones du même maître).
• ILayoutSlide AddClone(ILayoutSlide sourceLayout, IMasterSlide destMaster); – Utilisée pour ajouter une copie d’une diapositive de mise en page spécifiée à une présentation. La nouvelle mise en page sera liée au maître défini dans la présentation de destination. Cette option est analogue à copier ou coller avec l’option Use Destination Theme dans Microsoft PowerPoint.
• ILayoutSlide Add(IMasterSlide master, SlideLayoutType layoutType, string layoutName); – Utilisée pour ajouter une nouvelle diapositive de mise en page à une présentation. Types de mise en page pris en charge : Title, TitleOnly, Blank, TitleAndObject, VerticalText, VerticalTitleAndText, TwoObjects, SectionHeader, TwoTextAndTwoObjects, TitleObjectAndCaption, PictureAndCaption, Custom. Le nom de la mise en page peut être généré automatiquement. Une mise en page ajoutée de type SlideLayoutType.Custom ne contient aucun espace réservé ni aucune forme. Un analogue de cette méthode est la méthode IMasterLayoutSlideCollection.Add(SlideLayoutType, string) accessible via la propriété IMasterSlide.LayoutSlides.

Interface IMasterLayoutSlideCollection et classe MasterLayoutSlideCollection

L’interface IMasterLayoutSlideCollection et la classe MasterLayoutSlideCollection ont été ajoutées à l’espace de noms Aspose.Slides. La classe MasterLayoutSlideCollection implémente l’interface IMasterLayoutSlideCollection.

L’interface IMasterLayoutSlideCollection représente une collection de toutes les diapositives de mise en page d’un maître défini. Elle étend l’interface ILayoutSlideCollection avec des méthodes d’ajout, d’insertion, de suppression ou de clonage de diapositives de mise en page dans le contexte des collections individuelles des diapositives de mise en page d’un maître :

 // Method signature:

ILayoutSlide AddClone(ILayoutSlide sourceLayout);

// Code example that attaches copy of the sourceLayout to the destMasterSlide:

IMasterSlide destMasterSlide = ...;

destMasterSlide.LayoutSlides.AddClone(sourceLayout);

• ILayoutSlide InsertClone(int index, ILayoutSlide sourceLayout); – Utilisée pour insérer une copie d’une diapositive de mise en page spécifiée à la position indiquée dans la collection. La nouvelle mise en page sera liée au maître parent de cette collection de diapositives de mise en page. C’est donc l’analogue de copier/coller avec l’option Use Destination Theme dans PowerPoint.
• ILayoutSlide Add(SlideLayoutType layoutType, string layoutName);
• ILayoutSlide Insert(int index, SlideLayoutType layoutType, string layoutName); – Utilisée pour ajouter ou insérer une nouvelle diapositive de mise en page. Types de mise en page pris en charge : Title, TitleOnly, Blank, TitleAndObject, VerticalText, VerticalTitleAndText, TwoObjects, SectionHeader, TwoTextAndTwoObjects, TitleObjectAndCaption, PictureAndCaption, Custom. Le nom de la mise en page peut être généré automatiquement. Une mise en page ajoutée du type SlideLayoutType.Custom ne contient aucun espace réservé ni aucune forme. Un analogue de cette méthode est la méthode IGlobalLayoutSlideCollection.Add(IMasterSlide, SlideLayoutType, string) accessible via la propriété IPresentation.LayoutSlides.
• void RemoveAt(int index); – Utilisée pour supprimer la mise en page à l’index indiqué de la collection.
• void Reorder(int index, ILayoutSlide layoutSlide); – Utilisée pour déplacer la diapositive de mise en page de la collection vers la position indiquée.

Méthodes et propriétés modifiées

Signature de la méthode Aspose.Slides.ISlideCollection.AddClone(ISlide, IMasterSlide)

La signature de la méthode ISlideCollection :

ISlide AddClone(ISlide sourceSlide, IMasterSlide destMaster);

est désormais obsolète et est remplacée par la signature

ISlide AddClone(ISlide sourceSlide, IMasterSlide destMaster, bool allowCloneMissingLayout)

Le paramètre allowCloneMissingLayout indique quoi faire s’il n’existe aucune mise en page appropriée dans destMaster pour la nouvelle diapositive (clonée). La mise en page appropriée est celle qui a le même type ou le même nom que la mise en page de la diapositive source. Si aucune mise en page appropriée n’est présente dans le maître spécifié, la mise en page de la diapositive source sera clonée (si allowCloneMissingLayout est true) ou une PptxEditException sera levée (si allowCloneMissingLayout est false).

Un appel à la méthode obsolète tel que

AddClone(sourceSlide, destMaster);

suppose que allowCloneMissingLayout vaut false (c’est‑à‑dire qu’une PptxEditException sera levée s’il n’existe aucune mise en page appropriée). Un appel fonctionnellement identique utilisant la nouvelle signature ressemble à ceci :

AddClone(sourceSlide, destMaster, false);

Si vous voulez que les mises en page manquantes soient automatiquement clonées au lieu de lever une PptxEditException, passez le paramètre allowCloneMissingLayout à true.

Il en va de même pour la méthode ISlideCollection :

ISlide InsertClone(int index, ISlide sourceSlide, IMasterSlide destMaster);

est également obsolète et est remplacée par la signature

ISlide InsertClone(int index, ISlide sourceSlide, IMasterSlide destMaster, bool allowCloneMissingLayout);

Type de la propriété Aspose.Slides.IMasterSlide.LayoutSlides

Le type de la propriété Aspose.Slides.IMasterSlide.LayoutSlides a été changé de ILayoutSlideCollection vers la nouvelle interface IMasterLayoutSlideCollection. L’interface IMasterLayoutSlideCollection est une descendant de ILayoutSlideCollection, de sorte que le code existant ne nécessite aucune adaptation.

Le type de la propriété Aspose.Slides.IPresentation.LayoutSlides a été modifié

Le type de la propriété Aspose.Slides.IPresentation.LayoutSlides a été changé de ILayoutSlideCollection vers la nouvelle interface IGlobalLayoutSlideCollection. L’interface IGlobalLayoutSlideCollection est une descendante de ILayoutSlideCollection, de sorte que le code existant ne nécessite aucune adaptation.