procedure :message name Creates a message widget within the current panel frame for the TCL interpreter. A message widget is a frame window containing a message window. name is used to generate the path name of the window to be created. It should have the format of a widget name (e.g. :message MSG) 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. A message widget is none interactive and thus no click procedure is invoked. The path names generated have the root framename.panelname.message- name and the item msg. The :message procedure may also be used directly within a frame window (i.e. before any panel window has been created). The message window is placed within its own frame window to create a message widget in order to enable correct implementation of the :valuex argument and also to allow full access to options such as the background colour for the message text. The :message 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 message widget in pixels :y number number is the y-co-ordinate within the current panel of the message widget in pixels 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 message window in characters. The :w parameter may be omitted in which case the size of the message widget will be determined by its contents. :valuex value value is the position of the left hand edge of the message in relation to the left hand edge of the message widget. The value may be expressed in units of pixels or characters. e.g. :valuex 100 (pixels); :valuex 15c (characters) The :valuex parameter may be omitted in which case the size of the message widget will be determined by its contents. :label string string is a text string to be written into the message widget. The default is a null string. :font string string is the specification of the font to be used when writing text into the message widget. By default the font specified for message widgets will be used. If the :font argument is supplied then :bold will be ignored :justify string string is the specification of the justification to be used when writing text into the message widget. If not supplied the default justification for message windows will be used. :colour string string is the colour to be used when writing text into the message widget. By default the colour specified for message widgets will be used. :anchor where where can be any valid window point to be used when placing the message within its window. :anchor is only meaningful when :valuex has also been supplied otherwise it is ignored and the message packed to the left of its window. Valid points are n,s,e,w,nw,ne,se,sw. The default anchor point is ne - i.e. the message is placed justified to the right of its window. See also common procedure arguments defined later in this document.