ToolBarDropdownImageButtonEx

ToolBarDropdownImageButtonEx()

Syntax

Success = ToolBarDropdownImageButtonEx(ButtonID.l, MenuID.i, Text$, *NormalImageID, *HotImageID, *DisabledImageID, Style.l)

Description

Adds a drop-down image button to the current ToolBarEx. This is like a normal image button except when you click on the button it displays a popup menu just below it.

This command defaults so that the button will be drawn with a drop-down arrow in a separate section, to the right of the button.

ButtonID specifies the internal ID to be used and if #ProGUI_Any is used then the returned value will be the new Button ID. MenuID is the handle/ID of the popup menu you want to attach to the button. Text$ is displayed as the button's label and can contain escape-code effects (see MenuItemEx for details).  NormalImageID, HotImageID and DisabledImageID are pointers to image data that are used to display the button in the various states. Style.l specifies the optional Windows flags for the button and can include any of the following:

#BTNS_WHOLEDROPDOWN - Specifies that the button will have a drop-down arrow, but not as a separate section.

#BTNS_AUTOSIZE

#BTNS_NOPREFIX

#BTNS_SHOWTEXT

See Microsoft MSDN for details.

Returns zero for failure or the Button ID for success.

ToolBarEx Index