Управление маркированными и нумерованными списками

В Microsoft PowerPoint вы можете создавать маркированные и нумерованные списки так же, как в Word и других текстовых редакторах. Aspose.Slides для Python через .NET также позволяет использовать маркировку и нумерацию на слайдах ваших презентаций.

Почему использовать маркированные списки?

Маркированные списки помогают вам быстро и эффективно организовывать и представлять информацию.

Пример маркированного списка

В большинстве случаев маркированный список выполняет три основные функции:

привлекает внимание ваших читателей или зрителей к важной информации
позволяет вашим читателям или зрителям легко находить ключевые моменты
эффективно передает и сообщает важные детали.

Почему использовать нумерованные списки?

Нумерованные списки также помогают в организации и представлении информации. В идеале, вам следует использовать номера (вместо маркеров), когда важен порядок записей (например, шаг 1, шаг 2 и т.д.) или когда запись должна быть ссылаемой (например, см. шаг 3).

Пример нумерованного списка

Это краткое изложение шагов (шаг 1 по шагу 15) в процедуре Создание маркировки ниже:

Создайте экземпляр класса презентации.
Выполните несколько задач (шаг 3 по шагу 14).
Сохраните презентацию.

Создание маркировки

Для создания маркированного списка выполните следующие шаги:

Создайте экземпляр класса Presentation.
Получите доступ к слайду (в который вы хотите добавить маркированный список) в коллекции слайдов через объект ISlide.
Добавьте AutoShape на выбранном слайде.
Получите доступ к text_frame добавленной формы.
Удалите параграф по умолчанию в text_frame.
Создайте экземпляр первого параграфа с использованием класса Paragraph.
Установите тип маркера на Символ и затем установите символ маркера.
Установите текст параграфа.
Установите отступ параграфа для установки маркера.
Установите цвет маркера.
Установите высоту маркера.
Добавьте созданный параграф в коллекцию параграфов text_frame.
Добавьте второй параграф и повторите шаги 7-12.
Сохраните презентацию.

Этот пример кода на Python — реализация вышеперечисленных шагов — показывает, как создать маркированный список на слайде:

import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as pres:
    slide = pres.slides[0]
    autoShape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
    textFrame = autoShape.text_frame
    textFrame.paragraphs.clear()
    
    paragraph = slides.Paragraph()
    paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph.paragraph_format.bullet.char = '*'
    paragraph.paragraph_format.indent = 15
    paragraph.paragraph_format.bullet.is_bullet_hard_color = 1
    paragraph.paragraph_format.bullet.color.color = draw.Color.red
    paragraph.paragraph_format.bullet.height = 100
    paragraph.text = "Мой текст"

    textFrame.paragraphs.add(paragraph)
    
    
    pres.save("pres.pptx", slides.export.SaveFormat.PPTX)

Создание изображений в маркировке

Aspose.Slides для Python через .NET позволяет вам изменять маркеры в маркированных списках. Вы можете заменить маркеры на свои символы или изображения. Если вы хотите добавить визуальный интерес к списку или привлечь еще большее внимание к записям в списке, вы можете использовать свое собственное изображение в качестве маркера.

В идеале, если вы собираетесь заменить обычный символ маркера на изображение, вам стоит выбрать простое графическое изображение с прозрачным фоном. Такие изображения лучше всего подходят в качестве настраиваемых символов маркировки.

В любом случае изображение, которое вы выберете, будет уменьшено до очень небольшого размера, поэтому мы настоятельно рекомендуем выбрать изображение, которое будет хорошо выглядеть (как замена символу маркера) в списке.

Чтобы создать изображение в маркировке, выполните следующие шаги:

Создайте экземпляр класса Presentation.
Получите доступ к нужному слайду в коллекции слайдов, используя объект ISlide.
Добавьте add_auto_shape на выбранном слайде.
Получите доступ к text_frame добавленной формы.
Удалите параграф по умолчанию в text_frame.
Создайте экземпляр первого параграфа, используя класс Paragraph.
Загрузите изображение с диска и добавьте его в Presentation.images и затем используйте экземпляр IPPImage, который был возвращен из метода add_image.
Установите тип маркера на Изображение и затем установите изображение.
Установите текст параграфа.
Установите отступ параграфа для установки маркера.
Установите цвет маркера.
Установите высоту маркеров.
Добавьте созданный параграф в коллекцию параграфов text_frame.
Добавьте второй параграф и повторите шаги 7-13.
Сохраните презентацию.

Этот код на Python показывает, как создать изображение в маркировке на слайде:

import aspose.slides as slides

with slides.Presentation() as pres:
    slide = pres.slides[0]
    autoShape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
    textFrame = autoShape.text_frame
    textFrame.paragraphs.clear()
    
    
    paragraph = slides.Paragraph()
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    with open("img.jpeg", "rb") as in_file:
        image = pres.images.add_image(in_file)
    paragraph.paragraph_format.bullet.picture.image = image
    paragraph.paragraph_format.indent = 15
    paragraph.paragraph_format.bullet.height = 100
    paragraph.text = "Мой текст"

    textFrame.paragraphs.add(paragraph)
    
    pres.save("pres-bullets.pptx", slides.export.SaveFormat.PPTX)

Создание многоуровневых маркированных списков

Чтобы создать маркированный список, который содержит элементы на разных уровнях — дополнительные списки под основным маркированным списком — выполните следующие шаги:

Создайте экземпляр класса Presentation.
Получите доступ к нужному слайду в коллекции слайдов, используя объект ISlide.
Добавьте auto_shape на выбранном слайде.
Получите доступ к text_frame добавленной формы.
Удалите параграф по умолчанию в text_frame.
Создайте экземпляр первого параграфа, используя класс Paragraph, и установите глубину равной 0.
Создайте экземпляр второго параграфа с использованием класса Paragraph и глубиной, установленной на 1.
Создайте экземпляр третьего параграфа с использованием класса Paragraph и глубиной, установленной на 2.
Создайте экземпляр четвертого параграфа с использованием класса Paragraph и глубиной, установленной на 3.
Добавьте созданные параграфы в коллекцию параграфов text_frame.
Сохраните презентацию.

Этот код, который является реализацией вышеперечисленных шагов, показывает, как создать многоуровневый маркированный список на Python:

import aspose.slides as slides

with slides.Presentation() as pres:
    slide = pres.slides[0]
    autoShape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 300, 300)
    textFrame = autoShape.text_frame
    textFrame.paragraphs.clear()
    
    paragraph = slides.Paragraph()
    paragraph.paragraph_format.depth = 0
    paragraph.text = "Мой текст Глубина 0"
    textFrame.paragraphs.add(paragraph)
    
    paragraph2 = slides.Paragraph()
    paragraph2.paragraph_format.depth = 0
    paragraph2.text = "Мой текст Глубина 1"
    textFrame.paragraphs.add(paragraph2)
    
    paragraph3 = slides.Paragraph()
    paragraph3.paragraph_format.depth = 2
    paragraph3.text = "Мой текст Глубина 2"
    textFrame.paragraphs.add(paragraph3)
    
    paragraph4 = slides.Paragraph()
    paragraph4.paragraph_format.depth = 3
    paragraph4.text = "Мой текст Глубина 3"
    textFrame.paragraphs.add(paragraph4)
    
    pres.save("pres-bullets2.pptx", slides.export.SaveFormat.PPTX)

Создание номеров

Этот код на Python показывает, как создать нумерованный список на слайде:

import aspose.slides as slides

with slides.Presentation() as pres:
    slide = pres.slides[0]
    autoShape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
    textFrame = autoShape.text_frame
    textFrame.paragraphs.clear()
    
    paragraph = slides.Paragraph()
    paragraph.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph.text = "Мой текст 1"
    textFrame.paragraphs.add(paragraph)
    
    paragraph2 = slides.Paragraph()
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph2.text = "Мой текст 2"
    textFrame.paragraphs.add(paragraph2)
    
    pres.save("pres-bullets3.pptx", slides.export.SaveFormat.PPTX)

Анимированный текст Надстрочные и подстрочные символы