Aspose.Slides for .NET 16.2.0 のパブリック API と後方互換性がない変更

パブリック API の変更

Properties UpdateDateTimeFields と UpdateSlideNumberFields が削除されました

Properties UpdateDateTimeFields と UpdateSlideNumberFields は Aspose.Slides.Presentation クラスおよび Aspose.Slides.IPresentation インターフェイスから削除されました。
Aspose.Slides.TextFrame、Paragraph、Portion クラスおよび Aspose.Slides.ITextFrame、IParagraph、IPortion インターフェイスの Text プロパティは、更新された “datetime” フィールドを含むテキストを返します。
また、Presentation.DocumentProperties.CreatedTime、LastSavedTime、LastPrinted プロパティは読み取り専用になりました。

Enum Slides.Charts.CategoryAxisType がパブリックに変更されました

IAxis.CategoryAxisType および Axis.CategoryAxisType プロパティでカテゴリ軸のタイプを決定するために使用されます。
CategoryAxisType.Auto - カテゴリ軸タイプはシリアライズ時に自動的に決定されます(この動作は現在実装されていません)
CategoryAxisType.Text - カテゴリ軸タイプは Text です
CategoryAxisType.Date - カテゴリ軸タイプは DateTime です

高速テキスト抽出

Presentation クラスに新しい静的メソッド GetPresentationText が追加されました。このメソッドには 2 つのオーバーロードがあります:

 PresentationText GetPresentationText(Stream stream)

PresentationText GetPresentationText(Stream stream, ExtractionMode mode)

ExtractionMode 列挙体の引数はテキスト結果の出力方式を示し、以下の値に設定できます。
Unarranged - スライド上の位置を考慮しない生テキスト
Arranged - テキストがスライド上の順序と同じ位置に配置されます

速度が重要な場合は Unarranged モードを使用できます。Arranged モードよりも高速です。

PresentationText はプレゼンテーションから抽出された生テキストを表します。Aspose.Slides.Util 名前空間の SlidesText プロパティを含み、ISlideText オブジェクトの配列を返します。各オブジェクトは対応するスライドのテキストを表します。ISlideText オブジェクトには以下のプロパティがあります。
ISlideText.Text - スライドのシェイプ上のテキスト
ISlideText.MasterText - このスライドのマスターページ上のシェイプのテキスト
ISlideText.LayoutText - このスライドのレイアウトページ上のシェイプのテキスト
ISlideText.NotesText - このスライドのノートページ上のシェイプのテキスト

また、ISlideText インターフェイスを実装する SlideText クラスもあります。

新しい API は以下のように使用できます。

 PresentationText text1 = Presentation.GetPresentationText("presentation.ppt");

Console.WriteLine(text1.SlidesText[0].Text);

Console.WriteLine(text1.SlidesText[0].LayoutText);

Console.WriteLine(text1.SlidesText[0].MasterText);

Console.WriteLine(text1.SlidesText[0].NotesText);

PresentationText text2 = Presentation.GetPresentationText("presentation.pptx", ExtractionMode.Unarranged)

ILegacyDiagram インターフェイスと LegacyDiagram クラスが追加されました

Aspose.Slides.ILegacyDiagram インターフェイスと Aspose.Slides.LegacyDiagram クラスが追加され、レガシーダイアグラムオブジェクトを表します。レガシーダイアグラムオブジェクトは PowerPoint 97-2003 の古い形式のダイアグラムです。
新しいクラスは、レガシーダイアグラムを最新の編集可能な SmartArt オブジェクトまたは編集可能な GroupShape に変換するメソッドを提供します。

新しい Aspose.Slides.TextAlignment 列挙メンバーが追加 (JustifyLow)

TextAlignment 列挙体に新しいメンバーが追加されました。
JustifyLow - カシダーによる低い均等揃え。

Aspose.Slides.IOleObjectFrame と OleObjectFrame の新しいプロパティ

IOleObjectFrame インターフェイスとこのインターフェイスを実装する OleObjectFrame クラスに新しいプロパティが追加されました。これらのプロパティは、プレゼンテーションに埋め込まれたオブジェクトに関する情報を提供します。
EmbeddedFileExtension - 現在の埋め込みオブジェクトのファイル拡張子を返します。リンクでない場合は空文字列です。
EmbeddedFileLabel - 埋め込み OLE オブジェクトのファイル名を返します。
EmbeddedFileName - 埋め込み OLE オブジェクトのパスを返します。

IAxis と Axis クラスに新しいプロパティ CategoryAxisType が追加されました

CategoryAxisType プロパティはカテゴリ軸のタイプを指定します。

 using (Presentation pres = new Presentation(sourcePptxFileName))
{
   IChart chart = pres.Slides[0].Shapes[0] as IChart;
   chart.Axes.HorizontalAxis.CategoryAxisType = CategoryAxisType.Date;
   chart.Axes.HorizontalAxis.IsAutomaticMajorUnit = false;
   chart.Axes.HorizontalAxis.MajorUnit = 1;
   chart.Axes.HorizontalAxis.MajorUnitScale = TimeUnitType.Months;
   pres.Save(pptxOutPath, SaveFormat.Pptx);
}

DataLabelFormat クラスと IDataLabelFormat インターフェイスに新しいプロパティ ShowLabelAsDataCallout が追加されました

ShowLabelAsDataCallout プロパティは、指定されたチャートのデータラベルをデータコールアウトとして表示するか、データラベルとして表示するかを決定します。

 using (Presentation pres = new Presentation())
{
   IChart chart = pres.Slides[0].Shapes.AddChart(ChartType.Pie, 50, 50, 500, 400);
   chart.ChartData.Series[0].Labels.DefaultDataLabelFormat.ShowValue = true;
   chart.ChartData.Series[0].Labels.DefaultDataLabelFormat.ShowLabelAsDataCallout = true;
   chart.ChartData.Series[0].Labels[2].DataLabelFormat.ShowLabelAsDataCallout = false;
   pres.Save(pptxFileName, SaveFormat.Pptx);
}

PdfOptions と XpsOptions に新しいプロパティ DrawSlidesFrame が追加されました

ブール型プロパティ DrawSlidesFrame がインターフェイス Aspose.Slides.Export.IPdfOptions、Aspose.Slides.Export.IXpsOptions および関連クラス Aspose.Slides.Export.PdfOptions、Aspose.Slides.Export.XpsOptions に追加されました。
このプロパティが true に設定されていると、各スライドの周囲に黒いフレームが描画されます。

 using (Presentation pres = new Presentation("input.pptx"))
{
    pres.Save("output.pdf", SaveFormat.Pdf, new PdfOptions() { DrawSlidesFrame = true });
}