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

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, этот class ориентирован на многопотоковое исполнение.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

Полевая Сводка
- Поля, наследованные от class javax.swing.undo. CompoundEdit
  редактирования
- Поля, наследованные от class 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`, обновление индексирования следующего редактирования соответственно.

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

Методы, наследованные от class javax.swing.undo. AbstractUndoableEdit
replaceEdit

Методы, наследованные от class 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 в class CompoundEdit
    
    Броски:
    
    CannotUndoException - если один из бросков редактирований CannotUndoException или нет никаких редактирований, которые будут отменены
    
    См. Также:
    
    CompoundEdit.end(), canUndo(), editToBeUndone()
  - canUndo
```
public boolean canUndo()
```
    Возвращает true, если редактирования могут быть отменены. Если end был вызван, это возвращает значение из супер. Иначе это возвращает true, если есть какие-либо редактирования, которые будут отменены (editToBeUndone возвраты не -null).
    
    Определенный:
    
    canUndo в интерфейсе UndoableEdit
    
    Переопределения:
    
    canUndo в class CompoundEdit
    
    Возвраты:
    
    истина, если есть редактирования, которые будут отменены
    
    См. Также:
    
    CompoundEdit.canUndo(), editToBeUndone()
  - восстановление
```
public void redo()
          throws CannotRedoException
```
    Делает заново соответствующие редактирования. Если end был вызван это вызывает через к суперклассу. Иначе это вызывает redo на всех редактированиях между индексированием следующего редактирования и следующем существенном редактировании, обновляя индексирование следующего редактирования соответственно.
    
    Определенный:
    
    redo в интерфейсе UndoableEdit
    
    Переопределения:
    
    redo в class CompoundEdit
    
    Броски:
    
    CannotRedoException - если один из бросков редактирований CannotRedoException или нет никаких редактирований, которые будут сделаны заново
    
    См. Также:
    
    CompoundEdit.end(), canRedo(), editToBeRedone()
  - canRedo
```
public boolean canRedo()
```
    Возвращает true, если редактирования могут быть сделаны заново. Если end был вызван, это возвращает значение из супер. Иначе, это возвращает true, если есть какие-либо редактирования, которые будут сделаны заново (editToBeRedone возвраты не -null).
    
    Определенный:
    
    canRedo в интерфейсе UndoableEdit
    
    Переопределения:
    
    canRedo в class CompoundEdit
    
    Возвраты:
    
    истина, если есть редактирования, которые будут сделаны заново
    
    См. Также:
    
    CompoundEdit.canRedo(), editToBeRedone()
  - addEdit
```
public boolean addEdit(UndoableEdit anEdit)
```
    Добавляет UndoableEdit к этому UndoManager, если это возможно. Это удаляет все редактирования из индексирования следующего редактирования до конца списка редактирований. Если end был вызван редактирование не добавляется и false возвращается. Если end не был вызван это возвращается true.
    
    Определенный:
    
    addEdit в интерфейсе UndoableEdit
    
    Переопределения:
    
    addEdit в class CompoundEdit
    
    Параметры:
    
    anEdit - редактирование, которое будет добавлено
    
    Возвраты:
    
    истина, если anEdit может быть включен в это редактирование
    
    См. Также:
    
    CompoundEdit.end(), CompoundEdit.addEdit(javax.swing.undo.UndoableEdit)
  - конец
```
public void end()
```
    Повороты это UndoManager в нормальное CompoundEdit. Это удаляет все редактирования, которые были отменены.
    
    Переопределения:
    
    end в class CompoundEdit
    
    См. Также:
    
    CompoundEdit.end()
  - getUndoOrRedoPresentationName
```
public String getUndoOrRedoPresentationName()
```
    Метод удобства, который возвращается также getUndoPresentationName или getRedoPresentationName. Если индексирование следующего редактирования равняется размеру списка редактирований, getUndoPresentationName возвращается, иначе getRedoPresentationName возвращается.
    
    Возвраты:
    
    отмена или имя восстановления
  - getUndoPresentationName
```
public String getUndoPresentationName()
```
    Возвращает описание невыполнимой формы этого редактирования. Если end был вызван это вызывает в супер. Иначе, если есть редактирования, которые будут отменены, это возвращает значение из следующего существенного редактирования, которое будет отменено. Если нет никаких редактирований, которые будут отменены и end не был вызван это возвращает значение из UIManager свойство "AbstractUndoableEdit.undoText".
    
    Определенный:
    
    getUndoPresentationName в интерфейсе UndoableEdit
    
    Переопределения:
    
    getUndoPresentationName в class CompoundEdit
    
    Возвраты:
    
    описание невыполнимой формы этого редактирования
    
    См. Также:
    
    undo(), CompoundEdit.getUndoPresentationName()
  - getRedoPresentationName
```
public String getRedoPresentationName()
```
    Возвращает описание перевыполнимой формы этого редактирования. Если end был вызван это вызывает в супер. Иначе, если есть редактирования, которые будут сделаны заново, это возвращает значение из следующего существенного редактирования, которое будет сделано заново. Если нет никаких редактирований, которые будут сделаны заново и end не был вызван это возвращает значение из UIManager свойство "AbstractUndoableEdit.redoText".
    
    Определенный:
    
    getRedoPresentationName в интерфейсе UndoableEdit
    
    Переопределения:
    
    getRedoPresentationName в class 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 в class CompoundEdit
    
    Возвраты:
    
    Строковое представление этого объекта

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

Класс UndoManager

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

Поля, наследованные от class javax.swing.undo. CompoundEdit

Поля, наследованные от class javax.swing.undo. AbstractUndoableEdit

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

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

Методы, наследованные от class javax.swing.undo. CompoundEdit

Методы, наследованные от class javax.swing.undo. AbstractUndoableEdit

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

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

UndoManager

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

getLimit

discardAllEdits

trimForLimit

trimEdits

setLimit

editToBeUndone

editToBeRedone

undoTo

redoTo

undoOrRedo

canUndoOrRedo

отмена

canUndo

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

canRedo

addEdit

конец

getUndoOrRedoPresentationName

getUndoPresentationName

getRedoPresentationName

undoableEditHappened

toString