label(3Tk) label(3Tk)
label - Create and manipulate label widgets
label pathName ?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
Name: height
Class: Height
Command-Line 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
Command-Line 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
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.
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. 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 |
Page 1
label(3Tk) label(3Tk)
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.
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.
When a new label is created, it has no default event bindings: labels
are not intended to be interactive.
label, widget
PPPPaaaaggggeeee 2222 [ Back ]
|
