Beheer OLE in presentaties met Python

Waar deze pagina over gaat

Optimaliseer het beheer van OLE-objecten in PowerPoint- en OpenDocument-bestanden met Aspose.Slides voor Python via Java. Voeg OLE-inhoud in, werk deze bij en exporteer naadloos.

Inleiding

Note

OLE (Object Linking & Embedding) is een Microsoft‑technologie die het mogelijk maakt gegevens en objecten die in één toepassing zijn gemaakt, in een andere toepassing te plaatsen via koppeling of insluiting.

Beschouw een diagram dat is gemaakt in MS Excel. Het diagram wordt vervolgens in een PowerPoint‑dia geplaatst. Dat Excel‑diagram wordt beschouwd als een OLE‑object.

Een OLE‑object kan als een pictogram worden weergegeven. In dat geval wordt bij dubbelklikken op het pictogram het diagram geopend in de bijbehorende toepassing (Excel), of wordt u gevraagd een toepassing te selecteren om het object te openen of te bewerken.
Een OLE‑object kan de eigenlijke inhoud weergeven, zoals de inhoud van een diagram. In dat geval wordt het diagram geactiveerd in PowerPoint, laadt de diagraminterface, en kunt u de gegevens van het diagram binnen PowerPoint aanpassen.

Aspose.Slides for Python via Java stelt u in staat OLE‑objecten in dia’s in te voegen als OLE‑objectframes (OleObjectFrame).

OLE‑objectframes aan dia’s toevoegen

Als u al een diagram in Microsoft Excel hebt gemaakt en dit als OLE‑objectframe in een dia wilt insluiten met Aspose.Slides for Python via Java, kan dat op de volgende manier:

Maak een instantie van de Presentation klasse.
Haal een referentie op naar een dia op basis van de index.
Lees het Excel‑bestand in als een byte‑array.
Voeg het OleObjectFrame toe aan de dia met de byte‑array en overige informatie over het OLE‑object.
Schrijf de gewijzigde presentatie weg als een PPTX‑bestand.

In het voorbeeld hieronder hebben we een diagram uit een Excel‑bestand aan een dia toegevoegd als OLE‑objectframe met Aspose.Slides for Python via Java.
Note dat de constructor van OleEmbeddedDataInfo een extensie van het in te sluiten object als tweede parameter accepteert. Deze extensie stelt PowerPoint in staat het bestandstype correct te interpreteren en de juiste toepassing te kiezen om dit OLE‑object te openen.

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)

    # Voorbereiden van gegevens voor het OLE-object.
    file_data = Path("book.xlsx").read_bytes()
    file_data = jpype.JArray(jpype.JByte)(file_data)
    data_info = OleEmbeddedDataInfo(file_data, "xlsx")

    # Voeg het OLE-objectframe toe aan de dia.
    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()

Gekoppelde OLE‑objectframes toevoegen

Aspose.Slides for Python via Java laat u een OleObjectFrame toevoegen met een koppeling naar het bestand in plaats van ingesloten gegevens.

Deze Python‑code laat zien hoe u een OleObjectFrame met een gekoppeld Excel‑bestand aan een dia toevoegt:

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)

    # Voeg een OLE-objectframe toe met een gekoppeld Excel-bestand.
    slide.getShapes().addOleObjectFrame(20, 20, 200, 150, "Excel.Sheet.12", "book.xlsx")

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

OLE‑objectframes benaderen

Als een OLE‑object al in een dia is ingesloten, kunt u het op de volgende manier eenvoudig vinden of benaderen:

Laad een presentatie met het ingesloten OLE‑object door een instantie van de Presentation klasse te maken.
Haal een referentie op naar de dia op basis van de index.
Benader de OleObjectFrame‑vorm.
In ons voorbeeld gebruikten we de eerder gemaakte PPTX die slechts één vorm op de eerste dia bevat. Vervolgens controleerden we dat het object een OleObjectFrame was. Dit was het gewenste OLE‑objectframe om te benaderen.
Zodra het OLE‑objectframe is benaderd, kunt u er elke gewenste bewerking op uitvoeren.

In het voorbeeld hieronder wordt een OLE‑objectframe (een Excel‑diagramobject ingesloten in een dia) en de bijbehorende bestandsgegevens benaderd.

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

        # Haal de ingesloten bestandsgegevens op.
        file_data = ole_frame.getEmbeddedData().getEmbeddedFileData()

        # Haal de extensie van het ingesloten bestand op.
        file_extension = ole_frame.getEmbeddedData().getEmbeddedFileExtension()

        # ...
finally:
    presentation.dispose()

Eigenschappen van gekoppelde OLE‑objectframes benaderen

Aspose.Slides stelt u in staat de eigenschappen van gekoppelde OLE‑objectframes te benaderen.

Deze Python‑code laat zien hoe u controleert of een OLE‑object gekoppeld is en vervolgens het pad naar het gekoppelde bestand verkrijgt:

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

        # Controleer of het OLE-object gekoppeld is.
        if ole_frame.isObjectLink():
            # Print het volledige pad naar het gekoppelde bestand.
            print("OLE object frame is linked to: " + str(ole_frame.getLinkPathLong()))

            # Print het relatieve pad naar het gekoppelde bestand indien aanwezig.
            # Alleen PPT-presentaties kunnen het relatieve pad bevatten.
            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‑objectgegevens wijzigen

Note

In dit gedeelte gebruikt het code‑voorbeeld hieronder Aspose.Cells for Python via Java.

Als een OLE‑object al in een dia is ingesloten, kunt u dat object eenvoudig benaderen en de gegevens ervan als volgt wijzigen:

Laad een presentatie met het ingesloten OLE‑object door een instantie van de Presentation klasse te maken.
Haal een referentie op naar de dia op basis van de index.
Benader de OLE‑objectframe‑vorm.
In ons voorbeeld gebruikten we de eerder gemaakte PPTX die één vorm op de eerste dia bevat. Vervolgens controleerden we dat het object een OleObjectFrame was. Dit was het gewenste OLE‑objectframe om te benaderen.
Zodra het OLE‑objectframe is benaderd, kunt u er elke gewenste bewerking op uitvoeren.
Maak een Workbook‑object aan en benader de OLE‑gegevens.
Benader het gewenste Worksheet en pas de gegevens aan.
Sla het bijgewerkte Workbook op in een stream.
Wijzig de OLE‑objectgegevens vanuit de stream.

In het voorbeeld hieronder wordt een OLE‑objectframe (een Excel‑diagramobject ingesloten in een dia) benaderd en worden de bestandsgegevens aangepast om de diagramgegevens te updaten.

import jpype
import asposeslides
import asposecells

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

        # Lees de OLE-objectgegevens als een Workbook-object.
        workbook = Workbook(ole_stream)

        new_ole_stream = ByteArrayOutputStream()

        # Wijzig de werkboekgegevens.
        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)

        # Wijzig de OLE-frame-objectgegevens.
        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()

Andere bestandstypen insluiten in dia’s

Naast Excel‑diagrammen maakt Aspose.Slides for Python via Java het mogelijk andere bestandstypen in dia’s in te sluiten. U kunt bijvoorbeeld HTML‑, PDF‑ en ZIP‑bestanden als objecten invoegen. Wanneer een gebruiker dubbelklikt op het ingevoegde object, wordt dit automatisch geopend in het bijbehorende programma, of krijgt de gebruiker de mogelijkheid om een geschikt programma te kiezen.

Deze Python‑code toont hoe u HTML en ZIP in een dia insluit:

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

Bestandstypen voor ingesloten objecten instellen

Bij het werken met presentaties kan het nodig zijn oude OLE‑objecten te vervangen door nieuwe, of een niet‑ondersteund OLE‑object te vervangen door een ondersteund. Aspose.Slides for Python via Java stelt u in staat het bestandstype voor een ingesloten object in te stellen, zodat u de OLE‑frame‑gegevens of de extensie kunt bijwerken.

Deze Python‑code laat zien hoe u het bestandstype voor een ingesloten OLE‑object instelt op 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))

    # Wijzig het bestandstype naar ZIP.
    data_info = OleEmbeddedDataInfo(file_data, "zip")
    ole_frame.setEmbeddedData(data_info)

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

Pictogram‑afbeeldingen en titels voor ingesloten objecten instellen

Nadat een OLE‑object is ingesloten, wordt er automatisch een voorbeeld met een pictogram‑afbeelding toegevoegd. Dit voorbeeld is wat gebruikers zien voordat ze het OLE‑object openen of benaderen. Als u een specifieke afbeelding en tekst wilt gebruiken als elementen in het voorbeeld, kunt u via Aspose.Slides for Python via Java het pictogram en de titel instellen.

Deze Python‑code laat zien hoe u de pictogram‑afbeelding en titel voor een ingesloten object instelt:

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)

    # Voeg een afbeelding toe aan de presentatiebronnen.
    image_data = Path("image.png").read_bytes()
    image_data = jpype.JArray(jpype.JByte)(image_data)
    ole_image = presentation.getImages().addImage(image_data)

    # Stel een titel en de afbeelding in voor de OLE-preview.
    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()

Voorkomen dat een OLE‑objectframe wordt aangepast in grootte en positie

Nadat u een gekoppeld OLE‑object aan een presentatiedia hebt toegevoegd, ziet u bij het openen van de presentatie in PowerPoint soms een melding die vraagt de koppelingen bij te werken. Als u op “Update Links” klikt, kan dit de grootte en positie van het OLE‑objectframe wijzigen omdat PowerPoint de gegevens van het gekoppelde OLE‑object ververst en het voorbeeld van het object bijwerkt. Om te voorkomen dat PowerPoint vraagt de gegevens van het object bij te werken, roept u de setUpdateAutomatic‑methode van de OleObjectFrame‑klasse aan met 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()

Ingesloten bestanden extraheren

Aspose.Slides for Python via Java maakt het mogelijk om de bestanden die in dia’s als OLE‑objecten zijn ingesloten op de volgende manier te extraheren:

Maak een instantie van de Presentation‑klasse die de OLE‑objecten bevat die u wilt extraheren.
Loop door alle vormen in de presentatie en benader de OleObjectFrame‑vormen.
Benader de gegevens van de ingesloten bestanden vanuit OLE‑objectframes en schrijf ze naar schijf.

Deze Python‑code laat zien hoe u bestanden die als OLE‑objecten in een dia zijn ingesloten, kunt extraheren:

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

Wordt de OLE‑inhoud gerenderd bij het exporteren van dia’s naar PDF/afbeeldingen?

Wat zichtbaar is op de dia wordt gerenderd – het pictogram/alternatieve beeld (preview). De “live” OLE‑inhoud wordt niet uitgevoerd tijdens het renderen. Indien nodig, stelt u uw eigen preview‑afbeelding in om de verwachte weergave in de geëxporteerde PDF te waarborgen.

Om het ingesloten bestand tevens als PDF‑bijlage te behouden, roept u setIncludeOleData aan met True. Deze optie is standaard uitgeschakeld. Zie een voorbeeld en instructies voor het controleren van de bijlage in Preserve Embedded OLE Files as PDF Attachments.

Hoe kan ik een OLE‑object op een dia vergrendelen zodat gebruikers het niet kunnen verplaatsen/bewerken in PowerPoint?

Vergrendel de vorm: Aspose.Slides biedt vorm‑niveau vergrendelingen. Dit is geen versleuteling, maar voorkomt effectief onbedoelde wijzigingen en verplaatsingen.

Waarom “springt” een gekoppeld Excel‑object of verandert van grootte wanneer ik de presentatie open?

PowerPoint kan de preview van het gekoppelde OLE‑object vernieuwen. Voor een stabiele weergave volgt u de richtlijnen van de Working Solution for Worksheet Resizing – ofwel het frame aanpassen aan het bereik, of het bereik schalen naar een vast frame en een passend substituut‑beeld instellen.

Worden relatieve paden voor gekoppelde OLE‑objecten bewaard in het PPTX‑formaat?

In PPTX is informatie over “relatief pad” niet beschikbaar – alleen het volledige pad. Relatieve paden bestaan in het oudere PPT‑formaat. Voor draagbaarheid geeft u de voorkeur aan betrouwbare absolute paden/toegankelijke URI’s of insluiting.

Beheer mediabestanden in Python via Java Beheer presentatietekst in Python via Java