UndoManager (Платформа Java SE 7)

java.lang. Объект
- javax.swing.undo. AbstractUndoableEdit
- - javax.swing.undo. CompoundEdit
  - - javax.swing.undo. UndoManager

Все Реализованные Интерфейсы:

Сериализуемый, EventListener, UndoableEditListener, UndoableEdit
```
public class UndoManager
extends CompoundEdit
implements UndoableEditListener
```
UndoManager управляет списком UndoableEdits, обеспечение способа отменить или восстановить соответствующие редактирования. Есть два способа добавить редактирования к UndoManager. Добавьте редактирование, непосредственно используя addEdit метод, или добавляют UndoManager к бобу, который поддерживает UndoableEditListener. Следующие примеры создают UndoManager и добавляет это как UndoableEditListener к a JTextField:
```
   UndoManager undoManager = new UndoManager();
   JTextField tf = ...;
   tf.getDocument().addUndoableEditListener(undoManager);
 
```
UndoManager поддерживает упорядоченный список редактирований и индекс следующего редактирования в том списке. Индекс следующего редактирования является или размером текущего списка редактирований, или если undo был вызван это соответствует индексу последнего существенного редактирования, которое было отменено. Когда undo вызывается все редактирования от индекса следующего редактирования к последнему существенному редактированию отменяются в обратном порядке. Например, рассмотрите UndoManager состоя из следующих редактирований: b c Д. Эдитс с прописной буквой полужирным является существенным, те в нижнем регистре и выделенный курсивом являются незначащими.

Рисунок 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, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

Полевая Сводка
- Поля javax.swing.undo унаследованный от класса. CompoundEdit
  редактирования
- Поля javax.swing.undo унаследованный от класса. AbstractUndoableEdit
  RedoName, UndoName

Сводка конструктора

Конструкторы
Конструктор и Описание

UndoManager()
Создает новое UndoManager.

Конструкторы
Конструктор и Описание
`UndoManager()` Создает новое `UndoManager`.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`boolean`	`addEdit(UndoableEdit anEdit)` Добавляет `UndoableEdit` к этому `UndoManager`, если это возможно.
`boolean`	`canRedo()` Возвращает true, если редактирования могут быть сделаны заново.
`boolean`	`canUndo()` Возвращает true, если редактирования могут быть отменены.
`boolean`	`canUndoOrRedo()` Возвращает true, если возможно вызвать `undo` или `redo`.
`void`	`discardAllEdits()` Освобождает менеджера по отмене, отправляющего каждое редактирование a `die` сообщение в процессе.
`protected UndoableEdit`	`editToBeRedone()` Возвращает следующее существенное редактирование, которое будет сделано заново если `redo` вызывается.
`protected UndoableEdit`	`editToBeUndone()` Возвращает следующее существенное редактирование, которое будет отменено если `undo` вызывается.
`void`	`end()` Повороты это `UndoManager` в нормальное `CompoundEdit`.
`int`	`getLimit()` Возвращает максимальное количество редактирований это `UndoManager` содержит.
`Строка`	`getRedoPresentationName()` Возвращает описание перевыполнимой формы этого редактирования.
`Строка`	`getUndoOrRedoPresentationName()` Метод удобства, который возвращается также `getUndoPresentationName` или `getRedoPresentationName`.
`Строка`	`getUndoPresentationName()` Возвращает описание невыполнимой формы этого редактирования.
`void`	`redo()` Делает заново соответствующие редактирования.
`protected void`	`redoTo(UndoableEdit edit)` Делает заново все изменения от индекса следующего редактирования к `edit`, обновление индекса следующего редактирования соответственно.
`void`	`setLimit(int l)` Устанавливает максимальное количество редактирований это `UndoManager` содержит.
`Строка`	`toString()` Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.
`protected void`	`trimEdits(int from, int to)` Удаляет редактирования в указанном диапазоне.
`protected void`	`trimForLimit()` Сокращает количество редактирований с очередями к диапазону предела размера, центрируемого на индексе следующего редактирования.
`void`	`undo()` Отменяет соответствующие редактирования.
`void`	`undoableEditHappened(UndoableEditEvent e)` `UndoableEditListener` метод.
`void`	`undoOrRedo()` Метод удобства, который вызывает один из `undo` или `redo`.
`protected void`	`undoTo(UndoableEdit edit)` Отмены все изменения от индекса следующего редактирования к `edit`, обновление индекса следующего редактирования соответственно.

Методы javax.swing.undo унаследованный от класса. CompoundEdit
die, getPresentationName, isInProgress, isSignificant, lastEdit

Методы javax.swing.undo унаследованный от класса. AbstractUndoableEdit
replaceEdit

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - UndoManager
```
public UndoManager()
```
    Создает новое UndoManager.
- Деталь метода
  - getLimit
```
public int getLimit()
```
    Возвращает максимальное количество редактирований это UndoManager содержит. Значение меньше чем 0 указывают на число редактирований, не ограничивается.
    
    Возвраты:
    максимальное количество редактирований это UndoManager содержит
    См. Также:
    addEdit(javax.swing.undo.UndoableEdit), setLimit(int)
  - discardAllEdits
```
public void discardAllEdits()
```
    Освобождает менеджера по отмене, отправляющего каждое редактирование a die сообщение в процессе.
    
    См. Также:
    AbstractUndoableEdit.die()
  - trimForLimit
```
protected void trimForLimit()
```
    Сокращает количество редактирований с очередями к диапазону предела размера, центрируемого на индексе следующего редактирования.
  - trimEdits
```
protected void trimEdits(int from,
             int to)
```
    Удаляет редактирования в указанном диапазоне. Все редактирования в данном диапазоне (включительно, и в обратном порядке) будут иметь die вызванный на них и удаляются из списка редактирований. Это не имеет никакого эффекта если from > to.
    
    Параметры:
    from - минимальный индекс, чтобы удалить
    to - максимальный индекс, чтобы удалить
  - setLimit
```
public void setLimit(int l)
```
    Устанавливает максимальное количество редактирований это UndoManager содержит. Значение меньше чем 0 указывают на число редактирований, не ограничивается. Если редактирования должны быть отброшены, чтобы уменьшить предел, die будет вызван на них в обратном порядке, они были добавлены. Значение по умолчанию 100.
    
    Параметры:
    l - новый предел
    
    Броски:
    
    RuntimeException - если это UndoManager не происходит (end был вызван),
    См. Также:
    CompoundEdit.isInProgress(), end(), addEdit(javax.swing.undo.UndoableEdit), getLimit()
  - editToBeUndone
```
protected UndoableEdit editToBeUndone()
```
    Возвращает следующее существенное редактирование, которое будет отменено если undo вызывается. Это возвращается null если нет никаких редактирований, которые будут отменены.
    
    Возвраты:
    следующее существенное редактирование, которое будет отменено
  - editToBeRedone
```
protected UndoableEdit editToBeRedone()
```
    Возвращает следующее существенное редактирование, которое будет сделано заново если redo вызывается. Это возвращается null если нет никаких редактирований, которые будут сделаны заново.
    
    Возвраты:
    следующее существенное редактирование, которое будет сделано заново
  - undoTo
```
protected void undoTo(UndoableEdit edit)
               throws CannotUndoException
```
    Отмены все изменения от индекса следующего редактирования к edit, обновление индекса следующего редактирования соответственно.
    
    Броски:
    
    CannotUndoException - если один из бросков редактирований CannotUndoException
  - redoTo
```
protected void redoTo(UndoableEdit edit)
               throws CannotRedoException
```
    Делает заново все изменения от индекса следующего редактирования к edit, обновление индекса следующего редактирования соответственно.
    
    Броски:
    
    CannotRedoException - если один из бросков редактирований CannotRedoException
  - undoOrRedo
```
public void undoOrRedo()
                throws CannotRedoException,
                       CannotUndoException
```
    Метод удобства, который вызывает один из undo или redo. Если какие-либо редактирования были отменены (индекс следующего редактирования является меньше чем длина списка редактирований), это вызывает redo, иначе это вызывает undo.
    
    Броски:
    
    CannotUndoException - если один из бросков редактирований CannotUndoException
    
    CannotRedoException - если один из бросков редактирований CannotRedoException
    См. Также:
    canUndoOrRedo(), getUndoOrRedoPresentationName()
  - canUndoOrRedo
```
public boolean canUndoOrRedo()
```
    Возвращает true, если возможно вызвать undo или redo.
    
    Возвраты:
    истина, вызывая canUndoOrRedo допустимо
    См. Также:
    undoOrRedo()
  - отмена
```
public void undo()
          throws CannotUndoException
```
    Отменяет соответствующие редактирования. Если end был вызван это вызывает через к суперклассу, иначе это вызывает undo на всех редактированиях между индексом следующего редактирования и последнем существенном редактировании, обновляя индекс следующего редактирования соответственно.
    
    Определенный:
    
    undo в интерфейсе UndoableEdit
    
    Переопределения:
    
    undo в классе CompoundEdit
    
    Броски:
    
    CannotUndoException - если один из бросков редактирований CannotUndoException или нет никаких редактирований, которые будут отменены
    См. Также:
    CompoundEdit.end(), canUndo(), editToBeUndone()
  - canUndo
```
public boolean canUndo()
```
    Возвращает true, если редактирования могут быть отменены. Если end был вызван, это возвращает значение из супер. Иначе это возвращает true, если есть какие-либо редактирования, которые будут отменены (editToBeUndone возвраты не -null).
    
    Определенный:
    
    canUndo в интерфейсе UndoableEdit
    
    Переопределения:
    
    canUndo в классе CompoundEdit
    
    Возвраты:
    истина, если есть редактирования, которые будут отменены
    См. Также:
    CompoundEdit.canUndo(), editToBeUndone()
  - восстановление
```
public void redo()
          throws CannotRedoException
```
    Делает заново соответствующие редактирования. Если end был вызван это вызывает через к суперклассу. Иначе это вызывает redo на всех редактированиях между индексом следующего редактирования и следующем существенном редактировании, обновляя индекс следующего редактирования соответственно.
    
    Определенный:
    
    redo в интерфейсе UndoableEdit
    
    Переопределения:
    
    redo в классе CompoundEdit
    
    Броски:
    
    CannotRedoException - если один из бросков редактирований CannotRedoException или нет никаких редактирований, которые будут сделаны заново
    См. Также:
    CompoundEdit.end(), canRedo(), editToBeRedone()
  - canRedo
```
public boolean canRedo()
```
    Возвращает true, если редактирования могут быть сделаны заново. Если end был вызван, это возвращает значение из супер. Иначе, это возвращает true, если есть какие-либо редактирования, которые будут сделаны заново (editToBeRedone возвраты не -null).
    
    Определенный:
    
    canRedo в интерфейсе UndoableEdit
    
    Переопределения:
    
    canRedo в классе CompoundEdit
    
    Возвраты:
    истина, если есть редактирования, которые будут сделаны заново
    См. Также:
    CompoundEdit.canRedo(), editToBeRedone()
  - addEdit
```
public boolean addEdit(UndoableEdit anEdit)
```
    Добавляет UndoableEdit к этому UndoManager, если это возможно. Это удаляет все редактирования из индекса следующего редактирования до конца списка редактирований. Если end был вызван редактирование не добавляется и false возвращается. Если end не был вызван это возвращается true.
    
    Определенный:
    
    addEdit в интерфейсе UndoableEdit
    
    Переопределения:
    
    addEdit в классе CompoundEdit
    
    Параметры:
    anEdit - редактирование, которое будет добавлено
    
    Возвраты:
    истина, если anEdit может быть включен в это редактирование
    См. Также:
    CompoundEdit.end(), CompoundEdit.addEdit(javax.swing.undo.UndoableEdit)
  - конец
```
public void end()
```
    Повороты это UndoManager в нормальное CompoundEdit. Это удаляет все редактирования, которые были отменены.
    
    Переопределения:
    
    end в классе CompoundEdit
    
    См. Также:
    CompoundEdit.end()
  - getUndoOrRedoPresentationName
```
public String getUndoOrRedoPresentationName()
```
    Метод удобства, который возвращается также getUndoPresentationName или getRedoPresentationName. Если индекс следующего редактирования равняется размеру списка редактирований, getUndoPresentationName возвращается, иначе getRedoPresentationName возвращается.
    
    Возвраты:
    отмена или имя восстановления
  - getUndoPresentationName
```
public String getUndoPresentationName()
```
    Возвращает описание невыполнимой формы этого редактирования. Если end был вызван это вызывает в супер. Иначе, если есть редактирования, которые будут отменены, это возвращает значение из следующего существенного редактирования, которое будет отменено. Если нет никаких редактирований, которые будут отменены и end не был вызван это возвращает значение из UIManager свойство "AbstractUndoableEdit.undoText".
    
    Определенный:
    
    getUndoPresentationName в интерфейсе UndoableEdit
    
    Переопределения:
    
    getUndoPresentationName в классе CompoundEdit
    
    Возвраты:
    описание невыполнимой формы этого редактирования
    См. Также:
    undo(), CompoundEdit.getUndoPresentationName()
  - getRedoPresentationName
```
public String getRedoPresentationName()
```
    Возвращает описание перевыполнимой формы этого редактирования. Если end был вызван это вызывает в супер. Иначе, если есть редактирования, которые будут сделаны заново, это возвращает значение из следующего существенного редактирования, которое будет сделано заново. Если нет никаких редактирований, которые будут сделаны заново и end не был вызван это возвращает значение из UIManager свойство "AbstractUndoableEdit.redoText".
    
    Определенный:
    
    getRedoPresentationName в интерфейсе UndoableEdit
    
    Переопределения:
    
    getRedoPresentationName в классе CompoundEdit
    
    Возвраты:
    описание перевыполнимой формы этого редактирования
    См. Также:
    redo(), CompoundEdit.getRedoPresentationName()
  - undoableEditHappened
```
public void undoableEditHappened(UndoableEditEvent e)
```
    UndoableEditListener метод. Это вызывает addEdit с e.getEdit().
    
    Определенный:
    
    undoableEditHappened в интерфейсе UndoableEditListener
    
    Параметры:
    e - UndoableEditEvent UndoableEditEvent будет добавлен от
    См. Также:
    addEdit(javax.swing.undo.UndoableEdit)
  - toString
```
public String toString()
```
    Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.
    
    Переопределения:
    
    toString в классе CompoundEdit
    
    Возвраты:
    Строковое представление этого объекта

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс UndoManager

Полевая Сводка

Поля javax.swing.undo унаследованный от класса. CompoundEdit

Поля javax.swing.undo унаследованный от класса. AbstractUndoableEdit

Сводка конструктора

Сводка метода

Методы javax.swing.undo унаследованный от класса. CompoundEdit

Методы javax.swing.undo унаследованный от класса. AbstractUndoableEdit

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

UndoManager

Деталь метода

getLimit

discardAllEdits

trimForLimit

trimEdits

setLimit

editToBeUndone

editToBeRedone

undoTo

redoTo

undoOrRedo

canUndoOrRedo

отмена

canUndo

восстановление

canRedo

addEdit

конец

getUndoOrRedoPresentationName

getUndoPresentationName

getRedoPresentationName

undoableEditHappened

toString