List Box: _unselectText

List Box: _unselectText

Deselects an item that has specified text

Syntax
Details
Example

Syntax

CALL NOTIFY (list-box-name, '_unselectText', item-text<, occurrence>);

Argument Type Description

item-text
C specifies the text of the item to deselect

occurrence
N specifies the number of the text's occurrence if the text occurs more than once. The default is 1.

Argument	Type	Description
item-text	C	specifies the text of the item to deselect
occurrence	N	specifies the number of the text's occurrence if the text occurs more than once. The default is 1.

Details

If deselections are not allowed for the list box, the _unselectText method causes a program halt. In addition, if the value of occurrence is greater than the number of occurrences, the program halts.

Example

_unselectText deselects the first occurrence of the item North Carolina in LISTBOX1:

   call notify('listbox1','_unselect_text_',
               'North Carolina');

Chapter Contents
Previous
Next
Top of Page