Cambios de API pública e incompatibles hacia atrás en Aspose.Slides para .NET 14.4.0
API Pública y Cambios Incompatibles Retroactivos
Interfaces, Clases, Métodos y Propiedades Añadidos
Aspose.Slides.ILayoutSlide.HasDependingSlides Property Has Been Added
La propiedad Aspose.Slides.ILayoutSlide.HasDependingSlides devuelve true si existe al menos una diapositiva que depende de esta diapositiva de diseño. Por ejemplo:
ILayoutSlide layout = ...;
if (!layout.HasDependingSlides)
layout.Remove();
Aspose.Slides.ILayoutSlide.Remove() Method
El método Aspose.Slides.ILayoutSlide.Remove() le permite eliminar un diseño de una presentación con la mínima cantidad de código. Por ejemplo:
ILayoutSlide layout = ...;
if (!layout.HasDependingSlides)
layout.Remove();
Aspose.Slides.ILayoutSlideCollection.Remove(ILayoutSlide) Method
El método Aspose.Slides.ILayoutSlideCollection.Remove(ILayoutSlide) le permite eliminar un diseño de la colección. Ejemplos de código:
ILayoutSlide layout = ...;
if (!layout.HasDependingSlides)
presentation.LayoutSlides.Remove(layout);
o
IMasterSlide masterSlide = ...;
ILayoutSlide layout = ...;
if (!layout.HasDependingSlides)
masterSlide.LayoutSlides.Remove(layout);
Aspose.Slides.ILayoutSlideCollection.RemoveUnused()
El método Aspose.Slides.ILayoutSlideCollection.RemoveUnused() le permite eliminar los diseños de diapositiva no utilizados (diseños cuya propiedad HasDependingSlides es false). Ejemplos de código:
presentation.LayoutSlides.RemoveUnused();
o
IMasterSlide masterSlide = ...;
masterSlide.LayoutSlides.RemoveUnused();
Aspose.Slides.IMasterSlide.HasDependingSlides Property
La propiedad Aspose.Slides.IMasterSlide.HasDependingSlides devuelve true si existe al menos una diapositiva que depende de esta diapositiva maestra. Por ejemplo:
IMasterSlide masterSlide = ...;
if (!masterSlide.HasDependingSlides)
presentation.Masters.Remove(masterSlide);
Aspose.Slides.ISlide.Remove() Method
El método Aspose.Slides.ISlide.Remove() le permite eliminar una diapositiva de una presentación con la mínima cantidad de código. Por ejemplo:
ISlide slide = ...;
slide.Remove();
Aspose.Slides.SmartArt.ISmartArtNode.BulletFillFormat
La propiedad Aspose.Slides.SmartArt.ISmartArtNode.BulletFillFormat devuelve un IFillFormat para la viñeta de un nodo SmartArt si el diseño proporciona viñetas. Puede usarse para establecer la imagen de la viñeta.
Aspose.Slides.SmartArt.ISmartArtNode.Level Property
La propiedad Aspose.Slides.SmartArt.ISmartArtNode.Level devuelve el nivel anidado de los nodos SmartArt.
ISmartArtNode node = diagram.AllNodes[0];
if(node.Level == 1)
node.TextFrame.Text = "First level";
Aspose.Slides.SmartArt.ISmartArtNode.Position Property
La propiedad Aspose.Slides.SmartArt.ISmartArtNode.Position devuelve la posición de un nodo entre sus hermanos.
ISmartArtNode node = diagram.AllNodes[0];
if (node.ChildNodes.Count > 3)
node.ChildNodes[0].Position++;
Aspose.Slides.SmartArt.ISmartArtNode.Remove() Method Has Been Added
El método Aspose.Slides.SmartArt.ISmartArtNode.Remove() permite eliminar un nodo de un diagrama.
ISmartArt node = diagram.AllNodes[0];
node.Remove();
IGlobalLayoutSlideCollection Interface and GlobalLayoutSlideCollection Class
Se han añadido la interfaz IGlobalLayoutSlideCollection y la clase GlobalLayoutSlideCollection al espacio de nombres Aspose.Slides.
La clase GlobalLayoutSlideCollection implementa la interfaz IGlobalLayoutSlideCollection.
La interfaz IGlobalLayoutSlideCollection representa una colección de todas las diapositivas de diseño en una presentación. La propiedad IPresentation.LayoutSlides es del tipo IGlobalLayoutSlideCollection. IGlobalLayoutSlideCollection extiende la interfaz ILayoutSlideCollection con métodos para añadir y clonar diapositivas de diseño en el contexto de la unión de las colecciones individuales de diseños de los maestros:
- ILayoutSlide AddClone(ILayoutSlide sourceLayout); – Puede usarse para añadir una copia de un diseño especificado a la presentación. Este método conserva el formato de origen (al clonar un diseño entre presentaciones diferentes, también puede clonarse el maestro del diseño. El registro interno se usa para rastrear los maestros clonados automáticamente y evitar la creación de múltiples clones del mismo maestro).
- ILayoutSlide AddClone(ILayoutSlide sourceLayout, IMasterSlide destMaster); – Se usa para añadir una copia de un diseño especificado a una presentación. El nuevo diseño quedará vinculado al maestro definido en la presentación de destino. Esta opción es análoga a copiar o pegar con la opción Use Destination Theme en Microsoft PowerPoint.
- ILayoutSlide Add(IMasterSlide master, SlideLayoutType layoutType, string layoutName); – Se usa para añadir una nueva diapositiva de diseño a una presentación. Tipos de diseño admitidos: Title, TitleOnly, Blank, TitleAndObject, VerticalText, VerticalTitleAndText, TwoObjects, SectionHeader, TwoTextAndTwoObjects, TitleObjectAndCaption, PictureAndCaption, Custom. El nombre del diseño puede generarse automáticamente. Un diseño añadido del tipo SlideLayoutType.Custom no contiene marcadores de posición ni formas. Un análogo de este método es IMasterLayoutSlideCollection.Add(SlideLayoutType, string) accesible mediante la propiedad IMasterSlide.LayoutSlides.
Interface IMasterLayoutSlideCollection and Class MasterLayoutSlideCollection
Se han añadido la interfaz IMasterLayoutSlideCollection y la clase MasterLayoutSlideCollection al espacio de nombres Aspose.Slides. La clase MasterLayoutSlideCollection implementa la interfaz IMasterLayoutSlideCollection.
La interfaz IMasterLayoutSlideCollection representa una colección de todas las diapositivas de diseño de un maestro definido. Amplía la interfaz ILayoutSlideCollection con métodos para añadir, insertar, eliminar o clonar diseños en el contexto de las colecciones individuales de los diseños de un maestro:
// Firma del método:
ILayoutSlide AddClone(ILayoutSlide sourceLayout);
// Ejemplo de código que adjunta una copia del sourceLayout al destMasterSlide:
IMasterSlide destMasterSlide = ...;
destMasterSlide.LayoutSlides.AddClone(sourceLayout);
El método puede usarse para añadir una copia de un diseño especificado al final de la colección. El nuevo diseño quedará vinculado al maestro padre de esa colección de diseños. Por lo tanto, es análogo a copiar o pegar con la opción Use Destination Theme en PowerPoint. Un análogo de este método es IGlobalLayoutSlideCollection.AddClone(ILayoutSlide, IMasterSlide) accesible mediante la propiedad IPresentation.LayoutSlides.
- ILayoutSlide InsertClone(int index, ILayoutSlide sourceLayout); – Se usa para insertar una copia de un diseño especificado en la posición indicada de la colección. El nuevo diseño quedará vinculado al maestro padre de esa colección de diseños. Es análogo a copiar y pegar con la opción Use Destination Theme en PowerPoint.
- ILayoutSlide Add(SlideLayoutType layoutType, string layoutName);
- ILayoutSlide Insert(int index, SlideLayoutType layoutType, string layoutName); – Se usa para añadir o insertar una nueva diapositiva de diseño. Tipos de diseño admitidos: Title, TitleOnly, Blank, TitleAndObject, VerticalText, VerticalTitleAndText, TwoObjects, SectionHeader, TwoTextAndTwoObjects, TitleObjectAndCaption, PictureAndCaption, Custom. El nombre del diseño puede generarse automáticamente. Un diseño añadido del tipo SlideLayoutType.Custom no contiene marcadores de posición ni formas. Un análogo de este método es IGlobalLayoutSlideCollection.Add(IMasterSlide, SlideLayoutType, string) accesible mediante la propiedad IPresentation.LayoutSlides.
- void RemoveAt(int index); – Se usa para eliminar el diseño en el índice especificado de la colección.
- void Reorder(int index, ILayoutSlide layoutSlide); – Se usa para mover una diapositiva de diseño dentro de la colección a la posición indicada.
Changed Methods and Properties
Signature of the Aspose.Slides.ISlideCollection.AddClone(ISlide, IMasterSlide) Method
La firma del método ISlideCollection:
ISlide AddClone(ISlide sourceSlide, IMasterSlide destMaster);
está ahora obsoleta y se sustituye por la firma:
ISlide AddClone(ISlide sourceSlide, IMasterSlide destMaster, bool allowCloneMissingLayout)
El parámetro allowCloneMissingLayout especifica qué hacer si no existe un diseño apropiado en destMaster para la nueva diapositiva (clonada). El diseño apropiado es aquel con el mismo tipo o nombre que el diseño de la diapositiva de origen. Si no hay un diseño apropiado en el maestro especificado, el diseño de la diapositiva de origen se clonará (si allowCloneMissingLayout es true) o se lanzará una PptxEditException (si allowCloneMissingLayout es false).
Una llamada al método obsoleto como:
AddClone(sourceSlide, destMaster);
asume allowCloneMissingLayout igual a false (es decir, se lanzará PptxEditException si no hay un diseño apropiado). La llamada funcionalmente idéntica usando la nueva firma se ve así:
AddClone(sourceSlide, destMaster, false);
Si desea que los diseños faltantes se clonen automáticamente en lugar de lanzar PptxEditException, pase true al parámetro allowCloneMissingLayout.
Lo mismo aplica al método ISlideCollection:
ISlide InsertClone(int index, ISlide sourceSlide, IMasterSlide destMaster);
que también está obsoleto y se sustituye por la firma:
ISlide InsertClone(int index, ISlide sourceSlide, IMasterSlide destMaster, bool allowCloneMissingLayout);
Type of the Aspose.Slides.IMasterSlide.LayoutSlides Property
El tipo de la propiedad Aspose.Slides.IMasterSlide.LayoutSlides ha cambiado de ILayoutSlideCollection a la nueva interfaz IMasterLayoutSlideCollection. La interfaz IMasterLayoutSlideCollection es descendiente de ILayoutSlideCollection, por lo que el código existente no necesita adaptaciones.
Type of the Aspose.Slides.IPresentation.LayoutSlides Property Has Been Changed
El tipo de la propiedad Aspose.Slides.IPresentation.LayoutSlides ha cambiado de ILayoutSlideCollection a la nueva interfaz IGlobalLayoutSlideCollection. La interfaz IGlobalLayoutSlideCollection es descendiente de ILayoutSlideCollection, por lo que el código existente no necesita adaptaciones.