NAME

       tixButtonBox - Create and manipulate Tix ButtonBox widgets

SYNOPSIS

       tixButtonBox pathName ?options?  -anchor   -background    -cursor -relief   -borderWidth

WIDGET-SPECIFIC OPTIONS

       [-orientation orientation]   Static  Option.  Specifies  the  orientation  of  the  button
       subwidgets. Only the values "horizontal"  and  "vertical"  are  recognized.   [-padx padx]
       Specifies  the  horizontal  padding  between  two  neighboring  button  subwidgets  in the
       ButtonBox widget.

       [-pady pady] Specifies the vertical padding between two neighboring button  subwidgets  in
       the  ButtonBox  widget.   [-state state] 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