Sujet précédent

Label - Étiquettes

Sujet suivant

Listbox - Listes de sélection

Cette page

LabelFrame - Cadres étiquetés

Le widget «cadre étiqueté», LabelFrame, comme le widget Frame, est avant tout un conteneur. Il se présente comme une zone rectangulaire dans laquelle il est possible de mettre d’autres widgets. Cependant, contrairemet au cadre Frame, il vous permet d’afficher une étiquette sur sa bordure.

Voici un exemple de cadre étiqueté qui contient deux boutons. Remarquez que l’étiquette “Important controls” interrompt la bordure. Cette figure illustre les valeurs par défaut du widget: un relief ‘groove’ (Voir Les styles de relief) et une étiquette ancrée au nord ouest, 'nw', c’est à dire en haut à gauche du cadre.

../_images/labelframe.png

Pour créer un cadre étiqueté dans une fenêtre mère ou un cadre parent:

class LabelFrame(parent, option, ...)

Retourne le cadre étiqueté créé. Ses options sont:

Paramètres:
  • bg – (ou background) La couleur de fond appliquée à l’intérieur du widget; Voir Les couleurs.
  • bd – (ou borderwidth) Largeur de la bordure du cadre. Voir Les dimensions. Sa valeur par défaut est 2 pixels.
  • cursor – Le pointeur de souris utilisé lorsque la souris est à l’intérieur du cadre; voir Le pointeur de la souris.
  • fg – (ou foreground) Couleur utilisée pour l’étiquette.
  • height – La hauteur du cadre. Ne sera pas prise en compte sauf si vous appelez la méthode grid_propagate(0) sur le cadre; voir Autres méthodes du gestionnaire de grille.
  • highlightbackground – Couleur de la mise en valeur du focus lorsque le cadre ne l’a plus. Voir Focus: réception des saisies clavier.
  • highlightcolor – Couleur de la ligne de focus lorsque le cadre obtient le focus.
  • highlightthickness – Épaisseur de la zone de mise en valeur du focus.
  • labelanchor

    Utilisez cette option pour positionner l’étiquette sur le bord du cadre. Sa position par défaut est 'nw' ce qui place l’étiquette en haut à gauche. Pour les douze positions possibles:

    ../_images/labelanchor.png
  • labelwidget – À la place d’un label texte, vous pouvez utiliser n’importe quel widget comme label en le passant à cette option. Si vous précisez à la fois un tel widget et un étiquette texte, cette dernière est ignorée.
  • padx – Normalement, un cadre s’ajuste à son contenu. Pour ajouter N pixels d’espace supplémentaire horizontalement: padx=N.
  • pady – Similaire à padx dans la direction verticale.
  • relief – Le relief par défaut est ‘groove’. Pour d’autres valeurs, voir Les styles de relief.
  • takefocus – Normalement, un cadre n’obtient pas le focus (voir Focus: réception des saisies clavier pour une vue d’ensemble de ce sujet). Cependant, donner la valeur 1 à cette option si vous voulez que le cadre soit sensible aux saisies clavier. Pour réagir aux saisies clavier, vous aurez besoin de créer une liaison pour les événements du clavier; voir Événements: répondre aux actions de l’utilisateur. pour plus d’informations sur les événements et les liaisons.
  • text – Le texte de l’étiquette.
  • width – La largeur du cadre. Voir Les dimensions. Cette valeur est ignorée sauf si vous appelez la méthode grid_propagate(0) sur le cadre; Voir Autres méthodes du gestionnaire de grille.