label

 

label - Crée et manipule les labels


SYNTAXE

 label pathName ?options?

OPTIONS STANDARD


 -activebackground
 -activeforeground
 -anchor
 -background
 -bitmap
 -borderwidth
 -cursor
 -disabledforeground
 -font
 -foreground
 -highlightbackground
 -highlightcolor
 -highlightthickness
 -image
 -justify
 -padx
 -pady
 -relief
 -takefocus
 -text
 -textvariable
 -underline
 -wraplength

OPTIONS SPECIFIQUES AU WIDGET


Command-Line Name: -height Database Name: height 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’écrans (c.a.d. n'importe quelle des formes acceptable par [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’intérieur.

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 désactivé 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’écrans (c.a.d. n'importe quelle des formes acceptable par [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’intérieur.


DESCRIPTION


La commande label crée une nouvelle fenêtre (indiquée par l'argument pathName ) et 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 [ConfigWidg] 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.


Traduit par Michel Salvagniac 2002-2003

Copyright © 2003 - Le Wiki Tcl/Tk Francophone.


Voir aussi


Catégorie Manuel Tcl/Tk