From 8e30a0a9c549674a57f1773a3c7041cd7a809975 Mon Sep 17 00:00:00 2001 From: Volker Hilsheimer Date: Sat, 11 Dec 2021 10:42:26 +0100 Subject: 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 --- src/virtualkeyboard/content/InputPanel.qml | 13 +++---------- 1 file 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 { -- cgit v1.2.3