Abrufen und Aktualisieren von Präsentationsansichtseigenschaften in Python via Java
Einleitung
Die Normalansicht besteht aus drei Inhaltsbereichen: der Folie selbst, einem seitlichen Inhaltsbereich und einem unteren Inhaltsbereich. Normalansichtseigenschaften beschreiben die Positionierung dieser Inhaltsbereiche. Diese Informationen ermöglichen es der Anwendung, ihren Ansichtszustand in der Datei zu speichern, sodass beim erneuten Öffnen die Ansicht im gleichen Zustand ist, in dem die Präsentation zuletzt gespeichert wurde.
Die Methode ViewProperties.getNormalViewProperties wurde hinzugefügt, um Zugriff auf die Normalansichtseigenschaften einer Präsentation zu ermöglichen.
Die Klassen NormalViewProperties und NormalViewRestoredProperties sowie die Aufzählung SplitterBarStateType wurden hinzugefügt.
Über NormalViewProperties
Stellt Normalansichtseigenschaften dar.
Die Methoden getShowOutlineIcons und setShowOutlineIcons geben an, ob die Anwendung Symbole anzeigen soll, wenn Gliederungsinhalte in einem der Inhaltsbereiche des Normalansichtsmodus angezeigt werden.
Die Methoden getSnapVerticalSplitter und setSnapVerticalSplitter legen fest, ob der vertikale Trenner in einen minimierten Zustand einrasten soll, wenn der Seitenbereich ausreichend klein ist.
Die Methoden getPreferSingleView und setPreferSingleView geben an, ob der Benutzer es bevorzugt, einen einzelnen Inhaltsbereich im Vollbildfenster zu sehen, anstatt der Standard‑Normalansicht mit drei Inhaltsbereichen. Ist dies aktiviert, kann die Anwendung wählen, einen der Inhaltsbereiche im gesamten Fenster anzuzeigen.
Die Methoden getVerticalBarState und getHorizontalBarState geben den Zustand an, in dem die horizontale bzw. vertikale Trennleiste angezeigt werden soll. Eine horizontale Trennleiste trennt die Folie vom darunter liegenden Inhaltsbereich; eine vertikale Trennleiste trennt die Folie vom seitlichen Inhaltsbereich. Mögliche Werte sind: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized und SplitterBarStateType.Restored.
Die Methoden getRestoredLeft und getRestoredTop geben die Größe des oberen bzw. seitlichen Folienbereichs der Normalansicht an, wenn der Wert SplitterBarStateType.Restored auf getVerticalBarState bzw. getHorizontalBarState angewendet wird.
Über das Wiederherstellen von NormalViewProperties
Gibt die Größe des Folienbereichs (Breite, wenn ein Kind von getRestoredTop, Höhe, wenn ein Kind von getRestoredLeft) der Normalansicht an, wenn der Bereich eine variable wiederhergestellte Größe hat (weder minimiert noch maximiert).
Die Methode getDimensionSize gibt die Größe des Folienbereichs an (Breite, wenn ein Kind von getRestoredTop, Höhe, wenn ein Kind von getRestoredLeft).
Die Methode getAutoAdjust gibt an, ob die Größe des seitlichen Inhaltsbereichs die neue Größe ausgleichen soll, wenn das Fenster, das die Ansicht enthält, innerhalb der Anwendung neu skaliert wird.
Das folgende Beispiel zeigt, wie man ViewProperties.getNormalViewProperties für eine Präsentation aufruft.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat, SplitterBarStateType
presentation = Presentation()
try:
normal_view_properties = presentation.getViewProperties().getNormalViewProperties()
normal_view_properties.setHorizontalBarState(SplitterBarStateType.Restored)
normal_view_properties.setVerticalBarState(SplitterBarStateType.Maximized)
# Wiederherstellen der Ansichtseigenschaften der Präsentation.
normal_view_properties.getRestoredTop().setAutoAdjust(True)
normal_view_properties.getRestoredTop().setDimensionSize(80)
normal_view_properties.setShowOutlineIcons(True)
presentation.save("presentation_normal_view_state.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Standard-Zoom-Wert festlegen
Note
Aspose.Slides für Python via Java unterstützt das Festlegen des Standard‑Zoom‑Werts, sodass er bereits beim Öffnen der Präsentation angewendet wird. Dies kann erreicht werden, indem die ViewProperties einer Präsentation gesetzt wird. getSlideViewProperties sowie getNotesViewProperties können programmgesteuert konfiguriert werden. In diesem Thema zeigen wir anhand eines Beispiels, wie man die View Properties von Presentation in Aspose.Slides festlegt.So setzen Sie die Ansichtseigenschaften, gehen Sie wie folgt vor:
- Erstellen Sie eine Instanz der Klasse Presentation.
- Setzen Sie die View Properties von Presentation.
- Speichern Sie die Präsentation als PPTX-Datei.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import Presentation, SaveFormat
presentation = Presentation()
try:
# Ansichtseigenschaften der Präsentation festlegen.
presentation.getViewProperties().getSlideViewProperties().setScale(100) # Zoom-Prozentsatz für die Folienansicht.
presentation.getViewProperties().getNotesViewProperties().setScale(100) # Zoom-Prozentsatz für die Notizenansicht.
presentation.save("Zoom_out.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
FAQ
Kann ich unterschiedliche Ansichtseinstellungen für verschiedene Abschnitte einer Präsentation festlegen?
View settings werden auf Presentation‑Ebene definiert (Normal View/Slide View), nicht pro Abschnitt, sodass ein einziger Parametersatz beim Öffnen für das gesamte Dokument gilt.
Kann ich unterschiedliche Ansichts‑Zustände für verschiedene Benutzer vordefinieren?
Nein. Die Einstellungen werden in der Datei gespeichert und sind gemeinsam nutzbar. Viewer‑Anwendungen können Benutzerpräferenzen berücksichtigen, aber die Datei selbst enthält nur einen Satz von Ansichtseigenschaften.
Kann ich eine Vorlage mit vordefinierten Ansichtseigenschaften erstellen, sodass neue Präsentationen gleich geöffnet werden?
Ja. Da view properties auf Presentation‑Ebene gespeichert werden, können Sie sie in einer Vorlage einbetten und daraus neue Dokumente mit derselben anfänglichen Ansichtskonfiguration erzeugen.