How to: Change Cell Font and Background Color

• Apr 08, 2019
• 2 minutes to read

You can change cell font color and cell background.

To specify these attributes for an individual cell, modify the Cell object’s Formatting.Font and Formatting.Fill properties, which are inherited form the Formatting interface.

To change color characteristics for a range of cells, call the Range.BeginUpdateFormatting method for this range, modify the Font and Fill properties of the returned Formatting object and call the Range.EndUpdateFormatting method to finalize the modification.

• Cell Font Color

  The Formatting.Font property returns the SpreadsheetFont object. Set this object’s SpreadsheetFont.Color property to the required Color value to change cell font color.

• Cell Background

  The Formatting.Fill property returns the Fill object. Use the following properties of this object to set cell background.

  • Fill.BackgroundColor - sets the cell background color. It is also available via the Range.FillColor property of the cell or cell range object.
  • Fill.PatternType - sets the type of cell background pattern. The available pattern types are accessed via the PatternType enumeration members.
  • Fill.PatternColor - sets the shading color for a cell.

To share font color and background settings with multiple cells in a single step, create or modify a style with the Formatting.Font and Formatting.Fill properties specified as required, and assign this style to Range.Style for the desired cells.

This example demonstrates how to format color characteristics (font and background colors) for an individual cell and range of cells.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/spreadsheet-document-server-api-e4339

FormattingActions.cs

// Format an individual cell.
worksheet.Cells["A1"].Font.Color = Color.Red;
worksheet.Cells["A1"].FillColor = Color.Yellow;

// Format a range of cells.
Range range = worksheet.Range["C3:D4"];
Formatting rangeFormatting = range.BeginUpdateFormatting();
rangeFormatting.Font.Color = Color.Blue;
rangeFormatting.Fill.BackgroundColor = Color.LightBlue;
rangeFormatting.Fill.PatternType = PatternType.LightHorizontal;
rangeFormatting.Fill.PatternColor = Color.Violet;
range.EndUpdateFormatting(rangeFormatting);

FormattingActions.vb

' Format an individual cell.
worksheet.Cells("A1").Font.Color = Color.Red
worksheet.Cells("A1").FillColor = Color.Yellow

' Format a range of cells.
Dim range As Range = worksheet.Range("C3:D4")
Dim rangeFormatting As Formatting = range.BeginUpdateFormatting()
rangeFormatting.Font.Color = Color.Blue
rangeFormatting.Fill.BackgroundColor = Color.LightBlue
rangeFormatting.Fill.PatternType = PatternType.LightHorizontal
rangeFormatting.Fill.PatternColor = Color.Violet
range.EndUpdateFormatting(rangeFormatting)

The image below shows colored cells (the workbook is opened in Microsoft® Excel®).