Trabajar con Columnas y Filas

Para tener más control sobre el funcionamiento de las tablas, aprenda a manipular columnas y filas.

Buscar el Índice del Elemento de la Tabla

Las columnas, filas y celdas se administran accediendo al nodo de documento seleccionado por su índice. Encontrar el índice de cualquier nodo implica recopilar todos los nodos secundarios del tipo de elemento del nodo principal y luego usar el método IndexOf para encontrar el índice del nodo deseado en la colección.

Buscar el Índice de una Tabla en un Documento

A veces, es posible que deba realizar cambios en una tabla en particular de un documento. Para hacer esto, puede hacer referencia a una tabla por su índice.

El siguiente ejemplo de código muestra cómo recuperar el índice de una tabla en un documento:

Hallar el Índice de una Fila en una Tabla

Del mismo modo, es posible que deba realizar cambios en una fila específica de una tabla seleccionada. Para hacer esto, también puede hacer referencia a una fila por su índice.

El siguiente ejemplo de código muestra cómo recuperar el índice de una fila en una tabla:

Encuentra el Índice de una Celda en una Fila

Finalmente, es posible que deba realizar cambios en una celda específica, y también puede hacerlo mediante el índice de celda.

El siguiente ejemplo de código muestra cómo recuperar el índice de una celda en una fila:

Trabajar con Columnas

En el Aspose.Words Modelo de Objetos de documento (DOM), el nodo Table consta de Row nodos y luego Cell nodos. Por lo tanto, en el Modelo de Objetos de Documento de Aspose.Words, como en los documentos de Word, no existe el concepto de columna.

Por diseño, las filas de la tabla en Microsoft Word y Aspose.Words son completamente independientes, y las propiedades y operaciones básicas están contenidas solo en las filas y celdas de la tabla. Esto le da a las tablas la capacidad de tener algunos atributos interesantes:

• Cada fila de la tabla puede tener un número completamente diferente de celdas
• Verticalmente, las celdas de cada fila pueden tener diferentes anchos.
• Es posible unir tablas con diferentes formatos de fila y número de celdas

Cualquier operación realizada en columnas son en realidad “accesos directos” que realizan la operación cambiando colectivamente las celdas de la fila de tal manera que parece que se están aplicando a las columnas. Es decir, puede realizar operaciones en columnas simplemente iterando sobre el mismo índice de celda de fila de tabla.

El siguiente ejemplo de código simplifica dichas operaciones al probar una clase facade que recopila las celdas que componen una “columna” de una tabla:

El siguiente ejemplo de código muestra cómo insertar una columna en blanco en una tabla:

El siguiente ejemplo de código muestra cómo eliminar una columna de una tabla en un documento:

Especificar Filas como Filas de Encabezado

Puede optar por repetir la primera fila de la tabla como Fila de encabezado solo en la primera página o en cada página si la tabla está dividida en varias. En Aspose.Words, puede repetir la fila del encabezado en cada página utilizando la propiedad HeadingFormat.

También puede marcar varias filas de encabezado si dichas filas se encuentran una tras otra al principio de la tabla. Para hacer esto, debe aplicar las propiedades HeadingFormat a estas filas.

Tenga en cuenta que las filas de encabezado no funcionan en tablas anidadas. Es decir, si tiene una tabla dentro de otra tabla, esta configuración no tendrá ningún efecto. Es una limitación de Microsoft Word que no permite esto, no Aspose.Words.

El siguiente ejemplo de código muestra cómo crear una tabla que incluya filas de encabezado que se repitan en las páginas siguientes:

Evite que las Tablas y Filas se Dividan en Páginas

Hay ocasiones en las que el contenido de una tabla no debe dividirse en páginas. Por ejemplo, si un título está encima de una tabla, el título y la tabla siempre deben mantenerse juntos en la misma página para preservar la apariencia adecuada.

Hay dos técnicas separadas que son útiles para lograr esta funcionalidad:

• Allow row break across pages, que se aplica a las filas de la tabla
• Keep with next, que se aplica a párrafos en celdas de tabla

De forma predeterminada, las propiedades anteriores están deshabilitadas.

Evita que una Fila se Rompa En las Páginas

Esto implica restringir el contenido dentro de las celdas de una fila para que no se divida en una página. En Microsoft Word, esto se puede encontrar en Propiedades de la tabla como la opción “Permitir que la fila se divida entre páginas”. En Aspose.Words esto se encuentra debajo del objeto RowFormat de a Row como la propiedad RowFormat.AllowBreakAcrossPages.

El siguiente ejemplo de código muestra cómo deshabilitar la división de filas en páginas para cada fila de una tabla:

Evita que una Tabla se Divida en Páginas

Para evitar que la tabla se divida en páginas, debemos especificar que queremos que el contenido contenido en la tabla permanezca unido.

Para hacer esto, Aspose.Words usa un método que permite a los usuarios seleccionar una tabla y habilitar el parámetro KeepWithNext en verdadero para cada párrafo dentro de las celdas de la tabla. La excepción es el último párrafo de la tabla, que debe establecerse en falso.

El siguiente ejemplo de código muestra cómo configurar una tabla para que permanezcan juntas en la misma página: