Gestionar tablas de presentación en Android

Introducción

Las tablas en PowerPoint organizan la información en filas y columnas, facilitando la lectura y comparación de valores.

Aspose.Slides proporciona la clase Table, la interfaz ITable, la clase Cell, la interfaz ICell, y otros tipos que le permiten crear, actualizar y gestionar tablas en presentaciones.

Crear una tabla desde cero

Crear una tabla especificando su posición, los anchos de columna y las alturas de fila. Después de añadirla a una diapositiva, puede formatear los bordes de las celdas, combinar celdas e insertar texto.

  1. Crear una instancia de la clase Presentation.
  2. Obtener una referencia a la diapositiva por su índice.
  3. Definir una matriz de anchos de columna en puntos.
  4. Definir una matriz de alturas de fila en puntos.
  5. Añadir un objeto ITable a la diapositiva mediante el método addTable.
  6. Iterar a través de cada ICell para aplicar formato a los bordes superior, inferior, derecho e izquierdo.
  7. Combinar las dos primeras celdas de la primera fila de la tabla.
  8. Acceder a la celda combinada mediante su método getTextFrame.
  9. Establecer el texto en la celda combinada.
  10. Guardar la presentación modificada.

El siguiente ejemplo crea una tabla con tres columnas y cinco filas en (100, 50) puntos. Aplica bordes rojos con un ancho de 5 puntos, combina las dos primeras celdas de la primera fila y guarda el resultado como table.pptx.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 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)
        {
            ICellFormat cellFormat = cell.getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }

    table.mergeCells(table.get_Item(0, 0), table.get_Item(1, 0), false);
    table.get_Item(0, 0).getTextFrame().setText("Merged Cells");

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

Numeración en una tabla estándar

En una tabla estándar, los índices de celda comienzan en cero y siguen el orden (columna, fila). La primera celda tiene el índice (0, 0).

Por ejemplo, las celdas en una tabla con 4 columnas y 4 filas se numeran de la siguiente manera:

(0, 0) (1, 0) (2, 0) (3, 0)
(0, 1) (1, 1) (2, 1) (3, 1)
(0, 2) (1, 2) (2, 2) (3, 2)
(0, 3) (1, 3) (2, 3) (3, 3)

Este ejemplo crea la tabla 4 × 4 ilustrada arriba, con anchos de columna y alturas de fila de 70 puntos y bordes de celda rojos con un ancho de 5 puntos. Las coordenadas ilustran los índices de las celdas; el ejemplo deja las celdas vacías y guarda la tabla como StandardTables_out.pptx.

import com.aspose.slides.*;
import android.graphics.Color;

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);

    for (IRow row : table.getRows())
    {
        for (ICell cell : row)
        {
            ICellFormat cellFormat = cell.getCellFormat();
            cellFormat.getBorderTop().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderTop().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderTop().setWidth(5);

            cellFormat.getBorderBottom().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderBottom().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderBottom().setWidth(5);

            cellFormat.getBorderLeft().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderLeft().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderLeft().setWidth(5);

            cellFormat.getBorderRight().getFillFormat().setFillType(FillType.Solid);
            cellFormat.getBorderRight().getFillFormat().getSolidFillColor().setColor(Color.RED);
            cellFormat.getBorderRight().setWidth(5);
        }
    }

    presentation.save("StandardTables_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Acceder a una tabla existente

Las tablas se almacenan en la colección de formas de una diapositiva. Iterar a través de las formas para localizar una tabla y luego usar la interfaz ITable para leer o actualizar sus celdas.

  1. Cargar la presentación usando la clase Presentation.
  2. Obtener una referencia a la diapositiva que contiene la tabla por su índice.
  3. Iterar a través de los objetos IShape y detenerse cuando se encuentre una tabla. Si la diapositiva contiene varias tablas, usar getAlternativeText para identificar la que necesita.
  4. Actualizar el texto en la celda objetivo.
  5. Guardar la presentación modificada.

El siguiente ejemplo abre UpdateExistingTable.pptx y encuentra la primera tabla en la primera diapositiva. Establece la celda en la columna 0, fila 1 a New y guarda el resultado como table1_out.pptx. La entrada debe contener al menos una diapositiva, y la primera tabla de esa diapositiva debe tener al menos una columna y dos filas.

import com.aspose.slides.*;

Presentation presentation = new Presentation("UpdateExistingTable.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = null;

    for (IShape shape : slide.getShapes()) {
        if (shape instanceof ITable) {
            table = (ITable) shape;
            break;
        }
    }

    if (table != null) {
        table.get_Item(0, 1).getTextFrame().setText("New");
        presentation.save("table1_out.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

Para cambiar el tamaño de una fila en una tabla existente y comprender por qué su altura real puede superar la mínima solicitada, consulte Controlar la altura de fila.

Encontrar la celda que posee un marco de texto

Cuando el código genérico de procesamiento de texto recibe un ITextFrame de una tabla, use el método ITextFrame.getParentCell para obtener la ICell propietaria. Para un marco de texto de celda de tabla, ITextFrame.getParentCell devuelve el propietario y ITextFrame.getParentShape devuelve null, aunque la tabla en sí sea una forma.

Las coordenadas de la celda están disponibles mediante los métodos de solo lectura ICell.getFirstColumnIndex y ICell.getFirstRowIndex. ITextFrame.getParentCell también proporciona navegación de solo lectura: devuelve el propietario pero no cambia la propiedad. Siempre compruebe que la celda devuelta no sea null antes de usarla.

Para un ejemplo completo que identifica los propietarios de celdas de tabla y de formas, incluidas las formas asociadas a nodos de SmartArt, consulte Buscar y reemplazar texto.

Alinear texto en una tabla

Puede controlar el anclaje vertical y la dirección del texto de celdas de tabla individuales. El ejemplo en esta sección centra el texto dentro de la primera celda y lo rota 270 grados.

  1. Crear una instancia de la clase Presentation.
  2. Obtener una referencia a la diapositiva por su índice.
  3. Añadir un objeto ITable a la diapositiva.
  4. Acceder a un objeto ITextFrame de la tabla.
  5. Acceder al primer IParagraph y establecer su texto y color.
  6. Configurar el anclaje vertical de la celda y la dirección del texto usando setTextAnchorType y setTextVerticalType.
  7. Guardar la presentación modificada.

Este ejemplo crea una tabla 4 × 4 con anchos de columna de 120 puntos y alturas de fila de 100 puntos. Da formato al texto en la celda (0, 0), añade valores a las celdas restantes de la primera fila y guarda el resultado como Vertical_Align_Text_out.pptx.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 120, 120, 120, 120 };
    double[] rowHeights = { 100, 100, 100, 100 };
    ITable table = slide.getShapes().addTable(100, 50, columnWidths, rowHeights);

    table.get_Item(1, 0).getTextFrame().setText("10");
    table.get_Item(2, 0).getTextFrame().setText("20");
    table.get_Item(3, 0).getTextFrame().setText("30");

    ITextFrame textFrame = table.get_Item(0, 0).getTextFrame();
    IParagraph paragraph = textFrame.getParagraphs().get_Item(0);

    IPortion portion = paragraph.getPortions().get_Item(0);
    portion.setText("Text here");
    portion.getPortionFormat().getFillFormat().setFillType(FillType.Solid);
    portion.getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.BLACK);

    ICell cell = table.get_Item(0, 0);
    cell.setTextAnchorType(TextAnchorType.Center);
    cell.setTextVerticalType(TextVerticalType.Vertical270);

    presentation.save("Vertical_Align_Text_out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Establecer formato de texto a nivel de tabla

Utilice setTextFormat para aplicar formato de texto a todas las celdas de una tabla. Sus sobrecargas aceptan formato de porción, de párrafo y de marco de texto, por lo que puede establecer estas propiedades sin iterar por celdas individuales.

  1. Cargar la presentación usando la clase Presentation.
  2. Obtener una referencia a la diapositiva por su índice.
  3. Acceder a un objeto ITable de la diapositiva.
  4. Establecer el tamaño de fuente usando setFontHeight para el texto.
  5. Configurar la alineación del párrafo y el margen derecho usando setAlignment y setMarginRight.
  6. Establecer la dirección del texto usando setTextVerticalType.
  7. Guardar la presentación modificada.

El siguiente ejemplo abre table.pptx, que debe contener al menos una diapositiva con una tabla como su primera forma. Establece el tamaño de fuente a 25 puntos, alinea a la derecha los párrafos con un margen derecho de 20 puntos y hace que el texto sea vertical. La presentación formateada se guarda como result.pptx.

import com.aspose.slides.*;

Presentation presentation = new Presentation("table.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    ITable table = (ITable) slide.getShapes().get_Item(0);

    PortionFormat portionFormat = new PortionFormat();
    portionFormat.setFontHeight(25);
    table.setTextFormat(portionFormat);

    ParagraphFormat paragraphFormat = new ParagraphFormat();
    paragraphFormat.setAlignment(TextAlignment.Right);
    paragraphFormat.setMarginRight(20);
    table.setTextFormat(paragraphFormat);

    TextFrameFormat textFrameFormat = new TextFrameFormat();
    textFrameFormat.setTextVerticalType(TextVerticalType.Vertical);
    table.setTextFormat(textFrameFormat);

    presentation.save("result.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Obtener propiedades de estilo de tabla

Utilice getStylePreset para leer el estilo predefinido de una tabla y setStylePreset para asignarlo. Este ejemplo aplica TableStylePreset.DarkStyle1 a una tabla, muestra el valor del preset y asigna el mismo preset a una segunda tabla. Ambas tablas se guardan en table-style.pptx.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    double[] columnWidths = { 100, 150 };
    double[] rowHeights = { 5, 5, 5 };
    ITable table = slide.getShapes().addTable(10, 10, columnWidths, rowHeights);
    table.setStylePreset(TableStylePreset.DarkStyle1);

    int stylePreset = table.getStylePreset();
    System.out.println("Table style preset: " + stylePreset);

    ITable anotherTable = slide.getShapes().addTable(10, 100, columnWidths, rowHeights);
    anotherTable.setStylePreset(stylePreset);

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

Bloquear la relación de aspecto de una tabla

La relación de aspecto de una tabla es la proporción entre su anchura y su altura. Utilice setAspectRatioLocked para bloquear esta proporción en una tabla.

El siguiente ejemplo abre pres.pptx, que debe contener al menos una diapositiva con una tabla como su primera forma. Muestra el estado de bloqueo actual, habilita el bloqueo de la relación de aspecto, muestra el estado actualizado (true) y guarda el resultado como pres-out.pptx.

import com.aspose.slides.*;

Presentation presentation = new Presentation("pres.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    ITable table = (ITable) slide.getShapes().get_Item(0);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    table.getGraphicalObjectLock().setAspectRatioLocked(true);
    System.out.println("Lock aspect ratio set: " + table.getGraphicalObjectLock().getAspectRatioLocked());

    presentation.save("pres-out.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

¿Puedo habilitar la dirección de lectura de derecha a izquierda (RTL) para toda la tabla y el texto en sus celdas?

Sí. La tabla expone un método setRightToLeft, y los párrafos tienen ParagraphFormat.setRightToLeft. Usar ambos garantiza el orden y la representación correctos en RTL dentro de las celdas.

¿Cómo puedo evitar que los usuarios muevan o redimensionen una tabla en el archivo final?

Utilice shape locks para desactivar el movimiento, el redimensionado, la selección, etc. Estos bloqueos también se aplican a las tablas.

¿Se admite insertar una imagen dentro de una celda como fondo?

Sí. Puede establecer un picture fill para una celda; la imagen cubrirá el área de la celda según el modo elegido (estirar o mosaico).

Gestionar filas y columnas en tablas de PowerPoint en Android