1mNAME0m
       label - Create and manipulate label widgets

1mSYNOPSIS0m
       1mlabel 4m22mpathName24m ?4moptions24m?

1mSTANDARD OPTIONS0m
       1m-activebackground         -activeforeground         -anchor0m
       1m-background               -bitmap                   -borderwidth0m
       1m-cursor                   -disabledforeground       -font0m
       1m-foreground               -highlightbackground      -highlightcolor0m
       1m-highlightthickness       -image                    -justify0m
       1m-padx                     -pady                     -relief0m
       1m-takefocus                -text                     -textvariable0m
       1m-underline                -wraplength0m

       See the 1moptions 22mmanual entry for details on the standard options.

1mWIDGET-SPECIFIC OPTIONS0m
       Command-Line Name:1m-height0m
       Database Name:  1mheight0m
       Database Class: 1mHeight0m

              Specifies a desired height for the label.  If an image or bitmap
              is being displayed in the label then  the  value  is  in  screen
              units  (i.e.  any  of the forms acceptable to 1mTk_GetPixels22m); for
              text it is in lines of text.  If this  option  isn't  specified,
              the  label's  desired  height  is  computed from the size of the
              image or bitmap or text being displayed in it.

       Command-Line Name:1m-state0m
       Database Name:  1mstate0m
       Database Class: 1mState0m

              Specifies one of three states for the label:  1mnormal22m, 1mactive22m, or
              1mdisabled22m.   In  normal  state  the button is displayed using the
              1mforeground 22mand 1mbackground 22moptions.  In active state the label is
              displayed   using   the  1mactiveForeground  22mand  1mactiveBackground0m
              options.  In the disabled state the 1mdisabledForeground 22mand 1mback-0m
              1mground 22moptions determine how the button is displayed.

       Command-Line Name:1m-width0m
       Database Name:  1mwidth0m
       Database Class: 1mWidth0m

              Specifies  a desired width for the label.  If an image or bitmap
              is being displayed in the label then  the  value  is  in  screen
              units  (i.e.  any  of the forms acceptable to 1mTk_GetPixels22m); for
              text it is in characters.  If this option isn't  specified,  the
              label's  desired width is computed from the size of the image or
              bitmap or text being displayed in it.


1mDESCRIPTION0m
       The 1mlabel 22mcommand creates a new window (given by the 4mpathName24m 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 1mlabel 22mcommand returns its 4mpathName24m argument.  At the  time
       this  command is invoked, there must not exist a window named 4mpathName24m,
       but 4mpathName24m's parent must exist.

       A label is a widget that displays a textual string,  bitmap  or  image.
       If  text  is  displayed,  it  must  all be in a single font, but it can
       occupy multiple lines on the screen (if  it  contains  newlines  or  if
       wrapping  occurs because of the 1mwrapLength 22moption) and one of the char-
       acters may optionally be underlined using the  1munderline  22moption.   The
       label  can  be  manipulated  in a few simple ways, such as changing its
       relief or text, using the commands described below.


1mWIDGET COMMAND0m
       The 1mlabel 22mcommand creates a new Tcl command  whose  name  is  4mpathName24m.
       This  command  may  be used to invoke various operations on the widget.
       It has the following general form:
              4mpathName24m 4moption24m ?4marg24m 4marg24m 4m...24m?
       4mOption24m and the 4marg24ms determine the exact behavior of the  command.   The
       following commands are possible for label widgets:

       4mpathName24m 1mcget 4m22moption0m
              Returns  the  current value of the configuration option given by
              4moption24m.  4mOption24m may have any of the values accepted by the 1mlabel0m
              command.

       4mpathName24m 1mconfigure 22m?4moption24m? ?4mvalue24m 4moption24m 4mvalue24m 4m...24m?
              Query  or modify the configuration options of the widget.  If no
              4moption24m is specified, returns a list describing all of the avail-
              able  options for 4mpathName24m (see 1mTk_ConfigureInfo 22mfor information
              on the format of this list).  If 4moption24m  is  specified  with  no
              4mvalue24m,  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 4moption24m is specified).  If one or
              more 4moption-value24m 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.  4mOption24m may  have  any
              of the values accepted by the 1mlabel 22mcommand.


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


1mKEYWORDS0m
