Öffentliche API und rückwärtsinkompatible Änderungen in Aspose.Slides für .NET 16.2.0
Öffentliche API-Änderungen
Eigenschaften UpdateDateTimeFields und UpdateSlideNumberFields wurden entfernt
Die Eigenschaften UpdateDateTimeFields und UpdateSlideNumberFields wurden aus der Klasse Aspose.Slides.Presentation und aus dem Interface Aspose.Slides.IPresentation entfernt. Die Text‑Eigenschaft der Klassen Aspose.Slides.TextFrame, Paragraph, Portion sowie der Interfaces Aspose.Slides.ITextFrame, IParagraph, IPortion gibt Text mit aktualisierten „datetime“-Feldern zurück. Außerdem wurden die Eigenschaften Presentation.DocumentProperties.CreatedTime, LastSavedTime und LastPrinted schreibgeschützt.
Enum Slides.Charts.CategoryAxisType wurde öffentlich gemacht
Wird in den Eigenschaften IAxis.CategoryAxisType und Axis.CategoryAxisType verwendet, um den Typ der Kategorienachse zu bestimmen. CategoryAxisType.Auto - Der Typ der Kategorienachse wird bei der Serialisierung automatisch bestimmt (dieses Verhalten ist derzeit nicht implementiert) CategoryAxisType.Text - Der Typ der Kategorienachse ist Text CategoryAxisType.Date - Der Typ der Kategorienachse ist DateTime
Schnelle Textextraktion
Die neue statische Methode GetPresentationText wurde zur Klasse Presentation hinzugefügt. Es gibt zwei Überladungen für diese Methode:
PresentationText GetPresentationText(Stream stream)
PresentationText GetPresentationText(Stream stream, ExtractionMode mode)
Das Enum‑Argument ExtractionMode gibt den Modus zur Organisation der Textausgabe an und kann auf die folgenden Werte gesetzt werden: Unarranged - Der Rohtext ohne Berücksichtigung der Position auf der Folie Arranged - Der Text ist in derselben Reihenfolge wie auf der Folie positioniert
Der Modus Unarranged kann verwendet werden, wenn Geschwindigkeit entscheidend ist; er ist schneller als der Modus Arranged.
PresentationText stellt den aus der Präsentation extrahierten Rohtext dar. Es enthält eine SlidesText‑Eigenschaft aus dem Namespace Aspose.Slides.Util, die ein Array von ISlideText‑Objekten zurückgibt. Jedes Objekt repräsentiert den Text der jeweiligen Folie. ISlideText‑Objekte haben die folgenden Eigenschaften: ISlideText.Text - Der Text der Formen auf der Folie ISlideText.MasterText - Der Text der Formen auf der Masterseite für diese Folie ISlideText.LayoutText - Der Text der Formen auf der Layoutseite für diese Folie ISlideText.NotesText - Der Text der Formen auf der Notizenseite für diese Folie
Es gibt außerdem eine SlideText‑Klasse, die das ISlideText‑Interface implementiert.
Die neue API kann folgendermaßen verwendet werden:
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-Interface und LegacyDiagram-Klasse wurden hinzugefügt
Das Interface Aspose.Slides.ILegacyDiagram und die Klasse Aspose.Slides.LegacyDiagram wurden hinzugefügt, um ein Legacy-Diagrammobjekt zu repräsentieren. Ein Legacy-Diagrammobjekt ist ein altes Diagrammformat aus PowerPoint 97‑2003. Die neue Klasse stellt Methoden bereit, um das Legacy-Diagramm in ein modernes, bearbeitbares SmartArt‑Objekt oder in ein bearbeitbares GroupShape zu konvertieren.
Neues Aspose.Slides.TextAlignment‑Enum‑Mitglied hinzugefügt (JustifyLow)
Ein neues Mitglied des Enums TextAlignment wurde hinzugefügt: JustifyLow - Kashida‑Niedrig‑Justierung.
Neue Eigenschaften für Aspose.Slides.IOleObjectFrame und OleObjectFrame
Eine neue Eigenschaft wurde zum Interface IOleObjectFrame und zur Klasse OleObjectFrame, die dieses Interface implementiert, hinzugefügt. Diese Eigenschaften dienen dazu, Informationen über ein in die Präsentation eingebettetes Objekt bereitzustellen: EmbeddedFileExtension - Gibt die Dateierweiterung des aktuellen eingebetteten Objekts zurück oder einen leeren String, wenn das Objekt kein Link ist EmbeddedFileLabel - Gibt den Dateinamen des eingebetteten OLE‑Objekts zurück EmbeddedFileName - Gibt den Pfad des eingebetteten OLE‑Objekts zurück
Neue Eigenschaft CategoryAxisType wurde zu IAxis‑ und Axis‑Klassen hinzugefügt
Die Eigenschaft CategoryAxisType gibt den Typ der Kategorienachse an.
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);
}
Neue Eigenschaft ShowLabelAsDataCallout wurde zur DataLabelFormat‑Klasse und zum IDataLabelFormat‑Interface hinzugefügt
Die Eigenschaft ShowLabelAsDataCallout bestimmt, ob das Datenbeschriftungselement eines angegebenen Diagramms als Datenaufruf oder als Datenbeschriftung angezeigt wird.
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);
}
Eigenschaft DrawSlidesFrame wurde zu PdfOptions und XpsOptions hinzugefügt
Die boolesche Eigenschaft DrawSlidesFrame wurde zu den Interfaces Aspose.Slides.Export.IPdfOptions, Aspose.Slides.Export.IXpsOptions und zu den zugehörigen Klassen Aspose.Slides.Export.PdfOptions, Aspose.Slides.Export.XpsOptions hinzugefügt. Der schwarze Rahmen um jede Folie wird gezeichnet, wenn diese Eigenschaft auf „true“ gesetzt ist.
using (Presentation pres = new Presentation("input.pptx"))
{
pres.Save("output.pdf", SaveFormat.Pdf, new PdfOptions() { DrawSlidesFrame = true });
}