From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Thu, 22 Apr 2010 11:20:45 +0000 (+0000)
Subject: Clarify that Raise() is only a request to raise the window.
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/4582ed947831b29121287904a79a384d16c7aa91?ds=inline

Clarify that Raise() is only a request to raise the window.

Calling Raise() doesn't guarantee that the window will be raised.

Closes #11974.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@64099 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/interface/wx/window.h b/interface/wx/window.h
index 0335e85abe..63b2703191 100644
--- a/interface/wx/window.h
+++ b/interface/wx/window.h
@@ -2099,6 +2099,12 @@ public:
     /**
         Raises the window to the top of the window hierarchy (Z-order).
 
+        Notice that this function only requests the window manager to raise
+        this window to the top of Z-order. Depending on its configuration, the
+        window manager may raise the window, not do it at all or indicate that
+        a window requested to be raised in some other way, e.g. by flashing its
+        icon if it is minimized.
+
         @remarks
         This function only works for wxTopLevelWindow-derived classes.