From ea45013669857e8b7a13059a51e1fe9b1d03b8d8 Mon Sep 17 00:00:00 2001 From: Shawn Rutledge Date: Mon, 22 May 2023 15:05:18 +0200 Subject: [PATCH] doc: Reduce expectations for QInputDevice::devices() MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit I was hoping we could get the list mostly correct and complete on most platforms; but in practice, it's proving difficult on most platforms. Hopefully we can find ways to improve it over time. Task-number: QTBUG-101648 Task-number: QTBUG-101875 Task-number: QTBUG-112432 Task-number: QTBUG-113706 Task-number: QTBUG-113711 Change-Id: I16b6900cddb54197fb7b833a513e36996de72d51 Reviewed-by: Paul Wicking Reviewed-by: Morten Johan Sørvig (cherry picked from commit 8d11e05f8fdf5eb16fabb15c2ab176f8a5debc5f) Reviewed-by: Qt Cherry-pick Bot --- src/gui/kernel/qinputdevice.cpp | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/src/gui/kernel/qinputdevice.cpp b/src/gui/kernel/qinputdevice.cpp index 0be5d4353e0..d679f8ad7a4 100644 --- a/src/gui/kernel/qinputdevice.cpp +++ b/src/gui/kernel/qinputdevice.cpp @@ -269,6 +269,13 @@ static QBasicMutex devicesMutex; /*! Returns a list of all registered input devices (keyboards and pointing devices). + \note The list of devices is not always complete on all platforms. So far, + the most-complete information is available on the \l {Qt for Linux/X11}{X11} + platform, at startup and in response to hot-plugging. Most other platforms + are only able to provide generic devices of various types, only after receiving + events from them; and most platforms do not tell Qt when a device is plugged in, + or when it is unplugged at runtime. + \note The returned list cannot be used to add new devices. To add a simulated touch screen for an autotest, QTest::createTouchDevice() can be used. Platform plugins should call QWindowSystemInterface::registerInputDevice()