DESCRIPTION.

Définit la fonction à exécuter lorsque l'utilisateur relache le bouton de la souris sur la tortue graphique.

SYNTAXE.

turtle.onrelease ( fonction , bouton , mode )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

.onrelease ( ) ⇨ 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.onrelease ( fonction , bouton , mode )

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

.onrelease ( ) ⇨ 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, mai 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 : Contrairement à turtle.onclick ( ), la méthode turtle.onrelease ( ), héritée de la classe turtle.RawTurtle ( ), n'a pas d'homonyme ni d'équivalent, héritée de la classe turtle.Screen ( ), pour surveiller les relachement sur toute la toile.

Le clique de la souris doit avoir lieu sur la tortue graphique pour la sélectionner, mais Le bouton peut être relaché en dehors de l'emprunte de la tortue, pour exécuté la fonction associée. Cela peut permettre par exemple de déplacer la tortue aux coordonnées de relachement du bouton.

Voir aussi, turtle.onclick ( ), qui associe une fonction au clique d'un bouton de souris sur la tortue.

Voir aussi, turtle.ondrag ( ), qui associe une fonction au cliquer-glisser de souris sur la tortue.

La méthode turtle.onclick ( ) est une méthode commune du module turtle et n'a pas besoin d'être préfixée.

EXEMPLE.

import turtle

def FNC_Gauche ( Qabscisse , Qordonnee ) :

turtle.goto ( Qabscisse , Qordonnee )

turtle.circle ( 40 )

def FNC_Droite ( Qabscisse , Qordonnee ) :

turtle.goto ( Qabscisse , Qordonnee )

turtle.circle ( -40 )

turtle.shape ( "turtle" )

turtle.penup ( )

turtle.speed ( 1 )

turtle.home ( )

turtle.onrelease ( FNC_Gauche , 1 , True )

turtle.onrelease ( FNC_Gauche, 2 , True )

turtle.onrelease ( FNC_Droite , 2 , True )

turtle.onrelease ( lambda *event : turtle.home ( ) , 2 , True )

turtle.onrelease ( FNC_Droite , 3 , True )