]> git.saurik.com Git - wxWidgets.git/blame - include/wx/prntbase.h
IS_KIND_OF -> wxIS_KIND_OF compilation fix
[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$
8// Copyright: (c) Julian Smart and Markus Holzem
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
34138703
JS
12#ifndef _WX_PRNTBASEH__
13#define _WX_PRNTBASEH__
c801d85f
KB
14
15#ifdef __GNUG__
0d3820b3 16#pragma interface "prntbase.h"
c801d85f
KB
17#endif
18
19#include "wx/defs.h"
20#include "wx/event.h"
21#include "wx/cmndata.h"
22#include "wx/panel.h"
23#include "wx/scrolwin.h"
24#include "wx/dialog.h"
34138703 25#include "wx/frame.h"
c801d85f
KB
26
27class WXDLLEXPORT wxDC;
28class WXDLLEXPORT wxButton;
29class WXDLLEXPORT wxChoice;
30class WXDLLEXPORT wxPrintout;
31class WXDLLEXPORT wxPrinterBase;
32class WXDLLEXPORT wxPrintDialog;
33class WXDLLEXPORT wxPrintPreviewBase;
34class WXDLLEXPORT wxPreviewCanvas;
35class WXDLLEXPORT wxPreviewControlBar;
36class WXDLLEXPORT wxPreviewFrame;
37
38/*
39 * Represents the printer: manages printing a wxPrintout object
40 */
41
42class WXDLLEXPORT wxPrinterBase: public wxObject
43{
44 DECLARE_CLASS(wxPrinterBase)
45
34da0970 46public:
c67daf87 47 wxPrinterBase(wxPrintData *data = (wxPrintData *) NULL);
34da0970 48 ~wxPrinterBase();
c801d85f
KB
49
50 virtual wxWindow *CreateAbortWindow(wxWindow *parent, wxPrintout *printout);
51 virtual void ReportError(wxWindow *parent, wxPrintout *printout, char *message);
34da0970
JS
52 inline wxPrintData& GetPrintData() { return m_printData; };
53 inline bool GetAbort() { return sm_abortIt; }
c801d85f
KB
54
55 ///////////////////////////////////////////////////////////////////////////
56 // OVERRIDES
57
58 virtual bool Setup(wxWindow *parent) = 0;
59 virtual bool Print(wxWindow *parent, wxPrintout *printout, bool prompt = TRUE) = 0;
60 virtual bool PrintDialog(wxWindow *parent) = 0;
34da0970
JS
61
62protected:
63 wxPrintData m_printData;
64 wxPrintout* m_currentPrintout;
65public:
66 static wxWindow* sm_abortWindow;
67 static bool sm_abortIt;
68
c801d85f
KB
69};
70
71/*
72 * wxPrintout
73 * Represents an object via which a document may be printed.
74 * The programmer derives from this, overrides (at least) OnPrintPage,
75 * and passes it to a wxPrinter object for printing, or a wxPrintPreview
76 * object for previewing.
77 */
78
79class WXDLLEXPORT wxPrintout: public wxObject
80{
81 DECLARE_ABSTRACT_CLASS(wxPrintout)
82
34da0970
JS
83public:
84 wxPrintout(const wxString& title = "Printout");
85 ~wxPrintout();
c801d85f
KB
86
87 virtual bool OnBeginDocument(int startPage, int endPage);
34da0970
JS
88 virtual void OnEndDocument();
89 virtual void OnBeginPrinting();
90 virtual void OnEndPrinting();
c801d85f
KB
91
92 // Guaranteed to be before any other functions are called
34da0970 93 inline virtual void OnPreparePrinting() { }
c801d85f
KB
94
95 virtual bool HasPage(int page);
96 virtual bool OnPrintPage(int page) = 0;
97 virtual void GetPageInfo(int *minPage, int *maxPage, int *pageFrom, int *pageTo);
98
34da0970
JS
99 inline virtual wxString GetTitle() { return m_printoutTitle; }
100
101 inline wxDC *GetDC() { return m_printoutDC; }
102 inline void SetDC(wxDC *dc) { m_printoutDC = dc; }
103 inline void SetPageSizePixels(int w, int h) { m_pageWidthPixels = w; m_pageHeightPixels = h; }
104 inline void GetPageSizePixels(int *w, int *h) { *w = m_pageWidthPixels; *h = m_pageHeightPixels; }
105 inline void SetPageSizeMM(int w, int h) { m_pageWidthMM = w; m_pageHeightMM = h; }
106 inline void GetPageSizeMM(int *w, int *h) { *w = m_pageWidthMM; *h = m_pageHeightMM; }
107
108 inline void SetPPIScreen(int x, int y) { m_PPIScreenX = x; m_PPIScreenY = y; }
109 inline void GetPPIScreen(int *x, int *y) { *x = m_PPIScreenX; *y = m_PPIScreenY; }
110 inline void SetPPIPrinter(int x, int y) { m_PPIPrinterX = x; m_PPIPrinterY = y; }
111 inline void GetPPIPrinter(int *x, int *y) { *x = m_PPIPrinterX; *y = m_PPIPrinterY; }
112
113 inline virtual bool IsPreview() { return m_isPreview; }
114
115 inline virtual void SetIsPreview(bool p) { m_isPreview = p; }
116
117private:
118 wxString m_printoutTitle;
119 wxDC* m_printoutDC;
c801d85f 120
34da0970
JS
121 int m_pageWidthPixels;
122 int m_pageHeightPixels;
c801d85f 123
34da0970
JS
124 int m_pageWidthMM;
125 int m_pageHeightMM;
c801d85f 126
34da0970
JS
127 int m_PPIScreenX;
128 int m_PPIScreenY;
129 int m_PPIPrinterX;
130 int m_PPIPrinterY;
c801d85f 131
34da0970 132 bool m_isPreview;
c801d85f
KB
133};
134
135/*
136 * wxPreviewCanvas
137 * Canvas upon which a preview is drawn.
138 */
139
140class WXDLLEXPORT wxPreviewCanvas: public wxScrolledWindow
141{
142 DECLARE_CLASS(wxPreviewCanvas)
143
34da0970 144public:
c801d85f
KB
145 wxPreviewCanvas(wxPrintPreviewBase *preview, wxWindow *parent,
146 const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
147 long style = 0, const wxString& name = "canvas");
34da0970 148 ~wxPreviewCanvas();
c801d85f
KB
149
150 void OnPaint(wxPaintEvent& event);
151
152 // Responds to colour changes
153 void OnSysColourChanged(wxSysColourChangedEvent& event);
154
34da0970
JS
155private:
156 wxPrintPreviewBase* m_printPreview;
157
c801d85f
KB
158DECLARE_EVENT_TABLE()
159};
160
161/*
162 * wxPreviewFrame
163 * Default frame for showing preview.
164 */
165
166class WXDLLEXPORT wxPreviewFrame: public wxFrame
167{
168 DECLARE_CLASS(wxPreviewFrame)
169
34da0970 170public:
c801d85f
KB
171 wxPreviewFrame(wxPrintPreviewBase *preview, wxFrame *parent, const wxString& title = "Print Preview",
172 const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
f5419957 173 long style = wxDEFAULT_FRAME_STYLE, const wxString& name = "frame");
34da0970 174 ~wxPreviewFrame();
c801d85f 175
34da0970
JS
176 bool OnClose();
177 virtual void Initialize();
178 virtual void CreateCanvas();
179 virtual void CreateControlBar();
180
181protected:
182 wxWindow* m_previewCanvas;
183 wxPreviewControlBar* m_controlBar;
184 wxPrintPreviewBase* m_printPreview;
c801d85f
KB
185};
186
187/*
188 * wxPreviewControlBar
189 * A panel with buttons for controlling a print preview.
190 * The programmer may wish to use other means for controlling
191 * the print preview.
192 */
193
194#define wxPREVIEW_PRINT 1
195#define wxPREVIEW_PREVIOUS 2
196#define wxPREVIEW_NEXT 4
197#define wxPREVIEW_ZOOM 8
198
199#define wxPREVIEW_DEFAULT wxPREVIEW_PREVIOUS|wxPREVIEW_NEXT|wxPREVIEW_ZOOM
200
201// Ids for controls
202#define wxID_PREVIEW_CLOSE 1
203#define wxID_PREVIEW_NEXT 2
204#define wxID_PREVIEW_PREVIOUS 3
205#define wxID_PREVIEW_PRINT 4
206#define wxID_PREVIEW_ZOOM 5
207
208class WXDLLEXPORT wxPreviewControlBar: public wxPanel
209{
210 DECLARE_CLASS(wxPreviewControlBar)
211
34da0970 212public:
c801d85f
KB
213 wxPreviewControlBar(wxPrintPreviewBase *preview, long buttons,
214 wxWindow *parent, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
215 long style = 0, const wxString& name = "panel");
34da0970 216 ~wxPreviewControlBar();
c801d85f 217
34da0970 218 virtual void CreateButtons();
c801d85f 219 virtual void SetZoomControl(int zoom);
34da0970
JS
220 virtual int GetZoomControl();
221 inline virtual wxPrintPreviewBase *GetPrintPreview() const { return m_printPreview; }
c801d85f
KB
222
223 void OnPrint(wxCommandEvent& event);
224 void OnClose(wxCommandEvent& event);
225 void OnNext(wxCommandEvent& event);
226 void OnPrevious(wxCommandEvent& event);
227 void OnZoom(wxCommandEvent& event);
228 void OnPaint(wxPaintEvent& event);
229
34da0970
JS
230protected:
231 wxPrintPreviewBase* m_printPreview;
232 wxButton* m_closeButton;
233 wxButton* m_nextPageButton;
234 wxButton* m_previousPageButton;
235 wxButton* m_printButton;
236 wxChoice* m_zoomControl;
237 long m_buttonFlags;
238
c801d85f
KB
239DECLARE_EVENT_TABLE()
240};
241
242/*
243 * wxPrintPreview
244 * Programmer creates an object of this class to preview a wxPrintout.
245 */
246
247class WXDLLEXPORT wxPrintPreviewBase: public wxObject
248{
249 DECLARE_CLASS(wxPrintPreviewBase)
250
34da0970 251public:
c67daf87 252 wxPrintPreviewBase(wxPrintout *printout, wxPrintout *printoutForPrinting = (wxPrintout *) NULL, wxPrintData *data = (wxPrintData *) NULL);
34da0970 253 ~wxPrintPreviewBase();
c801d85f
KB
254
255 virtual bool SetCurrentPage(int pageNum);
34da0970 256 inline int GetCurrentPage() const { return m_currentPage; };
c801d85f 257
34da0970
JS
258 inline void SetPrintout(wxPrintout *printout) { m_previewPrintout = printout; };
259 inline wxPrintout *GetPrintout() const { return m_previewPrintout; };
260 inline wxPrintout *GetPrintoutForPrinting() const { return m_printPrintout; };
c801d85f 261
34da0970
JS
262 inline void SetFrame(wxFrame *frame) { m_previewFrame = frame; };
263 inline void SetCanvas(wxWindow *canvas) { m_previewCanvas = canvas; };
c801d85f 264
34da0970
JS
265 inline virtual wxFrame *GetFrame() const { return m_previewFrame; }
266 inline virtual wxWindow *GetCanvas() const { return m_previewCanvas; }
c801d85f
KB
267
268 // The preview canvas should call this from OnPaint
269 virtual bool PaintPage(wxWindow *canvas, wxDC& dc);
270
271 // This draws a blank page onto the preview canvas
272 virtual bool DrawBlankPage(wxWindow *canvas, wxDC& dc);
273
274 // This is called by wxPrintPreview to render a page into
275 // a wxMemoryDC.
276 virtual bool RenderPage(int pageNum);
277
34da0970 278 inline wxPrintData& GetPrintData() { return m_printData; }
c801d85f
KB
279
280 virtual void SetZoom(int percent);
34da0970
JS
281 inline int GetZoom() const { return m_currentZoom; };
282
283 inline int GetMaxPage() const { return m_maxPage; }
284 inline int GetMinPage() const { return m_minPage; }
c801d85f 285
34da0970
JS
286 inline bool Ok() const { return m_isOk; }
287 inline void SetOk(bool ok) { m_isOk = ok; }
c801d85f
KB
288
289 ///////////////////////////////////////////////////////////////////////////
290 // OVERRIDES
291
292 // If we own a wxPrintout that can be used for printing, this
293 // will invoke the actual printing procedure. Called
294 // by the wxPreviewControlBar.
295 virtual bool Print(bool interactive) = 0;
296
297 // Calculate scaling that needs to be done to get roughly
298 // the right scaling for the screen pretending to be
299 // the currently selected printer.
34da0970
JS
300 virtual void DetermineScaling() = 0;
301
302protected:
303 wxPrintData m_printData;
304 wxWindow* m_previewCanvas;
305 wxFrame* m_previewFrame;
306 wxBitmap* m_previewBitmap;
307 wxPrintout* m_previewPrintout;
308 wxPrintout* m_printPrintout;
309 int m_currentPage;
310 int m_currentZoom;
311 float m_previewScale;
312 int m_topMargin;
313 int m_leftMargin;
314 int m_pageWidth;
315 int m_pageHeight;
316 int m_minPage;
317 int m_maxPage;
318 protected:
319 bool m_isOk;
c801d85f
KB
320};
321
322/*
323 * Abort dialog
324 */
325
326class WXDLLEXPORT wxPrintAbortDialog: public wxDialog
327{
328public:
c801d85f
KB
329 wxPrintAbortDialog(wxWindow *parent,
330 const wxString& title, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize,
331 long style = 0, const wxString& name = "dialog"):
332 wxDialog(parent, -1, title, pos, size, style, name)
333 {
334 }
335
34da0970
JS
336 void OnCancel(wxCommandEvent& event);
337
c801d85f
KB
338 DECLARE_EVENT_TABLE()
339};
340
341#endif
34138703 342 // _WX_PRNTBASEH__