Class

NSUndoManager

A general-purpose recorder of operations that enables undo and redo. 操作の多目的記録装置、それは取り消しおよびやり直しを可能にするものです。

Declaration 宣言 

@interface NSUndoManager : NSObject

Overview 概要

You register an undo operation by calling one of the methods described in Registering Undo Operations. You specify the name of the object that’s changing (or the owner of that object) and provide a closure, method, or invocation to revert its state. あなたは、ある取り消し操作を、取り消し操作を登録するで記述されるメソッドの１つを呼び出すことによって登録します。あなたは、変更中のオブジェクトの名前（またはそのオブジェクトの所有者）を指定します、そしてクロージャ、メソッド、または発動を提供することでそれの状態を戻します。

After you register an undo operation, you can call undo on the undo manager to revert to the state of the last undo operation. When undoing an action, NSUndoManager saves the operations you reverted to so that you can call redo automatically. あなたがある取り消し操作を登録した後、あなたはundoをアンドゥマネージャ上で呼び出して、最後の取り消し操作の状態に戻すことができます。ある動作を取り消している時、NSUndoManagerはあなたが戻した操作それらを保存します、それであなたはredoを自動的に呼び出せます。

NSUndoManager is typically used by apps with UI interactions. For example, UIKit implements undo and redo in its text view object, making it easy for you to undo and redo actions in objects along the responder chain. NSUndoManager also serves as a general-purpose state manager, which can be used to undo and redo many kinds of actions. For example, an interactive command-line utility could use this class to undo the last command run, or a networking library could undo a request by sending another request that invalidates the previous one. NSUndoManagerは、概してUI相互作用でのアプリによって使われます。例えば、UIKitは取り消しとやり直しをそれのテキストビューオブジェクトにおいて実装して、あなたがレスポンダチェーンに沿ってオブジェクトにおける動作の取り消しとやり直しをやりやすくしています。NSUndoManagerはまた、一般的用途の状態マネージャとして役立ちます、それは多くの種類の動作の取り消しとやり直しに使用できます。例えば、ある対話式コマンドラインユーティリティはこのクラスを使って最後のコマンド実行を取り消すことができます、またネットワークライブラリはリクエストを、以前のものを無効にする別のリクエストを送信することによって取り消せます。

Topics 話題

Registering Undo Operations 取り消し操作を登録する

- registerUndoWithTarget:handler:
Records a single undo operation for a given target so that when an undo is performed, it executes the specified block. ある単一の取り消し操作をある与えられた目標に対して記録します、そうすることで取り消しが実行される時、それは指定されたブロックを遂行します。
- registerUndoWithTarget:selector:object:
Registers the selector of the specified target to implement a single undo operation that the target receives. 指定目標のセレクタを登録することで、レシーバを目標とするある単一の取り消し操作を実装します。
- prepareWithInvocationTarget:
Prepares the undo manager for invocation-based undo with the given target as the subject of the next undo operation. この与えられた目標物を次の取り消し操作の主題として、発動に基づく取り消しに対してアンドゥマネージャを用意します。

Checking Undo Ability 取り消し能力を調べる

canUndo
A Boolean value that indicates whether the receiver has any actions to undo. レシーバが取り消すいくらかの動作を持つかどうかを指し示すブール値。
canRedo
A Boolean value that indicates whether the receiver has any actions to redo. レシーバがやり直すいくらかの動作を持つかどうかを指し示すブール値。

Performing Undo and Redo 取り消しおよびやり直しを実行する

- undo
Closes the top-level undo group if necessary and invokes undoNestedGroup. トップレベル取り消しグループを必要ならば閉じます、そしてundoNestedGroupを発動します。
- undoNestedGroup
Performs the undo operations in the last undo group (whether top-level or nested), recording the operations on the redo stack as a single group. 最後の取り消しグループにおける取り消し操作それらを実行します（トップレベルであろうと入れ子であろうと）、やり直しスタック上の操作を単一グループとして記録しています。
- redo
Performs the operations in the last group on the redo stack, if there are any, recording them on the undo stack as a single group. やり直しスタック上の最後のグループの中の操作それらを実行します、もし何かそれらがあれば、それらを取り消しスタック上で単一グループとして記録しています。

Limiting the Undo Stack 取り消しスタックを制限する

levelsOfUndo
The maximum number of top-level undo groups the receiver holds. レシーバが保持するトップレベル取り消しグループの最大数。

Creating Undo Groups 取り消しグループを作成する

- beginUndoGrouping
Marks the beginning of an undo group. ある取り消しグループの始まりを印します。
- endUndoGrouping
Marks the end of an undo group. ある取り消しグループの終わりを印します。
groupsByEvent
A Boolean value that indicates whether the receiver automatically creates undo groups around each pass of the run loop. 実行ループの各通過に基づいてレシーバが自動的に取り消しグループを作成するかどうかを指し示すブール値。
groupingLevel
The number of nested undo groups (or redo groups, if Redo was invoked last) in the current event loop. 現在のイベントループの中の入れ子にされた取り消しグループ（またはやり直しグループ、もし「やり直す」が最後に発動されたならば）の数。

Enabling and Disabling Undo 取り消しを可能にするそしてできないようにする

- disableUndoRegistration
Disables the recording of undo operations, whether by registerUndoWithTarget:selector:object: or by invocation-based undo. 取り消し操作の記録をできないようにします、registerUndoWithTarget:selector:object:によってであろうと発動基盤の取り消しによってであろうと。
- enableUndoRegistration
Enables the recording of undo operations. 取り消し操作の記録を可能にします。
undoRegistrationEnabled
A Boolean value that indicates whether the recording of undo operations is enabled. 取り消し操作の記録が可能にされるかどうかを指し示すブール値。

Checking Whether Undo or Redo Is Being Performed 「取り消す」または「やり直す」どちらが実行されているか確認する

undoing
Returns a Boolean value that indicates whether the receiver is in the process of performing its undo or undoNestedGroup method. レシーバがそれのundoまたはundoNestedGroupメソッドの実行を進行中であるかどうかを指し示すブール値を返します。
redoing
Returns a Boolean value that indicates whether the receiver is in the process of performing its redo method. レシーバがそれのredoメソッドの実行を処理中であるかどうかを指し示すブール値を返します。

Clearing Undo Operations 取り消し操作をすっかりきれいにする

- removeAllActions
Clears the undo and redo stacks and re-enables the receiver. 取り消しおよびやり直しスタックをすっかりきれいにしてレシーバを再度利用可能にします。
- removeAllActionsWithTarget:
Clears the undo and redo stacks of all operations involving the specified target as the recipient of the undo message. この指定された目標を取り消しメッセージの受取手として発動している全ての操作の取り消しおよびやり直しスタックをすっかりきれいにします。

Managing the Action Name 動作名を管理する

undoActionName
The name identifying the undo action. 取り消し動作を識別する名前。
redoActionName
The name identifying the redo action. やり直し動作を識別する名前。
- setActionName:
Sets the name of the action associated with the Undo or Redo command. 「取り消す」または「やり直す」コマンドと結びつけられた動作の名前を設定します。

Getting and Localizing the Menu Item Title メニュー項目タイトルを取得するそしてローカライズする

undoMenuItemTitle
The complete title of the Undo menu command, for example, “Undo Paste.” 「取り消す」メニューコマンドの完全なタイトル、例えば、“Undo Paste”。
redoMenuItemTitle
The complete title of the Redo menu command, for example, “Redo Paste.” 「やり直す」メニューコマンドの完全なタイトル、例えば、“Redo Paste”。
- undoMenuTitleForUndoActionName:
Returns the complete, localized title of the Undo menu command for the action identified by the given name. 与えられた名前によって識別されるアクションに対する「取り消し」メニューコマンドの完全な、ローカライズされたタイトルを返します。
- redoMenuTitleForUndoActionName:
Returns the complete, localized title of the Redo menu command for the action identified by the given name. 与えられた名前によって識別されるアクションに対する「やり直す」メニューコマンドの完全な、ローカライズされたタイトルを返します。

Working with Run Loops 実行ループを扱う

runLoopModes
The modes governing the types of input handled during a cycle of the run loop. 実行ループの一周期の間に取り扱われる入力の型を規定するモード。

Discardable Undo and Redo Actions 取り消しとやり直しアクションを利用できなくする

- setActionIsDiscardable:
Sets whether the next undo or redo action is discardable. 次の取り消しまたはやり直しアクションが利用できなくされるかどうかを設定します。
undoActionIsDiscardable
Boolean value that indicates whether the next undo action is discardable. 次の取り消し動作が利用できなくされるかどうかを指し示すブール値。
redoActionIsDiscardable
Boolean value that indicates whether the next redo action is discardable. 次のやり直しアクションが利用できなくされるかどうかを指し示すブール値。

Constants 定数

NSUndoCloseGroupingRunLoopOrdering
NSUndoManager provides this constant as a convenience; you can use it to compare to values returned by some NSUndoManager methods. NSUndoManagerはこの定数をひとつの便宜として提供します；あなたは何らかのNSUndoManagerメソッドによって返される値と比較するのにそれを使用できます。
NSUndoManagerGroupIsDiscardableKey
The key has a corresponding value of YES, wrapped as a Boolean NSNumber object, if the undo group as a whole is discardable. キーはYESの対応する値を持ちます、ブールのNSNumberオブジェクトとしてラップされます、もし全体としてのundoグループが廃棄可能ならば。

Notifications 通知

NSUndoManagerCheckpointNotification
Posted whenever an NSUndoManager object opens or closes an undo group (except when it opens a top-level group) and when checking the redo stack in canRedo. NSUndoManagerオブジェクトがアンドゥグループを開くまたは閉じる時はいつでも（それがトップレベルグループを開くときを除いて）そしてやり直しスタックをcanRedoにおいて調べる時に投函されます。
NSUndoManagerDidOpenUndoGroupNotification
Posted whenever an NSUndoManager object opens an undo group, which occurs in the implementation of the beginUndoGrouping method. NSUndoManagerオブジェクトがアンドゥグループを開く時はいつでも投函されます、それはbeginUndoGroupingメソッドの実装において発生します。
NSUndoManagerDidRedoChangeNotification
Posted just after an NSUndoManager object performs a redo operation (redo). NSUndoManagerオブジェクトがリドゥ操作（redo）を実行する直後に投函されます。
NSUndoManagerDidUndoChangeNotification
Posted just after an NSUndoManager object performs an undo operation. NSUndoManagerオブジェクトがアンドゥ操作を実行する直後に投函されます。
NSUndoManagerWillCloseUndoGroupNotification
Posted before an NSUndoManager object closes an undo group, which occurs in the implementation of the endUndoGrouping method. NSUndoManagerオブジェクトがアンドゥグループを閉じる前に投函されます、それはendUndoGroupingメソッドの実装において発生します。
NSUndoManagerDidCloseUndoGroupNotification
Posted after an NSUndoManager object closes an undo group, which occurs in the implementation of the endUndoGrouping method. NSUndoManagerオブジェクトがアンドゥグループを閉じる後に投函されます、それはendUndoGroupingメソッドの実装において発生します。
NSUndoManagerWillRedoChangeNotification
Posted just before an NSUndoManager object performs a redo operation (redo). NSUndoManagerオブジェクトがやり直し操作（redo）を実行する直前に投函されます。
NSUndoManagerWillUndoChangeNotification
Posted just before an NSUndoManager object performs an undo operation. NSUndoManagerオブジェクトがアンドゥ操作を実行する直前に投函されます。

Relationships 関係

Inherits From 継承元