diff options
| -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 |