| | 1 | ///////////////////////////////////////////////////////////////////////////// |
| | 2 | // Name: wx/font.h |
| | 3 | // Purpose: wxFontBase class: the interface of wxFont |
| | 4 | // Author: Vadim Zeitlin |
| | 5 | // Modified by: |
| | 6 | // Created: 20.09.99 |
| | 7 | // RCS-ID: $Id$ |
| | 8 | // Copyright: (c) wxWidgets team |
| | 9 | // Licence: wxWindows licence |
| | 10 | ///////////////////////////////////////////////////////////////////////////// |
| | 11 | |
| | 12 | #ifndef _WX_FONT_H_BASE_ |
| | 13 | #define _WX_FONT_H_BASE_ |
| | 14 | |
| | 15 | // ---------------------------------------------------------------------------- |
| | 16 | // headers |
| | 17 | // ---------------------------------------------------------------------------- |
| | 18 | |
| | 19 | #include "wx/defs.h" // for wxDEFAULT &c |
| | 20 | #include "wx/fontenc.h" // the font encoding constants |
| | 21 | #include "wx/gdiobj.h" // the base class |
| | 22 | |
| | 23 | // ---------------------------------------------------------------------------- |
| | 24 | // forward declarations |
| | 25 | // ---------------------------------------------------------------------------- |
| | 26 | |
| | 27 | class WXDLLIMPEXP_FWD_CORE wxFontData; |
| | 28 | class WXDLLIMPEXP_FWD_CORE wxFontBase; |
| | 29 | class WXDLLIMPEXP_FWD_CORE wxFont; |
| | 30 | class WXDLLIMPEXP_FWD_CORE wxSize; |
| | 31 | |
| | 32 | // ---------------------------------------------------------------------------- |
| | 33 | // font constants |
| | 34 | // ---------------------------------------------------------------------------- |
| | 35 | |
| | 36 | // standard font families: these may be used only for the font creation, it |
| | 37 | // doesn't make sense to query an existing font for its font family as, |
| | 38 | // especially if the font had been created from a native font description, it |
| | 39 | // may be unknown |
| | 40 | enum wxFontFamily |
| | 41 | { |
| | 42 | wxFONTFAMILY_DEFAULT = wxDEFAULT, |
| | 43 | wxFONTFAMILY_DECORATIVE = wxDECORATIVE, |
| | 44 | wxFONTFAMILY_ROMAN = wxROMAN, |
| | 45 | wxFONTFAMILY_SCRIPT = wxSCRIPT, |
| | 46 | wxFONTFAMILY_SWISS = wxSWISS, |
| | 47 | wxFONTFAMILY_MODERN = wxMODERN, |
| | 48 | wxFONTFAMILY_TELETYPE = wxTELETYPE, |
| | 49 | wxFONTFAMILY_MAX, |
| | 50 | wxFONTFAMILY_UNKNOWN = wxFONTFAMILY_MAX |
| | 51 | }; |
| | 52 | |
| | 53 | // font styles |
| | 54 | enum wxFontStyle |
| | 55 | { |
| | 56 | wxFONTSTYLE_NORMAL = wxNORMAL, |
| | 57 | wxFONTSTYLE_ITALIC = wxITALIC, |
| | 58 | wxFONTSTYLE_SLANT = wxSLANT, |
| | 59 | wxFONTSTYLE_MAX |
| | 60 | }; |
| | 61 | |
| | 62 | // font weights |
| | 63 | enum wxFontWeight |
| | 64 | { |
| | 65 | wxFONTWEIGHT_NORMAL = wxNORMAL, |
| | 66 | wxFONTWEIGHT_LIGHT = wxLIGHT, |
| | 67 | wxFONTWEIGHT_BOLD = wxBOLD, |
| | 68 | wxFONTWEIGHT_MAX |
| | 69 | }; |
| | 70 | |
| | 71 | // the font flag bits for the new font ctor accepting one combined flags word |
| | 72 | enum |
| | 73 | { |
| | 74 | // no special flags: font with default weight/slant/anti-aliasing |
| | 75 | wxFONTFLAG_DEFAULT = 0, |
| | 76 | |
| | 77 | // slant flags (default: no slant) |
| | 78 | wxFONTFLAG_ITALIC = 1 << 0, |
| | 79 | wxFONTFLAG_SLANT = 1 << 1, |
| | 80 | |
| | 81 | // weight flags (default: medium) |
| | 82 | wxFONTFLAG_LIGHT = 1 << 2, |
| | 83 | wxFONTFLAG_BOLD = 1 << 3, |
| | 84 | |
| | 85 | // anti-aliasing flag: force on or off (default: the current system default) |
| | 86 | wxFONTFLAG_ANTIALIASED = 1 << 4, |
| | 87 | wxFONTFLAG_NOT_ANTIALIASED = 1 << 5, |
| | 88 | |
| | 89 | // underlined/strikethrough flags (default: no lines) |
| | 90 | wxFONTFLAG_UNDERLINED = 1 << 6, |
| | 91 | wxFONTFLAG_STRIKETHROUGH = 1 << 7, |
| | 92 | |
| | 93 | // the mask of all currently used flags |
| | 94 | wxFONTFLAG_MASK = wxFONTFLAG_ITALIC | |
| | 95 | wxFONTFLAG_SLANT | |
| | 96 | wxFONTFLAG_LIGHT | |
| | 97 | wxFONTFLAG_BOLD | |
| | 98 | wxFONTFLAG_ANTIALIASED | |
| | 99 | wxFONTFLAG_NOT_ANTIALIASED | |
| | 100 | wxFONTFLAG_UNDERLINED | |
| | 101 | wxFONTFLAG_STRIKETHROUGH |
| | 102 | }; |
| | 103 | |
| | 104 | // ---------------------------------------------------------------------------- |
| | 105 | // wxFontBase represents a font object |
| | 106 | // ---------------------------------------------------------------------------- |
| | 107 | |
| | 108 | class WXDLLIMPEXP_FWD_CORE wxNativeFontInfo; |
| | 109 | |
| | 110 | class WXDLLEXPORT wxFontBase : public wxGDIObject |
| | 111 | { |
| | 112 | public: |
| | 113 | // creator function |
| | 114 | virtual ~wxFontBase(); |
| | 115 | |
| | 116 | // from the font components |
| | 117 | static wxFont *New( |
| | 118 | int pointSize, // size of the font in points |
| | 119 | int family, // see wxFontFamily enum |
| | 120 | int style, // see wxFontStyle enum |
| | 121 | int weight, // see wxFontWeight enum |
| | 122 | bool underlined = false, // not underlined by default |
| | 123 | const wxString& face = wxEmptyString, // facename |
| | 124 | wxFontEncoding encoding = wxFONTENCODING_DEFAULT); // ISO8859-X, ... |
| | 125 | |
| | 126 | // from the font components but using the font flags instead of separate |
| | 127 | // parameters for each flag |
| | 128 | static wxFont *New(int pointSize, |
| | 129 | wxFontFamily family, |
| | 130 | int flags = wxFONTFLAG_DEFAULT, |
| | 131 | const wxString& face = wxEmptyString, |
| | 132 | wxFontEncoding encoding = wxFONTENCODING_DEFAULT); |
| | 133 | |
| | 134 | // from the font components |
| | 135 | static wxFont *New( |
| | 136 | const wxSize& pixelSize, // size of the font in pixels |
| | 137 | int family, // see wxFontFamily enum |
| | 138 | int style, // see wxFontStyle enum |
| | 139 | int weight, // see wxFontWeight enum |
| | 140 | bool underlined = false, // not underlined by default |
| | 141 | const wxString& face = wxEmptyString, // facename |
| | 142 | wxFontEncoding encoding = wxFONTENCODING_DEFAULT); // ISO8859-X, ... |
| | 143 | |
| | 144 | // from the font components but using the font flags instead of separate |
| | 145 | // parameters for each flag |
| | 146 | static wxFont *New(const wxSize& pixelSize, |
| | 147 | wxFontFamily family, |
| | 148 | int flags = wxFONTFLAG_DEFAULT, |
| | 149 | const wxString& face = wxEmptyString, |
| | 150 | wxFontEncoding encoding = wxFONTENCODING_DEFAULT); |
| | 151 | |
| | 152 | // from the (opaque) native font description object |
| | 153 | static wxFont *New(const wxNativeFontInfo& nativeFontDesc); |
| | 154 | |
| | 155 | // from the string representation of wxNativeFontInfo |
| | 156 | static wxFont *New(const wxString& strNativeFontDesc); |
| | 157 | |
| | 158 | // comparison |
| | 159 | bool operator==(const wxFont& font) const; |
| | 160 | bool operator!=(const wxFont& font) const { return !(*this == font); } |
| | 161 | |
| | 162 | // accessors: get the font characteristics |
| | 163 | virtual int GetPointSize() const = 0; |
| | 164 | virtual wxSize GetPixelSize() const; |
| | 165 | virtual bool IsUsingSizeInPixels() const; |
| | 166 | virtual int GetFamily() const = 0; |
| | 167 | virtual int GetStyle() const = 0; |
| | 168 | virtual int GetWeight() const = 0; |
| | 169 | virtual bool GetUnderlined() const = 0; |
| | 170 | virtual wxString GetFaceName() const = 0; |
| | 171 | virtual wxFontEncoding GetEncoding() const = 0; |
| | 172 | virtual const wxNativeFontInfo *GetNativeFontInfo() const = 0; |
| | 173 | |
| | 174 | virtual bool IsFixedWidth() const; |
| | 175 | |
| | 176 | wxString GetNativeFontInfoDesc() const; |
| | 177 | wxString GetNativeFontInfoUserDesc() const; |
| | 178 | |
| | 179 | // change the font characteristics |
| | 180 | virtual void SetPointSize( int pointSize ) = 0; |
| | 181 | virtual void SetPixelSize( const wxSize& pixelSize ); |
| | 182 | virtual void SetFamily( int family ) = 0; |
| | 183 | virtual void SetStyle( int style ) = 0; |
| | 184 | virtual void SetWeight( int weight ) = 0; |
| | 185 | virtual void SetUnderlined( bool underlined ) = 0; |
| | 186 | virtual void SetEncoding(wxFontEncoding encoding) = 0; |
| | 187 | virtual bool SetFaceName( const wxString& faceName ); |
| | 188 | void SetNativeFontInfo(const wxNativeFontInfo& info) |
| | 189 | { DoSetNativeFontInfo(info); } |
| | 190 | |
| | 191 | bool SetNativeFontInfo(const wxString& info); |
| | 192 | bool SetNativeFontInfoUserDesc(const wxString& info); |
| | 193 | |
| | 194 | // translate the fonts into human-readable string (i.e. GetStyleString() |
| | 195 | // will return "wxITALIC" for an italic font, ...) |
| | 196 | wxString GetFamilyString() const; |
| | 197 | wxString GetStyleString() const; |
| | 198 | wxString GetWeightString() const; |
| | 199 | |
| | 200 | // Unofficial API, don't use |
| | 201 | virtual void SetNoAntiAliasing( bool WXUNUSED(no) = true ) { } |
| | 202 | virtual bool GetNoAntiAliasing() const { return false; } |
| | 203 | |
| | 204 | // the default encoding is used for creating all fonts with default |
| | 205 | // encoding parameter |
| | 206 | static wxFontEncoding GetDefaultEncoding() { return ms_encodingDefault; } |
| | 207 | static void SetDefaultEncoding(wxFontEncoding encoding); |
| | 208 | |
| | 209 | protected: |
| | 210 | // the function called by both overloads of SetNativeFontInfo() |
| | 211 | virtual void DoSetNativeFontInfo(const wxNativeFontInfo& info); |
| | 212 | |
| | 213 | private: |
| | 214 | // the currently default encoding: by default, it's the default system |
| | 215 | // encoding, but may be changed by the application using |
| | 216 | // SetDefaultEncoding() to make all subsequent fonts created without |
| | 217 | // specifying encoding parameter using this encoding |
| | 218 | static wxFontEncoding ms_encodingDefault; |
| | 219 | }; |
| | 220 | |
| | 221 | // wxFontBase <-> wxString utilities, used by wxConfig |
| | 222 | WXDLLIMPEXP_CORE wxString wxToString(const wxFontBase& font); |
| | 223 | WXDLLIMPEXP_CORE bool wxFromString(const wxString& str, wxFontBase* font); |
| | 224 | |
| | 225 | |
| | 226 | |
| | 227 | // include the real class declaration |
| | 228 | #if defined(__WXPALMOS__) |
| | 229 | #include "wx/palmos/font.h" |
| | 230 | #elif defined(__WXMSW__) |
| | 231 | #include "wx/msw/font.h" |
| | 232 | #elif defined(__WXMOTIF__) |
| | 233 | #include "wx/motif/font.h" |
| | 234 | #elif defined(__WXGTK20__) |
| | 235 | #include "wx/gtk/font.h" |
| | 236 | #elif defined(__WXGTK__) |
| | 237 | #include "wx/gtk1/font.h" |
| | 238 | #elif defined(__WXX11__) |
| | 239 | #include "wx/x11/font.h" |
| | 240 | #elif defined(__WXMGL__) |
| | 241 | #include "wx/mgl/font.h" |
| | 242 | #elif defined(__WXDFB__) |
| | 243 | #include "wx/dfb/font.h" |
| | 244 | #elif defined(__WXMAC__) |
| | 245 | #include "wx/mac/font.h" |
| | 246 | #elif defined(__WXCOCOA__) |
| | 247 | #include "wx/cocoa/font.h" |
| | 248 | #elif defined(__WXPM__) |
| | 249 | #include "wx/os2/font.h" |
| | 250 | #endif |
| | 251 | |
| | 252 | #endif |
| | 253 | // _WX_FONT_H_BASE_ |
projects / wxWidgets.git / blame_incremental