Make wxGridSizer ctors more consistent.

[wxWidgets.git] / interface / wx / toplevel.h

diff --git a/interface/wx/toplevel.h b/interface/wx/toplevel.h
index aded9fab57d9dd0d8e7a81ae2832e91a8103c873..acb79b1c724a69840a5cac5d38ef183f9a49f593 100644 (file)
--- a/interface/wx/toplevel.h
+++ b/interface/wx/toplevel.h
@@ -42,6 +42,25 @@ enum
     directly, but all of its methods are also applicable for the two classes
     above.
 
     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.
+
+    @beginEventEmissionTable
+    @event{EVT_ACTIVATE(id, func)}
+        Process a @c wxEVT_MAXIMIZE event. See wxMaximizeEvent.
+    @event{EVT_MOVE(func)}
+        Process a @c wxEVT_MOVE event, which is generated when a window is moved.
+        See wxMoveEvent.
+    @event{EVT_MOVE_START(func)}
+        Process a @c wxEVT_MOVE_START event, which is generated when the user starts
+        to move or size a window. wxMSW only.
+        See wxMoveEvent.
+    @event{EVT_MOVE_END(func)}
+        Process a @c wxEVT_MOVE_END event, which is generated when the user stops
+        moving or sizing a window. wxMSW only.
+        See wxMoveEvent.
+    @endEventTable
+

     @library{wxcore}
     @category{managedwnd}
 
     @library{wxcore}
     @category{managedwnd}
 


@@ -50,6 +69,42 @@ enum
 class wxTopLevelWindow : public wxWindow
 {
 public:
 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.
 
     /**
         Returns @true if the platform supports making the window translucent.
 


@@ -99,7 +154,7 @@ public:
 
         @see GetIcons()
     */
 
         @see GetIcons()
     */

-    const wxIcon GetIcon() const;
+    wxIcon GetIcon() const;

 
     /**
         Returns all icons associated with the window, there will be none of them
 
     /**
         Returns all icons associated with the window, there will be none of them


@@ -108,7 +163,7 @@ public:
 
         @see wxIconBundle
     */
 
         @see wxIconBundle
     */

-    const wxIconBundle GetIcons() const;
+    const wxIconBundle& GetIcons() const;

 
     /**
         Gets a string containing the window title.
 
     /**
         Gets a string containing the window title.


@@ -133,7 +188,7 @@ public:
 
         @see IsIconized(), Maximize(), wxIconizeEvent.
     */
 
         @see IsIconized(), Maximize(), wxIconizeEvent.
     */

-    void Iconize(bool iconize);
+    virtual void Iconize(bool iconize = true);

 
     /**
         Returns @true if this window is currently active, i.e. if the user is
 
     /**
         Returns @true if this window is currently active, i.e. if the user is


@@ -176,6 +231,12 @@ public:
     */
     bool IsUsingNativeDecorations() const;
 
     */
     bool IsUsingNativeDecorations() const;
 

+    /**
+        See wxWindow::SetAutoLayout(): when auto layout is on, this function gets
+        called automatically when the window is resized.
+    */
+    virtual bool Layout();
+

     /**
         Maximizes or restores the window.
 
     /**
         Maximizes or restores the window.
 


@@ -184,7 +245,7 @@ public:
 
         @see Iconize()
     */
 
         @see Iconize()
     */

-    void Maximize(bool maximize);
+    virtual void Maximize(bool maximize = true);

 
     /**
         Use a system-dependent way to attract users attention to the window when
 
     /**
         Use a system-dependent way to attract users attention to the window when


@@ -210,7 +271,7 @@ public:
 
         @see GetDefaultItem()
     */
 
         @see GetDefaultItem()
     */

-    void SetDefaultItem(wxWindow* win);
+    wxWindow* SetDefaultItem(wxWindow* win);

 
     /**
         Sets the icon for this window.
 
     /**
         Sets the icon for this window.


@@ -368,7 +429,7 @@ public:
             fully transparent, and a value of 255 sets the window to be fully
             opaque.
     */
             fully transparent, and a value of 255 sets the window to be fully
             opaque.
     */

-    virtual bool SetTransparent(int alpha);
+    virtual bool SetTransparent(wxByte alpha);

 
     /**
         This virtual function is not meant to be called directly but can be
 
     /**
         This virtual function is not meant to be called directly but can be