Flutter iOS Embedder
FlutterEmbedderKeyResponder() Category Reference

Instance Methods

(void) - synchronizeModifiers:
 
(void) - updateKey:asPressed:
 
(void) - synthesizeCapsLockTapWithTimestamp:
 
(void) - sendPrimaryFlutterEvent:callback:
 
(void) - sendEmptyEvent
 
(void) - synthesizeModifierEventOfType:timestamp:keyCode:
 
(void) - handlePressBegin:callback:
 
(void) - handlePressEnd:callback:
 
(void) - handleResponse:forId:
 
(UInt32) - fixSidedFlags:withLeftFlag:withRightFlag:withLeftKey:withRightKey:withKeyCode:keyDown:forFlags:
 
(UInt32) - adjustModifiers:
 

Properties

FlutterSendKeyEvent sendEvent
 
NSMutableDictionary< NSNumber *, NSNumber * > * pressingRecords
 
NSUInteger modifierFlagOfInterestMask
 
NSUInteger lastModifierFlagsOfInterest
 
uint64_t responseId
 
NSMutableDictionary< NSNumber *, FlutterAsyncKeyCallback > * pendingResponses
 

Detailed Description

Definition at line 352 of file FlutterEmbedderKeyResponder.mm.

Method Documentation

◆ adjustModifiers:

- (UInt32) adjustModifiers: (ios(13.4))  API_AVAILABLE

Because iOS differs from other platforms in that the modifier flags still contain the flag for the key that is being released on the keyup event, we adjust the modifiers when the released key is a matching modifier key.

◆ fixSidedFlags:withLeftFlag:withRightFlag:withLeftKey:withRightKey:withKeyCode:keyDown:forFlags:

- (UInt32) fixSidedFlags: (ModifierFlag anyFlag
withLeftFlag: (ModifierFlag leftSide
withRightFlag: (ModifierFlag rightSide
withLeftKey: (UInt16)  leftKeyCode
withRightKey: (UInt16)  rightKeyCode
withKeyCode: (UInt16)  keyCode
keyDown: (BOOL)  isKeyDown
forFlags: (ios(13.4))  API_AVAILABLE 

Fix up the modifiers for a particular type of modifier key.

◆ handlePressBegin:callback:

- (void) handlePressBegin: (nonnull FlutterUIPressProxy *)  press
callback: (ios(13.4))  API_AVAILABLE 

Processes a down event from the system.

◆ handlePressEnd:callback:

- (void) handlePressEnd: (nonnull FlutterUIPressProxy *)  press
callback: (ios(13.4))  API_AVAILABLE 

Processes an up event from the system.

◆ handleResponse:forId:

- (void) handleResponse: (BOOL)  handled
forId: (uint64_t)  responseId 

Processes the response from the framework.

◆ sendEmptyEvent

- (void) sendEmptyEvent

Send an empty key event.

The event is never synthesized, and never expects an event result. An empty event is sent when no other events should be sent, such as upon back-to-back keydown events of the same key.

◆ sendPrimaryFlutterEvent:callback:

- (void) sendPrimaryFlutterEvent: (const FlutterKeyEvent &)  event
callback: (nonnull FlutterKeyCallbackGuard *)  callback 

Send an event to the framework, expecting its response.

◆ synchronizeModifiers:

- (void) synchronizeModifiers: (ios(13.4))  API_AVAILABLE

Compare the last modifier flags and the current, and dispatch synthesized key events for each different modifier flag bit.

The flags compared are all flags after masking with |modifierFlagOfInterestMask| and excluding |ignoringFlags|.

◆ synthesizeCapsLockTapWithTimestamp:

- (void) synthesizeCapsLockTapWithTimestamp: (NSTimeInterval)  timestamp

Synthesize a CapsLock down event, then a CapsLock up event.

◆ synthesizeModifierEventOfType:timestamp:keyCode:

- (void) synthesizeModifierEventOfType: (BOOL)  isDownEvent
timestamp: (NSTimeInterval)  timestamp
keyCode: (UInt32)  keyCode 

Send a key event for a modifier key.

◆ updateKey:asPressed:

- (void) updateKey: (uint64_t)  physicalKey
asPressed: (uint64_t)  logicalKey 

Update the pressing state.

If logicalKey is not 0, physicalKey is pressed as logicalKey. Otherwise, physicalKey is released.

Property Documentation

◆ lastModifierFlagsOfInterest

- (NSUInteger) lastModifierFlagsOfInterest
readwritenonatomicassign

The modifier flags of the last received key event, excluding uninterested bits.

This should be kept synchronized with the last |NSEvent.modifierFlags| after masking with |modifierFlagOfInterestMask|. This should also be kept synchronized with the corresponding keys of |pressingRecords|.

This is used by |synchronizeModifiers| to quickly find out modifier keys that are desynchronized.

Definition at line 393 of file FlutterEmbedderKeyResponder.mm.

◆ modifierFlagOfInterestMask

- (NSUInteger) modifierFlagOfInterestMask
readwritenonatomicassign

A constant mask for NSEvent.modifierFlags that Flutter synchronizes with.

Flutter keeps track of the last |modifierFlags| and compares it with the incoming one. Any bit within |modifierFlagOfInterestMask| that is different (except for the one that corresponds to the event key) indicates that an event for this modifier was missed, and Flutter synthesizes an event to make up for the state difference.

It is computed by computeModifierFlagOfInterestMask.

Definition at line 380 of file FlutterEmbedderKeyResponder.mm.

◆ pendingResponses

- (NSMutableDictionary<NSNumber*, FlutterAsyncKeyCallback>*) pendingResponses
readnonatomicretain

A map of unresponded key events sent to the framework.

Its values are |responseId|s, and keys are the callback that was received along with the event.

Definition at line 407 of file FlutterEmbedderKeyResponder.mm.

◆ pressingRecords

- (NSMutableDictionary<NSNumber*, NSNumber*>*) pressingRecords
readnonatomicretain

A map of pressed keys.

The keys of the dictionary are physical keys, while the values are the logical keys of the key down event.

Definition at line 367 of file FlutterEmbedderKeyResponder.mm.

◆ responseId

- (uint64_t) responseId
readwritenonatomicassign

A self-incrementing ID used to label key events sent to the framework.

Definition at line 398 of file FlutterEmbedderKeyResponder.mm.

◆ sendEvent

- (FlutterSendKeyEvent) sendEvent
readnonatomiccopy

The function to send converted events to.

Set by the initializer.

Definition at line 359 of file FlutterEmbedderKeyResponder.mm.


The documentation for this category was generated from the following file: