Toolbar Styles

Toolbar styles that are the same in both Windows CE and Windows-based desktop platforms are described in the following table.

Style Description
TBSTYLE_CUSTOMERASE Creates a toolbar that generates NM_CUSTOMDRAW notification messages when it processes WM_ERASEBKGND messages.
TBSTYLE_FLAT Creates a flat toolbar, in which both the toolbar and the buttons are transparent. Button text appears under button bitmaps.
TBSTYLE_LIST Places button text to the right of button bitmaps. This style can only be used with the TBSTYLE_FLAT style.
TBSTYLE_TRANSPARENT Creates a transparent toolbar, in which the toolbar is transparent but the buttons are not. Button text appears under button bitmaps.
TBSTYLE_WRAPABLE Creates a toolbar that can have multiple rows of buttons. Toolbar buttons can wrap to the next line when the toolbar becomes too narrow to include all buttons on the same line. Wrapping occurs on separation and non-group boundaries.

In Windows CE, the TBSTYLE_LIST style creates a toolbar with variable width buttons. If you want to use the TBSTYLE_LIST style with fixed width buttons, you can override the default behavior by sending a TB_SETBUTTONSIZE or TB_SETBUTTONWIDTH message.

Because Windows CE does not support drag-and-drop operations for toolbars, it does not support the TBSTYLE_ALTDRAG style or the TBSTYLE_REGISTERDROP style.

Note Because Windows CE does not support an actual ToolTip control, you cannot pass it a handle to a ToolTip control. Instead, the TB_SETTOOLTIPS message in Windows CE takes a wParam, which is the number of ToolTip strings to associate with the toolbar, and an lParam, which is the array of ToolTip strings to associate with the toolbar buttons.