Help Center

CToolbar.SetRowsmethod

Sets the number of rows of buttons in a toolbar.

WindowsmethodCToolbar.incdocumented

Syntax

SUB SetRows (BYVAL hToolbar AS HWND, BYVAL cRows AS WORD, BYVAL fLarger AS BOOLEAN, BYVAL prc AS RECT PTR)
SUB SetRows (BYVAL hToolbar AS HWND, BYVAL cRows AS WORD, BYVAL fLarger AS BOOLEAN, BYREF rc AS RECT)

Parameters

NameDescription
hToolbarHandle to the toolbar control.
cRowsThe 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
fLargerIndicates 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.
prcPointer to a RECT structure that receives the bounding rectangle of the toolbar after the rows are set.
rcA RECT structure that receives the bounding rectangle of the toolbar after the rows are set.

Description

Sets the number of rows of buttons in a toolbar.

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.

Reference

  • Include file CToolbar.inc
  • Defined in AfxNova/CToolbar.inc:1244
  • Documented in Windows/WIndows Controls/CToolbar Class.md
  • Topic: CToolbar Class