It interacts with the text editor through QVirtualKeyboardInputContext via pre-edit text or key events. It's main function is to handle keypress events and maintain state information for the user input. The input method is a concrete implementation of the keypress handler. If the key press is interrupted before the key release event, the keyboard invokes the QVirtualKeyboardInputEngine::virtualKe圜ancel method. This is a consequence of the fact that the actual action is performed only when the key is released. This also means that the methods are not suitable for mapping the physical keystrokes. The above-mentioned methods are intended for the integration of the virtual keyboard, hence the word "virtual" in the methods' names.
Internally, the current input locale is also updated to the QVirtualKeyboardInputEngine and the current input method instances. The application can receive this information through the QInputMethod interface. If a partial match is not found, then the "en_GB" locale is used as a fallback.Īfter the locale selection is done, the keyboard updates the input locale and input direction to match the current layout.
#VIRTUALKEYBOARD MAPPING FULL#
If a full match is not found, then only the locale language is matched. The locale is first matched against the full locale name. The keyboard locale matching is performed in the following sequence: If no changes are made to the default locale, the current system locale is used. However, this needs to be done before the application is initialized and the input method plugin is loaded. The application can specify the initial layout by changing the default locale. This will specify the virtual keyboard that a fallback layout can be used instead.Īt minimum the layout directory must contain the files: If the locale specific layout is not different from the fallback locale, then a place holder file. Each layout directory may contain one or more layouts, for example fi_FI/main.qml or symbols.qml. The list of supported locales is specified by the existence of a locale specific layout directory in "layouts/*".
This information includes, but is not limited to: The input context provides access to contextual information that originates from the application. An application should not directly interact with the input context. InputContext is a singleton instance hosted by QML. The input context is used by the keyboard as well as concrete input methods. QVirtualKeyboardExtensionPlugin: a plugin interface for virtual keyboard extensions that provide additional functionality.The input method usually handles key events, but can also handle mouse and touch input events. InputMethod: a base type for QML-based input methods.QVirtualKeyboardAbstractInputMethod: a base type for C++-based input methods.QVirtualKeyboardInputEngine: exposes an API to integrate user input events (key presses, etc.) and acts as a host for input methods.Acts as an interface to the underlying text input component. QVirtualKeyboardInputContext: provides contextual information for the virtual keyboard and other input components.The input framework provides the following main interfaces: The input framework is extensible through a plugin interface, which allows third-party input methods and keyboard layouts to be loaded at runtime. The plugin itself provides an input framework supporting multiple input methods as well as a QML UI for the virtual keyboard. These interfaces allow the plugin to be used as a platform input context plugin in Qt applications. The Qt Virtual Keyboard project is a Qt input context plugin which implements QPlatformInputContextPlugin and QPlatformInputContext interfaces.
This document provides a technical overview of the Qt Virtual Keyboard plugin.
0 kommentar(er)
