BBjListButton::removeItemAt

Description

Removes an item from the list in the BBjListButton control.

Syntax

Return Value

Method

void

removeItemAt(int index)

Parameters

Variable

Description

index

Specifies the 0-based index of the item to be removed from the list.

Return Value

None.

Remarks

Each item in the list with an index greater than the removed item's index is shifted downward to have an index one smaller than the value it had previously.

Example

rem 'Remove an item from 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 'Make a vector that will contain list items
myVector! = mySysGui!.makeVector()

rem 'Insert items into the vector
FOR I = 1 TO 4
    ITEM$="ITEM " + STR(I)
    myVector!.addItem(ITEM$)
NEXT I

rem 'Insert items in the vector into the list button control
myListButton!.insertItems(0,myVector!)

rem 'Remove an item from a list button control, this wil remove "ITEM 1"
myListButton!.removeItemAt(0)

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

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