1tixOptionMenu(n) Tix Built-In Commands tixOptionMenu(n)
2
6 tixOptionMenu - Create and manipulate tixOptionMenu widgets
7
9 tixOptionMenu pathName ?options?
10
12 The TixOptionMenu class is derived from the TixLabelWidget class and
13 inherits all the commands, options and subwidgets of its super-class.
14
16 The OptionMenu widget supports all the standard Tix widget options. See
17 the Tix-Options(n) manual entry for details on the standard Tix widget
18 options.
19
21 [-command command] Specifies the command to be called when the -value
22 option of the OptionMenu is changed. The command will be called with
23 one arguments -- the new value of the OptionMenu widget. [-disable‐
24 callback disableCallback] A boolean value indicating whether callbacks
25 should be disabled. When set to true, the TCL command specified by the
26 -command option is not executed when the -value of the OptionMenu wid‐
27 get changes. [-dynamicgeometry dynamicGeometry] A boolean value indi‐
28 cating whether the size of the menubutton subwidget should change
29 dynamically to match the width of the currently selected menu entry. If
30 set to false (the default), the the size of the menubutton subwidget
31 will be wide enough to display every menu entry fully and does not
32 change when the user selects different entries. [-label label] Speci‐
33 fies the string to display as the label of this OptionMenu widget.
34 [-labelside labelSide] Specifies where the label should be displayed
35 relative to the entry subwidget. Valid options are: top, left, right,
36 bottom, none or acrosstop. [-state state] Specifies the whether the
37 OptionMenu widget is normal or disabled. Only the values "normal" and
38 "disabled" are recognized. [-value value] Specifies the value of the
39 OptionMenu. The value of the OptionMenu widget is the name of the item
40 currently displayed by its menubutton subwidget. [-variable variable]
41 Specifies the global variable in which the value of the OptionMenu
42 should be stored. The value of the OptionMenu will be automatically
43 updated when this variable is changed.
44
46 Name: menu
47 Class: Menu
48 The menu subwidget, which is popped up when the user press the
50 menubutton subwidget.
51 Name: menubutton
53 Class: Menubutton
54 The menubutton subwidget.
56
58 The tixOptionMenu command creates a new window (given by the pathName
59 argument) and makes it into a OptionMenu widget. Additional options,
60 described above, may be specified on the command line or in the option
61 database to configure aspects of the OptionMenu such as its cursor and
62 relief.
63
65 The tixOptionMenu command creates a new Tcl command whose name is the
66 same as the path name of the OptionMenu's window. This command may be
67 used to invoke various operations on the widget. It has the following
68 general form:
69 pathName option ?arg arg ...?
70 PathName is the name of the command, which is the same as the Option‐
71 Menu widget's path name. Option and the args determine the exact behav‐
72 ior of the command. The following commands are possible for OptionMenu
73 widgets:
74 pathName add type name ?option value ...?
76 Adds a new item into the OptionMenu widget. type must be either
77 command or separator. The options may be any of the valid
78 options for the command or separator menu entry types for the TK
79 menu widget class, except -command.
80 pathName cget option
82 Returns the current value of the configuration option given by
83 option. Option may have any of the values accepted by the tixOp‐
84 tionMenu command.
85 pathName configure ?option? ?value option value ...?
87 Query or modify the configuration options of the widget. If no
88 option is specified, returns a list describing all of the avail‐
89 able options for pathName (see Tk_ConfigureInfo for information
90 on the format of this list). If option is specified with no
91 value, then the command returns a list describing the one named
92 option (this list will be identical to the corresponding sublist
93 of the value returned if no option is specified). If one or
94 more option-value pairs are specified, then the command modifies
95 the given widget option(s) to have the given value(s); in this
96 case the command returns an empty string. Option may have any of
97 the values accepted by the tixOptionMenu command.
98 pathName delete name
100 Deletes the menu entry identified by name.
101 pathName disable name
103 Disables the menu entry identified by name.
104 pathName enable name
106 Enables the menu entry identified by name.
107 pathName entrycget name option
109 Returns the current value of the configuration option given by
110 option in the menu entry identified by name. Option may have any
111 of the values accepted by the add widget command.
112 pathName entryconfigure name ?option? ?value option value ...?
114 Query or modify the configuration options of the menu entry
115 identified by name. If no option is specified, returns a list
116 describing all of the available options for the menu entry (see
117 Tk_ConfigureInfo for information on the format of this list).
118 If option is specified with no value, then the command returns a
119 list describing the one named option (this list will be identi‐
120 cal to the corresponding sublist of the value returned if no
121 option is specified). If one or more option-value pairs are
122 specified, then the command modifies the given option(s) to have
123 the given value(s); in this case the command returns an empty
124 string. Option may have any of the values accepted by the add
125 widget command.
126 pathName entries
128 Returns the names of all the entries currently in the OptionMenu
129 widget.
130 pathName subwidget name ?args?
132 When no options are given, this command returns the pathname of
133 the subwidget of the specified name.
134 When options are given, the widget command of the specified sub‐
136 widget will be called with these options.
137
139 Tix(n)
140Tix 4.0 tixOptionMenu(n)