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