BBjListButton::insertItemAt

Description

Inserts an item into the list of the BBjListButton control.

Syntax

Return Value	Method
void	insertItemAt(int `index`, string item)

Parameters

Variable	Description
index	Specifies the 0-based index at which the item will be inserted.
item	Specifies the item to be added.

Return Value

None.

Remarks

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

Example

rem 'Insert items into a list button control

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
myWindow! = mySysGui!.addWindow(X,Y,WIDTH,HEIGHT,TITLE$)

rem 'Add a list button control to the window
myListButton! = myWindow!.addListButton(101,50,100,90,60,"",$0000$)

rem 'Insert items into the list button control
FOR I = 1 TO 4
    ITEM$="ITEM " + STR(I)

    rem 'Insert each item a the begging of the list, the items will be in
    rem 'reverse order (ITEM4..ITEM1)
    myListButton!.insertItemAt(0,ITEM$)
NEXT I

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