man s label

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

______________________________________________________________________________

NAME
       label - Create and manipulate label widgets

SYNOPSIS
       label pathName ?options?

STANDARD OPTIONS
       -anchor         -font          -image          -takefocus
       -background     -foreground    -justify        -text
       -bitmap         -highlightbackground           -padx-textvariable
       -borderwidth    -highlightcolor                -pady-underline
       -cursor         -highlightthickness            -relief-wraplength

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

WIDGET-SPECIFIC OPTIONS
       [-height height] 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 Tk_GetPixels); for text it
       is in lines of text.  If this option isn't specified, the  label's  de-
       sired  height  is computed from the size of the image or bitmap or text
       being displayed in it.  [-width width] 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
       Tk_GetPixels);  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.
_________________________________________________________________

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, bitmap or image.
       If text is displayed, it must all be in a single font, but it  can  oc-
       cupy  multiple lines on the screen (if it contains newlines or if wrap-
       ping occurs because of the wrapLength option) and one of the characters
       may optionally be underlined using the underline option.  The label can
       be manipulated in a few simple ways, such as  changing  its  relief  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 (see Tk_ConfigureInfo for  information
              on  the  format  of  this list).  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

Tk                                    4.0                             label(n)