Administrar objetos OLE en presentaciones en .NET
Introducción
Note
OLE (Object Linking & Embedding) es una tecnología de Microsoft que permite que datos y objetos creados en una aplicación se coloquen en otra aplicación mediante enlace o incrustación.Considere un gráfico creado en MS Excel. El gráfico se coloca luego dentro de una diapositiva de PowerPoint. Ese gráfico de Excel se considera un objeto OLE.
- Un objeto OLE puede aparecer como un ícono. En este caso, al hacer doble clic en el ícono, el gráfico se abre en su aplicación asociada (Excel), o se le solicita seleccionar una aplicación para abrir o editar el objeto.
- Un objeto OLE puede mostrar su contenido real, como el contenido de un gráfico. En este caso, el gráfico se activa en PowerPoint, se carga la interfaz del gráfico y puede modificar los datos del gráfico dentro de PowerPoint.
Aspose.Slides for .NET permite insertar objetos OLE en diapositivas como marcos de objetos OLE (OleObjectFrame).
Agregar marcos de objetos OLE a diapositivas
Suponiendo que ya haya creado un gráfico en Microsoft Excel y desee incrustarlo en una diapositiva como un marco de objeto OLE mediante Aspose.Slides for .NET, puede hacerlo de la siguiente manera:
- Crear una instancia de la clase Presentation.
- Obtener la referencia de una diapositiva mediante su índice.
- Leer el archivo Excel como una matriz de bytes.
- Añadir el OleObjectFrame a la diapositiva que contiene la matriz de bytes y otra información sobre el objeto OLE.
- Guardar la presentación modificada como un archivo PPTX.
En el ejemplo a continuación, añadimos un gráfico de un archivo Excel a una diapositiva como un OleObjectFrame usando Aspose.Slides for .NET.
Nota que el constructor de OleEmbeddedDataInfo recibe como segundo parámetro una extensión de objeto incrustable. Esta extensión permite a PowerPoint interpretar correctamente el tipo de archivo y elegir la aplicación adecuada para abrir este objeto OLE.
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation())
{
SizeF slideSize = presentation.SlideSize.Size;
ISlide slide = presentation.Slides[0];
// Preparar datos para el objeto OLE.
byte[] fileData = File.ReadAllBytes("book.xlsx");
IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(fileData, "xlsx");
// Añadir el marco de objeto OLE a la diapositiva.
slide.Shapes.AddOleObjectFrame(0, 0, slideSize.Width, slideSize.Height, dataInfo);
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Agregar marcos de objetos OLE vinculados
Aspose.Slides for .NET permite añadir un OleObjectFrame sin incrustar datos, sino únicamente con un enlace al archivo.
Este código C# muestra cómo añadir un OleObjectFrame con un archivo Excel vinculado a una diapositiva:
using Aspose.Slides;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Añadir un marco de objeto OLE con un archivo Excel vinculado.
slide.Shapes.AddOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Acceder a marcos de objetos OLE
Si un objeto OLE ya está incrustado en una diapositiva, puede encontrarlo o acceder a él fácilmente de esta forma:
- Cargar una presentación con el objeto OLE incrustado creando una instancia de la clase Presentation.
- Obtener la referencia de la diapositiva mediante su índice.
- Acceder a la forma OleObjectFrame. En nuestro ejemplo usamos el PPTX creado previamente que tiene una sola forma en la primera diapositiva. Luego convertimos ese objeto a un IOleObjectFrame. Este era el marco de objeto OLE deseado para acceder.
- Una vez que se accede al marco de objeto OLE, puede realizar cualquier operación sobre él.
En el ejemplo a continuación, se accede a un marco de objeto OLE (un objeto de gráfico de Excel incrustado en una diapositiva) y a sus datos de archivo.
using Aspose.Slides;
using (Presentation presentation = new Presentation("sample.pptx"))
{
ISlide slide = presentation.Slides[0];
// Obtener la primera forma como un marco de objeto OLE.
IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;
if (oleFrame != null)
{
// Obtener los datos del archivo incrustado.
byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;
// Obtener la extensión del archivo incrustado.
string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;
// ...
}
}
Acceder a propiedades del marco de objeto OLE vinculado
Aspose.Slides permite acceder a las propiedades de los marcos de objetos OLE vinculados.
Este código C# muestra cómo comprobar si un objeto OLE está vinculado y, a continuación, obtener la ruta al archivo vinculado:
using Aspose.Slides;
using (Presentation presentation = new Presentation("sample.ppt"))
{
ISlide slide = presentation.Slides[0];
// Obtener la primera forma como un marco de objeto OLE.
IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;
// Comprobar si el objeto OLE está vinculado.
if (oleFrame != null && oleFrame.IsObjectLink)
{
// Imprimir la ruta completa al archivo vinculado.
Console.WriteLine("OLE object frame is linked to: " + oleFrame.LinkPathLong);
// Imprimir la ruta relativa al archivo vinculado si está presente.
// Solo las presentaciones PPT pueden contener la ruta relativa.
if (!string.IsNullOrEmpty(oleFrame.LinkPathRelative))
{
Console.WriteLine("OLE object frame relative path: " + oleFrame.LinkPathRelative);
}
}
}
Cambiar datos de objeto OLE
Note
En esta sección, el ejemplo de código a continuación utiliza Aspose.Cells for .NET.Si un objeto OLE ya está incrustado en una diapositiva, puede acceder a ese objeto y modificar sus datos de la siguiente manera:
- Cargar una presentación con el objeto OLE incrustado creando una instancia de la clase Presentation.
- Obtener la referencia de la diapositiva mediante su índice.
- Acceder a la forma OLEObjectFrame. En nuestro ejemplo usamos el PPTX creado previamente que tiene una forma en la primera diapositiva. Luego convertimos ese objeto a un IOleObjectFrame. Este era el marco de objeto OLE deseado para acceder.
- Una vez que se accede al marco de objeto OLE, puede realizar cualquier operación sobre él.
- Crear un objeto
Workbooky acceder a los datos OLE. - Acceder a la
Worksheetdeseada y modificar los datos. - Guardar el
Workbookactualizado en un flujo. - Cambiar los datos del objeto OLE a partir del flujo.
En el ejemplo a continuación, se accede a un marco de objeto OLE (un objeto de gráfico de Excel incrustado en una diapositiva) y se modifican sus datos de archivo para actualizar los datos del gráfico.
using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation("sample.pptx"))
{
ISlide slide = presentation.Slides[0];
// Obtener la primera forma como un marco de objeto OLE.
IOleObjectFrame oleFrame = slide.Shapes[0] as IOleObjectFrame;
if (oleFrame != null)
{
using (MemoryStream oleStream = new MemoryStream(oleFrame.EmbeddedData.EmbeddedFileData))
{
// Leer los datos del objeto OLE como un objeto Workbook.
Aspose.Cells.Workbook workbook = new Aspose.Cells.Workbook(oleStream);
using (MemoryStream newOleStream = new MemoryStream())
{
// Modificar los datos del workbook.
workbook.Worksheets[0].Cells[0, 4].PutValue("E");
workbook.Worksheets[0].Cells[1, 4].PutValue(12);
workbook.Worksheets[0].Cells[2, 4].PutValue(14);
workbook.Worksheets[0].Cells[3, 4].PutValue(15);
Aspose.Cells.OoxmlSaveOptions fileOptions = new Aspose.Cells.OoxmlSaveOptions(Aspose.Cells.SaveFormat.Xlsx);
workbook.Save(newOleStream, fileOptions);
// Cambiar los datos del objeto del marco OLE.
IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(newOleStream.ToArray(), oleFrame.EmbeddedData.EmbeddedFileExtension);
oleFrame.SetEmbeddedData(newData);
}
}
}
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Incrustar otros tipos de archivo en diapositivas
Además de los gráficos de Excel, Aspose.Slides for .NET permite incrustar otros tipos de archivos en diapositivas. Por ejemplo, puede insertar archivos HTML, PDF y ZIP como objetos. Cuando el usuario hace doble clic en el objeto insertado, se abre automáticamente en el programa correspondiente, o se le solicita seleccionar un programa adecuado para abrirlo.
Este código C# muestra cómo incrustar HTML y ZIP en una diapositiva:
using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
byte[] htmlData = File.ReadAllBytes("sample.html");
IOleEmbeddedDataInfo htmlDataInfo = new OleEmbeddedDataInfo(htmlData, "html");
IOleObjectFrame htmlOleFrame = slide.Shapes.AddOleObjectFrame(150, 120, 50, 50, htmlDataInfo);
htmlOleFrame.IsObjectIcon = true;
byte[] zipData = File.ReadAllBytes("sample.zip");
IOleEmbeddedDataInfo zipDataInfo = new OleEmbeddedDataInfo(zipData, "zip");
IOleObjectFrame zipOleFrame = slide.Shapes.AddOleObjectFrame(150, 220, 50, 50, zipDataInfo);
zipOleFrame.IsObjectIcon = true;
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Establecer tipos de archivo para objetos incrustados
Al trabajar con presentaciones, puede ser necesario reemplazar objetos OLE antiguos por otros nuevos o sustituir un objeto OLE no compatible por uno compatible. Aspose.Slides for .NET permite establecer el tipo de archivo para un objeto incrustado, lo que le permite actualizar los datos del marco OLE o su extensión.
Este código C# muestra cómo establecer el tipo de archivo para un objeto OLE incrustado a zip:
using Aspose.Slides;
using Aspose.Slides.DOM.Ole;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation("sample.pptx"))
{
ISlide slide = presentation.Slides[0];
IOleObjectFrame oleFrame = (IOleObjectFrame)slide.Shapes[0];
string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;
byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;
Console.WriteLine($"Current embedded file extension is: {fileExtension}");
// Cambiar el tipo de archivo a ZIP.
oleFrame.SetEmbeddedData(new OleEmbeddedDataInfo(fileData, "zip"));
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Establecer imágenes de icono y títulos para objetos incrustados
Tras incrustar un objeto OLE, se añade automáticamente una vista previa que consiste en una imagen de icono. Esta vista previa es lo que los usuarios ven antes de acceder o abrir el objeto OLE. Si desea usar una imagen y un texto específicos como elementos de la vista previa, puede establecer la imagen de icono y el título mediante Aspose.Slides for .NET.
Este código C# muestra cómo establecer la imagen de icono y el título para un objeto incrustado:
using Aspose.Slides;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation("sample.pptx"))
{
ISlide slide = presentation.Slides[0];
IOleObjectFrame oleFrame = (IOleObjectFrame)slide.Shapes[0];
// Añadir una imagen a los recursos de la presentación.
byte[] imageData = File.ReadAllBytes("image.png");
IPPImage oleImage = presentation.Images.AddImage(imageData);
// Establecer un título y la imagen para la vista previa OLE.
oleFrame.SubstitutePictureTitle = "My title";
oleFrame.SubstitutePictureFormat.Picture.Image = oleImage;
oleFrame.IsObjectIcon = true;
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Prevenir que un marco de objeto OLE sea redimensionado y reposicionado
Después de añadir un objeto OLE vinculado a una diapositiva de presentación, al abrir la presentación en PowerPoint puede aparecer un mensaje que le pide actualizar los enlaces. Al pulsar el botón “Update Links” el tamaño y la posición del marco de objeto OLE pueden cambiar porque PowerPoint actualiza los datos del objeto OLE vinculado y refresca la vista previa del objeto. Para evitar que PowerPoint solicite actualizar los datos del objeto, establezca la propiedad UpdateAutomatic de la interfaz IOleObjectFrame a false:
using Aspose.Slides;
using Aspose.Slides.Export;
using (Presentation presentation = new Presentation("sample.pptx"))
{
IOleObjectFrame oleFrame = (IOleObjectFrame)presentation.Slides[0].Shapes[0];
// Conservar el tamaño y la posición del marco de objeto OLE cuando PowerPoint actualiza el enlace.
oleFrame.UpdateAutomatic = false;
presentation.Save("output.pptx", SaveFormat.Pptx);
}
Extraer archivos incrustados
Aspose.Slides for .NET permite extraer los archivos incrustados en diapositivas como objetos OLE de la siguiente manera:
- Crear una instancia de la clase Presentation que contenga los objetos OLE que desea extraer.
- Recorrer todas las formas de la presentación y acceder a las formas OLEObjectFrame.
- Acceder a los datos de los archivos incrustados desde los marcos de objetos OLE y escribirlos en disco.
Este código C# muestra cómo extraer los archivos incrustados en una diapositiva como objetos OLE:
using Aspose.Slides;
using (Presentation presentation = new Presentation("sample.pptx"))
{
ISlide slide = presentation.Slides[0];
for (int index = 0; index < slide.Shapes.Count; index++)
{
IShape shape = slide.Shapes[index];
IOleObjectFrame oleFrame = shape as IOleObjectFrame;
if (oleFrame != null)
{
byte[] fileData = oleFrame.EmbeddedData.EmbeddedFileData;
string fileExtension = oleFrame.EmbeddedData.EmbeddedFileExtension;
string filePath = $"OLE_object_{index}{fileExtension}";
File.WriteAllBytes(filePath, fileData);
}
}
}
Preguntas frecuentes
¿Se renderizará el contenido OLE al exportar diapositivas a PDF/imagenes?
Lo que se muestra en la diapositiva se renderiza: el ícono/imagen de sustitución (vista previa). El contenido OLE “en vivo” no se ejecuta durante el renderizado. Si es necesario, establezca su propia imagen de vista previa para garantizar la apariencia esperada en el PDF exportado.
Para también conservar el archivo incrustado como un adjunto PDF, establezca PdfOptions.IncludeOleData a true. Esta opción está desactivada por defecto. Para un ejemplo e instrucciones sobre cómo comprobar el adjunto, vea Conservar archivos OLE incrustados como adjuntos PDF.
¿Cómo puedo bloquear un objeto OLE en una diapositiva para que los usuarios no puedan moverlo o editarlo en PowerPoint?
Bloquee la forma: Aspose.Slides proporciona bloqueos a nivel de forma. No es un cifrado, pero evita eficazmente ediciones y movimientos accidentales.
¿Por qué un objeto Excel vinculado “salta” o cambia de tamaño al abrir la presentación?
PowerPoint puede refrescar la vista previa del OLE vinculado. Para obtener una apariencia estable, siga las prácticas de la Solución práctica para el redimensionado de hojas de cálculo: ajuste el marco al rango o escale el rango a un marco fijo y establezca una imagen de sustitución adecuada.
¿Se preservarán las rutas relativas de los objetos OLE vinculados en el formato PPTX?
En PPTX la información de “ruta relativa” no está disponible, solo la ruta completa. Las rutas relativas aparecen en el formato PPT más antiguo. Para portabilidad, prefiera rutas absolutas fiables/URIs accesibles o la incrustación.