Événements: répondre aux actions de l’utilisateur.¶

Niveaux de liaisons¶

Vous pouvez lier un gestionnaire à un événement à l’un de ces niveaux:

1. Liaison au niveau d’un widget: Vous pouvez lier un événement à un widget particulier. Par exemple, vous pourriez lier la touche PageUp dans un canevas à un gestionnaire qui s’occuperait de le faire défiler d’une page vers le haut. Pour lier un événement à un widget, appelez la méthode bind() sur ce widget (voir Méthodes communes à tous les widgets).

   Par exemple, supposez que vous ayez un canevas référencé par can et que vous souhaitiez dessiner un disque orange sur ce canevas à chaque fois que l’utilisateur appuie sur le bouton 2 de la souris (celui du milieu). Pour définir ce comportement:

   can.bind('<Button-2>', dessineDisqueOrange)
   

   Le premier argument, '<Button-2>', est un «descripteur de séquence» qui indique à tkinter que lorsque le bouton central de la souris est pressé, il faut qu’il appelle le gestionnaire d’événement dessineDisqueOrange fourni comme deuxième argument (Voir Écrire son gestionnaire: la classe Event, ci-dessous, pour une vue d’ensemble sur la manière d’écrire un gestionnaire comme dessineDisqueOrange). Notez qu’il faut omettre les parenthèses du gestionnaire d’événement afin que Python utilise la référence au gestionnaire plutôt que d’essayer de l’appeler sur le champ.

2. Liaison au niveau de l’application: Vous pouvez définir une liaison d’événement de telle sorte que le gestionnaire d’événement soit appelé indépendament du widget qui a le focus ou qui se trouve sous la souris. Par exemple, vous pourriez souhaiter lier l’événement « appui sur la touche ImprÉcran » à tous les widgets de l’applicatoin de telle sorte que l’écran soit imprimé indépendamment du widget qui a effectivement reçu l’appui sur la touche. Pour lier un événement au niveau de l’application, appeler la méthode bind_all() sur n’importe quel widget (voir Méthodes communes à tous les widgets).

   Voici comment vous pourriez lier l’appui sur la touche, Key, ImprÉcran, Print, à l’effet désiré:

   w.bind_all('<Key-Print>', imprimeEcran)
   

Séquence d’événements¶

Tkinter dispose d’une méthode générale et puissante pour vous permettre d’indiquer précisément à quels événements vos gestionnaires sont liés.

En général, une séquence d’événements est une chaîne de caractères qui contient un ou plusieurs motifs d’événements. Chaque motif d’événements décrit quelquechose qui peut survenir pendant l’éxécution de votre application. S’il y a plus d’un motif dans une séquence d’événements, le gestionnaire associé sera appelé seulement si tous les motifs de la séquences se produisent en effet.

La forme générale d’un motif d’événement est la suivante:

<[modificateur-]...type[-detail]>

• Le motif est enfermé entre des chevrons <…>.
• Le type de l’événement décrit le genre général de celui-ci, comme un appui sur une touche, KeyPress, ou un clic souris, Button. Voir Types d’événements.
• Vous pouvez indiquer un ou plusieurs modificateurs avant son type pour décrire une combinaison comme un appui sur la touche Maj ou Control pendant qu’une autre touche ou qu’un bouton de la souris est enfoncé. Voir Modificateurs d’événement.
• Vous pouvez ajouter d’autres détails après le type pour décrire la touche ou le bouton précis qui vous intéresse. Pour les boutons de la souris, 1 indique normalement le bouton de gauche, 2 celui du milieu et 3 celui de droite.
  • Notez qu’il est possible que les boutons de la souris soit inversés si un gaucher a effectué le réglage correspondant de son système.
  • Pour les touches du clavier, il s’agit soit d’un caractère (pour un caractère unique comme pour la touche A ou *) ou le nom d’une touche; voir Noms des touches pour une liste de ces noms.

Voici quelques exemples de motifs d’événements:

• <Button-1>: L’utilisateur a appuyé sur le premier bouton de la souris (celui de gauche normalement).
• <KeyRelease-H>: L’utilisateur a relâché la touche H.
• <Control-Shift-KeyPress-H>: L’utilisateur a appuyé simultanément sur les touches Control, Maj et H.

Vous pouvez aussi utiliser des formes courtes pour préciser un événenemt. Voici quelques exemples:

'<1>' revient au même que '<Button-1>'.

'x' revient au même que '<KeyPress-x>'.

Remarquez que vous pouvez omettre les chevrons '<…>' pour la plupart des caractères, mais que vous ne pouvez pas le faire pour l’espace (dont le nom est '<space>') ou pour le caractère inférieur à < (dont le nom est '<less>').

Types d’événements¶

L’ensemble complet de tous les types d’événements est très grand, mais beaucoup ne sont pas utilisés fréquemment. Voici la plupart de ceux dont vous aurez besoin:

Modificateurs d’événement¶

Les noms des modificateurs que vous pouvez utiliser dans une séquence d’événements sont, entre autres:

• Alt : Vrai si l’utilisateur est en train de maintenir enfoncée la touche Alt.
• Any : Ce modificateur généralise un type d’événement. Par exemple, le motif d’événement '<Any-KeyPress>' correspond à l’appui sur une touche arbitraire.
• Control : Vrai si l’utilisateur est en train de maintenir enfoncée la touche Ctrl.
• Double : Indique qu’un événement s’est produit 2 fois dans un cours laps de temps. Par exemple, <Double-Button-1> indique un double clic sur le bouton gauche (normalement) de la souris.
• Lock : Vrai si l’utilisateur a verrouiller le mode Majuscule.
• Shift : Vrai si l’utilisateur est en train de maintenir enfoncée la touche Maj.

Noms des touches¶

La partie detail d’un motif pour un événement KeyPress ou KeyRelease précise la touche que vous souhaitez surveiller. (Voir le modificateur Any ci-dessus si vous souhaitez surveiller toutes les touches).

Le tableau ci-dessous montre plusieurs façons de nommer les touches. Voir Écrire son gestionnaire: la classe Event, ci-dessous, pour plus d’informations sur les objets Event, dont les attributs décrivent les touches de la même manière)

• La colonne keysym montre le «symbole de touche», une chaîne de caractères pour la touche. Cela correpond à l’attribut keysym des objets Event.
• La colonne keycode correpond au «code de touche». C’est un identifiant de touche (chaque touche possède un unique keycode) qui permet de savoir quelle touche a été enfoncée. Notez cependant qu’il ne permet pas de savoir si une touche modificatrice (Maj, Ctrl et VerrMaj) a été ou est enfoncée; ainsi, par exemple, a et A ont le même code de touche.
• La colonne keysym_num montre un code numérique équivalent au symbole de la touche. Il a la particularité d’être différent selon qu’une touche modificatrice a été ou est enfoncée. Par exemple, le chiffre 2 du clavier numérique (dont le symbole de touche est KP_2) et la flèche «sud» du clavier numérique (de symbole KP_Down) ont le même code de touche (88), mais leurs codes numériques keysym_num sont différents (65433 et 65458, respectivement).
• La colonne Touche montre le texte que vous trouverez habituellement sur la touche de votre clavier, comme Tab par exemple.

Il y a beaucoup de noms de touches pour couvrir de nombreux ensembles de caractères internationaux. Ce tableau montre uniquement l’ensemble «Latin-1» pour un clavier type. Pour connaître l’ensemble des possibilités, reportez-vous à la page correspondante du manuel de Tk.

Écrire son gestionnaire: la classe Event¶

Les sections précédentes vous ont expliquées comment décrire l’événement auquel vous souhaitez réagir et comment le lier à l’application. À présent, intéressons-nous à l’écriture du gestionnaire d’événements qui sera appelé lorsque l’événement aura lieu.

Le gestionnaire d’événements recevra un objet de type Event qui sert à décrire les circonstances de l’événement. Le gestionnaire peut être une fonction ou une méthode. Voici la forme de la déclaration d’une fonction:

def nomGestionnaire(evt):

Et pour une méthode:

class MaClasse:

        # ...

        def nomGestionnaire(self, evt):

Les attributs de l’objet de type Event passé au gestionnaire, par l’intermédiaire de son paramètre evt (parfois noté plus explicitement event), sont décrits ci-dessous. Certains attributs possèdent toujours une valeur, mais d’autres n’en possède une que pour certains types d’événements.

Utilisez ces masques pour tester les bits de la valeur de l’attribut state pour savoir quel(s) touche(s) modificatrice(s) et/ou bouton(s) ont été utilisé(s) pendant l’événement.

Voici un exemple de gestionnaire d’événements. Plus haut, dans Niveaux de liaisons, vous trouverez un exemple qui vous montre commment lier l’appui sur le bouton central de la souris à un gestionnaire nommé dessineDisqueOrange. Voici ce gestionnaire:

def dessineDisqueOrange(evt):
    '''Dessine un disque orange là où se trouve la souris
    '''
    r = 5   # Son rayon
    can.create_oval(evt.x-r, evt.y-r,
        evt.x+r, evt.y+r, fill='orange')

Lorsque ce gestionnaire est appelé, la position courante de la souris est (evt.x, evt.y). La méthode create_oval() dessine un cercle dont la boîte englobante est un carré centré sur cette position et dont les côtés mesure 2*r.

Astuce pour des arguments en plus de «evt»¶

Parfois, vous souhaiterez passer d’autres arguments à un gestionnaire (en plus de l’objet Event)

Voici un exemple. Supposez que votre application comporte un tableau de cases à cocher dont les widgets sont mémorisés dans une liste ccList, indexée par le numéro de la case à cocher situé dans range(10).

Supposez en outre que vous souhaitiez n’écrire qu’un gestionnaire ccGest pour l’événement '<Button-1>' sur l’une de ces 10 cases. Votre gestionnaire peut connaître la case sur laquelle a eu lieu le clic en utilisant l’attribut widget de l’objet Event, mais comment faire pour retrouver son index dans la liste ccList ?

Il serait commode d’écrire notre gestionnaire avec un argument supplémentaire pour le numéro de la case à cocher, quelquechose comme:

def ccGest(evt, ccNb):

Mais un gestionnaire d’événement ne reçoit qu’un argument, l’objet de type Event. Il n’est donc pas possible d’utiliser la fonction ci-dessus qui comporte un argument de trop.

Heureusement, il est possible d’exploiter les valeurs par défaut des fonctions pour parvenir à l’objectif. Observer le code suivant:

 ccListe = []
 def creerWidgets():
    #...
    for i in range(10):
        cc = Checkbutton(root, ...)
        ccList.append(cc)
        cc.grid(row=1, column=i)
        def gest(evt, i=i):   1
            return ccGest(evt, i)
        cc.bind('<Button-1>', gest)
    #...
def ccGest(evt, ccNb):
    #...

Ces lignes définissent un gestionnaire, gest() qui attend deux arguments. Le premier est l’objet de type Event habituel et le second a une valeur par défaut qui est exactement celle que nous avons besoin de connaître. Il suffit ensuite de définir le gestionnaire d’événement «réel», ccGest() pour atteindre le but que nous nous étions fixé.

Cette technique peut être étendue pour fournir autant d’arguments que souhaités à un gestionnaire d’événements.