Класс UndoManager

public class UndoManager
extends CompoundEdit
implements UndoableEditListener

UndoManager управляет списком UndoableEdits, предоставляя способ отмены или повтора соответствующих изменений. Существует два способа добавления изменений в UndoManager. Добавить изменение напрямую, используя метод addEdit, или добавить UndoManager в компонент, поддерживающий UndoableEditListener. Следующие примеры создают UndoManager и добавляют его как UndoableEditListener в JTextField:

UndoManager undoManager = new UndoManager();
   JTextField tf = ...;
   tf.getDocument().addUndoableEditListener(undoManager);

UndoManager поддерживает упорядоченный список изменений и индекс следующего изменения в этом списке. Индекс следующего изменения равен либо размеру текущего списка изменений, либо, если был вызван метод undo, он соответствует индексу последнего значимого изменения, которое было отменено. При вызове метода undo все изменения от индекса следующего изменения до последнего значимого изменения отменяются в обратном порядке. Например, рассмотрим UndoManager, состоящий из следующих изменений: A b c D. Изменения с заглавной буквой, выделенной жирным шрифтом, являются значимыми, а изменения в строчных буквах, выделенные курсивом, — незначимыми.

Рисунок 1

Как показано на рисунке 1, если D был только что добавлен, индекс следующего изменения будет 4. Вызов метода undo приводит к вызову метода undo для D и установке индекса следующего изменения в 3 (изменение c), как показано на следующем рисунке.

Рисунок 2

Последнее значимое изменение — A, поэтому повторный вызов метода undo снова вызывает метод undo для c, b и A в этом порядке, устанавливая индекс следующего изменения в 0, как показано на следующем рисунке.

Рисунок 3

Вызов метода redo приводит к вызову метода redo для всех изменений между индексом следующего изменения и следующего значимого изменения (или до конца списка). Продолжая предыдущий пример, если был вызван метод redo, метод redo будет в свою очередь вызван для A, b и c. Кроме того, индекс следующего изменения устанавливается в 3 (как показано на рисунке 2).

Добавление изменения в UndoManager приводит к удалению всех изменений от индекса следующего изменения до конца списка. Продолжая предыдущий пример, если добавлено новое изменение e, изменение D удаляется из списка (после вызова метода die для него). Если c не включено в следующее изменение (метод c.addEdit(e) возвращает true) или заменено им (метод e.replaceEdit(c) возвращает true), новое изменение добавляется после c, как показано на следующем рисунке.

Рисунок 4

После вызова метода end для UndoManager поведение суперкласса используется для всех методов UndoableEdit. Дополнительные сведения о его поведении см. в CompoundEdit.

В отличие от остальной части Swing, этот класс потокобезопасен.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.