public interface UndoableEdit
UndoableEditは編集結果を表します。編集結果の取り消しや、いったん取り消した編集の再実行も可能です。
UndoableEditはUndoManagerとともに使用します。UndoableEditはUndoableEditListenerによって生成されるので、通常はUndoManagerに追加されます。UndoableEditがUndoManagerに追加されると、次の処理が行われます(UndoManager上でまだendが呼び出されていないものと想定)。
UndoManagerは、現在の編集結果に対してaddEditを呼び出します。このとき、新しい編集結果を引数に指定します。addEditがtrueを返す場合は、新しい編集結果がすでに現在の編集結果に組み込まれたものとみなされます。したがって、この新しい編集結果は、現在の編集結果のリストには追加されません。addEditを使って小規模な編集結果をより大規模な編集結果に組み込むことにより、1つの編集結果として扱うことができます。
addEditの戻り値がfalseである場合、新しい編集結果に対してreplaceEditが呼び出されます。このとき、引数として現在の編集結果が渡されます。これは、addEditと逆の操作になります。新しい編集結果がreplaceEditからtrueを返す場合、この編集結果で現在の編集結果が置き換えられます。
UndoManagerは、isSignificantを利用して、何個の編集結果を取り消せるか、または取り消した編集を再実行できるかを決定します。UndoManagerは、小さな編集結果を取り消したり、再実行したりできます(isSignificantがfalseを返す場合)。たとえば、現在の編集結果を取り消して前回の重大な結果に戻したり、編集を再実行して重大な編集結果を得ることができます。複数の編集結果を単一の編集結果として扱うには、addEditとreplaceEditを使用します。isSignificantがfalseを返す場合は、多くの小さな編集結果を一度に取り消したり、再実行したりできます。同様の処理は、addEditメソッドを使っても実行できます。| 修飾子と型 | メソッドと説明 |
|---|---|
boolean |
addEdit(UndoableEdit anEdit)
この
UndoableEditにUndoableEditを追加します。 |
boolean |
canRedo()
この編集内容を再実行できる場合はtrueを返します。
|
boolean |
canUndo()
この編集結果を取り消せる場合はtrueを返します。
|
void |
die()
編集結果に、これ以上使用できないことを通知します。
|
String |
getPresentationName()
変更ログなどで使用するのに適した、この編集結果の判読可能なローカライズ済みの記述を返します。
|
String |
getRedoPresentationName()
「再実行」メニュー項目などで使用するのに適した、この編集結果の再実行可能な形式の判読可能なローカライズ済みの説明を返します。
|
String |
getUndoPresentationName()
「元に戻す」メニュー項目などで使用するのに適した、この編集結果の取消し可能な形式の判読可能なローカライズ済みの説明を返します。
|
boolean |
isSignificant()
この編集結果が重大であると見なされる場合にtrueを返します。
|
void |
redo()
編集内容を適用し直します。
|
boolean |
replaceEdit(UndoableEdit anEdit)
この
UndoableEditでanEditが置き換えられる場合は、trueを返します。 |
void |
undo()
編集結果を取り消します。
|
void undo() throws CannotUndoException
CannotUndoException - この編集結果を取り消せない場合boolean canUndo()
void redo() throws CannotRedoException
CannotRedoException - この編集内容を再実行できない場合boolean canRedo()
void die()
UndoableEditは、取り消すことも再実行することもできません。
これは、元に戻す操作や再実行の操作が不可能になり、不要になった状態をクリーンアップするとき、たとえば、削除の取消しができなくなったオブジェクトによって使用されるファイル・リソースを削除する場合に使用するフックです。UndoManagerは、編集結果の待機を解除する前にこのメソッドを呼び出します。
これは一方向の操作です。undieというメソッドはありません。
CompoundEdit.die()boolean addEdit(UndoableEdit anEdit)
UndoableEditにUndoableEditを追加します。比較的小規模な複数の編集結果を合体して、より大規模な単一の編集結果を得たい場合は、このメソッドを使用します。たとえば、通常、テキスト・エディタでは、語や文に取消し操作を適用することができます。テキスト・エディタでは、キー・イベントの発生のたびに編集結果を生成することもできますが、これらの編集結果を合体して、ユーザーにより扱いやすい単位(たとえば語単位)にすることもできます。このように複数の編集結果の合体が可能な場合は、UndoableEditがaddEditをオーバーライドし、trueを返します。
戻り値trueは、anEditがこの編集結果に組み込まれたことを表します。戻り値falseは、anEditをこの編集結果に組み込めないことを表します。
通常、レシーバはすでにUndoManager (または、ほかのUndoableEditListener)のキューに入っており、anEditをキューに順番に追加するのではなく、それを取り込む機会を与えられます。
trueが返されると、それ以降anEditは、canUndoおよびcanRedoからはfalseを返し、undoやredoには適切な例外をスローします。
anEdit - 追加される編集結果anEditを組み込むことができる場合はtrueboolean replaceEdit(UndoableEdit anEdit)
UndoableEditでanEditが置き換えられる場合は、trueを返します。このメソッドは、CompoundEditとUndoManagerによって使用されます。anEditを現在の編集結果に追加できない場合(addEditがfalseを返す場合)に呼び出されます。
このメソッドを利用すると、ある編集結果で既存の編集結果を置き換えることができます。
このメッセージは、addEditの対極にあります。つまり、anEditは通常UndoManager (または、ほかのUndoableEditListener)のキューにすでに入っており、レシーバはそれと置き換えられる機会を与えられます。
trueが返されると、それ以降anEditは、canUndo()およびcanRedo()からはfalseを返し、undo()やredo()には適切な例外をスローします。
anEdit - 現在の編集結果を置き換える編集内容anEditが置き換えられる場合はtrueboolean isSignificant()
UndoManagerは、次の重大な編集結果に対する小さな編集結果すべてを取り消しまたは再実行します。String getPresentationName()
String getUndoPresentationName()
getPresentationNameから派生します。String getRedoPresentationName()
getPresentationNameから派生します。 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.