TB_SETROWS message

Sets the number of rows of buttons in a toolbar.

Parameters

wParam

The LOWORD specifies the number of rows requested. The minimum number of rows is one, and the maximum number of rows is equal to the number of buttons in the toolbar.

The HIWORD is a BOOL that indicates whether to create more rows than requested when the system cannot create the number of rows specified by wParam. If TRUE, the system creates more rows. If FALSE, the system creates fewer rows.

lParam

Pointer to a RECT structure that receives the bounding rectangle of the toolbar after the rows are set.

Return value

No return value.

Remarks

Because the system does not break up button groups when setting the number of rows, the resulting number of rows might differ from the number requested.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Commctrl.h