Como Trabalhar com Tabelas em C++
Aspose.Slides FOSS for C++ supports creating tables on slides with configurable column widths and row heights. This guide shows how to add a table, populate it with data, and apply basic text formatting to cells.
Guia passo a passo
Etapa 1: Compilar e Vincular a Biblioteca
git clone https://github.com/aspose-slides-foss/Aspose.Slides-FOSS-for-Cpp.git
cd Aspose.Slides-FOSS-for-Cpp && mkdir build && cd build
cmake .. && cmake --build .Etapa 2: Criar ou Abrir uma Apresentação
#include <Aspose/Slides/Foss/presentation.h>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs;
auto& slide = prs.slides()[0];
// ... add table ...
prs.save("table.pptx", asf::SaveFormat::PPTX);
return 0;
}Etapa 3: Definir Larguras das Colunas e Alturas das Linhas
Tabelas exigem larguras de coluna e alturas de linha explícitas em pontos (1 ponto = 1/72 polegada). Um slide padrão tem 720 pontos de largura e 540 pontos de altura.
std::vector<double> col_widths = {200.0, 150.0, 150.0}; // 3 columns
std::vector<double> row_heights = {45.0, 40.0, 40.0}; // 3 rows
Etapa 4: Adicionar a Tabela
slide.shapes().add_table(x, y, col_widths, row_heights) cria a tabela na posição (x, y):
#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs;
auto& slide = prs.slides()[0];
std::vector<double> col_widths = {200.0, 150.0, 150.0};
std::vector<double> row_heights = {45.0, 40.0, 40.0};
auto& table = slide.shapes().add_table(50, 100, col_widths, row_heights);
prs.save("table.pptx", asf::SaveFormat::PPTX);
return 0;
}Etapa 5: Definir o Texto da Célula
Acesse as células via table.rows()[row_index][col_index] e atribua texto através de .text_frame()->set_text():
#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>
int main() {
namespace asf = Aspose::Slides::Foss;
asf::Presentation prs;
auto& slide = prs.slides()[0];
std::vector<double> col_widths = {200.0, 150.0, 150.0};
std::vector<double> row_heights = {45.0, 40.0, 40.0};
auto& table = slide.shapes().add_table(50, 100, col_widths, row_heights);
// Header row (row 0)
std::vector<std::string> headers = {"Product", "Units Sold", "Revenue"};
for (size_t col = 0; col < headers.size(); ++col) {
table.rows()[0][col].text_frame()->set_text(headers[col]);
}
// Data rows
std::vector<std::vector<std::string>> data = {
{"Widget A", "1,200", "$24,000"},
{"Widget B", "850", "$17,000"},
};
for (size_t r = 0; r < data.size(); ++r) {
for (size_t c = 0; c < data[r].size(); ++c) {
table.rows()[r + 1][c].text_frame()->set_text(data[r][c]);
}
}
prs.save("sales-table.pptx", asf::SaveFormat::PPTX);
return 0;
}Etapa 6: Formatar o Texto da Célula de Cabeçalho
Aplique formatação em negrito às células de cabeçalho usando PortionFormat:
for (size_t col = 0; col < headers.size(); ++col) {
auto& cell = table.rows()[0][col];
auto& portions = cell.text_frame()->paragraphs()[0].portions();
if (portions.size() > 0) {
auto& fmt = portions[0].portion_format();
fmt.set_font_bold(asf::NullableBool::TRUE);
fmt.fill_format().set_fill_type(asf::FillType::SOLID);
fmt.fill_format().solid_fill_color().set_color(
asf::Color::from_argb(255, 255, 255, 255));
}
}Exemplo Completo Funcional
#include <Aspose/Slides/Foss/presentation.h>
#include <vector>
#include <string>
#include <iostream>
int main() {
namespace asf = Aspose::Slides::Foss;
std::vector<std::vector<std::string>> data_rows = {
{"North", "$1.2M", "+8%"},
{"South", "$0.9M", "+4%"},
{"East", "$1.5M", "+12%"},
{"West", "$0.7M", "+2%"},
};
std::vector<std::string> headers = {"Region", "Revenue", "Growth"};
asf::Presentation prs;
auto& slide = prs.slides()[0];
std::vector<double> col_widths = {180.0, 140.0, 120.0};
std::vector<double> row_heights(1 + data_rows.size(), 38.0);
row_heights[0] = 45.0;
auto& table = slide.shapes().add_table(60, 80, col_widths, row_heights);
// Header row
for (size_t col = 0; col < headers.size(); ++col) {
auto& cell = table.rows()[0][col];
cell.text_frame()->set_text(headers[col]);
auto& portions = cell.text_frame()->paragraphs()[0].portions();
if (portions.size() > 0) {
portions[0].portion_format().set_font_bold(asf::NullableBool::TRUE);
}
}
// Data rows
for (size_t r = 0; r < data_rows.size(); ++r) {
for (size_t c = 0; c < data_rows[r].size(); ++c) {
table.rows()[r + 1][c].text_frame()->set_text(data_rows[r][c]);
}
}
prs.save("regional-revenue.pptx", asf::SaveFormat::PPTX);
std::cout << "Saved regional-revenue.pptx\n";
return 0;
}Problemas comuns e correções
std::out_of_range ao acessar table.rows()[row][col]
Os índices de linhas e colunas são baseados em zero. Se você definiu row_heights com 3 elementos, os índices de linha válidos são 0, 1, 2.
O texto da célula não aparece no arquivo salvo
Sempre atribua através de .text_frame()->set_text(), não através de .set_text() diretamente no objeto da célula.
A posição da tabela está fora do slide
Verifique se x + sum(col_widths) <= 720 e y + sum(row_heights) <= 540 para um slide padrão.
Perguntas Frequentes
Posso mesclar células da tabela?
A mesclagem de células não é suportada nesta edição.
Posso aplicar uma cor de fundo em toda a tabela?
Aplique formatação de preenchimento a cada célula individual:
for (size_t r = 0; r < table.rows().size(); ++r) {
for (size_t c = 0; c < table.rows()[r].size(); ++c) {
auto& cell = table.rows()[r][c];
cell.fill_format().set_fill_type(asf::FillType::SOLID);
cell.fill_format().solid_fill_color().set_color(
asf::Color::from_argb(255, 240, 248, 255));
}
}Posso definir estilos de borda de célula?
As propriedades de borda da célula são acessíveis por meio dos métodos de borda do formato de célula. Consulte a referência da API para a lista completa de atributos de formato de borda.
