Ajuster automatiquement les lignes et les colonnes

Microsoft Excel offre une bonne fonctionnalité pour ajuster automatiquement la largeur et la hauteur d’une cellule en fonction de son contenu. Cette fonctionnalité est également disponible pour les utilisateurs d’Aspose.Cells avec la possibilité de redimensionner automatiquement les dimensions d’une cellule à l’exécution.

Ajustement automatique

Aspose.Cells fournit une classe, Workbook, qui représente un fichier Microsoft Excel. La classe Workbook contient une collection Worksheets qui permet d’accéder à chaque feuille de calcul dans le fichier Excel.

Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet propose un large éventail de propriétés et de méthodes pour gérer une feuille de calcul. Cet article explique comment utiliser la classe Worksheet pour ajuster automatiquement les lignes ou les colonnes.

Ajuster automatiquement la ligne - Simple

L’approche la plus simple pour ajuster automatiquement la largeur et la hauteur d’une ligne est d’appeler la méthode autoFitRow de la classe Worksheet. La méthode autoFitRow prend un index de ligne (de la ligne à redimensionner) en paramètre.

Ajuster automatiquement la ligne dans une plage de cellules

Une ligne est composée de nombreuses colonnes. Aspose.Cells permet aux développeurs d’ajuster automatiquement une ligne en fonction du contenu dans une plage de cellules dans la ligne en appelant une version surchargée de la méthode autoFitRow. Elle prend les paramètres suivants :

• Index de la ligne, l’index de la ligne à ajuster automatiquement.
• Index de la première colonne, l’index de la première colonne de la ligne.
• Index de la dernière colonne, l’index de la dernière colonne de la ligne.

La méthode autoFitRow vérifie le contenu de toutes les colonnes de la ligne puis ajuste automatiquement la ligne.

Ajuster automatiquement la colonne - Simple

La manière la plus simple de redimensionner automatiquement la largeur et la hauteur d’une colonne est d’appeler la méthode autoFitColumn de la classe Worksheet. La méthode autoFitColumn prend l’index de la colonne (de la colonne à redimensionner) comme paramètre.

Ajuster automatiquement la colonne dans une plage de cellules

Une colonne est composée de nombreuses lignes. Il est possible de redimensionner automatiquement une colonne en fonction du contenu dans une plage de cellules de la colonne en appelant une version surchargée de la méthode autoFitColumn qui prend les paramètres suivants :

• Index de colonne, représente l’index de la colonne dont le contenu doit être ajusté automatiquement
• Index de la première ligne, représente l’index de la première ligne de la colonne
• Dernier index de ligne, représente l’index de la dernière ligne de la colonne

La méthode autoFitColumn vérifie le contenu de toutes les lignes de la colonne, puis ajuste automatiquement la largeur de la colonne.

Ajustement automatique des lignes pour les cellules fusionnées

Avec Aspose.Cells, il est possible de redimensionner automatiquement les lignes même pour les cellules qui ont été fusionnées à l’aide de l’API AutoFitterOptions. La classe AutoFitterOptions fournit la propriété AutoFitMergedCellsType qui peut être utilisée pour ajuster automatiquement les lignes pour les cellules fusionnées. AutoFitMergedCellsType accepte l’énumération AutoFitMergedCellsType qui contient les membres suivants.

• AUCUN : Ignorer les cellules fusionnées.
• PREMIÈRE_LIGNE : Augmente uniquement la hauteur de la première ligne.
• DERNIÈRE_LIGNE : Augmente uniquement la hauteur de la dernière ligne.
• CHAQUE_LIGNE : Augmente uniquement la hauteur de chaque ligne.

Vous pouvez également utiliser les versions surchargées des méthodes autoFitRows & autoFitColumns qui acceptent une plage de lignes/colonnes et une instance AutoFitterOptions pour adapter automatiquement les lignes/colonnes sélectionnées avec les AutoFitterOptions souhaités en conséquence.

Les signatures des méthodes susmentionnées sont les suivantes :

1. autoFitRows(int startRow, int endRow, AutoFitterOptions options)
2. autoFitColumns(int firstColumn, int lastColumn, AutoFitterOptions options)

Important à savoir

Si une cellule est fusionnée, les méthodes AutoFit ne seront pas appliquées, ce qui est le même comportement que dans Microsoft Excel. De plus, si le texte dans une cellule est enroulé, la méthode autoFitColumn ne sera pas appliquée non plus. Une autre chose que vous devez savoir est que les méthodes AutoFit sont longues à exécuter. Vous devriez donc appeler ces méthodes aussi rarement que possible pour assurer l’efficacité de votre application.