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對象的行爲消息

修改消息指向

- (void)sendAction:(SEL)action to:(id)target forEvent:(UIEvent *)event {
    //這裏、可以修改時間分發的目標以及方法
    [super sendAction:action to:target forEvent:event];
}

觀察

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

此外有兩點需要注意:

這個成員變量對外部傳進來的target對象是以weak的方式引用的
如果三要素相同，在_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
};

需要注意的是:

如果沒有特別設置某些狀態下的樣式
在該狀態下會顯示爲UIControlStateNormal時的樣式。
狀態允許重疊、比如對高亮狀態下的UIButton進行長按操作。
在複合狀態會下會顯示爲UIControlStateNormal時的樣式。
當然、這滿足第一條。
允許對複合狀態的樣式進行設置
你可以通過設置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

文檔中還提到一下幾點

你可以多次調用該方法來爲控件配置多個事件
重複添加一個Target-Action只會被調用一次
控件不會對target進行強引用

- removeTarget:action:forControlEvents:

爲控件刪除某個事件

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

參數的含義和addTarget一樣

文檔中也有一些說明

如果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消息。

如果我們不指定Event、那麼將會調用多有註冊了的Target-Action
如果我們沒有指定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。

返回NO會直接丟棄事件
如果你想讓下方的另一個UIControl嘗試響應、可以重載- sendAction:to:forEvent:並將target參數設置爲nil。
依賴於touchesBegan:withEvent:
觸發的事件類型
UIControlEventTouchDown

使用的話、比如我們可以讓某些情況下(範圍、事件等等)UIControl不去響應事件。

- continueTrackingWithTouch:withEvent:

觸摸事件更新時調用。默認YES、NO則丟棄事件

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

這個continue、指的是touch更新、也就是移動吧。
返回值同樣會影響tracking屬性。

返回NO會直接丟棄事件
注意高亮狀態的恢復也會被丟棄
依賴於touchesMoved:withEvent:
觸發的事件類型
UIControlEventTouchDragInside、UIControlEventTouchDragOutside、UIControlEventTouchDragEnter、UIControlEventTouchDragExit

- endTrackingWithTouch:withEvent:

觸摸事件結束時調用

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

依賴於touchesEnded:withEvent:
內部會將tracking屬性從YES修改成NO、所以請務必調用super實現。
觸發的事件類型
UIControlEventTouchUpInside、UIControlEventTouchUpOutside

- cancelTrackingWithEvent:

觸摸事件被取消時調用

- (void)cancelTrackingWithEvent:(UIEvent *)event;

依賴於touchesCanceled:withEvent:
請務必調用super實現
觸發的事件類型
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拖動響應事件距離問題

iOS文檔補完計劃--UIControl

UIControl

Target-Action機制

Action的類型

Target-Action的管理

此外有兩點需要注意:

基本屬性

state

UIControlState是一個枚舉類型

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

參考資料