Správa OLE v prezentacích pomocí Pythonu

O čem je tato stránka

Optimalizujte správu OLE objektů v PowerPoint a souborech OpenDocument s Aspose.Slides pro Python pomocí .NET. Vkládejte, aktualizujte a exportujte obsah OLE bez problémů.

Úvod

Note

OLE (Object Linking & Embedding) je technologie Microsoftu, která umožňuje propojit nebo vložit data a objekty vytvořené v jedné aplikaci do jiné.

Například graf vytvořený v Microsoft Excel a umístěný na snímku PowerPointu je OLE objekt.

OLE objekt se může zobrazovat jako ikona. Dvojklik na ikonu otevře objekt v jeho přiřazené aplikaci (např. Excel) nebo vyzve k výběru aplikace pro otevření či úpravu.
OLE objekt může zobrazovat svůj obsah (například graf). V tomto případě PowerPoint aktivuje vložený objekt, načte rozhraní grafu a umožní upravit data grafu přímo v PowerPointu.

Aspose.Slides for Python vám umožňuje vkládat OLE objekty do snímků jako OLE objektové rámy (OleObjectFrame).

Přidání OLE objektů do snímků

Pokud jste již vytvořili graf v Microsoft Excel a chcete jej vložit do snímku jako OLE objektový rámec pomocí Aspose.Slides for Python, postupujte podle těchto kroků:

Vytvořte instanci třídy Presentation.
Získejte odkaz na snímek podle jeho indexu.
Načtěte soubor Excel do pole bajtů.
Přidejte OleObjectFrame na snímek a předávejte pole bajtů a další podrobnosti OLE objektu.
Uložte upravenou prezentaci jako soubor PPTX.

V níže uvedeném příkladu je graf ze souboru Excel vložen do snímku jako OleObjectFrame.

Poznámka: Konstruktor OleEmbeddedDataInfo přijímá příponu souboru vložitelného objektu jako druhý parametr. PowerPoint používá tuto příponu k identifikaci typu souboru a výběru vhodné aplikace pro otevření OLE objektu.

import aspose.slides as slides

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

    # Připravte data pro OLE objekt.
    with open("book.xlsx", "rb") as file_stream:
        file_data = file_stream.read()
        data_info = slides.dom.ole.OleEmbeddedDataInfo(file_data, "xlsx")

    # Přidejte OLE objektový rámec do snímku.
    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)

Přidání propojených OLE objektů

Aspose.Slides for Python vám umožňuje přidat OleObjectFrame, který odkazuje na soubor místo vložení jeho dat.

Následující příklad v Pythonu ukazuje, jak přidat OleObjectFrame odkazující na soubor Excel na snímku:

import aspose.slides as slides

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

    # Přidejte OLE objektový rámec s propojeným souborem Excel.
    slide.shapes.add_ole_object_frame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx")

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

Přístup k OLE objektům

Pokud je OLE objekt již vložen do snímku, můžete k němu přistupovat následovně:

Načtěte prezentaci, která obsahuje vložený OLE objekt, vytvořením instance třídy Presentation.
Získejte odkaz na snímek podle jeho indexu.
Přistupte k tvaru OleObjectFrame.
Jakmile máte OLE objektový rámec, proveďte požadované operace.

Níže uvedený příklad přistupuje k OLE objektovému rámci — vloženému grafu Excelu — a načte jeho data souboru. V tomto příkladu používáme PPTX, který má na prvním snímku jediný tvar.

import aspose.slides as slides

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

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

        # Získejte data vloženého souboru.
        file_data = ole_frame.embedded_data.embedded_file_data

        # Získejte příponu vloženého souboru.
        file_extension = ole_frame.embedded_data.embedded_file_extension

        # ...

Přístup k vlastnostem propojených OLE objektů

Aspose.Slides vám umožňuje přistupovat k vlastnostem propojeného OLE objektového rámce.

Níže uvedený příklad v Pythonu kontroluje, zda je OLE objekt propojen, a pokud ano, získá cestu k propojenému souboru:

import aspose.slides as slides

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

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

        # Zkontrolujte, zda je OLE objekt propojen.
        if ole_frame.is_object_link:
            # Vytiskněte úplnou cestu k propojenému souboru.
            print("OLE object frame is linked to:", ole_frame.link_path_long)

            # Vytiskněte relativní cestu k propojenému souboru, pokud je k dispozici.
            # Pouze prezentace .ppt mohou obsahovat relativní cestu.
            if ole_frame.link_path_relative:
                print("OLE object frame relative path:", ole_frame.link_path_relative)

Změna dat OLE objektu

Note

V této sekci níže uvedený kód používá Aspose.Cells for Python via .NET.

Pokud je OLE objekt již vložen do snímku, můžete k němu přistupovat a upravit jeho data následovně:

Načtěte prezentaci vytvořením instance třídy Presentation.
Získejte cílový snímek podle jeho indexu.
Přistupte k tvaru OleObjectFrame.
Jakmile máte OLE objektový rámec, proveďte požadované operace.
Vytvořte objekt Workbook a načtěte OLE data.
Otevřete požadovaný Worksheet a upravte data.
Uložte aktualizovaný Workbook do proudu.
Nahraďte data OLE objektu tímto proudem.

V níže uvedeném příkladu je OLE objektový rámec (vložený graf Excelu) přístupný a jeho data souboru jsou upravena tak, aby aktualizovala graf. Vzorek používá dříve vytvořený PPTX, který obsahuje jediný tvar na prvním snímku.

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:
            # Načtěte data OLE objektu jako objekt Workbook.
            workbook = cells.Workbook(ole_stream)

        with io.BytesIO() as new_ole_stream:
            # Upravte data sešitu.
            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)

            # Změňte data objektu OLE rámce.
            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)

Vkládání souborů do snímků

Kromě grafů Excelu vám Aspose.Slides for Python umožňuje vkládat do snímků i jiné typy souborů. Například můžete vložit soubory HTML, PDF a ZIP jako objekty. Když uživatel dvojklikne vložený objekt, otevře se automaticky v příslušné aplikaci nebo je vyzván k výběru vhodného programu.

Níže uvedený kód v Pythonu ukazuje, jak vložit soubory HTML a ZIP do snímku:

import aspose.slides as slides

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)

Nastavení typů souborů pro vložené objekty

Při práci s prezentacemi může být potřeba nahradit staré OLE objekty novými nebo vyměnit nepodporovaný OLE objekt za podporovaný. Aspose.Slides for Python vám umožňuje nastavit typ souboru vloženého objektu, což vám umožní aktualizovat data OLE rámce nebo jeho příponu souboru.

Níže uvedený kód v Pythonu ukazuje, jak nastavit typ souboru vloženého OLE objektu na zip:

import aspose.slides as slides

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}")

    # Změňte typ souboru na ZIP.
    ole_frame.set_embedded_data(slides.dom.ole.OleEmbeddedDataInfo(file_data, "zip"))

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

Nastavení ikon a názvů pro vložené objekty

Po vložení OLE objektu je automaticky přidán náhled založený na ikoně. Tento náhled vidí uživatelé před tím, než objekt otevřou nebo získají k němu přístup. Pokud chcete v náhledu použít konkrétní obrázek a text, můžete nastavit obrázek ikony a název pomocí Aspose.Slides for Python.

Níže uvedený kód v Pythonu ukazuje, jak nastavit obrázek ikony a název pro vložený objekt:

import aspose.slides as slides

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

    # Přidejte obrázek do zdrojů prezentace.
    with slides.Images.from_file("image.png") as image:
        ole_image = presentation.images.add_image(image)

    # Nastavte název a obrázek pro náhled 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)

Zabránit změně velikosti a přesunutí rámců OLE objektů

Po přidání propojeného OLE objektu do snímku může PowerPoint při otevření prezentace vyzvat k aktualizaci odkazů. Volba Aktualizovat odkazy může změnit velikost a umístění rámce OLE objektu, protože PowerPoint obnovuje náhled s daty z propojeného objektu. Chcete‑li zabránit výzvě k aktualizaci dat objektu, nastavte vlastnost update_automatic třídy OleObjectFrame na False:

import aspose.slides as slides

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

    ole_frame.update_automatic = False

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

Extrahování vložených souborů

Aspose.Slides for Python vám umožňuje extrahovat soubory vložené do snímků jako OLE objekty následovně:

Vytvořte instanci třídy Presentation, která obsahuje OLE objekty, jež chcete extrahovat.
Projděte všechny tvary v prezentaci a najděte tvary OLEObjectFrame.
Získejte data vloženého souboru z každého OLEObjectFrame a zapište je na disk.

Níže uvedený kód v Pythonu ukazuje, jak extrahovat soubory vložené do snímku jako OLE objekty:

import aspose.slides as slides

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

Bude obsah OLE při exportu snímků do PDF/obrázků vykreslen?

Na snímku se vykresluje to, co je viditelné — ikona/náhradní obrázek (náhled). „Živý“ OLE obsah není během vykreslování spuštěn. V případě potřeby nastavte vlastní náhledový obrázek, aby se zajistil očekávaný vzhled v exportovaném PDF.

Pro zachování vloženého souboru také jako PDF přílohu nastavte PdfOptions.include_ole_data na True. Tato volba je ve výchozím nastavení vypnutá. Příklad a postup pro kontrolu přílohy najdete v Zachovat vložené OLE soubory jako PDF přílohy.

Jak mohu uzamknout OLE objekt na snímku, aby jej uživatelé nemohli v PowerPointu přesouvat či upravovat?

Uzamkněte tvar: Aspose.Slides poskytuje zámky na úrovni tvaru. Nejde o šifrování, ale účinně zabraňuje neúmyslným úpravám a přesunutí.

Proč se propojený objekt Excel „poskakuje“ nebo mění velikost, když otevřu prezentaci?

PowerPoint může obnovit náhled propojeného OLE. Pro stabilní vzhled dodržujte postupy z Řešení pro změnu velikosti listu — buď přizpůsobte rámec rozsahu, nebo škálujte rozsah na pevný rámec a nastavte vhodný náhradní obrázek.

Zůstanou relativní cesty pro propojené OLE objekty zachovány ve formátu PPTX?

V PPTX nejsou informace o „relativní cestě“ k dispozici — je dostupná jen úplná cesta. Relativní cesty jsou v starším formátu PPT. Pro přenosnost upřednostňujte spolehlivé absolutní cesty/přístupné URI nebo vložení.

Správa přístupnosti prezentací v Pythonu Správa textu v prezentacích pomocí Pythonu