HbListBox() > Methods

oHbListBox:insItem()

Inserts a new item into a list box.

Syntax

oHbListBox:insItem( <nItemPos>, ;
                    <cText>   , ;
                   [<xValue>]   ) --> self

Arguments

<nItemPos>

This is a numeric value specifying the ordinal position where to insert the list box item. Items are numbered from 1 to :itemCount.

<cText>

This is a character string holding the textual information of the list box item to insert.

<xValue>

Optionally, an arbitrary value can be passed which is associated with <cText>.

Description

Method :insItem() accepts a text string and an optional associated value which are inserted at position <nItemPos> into the internal list of list box items. The return value is the HbListBox object. The instance variable :itemCount reflects the new number of list box items maintained by a HbListBox object.