Combinar Celdas de Tabla

A veces, ciertas filas de una tabla requieren un encabezado o grandes bloques de texto que ocupan todo el ancho de la tabla. Para un diseño adecuado de la tabla, el usuario puede fusionar varias celdas de la tabla en una sola. Aspose.Words admite celdas combinadas cuando se trabaja con todos los formatos de entrada, incluida la importación de contenido HTML.

Cómo Combinar Celdas de Tabla

En Aspose.Words, las celdas combinadas se representan mediante las siguientes propiedades de la clase CellFormat:

• HorizontalMerge que describe si la celda es parte de una combinación horizontal de celdas
• VerticalMerge que describe si la celda es parte de una fusión vertical de celdas

Los valores de estas propiedades determinan el comportamiento de fusión de las celdas:

• La primera celda de una secuencia de celdas combinadas tendrá CellMerge.First
• Cualquier celda combinada posteriormente tendrá CellMerge.Previous
• Una celda que no esté fusionada tendrá CellMerge.None

A veces, al cargar celdas de documentos existentes en una tabla, aparecerán fusionadas. Sin embargo, en realidad puede ser una celda larga; a veces Microsoft Word exporta celdas combinadas de esta manera. Esto puede resultar confuso cuando se intenta trabajar con celdas individuales, pero no parece haber ningún patrón particular sobre cuándo sucede esto.

Comprobación de si una celda está fusionada

Para verificar si una celda es parte de una secuencia de celdas combinadas, simplemente verificamos las propiedades HorizontalMerge y VerticalMerge.

El siguiente ejemplo de código muestra cómo imprimir el tipo de combinación de celdas horizontal y vertical:

Fusionar Celdas De La Tabla Cuando Se Usa DocumentBuilder

Para fusionar celdas en una tabla creada con DocumentBuilder, debe establecer el tipo de fusión apropiado para cada celda donde se espera la fusión: primero CellMerge.First y luego CellMerge.Previous.

Además, debe recordar borrar la configuración de combinación para aquellas celdas donde no se requiere combinación; esto se puede hacer configurando la primera celda sin combinación en CellMerge.None. Si no se hace esto, se fusionarán todas las celdas de la tabla.

El siguiente ejemplo de código muestra cómo crear una tabla con dos filas donde las celdas de la primera fila se fusionan horizontalmente:

El siguiente ejemplo de código muestra cómo crear una tabla de dos columnas donde las celdas de la primera columna se fusionan verticalmente:

Combinar Celdas de Tabla en Otros Casos

En otras situaciones en las que no se usa DocumentBuilder, como en una tabla existente, fusionar celdas de la manera anterior puede no ser tan fácil. En cambio, podemos ajustar las operaciones básicas involucradas en la aplicación de propiedades de combinación a las celdas en un método que facilita mucho la tarea. Este método es similar al método de automatización de combinación, que se llama para combinar un rango de celdas en una tabla.

El siguiente código fusionará las celdas de la tabla en el rango especificado, comenzando en la celda dada y terminando en la celda final. En este caso, el rango puede abarcar varias filas o columnas:

El siguiente ejemplo de código muestra cómo fusionar un rango de celdas entre dos celdas especificadas:

Celdas Combinadas Verticales y Horizontales en la Tabla HTML

Como hemos dicho en artículos anteriores, una tabla en Microsoft Word es un conjunto de filas independientes. Cada fila tiene un conjunto de celdas que son independientes de las celdas de otras filas. Por lo tanto, en la tabla Microsoft Word no existe un objeto como “columna”, y “1ra columna” es algo así como “el conjunto de las 1ras celdas de cada fila de la tabla”. Esto permite a los usuarios tener una tabla en la que, por ejemplo, la primera fila consta de dos celdas: 2 cm y 1 cm, y la segunda fila consta de dos celdas diferentes: 1 cm y 2 cm de ancho. Y Aspose.Words apoya este concepto de tablas.

Una tabla en HTML tiene una estructura esencialmente diferente: cada fila tiene el mismo número de celdas y (es importante para la tarea) cada celda tiene el ancho de la columna correspondiente, el mismo para todas las celdas de una columna. Entonces, si HorizontalMerge y VerticalMerge devuelven un valor incorrecto, use el siguiente ejemplo de código:

Convertir a Celdas Combinadas Horizontalmente

A veces no es posible detectar qué celdas se fusionan porque algunas versiones más recientes de Microsoft Word ya no usan los indicadores de fusión cuando las celdas se fusionan horizontalmente. Pero para situaciones en las que las celdas se fusionan en una celda horizontalmente por su ancho usando indicadores de fusión, Aspose.Words proporciona el método ConvertToHorizontallyMergedCells para convertir celdas. Este método simplemente transforma la tabla y agrega nuevas celdas según sea necesario.

El siguiente ejemplo de código muestra el método anterior en funcionamiento: