diff options
| author | Volker Hilsheimer <volker.hilsheimer@qt.io> | 2021-10-18 15:38:27 +0200 |
|---|---|---|
| committer | Qt Cherry-pick Bot <cherrypick_bot@qt-project.org> | 2021-10-18 16:02:21 +0000 |
| commit | b45ad13d0d78929fa058ea2120434fba006fbda8 (patch) | |
| tree | 4cc2381d11fdcdbf565f63167771e92d9d103fcb | |
| parent | 6b0206ead18466a2eab48d24c7f08d0db1fdd061 (diff) | |
Document the reparenting of InputPanel during modal sessions
Amends 5564f1c96322d7c3f884d2e6f9b3a95e3134fb9f.
Change-Id: Ia690fd996a35d7c35408028523c5af2443f86781
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>
(cherry picked from commit 82b70a672329899d8bbe2322432789e2528f2913)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
| -rw-r--r-- | src/virtualkeyboard/content/InputPanel.qml | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/src/virtualkeyboard/content/InputPanel.qml b/src/virtualkeyboard/content/InputPanel.qml index 53b1ce00..89a60e38 100644 --- a/src/virtualkeyboard/content/InputPanel.qml +++ b/src/virtualkeyboard/content/InputPanel.qml @@ -43,9 +43,6 @@ import QtQuick.VirtualKeyboard width; that is, the keyboard maintains the aspect ratio specified by the current style. Therefore the application should only set the \l {Item::}{width} and \l {Item::}{y} coordinates of the InputPanel, and not the \l {Item::}{height}. - The default \l {Item::z}-value of the InputPanel is 10000, which puts it on - top of a typical user interface, while leaving space for UI elements that - should not be obscured by the input panel. As with \l {Qt Virtual Keyboard QML Types}{all other QML types} provided by the module, the \c QT_IM_MODULE environment variable must be set to @@ -53,6 +50,15 @@ import QtQuick.VirtualKeyboard \l {Loading the Plugin}. \note You can have only one InputPanel instance in your application. + + \section2 InputPanel and modal dialogs + + Qt prevents modal popups from blocking the keyboard UI, as this would make it + impossible to use the keyboard to write into a text field within a modal popup. + When an input field receives focus during a modal session, the InputPanel item is + made a sibling of the Overlay, and given a z-value one above the Overlay's so that + it stays on top of the user interface. When the modal session ends, the item is + reparented back to the original parent, and the z-value is restored. */ Item { |