CellTag Property
Applies To
fpSpread control
Description
Sets or returns the user-defined tag for a specified cell, column, row, or the entire sheet. This property is available at run time only.
Syntax
CString CSpreadSheet::GetCellTag( );
void CSpreadSheet::SetCellTag(LPCTSTR value);
[form.]fpSpread.CellTag[ = text$]
Remarks
The default value for the CellTag property is an empty string. This value is only for the application's use; the control does not use this value.
You can assign user-defined information to any cell, column, or row, or the entire sheet. This property lets you provide information for a cell, column, row, or the sheet, similar to the SetItemData, SetColItemData, and SetRowItemData methods, which let you assign information to the sheet, a column, or a row. The information provided by the CellTag property is stored separately from the information provided by the ItemData methods. If you prefer, you can provide either or both kinds of information for the sheet, columns, and rows.
This setting is applied to the current sheet setting unless you first set the Sheet property to specify the sheet for which you are setting the property. Before specifying the cell tag, specify the cell or cells for which you are setting a tag, as described in Using Column and Row Properties.
Spread Designer
Choose the Cell menu, the Tag menu, and then the Cell Tag tab, and then type in the Tag edit box in the Cell Settings dialog box.
Data Type
String
See Also
Sheet property
GetColItemData, GetItemData, GetRowItemData, SetColItemData, SetItemData, SetRowItemData methods
DLL Correspondence
SSGetCellTag, SSSetCellTag functions