DESCRIPTION.

Associe une fonction au relachement d'une touche du clavier si la zone de dessin à le focus.

SYNTAXE.

turtle.onkey ( fonction , touche )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

.onkey ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

fonction ⇨ fonction à exécuter [ OBLIGATOIRE ]

touche ⇨ touche à surveiller [ OBLIGATOIRE ]

ou

TOR_Tortue.screen.onkey ( fonction , touche )

TOR_Tortue ⇨ instance de la classe turtle.RawTurtle ( ) [ OBLIGATOIRE ]

.screen.onkey ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

fonction ⇨ fonction à exécuter [ OBLIGATOIRE ]

touche ⇨ touche à surveiller [ OBLIGATOIRE ]

REMARQUES.

fonction doit être une fonction, quelconque mais valide. Le nom de la fonction appelée, ne doit pas être suivie des parenthèses car aucun argument ne peut être passé lors de l'appel de la fonction. Attention cependant, car turtle fournit, automatiquement, l'abscisse et l'ordonnée du pointeur de la souris comme arguments à la fonction à exécuter, qui devra donc le prévoir dans sa définition. Toutefois, si des valeurs doivent être fournis pour le traitement correct de la fonction appelée, fonction pourra être une fonction anonyme créée avec l'instruction lambda.

Si fonction vaut None, le lien entre le clique du bouton bouton et la fonction fonction est détruit. La fonction fonction ne sera plus exécutée si cet événement survient.

touche doit être str ( ) identifiant la touche, ou la combinaison de touches, du clavier à surveiller. La valeur de touche doit être celle qui serait retournée, par exemple par la méthode print ( ), si elle devait être affichée.

L'appel de fonction ne sera effectuée que lors que touche sera relaché.

La méthode turtle.onkey ( ) ne sera prise en compte que pour la zone de dessin ayant le focus, c'est-à-dire, le controle actif qui reçoit les saisies du clavier. Pour s'assurer que cela est bien le cas, il faudra aussi appeler la méthode turtle.listen ( ) avec la même tortue graphique. 

Les méthodes turtle.onkey ( ) et turtle.onkeyrelease ( ) sont des synonymes qui peuvent être employés indifféremment.

La tortue graphique anonyme ne doit pas préfixer cette méthode (turtle.onkey ( )).

Les tortues graphiques nommées devront la préfixer avec .screen (TOR_Tortue.screen.onkey ( )).

Les tortues graphiques indépendantes ne doivent pas utiliser cette méthode.