Cambios en la API pública y retrocompatibilidad incompatibles en Aspose.Slides para .NET 16.2.0
Cambios en la API pública
Propiedades UpdateDateTimeFields y UpdateSlideNumberFields han sido eliminadas
Las propiedades UpdateDateTimeFields y UpdateSlideNumberFields se han eliminado de la clase Aspose.Slides.Presentation y de la interfaz Aspose.Slides.IPresentation.
La propiedad Text de las clases Aspose.Slides.TextFrame, Paragraph, Portion y de las interfaces Aspose.Slides.ITextFrame, IParagraph, IPortion devuelve el texto con los campos “datetime” actualizados.
Además, las propiedades Presentation.DocumentProperties.CreatedTime, LastSavedTime y LastPrinted se volvieron de solo lectura.
Enum Slides.Charts.CategoryAxisType Ha Pasado a Público
Se usa en las propiedades IAxis.CategoryAxisType y Axis.CategoryAxisType para determinar el tipo de eje de categoría.
CategoryAxisType.Auto - el tipo de eje de categoría se determinará automáticamente durante la serialización (este comportamiento no está implementado todavía)
CategoryAxisType.Text - el tipo de eje de categoría es Texto
CategoryAxisType.Date - el tipo de eje de categoría es DateTime
Extracción Rápida de Texto
Se ha añadido el nuevo método estático GetPresentationText a la clase Presentation. Hay dos sobrecargas para este método:
PresentationText GetPresentationText(Stream stream)
PresentationText GetPresentationText(Stream stream, ExtractionMode mode)
El argumento enum ExtractionMode indica el modo de organización del resultado de texto y puede establecerse en los siguientes valores:
Unarranged - El texto bruto sin respetar la posición en la diapositiva
Arranged - El texto se posiciona en el mismo orden que en la diapositiva
El modo Unarranged puede usarse cuando la velocidad es crítica; es más rápido que el modo Arranged.
PresentationText representa el texto bruto extraído de la presentación. Contiene una propiedad SlidesText del espacio de nombres Aspose.Slides.Util que devuelve una matriz de objetos ISlideText. Cada objeto representa el texto en la diapositiva correspondiente. El objeto ISlideText tiene las siguientes propiedades:
ISlideText.Text - El texto en las formas de la diapositiva
ISlideText.MasterText - El texto en las formas de la diapositiva maestra para esta diapositiva
ISlideText.LayoutText - El texto en las formas de la diapositiva de diseño para esta diapositiva
ISlideText.NotesText - El texto en las formas de la página de notas para esta diapositiva
También hay una clase SlideText que implementa la interfaz ISlideText.
La nueva API puede usarse así:
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)
Se Ha Añadido la Interfaz ILegacyDiagram y la Clase LegacyDiagram
Se han añadido la interfaz Aspose.Slides.ILegacyDiagram y la clase Aspose.Slides.LegacyDiagram para representar objetos de diagrama heredados. El objeto de diagrama heredado es un formato antiguo de diagramas de PowerPoint 97-2003.
La nueva clase proporciona métodos para convertir diagramas heredados a objetos SmartArt editables modernos o a GroupShape editable.
Nuevo Miembro del Enum Aspose.Slides.TextAlignment Añadido (JustifyLow)
Se ha añadido un nuevo miembro del enum TextAlignment:
JustifyLow - Justificación Kashida baja.
Nuevas Propiedades para Aspose.Slides.IOleObjectFrame y OleObjectFrame
Se han añadido nuevas propiedades a la interfaz IOleObjectFrame y a la clase OleObjectFrame que implementa esta interfaz. Estas propiedades se utilizan para proporcionar información sobre un objeto incrustado en la presentación:
EmbeddedFileExtension - Devuelve la extensión de archivo del objeto incrustado actual o una cadena vacía si el objeto no es un vínculo
EmbeddedFileLabel - Devuelve el nombre de archivo del objeto OLE incrustado
EmbeddedFileName - Devuelve la ruta del objeto OLE incrustado
Se Ha Añadido la Propiedad CategoryAxisType a las Clases IAxis y Axis
La propiedad CategoryAxisType especifica el tipo de eje de categoría.
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);
}
Se Ha Añadido la Propiedad ShowLabelAsDataCallout a la Clase DataLabelFormat y a la Interfaz IDataLabelFormat
La propiedad ShowLabelAsDataCallout determina si la etiqueta de datos especificada del gráfico se mostrará como llamada de datos o como etiqueta de datos.
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);
}
Se Ha Añadido la Propiedad DrawSlidesFrame a PdfOptions y XpsOptions
La propiedad booleana DrawSlidesFrame se ha añadido a las interfaces Aspose.Slides.Export.IPdfOptions, Aspose.Slides.Export.IXpsOptions y a las clases relacionadas Aspose.Slides.Export.PdfOptions, Aspose.Slides.Export.XpsOptions.
El marco negro alrededor de cada diapositiva se dibujará si esta propiedad se establece en ‘true’.
using (Presentation pres = new Presentation("input.pptx"))
{
pres.Save("output.pdf", SaveFormat.Pdf, new PdfOptions() { DrawSlidesFrame = true });
}