From e9835a3812f91fc4a948a606fd751382d4ecf248 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tor=20Arne=20Vestb=C3=B8?=
 <tor.arne.vestbo@theqtcompany.com>
Date: Tue, 13 Oct 2015 16:13:30 +0200
Subject: Document that QWindow::fromWinId() should be used with caution

Change-Id: I28c58fb720c323048615efe677a920f179ef9d20
Reviewed-by: Lars Knoll <lars.knoll@theqtcompany.com>
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@theqtcompany.com>
---
 src/gui/kernel/qwindow.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/gui/kernel/qwindow.cpp b/src/gui/kernel/qwindow.cpp
index 9ca5d3e9f8..dbacfba4a8 100644
--- a/src/gui/kernel/qwindow.cpp
+++ b/src/gui/kernel/qwindow.cpp
@@ -2382,6 +2382,11 @@ QWindow *QWindowPrivate::topLevelWindow() const
 
     If foreign windows are not supported, this function returns 0.
 
+    \note The resulting QWindow should not be used to manipulate the underlying
+    native window (besides re-parenting), or to observe state changes of the
+    native window. Any support for these kind of operations is incidental, highly
+    platform dependent and untested.
+
     \sa setParent()
     \sa setTransientParent()
 */
-- 
cgit v1.2.3