label(n) Tk (4.0) 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
Command-Line Name:-height
Database Name: height
Database Class: 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
desired height is computed from the size of the image
or bitmap or text being displayed in it.
Command-Line Name:-width
Database Name: width
Database Class: 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 configure aspects
of the label such as its colors, font, text, and initial
relief. The label command returns its pathName argument.
Page 1 (printed 2/26/99)
label(n) Tk (4.0) label(n)
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 occupy multiple lines on the screen (if it
contains newlines or if wrapping 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 available 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
Page 2 (printed 2/26/99)