Добавление прямоугольников в презентации на Python через Java

Обзор

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

Вы также увидите, как применить базовое форматирование прямоугольника, такое как сплошной цвет заливки, цвет линии и ширина линии. Кроме того, в разделе FAQ статьи указаны связанные задачи с прямоугольниками, включая скруглённые углы, заливку изображением, визуальные эффекты, гиперссылки, блокировку фигур, параметры экспорта и эффективные свойства.

Добавление прямоугольника на слайд

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

  • Создайте экземпляр класса Presentation.
  • Получите ссылку на слайд по его индексу.
  • Добавьте AutoShape типа прямоугольник, используя метод addAutoShape объекта ShapeCollection.
  • Сохраните изменённую презентацию в файл PPTX.

В приведённом ниже примере мы добавили простой прямоугольник на первый слайд презентации.

import jpype
import asposeslides

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

from asposeslides.api import Presentation, SaveFormat, ShapeType

# Создайте экземпляр класса Presentation, представляющего файл PPTX.
presentation = Presentation()
try:
    # Получите первый слайд.
    slide = presentation.getSlides().get_Item(0)

    # Добавьте форму прямоугольника.
    slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50)

    # Запишите файл PPTX на диск.
    presentation.save("RecShp1.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Добавление отформатированного прямоугольника на слайд

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

  • Создайте экземпляр класса Presentation.
  • Получите ссылку на слайд по его индексу.
  • Добавьте AutoShape типа прямоугольник, используя метод addAutoShape объекта ShapeCollection.
  • Установите fill type прямоугольника в значение solid.
  • Установите цвет прямоугольника с помощью метода setColor у сплошного цвета заливки объекта FillFormat связанного с объектом Shape.
  • Установите цвет контура прямоугольника.
  • Установите ширину контура прямоугольника.
  • Сохраните изменённую презентацию в файл PPTX.

Вышеуказанные шаги реализованы в примере, приведённом ниже.

import jpype
import asposeslides

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

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

# Создайте экземпляр класса Presentation, представляющего файл PPTX.
presentation = Presentation()
try:
    # Получите первый слайд.
    slide = presentation.getSlides().get_Item(0)

    # Добавьте форму прямоугольника.
    rectangle = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 150, 150, 50)

    # Форматируйте заливку прямоугольника.
    rectangle.getFillFormat().setFillType(FillType.Solid)
    rectangle.getFillFormat().getSolidFillColor().setColor(Color.GRAY)

    # Форматируйте контур прямоугольника.
    rectangle.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    rectangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    rectangle.getLineFormat().setWidth(5)

    # Запишите файл PPTX на диск.
    presentation.save("RecShp2.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

FAQ

Как добавить прямоугольник со скруглёнными углами?

Используйте тип фигуры со скруглёнными углами shape type и настройте радиус скругления в свойствах фигуры; скругление также можно применить к отдельным углам с помощью геометрических настроек.

Как залить прямоугольник изображением (текстурой)?

Выберите тип заливки изображением fill type, укажите источник изображения и настройте режимы stretching/tiling modes.

Можно ли добавить к прямоугольнику тень и свечение?

Да. Outer/inner shadow, glow, and soft edges доступны с настраиваемыми параметрами.

Можно ли превратить прямоугольник в кнопку с гиперссылкой?

Да. Assign a hyperlink к клику по фигуре (переход к слайду, файлу, веб‑адресу или e‑mail).

Как защитить прямоугольник от перемещения и изменений?

Use shape locks: вы можете запретить перемещение, изменение размера, выделение или редактирование текста, чтобы сохранить расположение.

Можно ли преобразовать прямоугольник в растровое изображение или SVG?

Да. Вы можете render the shape в изображение заданного размера/масштаба или export it as SVG для использования в векторном виде.

Как быстро получить фактические (эффективные) свойства прямоугольника с учётом темы и наследования?

Use the shape’s effective properties: API возвращает вычисленные значения, учитывающие стили темы, макет и локальные настройки, упрощая анализ форматирования.