美文网首页iOS 艾欧艾斯
iOS-UIResponder官方API总结

iOS-UIResponder官方API总结

作者: 你好自己 | 来源:发表于2016-08-15 10:49 被阅读383次

    本篇包括2部分:前篇是UIResponder的官方API的记录,后篇是对官方API的理解

    UIResponder概念

    Root类NSObject相比,其多出的特性是,可以响应和处理事件.iOS 的事件分为Touch(触摸)事件,Motion(移动)事件 以及 Remote Control(远程控制)事件。每个事件对应不同的触发操作。

    • 触摸事件: 顾名思义,就是用户用手指触摸屏幕引发的事件。
    • 移动事件: 移动事件对应真实的物理操作事件,比如用户甩动手机,进行的”摇一摇”操作。
    • 远程控制事件: 这种事件对应一些系统操作,比如我们在使用系统播放器播放视频的时候,视频的开始与暂停这类操作。

    Managing the Responder Chain

    - nextResponder
    - isFirstResponder
    - canBecomeFirstResponder
    - becomeFirstResponder
    - canResignFirstResponder
    - resignFirstResponder
    
    

    Managing Input Views

    inputView   //Property
    inputViewController  //Property
    inputAccessoryView  //Property
    inputAccessoryViewController  //Property
    - reloadInputViews
    
    

    Responding to Touch Events

    - touchesBegan:withEvent:
    - touchesMoved:withEvent:
    - touchesEnded:withEvent:
    - touchesCancelled:withEvent:
    - touchesEstimatedPropertiesUpdated:
    
    

    Responding to Motion Events

    - motionBegan:withEvent:
    - motionEnded:withEvent:
    - motionCancelled:withEvent:
    
    

    Responding to Press Events

    - pressesBegan:withEvent:
    - pressesCancelled:withEvent:
    - pressesChanged:withEvent:
    - pressesEnded:withEvent:
    
    

    Responding to Remote-Control Events

    - remoteControlReceivedWithEvent:
    
    

    Getting the Undo Manager

    undoManager  //Property
    
    

    Validating Commands

    - canPerformAction:withSender:
    - targetForAction:withSender:
    

    Accessing the Available Key Commands

    keyCommands  //Property
    
    

    Managing the Text Input Mode

    textInputMode  //Property
    textInputContextIdentifier //Property
    + clearTextInputContextIdentifier:
    inputAssistantItem  // Property
    
    

    Supporting User Activities

    userActivity //Property
    - restoreUserActivityState:
    - updateUserActivityState:
    
    

    第二部分

    一 概述

    App与用户进行交互,基本上是依赖于各种各样的事件。例如,用户点击界面上的按钮,我们需要触发一个按钮点击事件,并进行相应的处理,以给用户一个响应。比如UIView能够处理事件,其本身就是一个事件响应者,可以处理点击等事件,而这些事件就是在UIResponder类中定义的。

    一个UIResponder类为那些需要响应并处理事件的对象定义了一组接口。这些事件主要分为三类:触摸事件(touch events)运动事件(motion events)远程控制事件UIResponder类为每类事件都定义了一组接口,这个我们将在下面详细描述。

    在UIKit中,UIApplication、UIView、UIViewController这几个类都是直接继承自UIResponder类。另外SpriteKit中的SKNode也是继承自UIResponder类。因此UIKit中的视图、控件、视图控制器,以及我们自定义的视图及视图控制器都有响应事件的能力。

    二 响应链

    本文将详细介绍一个UIResponder类提供的基本功能。不过在此之前,我们先来了解一下事件响应链机制。

    响应链

    大多数事件的分发都是依赖响应链的。响应链是由一系列链接在一起的响应者组成的。一般情况下,一条响应链开始于第一响应者,结束于application对象。如果一个响应者不能处理事件,则会将事件沿着响应链传到下一响应者。

    那这里就会有三个问题:

    • 响应链是何时构建的
    • 系统是如何确定第一响应者的
    • 确定第一响应者后,系统又是按照什么样的顺序来传递事件的

    构建响应链

    我们都知道在一个App中,所有视图是按一定的结构组织起来的,即树状层次结构。除了根视图外,每个视图都有一个父视图;而每个视图都可以有0个或多个子视图。而在这个树状结构构建的同时,也构建了一条条的事件响应链。

    确定第一响应者

    当用户触发某一事件(触摸事件或运动事件)后,UIKit会创建一个事件对象(UIEvent),该对象包含一些处理事件所需要的信息。然后事件对象被放到一个事件队列中。这些事件按照先进先出的顺序来处理。当处理事件时,程序的UIApplication对象会从队列头部取出一个事件对象,将其分发出去。通常首先是将事件分发给程序的主window对象,对于触摸事件来讲,window对象会首先尝试将事件分发给触摸事件发生的那个视图上。这一视图通常被称为hit-test视图,而查找这一视图的过程就叫做hit-testing

    系统使用hit-testing来找到触摸下的视图,它检测一个触摸事件是否发生在相应视图对象的边界之内(即视图的frame属性,这也是为什么子视图如果在父视图的frame之外时,是无法响应事件的)。如果在,则会递归检测其所有的子视图。包含触摸点的视图层次架构中最底层的视图就是hit-test视图。在检测出hit-test视图后,系统就将事件发送给这个视图来进行处理。

    我们通过一个示例来演示hit-testing的过程。图1是一个视图层次结构,

    图3

    与inputView相关的属性有如下两个,

    @property(nonatomic, readonly, retain) UIView *inputView
    @property(nonatomic, readonly, retain) UIInputViewController *inputViewController
    

    这两个属性提供一个视图(或视图控制器)用于替代为UITextField和UITextView弹出的系统键盘。我们可以在子类中将这两个属性重新定义为读写属性来设置这个属性。如果我们需要自己写一个键盘的,如为输入框定义一个用于输入身份证的键盘(只包含0-9和X),则可以使用这两个属性来获取这个键盘。

    与inputView类似,inputAccessoryView也有两个相关的属性:

    @property(nonatomic, readonly, retain) UIView *inputAccessoryView
    @property(nonatomic, readonly, retain) UIInputViewController *inputAccessoryViewController
    

    设置方法与前面相同,都是在子类中重新定义为可读写属性,以设置这个属性。

    另外,UIResponder还提供了以下方法,在对象是第一响应者时更新输入和访问视图,

    - (void)reloadInputViews
    

    调用这个方法时,视图会立即被替换,即不会有动画之类的过渡。如果当前对象不是第一响应者,则该方法是无效的。

    五 响应触摸事件

    UIResponder提供了如下四个大家都非常熟悉的方法来响应触摸事件:

    // 当一个或多个手指触摸到一个视图或窗口
    - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
    // 当与事件相关的一个或多个手指在视图或窗口上移动时
    - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event
    // 当一个或多个手指从视图或窗口上抬起时
    - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event
    // 当一个系统事件取消一个触摸事件时
    - (void)touchesCancelled:(NSSet *)touches withEvent:(UIEvent *)event
    

    这四个方法默认都是什么都不做。不过,UIKit中UIResponder的子类,尤其是UIView,这几个方法的实现都会把消息传递到响应链上。因此,为了不阻断响应链,我们的子类在重写时需要调用父类的相应方法;而不要将消息直接发送给下一响应者。

    默认情况下,多点触摸是被禁用的。为了接受多点触摸事件,我们需要设置响应视图的multipleTouchEnabled属性为YES。

    六 响应移动事件

    与触摸事件类似,UIResponder也提供了几个方法来响应移动事件:

    // 移动事件开始
    - (void)motionBegan:(UIEventSubtype)motion withEvent:(UIEvent *)event
    // 移动事件结束
    - (void)motionEnded:(UIEventSubtype)motion withEvent:(UIEvent *)event
    // 取消移动事件
    - (void)motionCancelled:(UIEventSubtype)motion withEvent:(UIEvent *)event
    

    与触摸事件不同的是,运动事件只有开始与结束操作;它不会报告类似于晃动这样的事件。这几个方法的默认操作也是什么都不做。不过,UIKit中UIResponder的子类,尤其是UIView,这几个方法的实现都会把消息传递到响应链上。

    七 响应远程控制事件

    远程控制事件来源于一些外部的配件,如耳机等。用户可以通过耳机来控制视频或音频的播放。接收响应者对象需要检查事件的子类型来确定命令(如播放,子类型为UIEventSubtypeRemoteControlPlay),然后进行相应处理。

    为了响应远程控制事件,UIResponder提供了以下方法,

    - (void)remoteControlReceivedWithEvent:(UIEvent *)event
    

    我们可以在子类中实现该方法,来处理远程控制事件。不过,为了允许分发远程控制事件,我们必须调用UIApplication的beginReceivingRemoteControlEvents方法;而如果要关闭远程控制事件的分发,则调用endReceivingRemoteControlEvents方法。

    八 获取Undo管理器

    默认情况下,程序的每一个window都有一个undo管理器,它是一个用于管理undo和redo操作的共享对象。然而,响应链上的任何对象的类都可以有自定义undo管理器。例如,UITextField的实例的自定义管理器在文件输入框放弃第一响应者状态时会被清理掉。当需要一个undo管理器时,请求会沿着响应链传递,然后UIWindow对象会返回一个可用的实例。

    UIResponder提供了一个只读方法来获取响应链中共享的undo管理器,

    @property(nonatomic, readonly) NSUndoManager *undoManager
    我们可以在自己的视图控制器中添加undo管理器来执行其对应的视图的undo和redo操作。
    

    九 验证命令

    在我们的应用中,经常会处理各种菜单命令,如文本输入框的”复制”、”粘贴”等。UIResponder为此提供了两个方法来支持此类操作。首先使用以下方法可以启动或禁用指定的命令:

    - (BOOL)canPerformAction:(SEL)action withSender:(id)sender
    

    该方法默认返回YES,我们的类可以通过某种途径处理这个命令,包括类本身或者其下一个响应者。子类可以重写这个方法来开启菜单命令。例如,如果我们希望菜单支持”Copy“而不支持”Paser“,则在我们的子类中实现该方法。需要注意的是,即使在子类中禁用某个命令,在响应链上的其它响应者也可能会处理这些命令。

    另外,我们可以使用以下方法来获取可以响应某一行为的接收者:

    - (id)targetForAction:(SEL)action withSender:(id)sender
    

    在对象需要调用一个action操作时调用该方法。默认的实现是调用canPerformAction:withSender:方法来确定对象是否可以调用action操作。如果可以,则返回对象本身,否则将请求传递到响应链上。如果我们想要重写目标的选择方式,则应该重写这个方法。下面这段代码演示了一个文本输入域禁用拷贝/粘贴操作:

    - (id)targetForAction:(SEL)action withSender:(id)sender
    {
        UIMenuController *menuController = [UIMenuController sharedMenuController];
        if (action == @selector(selectAll:) || action == @selector(paste:) ||action == @selector(copy:) || action == @selector(cut:)) {
            if (menuController) {
                [UIMenuController sharedMenuController].menuVisible = NO;
            }
            return nil;
        }
        return [super targetForAction:action withSender:sender];
    }
    

    十 访问快捷键命令

    我们的应用可以支持外部设备,包括外部键盘。在使用外部键盘时,使用快捷键可以大大提高我们的输入效率。因此从iOS7后,UIResponder类新增了一个只读属性keyCommands,来定义一个响应者支持的快捷键,其声明如下:

    @property(nonatomic, readonly) NSArray *keyCommands
    

    一个支持硬件键盘命令的响应者对象可以重新定义这个方法并使用它来返回一个其所支持快捷键对象(UIKeyCommand)的数组。每一个快捷键命令表示识别的键盘序列及响应者的操作方法。

    我们用这个方法返回的快捷键命令数组被用于整个响应链。当与快捷键命令对象匹配的快捷键被按下时,UIKit会沿着响应链查找实现了响应行为方法的对象。它调用找到的第一个对象的方法并停止事件的处理。

    十一 管理文本输入模式

    文本输入模式标识当响应者激活时的语言及显示的键盘。UIResponder为此定义了一个属性来返回响应者对象的文本输入模式:

    @property(nonatomic, readonly, retain) UITextInputMode *textInputMode
    

    对于响应者而言,系统通常显示一个基于用户语言设置的键盘。我们可以重新定义这个属性,并让它返回一个不同的文本输入模式,以让我们的响应者使用一个特定的键盘。用户在响应者被激活时仍然可以改变键盘,在切换到另一个响应者时,可以再恢复到指定的键盘。

    如果我们想让UIKit来跟踪这个响应者的文本输入模式,我们可以通过textInputContextIdentifier属性来设置一个标识,该属性的声明如下:

    @property(nonatomic, readonly, retain) NSString *textInputContextIdentifier
    

    该标识指明响应者应保留文本输入模式的信息。在跟踪模式下,任何对文本输入模式的修改都会记录下来,当响应者激活时再用于恢复处理。

    为了从程序的user default中清理输入模式信息,UIResponder定义了一个类方法,其声明如下:

    + (void)clearTextInputContextIdentifier:(NSString *)identifier
    

    调用这个方法可以从程序的user default中移除与指定标识相关的所有文本输入模式。移除这些信息会让响应者重新使用默认的文本输入模式。

    十二 支持User Activities

    从iOS 8起,苹果为我们提供了一个非常棒的功能,即Handoff。使用这一功能,我们可以在一部iOS设备的某个应用上开始做一件事,然后在另一台iOS设备上继续做这件事。Handoff的基本思想是用户在一个应用里所做的任何操作都可以看作是一个Activity,一个Activity可以和一个特定iCloud用户的多台设备关联起来。在编写一个支持Handoff的应用时,会有以下三个交互事件:

    • 为将在另一台设备上继续做的事创建一个新的User Activity;
    • 当需要时,用新的数据更新已有的User Activity;
    • 把一个User Activity传递到另一台设备上。

    为了支持这些交互事件,在iOS 8后,UIResponder类新增了几个方法,我们在此不讨论这几个方法的实际使用,想了解更多的话,可以参考iOS 8 Handoff 开发指南。我们在此只是简单描述一下这几个方法。

    在UIResponder中,已经为我们提供了一个userActivity属性,它是一个NSUserActivity对象。因此我们在UIResponder的子类中不需要再去声明一个userActivity属性,直接使用它就行。其声明如下:

    @property(nonatomic, retain) NSUserActivity *userActivity
    

    由UIKit管理的User Activities会在适当的时间自动保存。一般情况下,我们可以重写UIResponder类的updateUserActivityState:方法来延迟添加表示User Activity的状态数据。当我们不再需要一个User Activity时,我们可以设置userActivity属性为nil。任何由UIKit管理的NSUserActivity对象,如果它没有相关的响应者,则会自动失效。

    另外,多个响应者可以共享一个NSUserActivity实例。

    上面提到的updateUserActivityState:是用于更新给定的User Activity的状态。其定义如下:

    - (void)updateUserActivityState:(NSUserActivity *)activity
    

    子类可以重写这个方法来按照我们的需要更新给定的User Activity。我们需要使用NSUserActivity对象的addUserInfoEntriesFromDictionary:方法来添加表示用户Activity的状态。

    在我们修改了User Activity的状态后,如果想将其恢复到某个状态,则可以使用以下方法:

    - (void)restoreUserActivityState:(NSUserActivity *)activity
    

    子类可以重写这个方法来使用给定User Activity的恢复响应者的状态。系统会在接收到数据时,将数据传递给application:continueUserActivity:restorationHandler:以做处理。我们重写时应该使用存储在user activity的userInfo字典中的状态数据来恢复对象。当然,我们也可以直接调用这个方法。

    参考:南峰子的技术博客

    相关文章

      网友评论

        本文标题:iOS-UIResponder官方API总结

        本文链接:https://www.haomeiwen.com/subject/wvrusttx.html