Pobieranie i aktualizacja właściwości widoku prezentacji w JavaScript

O czym jest ta strona

Odkryj Aspose.Slides dla Node.js poprzez właściwości widoku w Java, aby dostosować formaty slajdów PPT, PPTX i ODP — modyfikować układy, poziomy powiększenia i ustawienia wyświetlania.

Wprowadzenie

Normalny widok 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 poszczególnych regionów zawartości. Te informacje pozwalają aplikacji zapisać stan widoku w pliku, tak aby po ponownym otwarciu widok znajdował się w tym samym stanie, w którym prezentacja została ostatnio zapisana.

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

NormalViewProperties, NormalViewRestoredProperties klasy i ich pochodne, SplitterBarStateType wyliczenie zostały dodane.

O NormalViewProperties

Reprezentuje właściwości normalnego widoku.

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 normalnego widoku.

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 preferuje pełnoekranowy jednorodnikowy region zawartości zamiast standardowego normalnego widoku z trzema regionami zawartości. Jeśli włączone, aplikacja może wyświetlić jeden z regionów zawartości na całym oknie.

Metody getVerticalBarState i getHorizontalBarState określają stan, w jakim pasek rozdzielacza powinien być wyświetlany. Pionowy pasek rozdzielacza oddziela slajd od bocznego regionu zawartości, poziomy pasek rozdzielacza oddziela slajd od regionu zawartości pod slajdem. 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 normalnym widoku, gdy zastosowano wartość SplitterBarStateType.Restored dla getVerticalBarState i getHorizontalBarState odpowiednio.

O przywracaniu NormalViewProperties

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

Metoda getDimensionSize określa rozmiar regionu slajdu (szerokość, gdy jest dzieckiem restoredTop, wysokość, gdy jest dzieckiem 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 prezentacji.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var pres = new aspose.slides.Presentation();
try {
    pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(aspose.slides.SplitterBarStateType.Restored);
    pres.getViewProperties().getNormalViewProperties().setVerticalBarState(aspose.slides.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", aspose.slides.SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Ustaw domyślną wartość powiększenia

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

Aby ustawić właściwości widoku, postępuj zgodnie z poniższymi krokami:

Utwórz instancję klasy Presentation.
Ustaw View Properties dla Presentation.
Zapisz prezentację jako plik PPTX. W poniższym przykładzie ustawiliśmy wartość powiększenia dla widoku slajdu oraz widoku notatek.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.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", aspose.slides.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 ViewProperties.getGridSpacing i ViewProperties.setGridSpacing odczytują lub zmieniają interwał 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, wypisuje bieżący odstęp siatki, ustawia interwał ćwierćcala i zapisuje wynik.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation("demo.pptx");
try {
    var gridSpacing = presentation.getViewProperties().getGridSpacing();
    console.log("Current grid spacing: " + gridSpacing + " points");

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

Siatka różni się od drawing guides. Odstęp siatki kontroluje regularny interwał, podczas gdy prowadnice to indywidualnie rozmieszczone linie wyrównania poziome lub pionowe. Dodawanie, przemieszczanie 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 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 obowiązujących w całej prezentacji. Użyj ViewProperties.getShowComments i ViewProperties.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. Ukrycie komentarzy zachowuje ich treść, autorów, pozycje, odpowiedzi i statusy. Zobacz Presentation Comments w celu wykonania operacji zmieniających same komentarze.

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

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");
const java = require("java");

var presentation = new aspose.slides.Presentation("comments.pptx");
try {
    var showComments = presentation.getViewProperties().getShowComments();
    console.log("Current comment visibility: " + showComments);

    var hideComments = java.newByte(aspose.slides.NullableBool.False);
    presentation.getViewProperties().setShowComments(hideComments);
    presentation.getViewProperties().setLastView(aspose.slides.ViewType.SlideView);
    presentation.save("comments-hidden.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

To ustawienie nie określa, czy komentarze są uwzględniane w eksportach PDF, HTML, obrazu, notatek czy materiałów rozdawanych. Skonfiguruj odpowiednie opcje specyficzne dla eksportu osobno.

FAQ

Dlaczego siatka nie jest widoczna po ponownym otwarciu prezentacji?

Plik przechowuje odstęp siatki, ale edytor decyduje, 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 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 w poszczególnych sekcjach, dlatego pojedynczy zestaw parametrów obowiązuje dla całego dokumentu przy jego otwieraniu.

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

Nie. Ustawienia są przechowywane w pliku i są współdzielone. Aplikacje oglą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ę tak samo?

Tak. Ponieważ właściwości widoku są przechowywane na poziomie prezentacji, możesz osadzić je w szablonie i tworzyć nowe dokumenty z tymi samymi początkowymi ustawieniami widoku.

Zarządzanie właściwościami prezentacji w JavaScript Zarządzanie komentarzami prezentacji w Node.js