X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4cc4bfafe5a31cb96f35b3ec9b19fa2b0b3a4eef..63b37a4e648320827a5b4a3161be13154370b5c3:/interface/docmdi.h

diff --git a/interface/docmdi.h b/interface/docmdi.h
index b1c5b0931d..758fba89b6 100644
--- a/interface/docmdi.h
+++ b/interface/docmdi.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        docmdi.h
-// Purpose:     documentation for wxDocMDIParentFrame class
+// Purpose:     interface of wxDocMDIParentFrame and wxDocMDIChildFrame
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -11,19 +11,16 @@
     @wxheader{docmdi.h}
 
     The wxDocMDIParentFrame class provides a default top-level frame for
-    applications using the document/view framework. This class can only be used for
-    MDI parent frames.
+    applications using the document/view framework. This class can only be used
+    for MDI parent frames.
 
-    It cooperates with the wxView, wxDocument,
-    wxDocManager and wxDocTemplates classes.
-
-    See the example application in @c samples/docview.
+    It cooperates with the wxView, wxDocument, wxDocManager and wxDocTemplate
+    classes.
 
     @library{wxcore}
-    @category{FIXME}
+    @category{docview}
 
-    @seealso
-    @ref overview_docviewoverview, wxMDIParentFrame
+    @see @ref overview_docview, @ref page_samples_docview, wxMDIParentFrame
 */
 class wxDocMDIParentFrame : public wxMDIParentFrame
 {
@@ -60,31 +57,43 @@ public:
     /**
         Deletes all views and documents. If no user input cancelled the
         operation, the frame will be destroyed and the application will exit.
-        Since understanding how document/view clean-up takes place can be difficult,
-        the implementation of this function is shown below.
+
+        Since understanding how document/view clean-up takes place can be
+        difficult, the implementation of this function is shown below:
+
+        @code
+        void wxDocParentFrame::OnCloseWindow(wxCloseEvent& event)
+        {
+            if (m_docManager->Clear(!event.CanVeto()))
+            {
+                this->Destroy();
+            }
+            else
+                event.Veto();
+        }
+        @endcode
     */
     void OnCloseWindow(wxCloseEvent& event);
 };
 
 
+
 /**
     @class wxDocMDIChildFrame
     @wxheader{docmdi.h}
 
-    The wxDocMDIChildFrame class provides a default frame for displaying documents
-    on separate windows. This class can only be used for MDI child frames.
+    The wxDocMDIChildFrame class provides a default frame for displaying
+    documents on separate windows. This class can only be used for MDI child
+    frames.
 
     The class is part of the document/view framework supported by wxWidgets,
-    and cooperates with the wxView, wxDocument,
-    wxDocManager and wxDocTemplate classes.
-
-    See the example application in @c samples/docview.
+    and cooperates with the wxView, wxDocument, wxDocManager and wxDocTemplate
+    classes.
 
     @library{wxcore}
-    @category{FIXME}
+    @category{docview}
 
-    @seealso
-    @ref overview_docviewoverview, wxMDIChildFrame
+    @see @ref overview_docview, @ref page_samples_docview, wxMDIChildFrame
 */
 class wxDocMDIChildFrame : public wxMDIChildFrame
 {
@@ -93,8 +102,7 @@ public:
         Constructor.
     */
     wxDocMDIChildFrame(wxDocument* doc, wxView* view,
-                       wxFrame* parent,
-                       wxWindowID id,
+                       wxFrame* parent, wxWindowID id,
                        const wxString& title,
                        const wxPoint& pos = wxDefaultPosition,
                        const wxSize& size = wxDefaultSize,
@@ -109,12 +117,12 @@ public:
     /**
         Returns the document associated with this frame.
     */
-    wxDocument* GetDocument();
+    wxDocument* GetDocument() const;
 
     /**
         Returns the view associated with this frame.
     */
-    wxView* GetView();
+    wxView* GetView() const;
 
     /**
         Sets the currently active view to be the frame's view. You may need
@@ -137,15 +145,5 @@ public:
         Sets the view for this frame.
     */
     void SetView(wxView* view);
-
-    /**
-        wxDocument* m_childDocument
-        The document associated with the frame.
-    */
-
-
-    /**
-        wxView* m_childView
-        The view associated with the frame.
-    */
 };
+