Class AbstractDocument.DefaultDocumentEvent
java.lang.Object
javax.swing.undo.AbstractUndoableEdit
javax.swing.undo.CompoundEdit
javax.swing.text.AbstractDocument.DefaultDocumentEvent
- All Implemented Interfaces:
Serializable, DocumentEvent, UndoableEdit
- Enclosing class:
AbstractDocument
Stores document changes as the document is being
modified. Can subsequently be used for change notification
when done with the document modification transaction.
This is used by the AbstractDocument class and its extensions
for broadcasting change information to the document listeners.
-
Nested Class Summary
Nested classes/interfaces declared in interface DocumentEvent
DocumentEvent.ElementChange, DocumentEvent.EventType
Modifier and TypeInterfaceDescriptionstatic interface
Describes changes made to a specific element.static final class
Enumeration for document event types -
Field Summary
Fields declared in class CompoundEdit
edits
Modifier and TypeFieldDescriptionprotected Vector
<UndoableEdit> The collection ofUndoableEdit
s undone/redone en masse by thisCompoundEdit
.Fields declared in class AbstractUndoableEdit
RedoName, UndoName
Modifier and TypeFieldDescriptionprotected static final String
String returned bygetRedoPresentationName
; as of Java 2 platform v1.3.1 this field is no longer used.protected static final String
String returned bygetUndoPresentationName
; as of Java 2 platform v1.3.1 this field is no longer used. -
Constructor Summary
ConstructorsConstructorDescriptionDefaultDocumentEvent
(int offs, int len, DocumentEvent.EventType type) Constructs a change record. -
Method Summary
Modifier and TypeMethodDescriptionboolean
addEdit
(UndoableEdit anEdit) Adds a document edit.Gets the changes for an element.Gets the document that sourced the change event.int
Returns the length of the change.int
Returns the offset within the document of the start of the change.Provides a localized, human readable description of this edit suitable for use in, say, a change log.Provides a localized, human readable description of the redoable form of this edit, e.g. for use as a Redo menu item.getType()
Returns the type of event.Provides a localized, human readable description of the undoable form of this edit, e.g. for use as an Undo menu item.boolean
DefaultDocument events are significant.void
redo()
Redoes a change.toString()
Returns a string description of the change event.void
undo()
Undoes a change.Methods declared in class CompoundEdit
canRedo, canUndo, die, end, isInProgress, lastEdit
Modifier and TypeMethodDescriptionboolean
canRedo()
Returns false ifisInProgress
or if super returns false.boolean
canUndo()
Returns false ifisInProgress
or if super returns false.void
die()
Sendsdie
to each subedit, in the reverse of the order that they were added.void
end()
SetsinProgress
to false.boolean
Returns true if this edit is in progress--that is, it has not received end.protected UndoableEdit
lastEdit()
Returns the lastUndoableEdit
inedits
, ornull
ifedits
is empty.Methods declared in class AbstractUndoableEdit
replaceEdit
Modifier and TypeMethodDescriptionboolean
replaceEdit
(UndoableEdit anEdit) This default implementation returns false.Methods declared in class Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Modifier and TypeMethodDescriptionprotected Object
clone()
Creates and returns a copy of this object.boolean
Indicates whether some other object is "equal to" this one.protected void
finalize()
Deprecated, for removal: This API element is subject to removal in a future version.Finalization is deprecated and subject to removal in a future release.final Class
<?> getClass()
Returns the runtime class of thisObject
.int
hashCode()
Returns a hash code value for this object.final void
notify()
Wakes up a single thread that is waiting on this object's monitor.final void
Wakes up all threads that are waiting on this object's monitor.final void
wait()
Causes the current thread to wait until it is awakened, typically by being notified or interrupted.final void
wait
(long timeoutMillis) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.final void
wait
(long timeoutMillis, int nanos) Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
-
Constructor Details
-
DefaultDocumentEvent
Constructs a change record.- Parameters:
offs
- the offset into the document of the change >= 0len
- the length of the change >= 0type
- the type of event (DocumentEvent.EventType)- Since:
- 1.4
-
-
Method Details
-
toString
Returns a string description of the change event.- Overrides:
toString
in classCompoundEdit
- Returns:
- a string
-
addEdit
Adds a document edit. If the number of edits crosses a threshold, this switches on a hashtable lookup for ElementChange implementations since access of these needs to be relatively quick.- Specified by:
addEdit
in interfaceUndoableEdit
- Overrides:
addEdit
in classCompoundEdit
- Parameters:
anEdit
- a document edit record- Returns:
- true if the edit was added
- See Also:
-
redo
Redoes a change.- Specified by:
redo
in interfaceUndoableEdit
- Overrides:
redo
in classCompoundEdit
- Throws:
CannotRedoException
- if the change cannot be redone- See Also:
-
undo
Undoes a change.- Specified by:
undo
in interfaceUndoableEdit
- Overrides:
undo
in classCompoundEdit
- Throws:
CannotUndoException
- if the change cannot be undone- See Also:
-
isSignificant
public boolean isSignificant()DefaultDocument events are significant. If you wish to aggregate DefaultDocumentEvents to present them as a single edit to the user place them into a CompoundEdit.- Specified by:
isSignificant
in interfaceUndoableEdit
- Overrides:
isSignificant
in classCompoundEdit
- Returns:
- whether the event is significant for edit undo purposes
- See Also:
-
getPresentationName
Provides a localized, human readable description of this edit suitable for use in, say, a change log.- Specified by:
getPresentationName
in interfaceUndoableEdit
- Overrides:
getPresentationName
in classCompoundEdit
- Returns:
- the description
- See Also:
-
getUndoPresentationName
Provides a localized, human readable description of the undoable form of this edit, e.g. for use as an Undo menu item. Typically derived from getDescription();- Specified by:
getUndoPresentationName
in interfaceUndoableEdit
- Overrides:
getUndoPresentationName
in classCompoundEdit
- Returns:
- the description
- See Also:
-
getRedoPresentationName
Provides a localized, human readable description of the redoable form of this edit, e.g. for use as a Redo menu item. Typically derived from getPresentationName();- Specified by:
getRedoPresentationName
in interfaceUndoableEdit
- Overrides:
getRedoPresentationName
in classCompoundEdit
- Returns:
- the description
- See Also:
-
getType
Returns the type of event.- Specified by:
getType
in interfaceDocumentEvent
- Returns:
- the event type as a DocumentEvent.EventType
- See Also:
-
getOffset
public int getOffset()Returns the offset within the document of the start of the change.- Specified by:
getOffset
in interfaceDocumentEvent
- Returns:
- the offset >= 0
- See Also:
-
getLength
public int getLength()Returns the length of the change.- Specified by:
getLength
in interfaceDocumentEvent
- Returns:
- the length >= 0
- See Also:
-
getDocument
Gets the document that sourced the change event.- Specified by:
getDocument
in interfaceDocumentEvent
- Returns:
- the document
- See Also:
-
getChange
Gets the changes for an element.- Specified by:
getChange
in interfaceDocumentEvent
- Parameters:
elem
- the element- Returns:
- the changes
-