docs/latex/wx/tprint.tex

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