include/wx/prntbase.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        prntbase.h
   3 // Purpose:     Base classes for printing framework
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_PRNTBASEH__
  13 #define _WX_PRNTBASEH__
  14
  15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  16     #pragma interface "prntbase.h"
  17 #endif
  18
  19 #include "wx/defs.h"
  20
  21 #if wxUSE_PRINTING_ARCHITECTURE
  22
  23 #include "wx/event.h"
  24 #include "wx/cmndata.h"
  25 #include "wx/panel.h"
  26 #include "wx/scrolwin.h"
  27 #include "wx/dialog.h"
  28 #include "wx/frame.h"
  29
  30 class WXDLLEXPORT wxDC;
  31 class WXDLLEXPORT wxButton;
  32 class WXDLLEXPORT wxChoice;
  33 class WXDLLEXPORT wxPrintout;
  34 class WXDLLEXPORT wxPrinterBase;
  35 class WXDLLEXPORT wxPrintDialog;
  36 class WXDLLEXPORT wxPrintPreviewBase;
  37 class WXDLLEXPORT wxPreviewCanvas;
  38 class WXDLLEXPORT wxPreviewControlBar;
  39 class WXDLLEXPORT wxPreviewFrame;
  40
  41
  42 enum wxPrinterError
  43 {
  44     wxPRINTER_NO_ERROR = 0,
  45     wxPRINTER_CANCELLED,
  46     wxPRINTER_ERROR
  47 };
  48
  49
  50 /*
  51  * Represents the printer: manages printing a wxPrintout object
  52  */
  53
  54 class WXDLLEXPORT wxPrinterBase: public wxObject
  55 {
  56 public:
  57     wxPrinterBase(wxPrintDialogData *data = (wxPrintDialogData *) NULL);
  58     virtual ~wxPrinterBase();
  59
  60     virtual wxWindow *CreateAbortWindow(wxWindow *parent, wxPrintout *printout);
  61     virtual void ReportError(wxWindow *parent, wxPrintout *printout, const wxString& message);
  62
  63     wxPrintDialogData& GetPrintDialogData() const
  64         { return (wxPrintDialogData&) m_printDialogData; }
  65     bool GetAbort() const { return sm_abortIt; }
  66
  67     static wxPrinterError GetLastError() { return sm_lastError; }
  68
  69     ///////////////////////////////////////////////////////////////////////////
  70     // OVERRIDES
  71
  72     virtual bool Setup(wxWindow *parent) = 0;
  73     virtual bool Print(wxWindow *parent, wxPrintout *printout, bool prompt = TRUE) = 0;
  74     virtual wxDC* PrintDialog(wxWindow *parent) = 0;
  75
  76 protected:
  77     wxPrintDialogData     m_printDialogData;
  78     wxPrintout*           m_currentPrintout;
  79
  80     static wxPrinterError sm_lastError;
  81
  82 public:
  83     static wxWindow*      sm_abortWindow;
  84     static bool           sm_abortIt;
  85
  86 private:
  87     DECLARE_CLASS(wxPrinterBase)
  88     DECLARE_NO_COPY_CLASS(wxPrinterBase)
  89 };
  90
  91 /*
  92  * wxPrintout
  93  * Represents an object via which a document may be printed.
  94  * The programmer derives from this, overrides (at least) OnPrintPage,
  95  * and passes it to a wxPrinter object for printing, or a wxPrintPreview
  96  * object for previewing.
  97  */
  98
  99 class WXDLLEXPORT wxPrintout: public wxObject
 100 {
 101 public:
 102     wxPrintout(const wxString& title = wxT("Printout"));
 103     virtual ~wxPrintout();
 104
 105     virtual bool OnBeginDocument(int startPage, int endPage);
 106     virtual void OnEndDocument();
 107     virtual void OnBeginPrinting();
 108     virtual void OnEndPrinting();
 109
 110     // Guaranteed to be before any other functions are called
 111     virtual void OnPreparePrinting() { }
 112
 113     virtual bool HasPage(int page);
 114     virtual bool OnPrintPage(int page) = 0;
 115     virtual void GetPageInfo(int *minPage, int *maxPage, int *pageFrom, int *pageTo);
 116
 117     virtual wxString GetTitle() const { return m_printoutTitle; }
 118
 119     wxDC *GetDC() const { return m_printoutDC; }
 120     void SetDC(wxDC *dc) { m_printoutDC = dc; }
 121     void SetPageSizePixels(int w, int  h) { m_pageWidthPixels = w; m_pageHeightPixels = h; }
 122     void GetPageSizePixels(int *w, int  *h) const { *w = m_pageWidthPixels; *h = m_pageHeightPixels; }
 123     void SetPageSizeMM(int w, int  h) { m_pageWidthMM = w; m_pageHeightMM = h; }
 124     void GetPageSizeMM(int *w, int  *h) const { *w = m_pageWidthMM; *h = m_pageHeightMM; }
 125
 126     void SetPPIScreen(int x, int y) { m_PPIScreenX = x; m_PPIScreenY = y; }
 127     void GetPPIScreen(int *x, int *y) const { *x = m_PPIScreenX; *y = m_PPIScreenY; }
 128     void SetPPIPrinter(int x, int y) { m_PPIPrinterX = x; m_PPIPrinterY = y; }
 129     void GetPPIPrinter(int *x, int *y) const { *x = m_PPIPrinterX; *y = m_PPIPrinterY; }
 130
 131     virtual bool IsPreview() const { return m_isPreview; }
 132
 133     virtual void SetIsPreview(bool p) { m_isPreview = p; }
 134
 135 private:
 136     wxString         m_printoutTitle;
 137     wxDC*            m_printoutDC;
 138
 139     int              m_pageWidthPixels;
 140     int              m_pageHeightPixels;
 141
 142     int              m_pageWidthMM;
 143     int              m_pageHeightMM;
 144
 145     int              m_PPIScreenX;
 146     int              m_PPIScreenY;
 147     int              m_PPIPrinterX;
 148     int              m_PPIPrinterY;
 149
 150     bool             m_isPreview;
 151
 152 private:
 153     DECLARE_ABSTRACT_CLASS(wxPrintout)
 154     DECLARE_NO_COPY_CLASS(wxPrintout)
 155 };
 156
 157 /*
 158  * wxPreviewCanvas
 159  * Canvas upon which a preview is drawn.
 160  */
 161
 162 class WXDLLEXPORT wxPreviewCanvas: public wxScrolledWindow
 163 {
 164 public:
 165     wxPreviewCanvas(wxPrintPreviewBase *preview,
 166                     wxWindow *parent,
 167                     const wxPoint& pos = wxDefaultPosition,
 168                     const wxSize& size = wxDefaultSize,
 169                     long style = 0,
 170                     const wxString& name = wxT("canvas"));
 171     ~wxPreviewCanvas();
 172
 173     void OnPaint(wxPaintEvent& event);
 174     void OnChar(wxKeyEvent &event);
 175
 176     // Responds to colour changes
 177     void OnSysColourChanged(wxSysColourChangedEvent& event);
 178
 179 private:
 180     wxPrintPreviewBase* m_printPreview;
 181
 182     DECLARE_CLASS(wxPreviewCanvas)
 183     DECLARE_EVENT_TABLE()
 184     DECLARE_NO_COPY_CLASS(wxPreviewCanvas)
 185 };
 186
 187 /*
 188  * wxPreviewFrame
 189  * Default frame for showing preview.
 190  */
 191
 192 class WXDLLEXPORT wxPreviewFrame: public wxFrame
 193 {
 194 public:
 195     wxPreviewFrame(wxPrintPreviewBase *preview,
 196                    wxWindow *parent,
 197                    const wxString& title = wxT("Print Preview"),
 198                    const wxPoint& pos = wxDefaultPosition,
 199                    const wxSize& size = wxDefaultSize,
 200                    long style = wxDEFAULT_FRAME_STYLE,
 201                    const wxString& name = wxT("frame"));
 202     ~wxPreviewFrame();
 203
 204     void OnCloseWindow(wxCloseEvent& event);
 205     virtual void Initialize();
 206     virtual void CreateCanvas();
 207     virtual void CreateControlBar();
 208
 209     inline wxPreviewControlBar* GetControlBar() const { return m_controlBar; }
 210
 211 protected:
 212     wxPreviewCanvas*      m_previewCanvas;
 213     wxPreviewControlBar*  m_controlBar;
 214     wxPrintPreviewBase*   m_printPreview;
 215     wxWindowDisabler*     m_windowDisabler;
 216
 217 private:
 218     DECLARE_CLASS(wxPreviewFrame)
 219     DECLARE_EVENT_TABLE()
 220     DECLARE_NO_COPY_CLASS(wxPreviewFrame)
 221 };
 222
 223 /*
 224  * wxPreviewControlBar
 225  * A panel with buttons for controlling a print preview.
 226  * The programmer may wish to use other means for controlling
 227  * the print preview.
 228  */
 229
 230 #define wxPREVIEW_PRINT        1
 231 #define wxPREVIEW_PREVIOUS     2
 232 #define wxPREVIEW_NEXT         4
 233 #define wxPREVIEW_ZOOM         8
 234 #define wxPREVIEW_FIRST       16
 235 #define wxPREVIEW_LAST        32
 236 #define wxPREVIEW_GOTO        64
 237
 238 #define wxPREVIEW_DEFAULT  wxPREVIEW_PREVIOUS|wxPREVIEW_NEXT|wxPREVIEW_ZOOM\
 239                           |wxPREVIEW_FIRST|wxPREVIEW_GOTO|wxPREVIEW_LAST
 240
 241 // Ids for controls
 242 #define wxID_PREVIEW_CLOSE      1
 243 #define wxID_PREVIEW_NEXT       2
 244 #define wxID_PREVIEW_PREVIOUS   3
 245 #define wxID_PREVIEW_PRINT      4
 246 #define wxID_PREVIEW_ZOOM       5
 247 #define wxID_PREVIEW_FIRST      6
 248 #define wxID_PREVIEW_LAST       7
 249 #define wxID_PREVIEW_GOTO       8
 250
 251 class WXDLLEXPORT wxPreviewControlBar: public wxPanel
 252 {
 253     DECLARE_CLASS(wxPreviewControlBar)
 254
 255 public:
 256     wxPreviewControlBar(wxPrintPreviewBase *preview,
 257                         long buttons,
 258                         wxWindow *parent,
 259                         const wxPoint& pos = wxDefaultPosition,
 260                         const wxSize& size = wxDefaultSize,
 261                         long style = wxTAB_TRAVERSAL,
 262                         const wxString& name = wxT("panel"));
 263     ~wxPreviewControlBar();
 264
 265     virtual void CreateButtons();
 266     virtual void SetZoomControl(int zoom);
 267     virtual int GetZoomControl();
 268     virtual wxPrintPreviewBase *GetPrintPreview() const
 269         { return m_printPreview; }
 270
 271     void OnWindowClose(wxCommandEvent& event);
 272     void OnNext();
 273     void OnPrevious();
 274     void OnFirst();
 275     void OnLast();
 276     void OnGoto();
 277     void OnPrint();
 278     void OnPrintButton(wxCommandEvent& WXUNUSED(event)) { OnPrint(); }
 279     void OnNextButton(wxCommandEvent & WXUNUSED(event)) { OnNext(); }
 280     void OnPreviousButton(wxCommandEvent & WXUNUSED(event)) { OnPrevious(); }
 281     void OnFirstButton(wxCommandEvent & WXUNUSED(event)) { OnFirst(); }
 282     void OnLastButton(wxCommandEvent & WXUNUSED(event)) { OnLast(); }
 283     void OnGotoButton(wxCommandEvent & WXUNUSED(event)) { OnGoto(); }
 284     void OnZoom(wxCommandEvent& event);
 285     void OnPaint(wxPaintEvent& event);
 286
 287 protected:
 288     wxPrintPreviewBase*   m_printPreview;
 289     wxButton*             m_closeButton;
 290     wxButton*             m_nextPageButton;
 291     wxButton*             m_previousPageButton;
 292     wxButton*             m_printButton;
 293     wxChoice*             m_zoomControl;
 294     wxButton*             m_firstPageButton;
 295     wxButton*             m_lastPageButton;
 296     wxButton*             m_gotoPageButton;
 297     long                  m_buttonFlags;
 298
 299 private:
 300     DECLARE_EVENT_TABLE()
 301     DECLARE_NO_COPY_CLASS(wxPreviewControlBar)
 302 };
 303
 304 /*
 305  * wxPrintPreview
 306  * Programmer creates an object of this class to preview a wxPrintout.
 307  */
 308
 309 class WXDLLEXPORT wxPrintPreviewBase: public wxObject
 310 {
 311     DECLARE_CLASS(wxPrintPreviewBase)
 312
 313 public:
 314     wxPrintPreviewBase(wxPrintout *printout,
 315                        wxPrintout *printoutForPrinting = (wxPrintout *) NULL,
 316                        wxPrintDialogData *data = (wxPrintDialogData *) NULL);
 317     wxPrintPreviewBase(wxPrintout *printout,
 318                        wxPrintout *printoutForPrinting,
 319                        wxPrintData *data);
 320     virtual ~wxPrintPreviewBase();
 321
 322     virtual bool SetCurrentPage(int pageNum);
 323     int GetCurrentPage() const { return m_currentPage; };
 324
 325     void SetPrintout(wxPrintout *printout) { m_previewPrintout = printout; };
 326     wxPrintout *GetPrintout() const { return m_previewPrintout; };
 327     wxPrintout *GetPrintoutForPrinting() const { return m_printPrintout; };
 328
 329     void SetFrame(wxFrame *frame) { m_previewFrame = frame; };
 330     void SetCanvas(wxPreviewCanvas *canvas) { m_previewCanvas = canvas; };
 331
 332     virtual wxFrame *GetFrame() const { return m_previewFrame; }
 333     virtual wxPreviewCanvas *GetCanvas() const { return m_previewCanvas; }
 334
 335     // The preview canvas should call this from OnPaint
 336     virtual bool PaintPage(wxPreviewCanvas *canvas, wxDC& dc);
 337
 338     // This draws a blank page onto the preview canvas
 339     virtual bool DrawBlankPage(wxPreviewCanvas *canvas, wxDC& dc);
 340
 341     // Adjusts the scrollbars for the current scale
 342     virtual void AdjustScrollbars(wxPreviewCanvas *canvas);
 343
 344     // This is called by wxPrintPreview to render a page into a wxMemoryDC.
 345     virtual bool RenderPage(int pageNum);
 346
 347     wxPrintDialogData& GetPrintDialogData() { return m_printDialogData; }
 348
 349     virtual void SetZoom(int percent);
 350     int GetZoom() const { return m_currentZoom; };
 351
 352     int GetMaxPage() const { return m_maxPage; }
 353     int GetMinPage() const { return m_minPage; }
 354
 355     bool Ok() const { return m_isOk; }
 356     void SetOk(bool ok) { m_isOk = ok; }
 357
 358     ///////////////////////////////////////////////////////////////////////////
 359     // OVERRIDES
 360
 361     // If we own a wxPrintout that can be used for printing, this
 362     // will invoke the actual printing procedure. Called
 363     // by the wxPreviewControlBar.
 364     virtual bool Print(bool interactive) = 0;
 365
 366     // Calculate scaling that needs to be done to get roughly
 367     // the right scaling for the screen pretending to be
 368     // the currently selected printer.
 369     virtual void DetermineScaling() = 0;
 370
 371 protected:
 372     wxPrintDialogData m_printDialogData;
 373     wxPreviewCanvas*  m_previewCanvas;
 374     wxFrame*          m_previewFrame;
 375     wxBitmap*         m_previewBitmap;
 376     wxPrintout*       m_previewPrintout;
 377     wxPrintout*       m_printPrintout;
 378     int               m_currentPage;
 379     int               m_currentZoom;
 380     float             m_previewScale;
 381     int               m_topMargin;
 382     int               m_leftMargin;
 383     int               m_pageWidth;
 384     int               m_pageHeight;
 385     int               m_minPage;
 386     int               m_maxPage;
 387
 388     bool              m_isOk;
 389     bool              m_printingPrepared; // Called OnPreparePrinting?
 390
 391 private:
 392     void Init(wxPrintout *printout, wxPrintout *printoutForPrinting);
 393
 394     DECLARE_NO_COPY_CLASS(wxPrintPreviewBase)
 395 };
 396
 397 /*
 398  * Abort dialog
 399  */
 400
 401 class WXDLLEXPORT wxPrintAbortDialog: public wxDialog
 402 {
 403 public:
 404     wxPrintAbortDialog(wxWindow *parent,
 405                        const wxString& title,
 406                        const wxPoint& pos = wxDefaultPosition,
 407                        const wxSize& size = wxDefaultSize,
 408                        long style = 0,
 409                        const wxString& name = wxT("dialog"))
 410         : wxDialog(parent, -1, title, pos, size, style, name)
 411         {
 412         }
 413
 414     void OnCancel(wxCommandEvent& event);
 415
 416 private:
 417     DECLARE_EVENT_TABLE()
 418     DECLARE_NO_COPY_CLASS(wxPrintAbortDialog)
 419 };
 420
 421 #endif // wxUSE_PRINTING_ARCHITECTURE
 422
 423 #endif
 424     // _WX_PRNTBASEH__