QWizard_Widgets(3) User Contributed Perl Documentation QWizard_Widgets(3)NAMEQWizard_Widgets - Describes the Widgets available to QWizard Generators
OVERVIEW
This document describes the various QWizard backend widgets that can be
produced and what tags they support, and what the values of those tags
are expected to produce (either by direct value such as
tag => "string"
or as a result of a code execution like
tag => sub { return "string" }
or even:
tag => [sub { return $_[$#_] }, "string"]
Tag Value Expectations
The documentation to follow will reference a number of different value
types for various tags. These possible values are described below:
single
A single value is expected for this tag. If a subroutine returns
multiple values only the first will be used.
multi
The tag expects or can accept multiple values. These values should
be specified in the form of an array reference.
norecuse
This is a special form of "multi"... I need to go look at the code
again to remember exactly what it does.
values,labels
This is a special tag to indicate the widget needs both values and
labels associated with the multiple sub-widgets it can display
(radio boxes, menu items, check boxes, ...). The values tag (an
array ref) will indicate which values are used within the program.
The labels clause will map those values to human strings. The
labels clause can be either a hash mapping values to labels, or an
array where the even elements of the array (0, 2, 4, ...) will be
the values and the odd elements (1, 3, 5, ...) will be the labels
to associate with them. An array reference for labels allows the
order of label presentation to be specified, where as a hash will
display the labels/sub-widgets in a somewhat random order.
If the labels clause is left out, the values themselves will be
present to the user.
If the values clause is left out, the values will be pulled from
the labels.
It is likely a rare case that you need to specify both. This
special tag name specifically indicates you can specify both.
forced
This is a value which is forced for a particular tag for internal
use and can't be manipulated by the programmer. It's documented
here anyway for completeness.
Notes about this document.
1) This file is automatically generated from the Generator's own
expect ions of their supported widgets and the requirements. Thus,
not all widgets in all generators are perfectly equal. Some
generators have better support for extra options for certain
widgets, for example.
2) This document does not specify some of the other tags that every
question is allowed to have, such as "name", "text", "helpddesc",
"check_value", ... It only discusses the tags that the back end
generators make use of.
WIDGET SUPPORT SUMMARY MATRIX
+--------------+----+----+--+--------+
| |HTML|Gtk2|Tk|ReadLine|
+--------------+----+----+--+--------+
|bar |X |X | | |
|button |X |X |X | |
|checkbox |X |X |X |X |
|filedownload |X |X |X | |
|fileupload |X |X |X |X |
|graph |X |X |X | |
|hidetext |X |X |X | |
|image |X |X |X | |
|label |X |X |X |X |
|link |X | | | |
|menu |X |X |X |X |
|multi_checkbox|X |X |X |X |
|paragraph |X |X |X |X |
|radio |X |X |X |X |
|table |X |X |X | |
|text |X |X |X |X |
|textbox |X |X |X |X |
|unknown |X |X |X |X |
+--------------+----+----+--+--------+
THE GENERATORS
QWizard::Generator::HTML
These are the question types known to the QWizard::Generator::HTML
generator class:
bar
values => norecurse
button
values => single
checkbox
values => multi
default => single
submit => single
refresh_on_change => single
button_label => single
filedownload
name => single
default => single
data => single
datafn => noexpand
extension => single
linktext => single
fileupload
values => default
graph
values => norecurse
graph_options => norecursemulti
hidetext
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
image
imgdata => norecurse
image => norecurse
imagealt => single
height => single
width => single
label
values => multi
link
linktext => single
url => single
menu
=> values,labels
default => single
submit => single
refresh_on_change => single
name => single
multi_checkbox
default => multi
values,labels => single
submit => single
refresh_on_change => single
paragraph
values => multi
preformatted => single
radio
values,labels => single
default => single
submit => single
refresh_on_change => single
name => single
icons => single
noiconpadding => single
table
values => norecurse
headers => norecurse
text
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
textbox
default => single
width => single
size => single
height => single
submit => single
refresh_on_change => single
unknown
QWizard::Generator::Gtk2
These are the question types known to the QWizard::Generator::Gtk2
generator class:
bar
values => norecurse
button
values => single
default => single
icon => single
padding => single
runcode => noexpand
checkbox
values => multi
default => single
name => single
submit => single
refresh_on_change => single
button_label => single
filedownload
name => single
default => single
data => single
datafn => noexpand
fileupload
name => single
default => single
graph
values => norecurse
graph_options => norecursemulti
hidetext
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
image
imgdata => norecurse
image => norecurse
imagealt => single
addscalebuttons => single
label
values => multi
menu
values,labels => single
default => single
name => single
submit => single
refresh_on_change => single
multi_checkbox
default => multi
values,labels => single
refresh_on_change => single
paragraph
values => multi
preformatted => single
width => single
radio
=> values,labels
default => single
name => single
submit => single
refresh_on_change => single
icons => single
noiconpadding => single
table
values => norecurse
headers => norecurse
text
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
textbox
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
unknown
QWizard::Generator::Tk
These are the question types known to the QWizard::Generator::Tk
generator class:
button
values => single
default => single
checkbox
values => multi
default => single
button_label => single
filedownload
values => default
fileupload
values => default
graph
values => norecurse
graph_options => norecursemulti
hidetext
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
image
imgdata => norecurse
image => norecurse
imagealt => single
label
values => multi
menu
values,labels => single
default => single
name => single
multi_checkbox
default => multi
values,labels => single
paragraph
values => multi
preformatted => single
width => single
radio
=> values,labels
default => single
name => single
table
values => norecurse
headers => norecurse
text
name => single
default => single
size => single
maxsize => single
submit => single
refresh_on_change => single
textbox
name => single
default => single
size => single
width => single
height => single
unknown
QWizard::Generator::ReadLine
These are the question types known to the QWizard::Generator::ReadLine
generator class:
checkbox
values => multi
default => single
name => single
fileupload
values => default
label
values => multi
menu
=> values,labels
default => single
name => single
multi_checkbox
default => multi
values,labels => single
paragraph
values => multi
radio
=> values,labels
default => single
name => single
text
name => single
default => single
textbox
name => single
default => single
size => single
maxsize => single
submit => single
unknown
AUTHOR
Wes Hardaker, hardaker@users.sourceforge.net
SEE ALSO
QWizard, perl(1)
Net-Policy: http://net-policy.sourceforge.net/
POD ERRORS
Hey! The above document had some coding errors, which are explained
below:
Around line 75:
You forgot a '=back' before '=head2'
Around line 94:
You forgot a '=back' before '=head1'
perl v5.14.0 2008-09-17 QWizard_Widgets(3)
