From cf2ec5a5fccf9cd92ffead2b95af032283eecebc Mon Sep 17 00:00:00 2001 From: Shawn Rutledge Date: Fri, 4 Feb 2022 08:58:03 +0100 Subject: [PATCH] doc: clarify that passive-grab API is only for Qt Quick Pointer Handlers ...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 --- src/gui/kernel/qevent.cpp | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/gui/kernel/qevent.cpp b/src/gui/kernel/qevent.cpp index 22389ce54ec..5bff8488db1 100644 --- a/src/gui/kernel/qevent.cpp +++ b/src/gui/kernel/qevent.cpp @@ -401,7 +401,7 @@ void QPointerEvent::setExclusiveGrabber(const QEventPoint &point, QObject *exclu Returns the list of objects that have been requested to receive all 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() */ @@ -421,7 +421,7 @@ QList > QPointerEvent::passiveGrabbers(const QEventPoint &poin future update events and the release event containing the given \a point, 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. */ @@ -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. 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() */ @@ -450,7 +450,7 @@ bool QPointerEvent::removePassiveGrabber(const QEventPoint &point, QObject *grab /*! 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() */