List Object
[ Home ] [ Up ] [ General Object Information ] [ Label Object ] [ Button Object ] [ Text Object ] [ Banner Object ] [ Scrolling Text Object ] [ List Object ] [ Drop-Down Object ] [ Check Box Object ] [ Plotting Object ] [ Slider Object ] [ Bar Object ] [ Meter and Gauge Objects ] [ Image Object ] [ Image Button Object ] [ Back, Timers and Reset Objects ]

The List box object (oList) can be used to provide a selection of choices or to provide a list of updated information.

When creating, use the 'List Add' input box to add items to the list.

The event is triggered by double-clicking an item in the list.  The value returned is the current items text value.

The index of the item can be returned from (objName.I) and the total number of items, count, can be gotten from (objName.C).

bulletCreating:
!POBJ oList.objName=L,T [,W,H,font size,val1,val2,...]
!POBJ oList.List1=60,95
!POBJ oList.List2=60,70,15,40,9,one,two,three,four,five,six,seven

bulletFunctions:
SET (.Set or may be omitted)
Set the current select by text value.  If the value does not exist, it will be added.
objName.Set=Value
!POBJ List2.Set=eight

ADD: (.Add)
Adds an item to the listbox.  Commas may be used in the value.
objName.Add=string
!PObj List2.Add=This,is,ok

CLEAR (.Clear or .Clr)
Clears a list box
!POBJ List2.Clear

Text Tip (.Tip)
Sets the text pop-up tip
!POBJ objName.Tip=Text string
!POBJ List2.Tip=This is a tip!

Font (.Font or .F)
Sets the font of the object
!POBJ objName.Font=[Font name,size,italic (0/1),bold (0/1)]

Move (.Move or .M)
Moves the object to new coordinates/changes sizing
!POBJ objName.Move=[L,T,W,H]   or !POBJ objName.M=[L,T,W,H] 
!POBJ List2.M=50,50,,10

Set Focus (.SF)
Sets the current focus of the application to the object
!POBJ objName.SF
!POBJ List2.SF

 

bulletUpdate Value (.Update or .U)
Sets the value which will be used to update the object whenever a !POBJ Update is performed.
!POBJ objName.U=[text]
!POBJ List2.U=(AMAX)

bulletCode Event
Event on selection double-click.
!POBJ List2.Code=!STAT (LIST2)

bulletValues
(objName) - Returns the selected text
(objName.I) - Returns the position of the selected text. (1st entry is 1 **Change from version 2.9.x)
(objName.C)- Returns the count of the items
(objName.T) - Top coordinate
(objName.L) - Left coordinate
(objName.W) - Width
(objName.H) - Height
(ME) - Used only in its event code, returns object name.
((ME)) - Used only in its event code, returns object value.

!STAT (List2) is selected at position (List2.I) of a total of ((ME).C)