Управление абзацами текста PowerPoint в Python

Обзор

Aspose.Slides предоставляет классы, необходимые для работы с текстом PowerPoint в Python.

  • Aspose.Slides предоставляет класс TextFrame для создания объектов текстовых рамок. Объект TextFrame может содержать один или несколько абзацев (каждый абзац разделяется переводом строки).
  • Aspose.Slides предоставляет класс Paragraph для создания объектов абзацев. Объект Paragraph может содержать одну или несколько текстовых частей.
  • Aspose.Slides предоставляет класс Portion для создания объектов текстовых частей и задания их параметров форматирования.

Объект Paragraph может обрабатывать текст с разными параметрами форматирования через вложенные объекты Portion.

Добавление нескольких абзацев, содержащих несколько частей

Эти шаги показывают, как добавить текстовую рамку, содержащую три абзаца, каждый из которых имеет три части:

  1. Создайте экземпляр класса Presentation.
  2. Получите ссылку на целевой слайд по его индексу.
  3. Добавьте прямоугольный AutoShape на слайд.
  4. Получите TextFrame , связанный с AutoShape.
  5. Создайте два объекта Paragraph и добавьте их в коллекцию абзацев TextFrame (вместе со стандартным абзацем это даст три абзаца).
  6. Для каждого абзаца создайте три объекта Portion и добавьте их в коллекцию частей соответствующего абзаца.
  7. Установите текст для каждой части.
  8. Примените нужное форматирование к каждой текстовой части, используя свойства класса Portion.
  9. Сохраните изменённую презентацию.

Ниже приведён Python‑код, реализующий эти шаги:

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

# Создайте объект класса Presentation для создания нового файла PPTX.
with slides.Presentation() as presentation:

    # Получить первый слайд.
    slide = presentation.slides[0]

    # Добавить прямоугольный AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 150, 300, 150)

    # Получить TextFrame AutoShape.
    text_frame = shape.text_frame

    # Создать абзацы и части; форматирование будет применено ниже.
    paragraph0 = text_frame.paragraphs[0]
    portion01 = slides.Portion()
    portion02 = slides.Portion()
    paragraph0.portions.add(portion01)
    paragraph0.portions.add(portion02)

    paragraph1 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph1)
    portion10 = slides.Portion()
    portion11 = slides.Portion()
    portion12 = slides.Portion()
    paragraph1.portions.add(portion10)
    paragraph1.portions.add(portion11)
    paragraph1.portions.add(portion12)

    paragraph2 = slides.Paragraph()
    text_frame.paragraphs.add(paragraph2)
    portion20 = slides.Portion()
    portion21 = slides.Portion()
    portion22 = slides.Portion()
    paragraph2.portions.add(portion20)
    paragraph2.portions.add(portion21)
    paragraph2.portions.add(portion22)

    for i in range(3):
        for j in range(3):
            text_frame.paragraphs[i].portions[j].text = "Portion0" + str(j)
            if j == 0:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.red
                text_frame.paragraphs[i].portions[j].portion_format.font_bold = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 15
            elif j == 1:
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.fill_type = slides.FillType.SOLID
                text_frame.paragraphs[i].portions[j].portion_format.fill_format.solid_fill_color.color = draw.Color.blue
                text_frame.paragraphs[i].portions[j].portion_format.font_italic = 1
                text_frame.paragraphs[i].portions[j].portion_format.font_height = 18

    # Сохранить PPTX на диск.
    presentation.save("paragraphs_and_portions_out.pptx", slides.export.SaveFormat.PPTX)

Управление маркерами абзацев

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

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к целевому слайду по его индексу.
  3. Добавьте AutoShape на слайд.
  4. Получите TextFrame формы.
  5. Удалите стандартный абзац из TextFrame.
  6. Создайте первый абзац с помощью класса Paragraph.
  7. Установите тип маркера абзаца в SYMBOL и задайте символ маркера.
  8. Установите текст абзаца.
  9. Задайте отступ маркера для абзаца.
  10. Установите цвет маркера.
  11. Установите размер (высоту) маркера.
  12. Добавьте абзац в коллекцию абзацев TextFrame.
  13. Добавьте второй абзац и повторите шаги 7–12.
  14. Сохраните презентацию.

Этот Python‑код демонстрирует, как добавить абзацы с маркерами:

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

# Создать экземпляр презентации.
with slides.Presentation() as presentation:

    # Получить первый слайд.
    slide = presentation.slides[0]

    # Добавить и получить AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Получить текстовую рамку созданного AutoShape.
    text_frame = shape.text_frame

    # Удалить абзац по умолчанию.
    text_frame.paragraphs.remove_at(0)

    # Создать абзац.
    paragraph = slides.Paragraph()

    # Установить стиль и символ маркера абзаца.
    paragraph.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph.paragraph_format.bullet.char = chr(8226)

    # Установить текст абзаца.
    paragraph.text = "Welcome to Aspose.Slides"

    # Установить отступ маркера.
    paragraph.paragraph_format.indent = 25

    # Установить цвет маркера.
    paragraph.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph.paragraph_format.bullet.color.color = draw.Color.black
    paragraph.paragraph_format.bullet.is_bullet_hard_color = 1 

    # Установить высоту маркера.
    paragraph.paragraph_format.bullet.height = 100

    # Добавить абзац в текстовую рамку.
    text_frame.paragraphs.add(paragraph)

    # Создать второй абзац.
    paragraph2 = slides.Paragraph()

    # Установить тип и стиль маркера абзаца.
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    paragraph2.paragraph_format.bullet.numbered_bullet_style = slides.NumberedBulletStyle.BULLET_CIRCLE_NUM_WDBLACK_PLAIN

    # Установить текст абзаца.
    paragraph2.text = "This is numbered bullet"

    # Установить отступ маркера.
    paragraph2.paragraph_format.indent = 25

    # Установить цвет маркера.
    paragraph2.paragraph_format.bullet.color.color_type = slides.ColorType.RGB
    paragraph2.paragraph_format.bullet.color.color = draw.Color.black
    paragraph2.paragraph_format.bullet.is_bullet_hard_color = 1

    # Установить высоту маркера.
    paragraph2.paragraph_format.bullet.height = 100

    # Добавить абзац в текстовую рамку.
    text_frame.paragraphs.add(paragraph2)

    # Сохранить презентацию в файл PPTX.
    presentation.save("bullets_out.pptx", slides.export.SaveFormat.PPTX)

Управление маркерами‑картинками

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

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к целевому слайду по его индексу.
  3. Добавьте AutoShape на слайд.
  4. Получите TextFrame формы.
  5. Удалите стандартный абзац из TextFrame.
  6. Создайте первый абзац с помощью класса Paragraph.
  7. Загрузите изображение в объект PPImage.
  8. Установите тип маркера в PPImage и назначьте изображение.
  9. Установите текст абзаца.
  10. Задайте отступ абзаца для маркера.
  11. Установите цвет маркера.
  12. Установите высоту маркера.
  13. Добавьте новый абзац в коллекцию абзацев TextFrame.
  14. Добавьте второй абзац и повторите шаги 8–12.
  15. Сохраните презентацию.

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

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

with slides.Presentation() as presentation:

    # Получить первый слайд.
    slide = presentation.slides[0]

    # Загрузить изображение маркера.
    image = draw.Bitmap("bullets.png")
    pp_image = presentation.images.add_image(image)

    # Добавить и получить AutoShape.
    auto_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Получить TextFrame созданного AutoShape.
    text_frame = auto_shape.text_frame

    # Удалить абзац по умолчанию.
    text_frame.paragraphs.remove_at(0)

    # Создать новый абзац.
    paragraph = slides.Paragraph()
    paragraph.text = "Welcome to Aspose.Slides"

    # Установить тип маркера абзаца как Picture и назначить изображение.
    paragraph.paragraph_format.bullet.type = slides.BulletType.PICTURE
    paragraph.paragraph_format.bullet.picture.image = pp_image

    # Установить высоту маркера.
    paragraph.paragraph_format.bullet.height = 100

    # Добавить абзац в текстовую рамку.
    text_frame.paragraphs.add(paragraph)

    # Сохранить презентацию в файл PPTX.
    presentation.save("picture_bullets_out.pptx", slides.export.SaveFormat.PPTX)
    # Сохранить презентацию в файл PPT.
    presentation.save("picture_bullets_out.ppt", slides.export.SaveFormat.PPT)

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

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

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к целевому слайду по его индексу.
  3. Добавьте AutoShape на слайд.
  4. Получите TextFrame у AutoShape.
  5. Удалите стандартный абзац из TextFrame.
  6. Создайте первый абзац с помощью класса Paragraph и задайте его уровень глубины 0.
  7. Создайте второй абзац с помощью класса Paragraph и задайте глубину 1.
  8. Создайте третий абзац с помощью класса Paragraph и задайте глубину 2.
  9. Создайте четвёртый абзац с помощью класса Paragraph и задайте глубину 3.
  10. Добавьте новые абзацы в коллекцию абзацев TextFrame.
  11. Сохраните презентацию.

Ниже приведён Python‑код, показывающий, как добавить и управлять многоуровневыми маркерами:

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

# Создать экземпляр презентации.
with slides.Presentation() as presentation:

    # Получить первый слайд.
    slide = presentation.slides[0]
    
    # Добавить AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Получить TextFrame созданного AutoShape.
    text_frame = auto_shape.text_frame
    
    # Очистить абзац по умолчанию.
    text_frame.paragraphs.clear()

    # Добавить первый абзац.
    paragraph1 = slides.Paragraph()
    paragraph1.text = "Content"
    paragraph1.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph1.paragraph_format.bullet.char = chr(8226)
    paragraph1.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph1.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Установить уровень маркера.
    paragraph1.paragraph_format.depth = 0

    # Добавить второй абзац.
    paragraph2 = slides.Paragraph()
    paragraph2.text = "Second Level"
    paragraph2.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph2.paragraph_format.bullet.char = '-'
    paragraph2.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph2.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Установить уровень маркера.
    paragraph2.paragraph_format.depth = 1

    # Добавить третий абзац.
    paragraph3 = slides.Paragraph()
    paragraph3.text = "Third Level"
    paragraph3.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph3.paragraph_format.bullet.char = chr(8226)
    paragraph3.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph3.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Установить уровень маркера.
    paragraph3.paragraph_format.depth = 2

    # Добавить четвертый абзац.
    paragraph4 = slides.Paragraph()
    paragraph4.text = "Fourth Level"
    paragraph4.paragraph_format.bullet.type = slides.BulletType.SYMBOL
    paragraph4.paragraph_format.bullet.char = '-'
    paragraph4.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    paragraph4.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    # Установить уровень маркера.
    paragraph4.paragraph_format.depth = 3

    # Добавить абзацы в коллекцию.
    text_frame.paragraphs.add(paragraph1)
    text_frame.paragraphs.add(paragraph2)
    text_frame.paragraphs.add(paragraph3)
    text_frame.paragraphs.add(paragraph4)

    # Сохранить презентацию в файл PPTX.
    presentation.save("multilevel_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Управление абзацами с пользовательскими нумерованными списками

Класс BulletFormat предоставляет свойство numbered_bullet_start_with (и другие), позволяющее управлять пользовательской нумерацией и форматированием абзацев.

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к слайду, который будет содержать абзацы.
  3. Добавьте AutoShape на слайд.
  4. Получите TextFrame формы.
  5. Удалите стандартный абзац из TextFrame.
  6. Создайте первый Paragraph и задайте numbered_bullet_start_with равным 2.
  7. Создайте второй Paragraph и задайте numbered_bullet_start_with равным 3.
  8. Создайте третий Paragraph и задайте numbered_bullet_start_with равным 7.
  9. Добавьте абзацы в коллекцию TextFrame.
  10. Сохраните презентацию.

Следующий Python‑код демонстрирует, как добавить и управлять абзацами с пользовательской нумерацией и форматированием.

import aspose.slides as slides

with slides.Presentation() as presentation:

    # Добавить и получить AutoShape.
    shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 200, 200, 400, 200)

    # Получить TextFrame созданного AutoShape.
    text_frame = shape.text_frame

    # Удалить существующий абзац по умолчанию.
    text_frame.paragraphs.remove_at(0)

    # Создать первый нумерованный элемент (начинается с 2, уровень вложенности 4).
    paragraph1 = slides.Paragraph()
    paragraph1.text = "bullet 2"
    paragraph1.paragraph_format.depth = 4 
    paragraph1.paragraph_format.bullet.numbered_bullet_start_with = 2
    paragraph1.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph1)

    # Создать второй нумерованный элемент (начинается с 3, уровень вложенности 4).
    paragraph2 = slides.Paragraph()
    paragraph2.text = "bullet 3"
    paragraph2.paragraph_format.depth = 4
    paragraph2.paragraph_format.bullet.numbered_bullet_start_with = 3 
    paragraph2.paragraph_format.bullet.type = slides.BulletType.NUMBERED  
    text_frame.paragraphs.add(paragraph2)

    # Создать третий нумерованный элемент (начинается с 7, уровень вложенности 4).
    paragraph5 = slides.Paragraph()
    paragraph5.text = "bullet 7"
    paragraph5.paragraph_format.depth = 4
    paragraph5.paragraph_format.bullet.numbered_bullet_start_with = 7
    paragraph5.paragraph_format.bullet.type = slides.BulletType.NUMBERED
    text_frame.paragraphs.add(paragraph5)

    presentation.save("custom_bullets_out.pptx", slides.export.SaveFormat.PPTX)

Установка первого‑строчного отступа для абзаца

Используйте свойство ParagraphFormat.indent для управления первым‑строчным отступом абзаца. Это свойство смещает только первую строку относительно левого поля абзаца. Положительное значение сдвигает первую строку вправо, остальные строки остаются выровненными по телу абзаца.

Используйте ParagraphFormat.margin_left, когда нужно сместить весь абзац. Используйте ParagraphFormat.indent, когда требуется сместить только первую строку.

В примере ниже создаются несколько абзацев и применяются разные значения indent, чтобы продемонстрировать влияние первого‑строчного отступа на размещение текста.

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к целевому слайду.
  3. Добавьте прямоугольный AutoShape на слайд.
  4. Добавьте пустой TextFrame к форме и удалите стандартный абзац.
  5. Создайте несколько абзацев и задайте им разные значения indent.
  6. Добавьте абзацы в текстовую рамку.
  7. Сохраните изменённую презентацию.

Этот код показывает, как установить отступ абзаца:

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "No first-line indent. Wrapped lines start at the same position as the first line."
    first_paragraph.paragraph_format.margin_left = 20.0
    first_paragraph.paragraph_format.indent = 0.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "First-line indent of 20 points. The first line moves to the right, while wrapped lines remain aligned to the paragraph body."
    second_paragraph.paragraph_format.margin_left = 20.0
    second_paragraph.paragraph_format.indent = 20.0

    third_paragraph = slides.Paragraph()
    third_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    third_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    third_paragraph.text = "First-line indent of 40 points. This paragraph shows a larger first-line offset to make the effect easier to see."
    third_paragraph.paragraph_format.margin_left = 20.0
    third_paragraph.paragraph_format.indent = 40.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)
    text_frame.paragraphs.add(third_paragraph)

    presentation.save("paragraph_indent.pptx", slides.export.SaveFormat.PPTX)

Результат:

The first-line indent of the paragraphs

Установка висячего отступа для абзаца

Висячий отступ — это макет абзаца, при котором первая строка начинается слева от остальных строк. В Aspose.Slides такой эффект создаётся с помощью свойства ParagraphFormat.indent. Установите indent в отрицательное значение, чтобы переместить первую строку влево относительно тела абзаца.

На практике ParagraphFormat.margin_left определяет левую позицию тела абзаца, а ParagraphFormat.indent задаёт позицию первой строки относительно этого поля. Чтобы создать висячий отступ, задайте положительное значение margin_left и отрицательное значение indent.

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

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к целевому слайду.
  3. Добавьте прямоугольный AutoShape на слайд.
  4. Добавьте пустой TextFrame к форме и удалите стандартный абзац.
  5. Создайте абзацы и задайте каждому положительное значение margin_left.
  6. Установите отрицательное значение indent для создания эффекта висячего отступа.
  7. Добавьте абзацы в текстовую рамку.
  8. Сохраните изменённую презентацию.

Этот код показывает, как установить висячий отступ для абзаца:

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    rectangle = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 420, 220)
    rectangle.fill_format.fill_type = slides.FillType.NO_FILL
    rectangle.line_format.fill_format.fill_type = slides.FillType.SOLID
    rectangle.line_format.fill_format.solid_fill_color.color = draw.Color.gray

    text_frame = rectangle.add_text_frame("")
    text_frame.text_frame_format.autofit_type = slides.TextAutofitType.SHAPE
    text_frame.paragraphs.remove_at(0)

    first_paragraph = slides.Paragraph()
    first_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    first_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    first_paragraph.text = "A hanging indent is created by combining a positive left margin with a negative indent. The first line starts to the left, while wrapped lines align with the paragraph body."
    first_paragraph.paragraph_format.margin_left = 40.0
    first_paragraph.paragraph_format.indent = -20.0

    second_paragraph = slides.Paragraph()
    second_paragraph.paragraph_format.default_portion_format.fill_format.fill_type = slides.FillType.SOLID
    second_paragraph.paragraph_format.default_portion_format.fill_format.solid_fill_color.color = draw.Color.black
    second_paragraph.text = "This second example uses a deeper hanging indent so the difference between the first line and the wrapped lines is easier to compare."
    second_paragraph.paragraph_format.margin_left = 60.0
    second_paragraph.paragraph_format.indent = -30.0

    text_frame.paragraphs.add(first_paragraph)
    text_frame.paragraphs.add(second_paragraph)

    presentation.save("hanging_indent.pptx", slides.export.SaveFormat.PPTX)

Результат:

The hanging indent of the paragraphs

Управление форматом части в конце абзаца

Когда необходимо контролировать стиль «конца» абзаца (форматирование, применяемое после последней части текста), используйте свойство end_paragraph_portion_format. В примере ниже к концу второго абзаца применяется более крупный шрифт Times New Roman.

  1. Создайте или откройте файл Presentation.
  2. Получите целевой слайд по индексу.
  3. Добавьте прямоугольный AutoShape на слайд.
  4. Используйте TextFrame формы и создайте два абзаца.
  5. Создайте PortionFormat размером 48 пунктов Times New Roman и примените его как формат части в конце абзаца.
  6. Назначьте его свойству end_paragraph_portion_format абзаца (применяется к концу второго абзаца).
  7. Запишите изменённую презентацию в файл PPTX.

Этот Python‑код показывает, как задать формат части в конце абзаца для второго абзаца:

import aspose.slides as slides

with slides.Presentation("presentation.pptx") as presentation:
	shape = presentation.slides[0].shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 200, 250)

	paragraph1 = slides.Paragraph()
	paragraph1.portions.add(slides.Portion("Sample text"))

	end_paragraph_portion_format = slides.PortionFormat()
	end_paragraph_portion_format.font_height = 48
	end_paragraph_portion_format.latin_font = slides.FontData("Times New Roman")

	paragraph2 = slides.Paragraph()
	paragraph2.portions.add(slides.Portion("Sample text 2"))
	paragraph2.end_paragraph_portion_format = end_paragraph_portion_format

	shape.text_frame.paragraphs.add(paragraph1)
	shape.text_frame.paragraphs.add(paragraph2)

	presentation.save("presentation.pptx", slides.export.SaveFormat.PPTX)

Импорт HTML‑текста в абзацы

Aspose.Slides предоставляет расширенную поддержку импорта HTML‑текста в абзацы.

  1. Создайте экземпляр класса Presentation.
  2. Получите доступ к целевому слайду по его индексу.
  3. Добавьте AutoShape на слайд.
  4. Получите TextFrame у AutoShape.
  5. Удалите стандартный абзац из TextFrame.
  6. Прочитайте исходный HTML‑файл.
  7. Создайте первый абзац с помощью класса Paragraph.
  8. Добавьте HTML‑содержимое в коллекцию абзацев TextFrame.
  9. Сохраните изменённую презентацию.

Следующий Python‑код реализует эти шаги для импорта HTML‑текста в абзацы.

import aspose.slides as slides

# Создать пустой экземпляр Presentation.
with slides.Presentation() as presentation:

    # Получить первый слайд презентации.
    slide = presentation.slides[0]

    slide_width = presentation.slide_size.size.width
    slide_height = presentation.slide_size.size.height

    # Добавить AutoShape для размещения HTML-контента.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, slide_width - 20, slide_height - 10)

    # Очистить все абзацы в добавленной текстовой рамке.
    shape.text_frame.paragraphs.clear()

    # Загрузить HTML-файл.
    with open("file.html", "rt") as html_stream:
        # Добавить текст из HTML-файла в текстовую рамку.
        shape.text_frame.paragraphs.add_from_html(html_stream.read())

    # Сохранить презентацию.
    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Экспорт текста абзаца в HTML

Aspose.Slides предоставляет расширенную поддержку экспорта текста в HTML.

  1. Создайте экземпляр класса Presentation и загрузите целевую презентацию.
  2. Получите нужный слайд по его индексу.
  3. Выберите форму, содержащую текст для экспорта.
  4. Получите TextFrame формы.
  5. Откройте поток файла для записи HTML‑вывода.
  6. Укажите начальный индекс и экспортируйте требуемые абзацы.

Этот пример на Python показывает, как экспортировать текст абзаца в HTML.

import aspose.slides as slides

# Загрузить файл презентации.
with slides.Presentation("exporting_HTML_text.pptx") as presentation:
    # Получить первый слайд презентации.
    slide = presentation.slides[0]

    # Индекс целевой формы.
    index = 0

    # Получить форму по индексу.
    shape = slide.shapes[index]

    with open("output.html", "w") as html_stream:
        # Записать данные абзацев в HTML, указав начальный индекс абзаца и общее количество экспортируемых абзацев.
        html_stream.write(shape.text_frame.paragraphs.export_to_html(0, shape.text_frame.paragraphs.count, None))

Сохранение абзаца как изображения

В этом разделе мы рассмотрим два примера, демонстрирующие, как сохранить текстовый абзац, представленный классом Paragraph, в виде изображения. Оба примера включают получение изображения формы, содержащей абзац, с помощью методов get_image класса Shape, вычисление границ абзаца внутри формы и экспорт его как растрового изображения. Эти подходы позволяют извлекать отдельные части текста из презентаций PowerPoint и сохранять их как отдельные изображения, что может быть полезно в различных сценариях.

Предположим, у нас есть файл презентации sample.pptx с одним слайдом, где первая форма — это текстовое поле с тремя абзацами.

The text box with three paragraphs

Пример 1

В этом примере мы получаем второй абзац в виде изображения. Для этого извлекаем изображение формы с первого слайда презентации, затем рассчитываем границы второго абзаца в текстовой рамке формы. Затем абзац перерисовывается на новом растровом изображении, которое сохраняется в формате PNG. Этот метод особенно полезен, когда необходимо сохранить конкретный абзац как отдельное изображение, сохранив точные размеры и форматирование текста.

import aspose.slides as slides
import math
import io
from PIL import Image

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # Сохранить форму в памяти как растровое изображение.
    with first_shape.get_image() as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Создать растровое изображение формы из памяти.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Вычислить границы второго абзаца.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()

    # Вычислить координаты и размер выходного изображения (минимальный размер - 1x1 пиксель).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # Обрезать растровое изображение формы, чтобы получить только растровое изображение абзаца.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

Результат:

The paragraph image

Пример 2

В этом примере мы расширяем предыдущий подход, добавляя коэффициенты масштабирования к изображению абзаца. Форма извлекается из презентации и сохраняется как изображение с коэффициентом масштабирования 2. Это обеспечивает более высокое разрешение при экспорте абзаца. Затем границы абзаца рассчитываются с учётом масштаба. Масштабирование особенно полезно, когда требуется более детальное изображение, например, для печатных материалов высокого качества.

import aspose.slides as slides
import math
import io
from PIL import Image

image_scale_x = 2
image_scale_y = image_scale_x

with slides.Presentation("sample.pptx") as presentation:
    first_shape = presentation.slides[0].shapes[0]

    # Сохранить форму в памяти как растровое изображение.
    with first_shape.get_image(slides.ShapeThumbnailBounds.SHAPE, image_scale_x, image_scale_y) as shape_image:
        shape_image_stream = io.BytesIO()
        shape_image.save(shape_image_stream, slides.ImageFormat.PNG)

    # Создать растровое изображение формы из памяти.
    shape_image_stream.seek(0)
    shape_bitmap = Image.open(shape_image_stream)

    # Вычислить границы второго абзаца.
    second_paragraph = first_shape.text_frame.paragraphs[1]
    paragraph_rectangle = second_paragraph.get_rect()
    paragraph_rectangle.x *= image_scale_x
    paragraph_rectangle.y *= image_scale_y
    paragraph_rectangle.width *= image_scale_x
    paragraph_rectangle.height *= image_scale_y

    # Вычислить координаты и размер выходного изображения (минимальный размер - 1x1 пиксель).
    image_left = math.floor(paragraph_rectangle.x)
    image_top = math.floor(paragraph_rectangle.y)
    image_right = image_left + max(1, math.ceil(paragraph_rectangle.width))
    image_bottom = image_top + max(1, math.ceil(paragraph_rectangle.height))

    # Обрезать растровое изображение формы, чтобы получить только растровое изображение абзаца.
    paragraph_bitmap = shape_bitmap.crop((image_left, image_top, image_right, image_bottom))

    paragraph_bitmap.save("paragraph.png")

FAQ

Можно ли полностью отключить перенос строк внутри текстовой рамки?

Да. Используйте настройку переноса текста у рамки (wrap_text), чтобы отключить перенос — строки не будут разбиваться по краям рамки.

Как получить точные границы конкретного абзаца на слайде?

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

Где управляется выравнивание абзаца (по левому/правому краю/по центру/по ширине)?

Alignment — это настройка уровня абзаца в ParagraphFormat; она применяется ко всему абзацу независимо от форматирования отдельных частей.

Можно ли задать язык проверки правописания только для части абзаца (например, одного слова)?

Да. Язык задаётся на уровне части (PortionFormat.language_id), поэтому в одном абзаце могут сосуществовать несколько языков.

Улучшите свои презентации с помощью AutoFit в Python Форматирование текста PowerPoint в Python