API publique et changements incompatibles en arrière dans Aspose.Slides pour .NET 15.4.0

Modifications de l’API publique

Enum OrganizationChartLayoutType a été ajouté

L’énumération Aspose.Slides.SmartArt.OrganizationChartLayoutType représente le type de formatage des nœuds enfants dans un organigramme.

Méthode IBulletFormat.ApplyDefaultParagraphIndentsShifts a été ajoutée

La méthode Aspose.Slides.IBulletFormat.ApplyDefaultParagraphIndentsShifts définit les décalages non nuls par défaut pour l’indentation de paragraphe effective et la marge gauche lorsque les puces sont activées (comme PowerPoint le fait si la numérotation/les puces de paragraphe sont activées). Si les puces sont désactivées, elle réinitialise simplement l’indentation de paragraphe et la marge gauche (comme PowerPoint le fait si la numérotation/les puces de paragraphe sont désactivées).

Voir des exemples ici:

Méthode IConnector.Reroute a été ajoutée

La méthode Aspose.Slides.IConnector.Reroute redirige le connecteur afin qu’il emprunte le chemin le plus court possible entre les formes qu’il relie. Pour ce faire, la méthode Reroute() peut modifier les propriétés StartShapeConnectionSiteIndex et EndShapeConnectionSiteIndex.


 using(Presentation input = new Presentation())

{

  IShapeCollection shapes = input.Slides[0].Shapes;

  IConnector connector = shapes.AddConnector(ShapeType.BentConnector2, 0, 0, 10, 10);

  IAutoShape ellipse = shapes.AddAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);

  IAutoShape rectangle = shapes.AddAutoShape(ShapeType.Rectangle, 100, 300, 100, 100);

  connector.StartShapeConnectedTo = ellipse;

  connector.EndShapeConnectedTo = rectangle;

  connector.Reroute();

  input.Save("output.pptx", SaveFormat.Pptx);

}

Méthode IPresentation.GetSlideById a été ajoutée

La méthode Aspose.Slides.IPresentation.GetSlideById(System.UInt32) renvoie une Slide, MasterSlide ou LayoutSlide selon l’ID de la diapositive.


 using (Presentation presentation = new Presentation())

{

    uint id = presentation.Slides[0].SlideId;

    IBaseSlide slide = presentation.GetSlideById(id);

    Debug.Assert(presentation.Slides[0] == slide);

}

Propriété IShape.ConnectionSiteCount a été ajoutée

La propriété Aspose.Slides.IShape.ConnectionSiteCount renvoie le nombre de points de connexion sur la forme.


 using(Presentation input = new Presentation())

{

  IShapeCollection shapes = input.Slides[0].Shapes;

  IConnector connector = shapes.AddConnector(ShapeType.BentConnector2, 0, 0, 10, 10);

  IAutoShape ellipse = shapes.AddAutoShape(ShapeType.Ellipse, 0, 100, 100, 100);

  IAutoShape rectangle = shapes.AddAutoShape(ShapeType.Rectangle, 100, 200, 100, 100);

  connector.StartShapeConnectedTo = ellipse;

  connector.EndShapeConnectedTo = rectangle;

  uint wantedIndex = 6;

  if (ellipse.ConnectionSiteCount > wantedIndex)

  {

    connector.StartShapeConnectionSiteIndex = wantedIndex;

  }

  input.Save("output.pptx", SaveFormat.Pptx);

}

Propriété ISmartArt.IsReversed a été ajoutée

La propriété Aspose.Slides.SmartArt.ISmartArt.IsReversed permet d’obtenir ou de définir l’orientation du diagramme SmartArt (de gauche à droite LTR ou de droite à gauche RTL), si le diagramme prend en charge l’inversion.


 using (Presentation pres = new Presentation())

{

  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicProcess);

  smart.IsReversed = true;

  pres.Save("out.pptx", Export.SaveFormat.Pptx);

}

Propriété ISmartArt.Nodes a été ajoutée

La propriété Aspose.Slides.SmartArt.ISmartArt.Nodes renvoie la collection des nœuds racine de l’objet SmartArt.


 using (Presentation pres = new Presentation())

{

  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.VerticalBulletList);

  ISmartArtNode node = smart.Nodes[1]; // sélectionner le deuxième nœud racine

  node.TextFrame.Text = "Second root node";

  pres.Save("out.pptx", Export.SaveFormat.Pptx);

}

Propriété ISmartArtNode.IsHidden a été ajoutée

La propriété Aspose.Slides.SmartArt.ISmartArtNode.IsHidden renvoie true si ce nœud est masqué dans le modèle de données.


 using (Presentation pres = new Presentation())

{

  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.RadialCycle);

  ISmartArtNode node = smart.AllNodes.AddNode();

  bool hidden = node.IsHidden; // renvoie true

  if(hidden)

  {

    // effectuer des actions ou notifications

  }

  pres.Save("out.pptx", Export.SaveFormat.Pptx);

}

Propriété ISmartArtNode.OrganizationChartLayout a été ajoutée

La propriété Aspose.Slides.SmartArt.ISmartArtNode.OrganizationChartLayout permet d’obtenir ou de définir le type d’organigramme associé au nœud actuel.


 using (Presentation pres = new Presentation())

{

  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.OrganizationChart);

  smart.Nodes[0].OrganizationChartLayout = OrganizationChartLayoutType.LeftHanging;

  pres.Save("out.pptx", Export.SaveFormat.Pptx);

}

Méthode set pour la propriété ISmartArt.Layout a été ajoutée

La méthode set pour la propriété Aspose.Slides.SmartArt.ISmartArt.Layout a été ajoutée. Elle permet de modifier le type de mise en page d’un diagramme existant.


 using (Presentation pres = new Presentation())

{

  ISmartArt smart = pres.Slides[0].Shapes.AddSmartArt(10, 10, 400, 300, SmartArtLayoutType.BasicBlockList);

  smart.Layout = SmartArtLayoutType.BasicProcess;

  pres.Save("out.pptx", Export.SaveFormat.Pptx);

}

Modifications mineures de l’API

Voici la liste des modifications mineures de l’API :

Enum Aspose.Slides.BevelColorMode supprimé, énumération inutilisée
Property ThreeDFormatEffectiveData.BevelColorMode supprimée, propriété inutilisée
Property Aspose.Slides.Charts.ChartSeriesGroup.Chart
Property Aspose.Slides.Charts.IChartSeriesGroup.AsIChartComponent
ajoutée
Property Aspose.Slides.IParagraphFormatEffectiveData.AsISlideComponent
Inheritance of IParagraphFormatEffectiveData from ISlideComponent
Property Aspose.Slides.IThreeDFormat.AsISlideComponent
Inheritance of IThreeDFormat from ISlideComponent
supprimée
Property Aspose.Slides.ParagraphFormatEffectiveData.BulletChar
Property Aspose.Slides.ParagraphFormatEffectiveData.BulletFont
Property Aspose.Slides.ParagraphFormatEffectiveData.BulletHeight
Property Aspose.Slides.ParagraphFormatEffectiveData.BulletType
Property Aspose.Slides.ParagraphFormatEffectiveData.NumberedBulletStartWith
Property Aspose.Slides.ParagraphFormatEffectiveData.NumberedBulletStyle
supprimée comme obsolète