1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc: Reduce expectations for QInputDevice::devices()

Browse Source 
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 <paul.wicking@qt.io>
Reviewed-by: Morten Johan Sørvig <morten.sorvig@qt.io>
(cherry picked from commit 8d11e05f8fdf5eb16fabb15c2ab176f8a5debc5f)
Reviewed-by: Qt Cherry-pick Bot <cherrypick_bot@qt-project.org>
This commit is contained in:
Shawn Rutledge 2023-05-22 15:05:18 +02:00 committed by Qt Cherry-pick Bot
parent c31edaaff3
commit ea45013669
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
src/gui/kernel/qinputdevice.cpp
View File

@ -269,6 +269,13 @@ static QBasicMutex devicesMutex;
/*! /*!
Returns a list of all registered input devices (keyboards and pointing devices). 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 \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. touch screen for an autotest, QTest::createTouchDevice() can be used.
Platform plugins should call QWindowSystemInterface::registerInputDevice() Platform plugins should call QWindowSystemInterface::registerInputDevice()