Hantera OLE i presentationer med Python

Vad den här sidan handlar om

Optimera hantering av OLE-objekt i PowerPoint- och OpenDocument-filer med Aspose.Slides för Python via Java. Bädda in, uppdatera och exportera OLE-innehåll sömlöst.

Introduktion

Note

OLE (Object Linking & Embedding) är en Microsoft‑teknik som gör att data och objekt som skapats i ett program kan placeras i ett annat program genom länkar eller inbäddning.

Tänk dig ett diagram som skapats i MS Excel. Diagrammet placeras sedan i en PowerPoint‑bild. Det Excel‑diagrammet betraktas som ett OLE‑objekt.

Ett OLE‑objekt kan visas som en ikon. I så fall öppnas diagrammet i det associerade programmet (Excel) när du dubbelklickar på ikonen, eller så blir du ombedd att välja ett program för att öppna eller redigera objektet.
Ett OLE‑objekt kan visa sitt faktiska innehåll, exempelvis ett diagram. I detta fall aktiveras diagrammet i PowerPoint, diagramgränssnittet laddas och du kan ändra diagrammets data direkt i PowerPoint.

Aspose.Slides för Python via Java gör att du kan infoga OLE‑objekt i bilder som OLE‑objektramar (OleObjectFrame).

Lägg till OLE‑objektramar i bilder

Förutsatt att du redan har skapat ett diagram i Microsoft Excel och vill bädda in det i en bild som en OLE‑objektram med Aspose.Slides för Python via Java, kan du göra så här:

Skapa en instans av klassen Presentation.
Hämta en referens till en bild genom dess index.
Läs Excel‑filen som en byte‑array.
Lägg till OleObjectFrame på bilden och inkludera byte‑arrayen samt annan information om OLE‑objektet.
Skriv den modifierade presentationen som en PPTX‑fil.

I exemplet nedan lade vi till ett diagram från en Excel‑fil på en bild som en OLE‑objektram med Aspose.Slides för Python via Java.
Obs att konstruktorn för OleEmbeddedDataInfo tar en inbäddningsbar objekt‑extension som sin andra parameter. Denna extension gör att PowerPoint korrekt kan tolka filtypen och välja rätt program för att öppna OLE‑objektet.

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)

    # Förbered data för OLE-objektet.
    file_data = Path("book.xlsx").read_bytes()
    file_data = jpype.JArray(jpype.JByte)(file_data)
    data_info = OleEmbeddedDataInfo(file_data, "xlsx")

    # Lägg till OLE-objektramen på bilden.
    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()

Lägg till länkade OLE‑objektramar

Aspose.Slides för Python via Java gör att du kan lägga till en OleObjectFrame med en länk till filen istället för inbäddade data.

Denna Python‑kod visar hur du lägger till en OleObjectFrame med en länkad Excel‑fil på en bild:

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)

    # Lägg till en OLE-objektram med en länkad Excel-fil.
    slide.getShapes().addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx")

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

Åtkomst till OLE‑objektramar

Om ett OLE‑objekt redan är inbäddat i en bild kan du enkelt hitta eller komma åt det på följande sätt:

Ladda en presentation med det inbäddade OLE‑objektet genom att skapa en instans av klassen Presentation.
Hämta en referens till bilden genom dess index.
Åtkomst till formen OleObjectFrame. I vårt exempel använde vi den tidigare skapade PPTX‑filen som bara har en form på den första bilden. Vi kontrollerade sedan att objektet var en OleObjectFrame. Detta var den önskade OLE‑objektramen att åtkommas.
När OLE‑objektramen har åtkomst kan du utföra vilken operation som helst på den.

I exemplet nedan åtkoms en OLE‑objektram (ett Excel‑diagramobjekt inbäddat i en bild) och dess fildata.

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

        # Hämta den inbäddade filens data.
        file_data = ole_frame.getEmbeddedData().getEmbeddedFileData()

        # Hämta den inbäddade filens filändelse.
        file_extension = ole_frame.getEmbeddedData().getEmbeddedFileExtension()

        # ...
finally:
    presentation.dispose()

Åtkomst till egenskaper för länkade OLE‑objektramar

Aspose.Slides gör att du kan komma åt egenskaper för länkade OLE‑objektramar.

Denna Python‑kod visar hur du kontrollerar om ett OLE‑objekt är länkat och sedan hämtar sökvägen till den länkade filen:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.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

        # Kontrollera om OLE-objektet är länkat.
        if ole_frame.isObjectLink():
            # Skriv ut hela sökvägen till den länkade filen.
            print("OLE object frame is linked to: " + str(ole_frame.getLinkPathLong()))

            # Skriv ut den relativa sökvägen till den länkade filen om den finns.
            # Endast PPT-presentationer kan innehålla relativ sökväg.
            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()

Ändra OLE‑objektdata

Note

I detta avsnitt använder kodexemplet nedan Aspose.Cells för Python via Java.

Om ett OLE‑objekt redan är inbäddat i en bild kan du enkelt komma åt objektet och ändra dess data på följande sätt:

Ladda en presentation med det inbäddade OLE‑objektet genom att skapa en instans av klassen Presentation.
Hämta en referens till bilden genom dess index.
Åtkomst till OLE‑objektramens form. I vårt exempel använde vi den tidigare skapade PPTX‑filen som har en form på den första bilden. Vi kontrollerade sedan att objektet var en OleObjectFrame. Detta var den önskade OLE‑objektramen att åtkommas.
När OLE‑objektramen har åtkomst kan du utföra vilken operation som helst på den.
Skapa ett Workbook-objekt och åtkomst till OLE‑datan.
Åtkomst till önskat Worksheet och ändra data.
Spara den uppdaterade Workbook i en ström.
Ändra OLE‑objektets data från strömmen.

I exemplet nedan åtkoms en OLE‑objektram (ett Excel‑diagramobjekt inbäddat i en bild) och dess fildata modifieras för att uppdatera diagrammets data.

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)

        # Läs OLE-objektdatan som ett Workbook-objekt.
        workbook = Workbook(ole_stream)

        new_ole_stream = ByteArrayOutputStream()

        # Ändra arbetsbokens data.
        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)

        # Ändra OLE-ramens objektdata.
        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()

Bädda in andra filtyper i bilder

Förutom Excel‑diagram gör Aspose.Slides för Python via Java det möjligt att bädda in andra filtyper i bilder. Du kan exempelvis infoga HTML‑, PDF‑ och ZIP‑filer som objekt. När en användare dubbelklickar på det infogade objektet öppnas det automatiskt i det relevanta programmet, eller så uppmanas användaren att välja ett lämpligt program för att öppna det.

Denna Python‑kod visar hur du bäddar in HTML och ZIP i en bild:

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()

Ange filtyper för inbäddade objekt

När du arbetar med presentationer kan du behöva ersätta gamla OLE‑objekt med nya eller ersätta ett ej‑stött OLE‑objekt med ett stödd. Aspose.Slides för Python via Java låter dig ange filtyp för ett inbäddat objekt, vilket gör att du kan uppdatera OLE‑ramens data eller dess extension.

Denna Python‑kod visar hur du sätter filtypen för ett inbäddat OLE‑objekt till zip:

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

    # Ändra filtypen till ZIP.
    data_info = OleEmbeddedDataInfo(file_data, "zip")
    ole_frame.setEmbeddedData(data_info)

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

Ange ikonbilder och titlar för inbäddade objekt

Efter att ett OLE‑objekt är inbäddat läggs automatiskt en förhandsvisning bestående av en ikonbild till. Denna förhandsvisning är vad användarna ser innan de öppnar eller åtkommer OLE‑objektet. Om du vill använda en specifik bild och text som element i förhandsvisningen kan du ange ikonbild och titel med Aspose.Slides för Python via Java.

Denna Python‑kod visar hur du sätter ikonbild och titel för ett inbäddat objekt:

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)

    # Lägg till en bild i presentationens resurser.
    image_data = Path("image.png").read_bytes()
    image_data = jpype.JArray(jpype.JByte)(image_data)
    ole_image = presentation.getImages().addImage(image_data)

    # Ange en titel och bilden för OLE-förhandsvisningen.
    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()

Förhindra att en OLE‑objektram ändras i storlek och position

Efter att du har lagt till ett länkat OLE‑objekt i en presentationsbild kan du, när du öppnar presentationen i PowerPoint, få ett meddelande som ber dig uppdatera länkarna. Att klicka på knappen ”Uppdatera länkar” kan ändra storlek och position för OLE‑objektramen eftersom PowerPoint uppdaterar datan från det länkade OLE‑objektet och uppdaterar förhandsvisningen. För att förhindra att PowerPoint uppmanar att uppdatera objektets data, anropa metoden setUpdateAutomatic i klassen OleObjectFrame med False:

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()

Extrahera inbäddade filer

Aspose.Slides för Python via Java gör det möjligt att extrahera de filer som är inbäddade i bilder som OLE‑objekt på följande sätt:

Skapa en instans av klassen Presentation som innehåller de OLE‑objekt du vill extrahera.
Loopa igenom alla former i presentationen och åtkomst till OleObjectFrame-formerna.
Åtkomst till data för inbäddade filer från OLE‑objektramar och skriv dem till disk.

Denna Python‑kod visar hur du extraherar filer som är inbäddade i en bild som OLE‑objekt:

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()

FAQ

Kommer OLE‑innehållet att renderas när bilder exporteras till PDF/bilder?

Det som är synligt på bilden renderas – ikon‑/ersättningsbilden (förhandsvisningen). Det ”levande” OLE‑innehållet körs inte under rendering. Vid behov kan du ange en egen förhandsvisningsbild för att säkerställa önskat utseende i den exporterade PDF‑filen.

För att även bevara den inbäddade filen som ett PDF‑bilaga, anropa setIncludeOleData med True. Detta alternativ är avstängt som standard. Se ett exempel och instruktioner för att kontrollera bilagan i Preserve Embedded OLE Files as PDF Attachments.

Hur kan jag låsa ett OLE‑objekt på en bild så att användare inte kan flytta/redigera det i PowerPoint?

Lås formen: Aspose.Slides erbjuder shape-level locks. Detta är ingen kryptering, men det förhindrar i praktiken oavsiktliga redigeringar och förflyttningar.

Varför “hoppar” ett länkat Excel‑objekt eller ändrar storlek när jag öppnar presentationen?

PowerPoint kan uppdatera förhandsvisningen av det länkade OLE‑objektet. För ett stabilt utseende bör du följa rekommendationerna i Working Solution for Worksheet Resizing – antingen anpassa ramen till området, eller skala området till en fast ram och ange en lämplig ersättningsbild.

Behålls relativa sökvägar för länkade OLE‑objekt i PPTX‑formatet?

I PPTX finns ingen information om ”relativ sökväg” – endast den fullständiga sökvägen sparas. Relativa sökvägar finns i det äldre PPT‑formatet. För portabilitet bör du föredra pålitliga absoluta sökvägar eller åtkomliga URI:er, eller bädda in filerna.

Hantera mediafiler i Python via Java Hantera presentationstext i Python via Java