Управление графикой SmartArt в презентациях с помощью Python

О чём эта страница

Автоматизируйте создание, редактирование и стилизацию SmartArt в PowerPoint на Python с помощью Aspose.Slides, предоставляя лаконичные примеры кода и рекомендации, ориентированные на производительность.

Обзор

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

Примеры показывают, как работать с формами SmartArt через коллекцию форм слайда презентации, проверять, является ли форма SmartArt, а затем изменять или проверять её свойства.

Создать форму SmartArt

Aspose.Slides for Python via Java предоставляет API для создания форм SmartArt. Чтобы создать форму SmartArt на слайде, выполните следующие шаги:

Создайте экземпляр класса Presentation.
Получите слайд по его индексу.
Добавить форму SmartArt с указанием SmartArtLayoutType.
Сохраните изменённую презентацию в файл PPTX.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArtLayoutType

presentation = Presentation()
try:
    # Получить первый слайд.
    slide = presentation.getSlides().get_Item(0)

    # Добавить форму SmartArt.
    smart_art = slide.getShapes().addSmartArt(0, 0, 400, 400, SmartArtLayoutType.BasicBlockList)

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


Рисунок: форма SmartArt, добавленная на слайд

Доступ к форме SmartArt на слайде

Следующий пример получает доступ к формам SmartArt на слайде презентации. Он перебирает каждую форму на слайде и проверяет, является ли форма экземпляром SmartArt.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArt

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # Пройти каждую форму на первом слайде.
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape
            print("Shape Name: " + str(smart_art.getName()))
finally:
    presentation.dispose()

Доступ к форме SmartArt с определённым типом макета

Следующий пример получает доступ к форме SmartArt с определённым типом макета, возвращаемым методом SmartArt.getLayout.

Создайте экземпляр класса Presentation и загрузите презентацию, содержащую форму SmartArt.
Получите первый слайд по его индексу.
Переберите каждую форму на первом слайде.
Проверьте, является ли форма экземпляром SmartArt.
Проверьте, имеет ли форма SmartArt указанный тип макета, и выполните требуемую операцию.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SmartArt, SmartArtLayoutType

presentation = Presentation("AccessSmartArtShape.pptx")
try:
    # Пройти каждую форму на первом слайде.
    for shape in presentation.getSlides().get_Item(0).getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # Проверить макет SmartArt.
            if smart_art.getLayout() == SmartArtLayoutType.BasicBlockList:
                print("Perform the required operation here.")
finally:
    presentation.dispose()

Изменить стиль формы SmartArt

Этот пример показывает, как изменить быстрый стиль формы SmartArt.

Создайте экземпляр класса Presentation и загрузите презентацию, содержащую форму SmartArt.
Получите первый слайд по его индексу.
Переберите каждую форму на первом слайде.
Проверьте, является ли форма экземпляром SmartArt.
Найдите форму SmartArt с указанным стилем.
Установите новый стиль для формы SmartArt.
Сохраните презентацию.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtQuickStyleType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # Пройти каждую форму на первом слайде.
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # Проверить и изменить стиль SmartArt.
            if smart_art.getQuickStyle() == SmartArtQuickStyleType.SimpleFill:
                smart_art.setQuickStyle(SmartArtQuickStyleType.Cartoon)

    presentation.save("ChangeSmartArtStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Рисунок: форма SmartArt со изменённым стилем

Изменить стиль цвета формы SmartArt

Этот пример получает доступ к форме SmartArt с определённым стилем цвета и изменяет его.

Создайте экземпляр класса Presentation и загрузите презентацию, содержащую форму SmartArt.
Получите первый слайд по его индексу.
Переберите каждую форму на первом слайде.
Проверьте, является ли форма экземпляром SmartArt.
Найдите форму SmartArt с указанным стилем цвета.
Установите новый стиль цвета для формы SmartArt.
Сохраните презентацию.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, SmartArt, SmartArtColorType

presentation = Presentation("SimpleSmartArt.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # Пройти каждую форму на первом слайде.
    for shape in slide.getShapes():
        if isinstance(shape, SmartArt):
            smart_art = shape

            # Проверить и изменить стиль SmartArt.
            if smart_art.getColorStyle() == SmartArtColorType.ColoredFillAccent1:
                smart_art.setColorStyle(SmartArtColorType.ColorfulAccentColors)

    presentation.save("ChangeSmartArtColorStyle.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()


Рисунок: форма SmartArt со изменённым стилем цвета

Часто задаваемые вопросы

Могу ли я анимировать SmartArt как единый объект?

Да. SmartArt является формой, поэтому вы можете применять стандартные анимации через API анимаций (вход, выход, акцент, траектории движения) так же, как и к другим формам.

Как найти конкретный SmartArt на слайде, если я не знаю его внутренний ID?

Установите и используйте альтернативный текст и ищите форму по этому значению — это рекомендуемый способ найти нужную форму.

Могу ли я сгруппировать SmartArt с другими формами?

Да. Вы можете группировать SmartArt с другими формами (изображения, таблицы и т.д.) и затем управлять группой.

Как получить изображение конкретного SmartArt (например, для превью или отчёта)?

Экспортируйте миниатюру/изображение формы; библиотека может визуализировать отдельные формы в растровые файлы (PNG/JPG/TIFF).

Сохранится ли внешний вид SmartArt при конвертации всей презентации в PDF?

Да. Движок рендеринга нацелен на высокую точность при экспорте в PDF, предоставляя широкий набор параметров качества и совместимости.

Управление SmartArt в презентациях PowerPoint с использованием Python Управление узлами фигур SmartArt в презентациях с помощью Python