Fusionner les cellules du tableau

Parfois, certaines lignes d’un tableau nécessitent un en-tête ou de gros blocs de texte occupant toute la largeur du tableau. Pour une conception correcte du tableau, l’utilisateur peut fusionner plusieurs cellules du tableau en une seule. Aspose.Words prend en charge les cellules fusionnées lorsque vous travaillez avec tous les formats d’entrée, y compris l’importation de contenu HTML.

Comment fusionner des cellules de tableau

Dans Aspose.Words, les cellules fusionnées sont représentées par les propriétés suivantes de la classe CellFormat:

• HorizontalMerge qui décrit si la cellule fait partie d’une fusion horizontale de cellules
• VerticalMerge qui décrit si la cellule fait partie d’une fusion verticale de cellules

Les valeurs de ces propriétés déterminent le comportement de fusion des cellules:

• La première cellule d’une séquence de cellules fusionnées aura CellMerge.First
• Toutes les cellules fusionnées ultérieurement auront CellMerge.Previous
• Une cellule qui n’est pas fusionnée aura CellMerge.None

Parfois, lors du chargement de cellules de document existantes dans un tableau, elles apparaîtront fusionnées. Cependant, il peut en réalité s’agir d’une seule longue cellule – parfois, Microsoft Word exporte les cellules fusionnées de cette façon. Cela peut prêter à confusion lorsque l’on tente de travailler avec des cellules individuelles, mais il ne semble pas y avoir de schéma particulier quant au moment où cela se produit.

Vérifiez si la cellule est fusionnée

Pour vérifier si une cellule fait partie d’une séquence de cellules fusionnées, on vérifie simplement les propriétés HorizontalMerge et VerticalMerge.

L’exemple de code suivant montre comment imprimer le type de fusion de cellules horizontale et verticale:

Vous pouvez télécharger le fichier exemple de cet exemple à partir de Aspose.Words GitHub.

Fusionner les cellules du tableau lors de l’utilisation de DocumentBuilder

Pour fusionner des cellules dans un tableau créé avec DocumentBuilder, vous devez définir le type de fusion approprié pour chaque cellule où la fusion est attendue – d’abord CellMerge.First puis CellMerge.Previous.

N’oubliez pas non plus d’effacer le paramètre de fusion pour les cellules pour lesquelles aucune fusion n’est requise – cela peut être fait en définissant la première cellule non fusionnée sur CellMerge.None. Si cela n’est pas fait, toutes les cellules du tableau seront fusionnées.

L’exemple de code suivant montre comment créer un tableau avec deux lignes dans lequel les cellules de la première ligne sont fusionnées horizontalement:

L’exemple de code suivant montre comment créer un tableau à deux colonnes dans lequel les cellules de la première colonne sont fusionnées verticalement:

Fusionner les cellules du tableau dans d’autres cas

Dans d’autres situations où le DocumentBuilder n’est pas utilisé, comme dans un tableau existant, la fusion de cellules de la manière précédente peut ne pas être aussi simple. Au lieu de cela, nous pouvons regrouper les opérations de base impliquées dans l’application des propriétés de fusion aux cellules dans une méthode qui rend la tâche beaucoup plus facile. Cette méthode est similaire à la méthode d’automatisation Fusion, qui est appelée pour fusionner une plage de cellules dans un tableau.

Le code ci-dessous fusionnera les cellules du tableau dans la plage spécifiée, en commençant à la cellule donnée et en terminant à la cellule de fin. Dans ce cas, la plage peut s’étendre sur plusieurs lignes ou colonnes:

L’exemple de code suivant montre comment fusionner une plage de cellules entre deux cellules spécifiées:

Vous pouvez télécharger le fichier exemple de cet exemple à partir de Aspose.Words GitHub.

Selon la version du .NET Framework que vous utilisez, vous souhaiterez peut-être affiner cette méthode en la transformant en méthode d’extension. Dans ce cas, vous pouvez appeler cette méthode directement sur une cellule pour fusionner une plage de cellules, comme cell1.Merge(cell2).

Cellules fusionnées verticales et horizontales dans un tableau HTML

Comme nous l’avons dit dans les articles précédents, un tableau dans Microsoft Word est un ensemble de lignes indépendantes. Chaque ligne comporte un ensemble de cellules indépendantes des cellules des autres lignes. Ainsi, dans le tableau Microsoft Word, il n’existe pas d’objet tel qu’une “colonne” et la “1ère colonne” est quelque chose comme “l’ensemble des 1ères cellules de chaque ligne du tableau”. Cela permet aux utilisateurs d’avoir un tableau dans lequel, par exemple, la 1ère ligne est composée de deux cellules – 2 cm et 1 cm, et la 2ème ligne est composée de deux cellules différentes – 1 cm et 2 cm de large. Et Aspose.Words prend en charge ce concept de tables.

Un tableau en HTML a une structure essentiellement différente: chaque ligne a le même nombre de cellules et (c’est important pour la tâche) chaque cellule a la largeur de la colonne correspondante, la même pour toutes les cellules d’une colonne. Ainsi, si HorizontalMerge et VerticalMerge renvoient une valeur incorrecte, utilisez l’exemple de code suivant:

Vous pouvez télécharger le fichier exemple de cet exemple à partir de Aspose.Words GitHub.

Convertir en cellules fusionnées horizontalement

Parfois, il n’est pas possible de détecter quelles cellules sont fusionnées car certaines versions plus récentes de Microsoft Word n’utilisent plus les indicateurs de fusion lorsque les cellules sont fusionnées horizontalement. Mais pour les situations où les cellules sont fusionnées horizontalement en fonction de leur largeur à l’aide d’indicateurs de fusion, Aspose.Words fournit la méthode ConvertToHorizontallyMergedCells pour convertir les cellules. Cette méthode transforme simplement le tableau et ajoute de nouvelles cellules si nécessaire.

L’exemple de code suivant montre la méthode ci-dessus en fonctionnement: