You can reset various settings on various parts of the Spread component interface back to default or original values. You can also clear parts of the data area of various items, both data and formatting.
The ways in which parts of the component can be reset include:
Reset the settings for cells, rows, or columns using the individual reset methods for each setting in the Cell or Row or Column class:
Resetting Desired | Method Name |
---|---|
Background color for individual cells or for row or column of cells | ResetBackColor |
Border for individual cells or for row or column of cells | ResetBorder |
Cell type for individual cells or for row or column of cells | ResetCellType |
Text font for individual cells or for row or column of cells | ResetFont |
Foreground color for individual cells or for row or column of cells | ResetForeColor |
Row height | ResetHeight |
Cell contents horizontal alignment for individual cells or for row or column of cells | ResetHorizontalAlignment |
Cell header label | ResetLabel |
Locked status for individual cells or for row or column of cells | ResetLocked |
Merge policy for a row or column of cells | ResetMergePolicy |
Cell note indicator color for individual cells or for row or column of cells | ResetNoteIndicatorColor |
Parent style name for individual cells or for row or column of cells | ResetParentStyleName |
Column resizable | ResetResizable |
Column sort indicator | ResetSortIndicator |
Cell contents vertical alignment for individual cells or for row or column of cells | ResetVerticalAlignment |
Row or column visible | ResetVisible |
Column width | ResetWidth |
Reset all the named style properties to their default values using the NamedStyle class Reset method. There are also individual reset methods for each of the settings in a style:
Method Name | Resetting Desired |
---|---|
Reset | All the properties of the style |
ResetBackColor | Background color of a cell |
ResetBorder | Border around a cell |
ResetCanFocus | Whether the cell can receive focus |
ResetCellType | Cell type of the cell |
ResetEditor | Editor used for editing the cell |
ResetFont | Font face used in the text of the cell |
ResetForeColor | Text (foreground) color in a cell |
ResetFormatter | Formatter for formatting the contents of the cell |
ResetHorizontalAlignment | horizontal alignment of text in a cell |
ResetLocked | Whether the cell is marked as locked |
ResetName | Default name of the style |
ResetNoteIndicatorColor | Color of the cell note indicator |
ResetNoteStyle | Cell note style |
ResetParent (Inherited from StyleInfo) | Parent style name |
ResetProperty | Specified setting property |
ResetRenderer | Renderer for painting the cell |
ResetTabStop | Whether the user can set focus to the cell using the Tab key |
ResetVerticalAlignment | Vertical alignment of text in a cell |
If you are setting the background color for an individual cell, then ResetBackColor resets that cell's background color to its default color. If, instead, you set the background color using the BackColor property for a Row object, then you must use the ResetBackColor for that row. If you want to loop all the cells setting the color to White, you can speed this up by invalidating the painting in the Spread while you are looping the cells as shown in the following code.
Visual Basic |
Copy Code
|
---|---|
fpSpread1.SuspendLayout()
fpSpread1.Sheets(0).Cells(0, 0, 499, 499).BackColor = Color.White
fpSpread1.ResumeLayout(True)
|
C# |
Copy Code
|
---|---|
fpSpread1.SuspendLayout();
fpSpread1.Sheets[0].Cells(0, 0, 499, 499).BackColor = Color.White;
fpSpread1.ResumeLayout(true);
|
Resetting the component or a sheet to its default settings returns the component or the sheet to its initial state prior to any design-time or run-time changes. It clears data, resets colors, and returns cells to the default cell type. Resetting the component resets everything in the component to the state when the component is first drawn on the form.
Note: Resetting the component or a sheet clears the data in the sheet(s) as well as the formatting. If you provide a way for users to reset their sheet(s), be sure to have them confirm the action before resetting the sheet(s).
You can find out the default size of the component using the FpSpread DefaultSize property.
For more information about clearing data, refer to Removing Data from a Sheet.
For information on resetting values creating during the design using Spread Designer, refer to the explanation of this procedure in the Spread Designer Guide.