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

Wstęp

Widok normalny składa się z trzech regionów zawartości: samego slajdu, bocznego regionu zawartości oraz dolnego regionu zawartości. Właściwości dotyczące pozycjonowania różnych regionów zawartości. Ta informacja pozwala aplikacji zapisać stan widoku do pliku, tak aby po ponownym otwarciu widok był w tym samym stanie, w jakim prezentacja została ostatnio zapisana.

Dodano metodę ViewProperties::getNormalViewProperties umożliwiającą dostęp do właściwości widoku normalnego prezentacji.

Dodano klasy NormalViewProperties, NormalViewRestoredProperties, ich pochodne oraz enum SplitterBarStateType enum have been added.

O INormalViewProperties

Reprezentuje właściwości widoku normalnego.

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

Metody getSnapVerticalSplitter i setSnapVerticalSplitter określają, czy pionowy podziałnik powinien przeskoczyć do stanu zminimalizowanego, gdy boczny region jest wystarczająco mały.

Właściwości getPreferSingleView i setPreferSingleView określają, czy użytkownik woli widzieć pojedynczy region zawartości na pełnym ekranie zamiast standardowego widoku normalnego z trzema regionami zawartości. Jeśli jest włączone, aplikacja może wyświetlić jeden z regionów zawartości w całym oknie.

Metody getVerticalBarState i getHorizontalBarState określają stan, w jakim ma być wyświetlany pasek podziału poziomego lub pionowego. Pasek podziału poziomego oddziela slajd od regionu zawartości poniżej slajdu, pasek podziału pionowego oddziela slajd od bocznego regionu zawartości. Możliwe 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 niezmaksymalizowany).

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 zawartości powinien kompensować nowy rozmiar przy zmianie rozmiaru okna zawierającego widok w aplikacji

Poniżej podany jest przykład pokazujący, jak uzyskać dostęp do właściwości ViewProperties::getNormalViewProperties prezentacji.

  $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ść powiększenia

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

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 file. W poniższym przykładzie ustawiono wartość powiększenia dla widoku slajdu oraz widoku notatek.

  $presentation = new Presentation();
  try {
    # Ustawianie właściwości widoku prezentacji
    $presentation->getViewProperties()->getSlideViewProperties()->setScale(100); // Wartość powiększenia w procentach dla widoku slajdu
    $presentation->getViewProperties()->getNotesViewProperties()->setScale(100); // Wartość powiększenia w procentach dla widoku notatek

    $presentation->save("Zoom_out.pptx", SaveFormat::Pptx);
  } finally {
    $presentation->dispose();
  }

FAQ

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 pojedynczy zestaw parametrów ma zastosowanie do 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 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.