List Box: _setMaxsel

List Box: _setMaxsel

Assigns the maximum number of list box items that can be selected

Syntax
Details
Example

Syntax

CALL NOTIFY (list-box-name, '_setMaxsel', maximum<, allow-desel>);

Argument Type Description

maximum
N specifies the number of items that can be selected

allow-desel
N if maximum is 1, specifies a value indicating whether list box items may be deselected:

1 may be deselected

0 may not be deselected

if maximum is >1, specifies a value indicating the selection style:

1 extended selection

0 multiple selection

Argument	Type	Description
maximum	N	specifies the number of items that can be selected
allow-desel	N	if maximum is 1, specifies a value indicating whether list box items may be deselected:
		1	may be deselected
		0	may not be deselected
		if maximum is >1, specifies a value indicating the selection style:
		1	extended selection
		0	multiple selection

Details

The program halts if maximum is less than 0. If you change the maximum to less than the number of currently selected items, the most recently selected items are deselected.

Example

_setMaxsel sets the maximum number of selections in LISTBOX1 to 3:

   call notify('listbox1','_set_maxsel_',3);
   call notify('listbox1','_get_maxsel_',
                maxsel);
   put "The following should be MAXSEL=3 :
       " maxsel=;

Chapter Contents
Previous
Next
Top of Page