Управление OLE в презентациях на Android

OLE (Object Linking & Embedding) — технология Microsoft, позволяющая размещать данные и объекты, созданные в одном приложении, в другом приложении с помощью связывания или внедрения.

Рассмотрим диаграмму, созданную в MS Excel. Диаграмма помещается в слайд PowerPoint. Такая диаграмма Excel считается OLE‑объектом.

OLE‑объект может отображаться в виде значка. В этом случае, при двойном щелчке по значку, диаграмма открывается в связанном приложении (Excel), либо вам предлагается выбрать приложение для открытия или редактирования объекта.
OLE‑объект может показывать своё реальное содержимое, например содержимое диаграммы. В этом случае диаграмма активируется в PowerPoint, загружается её интерфейс, и вы можете изменять данные диаграммы непосредственно в PowerPoint.

Aspose.Slides for Android via Java позволяет вставлять OLE‑объекты в слайды в виде OLE‑кадров объектов (OleObjectFrame).

Добавление OLE‑кадров объектов на слайды

Предположим, вы уже создали диаграмму в Microsoft Excel и хотите внедрить её в слайд как OLE‑кадр объекта, используя Aspose.Slides for Android via Java. Это можно сделать следующим образом:

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Прочитайте файл Excel как массив байтов.
Добавьте OleObjectFrame на слайд, передав массив байтов и другую информацию об OLE‑объекте.
Запишите изменённую презентацию в файл PPTX.

В примере ниже мы добавили диаграмму из файла Excel на слайд как OLE‑кадр объекта, используя Aspose.Slides for Android via Java. Примечание что конструктор OleEmbeddedDataInfo принимает расширение встраиваемого объекта вторым параметром. Это расширение позволяет PowerPoint правильно определить тип файла и выбрать подходящее приложение для открытия данного OLE‑объекта.

Presentation presentation = new Presentation();
SizeF slideSize = presentation.getSlideSize().getSize();
ISlide slide = presentation.getSlides().get_Item(0);

// Подготовьте данные для OLE‑объекта.
File file = new File("book.xlsx");
byte fileData[] = new byte[(int) file.length()];
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file));
DataInputStream dis = new DataInputStream(bis);
dis.readFully(fileData);

IOleEmbeddedDataInfo dataInfo = new OleEmbeddedDataInfo(fileData, "xlsx");

// Добавьте OLE‑кадр объекта на слайд.
slide.getShapes().addOleObjectFrame(0, 0, slideSize.getWidth(), slideSize.getHeight(), dataInfo);

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

Добавление связанных OLE‑кадров объектов

Aspose.Slides for Android via Java позволяет добавить OleObjectFrame без встраивания данных, а только со ссылкой на файл.

Этот Java‑код показывает, как добавить OleObjectFrame со связанным файлом Excel на слайд:

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

// Add an OLE object frame with a linked Excel file.
slide.getShapes().addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx");

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

Доступ к OLE‑кадрам объектов

Если OLE‑объект уже внедрён в слайд, его можно легко найти или получить доступ следующим образом:

Загрузите презентацию с внедрённым OLE‑объектом, создав экземпляр класса Presentation.
Получите ссылку на слайд, используя его индекс.
Получите форму OleObjectFrame. В нашем примере мы использовали ранее созданный PPTX, в котором на первом слайде находится только одна форма. Затем мы привели этот объект к типу IOleObjectFrame. Это был нужный OLE‑кадр объекта для доступа.
После получения доступа к OLE‑кадру объекта вы можете выполнить любую операцию с ним.

В примере ниже доступ к OLE‑кадру объекта (внедрённому объекту диаграммы Excel на слайде) и к его файловым данным получен.

Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);

if (shape instanceof IOleObjectFrame) {
    IOleObjectFrame oleFrame = (IOleObjectFrame) shape;
    
    // Получить данные вложенного файла.
    byte[] fileData = oleFrame.getEmbeddedData().getEmbeddedFileData();

    // Получить расширение вложенного файла.
    String fileExtension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();

    // ...
}

Доступ к свойствам связанных OLE‑кадров объектов

Aspose.Slides позволяет получать свойства связанных OLE‑кадров объектов.

Этот Java‑код показывает, как проверить, связан ли OLE‑объект, и затем получить путь к связанному файлу:

Presentation presentation = new Presentation("sample.ppt");
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);

if (shape instanceof IOleObjectFrame) {
    IOleObjectFrame oleFrame = (IOleObjectFrame) shape;

    // Проверить, связан ли OLE объект.
    if (oleFrame.isObjectLink()) {
        // Вывести полный путь к связанному файлу.
        System.out.println("OLE object frame is linked to: " + oleFrame.getLinkPathLong());

        // Вывести относительный путь к связанному файлу, если он присутствует.
        // Только презентации PPT могут содержать относительный путь.
        if (oleFrame.getLinkPathRelative() != null && !oleFrame.getLinkPathRelative().isEmpty()) {
            System.out.println("OLE object frame relative path: " + oleFrame.getLinkPathRelative());
        }
    }
}

presentation.dispose();

Изменение данных OLE‑объекта

В этом разделе пример кода использует Aspose.Cells for Android via Java.

Если OLE‑объект уже внедрён в слайд, его можно легко получить и изменить его данные следующим образом:

Загрузите презентацию с внедрённым OLE‑объектом, создав экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Получите форму OLE‑кадра объекта. В нашем примере мы использовали ранее созданный PPTX, в котором на первом слайде одна форма. Затем мы привели этот объект к типу IOleObjectFrame. Это был нужный OLE‑кадр объекта для доступа.
После получения доступа к OLE‑кадру объекта вы можете выполнить любую операцию с ним.
Создайте объект Workbook и получите доступ к OLE‑данным.
Получите нужный Worksheet и измените данные.
Сохраните обновлённый Workbook в поток.
Обновите данные OLE‑объекта из потока.

В примере ниже OLE‑кадр объекта (внедрённый объект диаграммы Excel на слайде) получен, и его файловые данные изменены для обновления данных диаграммы.

Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IShape shape = slide.getShapes().get_Item(0);

if (shape instanceof IOleObjectFrame) {
    IOleObjectFrame oleFrame = (IOleObjectFrame) shape;

    ByteArrayInputStream oleStream = new ByteArrayInputStream(oleFrame.getEmbeddedData().getEmbeddedFileData());

    // Прочитать данные OLE‑объекта как объект Workbook.
    Workbook workbook = new Workbook(oleStream);

    ByteArrayOutputStream newOleStream = new ByteArrayOutputStream();

    // Изменить данные workbook.
    workbook.getWorksheets().get(0).getCells().get(0, 4).putValue("E");
    workbook.getWorksheets().get(0).getCells().get(1, 4).putValue(12);
    workbook.getWorksheets().get(0).getCells().get(2, 4).putValue(14);
    workbook.getWorksheets().get(0).getCells().get(3, 4).putValue(15);

    OoxmlSaveOptions fileOptions = new OoxmlSaveOptions(com.aspose.cells.SaveFormat.XLSX);
    workbook.save(newOleStream, fileOptions);

    // Изменить данные объекта OLE‑кадра.
    IOleEmbeddedDataInfo newData = new OleEmbeddedDataInfo(newOleStream.toByteArray(), oleFrame.getEmbeddedData().getEmbeddedFileExtension());
    oleFrame.setEmbeddedData(newData);
}

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

Внедрение других типов файлов в слайды

Помимо диаграмм Excel, Aspose.Slides for Android via Java позволяет внедрять в слайды другие типы файлов. Например, можно вставлять HTML, PDF и ZIP файлы в виде объектов. При двойном щелчке пользователя по вставленному объекту он автоматически открывается в соответствующей программе, либо пользователь получает запрос выбрать подходящую программу для открытия.

Этот Java‑код показывает, как внедрить HTML и ZIP в слайд:

Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);

File fileHtml = new File("sample.html");
byte htmlData[] = new byte[(int) fileHtml.length()];
BufferedInputStream bisHtml = new BufferedInputStream(new FileInputStream(fileHtml));
DataInputStream disHtml = new DataInputStream(bisHtml);
disHtml.readFully(htmlData);
IOleEmbeddedDataInfo htmlDataInfo = new OleEmbeddedDataInfo(htmlData, "html");
IOleObjectFrame htmlOleFrame = slide.getShapes().addOleObjectFrame(150, 120, 50, 50, htmlDataInfo);
htmlOleFrame.setObjectIcon(true);

File fileZip = new File("sample.zip");
byte zipData[] = new byte[(int) fileZip.length()];
BufferedInputStream bisZip = new BufferedInputStream(new FileInputStream(fileZip));
DataInputStream disZip = new DataInputStream(bisZip);
disZip.readFully(zipData);
IOleEmbeddedDataInfo zipDataInfo = new OleEmbeddedDataInfo(zipData, "zip");
IOleObjectFrame zipOleFrame = slide.getShapes().addOleObjectFrame(150, 220, 50, 50, zipDataInfo);
zipOleFrame.setObjectIcon(true);

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

Установка типов файлов для внедрённых объектов

При работе с презентациями может потребоваться заменить старые OLE‑объекты новыми или заменить неподдерживаемый OLE‑объект поддерживаемым. Aspose.Slides for Android via Java позволяет задать тип файла для внедрённого объекта, что даёт возможность обновить данные OLE‑кадра или его расширение.

Этот Java‑код показывает, как задать тип файла для внедрённого OLE‑объекта как zip:

Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IOleObjectFrame oleFrame = (IOleObjectFrame) slide.getShapes().get_Item(0);

String fileExtension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();
byte[] fileData = oleFrame.getEmbeddedData().getEmbeddedFileData();

System.out.println("Current embedded file extension is: " + fileExtension);

// Изменить тип файла на ZIP.
oleFrame.setEmbeddedData(new OleEmbeddedDataInfo(fileData, "zip"));

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

Установка изображений‑значков и заголовков для внедрённых объектов

После внедрения OLE‑объекта автоматически добавляется превью в виде значка. Это превью видят пользователи до доступа к объекту. Если необходимо использовать конкретное изображение и текст в превью, можно задать изображение‑значок и заголовок с помощью Aspose.Slides for Android via Java.

Этот Java‑код показывает, как задать изображение‑значок и заголовок для внедрённого объекта:

Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);
IOleObjectFrame oleFrame = (IOleObjectFrame) slide.getShapes().get_Item(0);

// Добавить изображение в ресурсы презентации.
File file = new File("image.png");
byte imageData[] = new byte[(int) file.length()];
BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file));
DataInputStream dis = new DataInputStream(bis);
dis.readFully(imageData);
IPPImage oleImage = presentation.getImages().addImage(imageData);

// Установить заголовок и изображение для предварительного просмотра OLE.
oleFrame.setSubstitutePictureTitle("My title");
oleFrame.getSubstitutePictureFormat().getPicture().setImage(oleImage);
oleFrame.setObjectIcon(true);

presentation.save("output.pptx", SaveFormat.Pptx);
presentation.dispose();

Предотвращение изменения размера и положения OLE‑кадра объекта

После добавления связанного OLE‑объекта в слайд презентации, при открытии её в PowerPoint может появиться сообщение с предложением обновить ссылки. Нажатие кнопки «Update Links» может изменить размер и положение OLE‑кадра, поскольку PowerPoint обновляет данные из связанного OLE‑объекта и обновляет превью. Чтобы PowerPoint не запрашивал обновление данных объекта, установите метод setUpdateAutomatic интерфейса IOleObjectFrame в false:

oleFrame.setUpdateAutomatic(false);

Извлечение внедрённых файлов

Aspose.Slides for Android via Java позволяет извлекать файлы, внедрённые в слайды в виде OLE‑объектов, следующим образом:

Создайте экземпляр класса Presentation, содержащий OLE‑объекты, которые необходимо извлечь.
Пройдитесь по всем формам в презентации и получите формы OLEObjectFrame.
Получите данные внедрённых файлов из OLE‑кадров объектов и запишите их на диск.

Этот Java‑код показывает, как извлечь файлы, внедрённые в слайд в виде OLE‑объектов:

Presentation presentation = new Presentation("sample.pptx");
ISlide slide = presentation.getSlides().get_Item(0);

for (int index = 0; index < slide.getShapes().size(); index++) {
    IShape shape = slide.getShapes().get_Item(index);

    if (shape instanceof IOleObjectFrame) {
        IOleObjectFrame oleFrame = (IOleObjectFrame) shape;

        byte[] fileData = oleFrame.getEmbeddedData().getEmbeddedFileData();
        String fileExtension = oleFrame.getEmbeddedData().getEmbeddedFileExtension();

        FileOutputStream fos = new FileOutputStream(new File("OLE_object_" + index + fileExtension));
        fos.write(fileData);
        fos.close();
    }
}

presentation.dispose();

FAQ

Будет ли OLE‑содержание отрисовано при экспорте слайдов в PDF/изображения?

Отображается то, что видно на слайде — значок/заменяющее изображение (превью). «Живое» OLE‑содержание при рендеринге не выполняется. При необходимости задайте собственное превью‑изображение, чтобы обеспечить ожидаемый вид в экспортированном PDF.

Как заблокировать OLE‑объект на слайде, чтобы пользователи не могли перемещать/редактировать его в PowerPoint?

Заблокируйте форму: Aspose.Slides предоставляет блокировки на уровне формы. Это не шифрование, но эффективно предотвращает случайные изменения и перемещения.

Почему связанный объект Excel «перепрыгивает» или меняет размер при открытии презентации?

PowerPoint может обновлять превью связанного OLE. Для стабильного отображения используйте рекомендации из Рабочего решения для изменения размера листа — либо подгоняйте кадр под диапазон, либо масштабируйте диапазон к фиксированному кадру и задавайте подходящее заменяющее изображение.

Сохранятся ли относительные пути для связанных OLE‑объектов в формате PPTX?

В PPTX информация о «относительном пути» недоступна — сохраняется только полный путь. Относительные пути присутствуют в старом формате PPT. Для переносимости предпочтительно использовать надёжные абсолютные пути/доступные URI или внедрение.

Управление медиафайлами Управление текстом