DDL Command LISTPICK

DDL Command LISTPICK LISTPICK

Presents a scrolling list of choices. When you make a choice, it is returned in the named variable. The list supports character navigation. That is, as you type characters, the list repositions itself.

Form1:
LISTPICK/options %v keyname [x,y]
[TITLE "literal"] [HEADING "literal"] [DELIMITER IS "character"]
Form2:
LISTPICK/options %v collection tname fdesc1 [... fdesc6] [x,y]
[TITLE "literal"] [HEADING "literal"] [DELIMITER IS "character"]

Notation standards Options Answers
Options:
H -Include a help button on the Listpick dialog object
K -Make this a multiple choice Listpick
S -Sort and therefore navigate on the second field listed
Wn -Make this a wide scrolling list (n is number of fields to show)
X -Suppress the command response
Y -Do not alter the command answer cells

Answers:
Ctl.Ans1 =1 if user picked something, else zero
Ctl.Ans2 = Zero
Ctl.Ans3 = Zero
%status = Zero or an error code

Notes:
In form1 a keyed field is specified and the list is instantaneous. In form2 the list is built from the records isolated in the specified collection. Although there is no limit on the number of records involved, you will find a practical limit based on the length of time it takes to build the list.

When the K option is specified you may select as many items as you wish. To select, click on an item. To deselect, click on a selected item. When you click OK all of the selected items go into the named variable separated either by a blank or by the delimiter you specified with the DELIMITER IS clause. Then you can scan them off using the NXT function for blank-delimited scanning or the NXTD function for delimited scanning.

In form2 up to six fields can be specified. The field named first is the thing being selected no matter if the sort (and therefore the character navigation) is on the first or the second field. The W option is used to specify how many fields are to show and causes a horizontal scroll bar so that the user can scroll wide to see the rest.

X,Y determines the initial placement of the upper left corner of the Listpick object. Once placed, the user can move the Listpick around at will. For more information about X,Y, see notation standards .

LISTPICK is modal. Modal means that you must deal with the LISTPICK (either pick something or Cancel) before you can do anything else. That is, when a LISTPICK is up all of the buttons or menu choices that you may see on the screen but that are not inside the LISTPICK frame are rendered inoperable. So that means that when a LISTPICK is active the user does not have the normal access to HELP. If you want your user to have access to HELP during a LISTPICK then use the H option and a HELP button will be available inside the LISTPICK frame.