BBjMenu::insertMenuItem

Description

Inserts a menu item into the BBjMenu.

Syntax

Return Value

Method

BBjMenuItem

insertMenuItem(int index, int ID, string title)

BBjMenuItem

insertMenuItem(int index, int ID, string title, int action)

BBjMenuItem

insertMenuItem(int index, int ID, string title, int checkable, int checked)

Parameters

Variable

Description

index

Specifies the 0-based index at which to insert the menu item.

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

Specifies whether the menu item is checkable.

0 = Not checkable

1 = Checkable

checked

Specifies whether the menu item is checked if it is checkable.

0 = Not checked

1 = Checked

Return Value

Returns the created BBjMenuItem object that was inserted into the menu.

Remarks

Each sub menu in the menu item with an index greater or equal to the specified index is shifted upward to have an index one greater than the value it had previously.

Example

REM Insert a menu item into 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(-103,"Cu&t",mySysGui!.CUT)
myMenu!.addMenuItem(-104,"&Copy",mySysGui!.COPY)
myMenu!.addMenuItem(-105,"&Paste",mySysGui!.PASTE)
myMenu!.insertMenuItem(0,-101,"Menu Item 1")
myMenu!.insertMenuItem(1,-102,"Menu Item 2")

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
RETURN

See Also

BBjAPI

BBjSysGui

BBjControl

BBjWindow

BBjMenu

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