Next: guintrctplt() Up: Graphical Interface Help File Previous: guilistctrl()   Contents

guilistdlg()

Usage:
guilistdlg(many, many keyword arguments)



Keywords:
This routine brings up a dialog box allowing you to choose variables,
and returns a CHARACTER vector of the chosen names.  It takes 
keyword arguments of several types: usexxxx:T, reqxxxx:T, and
attrxxxx:T|F (for example, attrlogic:T or reqreal:T).  Without any
arguments, all variables are included in the dialog.  If an reqxxx:T
argument is present, any variable must match the xxxx to be listed in
the dialog.  If one or more usexxxx:T arguments is present, then a
variable must match at least one of the xxxx descriptors to be 
included in the dialog.  If an attrxxx: keyword is used, then a
checkbox will be added to the dialog to optionally allow variables
that match the xxx to be show.  The T or F of the attrxxx keyword
determines whether the checkbox in initially checked or unchecked. 
Note: if any attrxxx:T arguments are present, then a variable must
match at least one of them to be listed.

There are two additional reqxxx keywords.  reqnrows:k means that a
variable must have leading dimension k; reqndims:k means that a
variable must have k dimensions.

Keyword maxselected:k sets that at most k variables can be selected.
0 is the default, and it indicates no limit.

usonly:vec says to use only the names in the character vector vec.
omit:vec says to omit any names in the character vector vec.

matchrows:T means that once a variable has been selected, only
variables that match the number of rows will be show.  This differs
from reqnrows:k in that matchrows:T allows different numbers of
rows to be shown before the first variable is selected.

Possible xxxx attributes are:
char         CHARACTER variable
graph        GRAPH variable
logic        LOGIC variable
macro        MACRO variable
real         REAL variable

scalr        Scalar variable
vect         Vector variable (a la isvector)
matrx        Matrix variable (a la ismatrix)
1d           Exactly one dimensional
2d           Exactly two dimensional
array        Array variable
struc        Structure variable

lockd        Locked variable
ulock        Unlocked variable

factr        Factor variable
vart         Variate (1 dimensional, real, not factor) variable
binary       0/1 variable
system       Name is all capitals, and either longer than
                         1 letter or not "E"

nonsys       A non-system variable
nsvart       A non-system variate
nsfact       A non-system factor
ns1d         A non-system 1d variable
ns2d         A non-system 2d variable
nsstrc       A non-system structure


Gary Oehlert 2005-08-12