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

doc: clarify that passive-grab API is only for Qt Quick Pointer Handlers

Browse Source 
...for now anyway. The plan is to have C++ API for custom handlers
later on; and we'll see if we find any other "must-have" use cases.

Task-number: QTBUG-68110
Pick-to: 6.2 6.3
Change-Id: I5e624a500af37797345d25bb5f54b146b13a45ca
Reviewed-by: Venugopal Shivashankar <Venugopal.Shivashankar@qt.io>
This commit is contained in:
Shawn Rutledge 2022-02-04 08:58:03 +01:00
parent 8058127a9d
commit cf2ec5a5fc
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
src/gui/kernel/qevent.cpp
View File

@ -401,7 +401,7 @@ void QPointerEvent::setExclusiveGrabber(const QEventPoint &point, QObject *exclu
Returns the list of objects that have been requested to receive all Returns the list of objects that have been requested to receive all
future update events and the release event containing the given \a point. future update events and the release event containing the given \a point.
It's mainly for use in Qt Quick at this time. It's only for use by \l {Qt Quick Input Handlers}.
\sa QPointerEvent::addPassiveGrabber() \sa QPointerEvent::addPassiveGrabber()
*/ */
@ -421,7 +421,7 @@ QList<QPointer<QObject> > QPointerEvent::passiveGrabbers(const QEventPoint &poin
future update events and the release event containing the given \a point, future update events and the release event containing the given \a point,
regardless where else those events may be delivered. regardless where else those events may be delivered.
It's mainly for use in Qt Quick at this time. It's only for use by \l {Qt Quick Input Handlers}.
Returns \c false if \a grabber was already added, \c true otherwise. Returns \c false if \a grabber was already added, \c true otherwise.
*/ */
@ -436,7 +436,7 @@ bool QPointerEvent::addPassiveGrabber(const QEventPoint &point, QObject *grabber
Removes the passive \a grabber from the given \a point if it was previously added. Removes the passive \a grabber from the given \a point if it was previously added.
Returns \c true if it had been a passive grabber before, \c false if not. Returns \c true if it had been a passive grabber before, \c false if not.
It's mainly for use in Qt Quick at this time. It's only for use by \l {Qt Quick Input Handlers}.
\sa QPointerEvent::addPassiveGrabber() \sa QPointerEvent::addPassiveGrabber()
*/ */
@ -450,7 +450,7 @@ bool QPointerEvent::removePassiveGrabber(const QEventPoint &point, QObject *grab
/*! /*!
Removes all passive grabbers from the given \a point. Removes all passive grabbers from the given \a point.
It's mainly for use in Qt Quick at this time. It's only for use by \l {Qt Quick Input Handlers}.
\sa QPointerEvent::addPassiveGrabber() \sa QPointerEvent::addPassiveGrabber()
*/ */