Pobierz i zaktualizuj właściwości widoku prezentacji w Javie

Wprowadzenie

Widok normalny składa się z trzech regionów treści: samego slajdu, bocznego regionu treści oraz dolnego regionu treści. Właściwości dotyczące pozycjonowania różnych regionów treści. Informacje te umożliwiają aplikacji zapisanie stanu widoku do pliku, tak aby po ponownym otwarciu widok znajdował się w takim samym stanie, w jakim prezentacja została ostatnio zapisana.

Metoda IViewProperties.getNormalViewProperties została dodana, aby zapewnić dostęp do właściwości widoku normalnego prezentacji.

INormalViewProperties, INormalViewRestoredProperties interfejsy oraz ich pochodne, enum SplitterBarStateType zostały dodane.

O INormalViewProperties

Reprezentuje właściwości widoku normalnego.

Metody getShowOutlineIcons i setShowOutlineIcons określają, czy aplikacja powinna wyświetlać ikony podczas wyświetlania zawartości konspektu w którymkolwiek z regionów treści w trybie widoku normalnego.

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

Właściwość getPreferSingleView i setPreferSingleView określa, czy użytkownik woli widok pełnoekranowego jednego regionu treści zamiast standardowego widoku normalnego z trzema regionami treści. Jeśli włączone, aplikacja może wyświetlić jeden z regionów treści na całym ekranie.

Metody getVerticalBarState i getHorizontalBarState określają stan, w jakim powinna być wyświetlana pozioma lub pionowa belka rozdzielacza. Pozioma belka rozdzielacza oddziela slajd od regionu treści pod slajdem, pionowa belka rozdzielacza oddziela slajd od bocznego regionu treści. Dostępne wartości to: SplitterBarStateType.Minimized, SplitterBarStateType.Maximized oraz SplitterBarStateType.Restored.

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

O przywracaniu INormalViewProperties

Określa wymiary regionu slajdu (szerokość, gdy jest potomkiem getRestoredTop, wysokość, gdy jest potomkiem getRestoredLeft) w widoku normalnym, gdy region ma zmienny przywrócony rozmiar (niezminimalizowany ani nie zmaksymalizowany).

Metoda getDimensionSize określa rozmiar regionu slajdu (szerokość, gdy jest potomkiem restoredTop, wysokość, gdy jest potomkiem restoredLeft).

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

Poniżej podano przykład, który pokazuje, jak uzyskać dostęp do właściwości ViewProperties.getNormalViewProperties dla prezentacji.

import com.aspose.slides.*;

Presentation pres = new Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
    
    // Przywróć właściwości widoku prezentacji
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
    pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
    pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);

    pres.save("presentation_normal_view_state.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Ustaw domyślną wartość przybliżenia

Aby ustawić właściwości widoku, wykonaj poniższe kroki:

  1. Utwórz instancję klasy Presentation.
  2. Ustaw View Properties dla Presentation.
  3. Zapisz prezentację jako plik PPTX. W poniższym przykładzie ustawiliśmy wartość przybliżenia dla widoku slajdu oraz widoku notatek.
import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    // Ustawianie właściwości widoku prezentacji
    presentation.getViewProperties().getSlideViewProperties().setScale(100); // Wartość przybliżenia w procentach dla widoku slajdu
    presentation.getViewProperties().getNotesViewProperties().setScale(100); // Wartość przybliżenia w procentach 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 obejmujących całą prezentację. Metody IViewProperties.getGridSpacing i IViewProperties.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, gdzie 72 punkty to jeden cal. Użyj wartości dodatniej, zgodnie z dokumentacją API.

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

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("demo.pptx");
try {
    float gridSpacing = presentation.getViewProperties().getGridSpacing();
    System.out.println("Current grid spacing: " + gridSpacing + " points");

    presentation.getViewProperties().setGridSpacing(18f);
    presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

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

Pokaż lub ukryj komentarze przy otwieraniu prezentacji

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

To ustawienie kontroluje jedynie przechowywaną 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 aby dowiedzieć się o operacjach zmieniających same komentarze.

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

import com.aspose.slides.NullableBool;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ViewType;

Presentation presentation = new Presentation("comments.pptx");
try {
    byte showComments = presentation.getViewProperties().getShowComments();
    System.out.println("Current comment visibility: " + showComments);

    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 rozdawniczych. 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 niezależne ustawienia. Usunięcie prowadnic nie zmienia przechowywanego interwału siatki.

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

Ustawienia widoku 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 otwarciu.

Czy mogę z góry określić 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ą respektować preferencje użytkownika, ale sam plik zawiera jedną zestaw właściwości widoku.

Czy mogę przygotować szablon z wstępnie zdefiniowanymi właściwościami widoku, aby nowe prezentacje otwierały się w ten sam sposób?

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