Dostęp do slajdów prezentacji w Javie

Przegląd

Ten artykuł wyjaśnia, jak uzyskać dostęp i zarządzać slajdami w prezentacji przy użyciu Aspose.Slides. Pokazuje, jak pobrać slajdy za pomocą ich indeksu zerowego z kolekcji slajdów oraz jak uzyskać dostęp do slajdu po jego unikalnym identyfikatorze przy użyciu metody getSlideById.

Dowiesz się także, jak zmienić pozycję slajdu za pomocą metody setSlideNumber oraz jak określić początkowy numer slajdu w prezentacji przy użyciu metody setFirstSlideNumber. Przykłady pokazują ładowanie prezentacji, uzyskiwanie referencji do slajdów, aktualizację kolejności lub numeracji slajdów oraz zapisywanie zmodyfikowanej prezentacji.

Uzyskiwanie slajdu po indeksie

Wszystkie slajdy w prezentacji są ułożone numerycznie według ich pozycji, zaczynając od 0. Pierwszy slajd jest dostępny pod indeksem 0; drugi slajd pod indeksem 1; itp.

Klasa Presentation, reprezentująca plik prezentacji, udostępnia wszystkie slajdy jako kolekcję ISlideCollection (kolekcję obiektów ISlide). Ten kod Java pokazuje, jak uzyskać dostęp do slajdu za pomocą jego indeksu:

// Tworzy obiekt Presentation, który reprezentuje plik prezentacji
Presentation pres = new Presentation("demo.pptx");
try {
    // Uzyskuje dostęp do slajdu przy użyciu jego indeksu
    ISlide slide = pres.getSlides().get_Item(0);
} finally {
    pres.dispose();
}

Uzyskiwanie slajdu po identyfikatorze

Każdy slajd w prezentacji ma przypisany unikalny identyfikator. Możesz użyć metody getSlideById (udostępnionej przez klasę Presentation), aby odwołać się do tego identyfikatora. Ten kod Java pokazuje, jak podać prawidłowy identyfikator slajdu i uzyskać dostęp do tego slajdu przy użyciu metody getSlideById:

// Tworzy obiekt Presentation, który reprezentuje plik prezentacji
Presentation pres = new Presentation("demo.pptx");
try {
    // Pobiera identyfikator slajdu
    int id = (int) pres.getSlides().get_Item(0).getSlideId();
    
    // Uzyskuje dostęp do slajdu za pomocą jego identyfikatora
    IBaseSlide slide = pres.getSlideById(id);
} finally {
    pres.dispose();
}

Zmiana pozycji slajdu

Aspose.Slides umożliwia zmianę pozycji slajdu. Na przykład możesz określić, że pierwszy slajd ma stać się drugim slajdem.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj referencję do slajdu (którego pozycję chcesz zmienić) przez jego indeks.
3. Ustaw nową pozycję slajdu przy użyciu właściwości setSlideNumber.
4. Zapisz zmodyfikowaną prezentację.

Ten kod Java demonstruje operację, w której slajd na pozycji 1 zostaje przeniesiony na pozycję 2:

// Tworzy obiekt Presentation, który reprezentuje plik prezentacji
Presentation pres = new Presentation("Presentation.pptx");
try {
    // Pobiera slajd, którego pozycja zostanie zmieniona
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Ustawia nową pozycję slajdu
    sld.setSlideNumber(2);
    
    // Zapisuje zmodyfikowaną prezentację
    pres.save("helloworld_Pos.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Pierwszy slajd stał się drugim; drugi slajd stał się pierwszym. Gdy zmieniasz pozycję slajdu, pozostałe slajdy są automatycznie dostosowywane.

Ustawienie numeru slajdu

Korzystając z właściwości setFirstSlideNumber (udostępnionej przez klasę Presentation), możesz określić nowy numer pierwszego slajdu w prezentacji. Ta operacja powoduje przeliczenie numerów pozostałych slajdów.

1. Utwórz instancję klasy Presentation.
2. Uzyskaj numer slajdu.
3. Ustaw numer slajdu.
4. Zapisz zmodyfikowaną prezentację.

Ten kod Java demonstruje operację, w której numer pierwszego slajdu jest ustawiony na 10:

// Tworzy obiekt Presentation, który reprezentuje plik prezentacji
Presentation pres = new Presentation("HelloWorld.pptx");
try {
    // Pobiera numer slajdu
    int firstSlideNumber = pres.getFirstSlideNumber();

    // Ustawia numer slajdu
    pres.setFirstSlideNumber(10);
	
    // Zapisuje zmodyfikowaną prezentację
    pres.save("Set_Slide_Number_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Jeśli wolisz pominąć pierwszy slajd, możesz rozpocząć numerację od drugiego slajdu (i ukryć numerację dla pierwszego slajdu) w następujący sposób:

Presentation presentation = new Presentation();
try {
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);
    presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);
    presentation.getSlides().addEmptySlide(layoutSlide);

    // Ustawia numer pierwszego slajdu w prezentacji
    presentation.setFirstSlideNumber(0);

    // Wyświetla numery slajdów we wszystkich slajdach
    presentation.getHeaderFooterManager().setAllSlideNumbersVisibility(true);

    // Ukrywa numer slajdu w pierwszym slajdzie
    presentation.getSlides().get_Item(0).getHeaderFooterManager().setSlideNumberVisibility(false);

    // Zapisuje zmodyfikowaną prezentację
    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

FAQ

Czy numer slajdu widziany przez użytkownika odpowiada zerowemu indeksowi w kolekcji?

Numer wyświetlany na slajdzie może zaczynać się od dowolnej wartości (np. 10) i nie musi odpowiadać indeksowi; zależność kontroluje ustawienie pierwszego numeru slajdu w prezentacji.

Czy ukryte slajdy wpływają na indeksowanie?

Tak. Ukryty slajd pozostaje w kolekcji i jest uwzględniany w indeksowaniu; „ukryty” odnosi się do wyświetlania, a nie do jego pozycji w kolekcji.

Czy indeks slajdu zmienia się, gdy dodawane są lub usuwane inne slajdy?

Tak. Indeksy zawsze odzwierciedlają aktualny kolejność slajdów i są przeliczane po operacjach wstawiania, usuwania i przenoszenia.