diff options
author | Aaron Kennedy <aaron.kennedy@nokia.com> | 2009-08-05 07:40:41 (GMT) |
---|---|---|
committer | Aaron Kennedy <aaron.kennedy@nokia.com> | 2009-08-05 07:40:41 (GMT) |
commit | c0525981ffb291fc281a2daaafa290d4ff5917f4 (patch) | |
tree | e6c47f24d7c1cee3d6ce110f8d8c8d4b9910330d /src/declarative/fx/qfxitem.cpp | |
parent | 5148fc56f03504671ee2fa54411b8129c8c49c8e (diff) | |
parent | 809b5fa1c396688eb943dc9cd3d6a09de9d69468 (diff) | |
download | Qt-c0525981ffb291fc281a2daaafa290d4ff5917f4.zip Qt-c0525981ffb291fc281a2daaafa290d4ff5917f4.tar.gz Qt-c0525981ffb291fc281a2daaafa290d4ff5917f4.tar.bz2 |
Merge branch 'kinetic-declarativeui' of git@scm.dev.nokia.troll.no:qt/kinetic into kinetic-declarativeui
Diffstat (limited to 'src/declarative/fx/qfxitem.cpp')
-rw-r--r-- | src/declarative/fx/qfxitem.cpp | 20 |
1 files changed, 18 insertions, 2 deletions
diff --git a/src/declarative/fx/qfxitem.cpp b/src/declarative/fx/qfxitem.cpp index 2ff02f0..806d5c0 100644 --- a/src/declarative/fx/qfxitem.cpp +++ b/src/declarative/fx/qfxitem.cpp @@ -1289,8 +1289,10 @@ void QFxItem::setBaselineOffset(qreal offset) */ /*! - Returns a value indicating whether the mouse should - remain with this item. + Returns a value indicating whether mouse input should + remain with this item exclusively. + + \sa setKeepMouseGrab */ bool QFxItem::keepMouseGrab() const { @@ -1301,6 +1303,20 @@ bool QFxItem::keepMouseGrab() const /*! The flag indicating whether the mouse should remain with this item is set to \a keep. + + This is useful for items that wish to grab and keep mouse + interaction following a predefined gesture. For example, + an item that is interested in horizontal mouse movement + may set keepMouseGrab to true once a threshold has been + exceeded. Once keepMouseGrab has been set to true, filtering + items will not react to mouse events. + + If the item does not indicate that it wishes to retain mouse grab, + a filtering item may steal the grab. For example, Flickable may attempt + to steal a mouse grab if it detects that the user has begun to + move the viewport. + + \sa keepMouseGrab */ void QFxItem::setKeepMouseGrab(bool keep) { |