使用 NSUndoManager 来进行撤销和重做

作者:Tomasz Szulc,原文链接,原文日期:2015-09-13
译者:Yake;校对:numbbbbb;定稿:

在相当长的一段时间内 NSUndoManager 对我来说都是一个很神秘的东西。我想学习使用它,但是一直没有时间。一直到今天,我写了一个简单的应用,这个应用创建了一个可以移动的矩形,并且还可以修改矩形的属性,例如背景色或者圆角。

你可以在这儿获取到示例应用
这儿是一段小视频,你可以看看这个示例应用是怎么工作的。

Screen-Shot-2015-09-13-at-17.24.19.png
Screen-Shot-2015-09-13-at-17.24.19.png

NSUndoManager

NSUndoManager允许记录用户执行的操作并且反转这类操作。

当你调用一个可以改变一些东西的方法或者是执行一个改变属性值的动作(例如 setter 方法)时,你可以注册这个操作来进行撤销。

一个撤销操作包含了接收消息的对象,发送消息以及参数 - 通常你会传入原始值。

NSUndoManager实例支持重做操作,所以才能逆转操作。你可以认为这个管理器拥有两个栈。实际上,它管理两个栈,undo(撤销)栈和redo(重做)栈 - 对应NSUndoManager的私有属性_undoStack_redoStack,里面存储着一些操作。

注册undo操作时,它会被添加到undo栈中。当调用undo()方法时管理器就会进行撤销,执行栈中的操作并把这个操作移动到redo栈中,这样你就可以重做它。当你拥有多个undo操作时,按照逆序来撤销和重做这些操作。你肯定不会将操作直接注册到redo栈中,实际上这根本无法实现。

你可以为undo操作设置一个级别,这指的是一个管理器可以在它的栈中存储多少undo操作。如果添加的undo操作数量超过了这个级别,最早加入的那个操作将会从栈中移除。

你可以通过canUndocanRedo来检查undoredo栈的状态。这些状态很重要,你可能会基于这些栈的状态来更新 UI。

假设你已经设置了undo操作的级别并且redo栈中还有一个操作,如果undo操作超过了这个级别,那你就需要使用canUndocanRedo来检测可用性。之所以要这样做,是因为在这种情况下NSUndoManager将会移除redo操作,因为它是历史操作中最新的undo操作。(校对注:这里确实很绕,大家可以类比一下编辑器的撤销和重做操作,如果你在撤销之后进行了新的改动,那之前撤销过的操作其实已经无法再被重做了,因此可以被直接删掉,从而把更多的空间留给undo操作。)

注册undo操作

API提供了两种注册操作的方法。

第一种是使用registerUndoWithTarget(_:selector:object:)方法:

func registerUndoAddFigure(figure: FigureView) {
    undoManager.registerUndoWithTarget(self, selector: Selector(“removeFigure:”), object: figure)
    undoManager.setActionName(“Add Figure”)
}

第二种撤销方法是基于NSInvocation。你可以使用prepareWithInvocationTarget(_:)方法来注册此类操作。

func registerUndoAddFigure(figure: FigureView) {
    undoManager.prepareWithInvocationTarget(self).removeFigure(figure)
    undoManager.setActionName("Add Figure")
}

你将会得到一个NSUndoManagerProxy类型对象,可以用它调用任何方法(但是只能调用目标对象遵守的那些协议方法,否则应用会抛出运行时异常)。注册之后代理对象将会在内部创建NSInvocation对象来记录你的操作,这个对象会在传入的目标对象执行undo操作时被调用。

值得强调的是,在注册过程中目标对象没有被持有,需要你去管理它。如果undo操作被调用而目标对象已经被销毁,就会产生运行时异常。

当对象将要被销毁时你需要调用removeAllActionsWithTarget(_:)来移除与目标对象相关联的一些操作,或者调用removeAllActions()来移除undoredo栈中所有的操作

将操作分组

分组操作是一件很有用的事情。默认情况下操作是通过事件进行分组的。这就意味着操作将会通过每一轮运行时循环来分组。你可以关闭自动分组,调用beginUndoGrouping()endUndoGrouping()方法来手动操作分组。

命名并显示操作

NSUndoManager支持存储操作的名称。你可以调用setActionName(_:)方法来为操作命名。管理器已经包含UndoRedo这两个单词的多语言版本,可以使用 API 直接获取对应语言的Undo/Redo字符串。

下面这个方法来自示例应用,每一个新的undo操作被注册或者undo``redo操作被执行之后,将会更新undoredo按钮。

private func updateUndoAndRedoButtons() {
    undoButton.enabled = undoManager.canUndo == true
    if undoManager.canUndo {
        undoButton.setTitle(undoManager.undoMenuTitleForUndoActionName(undoManager.undoActionName), forState: .Normal)
    } else {
        undoButton.setTitle(undoManager.undoMenuItemTitle, forState: .Normal)
    }
    
    redoButton.enabled = undoManager.canRedo == true
    if undoManager.canRedo {
        redoButton.setTitle(undoManager.redoMenuTitleForUndoActionName(undoManager.redoActionName), forState: .Normal)
    } else {
        redoButton.setTitle(undoManager.redoMenuItemTitle, forState: .Normal)
    }
}

通知

管理器有几个你可以观察的通知类型。在示例应用中我关注的是NSUndoManagerDidUndoChangeNotificationNSUndoManagerDidRedoChangeNotification。为了让应用完美运行,我可能需要观察所有will或者did类型的通知,因为操作可能要执行一段时间,并且一部分代码可能是异步的。在这些情况下应用要正确展示 UI 就需要使用这些通知来刷新UndoRedo按钮。

上下文

应用在不同的上下文中可能有不同的管理器。示例应用在不同的上下文中用了两个管理器。

第一个上下文是块展板,展板用来展示矩形并且可以在上面移动这个矩形。在这个展板上下文中可能发生的操作就是添加、移动或者移除一个矩形。

第二个上下文是这个矩形自己。你可以改变它的颜色和圆角。我决定追踪展板的背景色以及圆角,忽略掉它在展板中的位置。

这样你就可以添加一个矩形,移动它,改变它的颜色和圆角,使用undo来撤销移动操作但是不会撤销掉背景色和圆角的改变。你所使用的上下文数量取决于你的应用是怎么样的。

响应链

每一个UIView对象继承自UIResponder类型,这个类定义了响应对象的接口并且处理事件。

UIResponder类声明了undoManager属性。当应用接收到undo事件,UIResponder搭建起响应者链并通过undoManager返回一个NSUndoManager类型的对象来找到这个响应者。找到的第一个响应者将被用来处理undo或者redo操作。

为了使用响应者链你需要重载canBecomeFirstResponder()属性并且设置返回值为true,然后通过调用becomeFirstResponder()方法使持有undoManager的对象成为第一响应者。如果你已经正确设置好了一切,可以执行一个摇晃手势,应用会出现一个警告框询问你是否要执行undo操作。

图片二.png
图片二.png

示例代码

当我写这个示例代码的时候我注意自己花费了很多时间去考虑“具有唯一目的”的方法。当你需要支持撤销和重做操作时这其实很重要,因为你调用那些方法就是出于特定的目的。

下面的示例代码来自那个示例应用,它展示了在展板中的添加,移除以及移动操作都是怎么实现的。下面是所有与undo manager相关的代码:

/// MARK: Actions on Figures
func addFigure(figure: FigureView) {
    registerUndoAddFigure(figure)
    
    boardView.addSubview(figure)
    figures.append(figure)
    
    updateUndoAndRedoButtons()
}
 
func removeFigure(figure: FigureView) {
    registerUndoRemoveFigure(figure)
    
    figure.removeFromSuperview()
    if let index = figures.indexOf(figure) {
        figures.removeAtIndex(index)
    }
}
 
func moveFigure(figure: FigureView, center: CGPoint) {
    registerUndoMoveFigure(figure)
    figure.center = center
}
 
/// MARK: Undo Manager
override func canBecomeFirstResponder() -> Bool {
    return true
}
 
private var _undoManager = NSUndoManager()
override var undoManager: NSUndoManager {
    return _undoManager
}
 
private func observeUndoManager() {
    NSNotificationCenter.defaultCenter().addObserver(self, selector: Selector("updateUndoAndRedoButtons"), name: NSUndoManagerDidUndoChangeNotification, object: undoManager)
    NSNotificationCenter.defaultCenter().addObserver(self, selector: Selector("updateUndoAndRedoButtons"), name: NSUndoManagerDidRedoChangeNotification, object: undoManager)
}
 
@objc private func updateUndoAndRedoButtons() {
    undoButton.enabled = undoManager.canUndo == true
    if undoManager.canUndo {
        undoButton.setTitle(undoManager.undoMenuTitleForUndoActionName(undoManager.undoActionName), forState: .Normal)
    } else {
        undoButton.setTitle(undoManager.undoMenuItemTitle, forState: .Normal)
    }
    
    redoButton.enabled = undoManager.canRedo == true
    if undoManager.canRedo {
        redoButton.setTitle(undoManager.redoMenuTitleForUndoActionName(undoManager.redoActionName), forState: .Normal)
    } else {
        redoButton.setTitle(undoManager.redoMenuItemTitle, forState: .Normal)
    }
}
 
/// MARK: Undo Manager Actions
func registerUndoAddFigure(figure: FigureView) {
    undoManager.prepareWithInvocationTarget(self).removeFigure(figure)
    undoManager.setActionName("Add Figure")
}
 
func registerUndoRemoveFigure(figure: FigureView) {
    undoManager.prepareWithInvocationTarget(self).addFigure(figure)
    undoManager.setActionName("Remove Figure")
}
 
func registerUndoMoveFigure(figure: FigureView) {
    undoManager.prepareWithInvocationTarget(self).moveFigure(figure, center: figure.center)
    undoManager.setActionName("Move to \(figure.center)")
}

我创建了一些undo相关的简单方法。这样做效果很好,注册undo操作的逻辑和操作本身的逻辑相分离,代码精简为一句函数调用。

我决定放弃使用registerUndoWithTarget(_:selector:object:)方法,因为Selector是一个字符串,这样做很危险。而prepareWithInvocationTarget(_:)看起来更好一些,既安全又便于使用。

不过,当你需要设置属性时可能要用带Selector的方法。

你需要直接调用想要记录的方法,但是这样做不能设置属性(因为只能调用方法)。有两种解决方法:第一种是添加类似setPropertyName(_:)的方法,第二种是使用registerUndoWithTarget(_:selector:object:)方法并将Selector设置为setPropertyName:,作为参数传入。

结论

NSUndoManager是一种强大的机制,我们可以简单地向应用中加入undoredo方法。它需要你谨慎地设计应用的结构,因为你需要使用“具有唯一目的性”的方法来将用户的操作设置为undo或者是redo。但是总体来说这是个好事,不是吗?这会改善代码设计。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容