Home page  
Help >
DDL Command CHOOSE
Version 7.11
DDL Command CHOOSE CHOOSE

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:
CHOOSE/options %v keyname [x,y]
[TITLE "literal"] [HEADING "literal"] [DELIMITER IS "character"]
Form2:
CHOOSE/options %v collection tname fdesc1 [... fdesc6] [x,y]
[TITLE "literal"] [HEADING "literal"] [DELIMITER IS "character"]
Form3:
CHOOSE/D %v [x,y]
[TITLE "literal"] [HEADING "literal"] [DELIMITER IS "character"]

Notation standards Options Answers
Options:
B -Sort presented items on all fields
Cn -Present only the first "count" items (n is the count)
D -Show a list of Table names
F -Sort presented items on first field
H -Include a Help button on the CHOOSE dialog object
I -Show a list of record description names
K -Make this a multiple choice CHOOSE
L -Remove leading blanks from result
M -Suppress mapping
S -Sort presented items on second field
T -Used with /D option to include record counts
Used with /I option to include RD types
U -Convert result to upper case
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 =The item number selected, else zero
Ctl.Ans2 =The record number of the item chosen
Ctl.Ans3 =The full text of the selected line

Notes:
The maximum number of items in a CHOOSE list is 400.

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 Choose object. Once placed, the user can move it around at will. For more information about X,Y, see notation standards .

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

Copyright © 2019 , WhamTech, Inc.  All rights reserved. This document is provided for information purposes only and the contents hereof are subject to change without notice. Names may be trademarks of their respective owners.