added interface headers with latest discussed changes

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52381 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/printdlg.h

@@ -0,0 +1,124 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        printdlg.h
+// Purpose:     documentation for wxPrintDialog class
+// Author:      wxWidgets team
+// RCS-ID:      $Id$
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+/**
+    @class wxPrintDialog
+    @wxheader{printdlg.h}
+    
+    This class represents the print and print setup common dialogs.
+    You may obtain a wxPrinterDC device context from
+    a successfully dismissed print dialog.
+    
+    @library{wxcore}
+    @category{printing}
+    
+    @seealso
+    @ref overview_printingoverview "Printing framework overview", @ref
+    overview_wxprintdialogoverview "wxPrintDialog Overview"
+*/
+class wxPrintDialog : public wxDialog
+{
+public:
+    /**
+        Constructor. Pass a parent window, and optionally a pointer to a block of print
+        data, which will be copied to the print dialog's print data.
+        
+        @sa wxPrintDialogData
+    */
+    wxPrintDialog(wxWindow* parent, wxPrintDialogData* data = @NULL);
+
+    /**
+        Destructor. If GetPrintDC() has @e not been called,
+        the device context obtained by the dialog (if any) will be deleted.
+    */
+    ~wxPrintDialog();
+
+    /**
+        Returns the device context created by the print dialog, if any.
+        When this function has been called, the ownership of the device context
+        is transferred to the application, so it must then be deleted
+        explicitly.
+    */
+    wxDC* GetPrintDC();
+
+    /**
+        Returns the @ref overview_wxprintdialogdata "print dialog data" associated with
+        the print dialog.
+    */
+    wxPrintDialogData GetPrintDialogData();
+
+    /**
+        Shows the dialog, returning wxID_OK if the user pressed OK, and wxID_CANCEL
+        otherwise. After this function is called, a device context may
+        be retrievable using GetPrintDC().
+    */
+    int ShowModal();
+};
+
+
+/**
+    @class wxPageSetupDialog
+    @wxheader{printdlg.h}
+    
+    This class represents the page setup common dialog. In MSW, the page setup
+    dialog is standard from Windows 95 on, replacing the print setup dialog (which
+    is retained in Windows and wxWidgets for backward compatibility). On Windows 95
+    and NT 4.0 and above, the page setup dialog is native to the windowing system,
+    otherwise it is emulated.
+    
+    The page setup dialog contains controls for paper size (A4, A5 etc.),
+    orientation (landscape or portrait), and controls for setting left, top, right
+    and bottom margin sizes in millimetres.
+    
+    On Macintosh, the native page setup dialog is used, which lets you select paper
+    size and orientation but it does not let you change the page margins.
+    
+    On other platforms, a generic dialog is used.
+    
+    When the dialog has been closed, you need to query the
+    wxPageSetupDialogData object associated with
+    the dialog.
+    
+    Note that the OK and Cancel buttons do not destroy the dialog; this must be done
+    by the application.
+    
+    @library{wxcore}
+    @category{printing}
+    
+    @seealso
+    @ref overview_printingoverview "Printing framework overview", wxPrintDialog,
+    wxPageSetupDialogData
+*/
+class wxPageSetupDialog : public wxDialog
+{
+public:
+    /**
+        Constructor. Pass a parent window, and optionally a pointer to a block of page
+        setup
+        data, which will be copied to the print dialog's internal data.
+    */
+    wxPageSetupDialog(wxWindow* parent,
+                      wxPageSetupDialogData* data = @NULL);
+
+    /**
+        Destructor.
+    */
+    ~wxPageSetupDialog();
+
+    /**
+        Returns the @ref overview_wxpagesetupdialogdata "page setup data" associated
+        with the dialog.
+    */
+    wxPageSetupDialogData GetPageSetupData();
+
+    /**
+        Shows the dialog, returning wxID_OK if the user pressed OK, and wxID_CANCEL
+        otherwise.
+    */
+    int ShowModal();
+};