Use this record-level keyword to define a subfile as a multiple-choice-selection list. A multiple-choice-selection list is scrollable group of items from which the user can select multiple items.
The format of this keyword is:
SFLMLTCHC[(&number-selected] [*NORSTCSR | *RSTCSR] [*NOSLTIND | *SLTIND])]
Parameters are optional and may be entered in any order.
The &number-selected parameter allows the application to find the number of items that were selected in the multiple-selection list. This parameter must name a hidden field with a length of 4, data type of Y, and zero decimal positions.
The *RSTCSR parameter specifies whether the arrow keys should be allowed to move the selection cursor outside of the selection list. *RSTCSR specifies that the arrow keys will not cause the selection cursor to move outside of the push button field. *NORSTCSR specifies that the arrow keys will cause the selection cursor to leave the field. If the SFLMLTCHC subfile control record is defined in a pulldown, the default is *RSTCSR. Otherwise, the default is *NORSTCSR.
The *SLTIND parameter specifies whether selection indicators are used when this selection list is displayed on a graphical display. *SLTIND specifies that the check boxes should be used on color graphical displays as selection indicator. *NOSLTIND specifies that no selection indicator should be used on a color graphical display and only a selection cursor can be used to make a selection. The default is *NOSLTIND.
A subfile containing the SFLMLTCHC keyword must:
This optional keyword is valid only for the subfile control record format.
The following subfile control record keywords can not be specified on a
record with the SFLMLTCHC keyword:
SFLDROP SFLFOLD SFLSNGCHC |
|
The CHCAVAIL, CHCSLT, and CHCUNAVAIL keywords can be used to indicate the color of the items within the selection list, when the list is displayed on a color display station. The CHCAVAIL keyword indicates the color of the items within the list which are available for selection. The CHCSLT keyword indicates the color of the selected items. The CHCUNAVAIL keyword indicates the items on the list which are not available for selection. These keywords can be used in a subfile control record only if SFLSNGCHC or SFLMLTCHC keywords are also used.
Option indicators are not valid for this keyword.
(C) Copyright IBM Corporation 1992, 2006. All Rights Reserved.