iOS文档补完计划--UIControl

目录主要分为以下几个样式:
常用、会用、了解

目录

  • UIControl
  • Target-Action机制
    • Action的类型
    • Target-Action的管理
    • 触发识别流程
  • 基本属性
    • state
    • enabled
    • selected
    • highlighted
    • contentVerticalAlignment
    • contentHorizontalAlignment
    • effectiveContentHorizontalAlignment
  • Target && Action 操作
    • addTarget:action:forControlEvents:
    • removeTarget:action:forControlEvents:
    • actionsForTarget:forControlEvent:
    • allControlEvents
    • allTargets
  • 触发操作
    • sendAction:to:forEvent:
    • sendActionsForControlEvents:
  • 事件的跟踪
    • beginTrackingWithTouch:withEvent:
    • continueTrackingWithTouch:withEvent:
    • endTrackingWithTouch:withEvent:
    • cancelTrackingWithEvent:
    • tracking
    • touchInside
  • 参考资料

UIControl

UIContrl的子类可以实现按钮、滑块等元素、以对用户操作进行引导。并且使用Target-Action的机制报告用户的交互。

我们并不应该直接使用UIControl、而应该对其进行继承或直接使用其子类。
这样、我们就可以观察或修改其分发到target对象的行为消息

  1. 修改消息指向
- (void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event {
    //这里、可以修改时间分发的目标以及方法
    [super sendAction:action to:target forEvent:event];
}
  1. 观察
- (BOOL)beginTrackingWithTouch:(UITouch *)touch withEvent:(UIEvent *)event
- (BOOL)continueTrackingWithTouch:(UITouch *)touch withEvent:(UIEvent *)event
- (void)endTrackingWithTouch:(UITouch *)touch withEvent:(UIEvent *)event
- (void)cancelTrackingWithEvent:(UIEvent *)event

通过重写以上四个方法、可以观察开始、移动、结束、取消四个状态。

Target-Action机制

Target-action是一种设计模式，直译过来就是”目标-行为”。

这一段很多摘抄《UIControl 的基本使用方法和 Target-Action 机制》的内容、有兴趣可以跳转去看看。

当事件发生时，事件会被发送到控件对象中，然后再由这个控件对象去触发target对象上的action行为，来最终处理事件。因此，Target-Action机制由两部分组成：即目标对象和行为Selector。目标对象指定最终处理事件的对象，而行为Selector则是处理事件的方法。

  • Action的类型

在OC中、最多允许有两个参数。

- (IBAction)doSomething;
- (IBAction)doSomething:(id)sender;
- (IBAction)doSomething:(id)sender forEvent:(UIEvent*)event;
  • Target-Action的管理
iOS文档补完计划--UIControl-1

因此，UIControl内部实际上是有一个《可变数组(_targetActions)来保存Target-Action》，数组中的每个元素是一个UIControlTargetAction对象。UIControlTargetAction类是一个私有类，我们可以在iOS-Runtime-Header中找到它的头文件：

@interface UIControlTargetAction : NSObject {
    SEL _action;
    BOOL _cancelled;
    unsigned int _eventMask;
    id _target;
}
 
@property (nonatomic) BOOL cancelled;
 
- (void).cxx_destruct;
- (BOOL)cancelled;
- (void)setCancelled:(BOOL)arg1;
 
@end

可以看到UIControlTargetAction对象维护了一个Target-Action所必须的三要素，即target，action及对应的事件eventMask。

此外有两点需要注意:
  1. 这个成员变量对外部传进来的target对象是以weak的方式引用的
  2. 如果三要素相同，在_targetActions中并不会重复添加UIControlTargetAction对象。
  • 触发识别流程

这个文档和网上都没查到什么确切的答案。
但有一点可以肯定、Target&&Action依赖touchesBegan:withEvent:的调用。

至于super 实现中如何编写的、这个可能得看了源码才知道。我只是简单测试、以下是测试结果:

  1. 在super实现中的适当条件调用beginTrackingWithTouch修改了tracking属性以跟踪事件。
  2. 适当条件是其位于响应链顶端（似乎并不是仅仅根据UITouch参数中的view属性进行判断）。
  3. UITouch参数中的view属性是最终能否响应Target&&Action的决定因素

所以、当UIButton上add了一个UIView、UIButton的Action则不会被触发。(由于第二、三条)
不过、我们可以自己修改重载一下touchesBegan:withEvent:以达到最终的效果。

- (void)touchesBegan:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {   
    self.tracking = YES;
    touches.allObjects[0].view = self;
//    //其实他俩是一个touch
////    event.allTouches.allObjects[0].view = self;

    [super touchesBegan:touches withEvent:event];
}

//打印
-[View touchesBegan:withEvent:]
-[Button touchesBegan:withEvent:]
-[ViewController btnClick]

这样我们基本就对UIControl的机制能猜个八九不离十了：

  1. 事件开始、如果位于响应链最上端的VIew为UIControl并且注册了Target&&Action、则跟踪事件(self.tracking = YES;)。
    内部实现中如果self.tracking = YES;则截断响应链、并且持续跟踪。
  2. 事件结束、由Window向UITouch中的View属性发送touchesEnded:withEvent:消息
  3. 事件结束、由Window要求UIControl根据UITouch中的View属性决定谁来尝试响应Target&&Action。
    所谓尝试、意味着并不一定会响应。从测试来看、截断响应链的那个UIControl、必须与UITouch中的View属性相同才行。
  4. 最后。如果能够响应、最终将由UIApplication直接向Target发送Action。

基本属性

主要是UIControl的状态机制以及状态触发

  • state

控件的状态

@property(nonatomic, readonly) UIControlState state;
UIControlState是一个枚举类型
typedef NS_OPTIONS(NSUInteger, UIControlState) {
    UIControlStateNormal       = 0,  //默认状态
    UIControlStateHighlighted  = 1 << 0,                  // 当按住按钮不松开、或者用代码button.highlighted = YES时
    UIControlStateDisabled     = 1 << 1,  //button.enabled = NO时、此时无法接收点击事件
    UIControlStateSelected     = 1 << 2,  //button.selected = YES时
    UIControlStateFocused NS_ENUM_AVAILABLE_IOS(9_0) = 1 << 3, // 聚焦状态
    UIControlStateApplication  = 0x00FF0000,              // additional flags available for application use
    UIControlStateReserved     = 0xFF000000               // flags reserved for internal framework use
};

需要注意的是:

  1. 如果没有特别设置某些状态下的样式
    在该状态下会显示为UIControlStateNormal时的样式。
  2. 状态允许重叠、比如对高亮状态下的UIButton进行长按操作。
    在复合状态会下会显示为UIControlStateNormal时的样式。
    当然、这满足第一条。
  3. 允许对复合状态的样式进行设置
    你可以通过设置UIControlStateSelected|UIControlStateHighlighted的样式、来规避第二条的情况。
  • enabled

是否启用控件、默认YES。

@property(nonatomic, getter=isEnabled) BOOL enabled;

和userInteractionEnabled一样、都可以禁止该控件以及子视图的交互功能。
区别是UIControl的state会改变、可能会改变样式。

  • selected

控件是否处于选中状态、默认NO。

@property(nonatomic, getter=isSelected) BOOL selected;

影响UIControlStateSelected状态。
这个状态并不受用户行为影响。只能通过修改selected这个属性来更改。

  • highlighted

突出状态。默认NO

@property(nonatomic, getter=isHighlighted) BOOL highlighted;

影响UIControlStateHighlighted状态
这个状态受到用户行为影响。也可以通过highlighted来更改。

  • contentVerticalAlignment

内容的垂直对其方式

@property(nonatomic) UIControlContentVerticalAlignment contentVerticalAlignment;
  • contentHorizontalAlignment

内容的水平对其方式

@property(nonatomic) UIControlContentHorizontalAlignment contentHorizontalAlignment;
  • effectiveContentHorizontalAlignment

返回控件内容有效的水平对其方向

@property(nonatomic, readonly) UIControlContentHorizontalAlignment effectiveContentHorizontalAlignment;

这个属性总是包含值UIControlContentHorizontalAlignmentLeft或UIControlContentHorizontalAlignmentRight、并且不一定与contentHorizontalAlignment属性相同。

Target && Action 操作

控件的事件注册、删除查询等

  • - addTarget:action:forControlEvents:

为控件注册事件

- (void)addTarget:(id)target 
           action:(SEL)action 
 forControlEvents:(UIControlEvents)controlEvents;

target
目标对象。如果为nil、则UIKit会在响应链中一次搜索能够响应action的对象并将消息传递给该对象。
action
处理消息的方法选择器。不可为nil。
controlEvents
需要处理的事件类型、为UIControlEvents类型的枚举。
比如UIButton常用UIControlEventTouchDragOutside、UITextView常用UIControlEventEditingDidEnd

文档中还提到一下几点
  1. 你可以多次调用该方法来为控件配置多个事件
  2. 重复添加一个Target-Action只会被调用一次
  3. 控件不会对target进行强引用
  • - removeTarget:action:forControlEvents:

为控件删除某个事件

- (void)removeTarget:(id)target 
              action:(SEL)action 
    forControlEvents:(UIControlEvents)controlEvents;

参数的含义和addTarget一样

文档中也有一些说明
  1. 如果target为nil、将会移除所有target的所有action。
    但是controlEvents参数必须一致。比如remove:UIControlEventTouchDown并不能删除UIControlEventTouchUpInside]的事件。
[btn removeTarget:nil action:nil forControlEvents:UIControlEventTouchUpInside];
  • - actionsForTarget:forControlEvent:

返回指定target某个event下所注册的action(字符串)数组

- (NSArray<NSString *> *)actionsForTarget:(id)target 
                          forControlEvent:(UIControlEvents)controlEvent;

target参数不可为nil

  • allControlEvents

返回控件被注册的事件类型

@property(nonatomic, readonly) UIControlEvents allControlEvents;

返回值是一个常量的位掩码。你可以这样来判断

[btn allControlEvents]&UIControlEventTouchUpInside
[btn allControlEvents]&UIControlEventTouchCancel
  • allTargets

返回所有注册的target

@property(nonatomic, readonly) NSSet *allTargets;

返回的NSSet中可能包含NSNull、以指示将查询响应链上的对象。

触发操作

  • - sendAction:to:forEvent:

调用指定target的action

- (void)sendAction:(SEL)action 
                to:(id)target 
          forEvent:(UIEvent *)event;

这是UIControl中Target-Action机制的倒数第二步、具体的步骤可以参考《iOS基础补完计划--透过堆栈看事件响应机制》。下一步、会由UIApplication直接向target对象发送action消息。

  1. 如果我们不指定Event、那么将会调用多有注册了的Target-Action

  2. 如果我们没有指定target、则会将事件分发到响应链上第一个想处理消息的对象上。不过这个响应链、是从自身开始。与最初的响应链有可能不同。

* thread #1, queue = 'com.apple.main-thread', stop reason = breakpoint 2.1
* frame #0: 0x000000010439210d NSObject`-[View2 btnClick:event:](self=0x00007f89ac428c20, _cmd="btnClick:event:", sender=0x00007f89ac4021d0, event=0x000060000011d9a0) at View2.m:21
frame #1: 0x0000000105a7e3e8 UIKit`-[UIApplication sendAction:to:from:forEvent:] + 83
frame #2: 0x0000000105bf97a4 UIKit`-[UIControl sendAction:to:forEvent:] + 67
frame #3: 0x00000001043921d7 NSObject`-[View1 sendAction:to:forEvent:](self=0x00007f89ac4021d0, _cmd="sendAction:to:forEvent:", action="btnClick:event:", target=0x00007f89ac510260, event=0x000060000011d9a0) at View1.m:23
frame #4: 0x0000000105bf9ac1 UIKit`-[UIControl _sendActionsForEvents:withEvent:] + 450
frame #5: 0x0000000105bf8a09 UIKit`-[UIControl touchesEnded:withEvent:] + 580
frame #6: 0x0000000105af30bf UIKit`-[UIWindow _sendTouchesForEvent:] + 2729
frame #7: 0x0000000105af47c1 UIKit`-[UIWindow sendEvent:] + 4086
frame #8: 0x0000000105a98310 UIKit`-[UIApplication sendEvent:] + 352
frame #9: 0x00000001063d96af UIKit`__dispatchPreprocessedEventFromEventQueue + 2796
frame #10: 0x00000001063dc2c4 UIKit`__handleEventQueueInternal + 5949
frame #11: 0x00000001055a2bb1 CoreFoundation`__CFRUNLOOP_IS_CALLING_OUT_TO_A_SOURCE0_PERFORM_FUNCTION__ + 17
frame #12: 0x00000001055874af CoreFoundation`__CFRunLoopDoSources0 + 271
frame #13: 0x0000000105586a6f CoreFoundation`__CFRunLoopRun + 1263
frame #14: 0x000000010558630b CoreFoundation`CFRunLoopRunSpecific + 635
frame #15: 0x000000010a773a73 GraphicsServices`GSEventRunModal + 62
frame #16: 0x0000000105a7d057 UIKit`UIApplicationMain + 159
frame #17: 0x0000000104391fdf NSObject`main(argc=1, argv=0x00007ffeeb86f028) at main.m:14
frame #18: 0x000000010905d955 libdyld.dylib`start + 1
frame #19: 0x000000010905d955 libdyld.dylib`start + 1

从堆栈上来看。在View1返回tager为nil后、UIControl又重新从响应链中取出下一个能够响应Action的View2然后由UIApplication对其发送信息。
注意、这里的View2并不限于UIControl、任何实现了指定Action的对象均可。

  • - sendActionsForControlEvents:

强制调用指定Event事件相关的Target-Aciton

- (void)sendActionsForControlEvents:(UIControlEvents)controlEvents;

该方法遍历控件的Targets和Actions，并为由UIApplication(通过_sendActionsForEvents方法)向每个与controlEvents事件相关联的Targets调用sendAction:to:forEvent:方法。

事件的跟踪

开始、移动、结束、取消四种状态的获取。
底层方法与各种UIControlEvents的触发息息相关。

你可以帮他当成touchesBegan等等一系列方法来用。但是从规范上来讲、更多的是是否处理某个事件。

  • - beginTrackingWithTouch:withEvent:

决定控件是否继续跟踪触摸事件。默认YES、NO则丢弃事件。

- (BOOL)beginTrackingWithTouch:(UITouch *)touch 
                     withEvent:(UIEvent *)event;

此值用于更新控件的跟踪属性tracking。

  1. 返回NO会直接丢弃事件
    如果你想让下方的另一个对象尝试响应。
    可以返回YES并重载- sendAction:to:forEvent:并将target参数设置为nil。
  2. 依赖于touchesBegan:withEvent:
    这里需要注意。super touchesBegan:withEvent的调用是充分条件、而不是充要条件。不然UIView的覆盖、就不会影响到下方UIButton的点击效果了。
    具体原因可以返回去看《UIControl-->触发识别流程》
  3. 触发的事件类型
    UIControlEventTouchDown

使用的话、比如我们可以让某些情况下(范围、事件等等)UIControl不去响应事件。

  • - continueTrackingWithTouch:withEvent:

触摸事件更新时调用。默认YES、NO则丢弃事件

- (BOOL)continueTrackingWithTouch:(UITouch *)touch 
                        withEvent:(UIEvent *)event;

这个continue、指的是touch更新、也就是移动吧。
返回值同样会影响tracking属性。

  1. 返回NO会直接丢弃事件
    注意高亮状态的恢复也会被丢弃

  2. 依赖于touchesMoved:withEvent:

  3. 触发的事件类型
    UIControlEventTouchDragInside、UIControlEventTouchDragOutside、UIControlEventTouchDragEnter、UIControlEventTouchDragExit

  • - endTrackingWithTouch:withEvent:

触摸事件结束时调用

- (void)endTrackingWithTouch:(UITouch *)touch 
                   withEvent:(UIEvent *)event;

  1. 依赖于touchesEnded:withEvent:
    内部会将tracking属性从YES修改成NO、所以请务必调用super实现。

  2. 触发的事件类型
    UIControlEventTouchUpInside、UIControlEventTouchUpOutside

  • - cancelTrackingWithEvent:

触摸事件被取消时调用

- (void)cancelTrackingWithEvent:(UIEvent *)event;
  1. 依赖于touchesCanceled:withEvent:
    请务必调用super实现
  2. 触发的事件类型
    UIControlEventTouchCancel
  • tracking

控件当前是否正在跟踪触摸事件

@property(nonatomic, readonly, getter=isTracking) BOOL tracking;

我们可以发现当我们的触摸点沿着屏幕移出控件区域名，还是会继续追踪触摸操作，cancelTrackingWithEvent:消息并未被发送。

  • touchInside

指示被跟踪的触摸事件当前是否在控件的范围内

@property(nonatomic, readonly, getter=isTouchInside) BOOL touchInside;

进入或退出控件的触摸事件触发适当的拖动事件就依赖这个值。

为了判断当前触摸点是否在控件区域类，可以使用touchInside属性，这是个只读属性。不过实测的结果是，在控件区域周边一定范围内，该值还是会被标记为YES，即用于判定touchInside为YES的区域会比控件区域要大。

最后

本文主要是自己的学习与总结。如果文内存在纰漏、万望留言斧正。如果愿意补充以及不吝赐教小弟会更加感激。

参考资料

官方文档--UIControl
UIControl 的基本使用方法和 Target-Action 机制
UIButton基本状态及各种叠加状态详解
完美解决UIButton拖动响应事件距离问题

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,839评论 6赞 482
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,543评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 153,116评论 0赞 344
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,371评论 1赞 279
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,384评论 5赞 374
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,111评论 1赞 285
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,416评论 3赞 400
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,053评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,558评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2赞 325
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1赞 334
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,756评论 4赞 324
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,324评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1赞 262
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2赞 355
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2赞 345