Spread for ASP.NET 12 Product Documentation
Customizing Header Label Text
Spread for ASP.NET 12 Product Documentation > Developer's Guide > Customizing the Appearance > Customizing the Appearance of Headers > Customizing Header Label Text

By default the component displays letters in the column headers and numbers in the row headers. Besides this automatic text, you can add labels to any or all of the header cells. You can customize the header label text, as shown in the following figure where the first four columns have custom labels.

Spread with custom column header text

To specify the custom text for a header label, you can use the Column Label property or the Row Label property or you can use the Cell Text property. For headers with multiple columns and multiple rows, you use the Text property of the Cells shortcut objects. Refer to the example in Creating a Header with Multiple Rows or Columns.

To customize the sequential letters in column headers and sequential numbers in row headers that are displayed by default, refer to Customizing the Default Header Labels.

Cells in the headers are separate from the cells in the data area, so the coordinates for cells in the headers start at 0,0 and count up from upper left to lower right within the header. The sheet corner cell is separate and is not counted when figuring header cell coordinates.

Using the Properties Window

  1. At design time, in the Properties window, select the FpSpread component.
  2. Select the Sheets property.
  3. Click the button to display the SheetView Collection Editor.
  4. Click the sheet for which you want to change the header labels.

    You cannot add or change custom text in cells other than the labels displayed when using the Properties window.

  5. In the property list, select the Cells property and click the button to display the Cell, Column, and Row Editor.
  6. Select the column for which you want to change the labels displayed to custom text.
  7. Set the Label property to set the custom text.
  8. Click OK to close the Cell, Column, and Row Editor.
  9. Click OK to close the SheetView Collection Editor.

Using a Shortcut

Example

This example code sets custom text for the labels in the first four column headers.

C#
Copy Code
// Set custom text for columns A through D.
FpSpread1.Sheets[0].ColumnCount = 4;
FpSpread1.Sheets[0].ColumnHeader.Columns[0].Label = "North";
FpSpread1.Sheets[0].ColumnHeader.Columns[1].Label = "South";
FpSpread1.Sheets[0].ColumnHeader.Columns[2].Label = "East";
FpSpread1.Sheets[0].ColumnHeader.Columns[3].Label = "West"; 
VB
Copy Code
' Set custom text for columns A through D.
FpSpread1.Sheets(0).ColumnCount = 4
FpSpread1.Sheets(0).ColumnHeader.Columns(0).Label = "North"
FpSpread1.Sheets(0).ColumnHeader.Columns(1).Label = "South"
FpSpread1.Sheets(0).ColumnHeader.Columns(2).Label = "East"
FpSpread1.Sheets(0).ColumnHeader.Columns(3).Label = "West" 

Using the Spread Designer

  1. Select the sheet at the bottom of the designer.
  2. Select the Settings menu.
  3. Select the Header editor in the Other Settings section.
  4. Select the header you wish to edit.
  5. Set the Label property in the property grid.
  6. Choose Apply and OK to apply your changes to the component.
  7. Click Apply and Exit to close the Spread Designer.