aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorVolker Hilsheimer <volker.hilsheimer@qt.io>2021-12-11 10:42:26 +0100
committerVolker Hilsheimer <volker.hilsheimer@qt.io>2021-12-20 18:59:00 +0100
commit8e30a0a9c549674a57f1773a3c7041cd7a809975 (patch)
treeeed47d0ca8f8a83f58f04ecc192fd3695d9de9ee
parent05008776210db2717635f76cb56f835d56e17c15 (diff)
Update documentation wrt modality and z ordering
As of 1129af130964c5e0f2db6e8a6fb6dc2fe70f3bc8, the InputPanel uses a containment masks on the overlay popup to keep it enabled even during modal sessions. It no longer reparents itself to the overlay item and doesn't change the z value, so remove that documentation. Add instead that the one, common input panel is bypassing modality, and that it may be obscured by items with a higher z value. Task-number: QTBUG-97439 Pick-to: 6.2 6.3 Change-Id: I493d5446186dae48523f63b29a473ee83daa4ffb Reviewed-by: Jarkko Koivikko <jarkko.koivikko@code-q.fi>
-rw-r--r--src/virtualkeyboard/content/InputPanel.qml13
1 files changed, 3 insertions, 10 deletions
diff --git a/src/virtualkeyboard/content/InputPanel.qml b/src/virtualkeyboard/content/InputPanel.qml
index 89a60e38..6f1314d8 100644
--- a/src/virtualkeyboard/content/InputPanel.qml
+++ b/src/virtualkeyboard/content/InputPanel.qml
@@ -49,16 +49,9 @@ import QtQuick.VirtualKeyboard
\c qtvirtualkeyboard before using InputPanel. For more information, see
\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.
+ \note You can have only one InputPanel instance in your application. The panel
+ will not be blocked by modal dialogs, but it can be obscured by items with a higher
+ \l {Item::}{z} value.
*/
Item {