API pública y cambios incompatibles hacia versiones anteriores en Aspose.Slides para .NET 14.5.0
API Pública y Cambios Incompatibles hacia Versiones Anteriores
Interfaces, Clases, Propiedades y Métodos Agregados
Se agregó la interfaz Aspose.Slides.IPresentationInfo y la clase PresentationInfo
Representa información sobre la presentación.
- La propiedad booleana IsEncrypted devuelve True si una presentación está encriptada, de lo contrario devuelve False.
- La propiedad LoadFormat obtiene el tipo de una presentación.
Se agregó la propiedad Aspose.Slides.IShape.IsGrouped
La propiedad Aspose.Slides.IShape.IsGrouped determina si una forma está agrupada.
Se agregó la propiedad Aspose.Slides.IShape.ParentGroup
La propiedad Aspose.Slides.IShape.ParentGroup devuelve el objeto GroupShape padre si una forma está agrupada. De lo contrario devuelve null.
Se agregó el método Aspose.Slides.IShapeCollection.AddGroupShape()
El método Aspose.Slides.IShapeCollection.AddGroupShape() crea un nuevo GroupShape y lo añade al final de la colección. El tamaño y la posición del marco del GroupShape se ajustarán al contenido cuando se añada una nueva forma.
Se agregó el método Aspose.Slides.IShapeCollection.Clear()
El método Aspose.Slides.IShapeCollection.Clear() elimina todas las formas de la colección.
Se agregó el método Aspose.Slides.IShapeCollection.InsertGroupShape(int)
El método Aspose.Slides.IShapeCollection.InsertGroupShape(int) crea un nuevo GroupShape y lo inserta en la colección en la posición de índice especificada. El tamaño y la posición del marco del GroupShape se ajustarán al contenido cuando se añada una nueva forma.
Se agregó los métodos IPresentationFactory.GetPresentationInfo(string file), IPresentatoinFactory.GetPresentationInfo(Stream stream)
Estos métodos permiten obtener información sobre un archivo o flujo de presentación sin cargar completamente la presentación.
Se agregó la propiedad IPresentationFactory PresentationFactory.Instance
Esta propiedad permite a los desarrolladores usar la funcionalidad de la fábrica sin instanciarla.
Restricciones
Restricciones a IShape.Frame
Se han añadido restricciones para el uso de valores indefinidos en IShape.Frame. El código que intenta asignar un marco indefinido a IShape.Frame no tiene sentido en la mayoría de los casos (particularmente cuando el GroupShape padre está anidado múltiples veces dentro de otros {{GroupShape}}s). Por ejemplo:
IShape shape = ...;
shape.Frame = new ShapeFrame(float.NaN, float.NaN, float.NaN, float.NaN, NullableBool.NotDefined, NullableBool.NotDefined, float.NaN);
or
slide.Shapes.AddAutoShape(ShapeType.RoundCornerRectangle, float.NaN, float.NaN, float.NaN, float.NaN);
Tal código puede conducir a situaciones poco claras. Por lo tanto, se han añadido restricciones para el uso de valores indefinidos en IShape.Frame. Los valores de x, y, width, height, flipH, flipV y rotationAngle deben estar definidos (y no establecerse en float.NaN o NullableBool.NotDefined). El código de ejemplo anterior ahora lanza una excepción ArgumentException. Esto se aplica a los siguientes casos de uso:
IShape shape = ...;
shape.Frame = ...; // No puede ser indefinido
IShapeCollection shapes = ...;
// Los parámetros x, y, width, height no pueden ser float.NaN:
{
shapes.AddAudioFrameCD(...);
shapes.AddAudioFrameEmbedded(...);
shapes.AddAudioFrameLinked(...);
shapes.AddAutoShape(...);
shapes.AddChart(...);
shapes.AddConnector(...);
shapes.AddOleObjectFrame(...);
shapes.AddPictureFrame(...);
shapes.AddSmartArt(...);
shapes.AddTable(...);
shapes.AddVideoFrame(...);
shapes.InsertAudioFrameEmbedded(...);
shapes.InsertAudioFrameLinked(...);
shapes.InsertAutoShape(...);
shapes.InsertChart(...);
shapes.InsertConnector(...);
shapes.InsertOleObjectFrame(...);
shapes.InsertPictureFrame(...);
shapes.InsertTable(...);
shapes.InsertVideoFrame(...);
}
Sin embargo, las propiedades del marco IShape.RawFrame pueden ser indefinidas. Esto tiene sentido cuando una forma está vinculada a un marcador de posición. Entonces, los valores indefinidos del marco de la forma se sobrescriben con los del marcador de posición padre. Si no hay marcador de posición padre, la forma utiliza valores predeterminados cuando evalúa el marco efectivo basado en su IShape.RawFrame. Los valores predeterminados son 0 y NullableBool.False para x, y, width, height, flipH, flipV y rotationAngle. Por ejemplo:
IShape shape = ...; // la forma está vinculada a un marcador de posición
shape.RawFrame = new ShapeFrame(float.NaN, float.NaN, 100, float.NaN, NullableBool.NotDefined, NullableBool.NotDefined, 0);
// ahora la forma hereda los valores x, y, height, flipH, flipV del marcador de posición y sobrescribe width=100 y rotationAngle=0.
Propiedades modificadas
Se cambió el nombre y tipo de la propiedad Aspose.Slides.IShapeCollection.Parent
- El tipo de la propiedad Aspose.Slides.IShapeCollection.Parent se ha cambiado de ISlideComponent a la nueva interfaz IGroupShape. La interfaz IGroupShape es descendiente de ISlideComponent, por lo que el código existente no necesita adaptaciones.
- El nombre de la propiedad Aspose.Slides.IShapeCollection.Parent se ha cambiado de Parent a ParentGroup.
Se cambiaron los tipos de las propiedades Aspose.Slides.IShapeFrame.FlipH y .FlipV
- El tipo de la propiedad Aspose.Slides.IShapeFrame.FlipH se ha cambiado de bool a NullableBool.
- La propiedad IShape.Frame devuelve una instancia efectiva de IShapeFrame (todas sus propiedades tienen valores efectivos definidos).
- La propiedad IShape.RawFrame devuelve una instancia de IShapeFrame cuya cada propiedad puede tener un valor indefinido (en particular FlipH o FlipV pueden tener el valor NullableBool.NotDefined).