Como trabalhar com tabelas em Python
Este guia mostra como criar tabelas em slides do PowerPoint usando Aspose.Slides FOSS para Python. Call slide.shapes.add_table(x, y, col_widths, row_heights) para adicionar uma tabela, acessar células via table.rows[row][col].text_frame.text, e estilo texto de célula através cell.text_frame.paragraphs[0].portions[0].portion_format.
Guia passo a passo
Passo 1: Instalar o pacote
Instale a biblioteca no seu ambiente Python executando o seguinte comando pip:
pip install aspose-slides-fossPasso 2: Crie ou abra uma apresentação
Utilize um with declaração para construir um Presentation, acessar o primeiro slide via prs.slides[0], depois salva quando terminado:
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
# ... add table ...
prs.save("table.pptx", SaveFormat.PPTX)Passo 3: Defina largura de coluna e altura das linhas
As tabelas exigem largura explícita de colunas e alturas de linhas em pontos (1 ponto = 1/72 polegada). Um slide padrão tem 960 pontos de larguras e 540 pontos.
col_widths = [200.0, 150.0, 150.0] # 3 columns: 200pt + 150pt + 150pt
row_heights = [45.0, 40.0, 40.0] # 3 rows: 45pt header + 40pt data rowsPasso 4: Adicionar a tabela
slide.shapes.add_table(x, y, col_widths, row_heights) Cria a tabela na posição (x, y):
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
col_widths = [200.0, 150.0, 150.0]
row_heights = [45.0, 40.0, 40.0]
table = slide.shapes.add_table(50, 100, col_widths, row_heights)
prs.save("table.pptx", SaveFormat.PPTX)Passo 5: Configurar texto de célula
Células de acesso via table.rows[row_index][col_index] e atribuir texto através de: .text_frame.text.Os índices de linha e coluna são baseados em zero, portanto a linha do cabeçalho é o índice 0 e as linhas de dados começam no índize 1:
import aspose.slides_foss as slides
from aspose.slides_foss.export import SaveFormat
with slides.Presentation() as prs:
slide = prs.slides[0]
col_widths = [200.0, 150.0, 150.0]
row_heights = [45.0, 40.0, 40.0]
table = slide.shapes.add_table(50, 100, col_widths, row_heights)
# Header row (row 0)
headers = ["Product", "Units Sold", "Revenue"]
for col, header in enumerate(headers):
table.rows[0][col].text_frame.text = header
# Data rows
data = [
["Widget A", "1,200", "$24,000"],
["Widget B", "850", "$17,000"],
]
for row_idx, row_data in enumerate(data):
for col, cell_text in enumerate(row_data):
table.rows[row_idx + 1][col].text_frame.text = cell_text
prs.save("sales-table.pptx", SaveFormat.PPTX)Passo 6: Formatear texto da célula de cabeçalho
Aplicar o formato de fonte em negrito para células do cabeçalho acessando cell.text_frame.paragraphs[0].portions[0].portion_format e de fixação fmt.font_bold = NullableBool.TRUE:
from aspose.slides_foss import NullableBool, FillType
from aspose.slides_foss.drawing import Color
for col in range(len(headers)):
cell = table.rows[0][col]
portions = cell.text_frame.paragraphs[0].portions
if portions:
fmt = portions[0].portion_format
fmt.font_bold = NullableBool.TRUE
fmt.fill_format.fill_type = FillType.SOLID
fmt.fill_format.solid_fill_color.color = Color.from_argb(255, 255, 255, 255)Exemplo de trabalho completo
O seguinte script autônomo cria uma tabela de receita regional com uma linha de cabeçalho em negrito e quatro linhas de dados, depois salva o resultado como um arquivo PPTX:
import aspose.slides_foss as slides
from aspose.slides_foss import NullableBool, FillType
from aspose.slides_foss.drawing import Color
from aspose.slides_foss.export import SaveFormat
data_rows = [
["North", "$1.2M", "+8%"],
["South", "$0.9M", "+4%"],
["East", "$1.5M", "+12%"],
["West", "$0.7M", "+2%"],
]
headers = ["Region", "Revenue", "Growth"]
with slides.Presentation() as prs:
slide = prs.slides[0]
col_widths = [180.0, 140.0, 120.0]
row_heights = [45.0] + [38.0] * len(data_rows)
table = slide.shapes.add_table(60, 80, col_widths, row_heights)
# Header row
for col, text in enumerate(headers):
cell = table.rows[0][col]
cell.text_frame.text = text
if cell.text_frame.paragraphs and cell.text_frame.paragraphs[0].portions:
fmt = cell.text_frame.paragraphs[0].portions[0].portion_format
fmt.font_bold = NullableBool.TRUE
# Data rows
for row_idx, row_data in enumerate(data_rows):
for col, text in enumerate(row_data):
table.rows[row_idx + 1][col].text_frame.text = text
prs.save("regional-revenue.pptx", SaveFormat.PPTX)
print("Saved regional-revenue.pptx")Problemas comuns e soluções
IndexError quando acederem table.rows[row][col]
Os índices de linha e coluna são baseados em zero. Se você definir row_heights com 3 elementos, os índices de linha válidos são 0, 1, 2.
Não há texto na célula no arquivo de armazenamento .
Sempre atribuir através de .text_frame.text, não através de .text diretamente no objeto da célula:
# Correct
table.rows[0][0].text_frame.text = "Header"
# Wrong: AttributeError or silent failure
table.rows[0][0].text = "Header"A posição da mesa está fora do slide.
Verifica isso . x + sum(col_widths) <= 960 e a) y + sum(row_heights) <= 540 para um slide padrão.
Perguntas Frequentes
Posso juntar células de mesa?
A fusão de células não é suportada nesta edição.
Posso aplicar uma cor de fundo para toda a mesa?
Aplicar a formatação de preenchimento para cada célula individual:
for row_idx in range(len(table.rows)):
for col_idx in range(len(table.rows[row_idx])):
cell = table.rows[row_idx][col_idx]
cell.fill_format.fill_type = FillType.SOLID
cell.fill_format.solid_fill_color.color = Color.from_argb(255, 240, 248, 255)Posso definir estilos de fronteira da célula?
As propriedades de fronteira celular são acessíveis através do table.rows[row][col].border_* Propriedades: Consulte a referência da API para obter uma lista completa dos atributos do formato de bordas.
