diff options
author | Laszlo Agocs <laszlo.agocs@digia.com> | 2014-09-15 14:36:23 +0200 |
---|---|---|
committer | Laszlo Agocs <laszlo.agocs@digia.com> | 2014-09-17 10:44:25 +0200 |
commit | c137c6f07bde37f113268581b2c7394dfee22f0d (patch) | |
tree | 9bae354424bf80c11d82949410ea1f71a65bbff8 /src/quickwidgets | |
parent | 3dbe05f6bf3fd51ce8097c35f6c7f12b39acb0f6 (diff) |
Add a note about winId() to QQuickWidget
This unfortunate function causes the creation of a
native window which is very wrong.
Task-number: QTBUG-40765
Change-Id: Ia08138cf35c240c883c63a66a54f949b86ccc2d2
Reviewed-by: Paul Olav Tvete <paul.tvete@digia.com>
Diffstat (limited to 'src/quickwidgets')
-rw-r--r-- | src/quickwidgets/qquickwidget.cpp | 5 |
1 files changed, 5 insertions, 0 deletions
diff --git a/src/quickwidgets/qquickwidget.cpp b/src/quickwidgets/qquickwidget.cpp index 707dc9b0a0..7df529c9d9 100644 --- a/src/quickwidgets/qquickwidget.cpp +++ b/src/quickwidgets/qquickwidget.cpp @@ -294,6 +294,11 @@ QImage QQuickWidgetPrivate::grabFramebuffer() some of the benefits of threaded rendering, for example \l Animator classes and vsync driven animations, will not be available. + \note Avoid calling winId() on a QQuickWidget. This function triggers the creation of + a native window, resulting in reduced performance and possibly rendering glitches. The + entire purpose of QQuickWidget is to render Quick scenes without a separate native + window, hence making it a native widget should always be avoided. + \section1 Limitations Putting other widgets underneath and making the QQuickWidget transparent will not lead |