BBjMenuBar::insertMenu

Description

Inserts menu into the BBjMenuBar.

Syntax

Return Value	Method
BBjMenu	insertMenu(int index, int ID, string title)

Parameters

Variable	Description
index	Specifies the 0-based index in which the menu will be inserted into the menu bar.
ID	Specifies the menu ID of the menu that will be inserted.
title	Specifies the title of the menu.

Return Value

Returns the created BBjMenu object.

Remarks

Each menu in the menu bar 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 into a menu bar at given an index

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 the menu bar
myMenuBar! = myWindow!.addMenuBar()

rem 'Insert the menu into the menu bar at given an index
myMenu! = myMenuBar!.insertMenu(0,-100,"&Menu")

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