Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for label (redhat section n)

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

_________________________________________________________________________________________________

NAME
       label - Create and manipulate label widgets

SYNOPSIS
       label pathName ?options?

STANDARD OPTIONS
       -activebackground	 -activeforeground	   -anchor
       -background		 -bitmap		   -borderwidth
       -cursor			 -disabledforeground	   -font
       -foreground		 -highlightbackground	   -highlightcolor
       -highlightthickness	 -image 		   -justify
       -padx			 -pady			   -relief
       -takefocus		 -text			   -textvariable
       -underline		 -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 desired height is computed from the size of the image or bitmap or text being dis-
       played  in  it.	 [-state state]  Specifies  one  of  three states for the label:  normal,
       active, or disabled.  In normal state the button is displayed  using  the  foreground  and
       background options.  In active state the label is displayed using the activeForeground and
       activeBackground options.  In the disabled state  the  disabledForeground  and  background
       options	determine  how the button is displayed.  [-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 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 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 par-
       ent must exist.

       A label is a widget that displays a textual string, bitmap or  image.   If  text  is  dis-
       played,	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  com-
       mands 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  speci-
	      fied,  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  speci-
	      fied 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)


All times are GMT -4. The time now is 06:51 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password