Formatage des données

Approches pour formater les données dans Cells

C’est un fait commun que si les cellules de la feuille de calcul sont correctement formatées, il devient plus facile pour les utilisateurs de lire le contenu (données) de la cellule. Il existe de nombreuses façons de formater les cellules et leur contenu. Le moyen le plus simple consiste à formater les cellules à l’aide d’Excel Microsoft dans un environnement WYSIWYG lors de la création d’une feuille de calcul Designer. Une fois la feuille de calcul du concepteur créée, vous pouvez ouvrir la feuille de calcul à l’aide de Aspose.Cells en conservant tous les paramètres de format enregistrés avec la feuille de calcul. Une autre façon de formater les cellules et leur contenu consiste à utiliser Aspose.Cells API. Dans cette rubrique, nous décrirons deux approches pour formater les cellules et leur contenu avec l’utilisation de Aspose.Cells API.

Formatage Cells

Les développeurs peuvent formater les cellules et leur contenu à l’aide du flexible API de Aspose.Cells. Aspose.Cells fournit une classe,Cahier , qui représente un fichier Excel Microsoft. LeCahier classe contient unWorksheetCollection qui permet d’accéder à chaque feuille de calcul dans un fichier Excel. Une feuille de calcul est représentée par leFeuille de travail classe. LeFeuille de travail classe fournit une collection Cells. Chaque élément de laCellscollection représente un objet deCell classe.

Aspose.Cells fournit leStyle propriété dans leCell classe, utilisée pour définir le style de formatage d’une cellule. De plus, Aspose.Cells fournit également unStyle classe qui est utilisée pour servir le même but. Appliquez différents types de styles de mise en forme sur les cellules pour définir leurs couleurs d’arrière-plan ou de premier plan, les bordures, les polices, les alignements horizontaux et verticaux, le niveau d’indentation, la direction du texte, l’angle de rotation et bien plus encore.

Utilisation de la méthode setStyle

Lorsque vous appliquez différents styles de mise en forme à différentes cellules, il est préférable d’utiliser la méthode setStyle duCell classe. Un exemple est donné ci-dessous pour démontrer l’utilisation de la méthode setStyle pour appliquer divers paramètres de mise en forme sur une cellule.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getDataDir(FormattingCellsUsingsetStyleMethod.class);
// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "book1.xls");
// Accessing the first worksheet in the Excel file
Worksheet worksheet = workbook.getWorksheets().get(0);
Cells cells = worksheet.getCells();
// Accessing the "A1" cell from the worksheet
Cell cell = cells.get("A1");
// Adding some value to the "A1" cell
cell.setValue("Hello Aspose!");
Style style = cell.getStyle();
// Setting the vertical alignment of the text in the "A1" cell
style.setVerticalAlignment(TextAlignmentType.CENTER);
// Setting the horizontal alignment of the text in the "A1" cell
style.setHorizontalAlignment(TextAlignmentType.CENTER);
// Setting the font color of the text in the "A1" cell
Font font = style.getFont();
font.setColor(Color.getGreen());
// Setting the cell to shrink according to the text contained in it
style.setShrinkToFit(true);
// Setting the bottom border
style.setBorder(BorderType.BOTTOM_BORDER, CellBorderType.MEDIUM, Color.getRed());
// Saved style
cell.setStyle(style);
// Saving the modified Excel file in default (that is Excel 2003) format
workbook.save(dataDir + "output.xls");

Utilisation de l’objet Style

Lorsque vous appliquez le même style de mise en forme à différentes cellules, utilisez laStyle objet.

  1. Ajouter unStyle objet à la collection Styles duCahier classe en appelant la méthode createStyle de la classe Workbook.
  2. Accédez à l’objet Style nouvellement ajouté à partir de la collection Styles.
  3. Définissez les propriétés souhaitées de l’objet Style pour appliquer les paramètres de mise en forme souhaités.
  4. Attribuez l’objet Style configuré à la propriété Style de n’importe quelle cellule souhaitée.

Cette approche peut grandement améliorer l’efficacité de vos applications et également économiser de la mémoire.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(FormattingCellsUsingStyleObject.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook(dataDir + "book1.xls");
// Accessing the first worksheet in the Excel file
Worksheet worksheet = workbook.getWorksheets().get(0);
Cells cells = worksheet.getCells();
// Accessing the "A1" cell from the worksheet
Cell cell = cells.get("A1");
// Adding some value to the "A1" cell
cell.setValue("Hello Aspose!");
// Adding a new Style to the styles collection of the Excel object
Style style = workbook.createStyle();
// Setting the vertical alignment of the text in the "A1" cell
style.setVerticalAlignment(TextAlignmentType.CENTER);
// Setting the horizontal alignment of the text in the "A1" cell
style.setHorizontalAlignment(TextAlignmentType.CENTER);
// Setting the font color of the text in the "A1" cell
Font font = style.getFont();
font.setColor(Color.getGreen());
// Setting the cell to shrink according to the text contained in it
style.setShrinkToFit(true);
// Setting the bottom border
style.setBorder(BorderType.BOTTOM_BORDER, CellBorderType.MEDIUM, Color.getRed());
// Saved style
cell.setStyle(style);
// Saving the modified Excel file in default format
workbook.save(dataDir + "FCUsingStyleObject_out.xls");

Application d’effets de remplissage dégradé

Pour appliquer les effets de remplissage dégradé souhaités à la cellule, utilisez la méthode setTwoColorGradient de l’objet Style en conséquence.

Exemple de code

La sortie suivante est obtenue en exécutant le code ci-dessous.

Application d’effets de remplissage dégradé

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ApplyGradientFillEffects.class) + "data/";
// Instantiate a new Workbook
Workbook workbook = new Workbook();
// Get the first worksheet (default) in the workbook
Worksheet worksheet = workbook.getWorksheets().get(0);
// Input a value into B3 cell
worksheet.getCells().get(2, 1).putValue("test");
// Get the Style of the cell
Style style = worksheet.getCells().get("B3").getStyle();
// Set Gradient pattern on
style.setGradient(true);
// Specify two color gradient fill effects
style.setTwoColorGradient(Color.fromArgb(255, 255, 255), Color.fromArgb(79, 129, 189),
GradientStyleType.HORIZONTAL, 1);
// Set the color of the text in the cell
style.getFont().setColor(Color.getRed());
// Specify horizontal and vertical alignment settings
style.setHorizontalAlignment(TextAlignmentType.CENTER);
style.setVerticalAlignment(TextAlignmentType.CENTER);
// Apply the style to the cell
worksheet.getCells().get("B3").setStyle(style);
// Set the third row height in pixels
worksheet.getCells().setRowHeightPixel(2, 53);
// Merge the range of cells (B3:C3)
worksheet.getCells().merge(2, 1, 1, 2);
// Save the Excel file
workbook.save(dataDir + "ApplyGradientFillEffects_out.xlsx");

Configuration des paramètres d’alignement

Quiconque a utilisé Microsoft Excel pour formater des cellules connaîtra les paramètres d’alignement dans Microsoft Excel.

Paramètres d’alignement dans Microsoft Excel

tâche : image_autre_texte

Comme vous pouvez le voir sur la figure ci-dessus, il existe différents types d’options d’alignement :

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.

Configuration des paramètres d’alignement

Aspose.Cells fournit une classe,Cahier , qui représente un fichier Excel. La classe Workbook contient une WorksheetCollection qui permet d’accéder à chaque feuille de calcul du fichier Excel. Une feuille de calcul est représentée par leFeuille de travail classe.

La classe Worksheet fournit une collection Cells. Chaque pièce de la collection Cells représente un objet de laCell classe.

Aspose.Cells fournit la méthode setStyle dans leCell classe utilisée pour la mise en forme d’une cellule. LeStyle La classe fournit des propriétés utiles pour configurer les paramètres de police.

Sélectionnez n’importe quel type d’alignement de texte à l’aide de 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
Fond Représente l’alignement du texte inférieur
Centre Représente l’alignement du texte au centre
CenterAcross Représente le centre sur l’alignement du texte
Distribué Représente l’alignement de texte distribué
Remplir Représente l’alignement du texte de remplissage
Général Représente l’alignement général du texte
Justifier Représente l’alignement du texte justifié
Gauche Représente l’alignement du texte à gauche
Droit Représente l’alignement du texte à droite
Haut Représente l’alignement supérieur du texte

Alignement horizontal

Utilisez leStyle méthode setHorizontalAlignment de l’objet pour aligner le texte horizontalement.

La sortie suivante est obtenue en exécutant l’exemple de code ci-dessous :

Aligner le texte horizontalement

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TextAlignmentHorizontal.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Setting the horizontal alignment of the text in the "A1" cell
style.setHorizontalAlignment(TextAlignmentType.CENTER);
// Saved style
cell.setStyle(style);
// Saving the modified Excel file in default format
workbook.save(dataDir + "TAHorizontal_out.xls");

Alignement vertical

Utilisez leStyle la méthode setVerticalAlignment de l’objet pour aligner le texte verticalement.

La sortie suivante est obtenue lorsque VerticalAlignment est défini sur center.

Aligner le texte verticalement

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TextAlignmentVertical.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Setting the vertical alignment of the text in a cell
Style style1 = cell.getStyle();
style1.setVerticalAlignment(TextAlignmentType.CENTER);
cell.setStyle(style1);
// Saved style
cell.setStyle(style1);
// Saving the modified Excel file in default format
workbook.save(dataDir + "TAVertical_out.xls");

Échancrure

Il est possible de définir le niveau d’indentation du texte dans une cellule en utilisant laStyle la méthode setIndentLevel de l’objet.

La sortie suivante est obtenue lorsque IndentLevel est défini sur 2.

Niveau d’indentation ajusté à 2

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(Indentation.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Setting the vertical alignment of the text in a cell
Style style1 = cell.getStyle();
style1.setIndentLevel(2);
cell.setStyle(style1);
// Saved style
cell.setStyle(style1);
// Saving the modified Excel file in default format
workbook.save(dataDir + "Indentation_out.xls");

Orientation

Définissez l’orientation (rotation) du texte dans une cellule avec laStyle méthode setRotationAngle de l’objet.

La sortie suivante est obtenue lorsque l’angle de rotation est réglé sur 25.

Angle de rotation réglé sur 25

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(Orientation.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Setting the rotation of the text (inside the cell) to 25
Style style1 = cell.getStyle();
style1.setRotationAngle(25);
cell.setStyle(style1);
// Saved style
cell.setStyle(style1);
// Saving the modified Excel file in default format
workbook.save(dataDir + "Orientation_out.xls");

Contrôle du texte

La section suivante explique comment contrôler le texte en définissant l’habillage du texte, le rétrécissement et d’autres options de formatage.

Habillage du texte

L’habillage du texte dans une cellule facilite la lecture : la hauteur de la cellule s’ajuste pour s’adapter à tout le texte, au lieu de le couper ou de déborder dans les cellules adjacentes.

Activez ou désactivez l’habillage du texte avec leStyle la méthode setTextWrapped de l’objet.

La sortie suivante est obtenue lorsque l’habillage du texte est activé.

Texte enveloppé à l’intérieur de la cellule

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(WrapText.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Enabling the text to be wrapped within the cell
Style style1 = cell.getStyle();
style1.setTextWrapped(true);
cell.setStyle(style1);
// Saved style
cell.setStyle(style1);
// Saving the modified Excel file in default format
workbook.save(dataDir + "WrapText_out.xls");

Rétrécir pour s’adapter

Une option d’habillage du texte dans un champ consiste à réduire la taille du texte pour l’adapter aux dimensions d’une cellule. Cela se fait en réglant leStyle la propriété IsTextWrapped de l’objet àvrai.

La sortie suivante est obtenue lorsque le texte est rétréci pour tenir dans la cellule.

Texte rétréci pour tenir à l’intérieur des limites de la cellule

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ShrinkingToFit.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Shrinking the text to fit according to the dimensions of the cell
Style style1 = cell.getStyle();
style1.setShrinkToFit(true);
cell.setStyle(style1);
// Saved style
cell.setStyle(style1);
// Saving the modified Excel file in default format
workbook.save(dataDir + "ShrinkingToFit_out.xls");

Fusion Cells

Comme Microsoft Excel, Aspose.Cells prend en charge la fusion de plusieurs cellules en une seule.

La sortie suivante est obtenue si les trois cellules de la première ligne sont fusionnées pour créer une grande cellule unique.

Trois cellules fusionnées pour créer une grande cellule

tâche : image_autre_texte

Utilisez leCells la méthode Merge de la collection pour fusionner les cellules. La méthode Merge prend les paramètres suivants :

  • Première ligne, la première ligne à partir de laquelle commencer la fusion.
  • Première colonne, la première colonne à partir de laquelle commencer la fusion.
  • Nombre de lignes, le nombre de lignes à fusionner.
  • Nombre de colonnes, le nombre de colonnes à fusionner.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(MergingCellsInWorksheet.class) + "data/";
// Create a Workbook.
Workbook wbk = new Workbook();
// Create a Worksheet and get the first sheet.
Worksheet worksheet = wbk.getWorksheets().get(0);
// Create a Cells object to fetch all the cells.
Cells cells = worksheet.getCells();
// Merge some Cells (C6:E7) into a single C6 Cell.
cells.merge(5, 2, 2, 3);
// Input data into C6 Cell.
worksheet.getCells().get(5, 2).setValue("This is my value");
// Create a Style object to fetch the Style of C6 Cell.
Style style = worksheet.getCells().get(5, 2).getStyle();
// Create a Font object
Font font = style.getFont();
// Set the name.
font.setName("Times New Roman");
// Set the font size.
font.setSize(18);
// Set the font color
font.setColor(Color.getBlue());
// Bold the text
font.setBold(true);
// Make it italic
font.setItalic(true);
// Set the backgrond color of C6 Cell to Red
style.setForegroundColor(Color.getRed());
style.setPattern(BackgroundType.SOLID);
// Apply the Style to C6 Cell.
cells.get(5, 2).setStyle(style);
// Save the Workbook.
wbk.save(dataDir + "mergingcells_out.xls");
wbk.save(dataDir + "mergingcells_out.xlsx");
wbk.save(dataDir + "mergingcells_out.ods");
// Print message
System.out.println("Process completed successfully");

Sens 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 leStyle propriété TextDirection de l’objet. Aspose.Cells fournit des types de direction de texte prédéfinis dans l’énumération TextDirectionType.

Types d’orientation du texte Description
Contexte L’ordre de lecture cohérent avec la langue du premier caractère saisi
De gauche à droite Ordre de lecture de gauche à droite
De droite à gauche Ordre de lecture de droite à gauche
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ChangeTextDirection.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding the current system date to "A1" cell
Cell cell = cells.get("A1");
Style style = cell.getStyle();
// Adding some value to the "A1" cell
cell.setValue("Visit Aspose!");
// Setting the text direction from right to left
Style style1 = cell.getStyle();
style1.setTextDirection(TextDirectionType.RIGHT_TO_LEFT);
cell.setStyle(style1);
// Saved style
cell.setStyle(style1);
// Saving the modified Excel file in default format
workbook.save(dataDir + "ChangeTextDirection_out.xls");

La sortie suivante est obtenue si l’ordre de lecture du texte est défini de droite à gauche.

Réglage de l’ordre de lecture du texte de droite à gauche

tâche : image_autre_texte

Formatage des caractères sélectionnés dans un Cell

Gestion des paramètres de policeexpliqué comment formater les cellules, mais seulement comment formater le contenu de toutes les cellules. Que faire si vous souhaitez formater uniquement les caractères sélectionnés ?

Aspose.Cells prend en charge cette fonctionnalité. Cette rubrique explique comment utiliser cette fonctionnalité.

Formatage des caractères sélectionnés

Aspose.Cells fournit une classe,Cahier , qui représente un fichier Excel Microsoft. La classe Workbook contient une collection Worksheets qui permet d’accéder à chaque feuille de calcul du fichier Excel. Une feuille de calcul est représentée par leFeuille de travail classe. La classe Worksheet fournit une collection Cells. Chaque pièce de la collection Cells représente un objet de laCell classe.

La classe Cell fournit une méthode de caractères qui prend les paramètres suivants pour sélectionner une plage de caractères dans une cellule :

  • Index de départ, l’index du caractère à partir duquel commencer la sélection.
  • Nombre de caractères, le nombre de caractères à sélectionner.

Dans le fichier de sortie, dans la cellule A1", le mot ‘Visite’ est formaté avec la police par défaut mais ‘Aspose!’ est gras et bleu.

Formatage des caractères sélectionnés

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// Path to source file
String dataDir = Utils.getSharedDataDir(FormattingSelectedCharacters.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet = workbook.getWorksheets().get(sheetIndex);
Cells cells = worksheet.getCells();
// Adding some value to the "A1" cell
Cell cell = cells.get("A1");
cell.setValue("Visit Aspose!");
Font font = cell.characters(6, 7).getFont();
// Setting the font of selected characters to bold
font.setBold(true);
// Setting the font color of selected characters to blue
font.setColor(Color.getBlue());
// Saving the Excel file
workbook.save(dataDir + "FSCharacters_out.xls");

Activer des feuilles et activer un Cell ou sélectionner une plage de Cells dans la feuille de calcul

Parfois, vous devrez peut-être activer une feuille de calcul spécifique pour qu’elle soit la première à s’afficher lorsque quelqu’un ouvre le fichier dans Microsoft Excel. Vous devrez peut-être également activer une cellule spécifique de manière à ce que les barres de défilement défilent jusqu’à la cellule active afin qu’elle soit clairement visible. Aspose.Cells est capable de faire toutes les tâches mentionnées ci-dessus.

Une feuille active est la feuille sur laquelle vous travaillez dans un classeur. Le nom sur l’onglet de la feuille active est en gras par défaut. Une cellule active, quant à elle, est la cellule qui est sélectionnée et dans laquelle les données sont saisies lorsque vous commencez à taper. Une seule cellule est active à la fois. La cellule active est entourée d’une bordure épaisse pour la faire apparaître par rapport aux autres cellules. Aspose.Cells vous permet également de sélectionner une plage de cellules dans la feuille de calcul.

Activer une feuille et rendre un Cell actif

Aspose.Cells fournit un API spécifique pour ces tâches. Par exemple, la méthode WorksheetCollection.setActiveSheetIndex est utile pour définir une feuille active. De même, la méthode Worksheet.setActiveCell est utilisée pour définir et obtenir une cellule active dans une feuille de calcul.

Si vous souhaitez que les barres de défilement horizontales et verticales défilent jusqu’à la position d’index de ligne et de colonne pour donner une bonne vue des données sélectionnées lorsque le fichier est ouvert dans Microsoft Excel, utilisez les propriétés Worksheet.setFirstVisibleRow et Worksheet.setFirstVisibleColumn.

L’exemple suivant montre comment activer une feuille de calcul et rendre active une cellule de celle-ci. Les barres de défilement défilent pour faire de la 2e ligne et de la 2e colonne leur première ligne et colonne visibles.

Définir la cellule B2 comme cellule active

tâche : image_autre_texte

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(MakeCellActive.class) + "data/";
// Instantiate a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet in the workbook.
Worksheet worksheet1 = workbook.getWorksheets().get(0);
// Get the cells in the worksheet.
Cells cells = worksheet1.getCells();
// Input data into B2 cell.
cells.get(1, 1).setValue("Hello World!");
// Set the first sheet as an active sheet.
workbook.getWorksheets().setActiveSheetIndex(0);
// Set B2 cell as an active cell in the worksheet.
worksheet1.setActiveCell("B2");
// Set the B column as the first visible column in the worksheet.
worksheet1.setFirstVisibleColumn(1);
// Set the 2nd row as the first visible row in the worksheet.
worksheet1.setFirstVisibleRow(1);
// Save the Excel file.
workbook.save(dataDir + "MakeCellActive_out.xls");

Sélection d’une plage de Cells dans la feuille de calcul

Aspose.Cells fournit la méthode Worksheet.selectRange(int startRow, int startColumn, int totalRows, int totalColumns, bool removeOthers). En utilisant le dernier paramètre - removeOthers - sur true, les autres sélections de cellules ou de plages de cellules de la feuille sont supprimées.

L’exemple suivant montre comment sélectionner une plage de cellules dans la feuille de calcul active.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(SelectRangeofCellsinWorksheet.class) + "data/";
// Instantiate a new Workbook.
Workbook workbook = new Workbook();
// Get the first worksheet in the workbook.
Worksheet worksheet1 = workbook.getWorksheets().get(0);
// Get the cells in the worksheet.
Cells cells = worksheet1.getCells();
// Input data into B2 cell.
cells.get(1, 1).setValue("Hello World!");
// Set the first sheet as an active sheet.
workbook.getWorksheets().setActiveSheetIndex(0);
// Select range of cells(A1:E10) in the worksheet.
worksheet1.selectRange(0, 0, 10, 5, true);
// Save the Excel file.
workbook.save(dataDir + "SROfCInWorksheet_out.xlsx");

Formatage des lignes et des colonnes

Le formatage des lignes et des colonnes dans une feuille de calcul pour donner un aspect au rapport est probablement la fonctionnalité la plus largement utilisée de l’application Excel. Les API Aspose.Cells fournissent également cette fonctionnalité via son modèle de données en exposant la classe Style qui gère principalement toutes les fonctionnalités liées au style telles que la police et ses attributs, l’alignement du texte, les couleurs d’arrière-plan/de premier plan, les bordures, le format d’affichage des nombres et des littéraux de date, etc. . Une autre classe utile fournie par les API Aspose.Cells est le StyleFlag qui permet la réutilisation de l’objet Style.

Dans cet article, nous allons essayer d’expliquer comment utiliser Aspose.Cells for Java API pour appliquer la mise en forme aux lignes et aux colonnes.

Formatage des lignes et des colonnes

Aspose.Cells fournit une classe,Cahier qui représente un fichier Excel Microsoft. LeCahier contient une WorksheetCollection qui permet d’accéder à chaque feuille de calcul du fichier Excel. Une feuille de calcul est représentée par la classe Worksheet. LeFeuille de travail fournit la collection Cells. La collection Cells fournit une collection Rows.

Formater une ligne

Chaque élément de la collection Rows représente un objet Row. L’objet Row propose la méthode applyStyle utilisée pour appliquer une mise en forme à une ligne.

Pour appliquer le même formatage à une ligne, utilisez l’objet Style :

  1. Ajoutez un objet Style à la classe Workbook en appelant sa méthode createStyle.
  2. Définissez les propriétés de l’objet Style pour appliquer les paramètres de mise en forme.
  3. Affectez l’objet Style configuré à la méthode applyStyle d’un objet Row.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(FormattingARow.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
Worksheet worksheet = workbook.getWorksheets().get(0);
Cells cells = worksheet.getCells();
// Adding a new Style to the styles collection of the Excel object Accessing the newly added Style to the Excel object
Style style = workbook.createStyle();
// Setting the vertical alignment of the text in the cell
style.setVerticalAlignment(TextAlignmentType.CENTER);
// Setting the horizontal alignment of the text in the cell
style.setHorizontalAlignment(TextAlignmentType.CENTER);
// Setting the font color of the text in the cell
Font font = style.getFont();
font.setColor(Color.getGreen());
// Shrinking the text to fit in the cell
style.setShrinkToFit(true);
// Setting the bottom border of the cell
style.setBorder(BorderType.BOTTOM_BORDER, CellBorderType.MEDIUM, Color.getRed());
// Creating StyleFlag
StyleFlag styleFlag = new StyleFlag();
styleFlag.setHorizontalAlignment(true);
styleFlag.setVerticalAlignment(true);
styleFlag.setShrinkToFit(true);
styleFlag.setBottomBorder(true);
styleFlag.setFontColor(true);
// Accessing a row from the Rows collection
Row row = cells.getRows().get(0);
// Assigning the Style object to the Style property of the row
row.applyStyle(style, styleFlag);
// Saving the Excel file
workbook.save(dataDir + "FormattingARow_out.xls");

Formater une colonne

La collection Cells fournit une collection Columns. Chaque élément de la collection Columns représente un objet Column. Semblable à l’objet Row, l’objet Column propose la méthode applyStyle utilisée pour définir la mise en forme de la colonne. Utilisez la méthode applyStyle de l’objet Column pour mettre en forme une colonne de la même manière qu’une ligne.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(FormattingAColumn.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Accessing the added worksheet in the Excel file
Worksheet worksheet = workbook.getWorksheets().get(0);
Cells cells = worksheet.getCells();
// Adding a new Style to the styles collection of the Excel object Accessing the newly added Style to the Excel object
Style style = workbook.createStyle();
// Setting the vertical alignment of the text in the cell
style.setVerticalAlignment(TextAlignmentType.CENTER);
// Setting the horizontal alignment of the text in the cell
style.setHorizontalAlignment(TextAlignmentType.CENTER);
// Setting the font color of the text in the cell
Font font = style.getFont();
font.setColor(Color.getGreen());
// Shrinking the text to fit in the cell
style.setShrinkToFit(true);
// Setting the bottom border of the cell
style.setBorder(BorderType.BOTTOM_BORDER, CellBorderType.MEDIUM, Color.getRed());
// Creating StyleFlag
StyleFlag styleFlag = new StyleFlag();
styleFlag.setHorizontalAlignment(true);
styleFlag.setVerticalAlignment(true);
styleFlag.setShrinkToFit(true);
styleFlag.setBottomBorder(true);
styleFlag.setFontColor(true);
// Accessing a column from the Columns collection
Column column = cells.getColumns().get(0);
// Applying the style to the column
column.applyStyle(style, styleFlag);
// Saving the Excel file
workbook.save(dataDir + "FormattingAColumn_out.xls");

Définition du format d’affichage de Numbers et des dates pour les lignes et les colonnes

Si l’exigence est de définir le format d’affichage des nombres et des dates pour une ligne ou une colonne complète, le processus est plus ou moins le même que celui décrit ci-dessus, cependant, au lieu de définir des paramètres pour le contenu textuel, vous définirez le formatage des nombres et les dates en utilisant Style.Number ou Style.Custom. Veuillez noter que la propriété Style.Number est de type entier et fait référence aux formats de nombre et de date intégrés, tandis que la propriété Style.Custom est de type chaîne et accepte les modèles valides.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(SettingDisplayFormat.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Obtaining the reference of the first (default) worksheet by passing its sheet index
Worksheet worksheet = workbook.getWorksheets().get(0);
// Adding a new Style to the styles collection of the Workbook object
Style style = workbook.createStyle();
// Setting the Number property to 4 which corresponds to the pattern #,##0.00
style.setNumber(4);
// Creating an object of StyleFlag
StyleFlag flag = new StyleFlag();
// Setting NumberFormat property to true so that only this aspect takes effect from Style object
flag.setNumberFormat(true);
// Applying style to the first row of the worksheet
worksheet.getCells().getRows().get(0).applyStyle(style, flag);
// Re-initializing the Style object
style = workbook.createStyle();
// Setting the Custom property to the pattern d-mmm-yy
style.setCustom("d-mmm-yy");
// Applying style to the first column of the worksheet
worksheet.getCells().getColumns().get(0).applyStyle(style, flag);
// Saving spreadsheet on disc
workbook.save(dataDir + "SDisplayFormat_out.xlsx");