# 使用 Python 管理演示文稿中的 OLE

> 使用 Aspose.Slides for Python via Java 优化 PowerPoint 和 OpenDocument 文件中的 OLE 对象管理，实现 OLE 内容的无缝嵌入、更新和导出。

Source: https://docs.aspose.com/slides/zh/python-java/manage-ole/
Updated: 2026-09-09

## **简介**

{{% alert color="info" title="Note" %}}
OLE（对象链接与嵌入）是 Microsoft 的技术，允许在一个应用程序中创建的数据和对象通过链接或嵌入的方式放置到另一个应用程序中。
{{% /alert %}}

考虑在 MS Excel 中创建的图表。该图表随后被放置在 PowerPoint 幻灯片中。该 Excel 图表被视为 OLE 对象。

- OLE 对象可能以图标形式显示。在这种情况下，双击图标时，图表将在其关联的应用程序（Excel）中打开，或者系统会要求您选择用于打开或编辑该对象的应用程序。
- OLE 对象也可能直接显示其实际内容，例如图表的内容。在这种情况下，图表在 PowerPoint 中被激活，图表界面加载，您可以在 PowerPoint 中修改图表的数据。

[Aspose.Slides for Python via Java](https://products.aspose.com/slides/zh/python-java/) 允许您将 OLE 对象插入幻灯片作为 OLE 对象帧（[OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/)）。

## **向幻灯片添加 OLE 对象帧**

假设您已经在 Microsoft Excel 中创建了图表，并希望使用 Aspose.Slides for Python via Java 将其嵌入幻灯片作为 OLE 对象帧，您可以按以下方式操作：

1. 创建一个 [Presentation](https://reference.aspose.com/slides/zh/python-java/aspose.slides/presentation/) 类的实例。
2. 通过索引获取幻灯片的引用。
3. 将 Excel 文件读取为字节数组。
4. 向幻灯片添加包含字节数组及其他 OLE 对象信息的 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/)。
5. 将修改后的演示文稿写入为 PPTX 文件。

在下面的示例中，我们使用 Aspose.Slides for Python via Java 将 Excel 文件中的图表添加到幻灯片作为 OLE 对象帧。**注意**，[OleEmbeddedDataInfo](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleembeddeddatainfo/) 构造函数的第二个参数是可嵌入对象的扩展名。此扩展名使 PowerPoint 能够正确识别文件类型并选择合适的应用程序来打开该 OLE 对象。

```python
from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import OleEmbeddedDataInfo, Presentation, SaveFormat

presentation = Presentation()
try:
    slide_size = presentation.getSlideSize().getSize()
    slide = presentation.getSlides().get_Item(0)

    # 为 OLE 对象准备数据。
    file_data = Path("book.xlsx").read_bytes()
    file_data = jpype.JArray(jpype.JByte)(file_data)
    data_info = OleEmbeddedDataInfo(file_data, "xlsx")

    # 将 OLE 对象帧添加到幻灯片。
    frame_width = jpype.JFloat(slide_size.getWidth())
    frame_height = jpype.JFloat(slide_size.getHeight())
    slide.getShapes().addOleObjectFrame(0, 0, frame_width, frame_height, data_info)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

### **添加链接的 OLE 对象帧**

Aspose.Slides for Python via Java 允许您添加一个指向文件的链接而非嵌入数据的 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/)。

以下 Python 代码演示如何向幻灯片添加带有链接 Excel 文件的 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/)：

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    # 添加带链接的 Excel 文件的 OLE 对象帧。
    slide.getShapes().addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx")

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

## **访问 OLE 对象帧**

如果 OLE 对象已经嵌入到幻灯片中，您可以按以下方式轻松查找或访问它：

1. 通过创建 [Presentation](https://reference.aspose.com/slides/zh/python-java/aspose.slides/presentation/) 类的实例，加载包含嵌入 OLE 对象的演示文稿。
2. 通过索引获取幻灯片的引用。
3. 访问 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/) 形状。  
   在我们的示例中，我们使用了之前创建的 PPTX，该文件在第一页只有一个形状。随后我们检查该对象是否为 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/)。这就是我们想要访问的 OLE 对象帧。
4. 一旦访问到 OLE 对象帧，您就可以对其执行任何操作。

下面的示例中，访问了 OLE 对象帧（嵌入幻灯片的 Excel 图表对象）及其文件数据。

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import OleObjectFrame, Presentation

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().get_Item(0)

    if isinstance(shape, OleObjectFrame):
        ole_frame = shape

        # 获取嵌入的文件数据。
        file_data = ole_frame.getEmbeddedData().getEmbeddedFileData()

        # 获取嵌入文件的扩展名。
        file_extension = ole_frame.getEmbeddedData().getEmbeddedFileExtension()

        # ...
finally:
    presentation.dispose()
```

### **访问链接 OLE 对象帧属性**

Aspose.Slides 允许您访问链接 OLE 对象帧的属性。

以下 Python 代码演示如何检查 OLE 对象是否为链接，并获取链接文件的路径：

```python
import jpime
import asposeslides

if not jpime.isJVMStarted():
    jpime.startJVM()

from asposeslides.api import OleObjectFrame, Presentation

presentation = Presentation("sample.ppt")
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().get_Item(0)

    if isinstance(shape, OleObjectFrame):
        ole_frame = shape

        # 检查 OLE 对象是否为链接。
        if ole_frame.isObjectLink():
            # 打印链接文件的完整路径。
            print("OLE object frame is linked to: " + str(ole_frame.getLinkPathLong()))

            # 如果存在，打印链接文件的相对路径。
            # 仅 PPT 演示文稿才能包含相对路径。
            relative_path = ole_frame.getLinkPathRelative()
            if relative_path is not None and not relative_path.isEmpty():
                print("OLE object frame relative path: " + str(relative_path))
finally:
    presentation.dispose()
```

## **更改 OLE 对象数据**

{{% alert color="info" title="Note" %}}
在本节中，下面的代码示例使用了 [Aspose.Cells for Python via Java](https://products.aspose.com/cells/python-java/)。
{{% /alert %}}

如果 OLE 对象已经嵌入到幻灯片中，您可以按以下方式轻松访问该对象并修改其数据：

1. 通过创建 [Presentation](https://reference.aspose.com/slides/zh/python-java/aspose.slides/presentation/) 类的实例，加载包含嵌入 OLE 对象的演示文稿。
2. 通过索引获取幻灯片的引用。
3. 访问 OLE 对象帧形状。  
   在我们的示例中，我们使用了之前创建的 PPTX，该文件在第一页只有一个形状。随后我们检查该对象是否为 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/)。这就是我们想要访问的 OLE 对象帧。
4. 一旦访问到 OLE 对象帧，您就可以对其执行任何操作。
5. 创建一个 [Workbook](https://reference.aspose.com/cells/python-java/asposecells.api/workbook/) 对象并访问 OLE 数据。
6. 访问所需的 [Worksheet](https://reference.aspose.com/cells/python-java/asposecells.api/worksheet/) 并修改数据。
7. 将更新后的 [Workbook](https://reference.aspose.com/cells/python-java/asposecells.api/workbook/) 保存到流中。
8. 从流中更改 OLE 对象的数据。

下面的示例中，访问了 OLE 对象帧（嵌入幻灯片的 Excel 图表对象），并修改其文件数据以更新图表数据。

```python
import jpype
import asposeslides
import asposecells

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import OleEmbeddedDataInfo, OleObjectFrame, Presentation, SaveFormat
from asposecells.api import Workbook, OoxmlSaveOptions
from asposecells.api import SaveFormat as CellsSaveFormat
from java.io import ByteArrayInputStream, ByteArrayOutputStream

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    shape = slide.getShapes().get_Item(0)

    if isinstance(shape, OleObjectFrame):
        ole_frame = shape

        file_data = ole_frame.getEmbeddedData().getEmbeddedFileData()
        ole_stream = ByteArrayInputStream(file_data)

        # 将 OLE 对象数据读取为 Workbook 对象。
        workbook = Workbook(ole_stream)

        new_ole_stream = ByteArrayOutputStream()

        # 修改工作簿数据。
        cells = workbook.getWorksheets().get(0).getCells()
        cells.get(0, 4).putValue("E")
        cells.get(1, 4).putValue(jpype.JInt(12))
        cells.get(2, 4).putValue(jpype.JInt(14))
        cells.get(3, 4).putValue(jpype.JInt(15))

        file_options = OoxmlSaveOptions(CellsSaveFormat.XLSX)
        workbook.save(new_ole_stream, file_options)

        # 更改 OLE 框对象的数据。
        new_file_data = new_ole_stream.toByteArray()
        new_data = OleEmbeddedDataInfo(new_file_data, ole_frame.getEmbeddedData().getEmbeddedFileExtension())
        ole_frame.setEmbeddedData(new_data)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

## **在幻灯片中嵌入其他文件类型**

除了 Excel 图表，Aspose.Slides for Python via Java 允许您嵌入其他类型的文件到幻灯片中。例如，您可以将 HTML、PDF 和 ZIP 文件作为对象插入。当用户双击插入的对象时，它会自动在相应程序中打开，或提示用户选择合适的程序来打开它。

以下 Python 代码演示如何将 HTML 和 ZIP 嵌入幻灯片：

```python
from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import OleEmbeddedDataInfo, Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    html_data = Path("sample.html").read_bytes()
    html_data = jpype.JArray(jpype.JByte)(html_data)
    html_data_info = OleEmbeddedDataInfo(html_data, "html")
    html_ole_frame = slide.getShapes().addOleObjectFrame(150, 120, 50, 50, html_data_info)
    html_ole_frame.setObjectIcon(True)

    zip_data = Path("sample.zip").read_bytes()
    zip_data = jpype.JArray(jpype.JByte)(zip_data)
    zip_data_info = OleEmbeddedDataInfo(zip_data, "zip")
    zip_ole_frame = slide.getShapes().addOleObjectFrame(150, 220, 50, 50, zip_data_info)
    zip_ole_frame.setObjectIcon(True)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

## **设置嵌入对象的文件类型**

在处理演示文稿时，您可能需要将旧的 OLE 对象替换为新的，或将不受支持的 OLE 对象替换为受支持的。Aspose.Slides for Python via Java 允许您为嵌入对象设置文件类型，从而更新 OLE 帧数据或其扩展名。

以下 Python 代码演示如何将嵌入 OLE 对象的文件类型设置为 `zip`：

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import OleEmbeddedDataInfo, Presentation, SaveFormat

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    ole_frame = slide.getShapes().get_Item(0)

    file_extension = ole_frame.getEmbeddedData().getEmbeddedFileExtension()
    file_data = ole_frame.getEmbeddedData().getEmbeddedFileData()

    print("Current embedded file extension is: " + str(file_extension))

    # 将文件类型更改为 ZIP。
    data_info = OleEmbeddedDataInfo(file_data, "zip")
    ole_frame.setEmbeddedData(data_info)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

## **为嵌入对象设置图标图片和标题**

在 OLE 对象嵌入后，会自动添加由图标图片组成的预览。该预览是用户在访问或打开 OLE 对象之前看到的内容。如果您想使用特定的图片和文字作为预览元素，可以使用 Aspose.Slides for Python via Java 设置图标图片和标题。

以下 Python 代码演示如何为嵌入对象设置图标图片和标题：

```python
from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    ole_frame = slide.getShapes().get_Item(0)

    # 向演示文稿资源添加图片。
    image_data = Path("image.png").read_bytes()
    image_data = jpype.JArray(jpype.JByte)(image_data)
    ole_image = presentation.getImages().addImage(image_data)

    # 为 OLE 预览设置标题和图片。
    ole_frame.setSubstitutePictureTitle("My title")
    ole_frame.getSubstitutePictureFormat().getPicture().setImage(ole_image)
    ole_frame.setObjectIcon(True)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

## **防止 OLE 对象帧被重新大小调整和重新定位**

在向演示文稿幻灯片添加链接的 OLE 对象后，打开 PowerPoint 时可能会出现提示要求更新链接的消息。单击 “Update Links” 按钮可能会导致 OLE 对象帧的大小和位置发生变化，因为 PowerPoint 会从链接的 OLE 对象更新数据并刷新对象预览。要阻止 PowerPoint 提示更新对象数据，请将 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/) 类的 [setUpdateAutomatic](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/#setUpdateAutomatic) 方法设为 `False`：

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)
    ole_frame = slide.getShapes().get_Item(0)

    ole_frame.setUpdateAutomatic(False)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

## **提取嵌入文件**

Aspose.Slides for Python via Java 允许您按以下方式提取幻灯片中嵌入的 OLE 对象文件：

1. 创建包含您要提取的 OLE 对象的 [Presentation](https://reference.aspose.com/slides/zh/python-java/aspose.slides/presentation/) 类实例。
2. 循环遍历演示文稿中的所有形状，访问其中的 [OleObjectFrame](https://reference.aspose.com/slides/zh/python-java/aspose.slides/oleobjectframe/) 形状。
3. 从 OLE 对象帧中获取嵌入文件的数据并写入磁盘。

以下 Python 代码演示如何提取幻灯片中作为 OLE 对象嵌入的文件：

```python
from pathlib import Path

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import OleObjectFrame, Presentation

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    for index in range(slide.getShapes().size()):
        shape = slide.getShapes().get_Item(index)

        if isinstance(shape, OleObjectFrame):
            ole_frame = shape

            file_data = ole_frame.getEmbeddedData().getEmbeddedFileData()
            file_extension = ole_frame.getEmbeddedData().getEmbeddedFileExtension()

            file_path = Path(f"OLE_object_{index}.{str(file_extension).lstrip('.')}")
            file_path.write_bytes(bytes(file_data))
finally:
    presentation.dispose()
```

## **常见问题**

**将 OLE 内容在导出为 PDF/图像时会被渲染吗？**

幻灯片上可见的内容会被渲染——即图标/替代图片（预览）。“实时” OLE 内容在渲染过程中不会被执行。如有需要，可自行设置预览图片，以确保在导出的 PDF 中呈现预期外观。

**如何锁定幻灯片上的 OLE 对象，使用户在 PowerPoint 中无法移动/编辑它？**

锁定形状：Aspose.Slides 提供了 [shape-level locks](/slides/zh/python-java/applying-protection-to-presentation/)。这不是加密，但可以有效防止意外编辑和移动。

**为什么打开演示文稿时，链接的 Excel 对象会“跳动”或改变大小？**

PowerPoint 可能会刷新链接 OLE 的预览。为获得稳定的外观，请遵循 [Working Solution for Worksheet Resizing](/slides/zh/python-java/working-solution-for-worksheet-resizing/) 的做法——要么使帧适应范围，要么将范围缩放到固定帧并设置合适的替代图片。

**链接的 OLE 对象的相对路径会在 PPTX 格式中保留吗？**

在 PPTX 中不提供 “相对路径” 信息——只有完整路径。相对路径存在于较旧的 PPT 格式中。为实现可移植性，建议使用可靠的绝对路径/可访问的 URI 或直接嵌入。