procedure :text name Creates a text widget within the current panel frame for the TCL interpreter. A text widget is a frame window containing a label window and an entry window. 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. :text TXT) 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 the return key is pressed while the keyboard focus is on the entry window then ,if available, the TCL script supplied using the :command parameter will be executed. If this is not available the TCL command click FRAME “ ” TEXT text-string will be executed where FRAME and TEXT are widget names and text-string is the information entered in the entry window. The path names generated have the root framename.panelname.textname and the items label and entry. The :text 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 :text procedure may have a number of arguments however none of these is manditory. arguments :x number number is the x-co-ordinate within the current panel of the text widget in pixels e.g. :x 40 :y number number is the y-co-ordinate within the current panel of the text widget in pixels e.g. :y 20 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 text entry window in characters and is also used to calculate the width of the text widget.. e.g. :w 20 :h number number is the height of the text widget in pixels. e.g. :h 20 The :w and/or :h parameters may be omitted in which case the size of the text widget will be determined by its contents. If however the :w and :h parameters are supplied then these will be used to configure the text window. Normally :h will not be supplied. :valuex value value is the position of the left hand edge of the entry window with relation to the left hand edge of the text widget. It is thus the space available to write the label string but also allows alignment of the entry windows of several text widgets. The value may be expressed in units of pixels or characters. e.g. :valuex 100 (pixels); :valuex 15c (characters) :label string string is a text string to be written into the label component of the text widget. The default is the name of the button widget. :value string string is a text string to be written initially into the entry component of the text widget. The default is a null string. :shifters T|F If the option T is supplied then small buttons are placed at each end of the entry widget which can be used to scroll the contents of the entry right or left in the case when the width of the contents of the entry is greater than the physical width of the entry widget. The default is that these buttons are not drawn. :read-only T|F This is an alias for :deaf supplied for compatibility with existing scripts. :size S|N|L Specifies the size of the font to be used for characters in the label and entry windows. Options available are small (S); normal (N) and large (L). The default is that size N (normal) is used. :command string string is any TCL command or commands to be executed when the keyboard return key is pressed. If a command is supplied and executed in this manner then the click procedure is not invoked. See also common procedure arguments defined later in this document.