Paramètres d alignement
Configuration des paramètres d’alignement
Paramètres d’alignement dans Microsoft Excel
Toute personne ayant utilisé Microsoft Excel pour formater des cellules sera familière avec les paramètres d’alignement dans Microsoft Excel.
Comme vous pouvez le voir sur la figure ci-dessus, il existe différents types d’options d’alignement :
- Alignement du texte (horizontal et vertical)
- Retrait.
- Orientation.
- Contrôle du texte.
- Direction du texte.
Tous ces paramètres d’alignement sont entièrement pris en charge par Aspose.Cells et sont discutés plus en détail ci-dessous.
Paramètres d’alignement dans Aspose.Cells
Aspose.Cells fournit une classe, Workbook, qui représente un fichier Excel. La classe Workbook contient une collection Worksheets permettant d’accéder à chaque feuille de calcul du fichier Excel. Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet fournit une collection getCells(). Chaque élément de cette collection Cells représente un objet de la classe Cell.
Aspose.Cells fournit les méthodes getStyle et setStyle pour la classe Cell qui permettent de récupérer et de définir le formatage d’une cellule. La classe Style offre des propriétés utiles pour configurer les réglages d’alignement.
Sélectionnez n’importe quel type d’alignement du texte en utilisant l’énumération TextAlignmentType. Les types d’alignement de texte prédéfinis dans l’énumération TextAlignmentType sont :
| Types d’alignement de texte | Description |
|---|---|
| Bottom | Représente un alignement de texte en bas |
| Center | Représente un alignement de texte au centre |
| CenterAcross | Représente un alignement de texte centré sur plusieurs cellules |
| Distributed | Représente un alignement de texte distribué |
| Fill | Représente un alignement de texte en remplissage |
| General | Représente un alignement de texte général |
| Justify | Représente un alignement de texte justifié |
| Left | Représente un alignement de texte à gauche |
| Right | Représente un alignement de texte à droite |
| Top | Représente un alignement de texte en haut |
| JustifiedLow | Aligne le texte avec une longueur de kashida ajustée pour le texte arabe. |
| ThaiDistributed | Distribue le texte thaïlandais en particulier, car chaque caractère est traité comme un mot. |
Alignement horizontal
Utilisez la méthode setHorizontalAlignment de l’objet Style pour aligner le texte horizontalement.
Alignement vertical
De même que pour l’alignement horizontal, utilisez la méthode setVerticalAlignment de l’objet Style pour aligner le texte verticalement.
Indentation
Il est possible de définir le niveau d’indentation du texte dans une cellule avec la méthode setIndentLevel de l’objet Style.
Orientation
Définissez l’orientation (rotation) du texte dans une cellule avec la méthode setRotationAngle de l’objet Style.
Contrôle du texte
La section suivante aborde comment contrôler le texte en définissant le retour à la ligne, le rétrécissement pour s’adapter et d’autres options de mise en forme.
Retour à la ligne du texte
Le retour à la ligne du texte dans une cellule facilite sa lecture : la hauteur de la cellule s’ajuste pour contenir tout le texte, au lieu de le couper ou de déborder dans les cellules adjacentes. Activez ou désactivez le retour à la ligne avec la méthode setIsTextWrapped(boolean) de l’objet Style.
Rétrécissement pour s’adapter
Une option pour le retour à la ligne dans un champ est de réduire la taille du texte pour qu’il s’adapte aux dimensions de la cellule. Cela se fait en réglant la méthode setShrinkToFit(boolean) de l’objet Style sur true.
Fusion de cellules
Comme Microsoft Excel, Aspose.Cells supporte la fusion de plusieurs cellules en une seule. Aspose.Cells offre deux approches pour cette tâche. L’une consiste à appeler la méthode merge de la collection Cells. La méthode merge prend les paramètres suivants pour fusionner les cellules :
- Première rangée : la première rangée à partir de laquelle commencer la fusion.
- Première colonne : la première colonne à partir de laquelle commencer la fusion.
- Nombre de rangées : le nombre de rangées à fusionner.
- Nombre de colonnes : le nombre de colonnes à fusionner.
L’autre méthode consiste à d’abord appeler la méthode createRange de la collection Cells pour créer une plage de cellules à fusionner. La méthode createRange prend le même ensemble de paramètres que celle de la méthode merge évoquée ci-dessus et retourne un objet Range. L’objet Range offre également une méthode merge qui fusionne la plage spécifiée dans l’objet Range.
Direction du texte
Il est possible de définir l’ordre de lecture du texte dans les cellules. L’ordre de lecture est l’ordre visuel dans lequel les caractères, les mots, etc. sont affichés. Par exemple, l’anglais est une langue de gauche à droite tandis que l’arabe est une langue de droite à gauche.
L’ordre de lecture est défini avec la propriété TextDirection de l’objet Style. Aspose.Cells fournit des types de direction de texte prédéfinis dans l’énumération TextDirectionType.
| Types de direction du texte | Description |
|---|---|
| Context | L’ordre de lecture en accord avec la langue du premier caractère saisi |
| LeftToRight | Ordre de lecture de gauche à droite |
| RightToLeft | Ordre de lecture de droite à gauche |