Appliquer un style sur une cellule

Ce sujet traite de l’application d’un format de style sur une cellule, nous couvrirons presque toutes les propriétés associées qui peuvent être utilisées pour appliquer un style sur une cellule. En plus de certains paramètres de base de mise en forme, nous discuterons également de la définition de bordures et du paramétrage du format de nombre sur la cellule en détail.

Appliquer un style personnalisé sur une cellule - Un exemple

Pour changer la police et la couleur d’une cellule avec Aspose.Cells.GridDesktop, veuillez suivre les étapes ci-dessous :

• Accédez à n’importe quelle Worksheet souhaitée
• Accéder à une Cellule sur laquelle nous voulons appliquer un Style
• Obtenir le Style de la Cellule
• Définir les propriétés du Style selon vos besoins personnalisés
• Enfin, définissez le Style de la Cellule avec celui mis à jour

Il existe de nombreuses propriétés et méthodes utiles offertes par l’objet Style qui peuvent être utilisées par les développeurs pour personnaliser le style selon leurs besoins. Dans le code ci-dessous, il est démontré comment appliquer un style personnalisé à une cellule.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the worksheet of the Grid that is currently active
Worksheet sheet = gridDesktop1.GetActiveWorksheet();

// Accessing "A1" cell in the worksheet
GridCell cell = sheet.Cells["A1"];

// Adding a value to "A1" cell
cell.Value = "Hello";

// Getting the Style object for the cell
Style style = cell.GetStyle();

// Setting Style properties like border, alignment etc.
style.SetBorderLine(BorderType.Right, BorderLineType.Thick);
style.SetBorderColor(BorderType.Right, Color.Blue);
style.HAlignment = HorizontalAlignmentType.Centred;
style.Color = Color.Yellow;
style.CellLocked = true;
style.VAlignment = VerticalAlignmentType.Top;

// Setting the style of the cell with the customized Style object
cell.SetStyle(style);

Dessiner les bordures des cellules

En utilisant l’objet Style, nous pouvons dessiner facilement les bordures d’une cellule. Les bordures peuvent être dessinées dans n’importe quelle couleur. De plus, les développeurs ont également la flexibilité de choisir un type de ligne spécifique qui sera utilisé pour dessiner les bordures autour de la cellule. Les développeurs peuvent utiliser les méthodes SetBorderLine et SetBorderColor de l’objet Style pour dessiner des bordures de différents types et couleurs. De même, pour obtenir des informations sur les bordures d’une cellule, les développeurs peuvent également utiliser les méthodes GetBorderLine et GetBorderColor de l’objet Style.

Types de bordures

Il existe six types de bordures pris en charge par Aspose.Cells.GridDesktop comme suit :

• Gauche , représente la bordure gauche
• Droite , représente la bordure droite
• Haut , représente la bordure supérieure
• Bas , représente la bordure inférieure
• DiagonaleBas , représente la bordure diagonale descendante
• DiagonaleHaut , représente la bordure diagonale ascendante

Types de lignes de bordure

Une bordure est composée d’une ligne. Changer le type de ligne change l’apparence d’une bordure. Aspose.Cells.GridDesktop prend en charge de nombreux types de lignes de bordure, qui sont également répertoriés ci-dessous :

• Aucune , représente aucune bordure
• Fine , représente une bordure à ligne pleine
• Moyenne , représente une bordure à ligne pleine avec une largeur de ligne égale à 2f
• Pointillée , représente une bordure à ligne pointillée
• En traits , représente une bordure à ligne en tirets
• Épaisse , représente une bordure à ligne pleine avec une largeur de ligne égale à 3f
• MediumDashed , représente une bordure en pointillés de ligne avec une largeur de ligne égale à 2f
• ThinDashDotted , représente une bordure en pointillés tiretés
• MediumDashDotted , représente une bordure en pointillés tiretés avec une largeur de ligne égale à 2f
• ThinDashDotDotted , représente une bordure en pointillés, tiretés et pointillés
• MediumDashDotDotted , représente une bordure en pointillés, tiretés et pointillés avec une largeur de ligne égale à 2f

Résumant tout ensemble - Exemple

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing first worksheet of the Grid
Aspose.Cells.GridDesktop.Worksheet sheet = gridDesktop1.Worksheets[0];

// Accessing "B2" cell and setting its value
Aspose.Cells.GridDesktop.GridCell cell = sheet.Cells["B2"];
cell.Value = "None";

// Accessing "D4" cell and setting its value & column width
cell = sheet.Cells["D4"];
cell.Value = "out line Borders";
sheet.Columns[cell.Column].Width = 120;

// Accessing the Style object of "D4" cell and drawing thin red borders around it
Aspose.Cells.GridDesktop.Style style = cell.GetStyle();
style.SetBorderLine(BorderType.Left, BorderLineType.Thin);
style.SetBorderColor(BorderType.Left, System.Drawing.Color.Red);
style.SetBorderLine(BorderType.Right, BorderLineType.Thin);
style.SetBorderColor(BorderType.Right, System.Drawing.Color.Red);
style.SetBorderLine(BorderType.Top, BorderLineType.Thin);
style.SetBorderColor(BorderType.Top, System.Drawing.Color.Red);
style.SetBorderLine(BorderType.Bottom, BorderLineType.Thin);
style.SetBorderColor(BorderType.Bottom, System.Drawing.Color.Red);
cell.SetStyle(style);

// Accessing "B6" cell and setting its value, row height & column width
cell = sheet.Cells["B6"];
cell.Value = "Border with\ndifferent colors";
sheet.Rows[cell.Row].Height = 40;
sheet.Columns[cell.Column].Width = 110;

// Accessing the Style object of "B6" cell and drawing thin borders of different colors around it
style = cell.GetStyle();
style.SetBorderLine(BorderType.Left, BorderLineType.Thin);
style.SetBorderColor(BorderType.Left, System.Drawing.Color.Red);
style.SetBorderLine(BorderType.Right, BorderLineType.Thin);
style.SetBorderColor(BorderType.Right, System.Drawing.Color.Green);
style.SetBorderLine(BorderType.Top, BorderLineType.Thin);
style.SetBorderColor(BorderType.Top, System.Drawing.Color.Yellow);
style.SetBorderLine(BorderType.Bottom, BorderLineType.Thin);
style.SetBorderColor(BorderType.Bottom, System.Drawing.Color.Blue);
cell.SetStyle(style);

// Accessing "D7" cell and setting its value, row height & column width
cell = sheet.Cells["D7"];
cell.Value = "Border with\ndifferent styles";
sheet.Rows[cell.Row].Height = 40;
sheet.Columns[cell.Column].Width = 110;

// Accessing the Style object of "D7" cell and drawing different borders of different colors around it
style = cell.GetStyle();
style.SetBorderLine(BorderType.Left, BorderLineType.Thin);
style.SetBorderColor(BorderType.Left, System.Drawing.Color.Red);
style.SetBorderLine(BorderType.Right, BorderLineType.Medium);
style.SetBorderColor(BorderType.Right, System.Drawing.Color.Red);
style.SetBorderLine(BorderType.Top, BorderLineType.Dashed);
style.SetBorderColor(BorderType.Top, System.Drawing.Color.Yellow);
style.SetBorderLine(BorderType.Bottom, BorderLineType.Dotted);
style.SetBorderColor(BorderType.Bottom, System.Drawing.Color.Black);
cell.SetStyle(style);

// Accessing "B8" cell and drawing a single red border to its bottom side
cell = sheet.Cells["B8"];
cell.Value = "Only one border";
style = cell.GetStyle();
style.SetBorderLine(BorderType.Bottom, BorderLineType.MediumDashDotted);
style.SetBorderColor(BorderType.Bottom, System.Drawing.Color.Red);
cell.SetStyle(style);

Réglage des formats de nombre

Aspose.Cells.GridDesktop fournit également des paramètres de formats de nombre. Il existe 58 formats de nombre intégrés offerts par Aspose.Cells.GridDesktop. Pour voir une liste complète de tous les formats de nombre pris en charge, veuillez vous référer à Formats de nombre pris en charge.

Tous les formats de nombre intégrés se voient attribuer un numéro d’index. Par exemple, le numéro d’index du format de nombre 0.00E+00 est 11 . Pour utiliser un format de nombre intégré dans n’importe quelle cellule, les développeurs peuvent définir la propriété NumberFormat de l’objet Style sur le numéro d’index de ce format de nombre spécifique. Cependant, si les développeurs ont besoin de leur propre format de nombre personnalisé, ils peuvent également utiliser la propriété Custom de l’objet Style.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing first worksheet of the Grid
Aspose.Cells.GridDesktop.Worksheet sheet = gridDesktop1.Worksheets[0];

// Creating a standard Font object that will be applied on cells
System.Drawing.Font font = new System.Drawing.Font("MS Serif", 9f, FontStyle.Bold);

// Accessing and adding values to cells
Aspose.Cells.GridDesktop.GridCell cell = sheet.Cells["B2"];
cell.Value = "General";
cell.SetFont(font);
cell = sheet.Cells["C2"];
cell.Value = 1000;
cell = sheet.Cells["D2"];
cell.Value = "Text";
cell = sheet.Cells["B4"];
cell.Value = "Number";
cell.SetFont(font);

//Accessing the Style object of "C4" cell and setting its number format to index No.2
cell = sheet.Cells["C4"];
cell.Value = 20.00;
Aspose.Cells.GridDesktop.Style style = cell.GetStyle();

// For applying "0.00" format
style.NumberFormat = 2;
cell.SetStyle(style);

// Accessing the Style object of "D4" cell and setting its number format to index No.3
cell = sheet.Cells["D4"];
cell.Value = -2000.00;
style = cell.GetStyle();

// For "#,##0" format
style.NumberFormat = 3;
cell.SetStyle(style);

// Accessing a cell and setting its value & font
cell = sheet.Cells["B6"];
cell.Value = "Currency";
cell.SetFont(font);

// Accessing the Style object of "C6" cell and setting its number format to index No.6
cell = sheet.Cells["C6"];
cell.Value = -120.00;
style = cell.GetStyle();

// For Applying "\"$\"#,##0_);[Red](\"$\"#,##0)" expression
style.NumberFormat = 6;
cell.SetStyle(style);

// Accessing the Style object of "D6" cell and setting its number format to index No.41
cell = sheet.Cells["D6"];
cell.Value = 2400;
style = cell.GetStyle();

// For applying "_(\"$\"* #,##0_);_(\"$\"* (#,##0);_(\"$\"* \"-\"_);_(@_)" expression
style.NumberFormat = 41;
cell.SetStyle(style);

// Accessing a cell and setting its value & font
cell = sheet.Cells["B8"];
cell.Value = "Percent";
cell.SetFont(font);

// Accessing the Style object of "C8" cell and setting its number format to index No.9
cell = sheet.Cells["C8"];
cell.Value = 0.32;
style = cell.GetStyle();
style.NumberFormat = 9;
cell.SetStyle(style);

// Accessing the Style object of "D8" cell and setting its number format to index No.10
cell = sheet.Cells["D8"];
cell.Value = 0.64;
style = cell.GetStyle();

// For applying "0.00%" format
style.NumberFormat = 10;
cell.SetStyle(style);

// Accessing a cell and setting its value & font
cell = sheet.Cells["B10"];
cell.Value = "Scientific";
cell.SetFont(font);

// Accessing the Style object of "C10" cell and setting its number format to index No.11
cell = sheet.Cells["C10"];
cell.Value = 0.51;
style = cell.GetStyle();

// For applying "0.00E+00" format
style.NumberFormat = 11;
cell.SetStyle(style);

// Accessing the Style object of "D10" cell and setting its number format to index No.48
cell = sheet.Cells["D10"];
cell.Value = 32000;
style = cell.GetStyle();
style.NumberFormat = 48;
cell.SetStyle(style);

// Accessing a cell and setting its value & font
cell = sheet.Cells["B12"];
cell.Value = "DateTime";
cell.SetFont(font);

// Accessing the Style object of "C12" cell and setting a custom number format for it
cell = sheet.Cells["C12"];
cell.Value = DateTime.Now;
style = cell.GetStyle();
style.Custom = "yyyy-MM-dd";
cell.SetStyle(style);

// Accessing the Style object of "D12" cell and setting its number format to Index No.15
cell = sheet.Cells["D12"];
sheet.Columns[cell.Column].Width = 100;
cell.Value = DateTime.Now;
style = cell.GetStyle();

// For "d-mmm-yy"
style.NumberFormat = 15;
cell.SetStyle(style);

// Accessing the Style object of "C13" cell and setting a custom number format for it
cell = sheet.Cells["C13"];
cell.Value = DateTime.Now;
style = cell.GetStyle();
style.Custom = "hh:mm:ss";
cell.SetStyle(style);

// Accessing the Style object of "D13" cell and setting its number format to index No.18
cell = sheet.Cells["D13"];
cell.Value = DateTime.Now;
style = cell.GetStyle();

// For applying "h:mm AM/PM" format
style.NumberFormat = 18;
cell.SetStyle(style);

// Accessing the Style object of "C14" cell and setting a custom number format for it
cell = sheet.Cells["C14"];
sheet.Columns[cell.Column].Width = 160;
cell.Value = DateTime.Now;
style = cell.GetStyle();
style.Custom = "yyyy-MM-dd hh:mm:ss";
cell.SetStyle(style);