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

Обзор

Таблица в PowerPoint — эффективный способ представления информации. Информация, размещённая в сетке ячеек (строк и столбцов), проста и легко воспринимается.

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

Создание таблиц с нуля

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

Создайте экземпляр класса Presentation .
Получите ссылку на слайд по его индексу.
Определите массив ширин столбцов.
Определите массив высот строк.
Добавьте Table на слайд.
Итерируйтесь по каждому Cell и форматируйте его верхнюю, нижнюю, правую и левую границы.
Объедините первые две ячейки в первой строке таблицы.
Получите доступ к TextFrame ячейки Cell .
Добавьте текст в TextFrame .
Сохраните изменённую презентацию.

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

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

    # Создать экземпляр класса Presentation, представляющего файл презентации.
    with slides.Presentation() as presentation:
        # Получить первый слайд.
        slide = presentation.slides[0]

        # Определить ширины столбцов и высоты строк.
        column_widths = [50, 50, 50]
        row_heights = [50, 30, 30, 30, 30]

        # Добавить форму таблицы на слайд.
        table = slide.shapes.add_table(100, 50, column_widths, row_heights)

        # Установить формат границы для каждой ячейки.
        for row in table.rows:
            for cell in row:
                cell.cell_format.border_top.fill_format.fill_type = slides.FillType.SOLID
                cell.cell_format.border_top.fill_format.solid_fill_color.color = draw.Color.red
                cell.cell_format.border_top.width = 5

                cell.cell_format.border_bottom.fill_format.fill_type = slides.FillType.SOLID
                cell.cell_format.border_bottom.fill_format.solid_fill_color.color= draw.Color.red
                cell.cell_format.border_bottom.width = 5

                cell.cell_format.border_left.fill_format.fill_type = slides.FillType.SOLID
                cell.cell_format.border_left.fill_format.solid_fill_color.color =draw.Color.red
                cell.cell_format.border_left.width = 5

                cell.cell_format.border_right.fill_format.fill_type = slides.FillType.SOLID
                cell.cell_format.border_right.fill_format.solid_fill_color.color = draw.Color.red
                cell.cell_format.border_right.width = 5
        
        # Объединить ячейки от (строка 0, столбец 0) до (строка 1, столбец 1).
        table.merge_cells(table.rows[0][0], table.rows[1][1], False)

        # Добавить текст в объединённую ячейку.
        table.rows[0][0].text_frame.text = "Merged Cells"

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

Нумерация в стандартных таблицах

В стандартной таблице нумерация ячеек проста и начинается с нуля. Первая ячейка в таблице имеет индекс (0, 0) (столбец 0, строка 0).

Например, в таблице с 4 столбцами и 4 строками ячейки нумеруются следующим образом:

(0, 0)	(1, 0)	(2, 0)	(3, 0)
(0, 1)	(1, 1)	(2, 1)	(3, 1)
(0, 2)	(1, 2)	(2, 2)	(3, 2)
(0, 3)	(1, 3)	(2, 3)	(3, 3)

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

for row_index in range(len(table.rows)):
    for column_index in range(len(table.rows[row_index])):
        cell = table.rows[row_index][column_index]
        cell.text_frame.text = f"({column_index}, {row_index})"

Доступ к существующей таблице

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

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

Если слайд содержит несколько таблиц, лучше искать нужную таблицу по её свойству alternative_text.

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

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

# Создать экземпляр класса Presentation для загрузки файла PPTX.
with slides.Presentation("sample.pptx") as presentation:
    # Получить первый слайд.
    slide = presentation.slides[0]

    table = None

    # Перебрать фигуры и сослаться на первую найденную таблицу.
    for shape in slide.shapes:
        if isinstance(shape, slides.Table):
            table = shape
            break

    # Установить текст первой ячейки первой строки.
    if table is not None:
        table.rows[0][0].text_frame.text = "Found"

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

Выравнивание текста в таблицах

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

Создайте экземпляр класса Presentation .
Получите ссылку на слайд по его индексу.
Добавьте объект Table на слайд.
Получите объект Cell из таблицы.
Выравняйте текст вертикально.
Сохраните изменённую презентацию.

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

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

# Создать экземпляр класса Presentation.
with slides.Presentation() as presentation:
    # Получить первый слайд.
    slide = presentation.slides[0]

    # Определить ширины столбцов и высоты строк.
    column_widths = [40, 120, 120, 120]
    row_heights = [100, 100, 100, 100]

    # Добавить форму таблицы на слайд.
    table = slide.shapes.add_table(100, 50, column_widths, row_heights)
    table.rows[0][0].text_frame.text = "Numbers"
    table.rows[1][0].text_frame.text = "10"
    table.rows[2][0].text_frame.text = "20"
    table.rows[3][0].text_frame.text = "30"

    # Выравнять текст по центру и установить вертикальную ориентацию.
    cell = table.rows[0][0]
    cell.text_anchor_type = slides.TextAnchorType.CENTER
    cell.text_vertical_type = slides.TextVerticalType.VERTICAL270

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

Установка форматирования текста на уровне таблицы

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

Создайте экземпляр класса Presentation .
Получите ссылку на слайд по его индексу.
Добавьте Table на слайд.
Задайте размер шрифта (высоту шрифта) для текста.
Установите выравнивание абзаца и отступы.
Задайте вертикальную ориентацию текста.
Сохраните изменённую презентацию.

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

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

# Создает экземпляр класса Presentation
with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    # Установить размер шрифта для всех ячеек таблицы.
    portion_format = slides.PortionFormat()
    portion_format.font_height = 25
    table.set_text_format(portion_format)

    # Установить выравнивание по правому краю и правый отступ для всех ячеек таблицы.
    paragraph_format = slides.ParagraphFormat()
    paragraph_format.alignment = slides.TextAlignment.RIGHT
    paragraph_format.margin_right = 20
    table.set_text_format(paragraph_format)

    # Установить вертикальную ориентацию текста для всех ячеек таблицы.
    text_frame_format = slides.TextFrameFormat()
    text_frame_format.text_vertical_type = slides.TextVerticalType.VERTICAL
    table.set_text_format(text_frame_format)

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

Применение встроенных стилей таблиц

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

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(10, 10, [100, 150], [5, 5, 5])

    table.style_preset = slides.TableStylePreset.DARK_STYLE1

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

Блокировка соотношения сторон таблиц

Соотношение сторон фигуры — это отношение её размеров. Aspose.Slides предоставляет свойство aspect_ratio_locked, которое позволяет блокировать соотношение сторон для таблиц и других фигур.

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

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

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    table = slide.shapes.add_table(20, 20, [100, 50, 30], [30, 50, 30])

    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")
    table.shape_lock.aspect_ratio_locked = not table.shape_lock.aspect_ratio_locked
    print(f"Lock aspect ratio set: {table.shape_lock.aspect_ratio_locked}")

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

FAQ

Можно ли включить направление чтения справа налево (RTL) для всей таблицы и текста в её ячейках?

Да. Таблица имеет свойство right_to_left , а абзацы — ParagraphFormat.right_to_left . Использование обеих опций обеспечивает правильный порядок RTL и корректный рендеринг внутри ячеек.

Как предотвратить перемещение или изменение размеров таблицы пользователями в конечном файле?

Используйте shape locks , чтобы отключить перемещение, изменение размеров, выделение и т.д. Эти блокировки применимы и к таблицам.

Поддерживается ли вставка изображения в ячейку в качестве фона?

Да. Вы можете задать picture fill для ячейки; изображение будет заполнять область ячейки в соответствии с выбранным режимом (растягивание или мозаика).

Управление строками и столбцами в таблицах PowerPoint с помощью Python