label(3)
NAME
Tk::Label - Create and manipulate Label widgets
SYNOPSIS
$label = $parent->Label(?options?);
STANDARD OPTIONS
-anchor -font -image -takefocus -back ground -foreground -justify -text -bitmap -high lightbackground -padx -textvariable -border width -highlightcolor -pady -underline -cur sor -highlightthickness -relief -wraplength
See Tk::options for details of the standard options.
WIDGET-SPECIFIC OPTIONS
- Name: height
Class: Height
Switch: -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. - Name: width
Class: Width
Switch: -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 charac ters. 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 method creates a new window (given by the $wid
get argument) and makes it into a label widget. Addi
tional 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 $widget
argument. At the time this command is invoked, there must
not exist a window named $widget, but $widget'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 sin
gle 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 METHODS
The Label method creates a widget object. This object
supports the configure and cget methods described in
Tk::options which can be used to enquire and modify the
options described above. The widget also inherits all the
methods provided by the generic Tk::Widget class.
BINDINGS
When a new label is created, it has no default event bind
ings: labels are not intended to be interactive.
KEYWORDS
- label, widget