1tixButtonBox(n) Tix Built-In Commands tixButtonBox(n)
2
6 tixButtonBox - Create and manipulate Tix ButtonBox widgets
7
9 tixButtonBox pathName ?options? -anchor -background -cursor
10 -relief -borderWidth
11
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 [-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 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
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 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
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 The ButtonBox widget can be used as a container widget to hold the
44 ``action'' buttons in a dialog box.
45
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 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 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 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 pathName invoke buttonName
81 Invoke the button subwidget with the name buttonName.
82 pathName subwidget name ?args?
84 When no additional arguments are given, returns the pathname of
85 the subwidget of the specified name.
86 When no additional arguments are given, the widget command of
88 the specified subwidget will be called with these parameters.
89
91 TixButtonBox widgets have no default bindings. The button subwidgets
92 retain their default Tk bindings.
93
95 Tix(n), Container Widgets
96Tix 4.0 tixButtonBox(n)