DESCRIPTION.

Associe une fonction à un clique de souris sur la zone de dessin.

SYNTAXE.

turtle.onscreenclick ( fonction , bouton , mode )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

fonction ⇨ fonction à exécuter [ OBLIGATOIRE ]

bouton ⇨ bouton de la souris à surveiller [ optionnel ]

mode ⇨ mode de portée de l'appel [ optionnel ]

ou

TOR_Tortue.screen.onclick ( fonction , bouton , mode )

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

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

fonction ⇨ fonction à exécuter [ OBLIGATOIRE ]

bouton ⇨ bouton de la souris à surveiller [ optionnel ]

mode ⇨ mode de portée de l'appel [ optionnel ]

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.

bouton doit être int ( ) identifiant le bouton de la souris à surveiller. L'identification des boutons de la souris dépend du système, mais en général : 

- 1, équivaut au bouton gauche ;

- 2, équivaut à la molette, ou au bouton centrale en son absence ;

- 3, équivaut au bouton droite.

Si bouton est omis, c'est le bouton par défaut, en général le bouton gauche, qui sera surveillé pour la liaison avec la fonction fonction. Dans ce cas, mode doit aussi être absent.

mode doit être bool ( ), s'il vaut : 

- True, l'appel est ajouté à la liste des liaisons existantes, et plusieurs fonctions peuvent être exécutées ;

- False, valeur par défaut, l'appel remplace tous les liaisons précédents.

Note : ne pas confondre les deux fonctions suivantes :

turtle.onclick ( ), héritée de la classe turtle.RawTurtle ( ), qui surveille les cliques uniquement sur la tortue graphique ;

turtle.onscreenclick ( ), héritée de la classe turtle.Screen ( ), qui surveille les cliques sur toute la toile.

La tortue graphique anonyme doit utiliser la forme turtle.onscreenclick ( ).

Les tortues graphiques nommées doivent utiliser la forme TOR_Tortue.screen.onclick ( ).

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

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

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