X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2cd3cc948ea512eba91032323fe32207ac74bf8e..a25a17732c2d4d34d5d35a5318053dd8c6e29722:/docs/doxygen/overviews/printing.h diff --git a/docs/doxygen/overviews/printing.h b/docs/doxygen/overviews/printing.h index de21b4b77b..6026fa7e6e 100644 --- a/docs/doxygen/overviews/printing.h +++ b/docs/doxygen/overviews/printing.h @@ -6,9 +6,9 @@ // Licence: wxWindows license ///////////////////////////////////////////////////////////////////////////// -/*! +/** -@page overview_printing Printing Overview +@page overview_printing Printing Framework Overview Classes: @li wxPrintout @@ -22,6 +22,22 @@ Classes: @li wxPageSetupDialog @li wxPageSetupDialogData + +@li @ref overview_printing_printout +@li @ref overview_printing_printer +@li @ref overview_printing_printpreview +@li @ref overview_printing_printerdc +@li @ref overview_printing_postscriptdc +@li @ref overview_printing_printdialog +@li @ref overview_printing_printdata +@li @ref overview_printing_printdialogdata +@li @ref overview_printing_pagesetupdialog +@li @ref overview_printing_pagesetupdialogdata + + +
+ + The printing framework relies on the application to provide classes whose member functions can respond to particular requests, such as 'print this page' or 'does this page exist in the document?'. This method allows wxWidgets to @@ -81,7 +97,7 @@ printing under MSW and Mac), or a wxPostScriptDC (for printing under GTK or generating PostScript output). The @ref overview_docview "document/view framework" creates a default -wxPrintout object for every view, calling wxView::OnDraw to achieve a +wxPrintout object for every view, calling wxView::OnDraw() to achieve a prepackaged print/preview facility. If your window classes have a Draw(wxDC *dc) routine to do screen rendering, @@ -125,7 +141,7 @@ There are two important rectangles in printing: the page rectangle defines the printable area seen by the application, and under MSW and Mac, it is the printable area specified by the printer. (For PostScript printing, the page rectangle is the entire page.) The inherited function -wxDC::GetSize returns the page size in device pixels. The +wxDC::GetSize() returns the page size in device pixels. The point (0,0) on the wxPrinterDC represents the top left corner of the page rectangle; that is, the page rect is given by wxRect(0, 0, w, h), where (w,h) are the values returned by GetSize. @@ -134,7 +150,7 @@ The paper rectangle, on the other hand, represents the entire paper area including the non-printable border. Thus, the coordinates of the top left corner of the paper rectangle will have small negative values, while the width and height will be somewhat larger than that of the page rectangle. The -wxPrinterDC-specific function wxPrinterDC::GetPaperRect returns the paper +wxPrinterDC-specific function wxPrinterDC::GetPaperRect() returns the paper rectangle of the given wxPrinterDC.