Defines the row header display style.

C

int WINAPI SftTree_GetShowRowHeader(HWND hwndCtl);
void WINAPI SftTree_SetShowRowHeader(HWND hwndCtl, int style);
int WINAPI SftTreeSplit_GetShowRowHeader(HWND hwndCtl);
void WINAPI SftTreeSplit_SetShowRowHeader(HWND hwndCtl, int style);

C++

int CSftTree::GetShowRowHeader() const;
void CSftTree::SetShowRowHeader(int style);
int CSftTreeSplit::GetShowRowHeader() const;
void CSftTreeSplit::SetShowRowHeader(int style);

Parameters

hwndCtl

The window handle of the tree control.

style

A value describing the row header display style:

SFTTREE_ROWSTYLE_NONE	No row headers.
SFTTREE_ROWSTYLE_BUTTONTEXT	Displays row headers as buttons.  No default text.
SFTTREE_ROWSTYLE_TITLETEXT	Displays row headers as titles.  No default text.
SFTTREE_ROWSTYLE_BUTTONCOUNT0	Displays row headers as buttons.  The row header text defaults to the zero-based index of the item and can be specified using SetRowText.
SFTTREE_ROWSTYLE_TITLECOUNT0	Displays row headers as titles.  The row header text defaults to the zero-based index of the item and can be specified using SetRowText.
SFTTREE_ROWSTYLE_BUTTONCOUNT1	Displays row headers as buttons.  The row header text defaults to the one-based index of the item and can be specified using SetRowText.
SFTTREE_ROWSTYLE_TITLECOUNT1	Displays row headers as buttons.  The row header text defaults to the one-based index of the item and can be specified using SetRowText.

Returns

GetShowRowHeader returns a value describing the current row header style.

Comments

The GetShowRowHeader and SetShowRowHeader functions define the row header display style.

If the current style is set to SFTTREE_ROWSTYLE_BUTTONTEXT, SFTTREE_ROWSTYLE_BUTTONCOUNT0 or SFTTREE_ROWSTYLE_BUTTONCOUNT1, the row headers are displayed as buttons, which can be clicked by the user.  Row header buttons reflect the selection status (See GetSel and GetCurSel) of each item.

The value defined using SetShowRowHeader applies to all row headers and cannot be changed for individual items.

The status of the row header buttons can be controlled using SetRowHeaderStyle. 

See Also  C/C++ API  |  Categories |  Notifications