]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/mdi.h
remove daily build of docs
[wxWidgets.git] / interface / mdi.h
index 7444b51a85415a885b5296ca5d631bfc3478c1dc..c5543a403b53e68d8adcf43cbed1470cddf8fc7e 100644 (file)
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        mdi.h
-// Purpose:     documentation for wxMDIClientWindow class
+// Purpose:     interface of wxMDIClientWindow
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -16,8 +16,7 @@
     @library{wxcore}
     @category{FIXME}
 
-    @seealso
-    wxMDIChildFrame, wxMDIParentFrame, wxFrame
+    @see wxMDIChildFrame, wxMDIParentFrame, wxFrame
 */
 class wxMDIClientWindow : public wxWindow
 {
@@ -27,15 +26,14 @@ public:
         Constructor, creating the window.
         
         @param parent
-        The window parent.
-        
+            The window parent.
         @param style
-        The window style. Currently unused.
+            The window style. Currently unused.
         
         @remarks The second style of constructor is called within
-                   wxMDIParentFrame::OnCreateClient.
+                 wxMDIParentFrame::OnCreateClient.
         
-        @sa wxMDIParentFrame::wxMDIParentFrame, wxMDIParentFrame::OnCreateClient
+        @see wxMDIParentFrame::wxMDIParentFrame, wxMDIParentFrame::OnCreateClient
     */
     wxMDIClientWindow();
     wxMDIClientWindow(wxMDIParentFrame* parent, long style = 0);
@@ -54,6 +52,7 @@ public:
 };
 
 
+
 /**
     @class wxMDIParentFrame
     @wxheader{mdi.h}
@@ -102,8 +101,7 @@ public:
     @library{wxcore}
     @category{managedwnd}
 
-    @seealso
-    wxMDIChildFrame, wxMDIClientWindow, wxFrame, wxDialog
+    @see wxMDIChildFrame, wxMDIClientWindow, wxFrame, wxDialog
 */
 class wxMDIParentFrame : public wxFrame
 {
@@ -113,44 +111,40 @@ public:
         Constructor, creating the window.
         
         @param parent
-        The window parent. This should be @NULL.
-        
+            The window parent. This should be @NULL.
         @param id
-        The window identifier. It may take a value of -1 to indicate a default value.
-        
+            The window identifier. It may take a value of -1 to indicate a default
+        value.
         @param title
-        The caption to be displayed on the frame's title bar.
-        
+            The caption to be displayed on the frame's title bar.
         @param pos
-        The window position. The value wxDefaultPosition indicates a default position, chosen by
-        either the windowing system or wxWidgets, depending on platform.
-        
+            The window position. The value wxDefaultPosition indicates a default position,
+        chosen by
+            either the windowing system or wxWidgets, depending on platform.
         @param size
-        The window size. The value wxDefaultSize indicates a default size, chosen by
-        either the windowing system or wxWidgets, depending on platform.
-        
+            The window size. The value wxDefaultSize indicates a default size, chosen by
+            either the windowing system or wxWidgets, depending on platform.
         @param style
-        The window style. See wxMDIParentFrame.
-        
+            The window style. See wxMDIParentFrame.
         @param name
-        The name of the window. This parameter is used to associate a name with the
+            The name of the window. This parameter is used to associate a name with the
         item,
-        allowing the application user to set Motif resource values for
-        individual windows.
+            allowing the application user to set Motif resource values for
+            individual windows.
         
         @remarks During the construction of the frame, the client window will be
-                   created. To use a different class from
-                   wxMDIClientWindow, override
-                   OnCreateClient().
+                 created. To use a different class from
+                 wxMDIClientWindow, override
+                 OnCreateClient().
         
-        @sa Create(), OnCreateClient()
+        @see Create(), OnCreateClient()
     */
     wxMDIParentFrame();
     wxMDIParentFrame(wxWindow* parent, wxWindowID id,
                      const wxString& title,
                      const wxPoint& pos = wxDefaultPosition,
                      const wxSize& size = wxDefaultSize,
-                     long style = wxDEFAULT_FRAME_STYLE |  wxVSCROLL |  wxHSCROLL,
+                     long style = wxDEFAULT_FRAME_STYLE | wxVSCROLL | wxHSCROLL,
                      const wxString& name = "frame");
     //@}
 
@@ -162,28 +156,28 @@ public:
     /**
         Activates the MDI child following the currently active one.
         
-        @sa ActivatePrevious()
+        @see ActivatePrevious()
     */
     void ActivateNext();
 
     /**
         Activates the MDI child preceding the currently active one.
         
-        @sa ActivateNext()
+        @see ActivateNext()
     */
     void ActivatePrevious();
 
     /**
         Arranges any iconized (minimized) MDI child windows.
         
-        @sa Cascade(), Tile()
+        @see Cascade(), Tile()
     */
     void ArrangeIcons();
 
     /**
         Arranges the MDI child windows in a cascade.
         
-        @sa Tile(), ArrangeIcons()
+        @see Tile(), ArrangeIcons()
     */
     void Cascade();
 
@@ -195,52 +189,51 @@ public:
                 const wxString& title,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
-                long style = wxDEFAULT_FRAME_STYLE |  wxVSCROLL |  wxHSCROLL,
+                long style = wxDEFAULT_FRAME_STYLE | wxVSCROLL | wxHSCROLL,
                 const wxString& name = "frame");
 
     /**
         Returns a pointer to the active MDI child, if there is one.
     */
-    wxMDIChildFrame* GetActiveChild();
+    wxMDIChildFrame* GetActiveChild() const;
 
     /**
         This gets the size of the frame 'client area' in pixels.
         
         @param width
-        Receives the client width in pixels.
-        
+            Receives the client width in pixels.
         @param height
-        Receives the client height in pixels.
+            Receives the client height in pixels.
         
         @remarks The client area is the area which may be drawn on by the
-                   programmer, excluding title bar, border, status bar,
-                   and toolbar if present.
+                 programmer, excluding title bar, border, status bar,
+                 and toolbar if present.
         
-        @sa GetToolBar(), SetToolBar(),
-              wxMDIClientWindow
+        @see GetToolBar(), SetToolBar(),
+             wxMDIClientWindow
     */
-    virtual void GetClientSize(int* width, int* height);
+    virtual void GetClientSize(int* width, int* height) const;
 
     /**
         Returns a pointer to the client window.
         
-        @sa OnCreateClient()
+        @see OnCreateClient()
     */
-    wxMDIClientWindow* GetClientWindow();
+    wxMDIClientWindow* GetClientWindow() const;
 
     /**
         Returns the window being used as the toolbar for this frame.
         
-        @sa SetToolBar()
+        @see SetToolBar()
     */
-    virtual wxWindow* GetToolBar();
+    virtual wxWindow* GetToolBar() const;
 
     /**
         Returns the current Window menu (added by wxWidgets to the menubar). This
         function
         is available under Windows only.
     */
-    wxMenu* GetWindowMenu();
+    wxMenu* GetWindowMenu() const;
 
     /**
         Override this to return a different kind of client window. If you override this
@@ -251,10 +244,10 @@ public:
         example:
         
         @remarks You might wish to derive from wxMDIClientWindow in order to
-                   implement different erase behaviour, for example,
-                   such as painting a bitmap on the background.
+                 implement different erase behaviour, for example, such
+                 as painting a bitmap on the background.
         
-        @sa GetClientWindow(), wxMDIClientWindow
+        @see GetClientWindow(), wxMDIClientWindow
     */
     virtual wxMDIClientWindow* OnCreateClient();
 
@@ -264,13 +257,13 @@ public:
         of the toolbar MDI client window.
         
         @param toolbar
-        Toolbar to manage.
+            Toolbar to manage.
         
         @remarks When the frame is resized, the toolbar is resized to be the
-                   width of the frame client area, and the toolbar
-                   height is kept the same.
+                 width of the frame client area, and the toolbar height
+                 is kept the same.
         
-        @sa GetToolBar(), GetClientSize()
+        @see GetToolBar(), GetClientSize()
     */
     virtual void SetToolBar(wxWindow* toolbar);
 
@@ -278,23 +271,21 @@ public:
         Call this to change the current Window menu. Ownership of the menu object
         passes to
         the frame when you call this function.
-        
         This call is available under Windows only.
-        
         To remove the window completely, use the wxFRAME_NO_WINDOW_MENU window style.
     */
     void SetWindowMenu(wxMenu* menu);
 
     /**
         Tiles the MDI child windows either horizontally or vertically depending on
-        whether @e orient is wxHORIZONTAL or wxVERTICAL.
-        
+        whether @a orient is wxHORIZONTAL or wxVERTICAL.
         Currently only implemented for MSW, does nothing under the other platforms.
     */
     void Tile(wxOrientation orient = wxHORIZONTAL);
 };
 
 
+
 /**
     @class wxMDIChildFrame
     @wxheader{mdi.h}
@@ -332,8 +323,7 @@ public:
     @library{wxcore}
     @category{managedwnd}
 
-    @seealso
-    wxMDIClientWindow, wxMDIParentFrame, wxFrame
+    @see wxMDIClientWindow, wxMDIParentFrame, wxFrame
 */
 class wxMDIChildFrame : public wxFrame
 {
@@ -343,34 +333,30 @@ public:
         Constructor, creating the window.
         
         @param parent
-        The window parent. This should not be @NULL.
-        
+            The window parent. This should not be @NULL.
         @param id
-        The window identifier. It may take a value of -1 to indicate a default value.
-        
+            The window identifier. It may take a value of -1 to indicate a default
+        value.
         @param title
-        The caption to be displayed on the frame's title bar.
-        
+            The caption to be displayed on the frame's title bar.
         @param pos
-        The window position. The value wxDefaultPosition indicates a default position, chosen by
-        either the windowing system or wxWidgets, depending on platform.
-        
+            The window position. The value wxDefaultPosition indicates a default position,
+        chosen by
+            either the windowing system or wxWidgets, depending on platform.
         @param size
-        The window size. The value wxDefaultSize indicates a default size, chosen by
-        either the windowing system or wxWidgets, depending on platform.
-        
+            The window size. The value wxDefaultSize indicates a default size, chosen by
+            either the windowing system or wxWidgets, depending on platform.
         @param style
-        The window style. See wxMDIChildFrame.
-        
+            The window style. See wxMDIChildFrame.
         @param name
-        The name of the window. This parameter is used to associate a name with the
+            The name of the window. This parameter is used to associate a name with the
         item,
-        allowing the application user to set Motif resource values for
-        individual windows.
+            allowing the application user to set Motif resource values for
+            individual windows.
         
         @remarks None.
         
-        @sa Create()
+        @see Create()
     */
     wxMDIChildFrame();
     wxMDIChildFrame(wxMDIParentFrame* parent, wxWindowID id,
@@ -389,7 +375,7 @@ public:
     /**
         Activates this MDI child frame.
         
-        @sa Maximize(), Restore()
+        @see Maximize(), Restore()
     */
     void Activate();
 
@@ -407,7 +393,7 @@ public:
     /**
         Maximizes this MDI child frame.
         
-        @sa Activate(), Restore()
+        @see Activate(), Restore()
     */
     void Maximize(bool maximize);
 
@@ -416,3 +402,4 @@ public:
     */
     void Restore();
 };
+