Управление OLE
Рассмотрим график, созданный в MS Excel. График затем размещается внутри слайда PowerPoint. Этот график Excel считается объектом OLE.
- Объект OLE может отображаться в виде значка. В этом случае, когда вы дважды щелкните по значку, график откроется в связанной программе (Excel) или вам будет предложено выбрать программу для открытия или редактирования объекта.
- Объект OLE может отображать фактическое содержимое, например, содержимое графика. В этом случае график активируется в PowerPoint, интерфейс графика загружается, и вы можете изменить данные графика в приложении PowerPoint.
Aspose.Slides для Android через Java позволяет вам вставлять объекты OLE в слайды в виде рамок объектов OLE (OleObjectFrame).
Добавление рамок объектов OLE в слайды
Предположим, что вы уже создали график в Microsoft Excel и хотите встроить этот график в слайд в виде рамки объекта OLE с помощью Aspose.Slides для Android через Java, вы можете сделать это следующим образом:
- Создайте экземпляр класса Presentation.
- Получите ссылку на слайд, используя его индекс.
- Откройте файл Excel, содержащий объект графика Excel, и сохраните его в
MemoryStream. - Добавьте OleObjectFrame на слайд, содержащий массив байтов и другую информацию об объекте OLE.
- Запишите измененную презентацию как файл PPTX.
В приведенном ниже примере мы добавили график из файла Excel в слайд в виде рамки объекта OLE с помощью Aspose.Slides для Android через Java. Примечание: конструктор IOleEmbeddedDataInfo принимает расширение встраиваемого объекта в качестве второго параметра. Это расширение позволяет PowerPoint правильно интерпретировать тип файла и выбрать правильное приложение для открытия этого объекта OLE.
// Создает экземпляр класса Presentation, который представляет файл PPTX
Presentation pres = new Presentation();
try {
// Получает доступ к первому слайду
ISlide sld = pres.getSlides().get_Item(0);
// Загружает файл Excel в поток
FileInputStream fs = new FileInputStream("book1.xlsx");
ByteArrayOutputStream mstream = new ByteArrayOutputStream();
byte[] buf = new byte[4096];
while (true)
{
int bytesRead = fs.read(buf, 0, buf.length);
if (bytesRead <= 0)
break;
mstream.write(buf, 0, bytesRead);
}
fs.close();
// Создает объект данных для встраивания
IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(mstream.toByteArray(), "xlsx");
mstream.close();
// Добавляет форму рамки объекта Ole
IOleObjectFrame oleObjectFrame = sld.getShapes().addOleObjectFrame(0, 0,
(float) pres.getSlideSize().getSize().getWidth(),
(float) pres.getSlideSize().getSize().getHeight(),
dataInfo);
// Записывает файл PPTX на диск
pres.save("OleEmbed_out.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}
Доступ к рамкам объектов OLE
Если объект OLE уже встроен в слайд, вы можете легко найти или получить доступ к этому объекту следующим образом:
-
Создайте экземпляр класса Presentation.
-
Получите ссылку на слайд, используя его индекс.
-
Получите доступ к форме рамки объекта OLE.
В нашем примере мы использовали ранее созданный PPTX, который имеет только одну форму на первом слайде. Затем мы привели этот объект к типу OleObjectFrame. Это была искомая рамка объекта OLE, к которой нужно получить доступ.
-
Как только рамка объекта OLE доступна, вы можете выполнять любые операции с ней.
В приведенном ниже примере доступ к рамке объекта OLE (встраиваемый объект графика Excel на слайде) осуществляется, а затем данные его файла записываются в файл Excel.
// Загружает PPTX в объект Presentation
Presentation pres = new Presentation("AccessingOLEObjectFrame.pptx");
try {
// Получает доступ к первому слайду
ISlide sld = pres.getSlides().get_Item(0);
// Приводит форму к OleObjectFrame
OleObjectFrame oleObjectFrame = (OleObjectFrame) sld.getShapes().get_Item(0);
// Читает объект OLE и записывает его на диск
if (oleObjectFrame != null) {
// Получает данные встроенного файла
byte[] data = oleObjectFrame.getEmbeddedData().getEmbeddedFileData();
// Получает расширение встроенного файла
String fileExtention = oleObjectFrame.getEmbeddedData().getEmbeddedFileExtension();
// Создает путь для сохранения извлеченного файла
String extractedPath = "excelFromOLE_out" + fileExtention;
// Сохраняет извлеченные данные
FileOutputStream fstr = new FileOutputStream(extractedPath);
try {
fstr.write(data, 0, data.length);
} finally {
fstr.close();
}
}
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}
Изменение данных объекта OLE
Если объект OLE уже встроен в слайд, вы можете легко получить доступ к этому объекту и изменить его данные следующим образом:
-
Откройте нужную презентацию с встроенным объектом OLE, создав экземпляр класса Presentation.
-
Получите ссылку на слайд через его индекс.
-
Получите доступ к форме рамки объекта OLE.
В нашем примере мы использовали ранее созданный PPTX, который имеет только одну форму на первом слайде. Затем мы привели этот объект к типу OleObjectFrame. Это была искомая рамка объекта OLE, к которой нужно получить доступ.
-
Как только рамка объекта OLE доступна, вы можете выполнять любые операции с ней.
-
Создайте объект Workbook и получите доступ к данным OLE.
-
Получите доступ к нужному Worksheet и измените данные.
-
Сохраните обновленный Workbook в потоках.
-
Измените данные объекта OLE с данных потока.
В приведенном ниже примере доступ к рамке объекта OLE (встраиваемый объект графика Excel на слайде) осуществляется, а затем данные его файла изменяются для изменения данных графика:
Presentation pres = new Presentation("ChangeOLEObjectData.pptx");
try {
ISlide slide = pres.getSlides().get_Item(0);
OleObjectFrame ole = null;
// Обходит все формы в поисках рамки Ole
for (IShape shape : slide.getShapes())
{
if (shape instanceof OleObjectFrame)
{
ole = (OleObjectFrame) shape;
}
}
if (ole != null) {
ByteArrayInputStream msln = new ByteArrayInputStream(ole.getEmbeddedData().getEmbeddedFileData());
try {
// Читает данные объекта в Workbook
Workbook Wb = new Workbook(msln);
ByteArrayOutputStream msout = new ByteArrayOutputStream();
try {
// Изменяет данные workbook
Wb.getWorksheets().get(0).getCells().get(0, 4).putValue("E");
Wb.getWorksheets().get(0).getCells().get(1, 4).putValue(12);
Wb.getWorksheets().get(0).getCells().get(2, 4).putValue(14);
Wb.getWorksheets().get(0).getCells().get(3, 4).putValue(15);
OoxmlSaveOptions so1 = new OoxmlSaveOptions(com.aspose.cells.SaveFormat.XLSX);
Wb.save(msout, so1);
// Изменяет данные объекта Ole frame
IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(msout.toByteArray(), ole.getEmbeddedData().getEmbeddedFileExtension());
ole.setEmbeddedData(newData);
} finally {
if (msout != null) msout.close();
}
} finally {
if (msln != null) msln.close();
}
}
pres.save("OleEdit_out.pptx", SaveFormat.Pptx);
} catch (Exception e) {
} finally {
if (pres != null) pres.dispose();
}
Встраивание других типов файлов в слайды
Помимо графиков Excel, Aspose.Slides для Android через Java позволяет вам встраивать другие типы файлов в слайды. Например, вы можете вставлять файлы HTML, PDF и ZIP в качестве объектов в слайд. Когда пользователь дважды щелкает по вставленному объекту, объект автоматически запускается в соответствующей программе, или пользователю предлагается выбрать подходящую программу для открытия объекта.
Этот код на Java показывает, как встроить HTML и ZIP в слайд:
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
byte[] htmlBytes = Files.readAllBytes(Paths.get("embedOle.html"));
IOleEmbeddedDataInfo dataInfoHtml = new OleEmbeddedDataInfo(htmlBytes, "html");
IOleObjectFrame oleFrameHtml = slide.getShapes().addOleObjectFrame(150, 120, 50, 50, dataInfoHtml);
oleFrameHtml.setObjectIcon(true);
byte[] zipBytes = Files.readAllBytes(Paths.get("embedOle.zip"));
IOleEmbeddedDataInfo dataInfoZip = new OleEmbeddedDataInfo(zipBytes, "zip");
IOleObjectFrame oleFrameZip = slide.getShapes().addOleObjectFrame(150, 220, 50, 50, dataInfoZip);
oleFrameZip.setObjectIcon(true);
pres.save("embeddedOle.pptx", SaveFormat.Pptx);
} catch (Exception e) {
} finally {
if (pres != null) pres.dispose();
}
Установка типов файлов для встроенных объектов
При работе с презентациями вам может понадобиться заменить старые объекты OLE новыми. Либо вам может понадобиться заменить неподдерживаемый объект OLE на поддерживаемый.
Aspose.Slides для Android через Java позволяет вам установить тип файла для встроенного объекта. Таким образом, вы можете изменить данные рамки OLE или ее расширение.
Этот Java показывает вам, как установить тип файла для встроенного объекта OLE:
Presentation pres = new Presentation("embeddedOle.pptx");
try {
ISlide slide = pres.getSlides().get_Item(0);
IOleObjectFrame oleObjectFrame = (IOleObjectFrame)slide.getShapes().get_Item(0);
System.out.println("Текущее расширение встроенных данных: " + oleObjectFrame.getEmbeddedData().getEmbeddedFileExtension());
oleObjectFrame.setEmbeddedData(new OleEmbeddedDataInfo(Files.readAllBytes(Paths.get("embedOle.zip")), "zip"));
pres.save("embeddedChanged.pptx", SaveFormat.Pptx);
} catch (Exception e) {
} finally {
if (pres != null) pres.dispose();
}
Установка изображений значков и заголовков для встроенных объектов
После встраивания объекта OLE автоматически добавляется предварительный просмотр, состоящий из изображения значка и заголовка. Предварительный просмотр — это то, что пользователи видят перед тем, как получить доступ или открыть объект OLE.
Если вы хотите использовать конкретное изображение и текст в качестве элементов в предварительном просмотре, вы можете установить изображение значка и заголовок с помощью Aspose.Slides для Android через Java.
Этот код на Java показывает, как установить изображение значка и заголовок для встроенного объекта:
Presentation pres = new Presentation();
try {
ISlide slide = pres.getSlides().get_Item(0);
IOleObjectFrame oleObjectFrame = (IOleObjectFrame) slide.getShapes().get_Item(0);
IPPImage oleImage;
IImage image = Images.fromFile("image.png");
try {
oleImage = pres.getImages().addImage(image);
} finally {
if (image != null) image.dispose();
}
oleObjectFrame.setSubstitutePictureTitle("Мой заголовок");
oleObjectFrame.getSubstitutePictureFormat().getPicture().setImage(oleImage);
oleObjectFrame.setObjectIcon(false);
pres.save("embeddedOle-newImage.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}
Извлечение встроенных файлов
Aspose.Slides для Android через Java позволяет вам извлекать файлы, встроенные в слайды в виде объектов OLE, следующим образом:
- Создайте экземпляр класса Presentation, содержащего объект OLE, который вы собираетесь извлечь.
- Обходите все формы в презентации и получите доступ к форме OLEObjectFrame.
- Получите доступ к данным встроенного файла из рамки объекта OLE и запишите их на диск.
Этот код на Java показывает, как извлечь файл, встроенный в слайд в виде объекта OLE:
Presentation pres = new Presentation("embeddedOle.pptx");
try {
ISlide slide = pres.getSlides().get_Item(0);
for (int index = 0; index < slide.getShapes().size(); index++)
{
IShape shape = slide.getShapes().get_Item(index);
IOleObjectFrame oleFrame = (IOleObjectFrame)shape;
if (oleFrame != null)
{
byte[] data = oleFrame.getEmbeddedData().getEmbeddedFileData();
String extension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();
// Сохранить извлеченные данные
FileOutputStream fstr = new FileOutputStream("oleFrame" + index + extension);
try {
fstr.write(data, 0, data.length);
} finally {
fstr.close();
}
}
}
} catch (IOException e) {
} finally {
if (pres != null) pres.dispose();
}