Spread 8.0 Documentation
CellTag Property
Support Options
ActiveX Reference > ActiveX Properties > CellTag Property

Glossary Item Box

CellTag Property


See Also    DLL    Example

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

C++

CString CSpreadSheet::GetCellTag( );
void CSpreadSheet::SetCellTag(LPCTSTR value);

Visual Basic

[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

Providing Cell Tags

Sheet property

GetColItemData, GetItemData, GetRowItemData, SetColItemData, SetItemData, SetRowItemData methods

DLL Correspondence

SSGetCellTag, SSSetCellTag functions

© 2002-2014 ComponentOne, a division of GrapeCity. All Rights Reserved.