Administrar celdas de tabla en presentaciones usando JavaScript

Visión general

Aspose.Slides permite acceder y modificar celdas de tabla en presentaciones de PowerPoint. Este artículo explica cómo identificar celdas de tabla combinadas, eliminar los bordes de la celda, 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 mediante sus propiedades y guardar la presentación modificada como archivo PPTX.

Aspose.Slides utiliza índices basados en cero para acceder a las celdas de tabla en el orden (column, row).

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. Se asume que la diapositiva y la forma existen y que la forma es una tabla. A continuación itera por todas las filas y columnas y usa isMergedCell para identificar celdas en regiones combinadas. Por cada coincidencia, imprime las coordenadas de la celda en orden row;column, getRowSpan, getColSpan, y las coordenadas iniciales de la región, getFirstRowIndex y getFirstColumnIndex.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("presentation_with_table.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const table = slide.getShapes().get_Item(0);

    const rowCount = table.getRows().size();
    for (let rowIndex = 0; rowIndex < rowCount; rowIndex++) {
        const columnCount = table.getColumns().size();
        for (let columnIndex = 0; columnIndex < columnCount; columnIndex++) {
            const cell = table.get_Item(columnIndex, rowIndex);
            if (cell.isMergedCell()) {
                console.log("Cell %d;%d belongs to a merged region with RowSpan=%d and ColSpan=%d starting at %d;%d.", rowIndex, columnIndex, cell.getRowSpan(), cell.getColSpan(), cell.getFirstRowIndex(), cell.getFirstColumnIndex());
            }
        }
    }
} finally {
    presentation.dispose();
}

Eliminar bordes de la celda de tabla

Cree una Presentation y añada una tabla a su primera diapositiva con addTable. Los anchos de columna, las alturas 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, lo que los vuelve invisibles.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [50, 50, 50, 50]);
    const rowHeights = java.newArray("double", [50, 30, 30, 30, 30]);
    const table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    for (let rowIndex = 0; rowIndex < table.getRows().size(); rowIndex++) {
        const row = table.getRows().get_Item(rowIndex);
        for (let columnIndex = 0; columnIndex < row.size(); columnIndex++) {
            const cell = row.get_Item(columnIndex);
            cell.getCellFormat().getBorderTop().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
            cell.getCellFormat().getBorderBottom().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
            cell.getCellFormat().getBorderLeft().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
            cell.getCellFormat().getBorderRight().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.NoFill));
        }
    }

    presentation.save("table.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Añadir bordes diagonales a la celda

Use getBorderDiagonalDown para dibujar una línea desde la esquina superior izquierda a la inferior derecha, y getBorderDiagonalUp para dibujar una línea desde la esquina inferior izquierda a la superior derecha. Una diagonal puede marcar un encabezado de esquina; ambas diagonales pueden formar una X para indicar que una celda no es aplicable.

Cada diagonal es un LineFormat. En su getFillFormat, use setFillType para seleccionar FillType.Solid y elija un color mediante getSolidFillColor. Establezca el ancho de la línea en puntos con setWidth.

El ejemplo crea tres celdas en una fila: una diagonal roja descendente, una diagonal azul ascendente y ambas diagonales. Deja sin cambios los bordes superior, inferior, izquierdo y derecho de la celda.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [210, 210, 210]);
    const rowHeights = java.newArray("double", [160]);
    const table = slide.getShapes().addTable(45, 130, columnWidths, rowHeights);

    const downwardBorder = table.get_Item(0, 0).getCellFormat().getBorderDiagonalDown();
    downwardBorder.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    downwardBorder.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
    downwardBorder.setWidth(3);

    const upwardBorder = table.get_Item(1, 0).getCellFormat().getBorderDiagonalUp();
    upwardBorder.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    upwardBorder.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    upwardBorder.setWidth(5);

    const crossDownwardBorder = table.get_Item(2, 0).getCellFormat().getBorderDiagonalDown();
    crossDownwardBorder.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    crossDownwardBorder.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));
    crossDownwardBorder.setWidth(3);

    const crossUpwardBorder = table.get_Item(2, 0).getCellFormat().getBorderDiagonalUp();
    crossUpwardBorder.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    crossUpwardBorder.getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    crossUpwardBorder.setWidth(5);

    presentation.save("diagonal_cell_borders.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Una diagonal es una propiedad de formato, no una división de celda. Cada celda conserva un único marco de texto, accesible mediante getTextFrame; las regiones a ambos lados de una diagonal no pueden editarse de forma independiente.

La tabla guardada, renderizada en Microsoft PowerPoint:

Tres celdas de tabla que muestran una diagonal roja de la esquina superior izquierda a la inferior derecha, una diagonal azul de la esquina inferior izquierda a la superior derecha, y ambas diagonales formando una X.

De izquierda a derecha: diagonal descendente (rojo, 3 pt), diagonal ascendente (azul, 5 pt) y ambas diagonales.

Combinar celdas de tabla

Use mergeCells para combinar un rango rectangular de celdas de tabla en una sola celda. Especifique las celdas en las esquinas superior‑izquierda e 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, use 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, por lo que los índices de las celdas fuera del rango no cambian.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [70, 70, 70, 70]);
    const rowHeights = java.newArray("double", [70, 70, 70, 70]);
    const 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", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Dividir celdas de tabla

Dividir celdas en el ejemplo anterior preserva 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 de los 70 puntos de ancho de la celda se pasa para crear dos celdas de ancho igual.

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 ahora tiene cinco columnas: las celdas que originalmente estaban en las columnas 2 y 3 pasan a las columnas 3 y 4, respectivamente. Los índices de fila permanecen sin cambios. Use estos índices de columna actualizados al acceder a las celdas tras la división.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [70, 70, 70, 70]);
    const rowHeights = java.newArray("double", [70, 70, 70, 70]);
    const 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", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Una celda de 70 puntos sin combinar se divide en dos celdas de 35 puntos, añadiendo una quinta columna de cuadrícula y desplazando los índices a su derecha.

La división de ancho afecta a la celda (1, 1), usando índices basados en cero (columna, fila). Otras filas mantienen una celda que abarca ambas nuevas posiciones de columna.

Dividir celdas combinadas por fila o columna

Para preparar celdas de plantilla combinadas para la población de datos, use 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:

El ejemplo asume que una presentación tiene una tabla como primera forma en la primera diapositiva, con (1, 2) y (1, 3) combinados verticalmente. Partiendo desde la posición inferior, usa getFirstColumnIndex y getFirstRowIndex para localizar el origen y comprueba ambos alcances. splitByRowSpan(1) separa entonces las filas 2 y 3 para los nombres de producto. Para una combinación horizontal de dos columnas, use splitByColSpan(1) en su lugar.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation("table_template.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const table = slide.getShapes().get_Item(0);

    const selectedCell = table.get_Item(1, 3);
    const firstColumnIndex = selectedCell.getFirstColumnIndex();
    const firstRowIndex = selectedCell.getFirstRowIndex();
    const mergedCell = table.get_Item(firstColumnIndex, firstRowIndex);

    if (mergedCell.isMergedCell() && mergedCell.getRowSpan() == 2 && mergedCell.getColSpan() == 1) {
        mergedCell.splitByRowSpan(1);

        // Recuperar las celdas resultantes de la tabla tras la división.
        const upperCell = table.get_Item(firstColumnIndex, firstRowIndex);
        const lowerCell = table.get_Item(firstColumnIndex, firstRowIndex + 1);
        console.log("Upper cell merged: " + upperCell.isMergedCell());
        console.log("Lower cell merged: " + lowerCell.isMergedCell());

        upperCell.getTextFrame().setText("Product A");
        lowerCell.getTextFrame().setText("Product B");

        presentation.save("split_template.pptx", aspose.slides.SaveFormat.Pptx);
    } else {
        console.log("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 un alcance de 1 y isMergedCell muestra false. Regiones mayores pueden permanecer parcialmente combinadas después de 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 celda, como relleno, bordes y márgenes. Complete las celdas después de dividirlas 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 más detalles.

Dividir una celda a una altura específica

splitByHeight toma la altura de la parte superior en puntos. splitByRowSpan toma el número de filas de la cuadrícula existentes en la parte superior. Para centrar una celda de 40 puntos en la columna derecha, reste 40 a la altura real de la celda y distribuya el espacio restante de manera equitativa arriba y abajo de ella.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [160, 160]);
    const rowHeights = java.newArray("double", [140]);

    const table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);
    table.get_Item(0, 0).getTextFrame().setText("Left");

    const height = table.get_Item(1, 0).getHeight();
    const margin = (height - 40) / 2;

    table.get_Item(1, 0).splitByHeight(margin);
    table.get_Item(1, 1).splitByHeight(40);
    table.get_Item(1, 1).getTextFrame().setText("Middle");

    presentation.save("split_by_height.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

La primera división añade una fila a la cuadrícula y deja los 90 puntos inferiores en la celda (1, 1). La segunda división divide esa celda en una celda central de 40 puntos y una celda inferior de 50 puntos. La columna derecha tiene ahora tres celdas con alturas de 50, 40 y 50 puntos de arriba a abajo. La celda izquierda abarca las tres filas y conserva su altura original de 140 puntos.

La celda izquierda abarca toda la altura de la tabla junto a tres celdas con el medio en el centro.

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. Usa 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.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [150, 150, 150, 150]);
    const rowHeights = java.newArray("double", [50, 50, 50, 50, 50]);
    const table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);

    const cell = table.get_Item(2, 3);
    cell.getCellFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    cell.getCellFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "RED"));

    presentation.save("cell_background_color.pptx", aspose.slides.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 proporción. Los anchos de columna y las alturas de fila están en puntos. La imagen cargada se elimina en un bloque finally después de añadirse a la presentación.

const aspose = { slides: require("aspose.slides.via.java") };
const java = require("java");

const presentation = new aspose.slides.Presentation();
try {
    const slide = presentation.getSlides().get_Item(0);

    const columnWidths = java.newArray("double", [150, 150, 150, 150]);
    const rowHeights = java.newArray("double", [100, 100, 100, 100, 90]);
    const table = slide.getShapes().addTable(50, 50, columnWidths, rowHeights);

    let ppImage;
    const image = aspose.slides.Images.fromFile("aspose_logo.jpg");
    try {
        ppImage = presentation.getImages().addImage(image);
    } finally {
        image.dispose();
    }

    table.get_Item(0, 0).getCellFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().setPictureFillMode(aspose.slides.PictureFillMode.Stretch);
    table.get_Item(0, 0).getCellFormat().getFillFormat().getPictureFillFormat().getPicture().setImage(ppImage);

    presentation.save("table_cell_with_image.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Preguntas frecuentes

¿Puedo establecer diferentes grosores y estilos de línea para los distintos lados de una sola celda?

Sí. Los bordes top/bottom/left/right tienen propiedades separadas, por lo que el grosor y el estilo de cada lado pueden variar.

¿Qué ocurre con la imagen si cambio el tamaño de la columna/fila después de establecer una foto como fondo de la celda?

El comportamiento depende del fill mode (stretch/tile). Con estiramiento, la imagen se adapta a la nueva celda; con mosaico, los mosaicos se recalculan.

¿Puedo asignar un hipervínculo a todo el contenido de una celda?

Hyperlinks 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 sola celda?

Sí. El marco de texto de una celda admite portions (segmentos) con formato independiente: familia de fuente, estilo, tamaño y color.