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

NAME

6       tixOptionMenu - Create and manipulate tixOptionMenu widgets
7

SYNOPSIS

9       tixOptionMenu pathName ?options?
10

SUPER-CLASS

12       The  TixOptionMenu  class  is derived from the TixLabelWidget class and
13       inherits all the commands, options and subwidgets of its super-class.
14

STANDARD OPTIONS

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

WIDGET-SPECIFIC OPTIONS

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

SUBWIDGETS

46       Name:          menu
47       Class:         Menu
48
49              The menu subwidget, which is popped up when the user  press  the
50              menubutton subwidget.
51
52       Name:          menubutton
53       Class:         Menubutton
54
55              The menubutton subwidget.
56

DESCRIPTION

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

WIDGET COMMANDS

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
75       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
81       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
86       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
99       pathName delete name
100              Deletes the menu entry identified by name.
101
102       pathName disable name
103              Disables the menu entry identified by name.
104
105       pathName enable name
106              Enables the menu entry identified by name.
107
108       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
113       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
127       pathName entries
128              Returns the names of all the entries currently in the OptionMenu
129              widget.
130
131       pathName subwidget name ?args?
132              When no options are given, this command returns the pathname  of
133              the subwidget of the specified name.
134
135              When options are given, the widget command of the specified sub‐
136              widget will be called with these options.
137

KEYWORDS

139       Tix(n)
140
141
142
143
144
145
146Tix                                   4.0                     tixOptionMenu(n)
Impressum