BBjMenu::addMenuItem

Description

Adds a menu item to the BBjMenu.

Syntax

Return Value

Method

BBjMenuItem

addMenuItem(int ID, string title)

BBjMenuItem

addMenuItem(int ID, string title, int action)

BBjMenuItem

addMenuItem(int ID, string title, boolean checkable, boolean checked)

BBjMenuItem

addMenuItem(int ID, string title, boolean checkable, boolean checked, int action)

Parameters

Variable

Description

ID

Specifies the ID of the menu item to be added.

title

Specifies the title of the menu item.

action

Specifies one of the following special menu actions:

32027   CUT

32028   COPY

32029   PASTE

checkable

A boolean that specifies whether the menu item is checkable.

checked

A boolean value that specifies whether the menu item is checked if it is checkable.

Return Value

Returns the created BBjMenuItem object.

Remarks

None.

Example

rem 'Add a menu item to a menu

rem 'Obtain the instance of the BBjAPI object
let myAPI! = BBjAPI()

rem 'Open the SysGui device
SYSGUI = UNT
OPEN (SYSGUI) "X0"

rem 'Obtain the instance of the BBjSysGui object
let mySysGui! = myAPI!.getSysGui()

rem 'Set addWindow param values
X = 10
Y = 10
WIDTH = 200
HEIGHT = 200
TITLE$ = "BBj Window"

rem 'Set the current context
mySysGui!.setContext(0)

rem 'Create a window with a title in the current context
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

rem 'Create some edit boxes for doing cut/copy/paste
oneEditBox! = myWindow!.addEditBox(101,10,10,180,30,"first text control")
twoEditBox! = myWindow!.addEditBox(102,10,50,180,30,"second text control")

rem 'Create the menu bar
myMenuBar! = myWindow!.addMenuBar()

rem 'Add a menu to the menu bar
myMenu! = myMenuBar!.addMenu(-100,"&Menu")

rem 'Add menu items to the menu
myMenu!.addMenuItem(-101,"Menu Item 1")
myMenu!.addMenuItem(-102,"Menu Item 2")
myMenu!.addMenuItem(-103,"Cu&t",mySysGui!.CUT)
myMenu!.addMenuItem(-104,"&Copy",mySysGui!.COPY)
myMenu!.addMenuItem(-105,"&Paste",mySysGui!.PASTE)

rem 'Register the CALLBACK routines
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())

rem 'Process Events
process_events

rem 'Callback routine called when the user closes the application window
APP_CLOSE:
release

See Also

BBjAPI

BBjSysGui

BBjControl

BBjWindow

BBjMenu

Keyboard Focus, Keyboard Navigation, and the Default Button

See the BBj Object Diagram for an illustration of the relationship between BBj Objects.