label(n)		     Ck Built-In Commands		      label(n)



______________________________________________________________________________

NAME
       label - Create and manipulate label widgets

SYNOPSIS
       label pathName ?options?

STANDARD OPTIONS
       anchor	      foreground     textVariable   underlineForeground
       attributes     takeFocus	     underline
       background     text	     underlineAttributes

       See the ``options'' manual entry for details on the standard options.

WIDGET-SPECIFIC OPTIONS
       Name:	       height
       Class:	       Height
       Command-Line Switch:-height

	      Specifies	 a  desired  height for the label in screen lines.  If
	      this option isn't specified, the label's	desired	 height	 is  1
	      line.

       Name:	       width
       Class:	       Width
       Command-Line Switch:-width

	      Specifies	 a  desired width for the label in screen columns.  If
	      this option isn't specified, the label's desired width  is  com-
	      puted from the size of the text being displayed in it.
_________________________________________________________________


DESCRIPTION
       The label command creates a new window (given by the pathName argument)
       and makes it into a label widget.  Additional options, described above,
       may  be specified on the command line or in the option database to con-
       figure aspects of the label such as its colors, font, text, and initial
       relief.	 The label command returns its pathName argument.  At the time
       this command is invoked, there must not exist a window named  pathName,
       but pathName's parent must exist.

       A  label	 is a widget that displays a textual string.  The label can be
       manipulated in a few simple ways, such as changing  its	attributes  or
       text, using the commands described below.


WIDGET COMMAND
       The  label  command  creates  a new Tcl command whose name is pathName.
       This command may be used to invoke various operations  on  the  widget.
       It  has	the  following	general	 form:	pathName  option ?arg arg ...?
       Option and the args determine the exact behavior of the	command.   The
       following commands are possible for label widgets:

       pathName cget option
	      Returns  the  current value of the configuration option given by
	      option.  Option may have any of the values accepted by the label
	      command.

       pathName configure ?option? ?value option value ...?
	      Query  or modify the configuration options of the widget.	 If no
	      option is specified, returns a list describing all of the avail-
	      able options for pathName. If option is specified with no value,
	      then the command returns a list describing the one named	option
	      (this list will be identical to the corresponding sublist of the
	      value returned if no option  is  specified).   If	 one  or  more
	      option-value  pairs are specified, then the command modifies the
	      given widget option(s) to have the given value(s);  in this case
	      the command returns an empty string.  Option may have any of the
	      values accepted by the label command.


BINDINGS
       When a new label is created, it has no default event  bindings:	labels
       are not intended to be interactive.


KEYWORDS
       label, widget



Ck				      8.0			      label(n)
