X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/9d157d59786f32c4c094300450df99c0243e5e61..5b88a837ba75928cd3835a6b97ae2bf5ad983a6e:/interface/wx/dialog.h

diff --git a/interface/wx/dialog.h b/interface/wx/dialog.h
index bb798df560..4cf131dd17 100644
--- a/interface/wx/dialog.h
+++ b/interface/wx/dialog.h
@@ -126,13 +126,15 @@ enum wxDialogLayoutAdaptationMode
     styles to have an effect.
 
 
-    @beginEventTable{wxCloseEvent}
+    @beginEventEmissionTable{wxCloseEvent}
     @event{EVT_CLOSE(func)}
         The dialog is being closed by the user or programmatically (see wxWindow::Close).
         The user may generate this event clicking the close button
         (typically the 'X' on the top-right of the title bar) if it's present
         (see the @c wxCLOSE_BOX style) or by clicking a button with the
         @c wxID_CANCEL or @c wxID_OK ids.
+    @event{EVT_INIT_DIALOG(func)}
+        Process a @c wxEVT_INIT_DIALOG event. See wxInitDialogEvent.
     @endEventTable
 
     @library{wxcore}
@@ -180,8 +182,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();
 
@@ -578,6 +583,11 @@ public:
         modeless dialog modal. However ShowModal() can't be called twice
         without intervening EndModal() calls.
 
+        Note that this function creates a temporary event loop which takes
+        precedence over the application's main event loop (see wxEventLoopBase)
+        and which is destroyed when the dialog is dismissed.
+        This also results in a call to wxApp::ProcessPendingEvents().
+
         @return The value set with SetReturnCode().
 
         @see EndModal(), GetReturnCode(), SetReturnCode()