Sujet précédent

Les attributs standards

Sujet suivant

Canvas - Canevas

Cette page

Button - Boutons

Pour créer un simple bouton dans une fenêtre ou un cadre nommé parent:

class Button(parent, option=valeur, ...)

Le constructeur retourne le nouveau widget bouton. Ses options sont :

Paramètres:
  • activebackground – Couleur de fond lorsque la souris survole le bouton.
  • activeforeground – Couleur du texte lorsque la souris survole le bouton.
  • anchor – Précise la position du texte sur le bouton. Voir Le système d’ancrage. Par exemple, anchor="ne" positionne le texte dans le bord supérieur droit (nord est) du bouton.
  • borderwidth – (ou bd) largeur de la bordure du bouton ; Voir Les dimensions. Par défaut, sa valeur est 2 pixels.
  • background – (ou bg) Couleur de fond.
  • bitmap – Nom de l’un des bitmaps standards à afficher sur le bouton à la place du du texte.
  • command – Fonction ou méthode a appeler lorsqu’on clique sur le bouton.
  • cursor – Pour indiquer le pointeur de la souris à afficher lorsqu’on survole le bouton.
  • default'normal' est la valeur par défaut; utiliser 'disabled' si le bouton doit être désactivé (grisé et ne répondant pas au clic de la souris).
  • disabledforeground – Couleur du texte lorsque le bouton est désactivé.
  • foreground – (ou fg), Couleur du texte.
  • font – Police de caractère a utiliser pour le texte sur le bouton.
  • height – Hauteur du bouton en nombre de ligne (si le bouton possède une étiquette textuelle) ou en pixel (pour les images).
  • highlightbackground – Couleur de la ligne qui indique que le bouton n’a pas le focus.
  • highlightcolor – Couleur de ligne qui indique que le bouton a le focus.
  • highlightthickness – Épaisseur de la ligne de focus.
  • image – Image a afficher sur le bouton (à la place du texte).
  • justify'left', 'center' ou 'right' pour indiquer la position du texte.
  • overrelief – Le style de relief à utiliser lorsque la souris est sur le bouton; la valeur par défaut est 'raised'. Voir Les styles de relief.
  • padx – Marge additionnelle à gauche et à droite du texte. Voir Les dimensions pour les valeurs possibles.
  • pady – Marge additionnelle en haut et bas du texte.
  • relief – Précise le type de relief appliqué au bouton. (Voir Les styles de relief).
  • repeatdelay – Voir l’argument suivant.
  • repeatinterval – Normalement, un bouton est déclenché une seule fois lorsque l’utilisateur relâche le bouton de la souris. si vous souhaitez que le bouton soit déclenché à des intervalles réguliers lorsque l’utilisateur maintient le bouton de la souris enfoncé, positionner cette option a un certain nombre de millisecondes à attendre entre chaque répétition et donner une valeur à l’option repeatdelay (ms) pour indiquer un délai après lequel le bouton est déclenché. Par exemple, si repeatdelay=500 et repeatinterval=100, le bouton sera déclenché après une demi-seconde puis redéclenché tous les dixièmes de secondes juqu’à ce que l’utilisateur relâche le bouton de la souris. Si l’utilisateur relache le bouton avant la durée repeatdelay, le bouton se déclenche normalement.
  • state – Positionner cette option à 'disabled' pour griser le bouton et le rendre inactif. Sa valeur est ‘active’ lorsque la souris est sur le bouton et 'normal' autrement.
  • takefocus – Normalement, en utilisant la touche Tab, on peut donner le focus aux bouton (voir Focus: réception des saisies clavier), et l’appui sur la barre espace a le même effet qu’un clic sur le bouton. Vous pouvez mettre takefocus a zéro pour empêcher cela.
  • text – Le texte a afficher sur le bouton.
  • textvariable – Une instance d’un StringVar() qui sera associée au texte du bouton. Si la variable est modifiée, un nouveau texte est affiché sur le bouton. Voir Variables de contrôle: Les valeurs sous les widgets.
  • underline – Par défaut, vaut -1, indiquant qu’aucun caractère du texte du bouton n’est souligné. Si sa valeur est positive ou nulle, le caractère correspondant du texte est souligné. Par exemple, underline=1 indique que le deuxième caractère du texte sera souligné.
  • width – Largeur du bouton en nombre de lettres (si du texte est affiché) ou en pixels (pour une image).
  • wraplength – Si on indique une valeur positive, le texte est affiché avec autant de lignes qu’il faut pour tenir dans la largeur fixé par wraplength. Pour les différentes valeurs possibles, Voir Les dimensions.
flash()

Provoque quelques clignotement du bouton. Après cela, il revient dans son état initial.

invoke()

Appelle la fonction de rappel (callback) associée à l’option command et retourne ce que cette fonction retourne. N’a pas d’effet si le bouton est désactivé ou si aucune fonction de rappel ne lui est associé.