From a183ec70940e5ecddd4d5a0ea13ccdd43cc015b5 Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sun, 15 Aug 2010 21:14:11 +0000
Subject: [PATCH] Improve EVT_SHOW documentation.

Mention that it applies to the TLWs only and explain when it is generated (and
not generated).

Closes #12353.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@65316 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 interface/wx/event.h    | 5 +++++
 interface/wx/toplevel.h | 2 ++
 interface/wx/window.h   | 7 +++++--
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/interface/wx/event.h b/interface/wx/event.h
index 5d95b9b29a..ce3793bd08 100644
--- a/interface/wx/event.h
+++ b/interface/wx/event.h
@@ -3616,6 +3616,11 @@ public:
     @class wxShowEvent
 
     An event being sent when the window is shown or hidden.
+    The event is triggered by calls to wxWindow::Show(), and any user
+    action showing a previously hidden window or vice versa (if allowed by
+    the current platform and/or window manager).
+    Notice that the event is not triggered when the application is iconized
+    (minimized) or restored under wxMSW.
 
     Currently only wxMSW, wxGTK and wxOS2 generate such events.
 
diff --git a/interface/wx/toplevel.h b/interface/wx/toplevel.h
index 5afa28037f..bb8bdea42f 100644
--- a/interface/wx/toplevel.h
+++ b/interface/wx/toplevel.h
@@ -59,6 +59,8 @@ enum
         Process a @c wxEVT_MOVE_END event, which is generated when the user stops
         moving or sizing a window. wxMSW only.
         See wxMoveEvent.
+    @event{EVT_SHOW(func)}
+        Process a @c wxEVT_SHOW event. See wxShowEvent.
     @endEventTable
 
     @library{wxcore}
diff --git a/interface/wx/window.h b/interface/wx/window.h
index 6a2cc7216c..180aef5b63 100644
--- a/interface/wx/window.h
+++ b/interface/wx/window.h
@@ -235,8 +235,6 @@ enum wxWindowVariant
         Process scroll events. See wxScrollWinEvent.
     @event{EVT_SET_CURSOR(func)}
         Process a @c wxEVT_SET_CURSOR event. See wxSetCursorEvent.
-    @event{EVT_SHOW(func)}
-        Process a @c wxEVT_SHOW event. See wxShowEvent.
     @event{EVT_SIZE(func)}
         Process a @c wxEVT_SIZE event. See wxSizeEvent.
     @event{EVT_SYS_COLOUR_CHANGED(func)}
@@ -2235,6 +2233,11 @@ public:
         for a top level window if you want to bring it to top, although this is not
         needed if Show() is called immediately after the frame creation.
 
+        Notice that the default state of newly created top level windows is hidden
+        (to allow you to create their contents without flicker) unlike for
+        all the other, not derived from wxTopLevelWindow, windows that
+        are by default created in the shown state.
+
         @param show
             If @true displays the window. Otherwise, hides it.
 
-- 
2.45.2