Zoom in Python über Java verwalten
Einführung
PowerPoint-Zooms ermöglichen es Ihnen, während einer Bildschirmpräsentation zwischen bestimmten Folien und Abschnitten zu navigieren. Mit Aspose.Slides für Python über Java können Sie Folien-, Abschnitts- und Zusammenfassungs-Zooms erstellen und deren Vorschauen, Rahmen und Übergänge anpassen.

- Um die gesamte Präsentation auf einer einzigen Folie zusammenzufassen, verwenden Sie einen Zusammenfassungs-Zoom.
- Um nur ausgewählte Folien anzuzeigen, verwenden Sie einen Folien-Zoom.
- Um nur einen einzelnen Abschnitt anzuzeigen, verwenden Sie einen Abschnitts-Zoom.
Folien-Zoom
Ein Folien-Zoom kann Ihre Präsentation dynamischer machen, indem er Ihnen erlaubt, frei zwischen Folien in beliebiger Reihenfolge zu navigieren, ohne den Ablauf Ihrer Präsentation zu unterbrechen. Folien-Zooms eignen sich hervorragend für kurze Präsentationen ohne viele Abschnitte, können jedoch auch in verschiedenen Präsentationsszenarien verwendet werden.
Folien-Zooms ermöglichen es Ihnen, verwandte Informationen von einer einzigen Übersichtsfolie aus zu erkunden.

Für Folien-Zoom-Objekte stellt Aspose.Slides die Aufzählung ZoomImageType die Klasse ZoomFrame und Methoden der Klasse ShapeCollection bereit.
Zoom-Frames erstellen
Verwenden Sie ShapeCollection.addZoomFrame, um Links zu einzelnen Folien auf einer Übersichtsfolie zu platzieren. Dieses Beispiel erstellt zwei Ziel-Folien mit unterschiedlichen Hintergründen und Beschriftungen, fügt dann eine Vorschau jeder Folie zur ersten Folie hinzu und speichert die Präsentation als PPTX. Rahmen-Positionen und -Abmessungen werden in Punkten angegeben.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
second_slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
third_slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
second_slide.getBackground().setType(BackgroundType.OwnBackground)
second_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
second_slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.CYAN)
text_box = second_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 500, 200)
text_box.getTextFrame().setText("Second Slide")
third_slide.getBackground().setType(BackgroundType.OwnBackground)
third_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
third_slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(189, 183, 107))
text_box = third_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 500, 200)
text_box.getTextFrame().setText("Third Slide")
overview_slide.getShapes().addZoomFrame(20, 20, 250, 200, second_slide)
overview_slide.getShapes().addZoomFrame(200, 250, 250, 200, third_slide)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Zoom-Frames mit benutzerdefinierten Bildern erstellen
Übergeben Sie ein benutzerdefiniertes Bild an ShapeCollection.addZoomFrame, um die Standard-Vorschau der Ziel-Folie zu ersetzen. Dieses Beispiel erfordert ein lokales Bild, lädt es mit Images.fromFile, und fügt es der Präsentation über ImageCollection.addImage hinzu. Der resultierende Rahmen zeigt dieses Bild an, während er weiterhin auf die zweite Folie verlinkt.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Images, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().setType(BackgroundType.OwnBackground)
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.CYAN)
text_box = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 500, 200)
text_box.getTextFrame().setText("Second Slide")
image = Images.fromFile("image.png")
try:
preview_image = presentation.getImages().addImage(image)
finally:
image.dispose()
overview_slide.getShapes().addZoomFrame(20, 20, 300, 200, slide, preview_image)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Zoom-Frames formatieren
Dieses Beispiel passt zwei Folien-Zoom-Frames an. Es weist dem ersten Frame ein lokales Bild über ZoomObject.setZoomImage zu und gibt dem zweiten Frame einen fünf Punkt breiten, strich-punkt-gestrichelten pinken Rahmen über Shape.getLineFormat. Das Übergeben von False an ZoomObject.setShowBackground blendet den Hintergrund des zweiten Frames aus. Ein lokales Bild ist für die benutzerdefinierte Vorschau erforderlich; beide Frames behalten ihre Folien-Ziele in der gespeicherten PPTX bei.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Images, LineDashStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
second_slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
third_slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
second_slide.getBackground().setType(BackgroundType.OwnBackground)
second_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
second_slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.CYAN)
text_box = second_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 500, 200)
text_box.getTextFrame().setText("Second Slide")
third_slide.getBackground().setType(BackgroundType.OwnBackground)
third_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
third_slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(189, 183, 107))
text_box = third_slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 200, 500, 200)
text_box.getTextFrame().setText("Third Slide")
first_zoom_frame = overview_slide.getShapes().addZoomFrame(20, 20, 250, 200, second_slide)
second_zoom_frame = overview_slide.getShapes().addZoomFrame(200, 250, 250, 200, third_slide)
image = Images.fromFile("image.png")
try:
preview_image = presentation.getImages().addImage(image)
finally:
image.dispose()
first_zoom_frame.setZoomImage(preview_image)
second_zoom_frame.getLineFormat().setWidth(5)
second_zoom_frame.getLineFormat().getFillFormat().setFillType(FillType.Solid)
second_zoom_frame.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color(255, 105, 180))
second_zoom_frame.getLineFormat().setDashStyle(LineDashStyle.DashDot)
second_zoom_frame.setShowBackground(False)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Abschnitts-Zoom
Ein Abschnitts-Zoom verlinkt zu einem Abschnitt Ihrer Präsentation. Verwenden Sie ihn, um ein Thema erneut zu besuchen oder zu zeigen, wie verschiedene Teile der Präsentation zusammenhängen.

Für Abschnitts-Zoom-Objekte stellt Aspose.Slides die Klasse SectionZoomFrame sowie Methoden der Klasse ShapeCollection bereit.
Abschnitts-Zoom-Frames erstellen
Erstellen Sie einen Abschnitt mit SectionCollection.addSection, und übergeben Sie den zurückgegebenen Abschnitt an ShapeCollection.addSectionZoomFrame. Dieses Beispiel platziert einen Abschnitts-Zoom auf der ersten Folie und verlinkt ihn zu einem Abschnitt, der mit einer farbigen Folie beginnt. Die Position und Abmessungen des Frames werden in Punkten angegeben, und die Präsentation wird als PPTX gespeichert.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(154, 205, 50))
slide.getBackground().setType(BackgroundType.OwnBackground)
section = presentation.getSections().addSection("Section 1", slide)
section_zoom_frame = overview_slide.getShapes().addSectionZoomFrame(20, 20, 300, 200, section)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Abschnitts-Zoom-Frames mit benutzerdefinierten Bildern erstellen
Die Bild-Überladung von ShapeCollection.addSectionZoomFrame ermöglicht es Ihnen, eine benutzerdefinierte Vorschau anzuzeigen, ohne den Zielabschnitt zu ändern. Dieses Beispiel erfordert ein lokales Bild, das mit Images.fromFile geladen und über ImageCollection.addImage hinzugefügt wird. Die gespeicherte Präsentation enthält einen Abschnitts-Zoom auf der ersten Folie, der mit dem neu erstellten Abschnitt verknüpft ist.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Images, Presentation, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(154, 205, 50))
slide.getBackground().setType(BackgroundType.OwnBackground)
image = Images.fromFile("image.png")
try:
preview_image = presentation.getImages().addImage(image)
finally:
image.dispose()
section = presentation.getSections().addSection("Section 1", slide)
section_zoom_frame = overview_slide.getShapes().addSectionZoomFrame(20, 20, 300, 200, section, preview_image)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Zielabschnitt eines Abschnitts-Zooms ändern
Verwenden Sie SectionZoomFrame.setTargetSection, um einen bestehenden Abschnitts-Zoom umzuleiten, ohne ihn neu zu erstellen. Wählen Sie einen gefüllten Abschnitt aus der Presentation.getSections-Sammlung derselben Präsentation. Das Zuweisen eines leeren Abschnitts lässt das aktuelle Ziel unverändert, prüfen Sie daher Section.getSlidesListOfSection bevor Sie es zuweisen. Siehe Abschnitte verwalten für weitere Informationen zu Abschnitten.
Das folgende Beispiel lädt eine Präsentationsdatei, die mehrere gefüllte Abschnitte, einen bestehenden Abschnitts-Zoom mit dem Namen Section navigation und einen Abschnitt mit dem eindeutigen Namen Results enthalten muss. Es durchsucht alle Folien nach dem Zoom und findet das Ziel anhand des Namens anstatt eines Sammlungs-Index, der sich ändern kann, wenn Abschnitte neu geordnet werden. Wenn Namen nicht eindeutig sind, verwenden Sie Section.getSectionId, um das Ziel stattdessen zu ermitteln.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SectionZoomFrame
presentation = Presentation("section-zoom.pptx")
try:
zoom = None
for slide in presentation.getSlides():
for shape in slide.getShapes():
if isinstance(shape, SectionZoomFrame) and shape.getName() == "Section navigation":
zoom = shape
break
if zoom is not None:
break
target_section = None
for section in presentation.getSections():
if section.getName() == "Results":
target_section = section
break
if zoom is None or target_section is None:
print("The section zoom or destination section was not found.")
elif target_section.getSlidesListOfSection().size() == 0:
print("The destination section is empty.")
else:
current_section = zoom.getTargetSection()
current_name = "" if current_section is None else current_section.getName()
print("Current section: " + str(current_name))
zoom.setTargetSection(target_section)
presentation.save("section-zoom-updated.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Abschnitts-Zoom-Frames formatieren
Dieses Beispiel verschiebt und skaliert einen Abschnitts-Zoom auf 100 × 75 Punkte, weist über ZoomObject.setZoomImage ein lokales Bild zu und wendet einen 2,5 Punkt breiten, strich-punkt-gestrichelten braunen Rahmen an. Es aktiviert ZoomObject.setReturnToParent, um nach dem Abschnitt zur Ausgangs-Folie zurückzukehren, deaktiviert ZoomObject.setShowBackground, und setzt ZoomObject.setTransitionDuration auf 1,5 Sekunden. Ein lokales Bild ist für die benutzerdefinierte Vorschau erforderlich.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Images, LineDashStyle, Presentation, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(154, 205, 50))
slide.getBackground().setType(BackgroundType.OwnBackground)
section = presentation.getSections().addSection("Section 1", slide)
section_zoom_frame = overview_slide.getShapes().addSectionZoomFrame(20, 20, 300, 200, section)
section_zoom_frame.setX(100)
section_zoom_frame.setY(300)
section_zoom_frame.setWidth(100)
section_zoom_frame.setHeight(75)
image = Images.fromFile("image.png")
try:
preview_image = presentation.getImages().addImage(image)
finally:
image.dispose()
section_zoom_frame.setZoomImage(preview_image)
section_zoom_frame.setReturnToParent(True)
section_zoom_frame.setShowBackground(False)
section_zoom_frame.getLineFormat().getFillFormat().setFillType(FillType.Solid)
section_zoom_frame.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color(165, 42, 42))
section_zoom_frame.getLineFormat().setDashStyle(LineDashStyle.DashDot)
section_zoom_frame.getLineFormat().setWidth(2.5)
section_zoom_frame.setTransitionDuration(1.5)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Zusammenfassungs-Zoom
Ein Zusammenfassungs-Zoom bietet einen Überblick über die Abschnitte einer Präsentation. Während einer Bildschirmpräsentation können Sie ihn verwenden, um zu einem Abschnitt zu springen, weiterzublättern oder ein Thema erneut zu besuchen, ohne der Folienreihenfolge zu folgen.

Für Zusammenfassungs-Zoom-Objekte stellt Aspose.Slides die Klassen SummaryZoomFrame, SummaryZoomSection, und SummaryZoomSectionCollection sowie Methoden der Klasse ShapeCollection bereit.
Zusammenfassungs-Zoom erstellen
Verwenden Sie ShapeCollection.addSummaryZoomFrame, um einen Überblick über die Abschnitte der Präsentation zu erstellen. Dieses Beispiel erstellt vier Abschnitte mit unterschiedlichen Folien-Hintergründen und fügt einen Zusammenfassungs-Zoom zur ersten Folie hinzu. Die Position und Abmessungen des Frames werden in Punkten angegeben, und der resultierende Überblick wird in einer PPTX-Präsentation gespeichert.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(165, 42, 42))
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 1", slide)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.CYAN)
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 2", slide)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(127, 255, 0))
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 3", slide)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(0, 100, 0))
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 4", slide)
summary_zoom_frame = overview_slide.getShapes().addSummaryZoomFrame(150, 50, 300, 200)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Eine Zusammenfassungs-Zoom-Sektion hinzufügen und entfernen
Ein Zusammenfassungs-Zoom speichert seine SummaryZoomSection-Objekte in SummaryZoomFrame.getSummaryZoomCollection. Dieses Beispiel erstellt einen Überblick über zwei Abschnitte, fügt über SummaryZoomSectionCollection.addSummaryZoomSection einen dritten Abschnitt hinzu und entfernt den Eintrag des ersten Abschnitts mittels SummaryZoomSectionCollection.removeSummaryZoomSection. Das Entfernen des Eintrags lässt den Präsentations-Abschnitt und dessen Folien unverändert.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(165, 42, 42))
slide.getBackground().setType(BackgroundType.OwnBackground)
first_section = presentation.getSections().addSection("Section 1", slide)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.CYAN)
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 2", slide)
summary_zoom_frame = overview_slide.getShapes().addSummaryZoomFrame(150, 50, 300, 200)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(127, 255, 0))
slide.getBackground().setType(BackgroundType.OwnBackground)
third_section = presentation.getSections().addSection("Section 3", slide)
summary_zoom_frame.getSummaryZoomCollection().addSummaryZoomSection(third_section)
summary_zoom_frame.getSummaryZoomCollection().removeSummaryZoomSection(first_section)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Zusammenfassungs-Zoom-Sektionen formatieren
Dieses Beispiel formatiert den ersten Eintrag in SummaryZoomFrame.getSummaryZoomCollection, wobei der nullbasierte Index 0 verwendet wird. Es erfordert ein lokales Bild für ZoomObject.setZoomImage, wendet einen 1,5 Punkt breiten, strich-punkt-gestrichelten schwarzen Rahmen an und setzt ZoomObject.setTransitionDuration auf 1,5 Sekunden. Das Übergeben von False an ZoomObject.setReturnToParent deaktiviert die automatische Rückkehr zur Zusammenfassungs-Folien für diesen Eintrag.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import BackgroundType, FillType, Images, LineDashStyle, Presentation, SaveFormat
from java.awt import Color
presentation = Presentation()
try:
overview_slide = presentation.getSlides().get_Item(0)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color(165, 42, 42))
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 1", slide)
slide = presentation.getSlides().addEmptySlide(overview_slide.getLayoutSlide())
slide.getBackground().getFillFormat().setFillType(FillType.Solid)
slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.CYAN)
slide.getBackground().setType(BackgroundType.OwnBackground)
presentation.getSections().addSection("Section 2", slide)
summary_zoom_frame = overview_slide.getShapes().addSummaryZoomFrame(150, 50, 300, 200)
summary_section = summary_zoom_frame.getSummaryZoomCollection().get_Item(0)
image = Images.fromFile("image.png")
try:
preview_image = presentation.getImages().addImage(image)
finally:
image.dispose()
summary_section.setZoomImage(preview_image)
summary_section.setReturnToParent(False)
summary_section.getLineFormat().getFillFormat().setFillType(FillType.Solid)
summary_section.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
summary_section.getLineFormat().setDashStyle(LineDashStyle.DashDot)
summary_section.getLineFormat().setWidth(1.5)
summary_section.setTransitionDuration(1.5)
presentation.save("presentation.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
FAQ
Kann ich die Rückkehr zur „Eltern‑“Folien nach Anzeige des Ziels steuern?
Ja. Rufen Sie ZoomObject.setReturnToParent mit True auf, um nach Anzeige des Zielinhalts zur Ausgangs-Folie zurückzukehren.
Kann ich die „Geschwindigkeit“ oder Dauer des Zoom-Übergangs anpassen?
Ja. Verwenden Sie ZoomObject.setTransitionDuration, um die Übergangsdauer in Sekunden zu steuern.
Gibt es Beschränkungen, wie viele Zoom-Objekte eine Präsentation enthalten kann?
Es gibt keine dokumentierte harte API-Grenze. Praktische Grenzen hängen von der Gesamtkomplexität der Präsentation und der Leistung des Betrachters ab. Sie können viele Zoom-Frames hinzufügen, sollten jedoch Dateigröße und Renderzeit berücksichtigen.