summaryrefslogtreecommitdiffstats
path: root/src/gui/kernel/qwidget.cpp
diff options
context:
space:
mode:
authorNorwegian Rock Cat <qt-info@nokia.com>2009-04-27 09:36:12 (GMT)
committerNorwegian Rock Cat <qt-info@nokia.com>2009-04-27 09:52:22 (GMT)
commit63a4d6652aa8d84282083e49217120c97bb0bfc8 (patch)
tree925b5e66cf39000e7f5063dbb70bcaadbec19538 /src/gui/kernel/qwidget.cpp
parent4e356720440d6a99a9516d10e2705cd99f08fbdd (diff)
downloadQt-63a4d6652aa8d84282083e49217120c97bb0bfc8.zip
Qt-63a4d6652aa8d84282083e49217120c97bb0bfc8.tar.gz
Qt-63a4d6652aa8d84282083e49217120c97bb0bfc8.tar.bz2
Document what QWidget::winId() returns on Mac OS X.
There are different types depending on Carbon and Cocoa, and it is probably helpful to point that out. Task-number: 251001 Reviewed-by: Kavindra
Diffstat (limited to 'src/gui/kernel/qwidget.cpp')
-rw-r--r--src/gui/kernel/qwidget.cpp4
1 files changed, 4 insertions, 0 deletions
diff --git a/src/gui/kernel/qwidget.cpp b/src/gui/kernel/qwidget.cpp
index e9fd28b..eb2e9f7 100644
--- a/src/gui/kernel/qwidget.cpp
+++ b/src/gui/kernel/qwidget.cpp
@@ -2132,6 +2132,10 @@ QWidget *QWidget::find(WId id)
If a widget is non-native (alien) and winId() is invoked on it, that widget
will be provided a native handle.
+ On Mac OS X, the type returned depends on which framework Qt was linked
+ against. If Qt is using Carbon, the {WId} is actually an HIViewRef. If Qt
+ is using Cocoa, {WId} is a pointer to an NSView.
+
\note We recommend that you do not store this value as it is likely to
change at run-time.