prevent crash if panel/kicker is killed, bug 1872724

[wxWidgets.git] / interface / button.h

diff --git a/interface/button.h b/interface/button.h
index 5cc9bad0f732c65b8d7891491eadacde9ff1fe9f..67e13cc77f0f8241ddf01c18b8a54ff8aea12318 100644 (file)
--- a/interface/button.h
+++ b/interface/button.h
@@ -17,29 +17,29 @@
     or indeed on almost any other window.
 
     @beginStyleTable
-    @style{wxBU_LEFT}:
+    @style{wxBU_LEFT}
            Left-justifies the label. Windows and GTK+ only.
-    @style{wxBU_TOP}:
+    @style{wxBU_TOP}
            Aligns the label to the top of the button. Windows and GTK+ only.
-    @style{wxBU_RIGHT}:
+    @style{wxBU_RIGHT}
            Right-justifies the bitmap label. Windows and GTK+ only.
-    @style{wxBU_BOTTOM}:
+    @style{wxBU_BOTTOM}
            Aligns the label to the bottom of the button. Windows and GTK+ only.
-    @style{wxBU_EXACTFIT}:
+    @style{wxBU_EXACTFIT}
            Creates the button as small as possible instead of making it of the
            standard size (which is the default behaviour ).
-    @style{wxBORDER_NONE}:
+    @style{wxBORDER_NONE}
            Creates a flat button. Windows and GTK+ only.
     @endStyleTable
 
-    @beginEventTable
-    @event{EVT_BUTTON(id, func)}:
+    @beginEventTable{wxCommandEvent}
+    @event{EVT_BUTTON(id, func)}
            Process a wxEVT_COMMAND_BUTTON_CLICKED event, when the button is clicked.
     @endEventTable
 
     @library{wxcore}
     @category{ctrl}
-    @appearance{button.png}
+    <!-- @appearance{button.png} -->
 
     @see wxBitmapButton
 */
@@ -120,7 +120,8 @@ public:
     wxString GetLabel() const;
 
     /**
-        This sets the button to be the default item for the panel or dialog box.
+        This sets the button to be the default item in its top-level window
+        (e.g. the panel or the dialog box containing it).
 
         As normal, pressing return causes the default button to be depressed when
         the return key is pressed.
@@ -129,8 +130,10 @@ public:
         and text panel items, and wxTopLevelWindow::SetDefaultItem().
 
         @remarks Under Windows, only dialog box buttons respond to this function.
+
+        @return the old default item (possibly NULL)
     */
-    void SetDefault();
+    virtual wxWindow* SetDefault();
 
     /**
         Sets the string label for the button.