NAME
tixButtonBox - Create and manipulate Tix ButtonBox widgets
SYNOPSIS
tixButtonBox pathName ?options? -anchor -background -cursor
-relief -borderWidth
WIDGET-SPECIFIC OPTIONS
Static Option. Specifies the orientation of the button subwidgets. Only
the values "horizontal" and "vertical" are recognized. Specifies the
horizontal padding between two neighboring button subwidgets in the
ButtonBox widget.
Specifies the vertical padding between two neighboring button
subwidgets in the ButtonBox widget. Specifies the state of all the
buttons inside the ButtonBox widget.
Note: Setting this option using the config widget command will enable
or disable all the buttons subwidgets. Original states of the
individual buttons are not saved. Only the values "normal" and
"disabled" are recognized.
SUBWIDGETS
All the button subwidgets created as a result of the add command can be
accessed by the subwidget command. They are identified by the
buttonName parameter to the add command. Here is an example:
set bbox [tixButtonBox .bbox] pack $bbox $bbox add eat -text Eat
$bbox add sleep -text Sleep $bbox subwidget eat config -fg green
$bbox subwidget sleep config -fg red
DESCRIPTION
The tixButtonBox command creates a new window (given by the pathName
argument) and makes it into a ButtonBox widget. Additional options,
described above, may be specified on the command line or in the option
database to configure aspects of the ButtonBox such as its cursor and
relief.
The ButtonBox widget can be used as a container widget to hold the
‘‘action’’ buttons in a dialog box.
WIDGET COMMAND
The tixButtonBox command creates a new Tcl command whose name is the
same as the path name of the ButtonBox’s window. This command may be
used to invoke various operations on the widget. It has the following
general form:
pathName option ?arg arg ...?
PathName is the name of the command, which is the same as the ButtonBox
widget’s path name. Option and the args determine the exact behavior
of the command. The following commands are possible for ButtonBox
widgets:
pathName add buttonName ?option value ...?
Add a new button subwidget with the name buttonName into the
ButtonBox widget. Additional configuration options can be given
to configure the new button subwidget.
pathName cget option
Returns the current value of the configuration option given by
option. Option may have any of the values accepted by the
tixButtonBox 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 pathName (see Tk_ConfigureInfo for
information on the format of this list). If option is specified
with no value, then the command returns a list describing the
one named option (this list will be identical 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
tixButtonBox command.
pathName invoke buttonName
Invoke the button subwidget with the name buttonName.
pathName subwidget name ?args?
When no additional arguments are given, returns the pathname of
the subwidget of the specified name.
When no additional arguments are given, the widget command of
the specified subwidget will be called with these parameters.
BINDINGS
TixButtonBox widgets have no default bindings. The button subwidgets
retain their default Tk bindings.
KEYWORDS
Tix(n), Container Widgets