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];
}

2. 观察

- (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对象。

---

基本属性

主要是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会直接丢弃事件
   如果你想让下方的另一个UIControl尝试响应、可以重载- sendAction:to:forEvent:并将target参数设置为nil。
2. 依赖于touchesBegan:withEvent:
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拖动响应事件距离问题