Sujet précédent

Frame - Cadres

Sujet suivant

LabelFrame - Cadres étiquetés

Label - Étiquettes

Les widget Label (étiquette) servent à afficher une ou plusieurs lignes de texte avec le même style, un bitmap ou une image. Pour créer une étiquette dans une fenêtre principale ou dans un cadre parent:

class Label(parent, option, ...)

Le constructeur retourne l’étiquette crée. Ses options sont:

Paramètres:
  • activebackground – Couleur de fond lorsque la souris survole l’étiquette.
  • activeforeground – Couleur du texte lorsque la souris survole l’étiquette.
  • anchor – Cette option précise la postion du texte si le widget dispose de plus de place que de besoin pour le texte. La valeur par défaut est 'center', ce qui a pour effet de centrer le texte par rapport à l’espace disponible. Pour d’autres valeur, Voir Le système d’ancrage. Par exemple, si vous utilisez anchor='nw', le texte sera positionné dans le coin supérieur gauche de l’espace disponible.
  • background – (ou bg) La couleur de fond de l’étiquette. Voir Les couleurs.
  • borderwidth – (ou bd) Épaisseur de la bordure autour de l’étiquette; voir Les dimensions. La valeur par défaut est 2 pixels.
  • disabledforeground – La couleur d’avant plan à afficher lorsque l’étiquette est 'disabled'.
  • foreground – (ou fg) Couleur d’avant plan de l’étiquette. Elle sera utilisée pour le texte ou pour les bits à 1 du bitmap. Voir Les couleurs.
  • height – Hauteur de l’étiquette en nombre de lignes (non en pixels). Si cette option n’est pas précisée, l’étiquette s’ajuste à son contenu.
  • justify – Précise l’alignement du texte: ‘left’ pour un alignement à gauche, ‘center’ pour centrer et ‘right’ pour un alignement à droite.
  • padx – Espace horizontal supplémentaire à insérer à gauche et à droite dans l’étiquette. Sa valeur par défaut est 1.
  • pady – Similaire à padx mais pour la direction verticale.
  • relief – Précise l’apparence de la bordure décorative autour de l’étiquette. Par défaut, vaut 'flat'; pour d’autres valeurs, voir Les styles de relief.
  • state – Par défaut, une étiquette est dans l’état ‘normal’. Les autres états possibles sont ‘disabled’ et ‘active’ (les couleurs d’arrière plan et d’avant plan pour ces états sont alors utilisées).
  • text – Pour afficher une ou plusieurs ligne de texte dans une étiquette, indiquer une chaîne de caractères qui contient le texte. Le caractère spécial '\n' forcera la retour à la ligne.
  • textvariable – Pour pouvoir faire varier le texte affiché en même temps que la valeur d’une variable de contrôle de type StringVar, régler cette option avec cette variable. Voir Les variables de contrôle: Les valeurs sous les widgets.
  • width – Largeur de l’étiquette exprimée en nombre de caractères (non en pixels). Si cette option n’est pas précisée, l’étiquette s’ajuste à son contenu.

Il n’y a pas de méthodes spécifiques aux étiquettes. Voir Méthodes communes à tous les widgets.