]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/gdicmn.h
Fixed bug [ 865999 ] wxRETAINED windows appear blank on MSW.
[wxWidgets.git] / include / wx / gdicmn.h
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: gdicmn.h
3// Purpose: Common GDI classes, types and declarations
4// Author: Julian Smart
5// Modified by:
6// Created: 01/02/97
7// RCS-ID: $Id$
8// Copyright: (c)
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_GDICMNH__
13#define _WX_GDICMNH__
14
15// ---------------------------------------------------------------------------
16// headers
17// ---------------------------------------------------------------------------
18
19#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
20 #pragma interface "gdicmn.h"
21#endif
22
23#include "wx/setup.h"
24#include "wx/list.h"
25#include "wx/string.h"
26#include "wx/fontenc.h"
27
28// ---------------------------------------------------------------------------
29// forward declarations
30// ---------------------------------------------------------------------------
31
32class WXDLLEXPORT wxBitmap;
33class WXDLLEXPORT wxBrush;
34class WXDLLEXPORT wxColour;
35class WXDLLEXPORT wxCursor;
36class WXDLLEXPORT wxFont;
37class WXDLLEXPORT wxIcon;
38class WXDLLEXPORT wxPalette;
39class WXDLLEXPORT wxPen;
40class WXDLLEXPORT wxRegion;
41class WXDLLEXPORT wxString;
42
43// ---------------------------------------------------------------------------
44// constants
45// ---------------------------------------------------------------------------
46
47// Bitmap flags
48enum wxBitmapType
49{
50 wxBITMAP_TYPE_INVALID, // should be == 0 for compatibility!
51 wxBITMAP_TYPE_BMP,
52 wxBITMAP_TYPE_BMP_RESOURCE,
53 wxBITMAP_TYPE_RESOURCE = wxBITMAP_TYPE_BMP_RESOURCE,
54 wxBITMAP_TYPE_ICO,
55 wxBITMAP_TYPE_ICO_RESOURCE,
56 wxBITMAP_TYPE_CUR,
57 wxBITMAP_TYPE_CUR_RESOURCE,
58 wxBITMAP_TYPE_XBM,
59 wxBITMAP_TYPE_XBM_DATA,
60 wxBITMAP_TYPE_XPM,
61 wxBITMAP_TYPE_XPM_DATA,
62 wxBITMAP_TYPE_TIF,
63 wxBITMAP_TYPE_TIF_RESOURCE,
64 wxBITMAP_TYPE_GIF,
65 wxBITMAP_TYPE_GIF_RESOURCE,
66 wxBITMAP_TYPE_PNG,
67 wxBITMAP_TYPE_PNG_RESOURCE,
68 wxBITMAP_TYPE_JPEG,
69 wxBITMAP_TYPE_JPEG_RESOURCE,
70 wxBITMAP_TYPE_PNM,
71 wxBITMAP_TYPE_PNM_RESOURCE,
72 wxBITMAP_TYPE_PCX,
73 wxBITMAP_TYPE_PCX_RESOURCE,
74 wxBITMAP_TYPE_PICT,
75 wxBITMAP_TYPE_PICT_RESOURCE,
76 wxBITMAP_TYPE_ICON,
77 wxBITMAP_TYPE_ICON_RESOURCE,
78 wxBITMAP_TYPE_ANI,
79 wxBITMAP_TYPE_IFF,
80 wxBITMAP_TYPE_MACCURSOR,
81 wxBITMAP_TYPE_MACCURSOR_RESOURCE,
82 wxBITMAP_TYPE_ANY = 50
83};
84
85// Standard cursors
86enum wxStockCursor
87{
88 wxCURSOR_NONE, // should be 0
89 wxCURSOR_ARROW,
90 wxCURSOR_RIGHT_ARROW,
91 wxCURSOR_BULLSEYE,
92 wxCURSOR_CHAR,
93 wxCURSOR_CROSS,
94 wxCURSOR_HAND,
95 wxCURSOR_IBEAM,
96 wxCURSOR_LEFT_BUTTON,
97 wxCURSOR_MAGNIFIER,
98 wxCURSOR_MIDDLE_BUTTON,
99 wxCURSOR_NO_ENTRY,
100 wxCURSOR_PAINT_BRUSH,
101 wxCURSOR_PENCIL,
102 wxCURSOR_POINT_LEFT,
103 wxCURSOR_POINT_RIGHT,
104 wxCURSOR_QUESTION_ARROW,
105 wxCURSOR_RIGHT_BUTTON,
106 wxCURSOR_SIZENESW,
107 wxCURSOR_SIZENS,
108 wxCURSOR_SIZENWSE,
109 wxCURSOR_SIZEWE,
110 wxCURSOR_SIZING,
111 wxCURSOR_SPRAYCAN,
112 wxCURSOR_WAIT,
113 wxCURSOR_WATCH,
114 wxCURSOR_BLANK,
115#ifdef __WXGTK__
116 wxCURSOR_DEFAULT, // standard X11 cursor
117#endif
118#ifdef __WXMAC__
119 wxCURSOR_COPY_ARROW , // MacOS Theme Plus arrow
120#endif
121#ifdef __X__
122 // Not yet implemented for Windows
123 wxCURSOR_CROSS_REVERSE,
124 wxCURSOR_DOUBLE_ARROW,
125 wxCURSOR_BASED_ARROW_UP,
126 wxCURSOR_BASED_ARROW_DOWN,
127#endif // X11
128
129 wxCURSOR_ARROWWAIT,
130
131 wxCURSOR_MAX
132};
133
134#ifndef __WXGTK__
135 #define wxCURSOR_DEFAULT wxCURSOR_ARROW
136#endif
137
138// ---------------------------------------------------------------------------
139// macros
140// ---------------------------------------------------------------------------
141
142/* Useful macro for creating icons portably, for example:
143
144 wxIcon *icon = new wxICON(mondrian);
145
146 expands into:
147
148 wxIcon *icon = new wxIcon("mondrian"); // On wxMSW
149 wxIcon *icon = new wxIcon(mondrian_xpm); // On wxGTK
150 */
151
152#ifdef __WXMSW__
153 // Load from a resource
154 #define wxICON(X) wxIcon(wxT(#X))
155#elif defined(__WXPM__)
156 // Load from a resource
157 #define wxICON(X) wxIcon(wxT(#X))
158#elif defined(__WXMGL__)
159 // Initialize from an included XPM
160 #define wxICON(X) wxIcon( (const char**) X##_xpm )
161#elif defined(__WXGTK__)
162 // Initialize from an included XPM
163 #define wxICON(X) wxIcon( (const char**) X##_xpm )
164#elif defined(__WXMAC__)
165 // Initialize from an included XPM
166 #define wxICON(X) wxIcon( (const char**) X##_xpm )
167#elif defined(__WXMOTIF__)
168 // Initialize from an included XPM
169 #define wxICON(X) wxIcon( X##_xpm )
170#elif defined(__WXX11__)
171 // Initialize from an included XPM
172 #define wxICON(X) wxIcon( X##_xpm )
173#else
174 // This will usually mean something on any platform
175 #define wxICON(X) wxIcon(wxT(#X))
176#endif // platform
177
178/* Another macro: this one is for portable creation of bitmaps. We assume that
179 under Unix bitmaps live in XPMs and under Windows they're in ressources.
180 */
181
182#if defined(__WXMSW__) || defined(__WXPM__)
183 #define wxBITMAP(name) wxBitmap(wxT(#name), wxBITMAP_TYPE_RESOURCE)
184#elif defined(__WXGTK__) || defined(__WXMOTIF__) || defined(__WXX11__) || defined(__WXMAC__) || defined(__WXMGL__) || defined(__WXCOCOA__)
185 // Initialize from an included XPM
186 #define wxBITMAP(name) wxBitmap( (const char**) name##_xpm )
187#else // other platforms
188 #define wxBITMAP(name) wxBitmap(name##_xpm, wxBITMAP_TYPE_XPM)
189#endif // platform
190
191// ===========================================================================
192// classes
193// ===========================================================================
194
195// ---------------------------------------------------------------------------
196// wxSize
197// ---------------------------------------------------------------------------
198
199class WXDLLEXPORT wxSize
200{
201public:
202 // members are public for compatibility, don't use them directly.
203 int x, y;
204
205 // constructors
206 wxSize() : x(0), y(0) { }
207 wxSize(int xx, int yy) : x(xx), y(yy) { }
208
209 // no copy ctor or assignment operator - the defaults are ok
210
211 bool operator==(const wxSize& sz) const { return x == sz.x && y == sz.y; }
212 bool operator!=(const wxSize& sz) const { return x != sz.x || y != sz.y; }
213
214 // FIXME are these really useful? If they're, we should have += &c as well
215 wxSize operator+(const wxSize& sz) { return wxSize(x + sz.x, y + sz.y); }
216 wxSize operator-(const wxSize& sz) { return wxSize(x - sz.x, y - sz.y); }
217
218 void IncTo(const wxSize& sz)
219 { if ( sz.x > x ) x = sz.x; if ( sz.y > y ) y = sz.y; }
220 void DecTo(const wxSize& sz)
221 { if ( sz.x < x ) x = sz.x; if ( sz.y < y ) y = sz.y; }
222
223 // accessors
224 void Set(int xx, int yy) { x = xx; y = yy; }
225 void SetWidth(int w) { x = w; }
226 void SetHeight(int h) { y = h; }
227
228 int GetWidth() const { return x; }
229 int GetHeight() const { return y; }
230
231 // compatibility
232 int GetX() const { return x; }
233 int GetY() const { return y; }
234};
235
236// ---------------------------------------------------------------------------
237// Point classes: with real or integer coordinates
238// ---------------------------------------------------------------------------
239
240class WXDLLEXPORT wxRealPoint
241{
242public:
243 double x;
244 double y;
245
246 wxRealPoint() : x(0.0), y(0.0) { }
247 wxRealPoint(double xx, double yy) : x(xx), y(yy) { }
248
249 wxRealPoint operator+(const wxRealPoint& pt) const { return wxRealPoint(x + pt.x, y + pt.y); }
250 wxRealPoint operator-(const wxRealPoint& pt) const { return wxRealPoint(x - pt.x, y - pt.y); }
251
252 bool operator==(const wxRealPoint& pt) const { return x == pt.x && y == pt.y; }
253 bool operator!=(const wxRealPoint& pt) const { return x != pt.x || y != pt.y; }
254};
255
256class WXDLLEXPORT wxPoint
257{
258public:
259 int x, y;
260
261 wxPoint() : x(0), y(0) { }
262 wxPoint(int xx, int yy) : x(xx), y(yy) { }
263
264 // no copy ctor or assignment operator - the defaults are ok
265
266 // comparison
267 bool operator==(const wxPoint& p) const { return x == p.x && y == p.y; }
268 bool operator!=(const wxPoint& p) const { return !(*this == p); }
269
270 // arithmetic operations (component wise)
271 wxPoint operator+(const wxPoint& p) const { return wxPoint(x + p.x, y + p.y); }
272 wxPoint operator-(const wxPoint& p) const { return wxPoint(x - p.x, y - p.y); }
273
274 wxPoint& operator+=(const wxPoint& p) { x += p.x; y += p.y; return *this; }
275 wxPoint& operator-=(const wxPoint& p) { x -= p.x; y -= p.y; return *this; }
276
277 wxPoint& operator+=(const wxSize& s) { x += s.GetWidth(); y += s.GetHeight(); return *this; }
278 wxPoint& operator-=(const wxSize& s) { x -= s.GetWidth(); y -= s.GetHeight(); return *this; }
279
280 wxPoint operator+(const wxSize& s) const { return wxPoint(x + s.GetWidth(), y + s.GetHeight()); }
281 wxPoint operator-(const wxSize& s) const { return wxPoint(x - s.GetWidth(), y - s.GetHeight()); }
282};
283
284// ---------------------------------------------------------------------------
285// wxRect
286// ---------------------------------------------------------------------------
287
288class WXDLLEXPORT wxRect
289{
290public:
291 wxRect()
292 : x(0), y(0), width(0), height(0)
293 { }
294 wxRect(int xx, int yy, int ww, int hh)
295 : x(xx), y(yy), width(ww), height(hh)
296 { }
297 wxRect(const wxPoint& topLeft, const wxPoint& bottomRight);
298 wxRect(const wxPoint& pos, const wxSize& size);
299
300 // default copy ctor and assignment operators ok
301
302 int GetX() const { return x; }
303 void SetX(int xx) { x = xx; }
304
305 int GetY() const { return y; }
306 void SetY(int yy) { y = yy; }
307
308 int GetWidth() const { return width; }
309 void SetWidth(int w) { width = w; }
310
311 int GetHeight() const { return height; }
312 void SetHeight(int h) { height = h; }
313
314 wxPoint GetPosition() const { return wxPoint(x, y); }
315 void SetPosition( const wxPoint &p ) { x = p.x; y = p.y; }
316
317 wxSize GetSize() const { return wxSize(width, height); }
318 void SetSize( const wxSize &s ) { width = s.GetWidth(); height = s.GetHeight(); }
319
320 wxPoint GetTopLeft() const { return GetPosition(); }
321 wxPoint GetLeftTop() const { return GetTopLeft(); }
322 void SetTopLeft(const wxPoint &p) { SetPosition(p); }
323 void SetLeftTop(const wxPoint &p) { SetTopLeft(p); }
324
325 wxPoint GetBottomRight() const { return wxPoint(GetRight(), GetBottom()); }
326 wxPoint GetRightBottom() const { return GetBottomRight(); }
327 void SetBottomRight(const wxPoint &p) { SetRight(p.x); SetBottom(p.y); }
328 void SetRightBottom(const wxPoint &p) { SetBottomRight(p); }
329
330 int GetLeft() const { return x; }
331 int GetTop() const { return y; }
332 int GetBottom() const { return y + height - 1; }
333 int GetRight() const { return x + width - 1; }
334
335 void SetLeft(int left) { x = left; }
336 void SetRight(int right) { width = right - x + 1; }
337 void SetTop(int top) { y = top; }
338 void SetBottom(int bottom) { height = bottom - y + 1; }
339
340 // operations with rect
341 wxRect& Inflate(wxCoord dx, wxCoord dy);
342 wxRect& Inflate(wxCoord d) { return Inflate(d, d); }
343 wxRect Inflate(wxCoord dx, wxCoord dy) const
344 {
345 wxRect r = *this;
346 r.Inflate(dx, dy);
347 return r;
348 }
349
350 wxRect& Deflate(wxCoord dx, wxCoord dy) { return Inflate(-dx, -dy); }
351 wxRect& Deflate(wxCoord d) { return Inflate(-d); }
352 wxRect Deflate(wxCoord dx, wxCoord dy) const
353 {
354 wxRect r = *this;
355 r.Deflate(dx, dy);
356 return r;
357 }
358
359 void Offset(wxCoord dx, wxCoord dy) { x += dx; y += dy; }
360 void Offset(const wxPoint& pt) { Offset(pt.x, pt.y); }
361
362 wxRect& Intersect(const wxRect& rect);
363 wxRect Intersect(const wxRect& rect) const
364 {
365 wxRect r = *this;
366 r.Intersect(rect);
367 return r;
368 }
369
370 wxRect operator+(const wxRect& rect) const;
371 wxRect& operator+=(const wxRect& rect);
372
373 // compare rectangles
374 bool operator==(const wxRect& rect) const;
375 bool operator!=(const wxRect& rect) const { return !(*this == rect); }
376
377 // return TRUE if the point is (not strcitly) inside the rect
378 bool Inside(int x, int y) const;
379 bool Inside(const wxPoint& pt) const { return Inside(pt.x, pt.y); }
380
381 // return TRUE if the rectangles have a non empty intersection
382 bool Intersects(const wxRect& rect) const;
383
384public:
385 int x, y, width, height;
386};
387
388// ---------------------------------------------------------------------------
389// Management of pens, brushes and fonts
390// ---------------------------------------------------------------------------
391
392typedef wxInt8 wxDash;
393
394class WXDLLEXPORT wxPenList : public wxList
395{
396public:
397 wxPenList() { }
398 ~wxPenList();
399
400 void AddPen(wxPen *pen);
401 void RemovePen(wxPen *pen);
402 wxPen *FindOrCreatePen(const wxColour& colour, int width, int style);
403};
404
405class WXDLLEXPORT wxBrushList : public wxList
406{
407public:
408 wxBrushList() { }
409 ~wxBrushList();
410
411 void AddBrush(wxBrush *brush);
412 void RemoveBrush(wxBrush *brush);
413 wxBrush *FindOrCreateBrush(const wxColour& colour, int style);
414};
415
416class WXDLLEXPORT wxFontList : public wxList
417{
418public:
419 wxFontList() { }
420 ~wxFontList();
421
422 void AddFont(wxFont *font);
423 void RemoveFont(wxFont *font);
424 wxFont *FindOrCreateFont(int pointSize, int family, int style, int weight,
425 bool underline = FALSE,
426 const wxString& face = wxEmptyString,
427 wxFontEncoding encoding = wxFONTENCODING_DEFAULT);
428};
429
430class WXDLLEXPORT wxStringToColourHashMap;
431
432class WXDLLEXPORT wxColourDatabase
433{
434public:
435 wxColourDatabase();
436 ~wxColourDatabase();
437
438 // find colour by name or name for the given colour
439 wxColour Find(const wxString& name) const;
440 wxString FindName(const wxColour& colour) const;
441
442 // add a new colour to the database
443 void AddColour(const wxString& name, const wxColour& colour);
444
445 // deprecated, use Find() instead
446 wxDEPRECATED( wxColour *FindColour(const wxString& name) );
447
448
449#ifdef __WXPM__
450 // PM keeps its own type of colour table
451 long* m_palTable;
452 size_t m_nSize;
453#endif
454
455private:
456 // load the database with the built in colour values when called for the
457 // first time, do nothing after this
458 void Initialize();
459
460 wxStringToColourHashMap *m_map;
461};
462
463class WXDLLEXPORT wxBitmapList : public wxList
464{
465public:
466 wxBitmapList();
467 ~wxBitmapList();
468
469 void AddBitmap(wxBitmap *bitmap);
470 void RemoveBitmap(wxBitmap *bitmap);
471};
472
473class WXDLLEXPORT wxResourceCache: public wxList
474{
475public:
476 wxResourceCache() { }
477#if !wxUSE_STL
478 wxResourceCache(const unsigned int keyType) : wxList(keyType) { }
479#endif
480 ~wxResourceCache();
481};
482
483// ---------------------------------------------------------------------------
484// global variables
485// ---------------------------------------------------------------------------
486
487// Lists of GDI objects
488WXDLLEXPORT_DATA(extern wxPenList*) wxThePenList;
489WXDLLEXPORT_DATA(extern wxBrushList*) wxTheBrushList;
490WXDLLEXPORT_DATA(extern wxFontList*) wxTheFontList;
491WXDLLEXPORT_DATA(extern wxBitmapList*) wxTheBitmapList;
492
493// Stock objects
494WXDLLEXPORT_DATA(extern wxFont*) wxNORMAL_FONT;
495WXDLLEXPORT_DATA(extern wxFont*) wxSMALL_FONT;
496WXDLLEXPORT_DATA(extern wxFont*) wxITALIC_FONT;
497WXDLLEXPORT_DATA(extern wxFont*) wxSWISS_FONT;
498
499WXDLLEXPORT_DATA(extern wxPen*) wxRED_PEN;
500WXDLLEXPORT_DATA(extern wxPen*) wxCYAN_PEN;
501WXDLLEXPORT_DATA(extern wxPen*) wxGREEN_PEN;
502WXDLLEXPORT_DATA(extern wxPen*) wxBLACK_PEN;
503WXDLLEXPORT_DATA(extern wxPen*) wxWHITE_PEN;
504WXDLLEXPORT_DATA(extern wxPen*) wxTRANSPARENT_PEN;
505WXDLLEXPORT_DATA(extern wxPen*) wxBLACK_DASHED_PEN;
506WXDLLEXPORT_DATA(extern wxPen*) wxGREY_PEN;
507WXDLLEXPORT_DATA(extern wxPen*) wxMEDIUM_GREY_PEN;
508WXDLLEXPORT_DATA(extern wxPen*) wxLIGHT_GREY_PEN;
509
510WXDLLEXPORT_DATA(extern wxBrush*) wxBLUE_BRUSH;
511WXDLLEXPORT_DATA(extern wxBrush*) wxGREEN_BRUSH;
512WXDLLEXPORT_DATA(extern wxBrush*) wxWHITE_BRUSH;
513WXDLLEXPORT_DATA(extern wxBrush*) wxBLACK_BRUSH;
514WXDLLEXPORT_DATA(extern wxBrush*) wxGREY_BRUSH;
515WXDLLEXPORT_DATA(extern wxBrush*) wxMEDIUM_GREY_BRUSH;
516WXDLLEXPORT_DATA(extern wxBrush*) wxLIGHT_GREY_BRUSH;
517WXDLLEXPORT_DATA(extern wxBrush*) wxTRANSPARENT_BRUSH;
518WXDLLEXPORT_DATA(extern wxBrush*) wxCYAN_BRUSH;
519WXDLLEXPORT_DATA(extern wxBrush*) wxRED_BRUSH;
520
521WXDLLEXPORT_DATA(extern wxColour*) wxBLACK;
522WXDLLEXPORT_DATA(extern wxColour*) wxWHITE;
523WXDLLEXPORT_DATA(extern wxColour*) wxRED;
524WXDLLEXPORT_DATA(extern wxColour*) wxBLUE;
525WXDLLEXPORT_DATA(extern wxColour*) wxGREEN;
526WXDLLEXPORT_DATA(extern wxColour*) wxCYAN;
527WXDLLEXPORT_DATA(extern wxColour*) wxLIGHT_GREY;
528
529// 'Null' objects
530WXDLLEXPORT_DATA(extern wxBitmap) wxNullBitmap;
531WXDLLEXPORT_DATA(extern wxIcon) wxNullIcon;
532WXDLLEXPORT_DATA(extern wxCursor) wxNullCursor;
533WXDLLEXPORT_DATA(extern wxPen) wxNullPen;
534WXDLLEXPORT_DATA(extern wxBrush) wxNullBrush;
535WXDLLEXPORT_DATA(extern wxPalette) wxNullPalette;
536WXDLLEXPORT_DATA(extern wxFont) wxNullFont;
537WXDLLEXPORT_DATA(extern wxColour) wxNullColour;
538
539// Stock cursors types
540WXDLLEXPORT_DATA(extern wxCursor*) wxSTANDARD_CURSOR;
541WXDLLEXPORT_DATA(extern wxCursor*) wxHOURGLASS_CURSOR;
542WXDLLEXPORT_DATA(extern wxCursor*) wxCROSS_CURSOR;
543
544WXDLLEXPORT_DATA(extern wxColourDatabase*) wxTheColourDatabase;
545
546WXDLLEXPORT_DATA(extern const wxChar*) wxPanelNameStr;
547
548WXDLLEXPORT_DATA(extern const wxSize) wxDefaultSize;
549WXDLLEXPORT_DATA(extern const wxPoint) wxDefaultPosition;
550
551// The list of objects which should be deleted
552WXDLLEXPORT_DATA(extern wxList) wxPendingDelete;
553
554// ---------------------------------------------------------------------------
555// global functions
556// ---------------------------------------------------------------------------
557
558// resource management
559extern void WXDLLEXPORT wxInitializeStockObjects();
560extern void WXDLLEXPORT wxInitializeStockLists();
561extern void WXDLLEXPORT wxDeleteStockObjects();
562extern void WXDLLEXPORT wxDeleteStockLists();
563
564// is the display colour (or monochrome)?
565extern bool WXDLLEXPORT wxColourDisplay();
566
567// Returns depth of screen
568extern int WXDLLEXPORT wxDisplayDepth();
569#define wxGetDisplayDepth wxDisplayDepth
570
571// get the display size
572extern void WXDLLEXPORT wxDisplaySize(int *width, int *height);
573extern wxSize WXDLLEXPORT wxGetDisplaySize();
574extern void WXDLLEXPORT wxDisplaySizeMM(int *width, int *height);
575extern wxSize WXDLLEXPORT wxGetDisplaySizeMM();
576
577// Get position and size of the display workarea
578extern void WXDLLEXPORT wxClientDisplayRect(int *x, int *y, int *width, int *height);
579extern wxRect WXDLLEXPORT wxGetClientDisplayRect();
580
581// set global cursor
582extern void WXDLLEXPORT wxSetCursor(const wxCursor& cursor);
583
584#endif
585 // _WX_GDICMNH__