1tixButtonBox(n)              Tix Built-In Commands             tixButtonBox(n)
2
3
4

NAME

6       tixButtonBox - Create and manipulate Tix ButtonBox widgets
7

SYNOPSIS

9       tixButtonBox   pathName   ?options?    -anchor   -background    -cursor
10       -relief   -borderWidth
11

WIDGET-SPECIFIC OPTIONS

13       [-orientation orientation] Static Option. Specifies the orientation  of
14       the  button subwidgets. Only the values "horizontal" and "vertical" are
15       recognized.  [-padx padx] Specifies the horizontal padding between  two
16       neighboring button subwidgets in the ButtonBox widget.
17
18       [-pady pady]  Specifies  the  vertical  padding between two neighboring
19       button subwidgets in the ButtonBox  widget.   [-state state]  Specifies
20       the state of all the buttons inside the ButtonBox widget.
21
22       Note:  Setting  this option using the config widget command will enable
23       or disable all the buttons subwidgets. Original states of the  individ‐
24       ual  buttons are not saved. Only the values "normal" and "disabled" are
25       recognized.
26

SUBWIDGETS

28       All the button subwidgets created as a result of the add command can be
29       accessed  by  the subwidget command. They are identified by the button‐
30       Name parameter to the add command. Here is an example:
31
32       set bbox [tixButtonBox .bbox] pack $bbox  $bbox  add  eat    -text  Eat
33       $bbox  add  sleep  -text  Sleep  $bbox subwidget eat   config -fg green
34       $bbox subwidget sleep config -fg red
35

DESCRIPTION

37       The tixButtonBox command creates a new window (given  by  the  pathName
38       argument)  and  makes  it  into a ButtonBox widget. Additional options,
39       described above, may be specified on the command line or in the  option
40       database  to  configure aspects of the ButtonBox such as its cursor and
41       relief.
42
43       The ButtonBox widget can be used as a  container  widget  to  hold  the
44       ``action'' buttons in a dialog box.
45

WIDGET COMMAND

47       The  tixButtonBox  command  creates a new Tcl command whose name is the
48       same as the path name of the ButtonBox's window. This  command  may  be
49       used  to  invoke various operations on the widget. It has the following
50       general form:
51              pathName option ?arg arg ...?
52       PathName is the name of the command, which is the same as the ButtonBox
53       widget's  path  name.  Option and the args determine the exact behavior
54       of the command.  The following commands are possible for ButtonBox wid‐
55       gets:
56
57       pathName add buttonName ?option value ...?
58              Add  a  new  button  subwidget with the name buttonName into the
59              ButtonBox widget. Additional configuration options can be  given
60              to configure the new button subwidget.
61
62       pathName cget option
63              Returns  the  current value of the configuration option given by
64              option. Option may have  any  of  the  values  accepted  by  the
65              tixButtonBox command.
66
67       pathName configure ?option? ?value option value ...?
68              Query  or modify the configuration options of the widget.  If no
69              option is specified, returns a list describing all of the avail‐
70              able  options for pathName (see Tk_ConfigureInfo for information
71              on the format of this list). If  option  is  specified  with  no
72              value,  then the command returns a list describing the one named
73              option (this list will be identical to the corresponding sublist
74              of  the  value  returned  if no option is specified).  If one or
75              more option-value pairs are specified, then the command modifies
76              the  given  widget option(s) to have the given value(s); in this
77              case the command returns an empty string. Option may have any of
78              the values accepted by the tixButtonBox command.
79
80       pathName invoke buttonName
81              Invoke the button subwidget with the name buttonName.
82
83       pathName subwidget  name ?args?
84              When  no additional arguments are given, returns the pathname of
85              the subwidget of the specified name.
86
87              When no additional arguments are given, the  widget  command  of
88              the specified subwidget will be called with these parameters.
89

BINDINGS

91       TixButtonBox  widgets  have  no default bindings. The button subwidgets
92       retain their default Tk bindings.
93

KEYWORDS

95       Tix(n), Container Widgets
96
97
98
99
100
101
102Tix                                   4.0                      tixButtonBox(n)
Impressum