Управление OLE в презентациях с использованием Python

Обзор

Info

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

Например, диаграмма, созданная в Microsoft Excel и размещённая на слайде PowerPoint, является OLE‑объектом.

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

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

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

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

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

В примере ниже диаграмма из файла Excel встроена в слайд в виде OleObjectFrame.

Примечание: Конструктор OleEmbeddedDataInfo принимает расширение файла встраиваемого объекта вторым параметром. PowerPoint использует это расширение для определения типа файла и выбора соответствующего приложения для открытия OLE‑объекта.

with slides.Presentation() as presentation:
    slide_size = presentation.slide_size.size
    slide = presentation.slides[0]

    # Подготовьте данные для OLE‑объекта.
    with open("book.xlsx", "rb") as file_stream:
        file_data = file_stream.read()
        data_info = slides.dom.ole.OleEmbeddedDataInfo(file_data, "xlsx")

    # Добавьте кадр OLE‑объекта на слайд.
    ole_frame = slide.shapes.add_ole_object_frame(0, 0, slide_size.width, slide_size.height, data_info)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

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

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

Пример ниже на Python показывает, как добавить OleObjectFrame, связанный с файлом Excel на слайде:

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # Добавить кадр OLE‑объекта со связанным файлом Excel.
    slide.shapes.add_ole_object_frame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx")

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

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

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

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

Пример ниже получает доступ к кадру OLE‑объекта — встроенной диаграмме Excel — и извлекает данные файла. В этом примере используется PPTX с единственной фигурой на первом слайде.

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.OleObjectFrame):
        ole_frame = shape

        # Получить данные встроенного файла.
        file_data = ole_frame.embedded_data.embedded_file_data

        # Получить расширение встроенного файла.
        file_extension = ole_frame.embedded_data.embedded_file_extension

        # ...

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

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

Пример на Python ниже проверяет, связан ли OLE‑объект, и, если да, извлекает путь к связанному файлу:

with slides.Presentation("sample.ppt") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.OleObjectFrame):
        ole_frame = shape

        # Проверить, связан ли OLE объект.
        if ole_frame.is_object_link:
            # Вывести полный путь к связанному файлу.
            print("OLE object frame is linked to:", ole_frame.link_path_long)

            # Вывести относительный путь к связанному файлу, если он присутствует.
            # Только презентации .ppt могут содержать относительный путь.
            if ole_frame.link_path_relative:
                print("OLE object frame relative path:", ole_frame.link_path_relative)

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

В этом разделе пример кода ниже использует Aspose.Cells for Python via .NET.

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

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

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

import io
import aspose.slides as slides
import aspose.cells as cells

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.OleObjectFrame):
        ole_frame = shape

        with io.BytesIO(ole_frame.embedded_data.embedded_file_data) as ole_stream:
            # Прочитать данные OLE-объекта как объект Workbook.
            workbook = cells.Workbook(ole_stream)

        with io.BytesIO() as new_ole_stream:
            # Изменить данные рабочей книги.
            workbook.worksheets.get(0).cells.get(0, 4).put_value("E")
            workbook.worksheets.get(0).cells.get(1, 4).put_value(12)
            workbook.worksheets.get(0).cells.get(2, 4).put_value(14)
            workbook.worksheets.get(0).cells.get(3, 4).put_value(15)

            file_options = cells.OoxmlSaveOptions(cells.SaveFormat.XLSX)
            workbook.save(new_ole_stream, file_options)

            # Изменить данные объекта OLE-кадра.
            new_data = slides.dom.ole.OleEmbeddedDataInfo(new_ole_stream.getvalue(), ole_frame.embedded_data.embedded_file_extension)
            ole_frame.set_embedded_data(new_data)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Внедрение файлов в слайды

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

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    with open("sample.html", "rb") as html_stream:
        html_data = html_stream.read()

    html_data_info = slides.dom.ole.OleEmbeddedDataInfo(html_data, "html")
    html_ole_frame = slide.shapes.add_ole_object_frame(150, 120, 50, 50, html_data_info)
    html_ole_frame.is_object_icon = True

    with open("sample.zip", "rb") as zip_stream:
        zip_data = zip_stream.read()

    zip_data_info = slides.dom.ole.OleEmbeddedDataInfo(zip_data, "zip")
    zip_ole_frame = slide.shapes.add_ole_object_frame(150, 220, 50, 50, zip_data_info)
    zip_ole_frame.is_object_icon = True

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

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

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

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

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    ole_frame = slide.shapes[0]

    file_extension = ole_frame.embedded_data.embedded_file_extension
    file_data = ole_frame.embedded_data.embedded_file_data

    print(f"Current embedded file extension is: {file_extension}")

    # Изменить тип файла на ZIP.
    ole_frame.set_embedded_data(slides.dom.ole.OleEmbeddedDataInfo(file_data, "zip"))

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

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

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

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

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    ole_frame = slide.shapes[0]

    # Добавить изображение в ресурсы презентации.
    with slides.Images.from_file("image.png") as image:
        ole_image = presentation.images.add_image(image)

    # Установить заголовок и изображение для предварительного просмотра OLE.
    ole_frame.substitute_picture_title = "My title"
    ole_frame.substitute_picture_format.picture.image = ole_image
    ole_frame.is_object_icon = True

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

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

После добавления связанного OLE‑объекта на слайд PowerPoint может предлагать обновить ссылки при открытии презентации. Выбор “Update Links” может изменить размер и положение кадра OLE‑объекта, так как PowerPoint обновляет превью данными из связанного объекта. Чтобы предотвратить запрос PowerPoint об обновлении данных объекта, установите свойство update_automatic класса OleObjectFrame в False:

ole_frame.update_automatic = False

Извлечение встроенных файлов

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

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

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

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    for index, shape in enumerate(slide.shapes):
        if isinstance(shape, slides.OleObjectFrame):
            ole_frame = shape

            file_data = ole_frame.embedded_data.embedded_file_data
            file_extension = ole_frame.embedded_data.embedded_file_extension

            file_path = f"OLE_object_{index}{file_extension}"
            with open(file_path, 'wb') as file_stream:
                file_stream.write(file_data)

FAQ

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

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

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

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

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

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

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

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

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