Unverified Commit e3261999 authored by Bruno Leroux's avatar Bruno Leroux Committed by GitHub

Add more documentation for SystemChannels.keyboard getKeyboardState (#133663)

## Description

This PR adds some documentation to SystemChannels.keyboard getKeyboardState.
This method was added in https://github.com/flutter/flutter/pull/122885.

## Related Issue

Fixes https://github.com/flutter/flutter/issues/132938.

## Tests

Documentation only.
parent 510ecaa4
...@@ -532,6 +532,10 @@ class HardwareKeyboard { ...@@ -532,6 +532,10 @@ class HardwareKeyboard {
} }
/// Query the engine and update _pressedKeys accordingly to the engine answer. /// Query the engine and update _pressedKeys accordingly to the engine answer.
//
/// Both the framework and the engine maintain a state of the current pressed
/// keys. There are edge cases, related to startup and restart, where the framework
/// needs to resynchronize its keyboard state.
Future<void> syncKeyboardState() async { Future<void> syncKeyboardState() async {
final Map<int, int>? keyboardState = await SystemChannels.keyboard.invokeMapMethod<int, int>( final Map<int, int>? keyboardState = await SystemChannels.keyboard.invokeMapMethod<int, int>(
'getKeyboardState', 'getKeyboardState',
......
...@@ -503,6 +503,10 @@ abstract final class SystemChannels { ...@@ -503,6 +503,10 @@ abstract final class SystemChannels {
/// represents a pressed keyboard key. The entry key is the physical /// represents a pressed keyboard key. The entry key is the physical
/// key ID and the entry value is the logical key ID. /// key ID and the entry value is the logical key ID.
/// ///
/// Both the framework and the engine maintain a state of the current
/// pressed keys. There are edge cases, related to startup and restart,
/// where the framework needs to resynchronize its keyboard state.
///
/// See also: /// See also:
/// ///
/// * [HardwareKeyboard.syncKeyboardState], which uses this channel to synchronize /// * [HardwareKeyboard.syncKeyboardState], which uses this channel to synchronize
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment