turtle.DESCRIPTION.

Définit la fonction à exécuter lorsque l'utilisateur effectue un cliquer-glisser sur la tortue graphique.

SYNTAXE.

turtle.ondrag ( fonction , bouton , mode )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

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

.ondrag ( ) ⇨ 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.

Pour déclencher un cliquer-glisser, le bouton de la souris doit être au préalable enfoncé, puis relaché pour terminer l'opération. 

Note : Contrairement à turtle.onclick ( ), la méthode turtle.ondrag ( ), 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 cliquer-glisser sur toute la toile.

Après avoir exécuté fonction, la tortue graphique se déplacera sur la toile, et laissera des traces si le crayon de la tortue est baissé, à la volée, non désirées. C'est pourquoi cette pratique est en général déconseillée.

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

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

La méthode turtle.ondrag ( ) 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.forward ( 40 )

turtle.left ( 36 )

def FNC_Droite ( Qabscisse , Qordonnee ) :

turtle.forward ( 40 )

turtle.right ( 36 )

turtle.shape ( "turtle" )

turtle.penup ( )

turtle.speed ( 1 )

turtle.home ( )

turtle.ondrag ( FNC_Gauche , 1 , True )

turtle.ondrag ( FNC_Gauche, 2 , True )

turtle.ondrag ( FNC_Droite , 2 , True )

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

turtle.ondrag ( FNC_Droite , 3 , True )