| | 1 | \section{Printing overview}\label{printingoverview} |
| | 2 | |
| | 3 | Classes: \helpref{wxPrintout}{wxprintout}, \helpref{wxPrinter}{wxprinter},\rtfsp |
| | 4 | \helpref{wxPrintPreview}{wxprintpreview}, \helpref{wxPrinterDC}{wxprinterdc},\rtfsp |
| | 5 | \helpref{wxPrintDialog}{wxprintdialog}. |
| | 6 | |
| | 7 | The printing framework relies on the application to provide classes |
| | 8 | whose member functions can respond to particular requests, such |
| | 9 | as `print this page' or `does this page exist in the document?'. |
| | 10 | This method allows wxWindows to take over the housekeeping duties of |
| | 11 | turning preview pages, calling the print dialog box, creating |
| | 12 | the printer device context, and so on: the application can concentrate |
| | 13 | on the rendering of the information onto a device context. |
| | 14 | The printing framework is mainly a Windows feature; PostScript |
| | 15 | support under non-Windows platforms is emerging but has not been rigorously tested. |
| | 16 | |
| | 17 | The \helpref{document/view framework}{docviewoverview} creates a default wxPrintout |
| | 18 | object for every view, calling wxView::OnDraw to achieve a |
| | 19 | prepackaged print/preview facility. |
| | 20 | |
| | 21 | A document's printing ability is represented in an application by a |
| | 22 | derived wxPrintout class. This class prints a page on request, and can |
| | 23 | be passed to the Print function of a wxPrinter object to actually print |
| | 24 | the document, or can be passed to a wxPrintPreview object to initiate |
| | 25 | previewing. The following code (from the printing sample) shows how easy |
| | 26 | it is to initiate printing, previewing and the print setup dialog, once the wxPrintout |
| | 27 | functionality has been defined. Notice the use of MyPrintout for |
| | 28 | both printing and previewing. All the preview user interface functionality |
| | 29 | is taken care of by wxWindows. For details on how MyPrintout is defined, |
| | 30 | please look at the printout sample code. |
| | 31 | |
| | 32 | \begin{verbatim} |
| | 33 | case WXPRINT_PRINT: |
| | 34 | { |
| | 35 | wxPrinter printer; |
| | 36 | MyPrintout printout("My printout"); |
| | 37 | printer.Print(this, &printout, TRUE); |
| | 38 | break; |
| | 39 | } |
| | 40 | case WXPRINT_PREVIEW: |
| | 41 | { |
| | 42 | // Pass two printout objects: for preview, and possible printing. |
| | 43 | wxPrintPreview *preview = new wxPrintPreview(new MyPrintout, new MyPrintout); |
| | 44 | wxPreviewFrame *frame = new wxPreviewFrame(preview, this, "Demo Print Preview", 100, 100, 600, 650); |
| | 45 | frame->Centre(wxBOTH); |
| | 46 | frame->Initialize(); |
| | 47 | frame->Show(TRUE); |
| | 48 | break; |
| | 49 | } |
| | 50 | case WXPRINT_PRINT_SETUP: |
| | 51 | { |
| | 52 | wxPrintDialog printerDialog(this); |
| | 53 | printerDialog.GetPrintData().SetSetupDialog(TRUE); |
| | 54 | printerDialog.Show(TRUE); |
| | 55 | break; |
| | 56 | } |
| | 57 | \end{verbatim} |
| | 58 | |
| | 59 | |
projects / wxWidgets.git / blame_incremental