aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMitch Curtis <mitch.curtis@qt.io>2019-03-21 10:35:15 +0100
committerMitch Curtis <mitch.curtis@qt.io>2019-03-21 11:50:46 +0000
commit21558bcead96716607e670840c63213d6eb4d8c9 (patch)
tree0441db99fd2ba602ffc55514bcdf5f65463489a3
parente032cadd9d80171cd97c0acac2c0f332131746fb (diff)
Document Qt::WA_AcceptTouchEvents requirement when using QQuickWidget
On touch devices, it's necessary to set this attribute on the widget to ensure that touch events don't get sent as mouse events. This apparently became necessary after 41293196. Change-Id: I6371efa4bce561aa7e21b240c862d8b1e0fc2950 Fixes: QTBUG-67018 Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io> Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
-rw-r--r--src/virtualkeyboard/doc/src/technical-guide.qdoc7
1 files changed, 7 insertions, 0 deletions
diff --git a/src/virtualkeyboard/doc/src/technical-guide.qdoc b/src/virtualkeyboard/doc/src/technical-guide.qdoc
index 9f97cbd8..ff149f13 100644
--- a/src/virtualkeyboard/doc/src/technical-guide.qdoc
+++ b/src/virtualkeyboard/doc/src/technical-guide.qdoc
@@ -774,4 +774,11 @@ The final step is to run the example application with your custom style:
QT_VIRTUALKEYBOARD_STYLE=test virtualkeyboard
\endcode
+\section1 Using Qt Virtual Keyboard with QQuickWidget
+
+When using Qt Virtual Keyboard in a \l QQuickWidget on a touch device,
+it is necessary to set the \l Qt::WA_AcceptTouchEvents attribute via
+\l QWidget::setAttribute(). Without this attribute set, events from
+a touch device will be converted into synthesized mouse events.
+
*/