List Box: _selectText

List Box: _selectText

Selects or deselects the list box item that has specified text

Syntax
Details
Example

Syntax

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

Argument Type Description

item-text
C specifies the text to find; item-text is case sensitive

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

action
C specifies an action to apply to the row:

'OFF' deselects the row

'ON' selects the row (the default)

'TOGGLE' deselects the row if it is selected, and selects the row if it is not selected

Argument	Type	Description
item-text	C	specifies the text to find; item-text is case sensitive
occurrence	N	specifies the number of the occurrence if the text occurs more than once. The default is 1.
action	C	specifies an action to apply to the row:
		'OFF'	deselects the row
		'ON'	selects the row (the default)
		'TOGGLE'	deselects the row if it is selected, and selects the row if it is not selected

Details

If the list box allows only one selection, the specified item is selected and the previously selected item is deselected. If the list box allows multiple selections and the maximum number of allowable selections is exceeded, the program halts.

Example

_selectText uses the default action, ON, to select the row containing North Carolina in LISTBOX1:

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

Chapter Contents
Previous
Next
Top of Page