BBjPopupMenu::addSeparator

Description

In BBj 3.0 and higher, this method adds a separator to the end of a BBjPopupMenu.

Syntax

Return Value

Method

void

addSeparator()

Parameters

None.

Return Value

None.

Remarks

None.

Example

REM Add a separator to a popup 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=100
Y=100
WIDTH=200
HEIGHT=100
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 a button
myButton! = myWindow!.addButton(1,55,35,90,30,"OK")

REM Add a popup menu to the button
myPopupMenu!=myButton!.addPopupMenu()

REM Add menu items, including a separator, to the popup menu
myItem1! = myPopupMenu!.addMenuItem(-201,"Item 1")
myItem2! = myPopupMenu!.addMenuItem(-202,"Item 2")
myPopupMenu!.addSeparator()
myItem3! = myPopupMenu!.addMenuItem(-203,"Item 3",1,0)
myItem4! = myPopupMenu!.addMenuItem(-204,"Item 4",1,1)

REM Register the CALLBACK routines
CALLBACK(ON_BUTTON_PUSH,OK,mySysGui!.getContext(),myButton!.getID())
CALLBACK(ON_POPUP_ITEM_SELECT,Item1,myPopupMenu!.getID(),myItem1!.getID())
CALLBACK(ON_POPUP_ITEM_SELECT,Item2,myPopupMenu!.getID(),myItem2!.getID())
CALLBACK(ON_POPUP_ITEM_SELECT,Item3,myPopupMenu!.getID(),myItem3!.getID())
CALLBACK(ON_POPUP_ITEM_SELECT,Item4,myPopupMenu!.getID(),myItem4!.getID())
CALLBACK(ON_CLOSE,APP_CLOSE,mySysGui!.getContext())

REM Process Events
PROCESS_EVENTS

REM Callback routine invoked when the user clicks the button
OK:
i = msgbox("OK Button was selected")
return

REM Callback routine invoked when the user selects the first item
Item1:
i = msgbox("Item 1 was selected")
return

REM Callback routine invoked when the user selects the second item
Item2:
i = msgbox("Item 2 was selected")
return

REM Callback routine invoked when the user selects the third item
Item3:
if myItem3!.isSelected() then state$="ON" else state$="OFF"
i = msgbox("Item 3 was selected and is now checked "+state$)
return

REM Callback routine invoked when the user selects the fourth item
Item4:
if myItem4!.isSelected() then state$="ON" else state$="OFF"
i = msgbox("Item 4 was selected and is now checked "+state$)
return

REM Callback routine called when the user closes the application window
APP_CLOSE:
RELEASE

See Also

BBjAPI

BBjSysGui Methods

BBjControl Methods

BBjPopupMenu

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