Gerenciar Células de Tabela em Apresentações Usando PHP
Visão geral
O Aspose.Slides permite acessar e modificar células de tabela em apresentações do PowerPoint. Este artigo explica como identificar células de tabela mescladas, remover bordas das células, trabalhar com a numeração das células após mesclar ou dividir células, alterar a cor de fundo de uma célula e adicionar uma imagem dentro de uma célula de tabela. Os exemplos mostram como criar ou abrir uma apresentação, obter uma tabela de um slide, atualizar a formatação da célula por meio das propriedades da célula e salvar a apresentação modificada como um arquivo PPTX.
O Aspose.Slides usa índices baseados em zero para acessar células de tabela na ordem (coluna, linha).
Identificar uma Célula de Tabela Mesclada
O exemplo abre uma apresentação existente e acessa a primeira forma no primeiro slide como uma tabela. Ele assume que o slide e a forma existem e que a forma é uma tabela. Em seguida, itera por todas as linhas e colunas e usa isMergedCell para identificar células em regiões mescladas. Para cada correspondência, ele imprime as coordenadas da célula na ordem linha;coluna, getRowSpan, getColSpan, e as coordenadas iniciais da região, getFirstRowIndex e getFirstColumnIndex.
use aspose\slides\Presentation;
$presentation = new Presentation("presentation_with_table.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$table = $slide->getShapes()->get_Item(0);
$rowCount = java_values($table->getRows()->size());
for ($rowIndex = 0; $rowIndex < $rowCount; $rowIndex++)
{
$columnCount = java_values($table->getColumns()->size());
for ($columnIndex = 0; $columnIndex < $columnCount; $columnIndex++)
{
$cell = $table->get_Item($columnIndex, $rowIndex);
if (java_values($cell->isMergedCell()))
{
printf("Cell %d;%d belongs to a merged region with RowSpan=%d and ColSpan=%d starting at %d;%d.\n", $rowIndex, $columnIndex, java_values($cell->getRowSpan()), java_values($cell->getColSpan()), java_values($cell->getFirstRowIndex()), java_values($cell->getFirstColumnIndex()));
}
}
}
} finally {
$presentation->dispose();
}
Remover Bordas da Célula da Tabela
Crie uma Presentation e adicione uma tabela ao seu primeiro slide com addTable. As larguras das colunas, alturas das linhas e a posição da tabela são especificadas em pontos. O exemplo define todas as quatro bordas da célula como FillType::NoFill, tornando-as invisíveis.
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 50, 50, 50, 50 ];
$rowHeights = [ 50, 30, 30, 30, 30 ];
$table = $slide->getShapes()->addTable(100, 50, $columnWidths, $rowHeights);
for ($rowIndex = 0; $rowIndex < java_values($table->getRows()->size()); $rowIndex++) {
for ($columnIndex = 0; $columnIndex < java_values($table->getColumns()->size()); $columnIndex++) {
$cell = $table->get_Item($columnIndex, $rowIndex);
$cell->getCellFormat()->getBorderTop()->getFillFormat()->setFillType(FillType::NoFill);
$cell->getCellFormat()->getBorderBottom()->getFillFormat()->setFillType(FillType::NoFill);
$cell->getCellFormat()->getBorderLeft()->getFillFormat()->setFillType(FillType::NoFill);
$cell->getCellFormat()->getBorderRight()->getFillFormat()->setFillType(FillType::NoFill);
}
}
$presentation->save("table.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Mesclar Células de Tabela
Use mergeCells para combinar um intervalo retangular de células de tabela em uma única célula. Especifique as células nos cantos superior esquerdo e inferior direito do intervalo. O argumento final controla se a mesclagem pode incluir células fora do intervalo especificado; false mantém a mesclagem dentro desse intervalo.
O exemplo cria uma tabela de 4 por 4 com colunas e linhas de 70 pontos, então mescla as quatro células centrais de (1, 1) até (2, 2). A célula resultante abrange duas colunas e duas linhas, enquanto a grade subjacente da tabela mantém quatro colunas e quatro linhas. Para acessar o conteúdo ou a formatação da célula mesclada, use sua posição superior esquerda: $table->get_Item(1, 1) neste exemplo. As outras posições no intervalo mesclado permanecem parte da grade da tabela, portanto os índices das células fora do intervalo não mudam.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 70, 70, 70, 70 ];
$rowHeights = [ 70, 70, 70, 70 ];
$table = $slide->getShapes()->addTable(100, 50, $columnWidths, $rowHeights);
$table->mergeCells($table->get_Item(1, 1), $table->get_Item(2, 2), false);
$presentation->save("merged_cells.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Dividir Células de Tabela
Mesclar células no exemplo anterior preserva a grade da tabela. Dividir uma célula pode introduzir uma nova coluna na grade e alterar os índices de coluna das células à sua direita. O Aspose.Slides segue o modelo de grade de tabelas do PowerPoint.
Este exemplo cria uma tabela de 4 por 4 com colunas e linhas de 70 pontos e chama splitByWidth na célula (1, 1). Metade da largura de 70 pontos da célula é usada para criar duas células de largura igual.
Após essa divisão, as duas metades são acessadas como $table->get_Item(1, 1) e $table->get_Item(2, 1). A grade da tabela agora tem cinco colunas: as células originalmente nas colunas 2 e 3 passam para as colunas 3 e 4, respectivamente. Os índices das linhas permanecem inalterados. Use esses índices de coluna atualizados ao acessar células após a divisão.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 70, 70, 70, 70 ];
$rowHeights = [ 70, 70, 70, 70 ];
$table = $slide->getShapes()->addTable(100, 50, $columnWidths, $rowHeights);
$table->get_Item(1, 1)->splitByWidth(java_values($table->get_Item(1, 1)->getWidth()) / 2);
$presentation->save("split_cells.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Dividir Células Mescladas por Linha ou Coluna
Para preparar células de modelo mescladas para preenchimento de dados, use splitByRowSpan para dividir ao longo de uma borda de linha existente, ou splitByColSpan para dividir ao longo de uma borda de coluna.
O argumento index conta linhas na parte superior ou colunas na parte esquerda da divisão; ele é relativo à região mesclada:
- Divisão de linha:
0 < index <getRowSpan. - Divisão de coluna:
0 < index <getColSpan.
O exemplo pressupõe que uma apresentação tenha uma tabela como a primeira forma no primeiro slide, com (1, 2) e (1, 3) mesclados verticalmente. Começando a partir da posição inferior, ele usa getFirstColumnIndex e getFirstRowIndex para localizar a origem e verifica ambas as extensões. splitByRowSpan(1) então separa as linhas 2 e 3 para nomes de produtos. Para uma mesclagem horizontal de duas colunas, use splitByColSpan(1) em vez disso.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("table_template.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$table = $slide->getShapes()->get_Item(0);
$selectedCell = $table->get_Item(1, 3);
$firstColumnIndex = java_values($selectedCell->getFirstColumnIndex());
$firstRowIndex = java_values($selectedCell->getFirstRowIndex());
$mergedCell = $table->get_Item($firstColumnIndex, $firstRowIndex);
if (java_values($mergedCell->isMergedCell()) && java_values($mergedCell->getRowSpan()) == 2 && java_values($mergedCell->getColSpan()) == 1)
{
$mergedCell->splitByRowSpan(1);
// Recuperar as células resultantes da tabela após a divisão.
$upperCell = $table->get_Item($firstColumnIndex, $firstRowIndex);
$lowerCell = $table->get_Item($firstColumnIndex, $firstRowIndex + 1);
echo "Upper cell merged: " . (java_values($upperCell->isMergedCell()) ? "true" : "false") . PHP_EOL;
echo "Lower cell merged: " . (java_values($lowerCell->isMergedCell()) ? "true" : "false") . PHP_EOL;
$upperCell->getTextFrame()->setText("Product A");
$lowerCell->getTextFrame()->setText("Product B");
$presentation->save("split_template.pptx", SaveFormat::Pptx);
}
else
{
echo "Select a merged region spanning exactly two rows and one column." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
A grade da tabela e os índices das células ao redor permanecem inalterados. Recupere as células resultantes por suas coordenadas; aqui, ambas têm extensão de 1 e isMergedCell exibe false. Regiões maiores podem permanecer parcialmente mescladas após uma única divisão.
O texto original e sua formatação permanecem na célula superior (ou esquerda); a nova célula está vazia mas herda a formatação da célula, como preenchimento, bordas e margens. Preencha as células após a divisão e defina explicitamente qualquer formatação de texto necessária.
A apresentação salva contém células separadas “Product A” e “Product B” com a formatação de célula do modelo mantida. Consulte a Cell API Reference para detalhes.
Alterar a Cor de Fundo da Célula da Tabela
Este exemplo cria uma tabela com colunas de 150 pontos e linhas de 50 pontos. Ele usa setFillType para selecionar um preenchimento sólido e define a cor retornada por getSolidFillColor como vermelho para a célula (2, 3), na terceira coluna e quarta linha.
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 150, 150, 150, 150 ];
$rowHeights = [ 50, 50, 50, 50, 50 ];
$table = $slide->getShapes()->addTable(50, 50, $columnWidths, $rowHeights);
$cell = $table->get_Item(2, 3);
$cell->getCellFormat()->getFillFormat()->setFillType(FillType::Solid);
$cell->getCellFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$presentation->save("cell_background_color.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Adicionar uma Imagem Dentro de uma Célula de Tabela
Coloque a imagem de entrada no diretório de trabalho antes de executar este exemplo. Ela carrega a imagem com Images::fromFile e a adiciona à coleção de imagens da apresentação com addImage. Em seguida, atribui a imagem ao preenchimento de imagem da célula (0, 0), a primeira célula da tabela.
PictureFillMode::Stretch estica a imagem para preencher a célula, o que pode alterar sua proporção. As larguras das colunas e alturas das linhas estão em pontos. A imagem carregada é descartada em um bloco finally após ser adicionada à apresentação.
use aspose\slides\FillType;
use aspose\slides\Images;
use aspose\slides\PictureFillMode;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 150, 150, 150, 150 ];
$rowHeights = [ 100, 100, 100, 100, 90 ];
$table = $slide->getShapes()->addTable(50, 50, $columnWidths, $rowHeights);
$image = Images::fromFile("aspose_logo.jpg");
try {
$ppImage = $presentation->getImages()->addImage($image);
} finally {
$image->dispose();
}
$table->get_Item(0, 0)->getCellFormat()->getFillFormat()->setFillType(FillType::Picture);
$table->get_Item(0, 0)->getCellFormat()->getFillFormat()->getPictureFillFormat()->setPictureFillMode(PictureFillMode::Stretch);
$table->get_Item(0, 0)->getCellFormat()->getFillFormat()->getPictureFillFormat()->getPicture()->setImage($ppImage);
$presentation->save("table_cell_with_image.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Perguntas Frequentes
Posso definir espessuras e estilos de linha diferentes para os lados de uma única célula?
Sim. As bordas top/bottom/left/right têm propriedades separadas, portanto a espessura e o estilo de cada lado podem ser diferentes.
O que acontece com a imagem se eu alterar o tamanho da coluna/linha após definir uma imagem como fundo da célula?
O comportamento depende do fill mode (stretch/tile). Com estiramento, a imagem se ajusta à nova célula; com mosaico, os ladrilhos são recalculados.
Posso atribuir um hiperlink a todo o conteúdo de uma célula?
Hyperlinks são definidos no nível de texto (porção) dentro da moldura de texto da célula ou no nível de toda a tabela/forma. Na prática, você atribui o link a uma porção ou a todo o texto da célula.
Posso definir fontes diferentes dentro de uma única célula?
Sim. A moldura de texto de uma célula suporta portions (trechos) com formatação independente — família da fonte, estilo, tamanho e cor.