Gestire le celle della tabella nelle presentazioni usando PHP
Panoramica
Aspose.Slides consente di accedere e modificare le celle di una tabella nelle presentazioni PowerPoint. Questo articolo spiega come identificare le celle di tabella unite, rimuovere i bordi delle celle, gestire la numerazione delle celle dopo l’unione o la divisione, cambiare il colore di sfondo di una cella e aggiungere un’immagine all’interno di una cella di tabella. Gli esempi mostrano come creare o aprire una presentazione, ottenere una tabella da una diapositiva, aggiornare la formattazione delle celle tramite le proprietà della cella e salvare la presentazione modificata come file PPTX.
Aspose.Slides utilizza indici a base zero per accedere alle celle della tabella nell’ordine (column, row).
Identificare una cella di tabella unita
L’esempio apre una presentazione esistente e accede alla prima forma sulla prima diapositiva trattandola come una tabella. Si presume che la diapositiva e la forma esistano e che la forma sia una tabella. Quindi itera attraverso tutte le righe e le colonne e utilizza isMergedCell per identificare le celle nelle regioni unite. Per ogni corrispondenza, stampa le coordinate della cella nell’ordine row;column, getRowSpan, getColSpan, e le coordinate di inizio della regione, 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();
}
Rimuovere i bordi delle celle della tabella
Crea un Presentation e aggiungi una tabella alla sua prima diapositiva con addTable. Le larghezze delle colonne, le altezze delle righe e la posizione della tabella sono specificate in punti. L’esempio imposta tutti e quattro i bordi delle celle su FillType::NoFill, rendendoli invisibili.
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();
}
Aggiungere bordi diagonali alle celle
Usa getBorderDiagonalDown per tracciare una linea dall’angolo in alto a sinistra a quello in basso a destra, e getBorderDiagonalUp per tracciare una linea dall’angolo in basso a sinistra a quello in alto a destra. Una diagonale può contrassegnare un’intestazione d’angolo; entrambe le diagonali possono formare una X per indicare che la cella non è applicabile.
Ogni diagonale ha il proprio LineFormat. Nel suo getFillFormat, usa setFillType per selezionare FillType::Solid e scegliere un colore tramite getSolidFillColor. Imposta lo spessore della linea in punti con setWidth.
L’esempio crea tre celle in una riga: una diagonale rossa verso il basso, una diagonale blu verso l’alto e entrambe le diagonali. Lascia invariati i bordi superiore, inferiore, sinistro e destro delle celle.
use aspose\slides\FillType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 210, 210, 210 ];
$rowHeights = [ 160 ];
$table = $slide->getShapes()->addTable(45, 130, $columnWidths, $rowHeights);
$downwardBorder = $table->get_Item(0, 0)->getCellFormat()->getBorderDiagonalDown();
$downwardBorder->getFillFormat()->setFillType(FillType::Solid);
$downwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$downwardBorder->setWidth(3);
$upwardBorder = $table->get_Item(1, 0)->getCellFormat()->getBorderDiagonalUp();
$upwardBorder->getFillFormat()->setFillType(FillType::Solid);
$upwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
$upwardBorder->setWidth(5);
$crossDownwardBorder = $table->get_Item(2, 0)->getCellFormat()->getBorderDiagonalDown();
$crossDownwardBorder->getFillFormat()->setFillType(FillType::Solid);
$crossDownwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$crossDownwardBorder->setWidth(3);
$crossUpwardBorder = $table->get_Item(2, 0)->getCellFormat()->getBorderDiagonalUp();
$crossUpwardBorder->getFillFormat()->setFillType(FillType::Solid);
$crossUpwardBorder->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLUE);
$crossUpwardBorder->setWidth(5);
$presentation->save("diagonal_cell_borders.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Una diagonale modifica solo la formattazione della cella. Ogni cella mantiene un unico frame di testo, accessibile tramite getTextFrame. Le regioni su entrambi i lati di una diagonale non possono essere modificate indipendentemente.
The saved table, rendered in Microsoft PowerPoint:

Da sinistra a destra: diagonale verso il basso (rossa, 3 pt), diagonale verso l’alto (blu, 5 pt) e entrambe le diagonali.
Unire le celle della tabella
Usa mergeCells per combinare un intervallo rettangolare di celle della tabella in un’unica cella. Specifica le celle negli angoli in alto a sinistra e in basso a destra dell’intervallo. L’ultimo argomento controlla se l’unione può includere celle al di fuori dell’intervallo specificato; false mantiene l’unione all’interno di quell’intervallo.
L’esempio crea una tabella 4x4 con colonne e righe di 70 punti, quindi unisce le quattro celle centrali da (1, 1) a (2, 2). La cella risultante occupa due colonne e due righe, mentre la griglia sottostante della tabella mantiene quattro colonne e quattro righe. Per accedere al contenuto o alla formattazione della cella unita, usa la sua posizione in alto a sinistra: $table->get_Item(1, 1) in questo esempio. Le altre posizioni nell’intervallo unito rimangono parte della griglia della tabella, quindi gli indici delle celle al di fuori dell’intervallo non cambiano.
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();
}
Dividere le celle della tabella
L’unione delle celle nell’esempio precedente conserva la griglia della tabella. Dividere una cella può introdurre una nuova colonna nella griglia e modificare gli indici delle colonne delle celle alla sua destra. Aspose.Slides segue il modello di griglia delle tabelle di PowerPoint.
Questo esempio crea una tabella 4x4 con colonne e righe di 70 punti e chiama splitByWidth sulla cella (1, 1). Metà della larghezza di 70 punti della cella viene passata per creare due celle di larghezza uguale.
Dopo questa divisione, le due metà sono accessibili come $table->get_Item(1, 1) e $table->get_Item(2, 1). La griglia della tabella ora ha cinque colonne: le celle originariamente nelle colonne 2 e 3 si spostano rispettivamente alle colonne 3 e 4. Gli indici delle righe rimangono invariati. Usa questi indici di colonna aggiornati quando accedi alle celle dopo la divisione.
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();
}
La divisione della larghezza influisce sulla cella (1, 1), usando indici a base zero (colonna, riga). Le altre righe mantengono una cella che occupa entrambe le nuove posizioni di colonna.
Dividere le celle unite per riga o per estensione di colonna
Per preparare le celle modello unite per la popolazione dei dati, usa splitByRowSpan per dividere lungo un confine di riga esistente, o splitByColSpan per dividere lungo un confine di colonna.
L’argomento index conta le righe nella parte superiore o le colonne nella parte sinistra della divisione; è relativo alla regione unita:
- Divisione di riga:
0 < index <getRowSpan. - Divisione di colonna:
0 < index <getColSpan.
L’esempio prevede che una presentazione abbia una tabella come prima forma sulla prima diapositiva, con (1, 2) e (1, 3) uniti verticalmente. Partendo dalla posizione inferiore, utilizza getFirstColumnIndex e getFirstRowIndex per individuare l’origine e verifica entrambe le estensioni. splitByRowSpan(1) separa quindi le righe 2 e 3 per i nomi dei prodotti. Per un’unione orizzontale a due colonne, usa splitByColSpan(1) invece.
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);
// Recupera le celle risultanti dalla tabella dopo la divisione.
$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();
}
La griglia della tabella e gli indici delle celle circostanti rimangono invariati. Recupera le celle risultanti usando le loro coordinate; qui, entrambe hanno estensioni di 1 e isMergedCell stampa false. Regioni più grandi possono rimanere parzialmente unite dopo una divisione.
Il testo originale e la sua formattazione rimangono nella cella superiore (o sinistra); la nuova cella è vuota ma eredita la formattazione della cella come riempimento, bordi e margini. Popola le celle dopo la divisione e imposta esplicitamente qualsiasi formattazione del testo richiesta.
La presentazione salvata contiene celle separate “Product A” e “Product B” con il formato della cella del modello mantenuto. Vedi il Cell API Reference per i dettagli.
Dividere una cella a un’altezza specifica
splitByHeight prende l’altezza della parte superiore in punti. splitByRowSpan prende il numero di righe della griglia esistenti nella parte superiore. Per centrare una cella di 40 punti nella colonna destra, sottrai 40 dall’altezza reale della cella e dividi lo spazio rimanente equamente sopra e sotto.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$columnWidths = [ 160, 160 ];
$rowHeights = [ 140 ];
$table = $slide->getShapes()->addTable(50, 50, $columnWidths, $rowHeights);
$table->get_Item(0, 0)->getTextFrame()->setText("Left");
$rightCell = $table->get_Item(1, 0);
$height = java_values($rightCell->getHeight());
$margin = ($height - 40) / 2;
$rightCell->splitByHeight($margin);
$table->get_Item(1, 1)->splitByHeight(40);
$table->get_Item(1, 1)->getTextFrame()->setText("Middle");
$presentation->save("split_by_height.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
La prima divisione aggiunge una riga alla griglia e lascia i 90 punti inferiori nella cella (1, 1). La seconda divisione suddivide quella cella in una cella intermedia di 40 punti e una cella inferiore di 50 punti. La colonna di destra ora ha tre celle con altezze di 50, 40 e 50 punti dall’alto verso il basso. La cella sinistra si estende su tutte e tre le righe e mantiene la sua altezza originale di 140 punti.

Modificare il colore di sfondo della cella della tabella
Questo esempio crea una tabella con colonne di 150 punti e righe di 50 punti. Usa setFillType per selezionare un riempimento solido e imposta il colore restituito da getSolidFillColor a rosso per la cella (2, 3), nella terza colonna e quarta riga.
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();
}
Aggiungere un’immagine all’interno di una cella della tabella
Posiziona l’immagine di input nella directory di lavoro prima di eseguire questo esempio. Carica l’immagine con Images::fromFile e la aggiunge alla collezione di immagini della presentazione con addImage. Quindi assegna l’immagine al riempimento immagine della cella (0, 0), la prima cella della tabella.
PictureFillMode::Stretch allunga l’immagine per riempire la cella, il che può modificare il suo rapporto d’aspetto. Le larghezze delle colonne e le altezze delle righe sono in punti. L’immagine caricata viene rilasciata in un blocco finally dopo esser stata aggiunta alla presentazione.
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();
}
FAQ
Posso impostare spessori e stili di linea diversi per i vari lati di una singola cella?
Sì. I bordi top/bottom/left/right hanno proprietà separate, quindi lo spessore e lo stile di ciascun lato possono differire.
Cosa succede all’immagine se modifico la dimensione della colonna/riga dopo aver impostato un’immagine come sfondo della cella?
Il comportamento dipende dal fill mode (stretch/tile). Con lo stretching, l’immagine si adatta alla nuova cella; con il tiling, le piastrelle vengono ricalcolate.
Posso assegnare un collegamento ipertestuale a tutto il contenuto di una cella?
Hyperlinks vengono impostati a livello di testo (porzione) all’interno del frame di testo della cella o a livello dell’intera tabella/forma. In pratica, assegni il collegamento a una porzione o a tutto il testo nella cella.
Posso impostare caratteri diversi all’interno di una singola cella?
Sì. Il frame di testo di una cella supporta portions (run) con formattazione indipendente — famiglia di caratteri, stile, dimensione e colore.