SftTree/DLL 7.5 - Tree Control

RowHeaderLines

Defines the number of text lines used for row header height calculation.

C

int WINAPI SftTree_GetRowHeaderLines(HWND hwndCtl);
void WINAPI SftTree_SetRowHeaderLines(HWND hwndCtl, int nLines);
int WINAPI SftTreeSplit_GetRowHeaderLines(HWND hwndCtl);
void WINAPI SftTreeSplit_SetRowHeaderLines(HWND hwndCtl, int nLines);

C++

int CSftTree::GetRowHeaderLines() const;
void CSftTree::SetRowHeaderLines(int nLines = 1);
int CSftTreeSplit::GetRowHeaderLines() const;
void CSftTreeSplit::SetRowHeaderLines(int nLines = 1);

Parameters

hwndCtl

The window handle of the tree control.

nLines

The number of text lines used for row headers to calculate the expected height of items.

Returns

GetRowHeaderLines returns the current number of text lines last defined using SetRowHeaderLines.

Comments

The GetRowHeaderLines and SetRowHeaderLines functions define the number of text lines used for row header height calculation.

The height of items is determined based on an item's attributes such as registered item picture size, label picture size, fonts used, etc. Using SetRowHeaderLines, an application can specify how many lines of text an item can display in a row header.

In a fixed height tree control (see SFTTREESTYLE_VARIABLE), all row headers have the same number of text lines. If an application needs multiple text lines, SetRowHeaderLines must be used to specify the number of text lines.

In a variable height tree control, each item's height is determined individually. If an application requires new line characters in row headers, SetRowHeaderLines must be used to specify the maximum number of text lines to display in all row headers. If row header text exceeds the specified number of lines, "+" is shown at the bottom, right corner of the row header.

A tree control defaults to one line of text for each row header.

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