Pobieranie i aktualizacja właściwości widoku prezentacji w Pythonie za pośrednictwem Java

O czym jest ta strona

Odkryj właściwości widoku Aspose.Slides dla Pythona za pośrednictwem Java, aby dostosować slajdy PPT, PPTX i ODP — zmieniaj układy, poziomy powiększenia i ustawienia wyświetlania.

Wstęp

Widok normalny składa się z trzech obszarów treści: samego slajdu, bocznego obszaru treści oraz dolnego obszaru treści. Właściwości widoku normalnego opisują pozycjonowanie tych obszarów treści. Informacje te umożliwiają aplikacji zapisanie stanu widoku do pliku, tak aby po ponownym otwarciu widok znajdował się w tym samym stanie, w jakim prezentacja została ostatnio zapisana.

Dodano metodę ViewProperties.getNormalViewProperties, aby zapewnić dostęp do właściwości widoku normalnego prezentacji.

Dodano klasy NormalViewProperties i NormalViewRestoredProperties oraz wyliczenie SplitterBarStateType.

O NormalViewProperties

Reprezentuje właściwości widoku normalnego.

Metody getShowOutlineIcons i setShowOutlineIcons określają, czy aplikacja ma wyświetlać ikony przy wyświetlaniu treści konspektu w dowolnym z obszarów treści w trybie widoku normalnego.

Metody getSnapVerticalSplitter i setSnapVerticalSplitter określają, czy pionowy podziałnik ma przełączać się do stanu zminimalizowanego, gdy boczny obszar jest wystarczająco mały.

Metody getPreferSingleView i setPreferSingleView określają, czy użytkownik preferuje widok pełnoekranowego jednego obszaru treści zamiast standardowego widoku normalnego z trzema obszarami treści. Jeśli jest włączone, aplikacja może zdecydować o wyświetleniu jednego z obszarów treści w całym oknie.

Metody getVerticalBarState i getHorizontalBarState określają stan, w jakim ma być wyświetlany poziomy lub pionowy pasek podziału. Poziomy pasek podziału oddziela slajd od obszaru treści pod slajdem; pionowy pasek podziału oddziela slajd od bocznego obszaru treści. Dostępne wartości to: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized oraz SplitterBarStateType.Restored.

Metody getRestoredLeft i getRestoredTop określają rozmiar górnego lub bocznego obszaru slajdu w widoku normalnym, gdy wartość SplitterBarStateType.Restored jest zastosowana do getVerticalBarState i getHorizontalBarState, odpowiednio.

O przywracaniu NormalViewProperties

Określa rozmiar obszaru slajdu (szerokość, gdy jest dzieckiem getRestoredTop, wysokość, gdy jest dzieckiem getRestoredLeft) w widoku normalnym, gdy obszar ma zmienny przywrócony rozmiar (ani zminimalizowany, ani zmaksymalizowany).

Metoda getDimensionSize określa rozmiar obszaru slajdu (szerokość, gdy jest dzieckiem getRestoredTop, wysokość, gdy jest dzieckiem getRestoredLeft).

Metoda getAutoAdjust określa, czy rozmiar bocznego obszaru treści ma kompensować nowy rozmiar przy zmianie rozmiaru okna zawierającego widok w aplikacji.

Poniższy przykład pokazuje, jak uzyskać dostęp do ViewProperties.getNormalViewProperties dla prezentacji.

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)

    # Przywróć właściwości widoku prezentacji.
    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()

Ustaw domyślną wartość powiększenia

Note

Aspose.Slides for Python via Java obsługuje ustawianie domyślnej wartości powiększenia, tak aby była zastosowana już przy otwarciu prezentacji. Można to zrobić, ustawiając ViewProperties prezentacji. getSlideViewProperties oraz getNotesViewProperties można konfigurować programowo. W tym temacie pokażemy na przykładzie, jak ustawić View Properties Presentation w Aspose.Slides.

Aby ustawić właściwości widoku, wykonaj następujące kroki:

1. Utwórz instancję klasy Presentation.
2. Ustaw View Properties Presentation.
3. Zapisz prezentację jako plik PPTX.

W poniższym przykładzie ustawiamy wartość powiększenia zarówno dla widoku slajdu, jak i widoku notatek.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation()
try:
    # Ustaw właściwości widoku prezentacji.
    presentation.getViewProperties().getSlideViewProperties().setScale(100)  # Procent powiększenia dla widoku slajdu.
    presentation.getViewProperties().getNotesViewProperties().setScale(100)  # Procent powiększenia dla widoku notatek.

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

Ustaw odstęp siatki

Użyj Presentation.getViewProperties, aby uzyskać dostęp do ustawień widoku obowiązujących dla całej prezentacji. Metody ViewProperties.getGridSpacing i ViewProperties.setGridSpacing odczytują lub zmieniają odstęp podstawowej siatki edycji. To ustawienie ma zastosowanie do całej prezentacji, a nie do pojedynczego slajdu. Odstęp siatki podawany jest w punktach, przy czym 72 punkty to jeden cal. Użyj wartości dodatniej, zgodnie z wymaganiami dokumentacji API.

Poniższy przykład otwiera istniejący plik demo.pptx, wypisuje aktualny odstęp siatki, ustawia odstęp ćwierć cala i zapisuje wynik.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("demo.pptx")
try:
    grid_spacing = presentation.getViewProperties().getGridSpacing()
    print(f"Current grid spacing: {grid_spacing} points")

    presentation.getViewProperties().setGridSpacing(18.0)
    presentation.save("grid-spacing.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Siatka różni się od drawing guides. Odstęp siatki kontroluje regularny interwał, podczas gdy prowadnice rysunkowe są indywidualnie rozmieszczonymi poziomymi lub pionowymi liniami wyrównania. Dodawanie, przesuwanie lub usuwanie prowadnic nie zmienia odstępu siatki.

Zarówno siatka, jak i prowadnice rysunkowe są pomocnikami edycji. Nie są renderowane jako treść slajdu w PDF, obrazach, SVG ani w pokazie slajdów. Przechowywanie odstępu siatki nie gwarantuje, że edytor wyświetli siatkę: jej widoczność zależy również od preferencji przeglądarki lub edytora.

Pokaż lub ukryj komentarze przy otwieraniu prezentacji

Użyj Presentation.getViewProperties, aby uzyskać dostęp do ustawień widoku obowiązujących dla całej prezentacji. Użyj ViewProperties.getShowComments i ViewProperties.setShowComments, aby odczytać lub zmienić zapisaną preferencję dotyczącą wyświetlania komentarzy przy otwieraniu prezentacji w PowerPoint lub innym kompatybilnym edytorze.

To ustawienie kontroluje tylko zapisaną preferencję widoku. Nie dodaje, nie usuwa, nie edytuje ani nie rozwiązuje komentarzy. Ukrywanie komentarzy zachowuje ich treść, autorów, pozycje, odpowiedzi i statusy. Zobacz Presentation Comments po informacje o operacjach zmieniających same komentarze.

Poniższy przykład wymaga istniejącego pliku comments.pptx zawierającego komentarze. Wypisuje aktualne ustawienie widoczności, żąda ukrycia komentarzy i zapisuje nowy plik PPTX bez usuwania żadnych komentarzy. Używa także ViewProperties.setLastView wraz z ViewType.SlideView, aby skonfigurować początkowy widok edycji razem z widocznością komentarzy.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import NullableBool, Presentation, SaveFormat, ViewType

presentation = Presentation("comments.pptx")
try:
    show_comments = presentation.getViewProperties().getShowComments()
    print(f"Current comment visibility: {show_comments}")

    presentation.getViewProperties().setShowComments(NullableBool.False_)
    presentation.getViewProperties().setLastView(ViewType.SlideView)
    presentation.save("comments-hidden.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

To ustawienie nie decyduje o tym, czy komentarze są uwzględniane w eksportach do PDF, HTML, obrazu, notatek lub materiałów rozdawczych. Konfiguruj odpowiednie opcje specyficzne dla eksportu osobno.

FAQ

Dlaczego siatka nie jest widoczna po ponownym otwarciu prezentacji?

Plik przechowuje odstęp siatki, ale to edytor decyduje, czy siatka jest wyświetlana. Sprawdź ustawienia widoczności siatki w edytorze.

Czy usunięcie prowadnic rysunkowych zmienia odstęp siatki?

Nie. Prowadnice rysunkowe i odstęp siatki to odrębne ustawienia. Usunięcie prowadnic nie zmienia zapisanego interwału siatki.

Czy mogę ustawić różne ustawienia widoku dla różnych sekcji prezentacji?

View settings są definiowane na poziomie prezentacji (Normal View/Slide View), a nie dla poszczególnych sekcji, więc jeden zestaw parametrów obowiązuje dla całego dokumentu po jego otwarciu.

Czy mogę zdefiniować różne stany widoku dla różnych użytkowników?

Nie. Ustawienia są przechowywane w pliku i są współdzielone. Aplikacje przeglądające mogą uwzględniać preferencje użytkownika, ale sam plik zawiera jeden zestaw właściwości widoku.

Czy mogę przygotować szablon z wstępnie zdefiniowanymi View Properties, aby nowe prezentacje otwierały się w ten sam sposób?

Tak. Ponieważ view properties są przechowywane na poziomie prezentacji, możesz osadzić je w szablonie i tworzyć z niego nowe dokumenty z taką samą początkową konfiguracją widoku.