summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorMartin Smith <msmith@trolltech.com>2010-01-05 11:39:22 (GMT)
committerMartin Smith <msmith@trolltech.com>2010-01-05 11:39:22 (GMT)
commit190f45bcc7383bdc68a904e7dd5780372d00afba (patch)
tree4088cf27f4dd9d098d870a60b68596752cae5394 /src
parent553e0cafa578ece64c07afa11571eca4c7b9444c (diff)
downloadQt-190f45bcc7383bdc68a904e7dd5780372d00afba.zip
Qt-190f45bcc7383bdc68a904e7dd5780372d00afba.tar.gz
Qt-190f45bcc7383bdc68a904e7dd5780372d00afba.tar.bz2
doc: Added note explaining grabMouse() for Cocoa and Carbon.
Task-number: QTBUG-6810
Diffstat (limited to 'src')
-rw-r--r--src/gui/kernel/qwidget.cpp14
1 files changed, 10 insertions, 4 deletions
diff --git a/src/gui/kernel/qwidget.cpp b/src/gui/kernel/qwidget.cpp
index 81f38ec..5c4cc74 100644
--- a/src/gui/kernel/qwidget.cpp
+++ b/src/gui/kernel/qwidget.cpp
@@ -11871,16 +11871,20 @@ void QWidget::ungrabGesture(Qt::GestureType gesture)
mouse when a mouse button is pressed and keeps it until the last
button is released.
- Note that only visible widgets can grab mouse input. If
- isVisible() returns false for a widget, that widget cannot call
- grabMouse().
+ \note Only visible widgets can grab mouse input. If isVisible()
+ returns false for a widget, that widget cannot call grabMouse().
+
+ \note \bold{(Mac OS X developers)} For \e Cocoa, calling
+ grabMouse() on a widget only works when the mouse is inside the
+ frame of that widget. For \e Carbon, it works outside the widget's
+ frame as well, like for Windows and X11.
\sa releaseMouse() grabKeyboard() releaseKeyboard()
*/
/*!
\fn void QWidget::grabMouse(const QCursor &cursor)
- \overload
+ \overload grabMouse()
Grabs the mouse input and changes the cursor shape.
@@ -11890,6 +11894,8 @@ void QWidget::ungrabGesture(Qt::GestureType gesture)
\warning Grabbing the mouse might lock the terminal.
+ \note \bold{(Mac OS X developers)} See the note in QWidget::grabMouse().
+
\sa releaseMouse(), grabKeyboard(), releaseKeyboard(), setCursor()
*/