Next: guintrctplt()
Up: Graphical Interface Help File
Previous: guilistctrl()
Contents
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
2006-01-30