Доступ к слайдам презентации в Python

Обзор

В этой статье объясняется, как получать доступ к слайдам в презентации и управлять ими с помощью Aspose.Slides. Показано, как извлекать слайды по их нулевому индексу из коллекции слайдов и как обращаться к слайду по его уникальному идентификатору с помощью метода getSlideById.

Вы также узнаете, как изменить позицию слайда, используя метод setSlideNumber, и как задать номер первого слайда в презентации с помощью метода setFirstSlideNumber. Примеры демонстрируют загрузку презентации, получение ссылок на слайды, обновление порядка или нумерации слайдов и сохранение изменённой презентации.

Получение слайда по индексу

Все слайды в презентации упорядочены численно в соответствии с их позицией, начиная с 0. Первый слайд доступен по индексу 0; второй — по индексу 1; и т.д.

Класс Presentation, представляющий файл презентации, раскрывает все слайды как коллекцию SlideCollection (коллекцию объектов Slide). Этот Python‑код показывает, как получить доступ к слайду по его индексу:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

# Создайте объект Presentation, представляющий файл презентации.
presentation = Presentation("demo.pptx")
try:
    # Доступ к слайду по его индексу.
    slide = presentation.getSlides().get_Item(0)
finally:
    presentation.dispose()

Получение слайда по ID

Каждому слайду в презентации присвоен уникальный идентификатор. Вы можете использовать метод getSlideById, предоставленный классом Presentation, чтобы обратиться к этому ID. Этот Python‑код показывает, как указать действительный ID слайда и получить доступ к нему через метод getSlideById:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

# Создайте объект Presentation, представляющий файл презентации.
presentation = Presentation("demo.pptx")
try:
    # Получите идентификатор слайда.
    slide_id = presentation.getSlides().get_Item(0).getSlideId()

    # Доступ к слайду по его идентификатору.
    slide = presentation.getSlideById(slide_id)
finally:
    presentation.dispose()

Изменение позиции слайда

Aspose.Slides позволяет менять позицию слайда. Например, вы можете указать, что первый слайд должен стать вторым.

  1. Создайте экземпляр класса Presentation.
  2. Получите ссылку на слайд (позицию которого нужно изменить) через его индекс.
  3. Установите новую позицию слайда через метод setSlideNumber.
  4. Сохраните изменённую презентацию.

Этот Python‑код демонстрирует операцию, при которой слайд с позицией 1 перемещается на позицию 2:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

# Создайте объект Presentation, представляющий файл презентации.
presentation = Presentation("Presentation.pptx")
try:
    # Получите слайд, позицию которого нужно изменить.
    slide = presentation.getSlides().get_Item(0)

    # Установите новую позицию для слайда.
    slide.setSlideNumber(2)

    # Сохраните изменённую презентацию.
    presentation.save("helloworld_Pos.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Первый слайд стал вторым; второй — первым. При изменении позиции одного слайда остальные автоматически перераспределяются.

Установка номера слайда

С помощью метода setFirstSlideNumber, предоставленного классом Presentation, вы можете задать новый номер первого слайда в презентации. Эта операция приводит к пересчёту номеров остальных слайдов.

  1. Создайте экземпляр класса Presentation.
  2. Получите номер слайда.
  3. Установите номер слайда.
  4. Сохраните изменённую презентацию.

Этот Python‑код демонстрирует операцию, при которой номер первого слайда устанавливается в 10:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

# Создайте объект Presentation, представляющий файл презентации.
presentation = Presentation("HelloWorld.pptx")
try:
    # Получите номер слайда.
    first_slide_number = presentation.getFirstSlideNumber()

    # Установите номер слайда.
    presentation.setFirstSlideNumber(10)

    # Сохраните изменённую презентацию.
    presentation.save("Set_Slide_Number_out.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Если вы хотите пропустить первый слайд, вы можете начать нумерацию со второго слайда (и скрыть нумерацию для первого) следующим образом:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, SlideLayoutType

presentation = Presentation()
try:
    layout_slide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank)
    presentation.getSlides().addEmptySlide(layout_slide)
    presentation.getSlides().addEmptySlide(layout_slide)
    presentation.getSlides().addEmptySlide(layout_slide)

    # Установите номер для первого слайда презентации.
    # Отобразите номера слайдов для всех слайдов.
    # Скрыть номер слайда для первого слайда.
    # Сохраните изменённую презентацию.
    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

FAQ

Совпадает ли номер слайда, видимый пользователем, с нулевым индексом коллекции?

Номер, отображаемый на слайде, может начинаться с произвольного значения (например, 10) и не обязан соответствовать индексу; связь контролируется настройкой first slide number презентации.

Влияют ли скрытые слайды на индексацию?

Да. Скрытый слайд остаётся в коллекции и учитывается при индексации; «скрытый» относится к отображению, а не к его позиции в коллекции.

Изменяется ли индекс слайда при добавлении или удалении других слайдов?

Да. Индексы всегда отражают текущее расположение слайдов и пересчитываются при вставке, удалении и перемещении.

Добавление слайдов в презентации на Python Удаление слайдов из презентаций в Python