Fix for mistake with const for non pointer/reference with corrections in documentation.
[wxWidgets.git] / include / wx / palmos / pen.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: wx/palmos/pen.h
3 // Purpose: wxPen class
4 // Author: William Osborne - minimal working wxPalmOS port
5 // Modified by:
6 // Created: 10/13/04
7 // RCS-ID: $Id$
8 // Copyright: (c) William Osborne
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_PEN_H_
13 #define _WX_PEN_H_
14
15 #include "wx/gdiobj.h"
16 #include "wx/bitmap.h"
17 #include "wx/colour.h"
18
19 typedef WXDWORD wxMSWDash;
20
21 class WXDLLEXPORT wxPen;
22
23 // VZ: this class should be made private
24 class WXDLLEXPORT wxPenRefData : public wxGDIRefData
25 {
26 public:
27 wxPenRefData();
28 wxPenRefData(const wxPenRefData& data);
29 virtual ~wxPenRefData();
30
31 bool operator==(const wxPenRefData& data) const
32 {
33 // we intentionally don't compare m_hPen fields here
34 return m_style == data.m_style &&
35 m_width == data.m_width &&
36 m_join == data.m_join &&
37 m_cap == data.m_cap &&
38 m_colour == data.m_colour &&
39 (m_style != wxSTIPPLE || m_stipple == data.m_stipple) &&
40 (m_style != wxUSER_DASH ||
41 (m_nbDash == data.m_nbDash &&
42 memcmp(m_dash, data.m_dash, m_nbDash*sizeof(wxDash)) == 0));
43 }
44
45 protected:
46 int m_width;
47 int m_style;
48 int m_join;
49 int m_cap;
50 wxBitmap m_stipple;
51 int m_nbDash;
52 wxDash * m_dash;
53 wxColour m_colour;
54 WXHPEN m_hPen;
55
56 private:
57 friend class WXDLLEXPORT wxPen;
58
59 // Cannot use
60 // DECLARE_NO_COPY_CLASS(wxPenRefData)
61 // because copy constructor is explicitly declared above;
62 // but no copy assignment operator is defined, so declare
63 // it private to prevent the compiler from defining it:
64 wxPenRefData& operator=(const wxPenRefData&);
65 };
66
67 #define M_PENDATA ((wxPenRefData *)m_refData)
68 #define wxPENDATA(x) ((wxPenRefData *)(x).m_refData)
69
70 // ----------------------------------------------------------------------------
71 // Pen
72 // ----------------------------------------------------------------------------
73
74 class WXDLLEXPORT wxPen : public wxGDIObject
75 {
76 public:
77 wxPen();
78 wxPen(const wxColour& col, int width = 1, int style = wxSOLID);
79 wxPen(const wxBitmap& stipple, int width);
80 wxPen(const wxPen& pen) { Ref(pen); }
81 virtual ~wxPen();
82
83 wxPen& operator=(const wxPen& pen)
84 {
85 if ( this != &pen )
86 Ref(pen);
87
88 return *this;
89 }
90
91 bool operator==(const wxPen& pen) const
92 {
93 const wxPenRefData *penData = (wxPenRefData *)pen.m_refData;
94
95 // an invalid pen is only equal to another invalid pen
96 return m_refData ? penData && *M_PENDATA == *penData : !penData;
97 }
98
99 bool operator!=(const wxPen& pen) const { return !(*this == pen); }
100
101 virtual bool Ok() const { return (m_refData != NULL); }
102
103 // Override in order to recreate the pen
104 void SetColour(const wxColour& col);
105 void SetColour(unsigned char r, unsigned char g, unsigned char b);
106
107 void SetWidth(int width);
108 void SetStyle(int style);
109 void SetStipple(const wxBitmap& stipple);
110 void SetDashes(int nb_dashes, const wxDash *dash);
111 void SetJoin(int join);
112 void SetCap(int cap);
113
114 wxColour& GetColour() const { return (M_PENDATA ? M_PENDATA->m_colour : wxNullColour); };
115 int GetWidth() const { return (M_PENDATA ? M_PENDATA->m_width : 0); };
116 int GetStyle() const { return (M_PENDATA ? M_PENDATA->m_style : 0); };
117 int GetJoin() const { return (M_PENDATA ? M_PENDATA->m_join : 0); };
118 int GetCap() const { return (M_PENDATA ? M_PENDATA->m_cap : 0); };
119 int GetDashes(wxDash **ptr) const
120 {
121 *ptr = (M_PENDATA ? (wxDash*)M_PENDATA->m_dash : (wxDash*) NULL);
122 return (M_PENDATA ? M_PENDATA->m_nbDash : 0);
123 }
124 wxDash* GetDash() const { return (M_PENDATA ? (wxDash*)M_PENDATA->m_dash : (wxDash*)NULL); };
125 inline int GetDashCount() const { return (M_PENDATA ? M_PENDATA->m_nbDash : 0); };
126
127 inline wxBitmap *GetStipple() const { return (M_PENDATA ? (& M_PENDATA->m_stipple) : (wxBitmap*) NULL); };
128
129 // Internal
130 bool RealizeResource();
131 bool FreeResource(bool force = false);
132 WXHANDLE GetResourceHandle() const;
133 bool IsFree() const;
134 void Unshare();
135
136 private:
137 DECLARE_DYNAMIC_CLASS(wxPen)
138 };
139
140 #endif // _WX_PEN_H_