BBjWindow::getMenuItem

Description

In BBj 7.0 and higher, this method returns a BBjControl object in the BBjWindow cast to a BBjMenuItem.

In BBj 11.0 and higher, this method supports reference to the BBjMenuItem by name with a (string name) parameter.

Syntax

Return Value	Method
BBjMenuItem	getMenuItem(int controlID)
BBjMenuItem	getMenuItem(string name)

Parameters

Return Value	Method
controlID	Specifies the ID of the control. A value of 0 may be used to get information about a context's window or dialog rather than an individual control or child window (as defined in the CTRL() function).
name	Specifies name given to a BBj control using the setName method.

Return Value

This convenience method calls getControl() and casts the result to a BBjMenuItem.

Remarks

If the control that generated this event is not a BBjMenuItem, this method will generate an !ERROR=26.

Example

rem Demostrate use of BBjWindow::getMenuItem()
declare BBjSysGui sysgui!
declare BBjTopLevelWindow win!
declare BBjMenuBar menubar!
declare BBjMenu menu!
declare BBjMenuItem menuItem!
declare BBjMenuItemSelectEvent event!

sysgui!=BBjAPI().openSysGui("X0")

win!=sysgui!.addWindow(100,100,300,200,"Window with menu")
menuBar!=win!.addMenuBar()
menu!=menuBar!.addMenu(-1,"File")
menuItem!=menu!.addMenuItem(-10,"New")
menuItem!=menu!.addMenuItem(-11,"Open")
menuItem!=menu!.addMenuItem(-12,"Save")
menuItem!=menu!.addMenuItem(-13,"Save As")
menuItem!=menu!.addMenuItem(-14,"Close")
menuItem!=menu!.addMenuItem(-15,"Exit")
menuItem!.setCallback(menuItem!.ON_MENU_ITEM_SELECT,"exit_pressed")

rem Get the "Save" menu item for the window and print its name.
menuItem!=win!.getMenuItem(-12)
print menuItem!.getText()

process_events

exit_pressed:
release