  NOM
    label - Crée et manipule les labels
  SYNTAXE
    label pathName ?options?
  OPTIONS STANDARD
    -activebackground, activeBackground, Foreground
    -activeforeground, activeForeground, Background
    -anchor, anchor, Anchor
    -background ou -bg, background, Background
    -bitmap, bitmap, Bitmap
    -borderwidth ou -bd, borderWidth, BorderWidth
    -cursor, cursor, Cursor
    -disabledforeground, disabledForeground, DisabledForeground
    -font, font, Font
    -foreground ou -fg, foreground, Foreground
    -highlightbackground, highlightBackground, HighlightBackground
    -highlightcolor, highlightColor, HighlightColor
    -highlightthickness, highlightThickness, HighlightThickness
    -image, image, Image
    -justify, justify, Justify
    -padx, padX, Pad
    -pady, padY, Pad
    -relief, relief, Relief
    -takefocus, takeFocus, TakeFocus
    -text, text, Text
    -textvariable, textVariable, Variable
    -underline, underline, Underline
    -wraplength, wrapLength, WrapLength
  OPTIONS SPECIFIQUES AU WIDGET
    -height, height, Height
    -state, state, State
    -width, width, Width
  DESCRIPTION
  COMMANDES DE WIDGET
    pathName cget option
    pathName configure ?option? ?valeur option valeur ...?
  BINDINGS
  MOTS-CLES

### NOM

label - Crée et manipule les labels

### SYNTAXE

label pathName ?options?

### OPTIONS STANDARD

-activebackground, activeBackground, Foreground
-activeforeground, activeForeground, Background
-anchor, anchor, Anchor
-background ou -bg, background, Background
-bitmap, bitmap, Bitmap
-borderwidth ou -bd, borderWidth, BorderWidth
-cursor, cursor, Cursor
-disabledforeground, disabledForeground, DisabledForeground
-font, font, Font
-foreground ou -fg, foreground, Foreground
-highlightbackground, highlightBackground, HighlightBackground
-highlightcolor, highlightColor, HighlightColor
-highlightthickness, highlightThickness, HighlightThickness
-image, image, Image
-justify, justify, Justify
-padx, padX, Pad
-pady, padY, Pad
-relief, relief, Relief
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-underline, underline, Underline
-wraplength, wrapLength, WrapLength

### OPTIONS SPECIFIQUES AU WIDGET

Command-Line Name: -hauteur
Database Name: hauteur
Database Class: Height
  Spécifie la hauteur désirée du label. Si une image ou un bitmap est affiché dans le label alors la valeur est en unités d'ecrans (c.a.d. n'importe quelle des formes acceptable par Tk_GetPixels); pour le texte c'est en lignes de texte. Si cette option n'est pas spécifiée, la hauteur désirée du label est calculée à partir de la taille de l'image ou du bitmap ou du texte affiché à l'interieur.

Command-Line Name: -state
Database Name: state
Database Class: State
  Spécifie un des trois états du label: normal, active, ou disabled. Dans l'état normal le label est affiché en utilisant les options foreground et background. Dans l'état actif le label est affiché en utilisant les options activeForeground et activeBackground. Dans l'état desactivé les options disabledForeground et background déterminent comment le label est affiché.

Command-Line Name: -width
Database Name: width
Database Class: Width
  Spécifie la largeur désirée du label. Si une image ou un bitmap est affiché dans le label alors la valeur est en unités d'ecrans (c.a.d. n'importe quelle des formes acceptable to Tk_GetPixels); pour le texte il est en caractères. Si cette option n'est pas spécifiée, la largeur désirée du label est calculée à partir de la taille de l'image ou du bitmap ou du texte affiché à l'interieur.

### DESCRIPTION

La commande label crée une nouvelle fenêtre (indiquée par l'argument pathName ) en en fait un widget label. Des options supplémentaires, décrites ci-dessus, peuvent être spécifiées sur la ligne de commande ou dans la base de données d'options pour configurer des aspects du label comme ses couleurs, police, texte, et relief initial. La commande label retourne son argument pathName. A l'instant ou cette commande est appelée, il ne doit pas exister un nom de fenêtre pathName, mais le parent de pathName doit exister.

Un label est un widget qui affiche une chaîne de texte, un bitmap ou une image. Si du texte est affiché, il doit être d'une seule police, mais il peut occuper plusieurs lignes sur l'écran (si il contient des saut de lignes ou si le retour à la ligne se produit à cause de l'option wrapLength) et un des caractères peut éventuellement être souligné en utilisant l'option underline. La label peut être manipulé simplement, son relief ou son texte peuvent être modifiés, en utilisant les commandes décrites ci-dessous.

### COMMANDES DE WIDGET

La commande label crée une nouvelle commande Tcl dont le nom est pathName. Cette commande peut être utilisée pour appeler diverses opérations sur le widget. Elle a la forme générale suivante:

    pathName option ?arg arg ...?

Option et args déterminent le comportement exact de la commande. Les commandes suivantes sont possible pour les label:

pathName cget option
  Retourne la valeur courante de l'option de configuration indiquée par option. Option peut prendre n'importe quelle des valeurs acceptées par la commande label.

pathName configure ?option? ?valeur option valeur ...?
  Interroge ou modifie les options de configuration du widget. Si aucune option n'est spécifiée, retourne une liste décrivant toutes les options disponibles pour pathName (voir Tk_ConfigureInfo pour des informations sur le format de cette liste). Si option est spécifiée sans valeur, alors la commande retourne une liste décrivant l'option désignée (cette liste sera identique à la sous-liste correspondante de la valeur retournée si aucune option n'est spécifiée). Si un ou plusieurs paires option-valeur sont spécifiées, alors la commande modifie l'option(s) indiquée avec la valeur(s) donnée; dans ce cas la commande retourne une chaîne vide. Option peut prendre n'importe quelle des valeurs acceptées par la commande label.

### BINDINGS

Quand un nouveau label est créé, il n'a pas de bindings d'évènement par défaut: les labels ne sont pas conçus pour être interactifs.

### MOTS-CLES

label, widget

    Copyright © 1990-1994 The Regents of the University of California.
    Copyright © 1994-1996 Sun Microsystems, Inc.
    Copyright © 1995-1997 Roger E. Critchlow Jr.

Copyright © 2003 - Le Portail Tcl/Tk Francophone.