Commande undo

La commande undo permet d'annuler ou de répéter les modifications apportées au document en cours. Elle permet également de fermer de manière explicite la modification en cours, d'effacer toutes les modifications de la pile d'annulation, ou de les restaurer.

Syntaxe

undo [ [ n ] [ discard ] [ quiet ]
     | check
     | clear
     | resetChanges
     ] 

Paramètres

n Le paramètre n permet d'indiquer le nombre de modifications à annuler. Si n est négatif, -n modifications sont annulées.
discard Le paramètre discard permet d'éliminer les modifications qui ont été annulées de sorte qu'elles ne puissent pas être répétées. Si n est inférieur à zéro, le paramètre discard n'est pas admis.
quiet Le paramètre quiet permet de supprimer les produits par la commande undo.
check Le paramètre check permet de fermer la modification en cours.
clear Le paramètre clear permet de retirer toutes les modifications de la pile d'annulation.
resetChanges Le paramètre resetChanges permet de remettre le comptage des modifications à zéro.

Etat

L'une des valeurs suivantes est affectée au paramètre status :
null La commande undo a été exécutée avec succès.
undo.nothingUndone Aucune modification susceptible d'être annulée ou rétablie n'était enregistrée.

Description

Si aucun paramètre n'a été indiqué, la commande undo annule une modification.

Le paramètre dirty permet de déterminer s'il existe une modification incomplète. Si ce n'est pas le cas, le paramètre undo check n'intervient pas, mais si c'est le cas, il permet d'appliquer la modification, d'incrémenter la comptage des modifications et d'affecter la valeur off au paramètre dirty pour le remettre à zéro.

Seules les modifications qui ont abouti peuvent être annulées.

Les modifications sont effectuées de manière implicite lorsque le curseur ne se trouve plus sur la ligne en cours. Si la valeur off est affectée au paramètre autoCheck, les modifications ne sont pas effectuées implicitement.

Les modifications apportées lorsque la valeur off est affectée au paramètre recording ne peuvent pas être annulées.

Le modifications ne concernant que les éléments show ne sont pas enregistrées et ne peuvent pas être annulées.

Exemples

undo
undo -1
undo clear 

Concepts connexes
Commandes, actions et paramètres de l'éditeur

Références connexes
Commande load
Commande save
Paramètre autoCheck
Paramètre changes
Paramètre dirty
Paramètre recording
Action redo
Action undo