Defines the position of text displayed in the row headers.

C

DWORD WINAPI SftTree_GetRowHeaderStyle(HWND hwndCtl);
void WINAPI SftTree_SetRowHeaderStyle(HWND hwndCtl, DWORD style);
DWORD WINAPI SftTreeSplit_GetRowHeaderStyle(HWND hwndCtl);
void WINAPI SftTreeSplit_SetRowHeaderStyle(HWND hwndCtl, DWORD style);

C++

DWORD CSftTree::GetRowHeaderStyle() const;
void CSftTree::SetRowHeaderStyle(DWORD style);
DWORD CSftTreeSplit::GetRowHeaderStyle() const;
void CSftTreeSplit::SetRowHeaderStyle(DWORD style);

Parameters

hwndCtl

The window handle of the tree control.

style

The row header style used for all row headers.  This value applies to all row headers.

One value of each of the following tables can be combined and passed as style parameter.

style	Horizontal row header text alignment
not specified	If no horizontal row header text alignment is specified, the default is ES_LEFT.
ES_LEFT	The row header text is left aligned within the row header.  Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
ES_CENTER	The row header text is centered within the row header.  Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
ES_RIGHT	The row header text is right aligned within the row header.  Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.

style	Vertical row header text alignment
not specified	If no vertical row header text alignment is specified, the default is SFTTREE_VCENTER.
SFTTREE_TOP	The row header text and picture are aligned with the top of the row header.  Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
SFTTREE_VCENTER	The row header text and picture are vertically centered within the row header.  Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.
SFTTREE_BOTTOM	The row header text and picture are aligned with the bottom of the row header.  Row headers can override this default by defining new alignment values using the SFTTREE_ROW, flag member.

The style value can optionally be combined with one or more of the following values:

SFTTREE_HEADER_DISABLED	The row headers are disabled, cannot be clicked and are displayed in a "grayed" fashion.  The item contents are otherwise unaffected.
SFTTREE_HEADER_UP	The row header buttons will automatically return to their "up" position when clicked.

Returns

GetRowHeaderStyle returns a value indicating the position of the text displayed in row headers.

Comments

The GetRowHeaderStyle and SetRowHeaderStyle functions define the position of text displayed in the row headers.

The row header style defined using SetRowHeaderStyle affects all row headers, individual items cannot override the style given.

Row header text can be defined using SetRowText.

Row headers are made visible using SetShowRowHeader. 

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