SetDropDown SEToolBar

<< Click to Display Table of Contents >>

Navigation:  SEUIXP Classes for X# > Classes > SEToolBar >

SetDropDown SEToolBar

Previous pageReturn to chapter overviewNext page

Purpose

Sets a command to a toolbar buttons drop down button.

This has only an effect to toolbar buttons with the BTNS_DROPDOWN or the BTNS_WHOLEDROPDOWN style.

 

Prototype

METHOD SetDropDown(nMenuItemID, uCommand, uExtra, symTB) CLASS SEToolBar

 

Arguments

<nMenuItemID>

A numeric value which is the item ID of an existing toolbar button.

 

[<uCommand>]

A menu object or a symbol.

If it is a menu object, the specified menu will be poped up directly near the toolbar button.

 

If it is a symbolic value, its meaning is identical to the event name in the menu editor.

If the toolbar button drop down button with the item id <nMenuItemID> is pressed an event with the name <uCommand> is invoked. At runtime, the system will first look for a method with this name. If no method can be found, it will look for a Window or ReportQueue class.  If none of these can be found, the menu selection will do nothing.

 

If <uCommand> is not specified a former assigned command will be deleted.

 

[<uExtra>]

If <uCommand> is a menu object, <uExtra> specifies the number of the sub menu (nMenuIndex) which should be displayed. Also <uExtra> can be a PTR value.

In this case it specifies a menu handle of off the sub menus of the menu object.

If <uCommand> is a symbol, <uExtra> is unused.

 

[<symTB>]

The symbolic name of the toolbar. Default is #MainToolBar.

 

Return

NIL