Gestionar celdas de tabla en presentaciones en Android
Visión general
Aspose.Slides le permite acceder y modificar celdas de tabla en presentaciones de PowerPoint. Este artículo explica cómo identificar celdas de tabla fusionadas, eliminar los bordes de las celdas, trabajar con la numeración de celdas después de combinar o dividir celdas, cambiar el color de fondo de una celda y añadir una imagen dentro de una celda de tabla. Los ejemplos muestran cómo crear o abrir una presentación, obtener una tabla de una diapositiva, actualizar el formato de la celda a través de sus propiedades y guardar la presentación modificada como un archivo PPTX.
Aspose.Slides utiliza índices basados en cero para acceder a las celdas de tabla en el orden (columna, fila).
Identificar una celda de tabla combinada
El ejemplo abre una presentación existente y accede a la primera forma en la primera diapositiva como una tabla. Asume que la diapositiva y la forma existen y que la forma es una tabla. Luego itera a través de todas las filas y columnas y utiliza isMergedCell para identificar celdas en regiones combinadas. Para cada coincidencia, imprime las coordenadas de la celda en orden fila;columna, getRowSpan, getColSpan, y las coordenadas iniciales de la región, getFirstRowIndex y getFirstColumnIndex.
import com.aspose.slides.*;
Presentation presentation = new Presentation("presentation_with_table.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
ITable table = (ITable) slide.getShapes().get_Item(0);
int rowCount = table.getRows().size();
for (int rowIndex = 0; rowIndex < rowCount; rowIndex++)
{
int columnCount = table.getColumns().size();
for (int columnIndex = 0; columnIndex < columnCount; columnIndex++)
{
ICell cell = table.get_Item(columnIndex, rowIndex);
if (cell.isMergedCell())
{
System.out.printf("Cell %d;%d belongs to a merged region with RowSpan=%d and ColSpan=%d starting at %d;%d.%n", rowIndex, columnIndex, cell.getRowSpan(), cell.getColSpan(), cell.getFirstRowIndex(), cell.getFirstColumnIndex());
}
}
}
} finally {
presentation.dispose();
}
Eliminar bordes de celdas de tabla
Cree una Presentation y añada una tabla a su primera diapositiva con addTable. Los anchos de columna, altos de fila y la posición de la tabla se especifican en puntos. El ejemplo establece los cuatro bordes de la celda a FillType.NoFill, haciéndolos invisibles.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
double[] columnWidths = { 50, 50, 50, 50 };
double[] rowHeights = { 50, 30, 30, 30, 30 };
ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);
for (IRow row : table.getRows())
for (ICell cell : row)
{
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();
}
Combinar celdas de tabla
Utilice mergeCells para combinar un rango rectangular de celdas de tabla en una sola celda. Especifique las celdas de la esquina superior izquierda y la esquina inferior derecha del rango. El argumento final controla si la combinación puede incluir celdas fuera del rango especificado; false mantiene la combinación dentro de ese rango.
El ejemplo crea una tabla de 4 × 4 con columnas y filas de 70 puntos, y luego combina las cuatro celdas centrales desde (1, 1) hasta (2, 2). La celda resultante abarca dos columnas y dos filas, mientras que la cuadrícula subyacente de la tabla conserva cuatro columnas y cuatro filas. Para acceder al contenido o formato de la celda combinada, utilice su posición superior izquierda: table.get_Item(1, 1) en este ejemplo. Las demás posiciones del rango combinado siguen formando parte de la cuadrícula de la tabla, por lo que los índices de las celdas fuera del rango no cambian.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
double[] columnWidths = { 70, 70, 70, 70 };
double[] rowHeights = { 70, 70, 70, 70 };
ITable 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 celdas de tabla
Combinar celdas en el ejemplo anterior conserva la cuadrícula de la tabla. Dividir una celda puede introducir una nueva columna en la cuadrícula y cambiar los índices de columna de las celdas a su derecha. Aspose.Slides sigue el modelo de cuadrícula de tablas de PowerPoint.
Este ejemplo crea una tabla de 4 × 4 con columnas y filas de 70 puntos y llama a splitByWidth sobre la celda (1, 1). La mitad del ancho de 70 puntos de la celda se pasa para crear dos celdas de igual anchura.
Después de esta división, las dos mitades se acceden como table.get_Item(1, 1) y table.get_Item(2, 1). La cuadrícula de la tabla ahora tiene cinco columnas: las celdas que estaban originalmente en las columnas 2 y 3 pasan a las columnas 3 y 4, respectivamente. Los índices de fila permanecen sin cambios. Utilice estos índices de columna actualizados al acceder a las celdas después de la división.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
double[] columnWidths = { 70, 70, 70, 70 };
double[] rowHeights = { 70, 70, 70, 70 };
ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);
table.get_Item(1, 1).splitByWidth(table.get_Item(1, 1).getWidth() / 2);
presentation.save("split_cells.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Dividir celdas combinadas por extensión de fila o columna
Para preparar celdas de plantilla combinadas para la inserción de datos, utilice splitByRowSpan para dividir a lo largo de un límite de fila existente, o splitByColSpan para dividir a lo largo de un límite de columna.
El argumento index cuenta filas en la parte superior o columnas en la parte izquierda de la división; es relativo a la región combinada:
- División de fila:
0 < index <getRowSpan. - División de columna:
0 < index <getColSpan.
El ejemplo supone que una presentación tiene una tabla como la primera forma en la primera diapositiva, con (1, 2) y (1, 3) combinados verticalmente. Partiendo desde la posición inferior, utiliza getFirstColumnIndex y getFirstRowIndex para localizar el origen y verifica ambas extensiones. splitByRowSpan(1) separa entonces las filas 2 y 3 para los nombres de productos. Para una combinación horizontal de dos columnas, use splitByColSpan(1) en su lugar.
import com.aspose.slides.*;
Presentation presentation = new Presentation("table_template.pptx");
try {
ISlide slide = presentation.getSlides().get_Item(0);
ITable table = (ITable) slide.getShapes().get_Item(0);
ICell selectedCell = table.get_Item(1, 3);
int firstColumnIndex = selectedCell.getFirstColumnIndex();
int firstRowIndex = selectedCell.getFirstRowIndex();
ICell mergedCell = table.get_Item(firstColumnIndex, firstRowIndex);
if (mergedCell.isMergedCell() && mergedCell.getRowSpan() == 2 && mergedCell.getColSpan() == 1)
{
mergedCell.splitByRowSpan(1);
// Recupera las celdas resultantes de la tabla después de la división.
ICell upperCell = table.get_Item(firstColumnIndex, firstRowIndex);
ICell lowerCell = table.get_Item(firstColumnIndex, firstRowIndex + 1);
System.out.println("Upper cell merged: " + upperCell.isMergedCell());
System.out.println("Lower cell merged: " + lowerCell.isMergedCell());
upperCell.getTextFrame().setText("Product A");
lowerCell.getTextFrame().setText("Product B");
presentation.save("split_template.pptx", SaveFormat.Pptx);
}
else
{
System.out.println("Select a merged region spanning exactly two rows and one column.");
}
} finally {
presentation.dispose();
}
La cuadrícula de la tabla y los índices de celdas circundantes permanecen sin cambios. Recupere las celdas resultantes por sus coordenadas; aquí, ambas tienen extensiones de 1 y isMergedCell muestra false. Las regiones más grandes pueden quedar parcialmente combinadas tras una división.
El texto original y su formato permanecen en la celda superior (o izquierda); la nueva celda está vacía pero hereda el formato de la celda, como relleno, bordes y márgenes. Rellene las celdas después de dividir y establezca explícitamente cualquier formato de texto necesario.
La presentación guardada contiene celdas separadas “Product A” y “Product B” con el formato de celda de la plantilla conservado. Consulte la Cell API Reference para obtener más detalles.
Cambiar el color de fondo de la celda de tabla
Este ejemplo crea una tabla con columnas de 150 puntos y filas de 50 puntos. Utiliza setFillType para seleccionar un relleno sólido y establece el color devuelto por getSolidFillColor a rojo para la celda (2, 3), en la tercera columna y cuarta fila.
import com.aspose.slides.*;
import android.graphics.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
double[] columnWidths = { 150, 150, 150, 150 };
double[] rowHeights = { 50, 50, 50, 50, 50 };
ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);
ICell cell = table.get_Item(2, 3);
cell.getCellFormat().getFillFormat().setFillType(FillType.Solid);
cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(Color.RED);
presentation.save("cell_background_color.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Añadir una imagen dentro de una celda de tabla
Coloque la imagen de entrada en el directorio de trabajo antes de ejecutar este ejemplo. Carga la imagen con Images.fromFile y la añade a la colección de imágenes de la presentación con addImage. Luego asigna la imagen al relleno de imagen de la celda (0, 0), la primera celda de la tabla.
PictureFillMode.Stretch estira la imagen para llenar la celda, lo que puede cambiar su relación de aspecto. Los anchos de columna y los altos de fila están en puntos. La imagen cargada se libera en un bloque finally después de añadirse a la presentación.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
double[] columnWidths = { 150, 150, 150, 150 };
double[] rowHeights = { 100, 100, 100, 100, 90 };
ITable table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);
IPPImage ppImage;
IImage 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
¿Puedo establecer diferentes grosores y estilos de línea para los distintos lados de una única celda?
Sí. Los bordes superior, inferior, izquierda, derecha tienen propiedades independientes, por lo que el grosor y el estilo de cada lado pueden diferir.
¿Qué ocurre con la imagen si cambio el tamaño de la columna/fila después de establecer una imagen como fondo de la celda?
El comportamiento depende del modo de relleno (stretch/tile). Con el estiramiento, la imagen se ajusta a la nueva celda; con el mosaico, los fragmentos se recalculan.
¿Puedo asignar un hipervínculo a todo el contenido de una celda?
Hipervínculos se establecen a nivel de texto (porción) dentro del marco de texto de la celda o a nivel de toda la tabla/forma. En la práctica, asigna el enlace a una porción o a todo el texto de la celda.
¿Puedo establecer diferentes fuentes dentro de una única celda?
Sí. El marco de texto de una celda admite porciones (corridas) con formato independiente: familia de fuente, estilo, tamaño y color.