DESCRIPTION.

Initialise la pile d'annulation et détermine le nombre d'actions de la tortue graphique qui pourront être annulée.

SYNTAXE.

turtle.setundobuffer ( actions )

turtle ⇨ tortue graphique anonyme [ OBLIGATOIRE ]

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

actions ⇨ nombre d'annulation possibles [ OBLIGATOIRE ]

ou

TOR_Tortue.setundobuffer ( actions )

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

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

actions ⇨ nombre d'annulation possibles [ OBLIGATOIRE ]

REMARQUES.

actions doit être : 

- un int ( ) quelconque mais valide, donnant le nombre maximum d'actions qui pourront être annulées ;

- None pour désactiver le mécanisme d'annulation.

Si actions est modifié, la pile n'annulation sera vidée et toutes les commandes présentes seront perdues. Il ne sera plus possible de les annuler.

Par défaut, il n'est pas possible d'annuler les directives fournies par le script, à une tortue graphique. A partir de l'appel de la méthode turtle.setundobuffer ( ), les actions de la tortue graphique pourront être annulées avec l'utilisation de la méthode turtle.undo ( ), et en remontant la file des actions, de la plus récente à la plus ancienne. Il sera possible d'annuler uniquement les dernières actions de la tortue graphique.

Le module turtle ne possède de méthode pour refaire une action annulée par un appel de la méthode turtle.undo ( ). Il faudra donc la reprogrammer pour la rétablir. 

La méthode turtle.undo ( ) permet d'annuler l'action en haut de la pile d'annulation. 

La méthode turtle.undobufferentries ( ) permet de connaitre les nombre d'actions restantes dans la pile d'annulation.

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

EXEMPLE.

import turtle

turtle.speed ( 1 )

turtle.setundobuffer ( 20 )

for kvaleur in range ( 8 ) :

turtle.forward ( 50 )

turtle.left ( 45 )

while turtle.undobufferentries ( ) :

print ( turtle.undobufferentries ( ) )

turtle.undo ( )