SEC_TREECLASS::SetItemText

Sets the text of the specified item. See remarks for subitems.

Defined in: trcore.inl

Syntax

SetItemText( HTREEITEM hItem, LPCTSTR lpszItem )

SetItemText( HTREEITEM hItem, int nSubItem, LPCTSTR lpszItem )

Return Value

Nonzero if successful; otherwise 0.

Parameters

hItem

Handle of the item whose text is to be set.

nSubItem

The subitem index, indicating the column number. Default is 0.

lpszItem

Address of a string containing the new text for the item.

Comments

If you want to use SetItemText() or SetItemString() for subitems and NOT use LV_GETDISPINFO, you must call StoreSubItemText( TRUE ). This will enable internal string storage for subitems.

For large trees, it may be desireable to use the callback to conserve memory. By default, the callback is used.