From 2e4f32d760c36985ce946b06fa19abcc9dd4bce3 Mon Sep 17 00:00:00 2001
From: Francesco Montorsi <f18m_cpp217828@yahoo.it>
Date: Tue, 25 Nov 2008 00:24:58 +0000
Subject: [PATCH] add more references to the delayed deletion of
 wxTopLevelWindows

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56959 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 interface/wx/dialog.h   |  7 +++++--
 interface/wx/frame.h    |  2 ++
 interface/wx/toplevel.h | 36 ++++++++++++++++++++++++++++++++++++
 3 files changed, 43 insertions(+), 2 deletions(-)

diff --git a/interface/wx/dialog.h b/interface/wx/dialog.h
index bb798df560..e057bc30ed 100644
--- a/interface/wx/dialog.h
+++ b/interface/wx/dialog.h
@@ -180,8 +180,11 @@ public:
              const wxString& name = wxDialogNameStr);
 
     /**
-        Destructor. Deletes any child windows before deleting the physical
-        window.
+        Destructor.
+
+        Deletes any child windows before deleting the physical window.
+
+        See @ref overview_windowdeletion for more info.
     */
     virtual ~wxDialog();
 
diff --git a/interface/wx/frame.h b/interface/wx/frame.h
index 04de46ed7a..58348fca31 100644
--- a/interface/wx/frame.h
+++ b/interface/wx/frame.h
@@ -165,6 +165,8 @@ public:
 
     /**
         Destructor. Destroys all child windows and menu bar if present.
+
+        See @ref overview_windowdeletion for more info.
     */
     virtual ~wxFrame();
 
diff --git a/interface/wx/toplevel.h b/interface/wx/toplevel.h
index 51aa45c656..822e2edc7f 100644
--- a/interface/wx/toplevel.h
+++ b/interface/wx/toplevel.h
@@ -53,6 +53,42 @@ enum
 class wxTopLevelWindow : public wxWindow
 {
 public:
+    /**
+        Default ctor.
+    */
+    wxTopLevelWindow();
+
+    /**
+        Constructor creating the top level window.
+    */
+    wxTopLevelWindow(wxWindow *parent,
+                    wxWindowID winid,
+                    const wxString& title,
+                    const wxPoint& pos = wxDefaultPosition,
+                    const wxSize& size = wxDefaultSize,
+                    long style = wxDEFAULT_FRAME_STYLE,
+                    const wxString& name = wxFrameNameStr);
+
+    /**
+        Destructor. Remember that wxTopLevelWindows do not get immediately
+        destroyed when the user (or the app) closes them; they have a
+        @b delayed destruction.
+
+        See @ref overview_windowdeletion for more info.
+    */
+    virtual ~wxTopLevelWindow();
+
+    /**
+        Creates the top level window.
+    */
+    bool Create(wxWindow *parent,
+                wxWindowID id,
+                const wxString& title,
+                const wxPoint& pos = wxDefaultPosition,
+                const wxSize& size = wxDefaultSize,
+                long style = wxDEFAULT_FRAME_STYLE,
+                const wxString& name = wxFrameNameStr);
+
     /**
         Returns @true if the platform supports making the window translucent.
 
-- 
2.45.2