UIResponder.h

NS_ASSUME_NONNULL_BEGIN

@class UIPress;

@class UIPressesEvent;

@protocol UIResponderStandardEditActions<NSObject>

@optional

//剪下

- (void)cut:(nullableid)senderNS_AVAILABLE_IOS(3_0);

//複製

- (void)copy:(nullableid)senderNS_AVAILABLE_IOS(3_0);

//貼上

- (void)paste:(nullableid)senderNS_AVAILABLE_IOS(3

//選擇

- (void)select:(nullableid)senderNS_AVAILABLE_IOS(3_0);

//全選

- (void)selectAll:(nullableid)senderNS_AVAILABLE_IOS(3_0);

//刪除

- (void)delete:(nullableid)senderNS_AVAILABLE_IOS(3_2);

//從左到右寫入字串(居左)

- (void)makeTextWritingDirectionLeftToRight:(nullableid)senderNS_AVAILABLE_IOS(5_0);

//從右到左寫入字串(居右)

- (void)makeTextWritingDirectionRightToLeft:(nullable

//切換字型為黑體(粗體)

- (void)toggleBoldface:(nullableid)senderNS_AVAILABLE_IOS(6_0);

//切換字型為斜體

- (void)toggleItalics:(nullableid)senderNS_AVAILABLE_IOS(6_0);

//給文字新增下劃線

- (void)toggleUnderline:(nullableid)senderNS_AVAILABLE_IOS(6_0);

//增加字型大小

- (void)increaseSize:(nullableid)senderNS_AVAILABLE_IOS(7

//減小字型大小

- (void)decreaseSize:(nullableid)senderNS_AVAILABLE_IOS(7_0);

@end

@interface UIResponder : NSObject<UIResponderStandardEditActions>

#ifUIKIT_DEFINE_AS_PROPERTIES

//下一個響應者

@property(nonatomic,readonly, nullable) UIResponder*nextResponder;

#else

//返回接收下一個響應者，或者nil如果它有沒有。

- (nullableUIResponder*)nextResponder;

#endif

#ifUIKIT_DEFINE_AS_PROPERTIES

//是否可以成為第一個響應者

@property(nonatomic,readonly) BOOLcanBecomeFirstResponder;   // default is NO

#else

//返回一個布林值指出接收者是否可以成為第一個響應者。

- (BOOL)canBecomeFirstResponder;   // default is NO

#endif

//通知接收器，它是即將成為第一響應在其視窗。

- (BOOL)becomeFirstResponder;

#ifUIKIT_DEFINE_AS_PROPERTIES

//是否願意放棄第一響應狀態。

@property(nonatomic,readonly) BOOLcanResignFirstResponder;   // default is YES

#else

//返回一個布林值，指示接收者是否願意放棄第一響應狀態。

- (BOOL)canResignFirstResponder;   // default is YES

#endif

//通知接收器，它已被要求放棄在其視窗第一個響應者的地位。

- (BOOL)resignFirstResponder;

#ifUIKIT_DEFINE_AS_PROPERTIES

//是否是第一響應者

@property(nonatomic,readonly) BOOL isFirstResponder;

#else

//返回一個布林值指出接收者是否是第一個響應者。

- (BOOL)isFirstResponder;

#endif

//響應觸控事件 -----

//告訴當一個或多個手指觸控到了檢視或者視窗響應。

- (void)touchesBegan:(NSSet<UITouch*> *)touches withEvent:(nullable UIEvent *)event;

//講述當用圖或視窗內的事件移動相關聯的一個或更多個手指的響應者。

- (void)touchesMoved:(NSSet<UITouch*> *)touches withEvent:(nullable UIEvent *)event;

//講述當一個或多個手指從檢視或視窗所提出的應答。

- (void)touchesEnded:(NSSet<UITouch*> *)touches withEvent:(nullable UIEvent *)event;

//傳送到應答時，系統事件（如低儲存器警告）取消的觸控事件。

- (void)touchesCancelled:(NSSet<UITouch*> *)touches withEvent:(nullable UIEvent *)event;

//傳送到應答器時的觸控所估計的特性發生了改變，使它們不再估計或更新不再預期。

- (void)touchesEstimatedPropertiesUpdated:(NSSet<UITouch*> *)touches NS_AVAILABLE_IOS(9_1);

//響應新聞釋出會  ---

//傳送到時，在相關聯的檢視被按壓物理按鈕接收機。

- (void)pressesBegan:(NSSet<UIPress*> *)presses withEvent:(nullable UIPressesEvent *)eventNS_AVAILABLE_IOS(9_0);

//傳送到接收器時，force壓在相關的檢視已經改變。

- (void)pressesChanged:(NSSet<UIPress*> *)presses withEvent:(nullable UIPressesEvent *)eventNS_AVAILABLE_IOS(9_0);

//傳送到接收器時，force壓在相關的檢視已經改變。

- (void)pressesEnded:(NSSet<UIPress*> *)presses withEvent:(nullable UIPressesEvent *)eventNS_AVAILABLE_IOS(9_0);

//送到時，系統事件（例如低記憶體報警）取消了新聞事件的接收器。

- (void)pressesCancelled:(NSSet<UIPress*> *)presses withEvent:(nullable UIPressesEvent *)eventNS_AVAILABLE_IOS(9_0);

//響應運動事件 -----

//告訴一個移動事件已經開始接收器。

- (void)motionBegan:(UIEventSubtype)motionwithEvent:(nullable UIEvent *)event NS_AVAILABLE_IOS(3_0);

//告訴運動活動已結束的接收器。

- (void)motionEnded:(UIEventSubtype)motionwithEvent:(nullable UIEvent *)event NS_AVAILABLE_IOS(3_0);

//告訴運動活動已經取消了接收器。

- (void)motionCancelled:(UIEventSubtype)motionwithEvent:(nullable UIEvent *)event NS_AVAILABLE_IOS(3_0);

//響應遠端控制活動----

//傳送到當接收到遠端控制事件的接收機。

- (void)remoteControlReceivedWithEvent:(nullable UIEvent *)eventNS_AVAILABLE_IOS(4_0);

//驗證命令 ----

//請接收響應啟用或在使用者介面中關閉指定的命令。

//通過這個方法告訴UIMenuController它內部應該顯示什麼內容,”複製”、”貼上”等

- (BOOL)canPerformAction:(SEL)action withSender:(nullableid)senderNS_AVAILABLE_IOS(3_0);

//返回響應的操作目標物件。

//預設的實現是呼叫canPerformAction:withSender:方法來確定物件是否可以呼叫action操作。如果我們想要重寫目標的選擇方式，則應該重寫這個方法。

- (nullable id)targetForAction:(SEL)action withSender:(nullableid)senderNS_AVAILABLE_IOS(7_0);

//獲取撤消經理 ---

//返回響應鏈就近共享撤消管理。

//UIResponder提供了一個只讀方法來獲取響應鏈中共享的undo管理器，公共的事件撤銷管理者

@property(nullable,nonatomic,readonly) NSUndoManager*undoManager NS_AVAILABLE_IOS(3_0);

@end

//響應者支援的快捷鍵

typedef NS_OPTIONS(NSInteger,UIKeyModifierFlags) {

    UIKeyModifierAlphaShift     = 1 <<16,  // Alppha+Shift鍵

    UIKeyModifierShift          = 1 <<17,  //Shift鍵

    UIKeyModifierControl        = 1 <<18,  //Control鍵

    UIKeyModifierAlternate      = 1 <<19,  //Alt鍵

    UIKeyModifierCommand        = 1 <<20,  //Command鍵

    UIKeyModifierNumericPad     = 1 <<21,  //Num鍵

}NS_ENUM_AVAILABLE_IOS(7_0);

@interface UIKeyCommand :NSObject <NSCopying, NSSecureCoding>

- (instancetype)initNS_DESIGNATED_INITIALIZER;

- (nullable instancetype)initWithCoder:(NSCoder*)aDecoder NS_DESIGNATED_INITIALIZER;

//輸入字串

@property (nonatomic,readonly) NSString *input;

//按鍵調節器

@property (nonatomic,readonly) UIKeyModifierFlagsmodifierFlags;

//按指定調節器鍵輸入字串並設定事件

@property (nullable,nonatomic,copy) NSString*discoverabilityTitle NS_AVAILABLE_IOS(9_0);

// The action forUIKeyCommands should accept a single (id)sender, as do theUIResponderStandardEditActions above

// Creates an keycommand that will _not_ be discoverable in the UI.

+ (UIKeyCommand*)keyCommandWithInput:(NSString *)inputmodifierFlags:(UIKeyModifierFlags)modifierFlags action:(SEL)action;

// Key Commands witha discoverabilityTitle _will_ be discoverable in the UI.

+ (UIKeyCommand*)keyCommandWithInput:(NSString *)inputmodifierFlags:(UIKeyModifierFlags)modifierFlags action:(SEL)actiondiscoverabilityTitle:(NSString *)discoverabilityTitle NS_AVAILABLE_IOS(9_0);

@end

//訪問可用鍵盤命令---

@interface UIResponder(UIResponderKeyCommands)

//觸發這一行動響應的關鍵命令。

//組合快捷鍵命令(裝有多個按鍵的陣列)

@property (nullable,nonatomic,readonly)NSArray<UIKeyCommand *> *keyCommands NS_AVAILABLE_IOS(7_0);// returns an arrayof UIKeyCommand objects<

@end

@class UIInputViewController;

@class UITextInputMode;

@classUITextInputAssistantItem;

//管理文字輸入模式----

@interface UIResponder(UIResponderInputViewAdditions)

//顯示自定義輸入檢視當接收機成為第一個響應者。//鍵盤輸入檢視(系統預設的,可以自定義)

@property (nullable,nonatomic, readonly,strong) __kindof UIView *inputViewNS_AVAILABLE_IOS(3_2);

//要顯示的自定義輸入附件檢視時，接收器成為第一個響應者。//彈出鍵盤時附帶的檢視

@property (nullable,nonatomic, readonly,strong) __kindof UIView*inputAccessoryView NS_AVAILABLE_IOS(3_2);

//輸入助手配置鍵盤的快捷方式欄時使用。

@property (nonnull,nonatomic, readonly,strong)UITextInputAssistantItem *inputAssistantItem NS_AVAILABLE_IOS(9_0) __TVOS_PROHIBITED__WATCHOS_PROHIBITED;

//當接收機成為第一個響應者使用自定義輸入檢視控制器。

@property (nullable,nonatomic, readonly,strong) UIInputViewController*inputViewController NS_AVAILABLE_IOS(8_0);

//顯示自定義輸入附件檢視控制器當接收機成為第一個響應者。

@property (nullable,nonatomic, readonly,strong) UIInputViewController*inputAccessoryViewController NS_AVAILABLE_IOS(8_0);

//文字輸入此響應的物件。

@property (nullable,nonatomic, readonly,strong) UITextInputMode*textInputMode NS_AVAILABLE_IOS(7_0);

//識別符號表示該響應應保留其文字輸入方式的資訊。

@property (nullable,nonatomic, readonly,strong) NSString*textInputContextIdentifier NS_AVAILABLE_IOS(7_0);

//清除從應用程式的使用者預設文字輸入模式的資訊。

+ (void)clearTextInputContextIdentifier:(NSString*)identifier NS_AVAILABLE_IOS(7_0);

//更新自定義輸入及配件的意見時，物件是第一個響應。

- (void)reloadInputViewsNS_AVAILABLE_IOS(3_2);

@end

// 按鍵輸入箭頭指向

UIKIT_EXTERN NSString *const UIKeyInputUpArrow         NS_AVAILABLE_IOS(7_0);

UIKIT_EXTERN NSString *constUIKeyInputDownArrow      NS_AVAILABLE_IOS(7_0);

UIKIT_EXTERN NSString *constUIKeyInputLeftArrow       NS_AVAILABLE_IOS(7_0);

UIKIT_EXTERN NSString *constUIKeyInputRightArrow     NS_AVAILABLE_IOS(7_0);

UIKIT_EXTERN NSString *const UIKeyInputEscape          NS_AVAILABLE_IOS(7_0);

//支援使用者活動 ---- //響應者類的類目:

@interface UIResponder(ActivityContinuation)

//使用者活動

@property (nullable,nonatomic, strong) NSUserActivity*userActivity NS_AVAILABLE_IOS(8_0);

//更新使用者活動

- (void)updateUserActivityState:(NSUserActivity*)activity NS_AVAILABLE_IOS(8_0);

//恢復使用者活動

- (void)restoreUserActivityState:(NSUserActivity*)activity NS_AVAILABLE_IOS(8_0);

@end