docs: Explain the limitations of QWidget::grabMouse() on Windows

Because carbon is dead, I merged both OSX and Windows in the same note.
Change-Id: I5d43c5fce30e187f63a1e3e5af688c344eb80d28
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@theqtcompany.com>
This commit is contained in:
Sérgio Martins 2015-01-08 11:31:27 +00:00 committed by Giuseppe D'Angelo
parent d62cd6508a
commit 5c5f43e95b

View File

@ -12392,10 +12392,9 @@ static void releaseMouseGrabOfWidget(QWidget *widget)
\note Only visible widgets can grab mouse input. If isVisible()
returns \c false for a widget, that widget cannot call grabMouse().
\note \b{(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.
\note On Windows, grabMouse() only works when the mouse is inside a window
owned by the process.
On OS X, grabMouse() only works when the mouse is inside the frame of that widget.
\sa releaseMouse(), grabKeyboard(), releaseKeyboard()
*/
@ -12416,7 +12415,7 @@ void QWidget::grabMouse()
\warning Grabbing the mouse might lock the terminal.
\note \b{(Mac OS X developers)} See the note in QWidget::grabMouse().
\note See the note in QWidget::grabMouse().
\sa releaseMouse(), grabKeyboard(), releaseKeyboard(), setCursor()
*/