procedure
:number name
Creates a number widget within the current panel frame for the TCL
interpreter. A number widget is a frame window containing a label window,
entry window and two checkbox windows.
name is used to generate the path name of the windows to be created. It
should have the format of a widget name (e.g. :number NUM) and should
be unique within this interpreter. The name will be lower-cased (using the
string tolower command) in order to generate the path name used to create
the windows.
When a number is entered either by pressing the Return key while the
keyboard focus is on the entry window or by selection of one of the two
checkbox windows using the mouse then the TCL command
click FRAME “ ” NUMBER value
will be executed where FRAME and NUMBER are widget names and value is
the current value of the number widget.
The path names generated have the root framename.panelname.number-
name and the items label, entry, button-up and button-dn.
The :number procedure may also be used directly within a frame window (i.e. before any
panel window has been created).
Normally it is necessary when typing information into the entry window to press the return key
in order to generate an event and cause the procedure linked to the entry to be executed.
Often users fail to do this and so a binding is made to the mouse focus and the contents of the
entry window are checked whenever the mouse focus leaves the entry window. If information
is found to have been typed into the entry window which has not been seen by a return key
event then an action is taken as is the return key had been pressed.
The :number procedure may have a number of arguments however none of
these is mandatory.
arguments
:x number
number is the x-co-ordinate within the current panel of the number
widget in pixels
e.g. :x 400
:y number
number is the y-co-ordinate within the current panel of the number
widget in pixels
e.g. :y 200
The :x and :y parameters may be omitted in which case the packer geometry manager will be
used and the position of the window will be determined by the contents of the master (panel)
window. If however the :x and :y parameters are supplied then the placer geometry manager
will be used to position the window within the master (panel) window.
Warning: Note that it is not possible to mix use of the packer and placer geometry
managers within the same window. Thus all windows within a panel must request or imply that
the same geometry manager is used.
:w number
number is the width of the entry window in characters.
e.g. :w 20
:h number
number is the height of the number widget in characters.
e.g. :h 2
The default value is :h 1.
:value value
value is the initial value of the number.
The default value is 0.
:min value
value is the minimum value of the number.
:max value
value is the maximum value of the number.
:inc value
value is the increment (or decrement) made to the value of the number
by the up (or down) buttons.
:valuex value
value is the position of the left hand edge of the entry window and the
right hand edge of the label window with relation to the left hand edge of the
checkbox widget. It is thus the space available to write the label string which
is right justified within the label window and also allows alignment of the entry
windows of several widgets. The value may be expressed in units of pixels or
characters.
e.g. :valuex 100 (pixels); :valuex 15c (characters)
By default the component windows of the widget are packed within the widget frame..
:label string
string is a text string to be written into the label component of the
number widget.
The default is the name of the number widget.
See also common procedure arguments defined later in this document