Modify an Existing Style
To apply the same formatting options to cells, create a new formatting style object. A formatting style object is a combination of formatting characteristics, such as font, font size, indentation, number, border, patterns etc., named and stored as a set. When applied, all of the formatting in that style are applied.
You can also use an existing style, save it with the workbook and use to format information with the same attributes.
When cells aren’t explicitly formatted, the Normal style (the workbook’s default style) is applied. Microsoft Excel predefines several styles in addition to the Normal style including Comma, Currency, and Percent.
Aspose.Cells allows modifying any of these styles or any other style that you define with your desired attributes.
Using Microsoft Excel
To update a style in Microsoft Excel 97-2003:
- On the Format menu, click Style.
- Select the style you want to modify from the Style name list.
- Click Modify.
- Select the style options that you want using the tabs in the Format Cells dialog.
- Click OK.
- Under Style includes, specify the style features you want.
- Click OK to save the style and apply it to the selected range.
Using Aspose.Cells
The following examples demonstrate how to use Style.Update method.
Creating and Modifying a Style
This example creates a Style object, applies it to a range of cells and modifies the Style object. The modifications are automatically applied to the cell and the range the style was applied to.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
// Create a workbook. | |
Workbook workbook = new Workbook(); | |
// Create a new style object. | |
Style style = workbook.CreateStyle(); | |
// Set the number format. | |
style.Number = 14; | |
// Set the font color to red color. | |
style.Font.Color = System.Drawing.Color.Red; | |
// Name the style. | |
style.Name = "Date1"; | |
// Get the first worksheet cells. | |
Cells cells = workbook.Worksheets[0].Cells; | |
// Specify the style (described above) to A1 cell. | |
cells["A1"].SetStyle(style); | |
// Create a range (B1:D1). | |
Range range = cells.CreateRange("B1", "D1"); | |
// Initialize styleflag object. | |
StyleFlag flag = new StyleFlag(); | |
// Set all formatting attributes on. | |
flag.All = true; | |
// Apply the style (described above)to the range. | |
range.ApplyStyle(style, flag); | |
// Modify the style (described above) and change the font color from red to black. | |
style.Font.Color = System.Drawing.Color.Black; | |
// Done! Since the named style (described above) has been set to a cell and range, | |
// The change would be Reflected(new modification is implemented) to cell(A1) and // Range (B1:D1). | |
style.Update(); | |
// Save the excel file. | |
workbook.Save(dataDir+ "book_styles.out.xls"); |
Modifying an Existing Style
This example uses a simple template Excel file in which a style called Percent has already been applied to a range. The example:
- gets the style,
- creates a style object and
- modifies the style formatting.
The modifications are automatically applied to the range the style was applied to.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET | |
// The path to the documents directory. | |
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType); | |
/* | |
* Create a workbook. | |
* Open a template file. | |
* In the book1.xls file, we have applied Ms Excel's | |
* Named style i.e., "Percent" to the range "A1:C8". | |
*/ | |
Workbook workbook = new Workbook(dataDir+ "book1.xlsx"); | |
// We get the Percent style and create a style object. | |
Style style = workbook.GetNamedStyle("Percent"); | |
// Change the number format to "0.00%". | |
style.Number = 11; | |
// Set the font color. | |
style.Font.Color = System.Drawing.Color.Red; | |
// Update the style. so, the style of range "A1:C8" will be changed too. | |
style.Update(); | |
// Save the excel file. | |
workbook.Save(dataDir+ "book2.out.xlsx"); |