Class

UndoManager

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

Declaration 宣言 

class UndoManager : 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, UndoManager saves the operations you reverted to so that you can call redo() automatically. あなたがある取り消し操作を登録した後、あなたはundo()をアンドゥマネージャ上で呼び出して、最後の取り消し操作の状態に戻すことができます。ある動作を取り消している時、UndoManagerはあなたが戻した操作それらを保存します、それであなたはredo()を自動的に呼び出せます。

UndoManager 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. UndoManager 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. UndoManagerは、概してUI相互作用でのアプリによって使われます。例えば、UIKitは取り消しとやり直しをそれのテキストビューオブジェクトにおいて実装して、あなたがレスポンダチェーンに沿ってオブジェクトにおける動作の取り消しとやり直しをやりやすくしています。UndoManagerはまた、一般的用途の状態マネージャとして役立ちます、それは多くの種類の動作の取り消しとやり直しに使用できます。例えば、ある対話式コマンドラインユーティリティはこのクラスを使って最後のコマンド実行を取り消すことができます、またネットワークライブラリはリクエストを、以前のものを無効にする別のリクエストを送信することによって取り消せます。

Topics 話題

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

func registerUndo<TargetType>(withTarget: TargetType, handler: (TargetType) -> Void)
Registers the specified closure to implement a single undo operation that the target receives. 指定されたクロージャを登録して、レシーバを対象とする単一の取り消し操作を実装します。
func registerUndo(withTarget: Any, selector: Selector, object: Any?)
Registers the selector of the specified target to implement a single undo operation that the target receives. 指定目標のセレクタを登録することで、レシーバを目標とするある単一の取り消し操作を実装します。
func prepare(withInvocationTarget: Any) -> Any
Prepares the undo manager for invocation-based undo with the given target as the subject of the next undo operation. この与えられた目標物を次の取り消し操作の主題として、発動に基づく取り消しに対してアンドゥマネージャを用意します。

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

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

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

func undo()
Closes the top-level undo group if necessary and invokes undoNestedGroup(). トップレベル取り消しグループを必要ならば閉じます、そしてundoNestedGroup()を発動します。
func 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. 最後の取り消しグループにおける取り消し操作それらを実行します（トップレベルであろうと入れ子であろうと）、やり直しスタック上の操作を単一グループとして記録しています。
func 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 取り消しスタックを制限する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Constants 定数

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

Notifications 通知

static let NSUndoManagerCheckpoint: NSNotification.Name
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において調べる時に投函されます。
static let NSUndoManagerDidOpenUndoGroup: NSNotification.Name
Posted whenever an NSUndoManager object opens an undo group, which occurs in the implementation of the beginUndoGrouping() method. NSUndoManagerオブジェクトがアンドゥグループを開く時はいつでも投函されます、それはbeginUndoGrouping()メソッドの実装において発生します。
static let NSUndoManagerDidRedoChange: NSNotification.Name
Posted just after an NSUndoManager object performs a redo operation (redo()). NSUndoManagerオブジェクトがリドゥ操作（redo()）を実行する直後に投函されます。
static let NSUndoManagerDidUndoChange: NSNotification.Name
Posted just after an NSUndoManager object performs an undo operation. NSUndoManagerオブジェクトがアンドゥ操作を実行する直後に投函されます。
static let NSUndoManagerWillCloseUndoGroup: NSNotification.Name
Posted before an NSUndoManager object closes an undo group, which occurs in the implementation of the endUndoGrouping() method. NSUndoManagerオブジェクトがアンドゥグループを閉じる前に投函されます、それはendUndoGrouping()メソッドの実装において発生します。
static let NSUndoManagerDidCloseUndoGroup: NSNotification.Name
Posted after an NSUndoManager object closes an undo group, which occurs in the implementation of the endUndoGrouping() method. NSUndoManagerオブジェクトがアンドゥグループを閉じる後に投函されます、それはendUndoGrouping()メソッドの実装において発生します。
static let NSUndoManagerWillRedoChange: NSNotification.Name
Posted just before an NSUndoManager object performs a redo operation (redo()). NSUndoManagerオブジェクトがやり直し操作（redo()）を実行する直前に投函されます。
static let NSUndoManagerWillUndoChange: NSNotification.Name
Posted just before an NSUndoManager object performs an undo operation. NSUndoManagerオブジェクトがアンドゥ操作を実行する直前に投函されます。

Relationships 関係

Inherits From 継承元