InsertToolBarDropdownImageButtonEx

www.progui.co.uk  Top  Previous  Next

InsertToolBarDropdownImageButtonEx()

Syntax

Success = InsertToolBarDropdownImageButtonEx(Toolbar.i, Position.l, ButtonID.l, MenuID.i, Text$, *NormalImageID, *HotImageID, *DisabledImageID, style.l)

Description

Inserts a drop-down image button into a 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.

Toolbar.i specifies the handle/ID of the ToolBarEx you want to insert the button into. Position.l is the zero-based index of where the button will be inserted and can be -1 in order to append the button to the end of the ToolBarEx. 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, please see ToolBarDropdownImageButtonEx for details.

 

Returns zero for failure or the Button ID for success.

 

ToolBarEx Index