handleKeyData method

  1. @Deprecated('No longer supported. Use HardwareKeyboard.instance.addHandler instead. ' 'This feature was deprecated after v3.18.0-2.0.pre.')
bool handleKeyData(
  1. KeyData data
)

Dispatch a key data to global and leaf listeners.

This method is the handler to the global onKeyData API.

This handler is deprecated, and will be removed. Use HardwareKeyboard.addHandler instead.

Implementation

@Deprecated(
  'No longer supported. Use HardwareKeyboard.instance.addHandler instead. '
  'This feature was deprecated after v3.18.0-2.0.pre.',
)
bool handleKeyData(ui.KeyData data) {
  _transitMode ??= KeyDataTransitMode.keyDataThenRawKeyData;
  switch (_transitMode!) {
    case KeyDataTransitMode.rawKeyData:
      assert(false, 'Should never encounter KeyData when transitMode is rawKeyData.');
      return false;
    case KeyDataTransitMode.keyDataThenRawKeyData:
      // Having 0 as the physical and logical ID indicates an empty key data
      // (the only occasion either field can be 0,) transmitted to ensure
      // that the transit mode is correctly inferred. These events should be
      // ignored.
      if (data.physical == 0 && data.logical == 0) {
        return false;
      }
      assert(data.physical != 0 && data.logical != 0);
      final KeyEvent event = _eventFromData(data);
      if (data.synthesized && _keyEventsSinceLastMessage.isEmpty) {
        // Dispatch the event instantly if both conditions are met:
        //
        // - The event is synthesized, therefore the result does not matter.
        // - The current queue is empty, therefore the order does not matter.
        //
        // This allows solitary synthesized `KeyEvent`s to be dispatched,
        // since they won't be followed by `RawKeyEvent`s.
        _hardwareKeyboard.handleKeyEvent(event);
        _dispatchKeyMessage(<KeyEvent>[event], null);
      } else {
        // Otherwise, postpone key event dispatching until the next raw
        // event. Normal key presses always send 0 or more `KeyEvent`s first,
        // then 1 `RawKeyEvent`.
        _keyEventsSinceLastMessage.add(event);
      }
      return false;
  }
}