Pobieranie i aktualizacja właściwości widoku prezentacji na Androidzie

O czym jest ta strona

Odkryj właściwości widoku Aspose.Slides dla Androida przy użyciu Java, aby dostosować formaty slajdów PPT, PPTX i ODP — regulować układy, poziomy przybliżenia i ustawienia wyświetlania.

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 rozmieszczenia poszczególnych regionów zawartości. Informacje te pozwalają aplikacji zapisać stan widoku do pliku, tak aby po ponownym otwarciu widok był w tym samym stanie, w jakim prezentacja była ostatnio zapisana.

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

Dodano interfejsy INormalViewProperties, INormalViewRestoredProperties oraz ich pochodne, a także wyliczenie SplitterBarStateType.

O INormalViewProperties

Reprezentuje właściwości widoku normalnego.

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

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

Właściwości getPreferSingleView i setPreferSingleView określają, czy użytkownik preferuje pełnoekranowy jednorodny region zawartości 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 na całym ekranie.

Metody getVerticalBarState i getHorizontalBarState określają stan, w jakim powinien być wyświetlany odpowiednio pionowy lub poziomy pasek dzielnika. Poziomy pasek dzielnika oddziela slajd od regionu zawartości pod slajdem, pionowy pasek dzielnika 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ą rozmiar 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 rozmiar regionu slajdu (szerokość, gdy jest potomkiem getRestoredTop, wysokość, gdy jest potomkiem getRestoredLeft) w widoku normalnym, gdy region ma zmienny rozmiar przywrócony (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 przykład 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

Aspose.Slides for Android via Java obsługuje teraz ustawianie domyślnej wartości przybliżenia dla prezentacji, tak aby po otwarciu prezentacji przybliżenie było już ustawione. Można to zrobić, ustawiając ViewProperties prezentacji. getSlideViewProperties oraz getNotesViewProperties mogą być ustawione programowo. W tym temacie zobaczymy 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.
   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 obowiązujących w całej prezentacji. Metody IViewProperties.getGridSpacing i IViewProperties.setGridSpacing odczytują lub zmieniają interwał podstawowej siatki edycji. To ustawienie obowiązuje całą prezentację, a nie pojedynczy slajd. Odstęp siatki jest podawany w punktach, gdzie 72 punkty równa się jednemu calowi. Używaj 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 interwał ć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ł, podczas gdy prowadnice są indywidualnie rozmieszczonymi liniami wyrównania poziomymi lub pionowymi. Dodawanie, przenoszenie lub usuwanie prowadnic nie zmienia odstępu siatki.

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

Pokaż lub ukryj komentarze przy otwieraniu prezentacji

Użyj Presentation.getViewProperties aby uzyskać dostęp do ustawień widoku obowiązujących w całej prezentacji. 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 nastawienie 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 poznać operacje zmieniające same komentarze.

Poniższy przykład wymaga istniejącego pliku comments.pptx zawierającego komentarze. Wyświetla bieżące ustawienie widoczności, żąda ukrycia komentarzy i zapisuje nowy plik PPTX bez usuwania jakichkolwiek komentarzy. Używa również 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 określa, czy komentarze są uwzględniane w eksportach do PDF, HTML, obrazów, notatek czy 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 o tym, czy siatka jest wyświetlana. Sprawdź ustawienia widoczności siatki w edytorze.

Czy usunięcie prowadnic zmienia odstęp siatki?

Nie. Prowadnice i odstęp siatki to niezależne ustawienia. Usunięcie prowadnic pozostawia przechowywany interwał siatki niezmieniony.

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

Ustawienia View settings są definiowane na poziomie prezentacji (Normal View/Slide View), nie per sekcja, więc pojedynczy zestaw parametrów obowiązuje dla całego dokumentu po 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 określonymi właściwościami widoku, 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.