HeaderPane
Main
Hide
Share Link
Print

RowHeaderLines

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

C

int WINAPI SftBox_GetRowHeaderLines(HWND hwndCtl);
void WINAPI SftBox_SetRowHeaderLines(HWND hwndCtl, int nLines);

C++

int CSftBox::GetRowHeaderLines() const;
void CSftBox::SetRowHeaderLines(int nLines);

Parameters

hwndCtl

The window handle of the combo box control.

nLines

The number of text lines used for row headers to calculate the expected height of items. Values less than 1 are treated as 1.

Returns

GetRowHeaderLines returns the current number of text lines used for row headers.

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 combo box (see SFTBOXSTYLE_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 combo box, 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.

A combo box defaults to one line of text for each row header.

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


Last Updated 11/21/2026 - (email)
© 2026 Softel vdm, Inc.