NAME
buttonbox - Create and manipulate a manager widget for
buttons
SYNOPSIS
buttonbox pathName ?options?
INHERITANCE
itk::Widget <- buttonbox
STANDARD OPTIONS
background cursor
See the "options" manual entry for details on the standard
options.
WIDGET-SPECIFIC OPTIONS
Name: orient
Class: Orient
Command-Line Switch: -orient
Orientation of the button box: horizontal or verti
cal. The default is horizontal.
Name: padX
Class: PadX
Command-Line Switch: -padx
Specifies a non-negative padding distance to leave
between the button group and the outer edge of the
button box in the x direction. The value may be
given in any of the forms acceptable to Tk_GetPix
els. The default is 5 pixels.
Name: padY
Class: PadY
Command-Line Switch: -pady
Specifies a non-negative padding distance to leave
between the button group and the outer edge of the
button box in the y direction. The value may be
given in any of the forms acceptable to Tk_GetPix
els. The default is 5 pixels.
_________________________________________________________________
DESCRIPTION
The buttonbox command creates a manager widget for con
trolling buttons. The button box also supports the dis
play and invocation of a default button. The button box
can be configured either horizontally or vertically.
The buttonbox command creates a new Tcl command whose name
is pathName. This command may be used to invoke various
operations on the widget. It has the following general
form:
pathName option ?arg arg ...?
Option and the args determine the exact behavior of the
command.
Many of the widget commands for the buttonbox take as one
argument an indicator of which button of the button box to
operate on. These indicators are called indexes and allow
reference and manipulation of buttons regardless of their
current map state. buttonbox indexes may be specified in
any of the following forms:
number Specifies the button numerically, where 0 cor
responds to the left/top-most button of the
button box.
end Indicates the right/bottom-most button of the
button box.
default Indicates the current default button of the
button box. This is the button with the
default ring displayed.
pattern If the index doesn't satisfy one of the above
forms then this form is used. Pattern is pat
tern-matched against the tag of each button in
the button box, in order from left/top to
right/left, until a matching entry is found.
The rules of Tcl_StringMatch are used.
WIDGET-SPECIFIC METHODS
pathName add tag args
Add a button distinguished by tag to the end of the
button box. If additional arguments are present
they specify options to be applied to the button.
See PushButton for information on the options
available.
pathName buttonconfigure index ?options?
This command is similar to the configure command,
except that it applies to the options for an indi
vidual button, whereas configure applies to the
options for the button box as a whole. Options may
have any of the values accepted by the PushButton
command. If options are specified, options are
modified as indicated in the command and the com
mand returns an empty string. If no options are
options for entry index (see Tk_ConfigureInfo for
information on the format of this list).
pathName cget option
Returns the current value of the configuration
option given by option. Option may have any of the
values accepted by the buttonbox command.
pathName configure ?option? ?value option value ...?
Query or modify the configuration options of the
widget. If no option is specified, returns a list
describing all of the available options for path
Name (see Tk_ConfigureInfo for information on the
format of this list). If option is specified with
no value, then the command returns a list describ
ing the one named option (this list will be identi
cal to the corresponding sublist of the value
returned if no option is specified). If one or
more option-value pairs are specified, then the
command modifies the given widget option(s) to have
the given value(s); in this case the command
returns an empty string. Option may have any of
the values accepted by the buttonbox command.
pathName default index
Sets the default button to the button given by
index. This causes the default ring to appear
arround the specified button.
pathName delete index
Deletes the button given by index from the button
box.
pathName hide index
Hides the button denoted by index. This doesn't
remove the button permanently, just inhibits its
display.
pathName index index
Returns the numerical index corresponding to index.
pathName insert index tag ?option value option value ...?
Same as the add command except that it inserts the
new button just before the one given by index,
instead of appending to the end of the button box.
The option, and value arguments have the same
interpretation as for the add widget command.
pathName invoke ?index?
Invoke the command associated with a button. If no
arguments are given then the current default button
is invoked, otherwise the argument is expected to
be a button index.
Display a previously hidden button denoted by
index.
EXAMPLE
buttonbox .bb
.bb add Yes -text Yes -command "puts Yes"
.bb add No -text No -command "puts No"
.bb add Maybe -text Maybe -command "puts Maybe"
.bb default Yes
pack .bb -expand yes -fill both
AUTHOR
Bret A. Schuhmacher
Mark L. Ulferts
KEYWORDS
buttonbox, pushbutton, button, widget
Man(1) output converted with
man2html