From afc31d8ad8cb0712fa538126711d73bb30305679 Mon Sep 17 00:00:00 2001 From: Francesco Montorsi Date: Sat, 22 Nov 2008 13:12:32 +0000 Subject: [PATCH] clarify how top-level windows are used by wxApp (fixes #9448) git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56897 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- interface/wx/app.h | 17 +++++++++++------ interface/wx/toplevel.h | 3 +++ 2 files changed, 14 insertions(+), 6 deletions(-) diff --git a/interface/wx/app.h b/interface/wx/app.h index 4fea75c14b..595fe78aab 100644 --- a/interface/wx/app.h +++ b/interface/wx/app.h @@ -531,9 +531,10 @@ public: /** Returns a pointer to the top window. - @remarks If the top window hasn't been set using SetTopWindow(), - this function will find the first top-level window - (frame or dialog) and return that. + @remarks + If the top window hasn't been set using SetTopWindow(), this function + will find the first top-level window (frame or dialog or instance of + wxTopLevelWindow) from the internal top level window list and return that. @see SetTopWindow() */ @@ -624,9 +625,13 @@ public: Sets the 'top' window. You can call this from within OnInit() to let wxWidgets know which is the main window. You don't have to set the top window; it is only a convenience so that (for example) certain dialogs without parents - can use a specific window as the top window. If no top window is specified by the - application, wxWidgets just uses the first frame or dialog in its top-level window - list, when it needs to use the top window. + can use a specific window as the top window. + + If no top window is specified by the application, wxWidgets just uses the + first frame or dialog (or better, any wxTopLevelWindow) in its top-level + window list, when it needs to use the top window. + If you previously called SetTopWindow() and now you need to restore this + automatic behaviour you can call @code wxApp::SetTopWindow(NULL) @endcode. @param window The new top window. diff --git a/interface/wx/toplevel.h b/interface/wx/toplevel.h index 0806c2f21f..51aa45c656 100644 --- a/interface/wx/toplevel.h +++ b/interface/wx/toplevel.h @@ -42,6 +42,9 @@ enum directly, but all of its methods are also applicable for the two classes above. + Note that the instances of wxTopLevelWindow are managed by wxWidgets in the + internal top level window list. + @library{wxcore} @category{managedwnd} -- 2.45.2