1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: interface of wxFont
4 // Author: wxWidgets team
6 // Licence: wxWindows license
7 /////////////////////////////////////////////////////////////////////////////
11 Standard font families: these are used mainly during wxFont creation to specify
12 the generic properties of the font without hardcoding in the sources a specific
15 wxFontFamily thus allows to group the font face names of fonts with similar
16 properties. Most wxWidgets ports use lists of fonts for each font family
17 inspired by the data taken from http://www.codestyle.org/css/font-family.
21 wxFONTFAMILY_DEFAULT
= wxDEFAULT
, //!< Chooses a default font.
23 wxFONTFAMILY_DECORATIVE
= wxDECORATIVE
, //!< A decorative font.
24 wxFONTFAMILY_ROMAN
= wxROMAN
, //!< A formal, serif font.
25 wxFONTFAMILY_SCRIPT
= wxSCRIPT
, //!< A handwriting font.
26 wxFONTFAMILY_SWISS
= wxSWISS
, //!< A sans-serif font.
28 /// A fixed pitch font. Note that wxFont currently does not make distinctions
29 /// between @c wxFONTFAMILY_MODERN and @c wxFONTFAMILY_TELETYPE.
30 wxFONTFAMILY_MODERN
= wxMODERN
,
32 /// A teletype (i.e. monospaced) font.
33 /// Monospace fonts have a fixed width like typewriters and often have strong angular
34 /// or block serifs. Monospace font faces are often used code samples and have a simple,
35 /// functional font style.
36 /// See also wxFont::IsFixedWidth() for an easy way to test for monospace property.
37 wxFONTFAMILY_TELETYPE
= wxTELETYPE
,
39 /// Returned by wxFont::GetFamily() when the face name of the font cannot
40 /// be classified into one of the previous wxFontFamily values.
41 wxFONTFAMILY_UNKNOWN
= wxFONTFAMILY_MAX
,
51 /// The font is drawn without slant.
52 wxFONTSTYLE_NORMAL
= wxNORMAL
,
54 /// The font is slanted in an italic style.
55 wxFONTSTYLE_ITALIC
= wxITALIC
,
57 /// The font is slanted, but in a roman style.
58 /// Note that under wxMSW this style is the same as @c wxFONTSTYLE_ITALIC.
59 wxFONTSTYLE_SLANT
= wxSLANT
,
69 wxFONTWEIGHT_NORMAL
= wxNORMAL
, //!< Normal font.
70 wxFONTWEIGHT_LIGHT
= wxLIGHT
, //!< Light font.
71 wxFONTWEIGHT_BOLD
= wxBOLD
, //!< Bold font.
76 The font flag bits for the new font ctor accepting one combined flags word.
80 /// no special flags: font with default weight/slant/anti-aliasing
81 wxFONTFLAG_DEFAULT
= 0,
83 /// slant flags (default: no slant)
84 wxFONTFLAG_ITALIC
= 1 << 0,
85 wxFONTFLAG_SLANT
= 1 << 1,
87 /// weight flags (default: medium)
88 wxFONTFLAG_LIGHT
= 1 << 2,
89 wxFONTFLAG_BOLD
= 1 << 3,
91 /// anti-aliasing flag: force on or off (default: the current system default)
92 wxFONTFLAG_ANTIALIASED
= 1 << 4,
93 wxFONTFLAG_NOT_ANTIALIASED
= 1 << 5,
95 /// underlined/strikethrough flags (default: no lines)
96 wxFONTFLAG_UNDERLINED
= 1 << 6,
97 wxFONTFLAG_STRIKETHROUGH
= 1 << 7,
99 /// the mask of all currently used flags
100 wxFONTFLAG_MASK
= wxFONTFLAG_ITALIC
|
104 wxFONTFLAG_ANTIALIASED
|
105 wxFONTFLAG_NOT_ANTIALIASED
|
106 wxFONTFLAG_UNDERLINED
|
107 wxFONTFLAG_STRIKETHROUGH
115 See wxFont::SetEncoding().
119 /// Default system encoding.
120 wxFONTENCODING_SYSTEM
= -1, // system default
122 /// Default application encoding.
123 wxFONTENCODING_DEFAULT
, // current default encoding
125 // ISO8859 standard defines a number of single-byte charsets
126 wxFONTENCODING_ISO8859_1
, //!< West European (Latin1)
127 wxFONTENCODING_ISO8859_2
, //!< Central and East European (Latin2)
128 wxFONTENCODING_ISO8859_3
, //!< Esperanto (Latin3)
129 wxFONTENCODING_ISO8859_4
, //!< Baltic (old) (Latin4)
130 wxFONTENCODING_ISO8859_5
, //!< Cyrillic
131 wxFONTENCODING_ISO8859_6
, //!< Arabic
132 wxFONTENCODING_ISO8859_7
, //!< Greek
133 wxFONTENCODING_ISO8859_8
, //!< Hebrew
134 wxFONTENCODING_ISO8859_9
, //!< Turkish (Latin5)
135 wxFONTENCODING_ISO8859_10
, //!< Variation of Latin4 (Latin6)
136 wxFONTENCODING_ISO8859_11
, //!< Thai
137 wxFONTENCODING_ISO8859_12
, //!< doesn't exist currently, but put it
138 //!< here anyhow to make all ISO8859
139 //!< consecutive numbers
140 wxFONTENCODING_ISO8859_13
, //!< Baltic (Latin7)
141 wxFONTENCODING_ISO8859_14
, //!< Latin8
142 wxFONTENCODING_ISO8859_15
, //!< Latin9 (a.k.a. Latin0, includes euro)
143 wxFONTENCODING_ISO8859_MAX
,
145 // Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
146 wxFONTENCODING_KOI8
, //!< KOI8 Russian
147 wxFONTENCODING_KOI8_U
, //!< KOI8 Ukrainian
148 wxFONTENCODING_ALTERNATIVE
, //!< same as MS-DOS CP866
149 wxFONTENCODING_BULGARIAN
, //!< used under Linux in Bulgaria
151 // what would we do without Microsoft? They have their own encodings
153 wxFONTENCODING_CP437
, //!< original MS-DOS codepage
154 wxFONTENCODING_CP850
, //!< CP437 merged with Latin1
155 wxFONTENCODING_CP852
, //!< CP437 merged with Latin2
156 wxFONTENCODING_CP855
, //!< another cyrillic encoding
157 wxFONTENCODING_CP866
, //!< and another one
159 wxFONTENCODING_CP874
, //!< WinThai
160 wxFONTENCODING_CP932
, //!< Japanese (shift-JIS)
161 wxFONTENCODING_CP936
, //!< Chinese simplified (GB)
162 wxFONTENCODING_CP949
, //!< Korean (Hangul charset)
163 wxFONTENCODING_CP950
, //!< Chinese (traditional - Big5)
164 wxFONTENCODING_CP1250
, //!< WinLatin2
165 wxFONTENCODING_CP1251
, //!< WinCyrillic
166 wxFONTENCODING_CP1252
, //!< WinLatin1
167 wxFONTENCODING_CP1253
, //!< WinGreek (8859-7)
168 wxFONTENCODING_CP1254
, //!< WinTurkish
169 wxFONTENCODING_CP1255
, //!< WinHebrew
170 wxFONTENCODING_CP1256
, //!< WinArabic
171 wxFONTENCODING_CP1257
, //!< WinBaltic (same as Latin 7)
172 wxFONTENCODING_CP12_MAX
,
174 wxFONTENCODING_UTF7
, //!< UTF-7 Unicode encoding
175 wxFONTENCODING_UTF8
, //!< UTF-8 Unicode encoding
176 wxFONTENCODING_EUC_JP
, //!< Extended Unix Codepage for Japanese
177 wxFONTENCODING_UTF16BE
, //!< UTF-16 Big Endian Unicode encoding
178 wxFONTENCODING_UTF16LE
, //!< UTF-16 Little Endian Unicode encoding
179 wxFONTENCODING_UTF32BE
, //!< UTF-32 Big Endian Unicode encoding
180 wxFONTENCODING_UTF32LE
, // UTF-32 Little Endian Unicode encoding
182 wxFONTENCODING_MACROMAN
, //!< the standard mac encodings
183 wxFONTENCODING_MACJAPANESE
,
184 wxFONTENCODING_MACCHINESETRAD
,
185 wxFONTENCODING_MACKOREAN
,
186 wxFONTENCODING_MACARABIC
,
187 wxFONTENCODING_MACHEBREW
,
188 wxFONTENCODING_MACGREEK
,
189 wxFONTENCODING_MACCYRILLIC
,
190 wxFONTENCODING_MACDEVANAGARI
,
191 wxFONTENCODING_MACGURMUKHI
,
192 wxFONTENCODING_MACGUJARATI
,
193 wxFONTENCODING_MACORIYA
,
194 wxFONTENCODING_MACBENGALI
,
195 wxFONTENCODING_MACTAMIL
,
196 wxFONTENCODING_MACTELUGU
,
197 wxFONTENCODING_MACKANNADA
,
198 wxFONTENCODING_MACMALAJALAM
,
199 wxFONTENCODING_MACSINHALESE
,
200 wxFONTENCODING_MACBURMESE
,
201 wxFONTENCODING_MACKHMER
,
202 wxFONTENCODING_MACTHAI
,
203 wxFONTENCODING_MACLAOTIAN
,
204 wxFONTENCODING_MACGEORGIAN
,
205 wxFONTENCODING_MACARMENIAN
,
206 wxFONTENCODING_MACCHINESESIMP
,
207 wxFONTENCODING_MACTIBETAN
,
208 wxFONTENCODING_MACMONGOLIAN
,
209 wxFONTENCODING_MACETHIOPIC
,
210 wxFONTENCODING_MACCENTRALEUR
,
211 wxFONTENCODING_MACVIATNAMESE
,
212 wxFONTENCODING_MACARABICEXT
,
213 wxFONTENCODING_MACSYMBOL
,
214 wxFONTENCODING_MACDINGBATS
,
215 wxFONTENCODING_MACTURKISH
,
216 wxFONTENCODING_MACCROATIAN
,
217 wxFONTENCODING_MACICELANDIC
,
218 wxFONTENCODING_MACROMANIAN
,
219 wxFONTENCODING_MACCELTIC
,
220 wxFONTENCODING_MACGAELIC
,
221 wxFONTENCODING_MACKEYBOARD
,
223 // more CJK encodings (for historical reasons some are already declared
225 wxFONTENCODING_ISO2022_JP
, //!< ISO-2022-JP JIS encoding
227 wxFONTENCODING_MAX
, //!< highest enumerated encoding value
229 wxFONTENCODING_MACMIN
= wxFONTENCODING_MACROMAN
,
230 wxFONTENCODING_MACMAX
= wxFONTENCODING_MACKEYBOARD
,
232 // aliases for endian-dependent UTF encodings
233 wxFONTENCODING_UTF16
, //!< native UTF-16
234 wxFONTENCODING_UTF32
, //!< native UTF-32
236 /// Alias for the native Unicode encoding on this platform
237 /// (this is used by wxEncodingConverter and wxUTFFile only for now)
238 wxFONTENCODING_UNICODE
,
240 // alternative names for Far Eastern encodings
242 wxFONTENCODING_GB2312
= wxFONTENCODING_CP936
, //!< Simplified Chinese
243 wxFONTENCODING_BIG5
= wxFONTENCODING_CP950
, //!< Traditional Chinese
245 // Japanese (see http://zsigri.tripod.com/fontboard/cjk/jis.html)
246 wxFONTENCODING_SHIFT_JIS
= wxFONTENCODING_CP932
//!< Shift JIS
254 A font is an object which determines the appearance of text.
255 Fonts are used for drawing text to a device context, and setting the appearance
258 This class uses @ref overview_refcount "reference counting and copy-on-write"
259 internally so that assignments between two instances of this class are very
260 cheap. You can therefore use actual objects instead of pointers without
261 efficiency problems. If an instance of this class is changed it will create
262 its own data internally so that other instances, which previously shared the
263 data using the reference counting, are not affected.
265 You can retrieve the current system font settings with wxSystemSettings.
271 ::wxNullFont, ::wxNORMAL_FONT, ::wxSMALL_FONT, ::wxITALIC_FONT, ::wxSWISS_FONT
273 @see @ref overview_font, wxDC::SetFont, wxDC::DrawText,
274 wxDC::GetTextExtent, wxFontDialog, wxSystemSettings
276 class wxFont
: public wxGDIObject
285 Copy constructor, uses @ref overview_refcount "reference counting".
287 wxFont(const wxFont
& font
);
290 Creates a font object with the specified attributes.
293 Size in points. See SetPointSize() for more info.
295 The font family: a generic portable way of referring to fonts without specifying a
296 facename. This parameter must be one of the ::wxFontFamily enumeration values.
297 If the @a faceName argument is provided, then it overrides the font family.
299 One of @c wxFONTSTYLE_NORMAL, @c wxFONTSTYLE_SLANT and @c wxFONTSTYLE_ITALIC.
301 Font weight, sometimes also referred to as font boldness.
302 One of the ::wxFontWeight enumeration values.
304 The value can be @true or @false.
305 At present this has an effect on Windows and Motif 2.x only.
307 An optional string specifying the face name to be used.
308 If it is an empty string, a default face name will be chosen based on the family.
310 An encoding which may be one of the enumeration values of ::wxFontEncoding.
311 Briefly these can be summed up as:
313 <TR><TD>@c wxFONTENCODING_SYSTEM</TD><TD>Default system encoding.</TD></TR>
314 <TR><TD>@c wxFONTENCODING_DEFAULT</TD><TD>
315 Default application encoding: this is the encoding set by calls to
316 SetDefaultEncoding() and which may be set to, say, KOI8 to create all
317 fonts by default with KOI8 encoding. Initially, the default application
318 encoding is the same as default system encoding.</TD></TR>
319 <TR><TD>@c wxFONTENCODING_ISO8859_1...15</TD><TD>ISO8859 encodings.</TD></TR>
320 <TR><TD>@c wxFONTENCODING_KOI8</TD><TD>The standard Russian encoding for Internet.</TD></TR>
321 <TR><TD>@c wxFONTENCODING_CP1250...1252</TD><TD>Windows encodings similar to ISO8859 (but not identical).</TD></TR>
323 If the specified encoding isn't available, no font is created
324 (see also @ref overview_fontencoding).
326 @remarks If the desired font does not exist, the closest match will be
327 chosen. Under Windows, only scalable TrueType fonts are used.
329 wxFont(int pointSize
, wxFontFamily family
, wxFontStyle style
,
331 bool underline
= false,
332 const wxString
& faceName
= wxEmptyString
,
333 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
336 Creates a font object with the specified attributes.
339 Size in pixels. See SetPixelSize() for more info.
341 The font family: a generic portable way of referring to fonts without specifying a
342 facename. This parameter must be one of the ::wxFontFamily enumeration values.
343 If the @a faceName argument is provided, then it overrides the font family.
345 One of @c wxFONTSTYLE_NORMAL, @c wxFONTSTYLE_SLANT and @c wxFONTSTYLE_ITALIC.
347 Font weight, sometimes also referred to as font boldness.
348 One of the ::wxFontWeight enumeration values.
350 The value can be @true or @false.
351 At present this has an effect on Windows and Motif 2.x only.
353 An optional string specifying the face name to be used.
354 If it is an empty string, a default face name will be chosen based on the family.
356 An encoding which may be one of the enumeration values of ::wxFontEncoding.
357 Briefly these can be summed up as:
359 <TR><TD>@c wxFONTENCODING_SYSTEM</TD><TD>Default system encoding.</TD></TR>
360 <TR><TD>@c wxFONTENCODING_DEFAULT</TD><TD>
361 Default application encoding: this is the encoding set by calls to
362 SetDefaultEncoding() and which may be set to, say, KOI8 to create all
363 fonts by default with KOI8 encoding. Initially, the default application
364 encoding is the same as default system encoding.</TD></TR>
365 <TR><TD>@c wxFONTENCODING_ISO8859_1...15</TD><TD>ISO8859 encodings.</TD></TR>
366 <TR><TD>@c wxFONTENCODING_KOI8</TD><TD>The standard Russian encoding for Internet.</TD></TR>
367 <TR><TD>@c wxFONTENCODING_CP1250...1252</TD><TD>Windows encodings similar to ISO8859 (but not identical).</TD></TR>
369 If the specified encoding isn't available, no font is created
370 (see also @ref overview_fontencoding).
372 @remarks If the desired font does not exist, the closest match will be
373 chosen. Under Windows, only scalable TrueType fonts are used.
375 wxFont(const wxSize
& pixelSize
, wxFontFamily family
,
376 wxFontStyle style
, wxFontWeight weight
,
377 bool underline
= false,
378 const wxString
& faceName
= wxEmptyString
,
379 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
382 Constructor from font description string.
384 This constructor uses SetNativeFontInfo() to initialize the font.
385 If @a fontdesc is invalid the font remains uninitialized, i.e. its IsOk() method
388 wxFont(const wxString
& fontdesc
);
393 See @ref overview_refcount_destruct "reference-counted object destruction"
396 @remarks Although all remaining fonts are deleted when the application
397 exits, the application should try to clean up all fonts
398 itself. This is because wxWidgets cannot know if a
399 pointer to the font object is stored in an application
400 data structure, and there is a risk of double deletion.
411 Returns the encoding of this font.
413 Note that under wxGTK the returned value is always @c wxFONTENCODING_UTF8.
417 virtual wxFontEncoding
GetEncoding() const;
420 Returns the face name associated with the font, or the empty string if
421 there is no face information.
425 virtual wxString
GetFaceName() const;
428 Gets the font family.
429 As described in ::wxFontFamily docs the returned value acts as a rough,
430 basic classification of the main font properties (look, spacing).
432 If the current font face name is not recognized by wxFont or by the
433 underlying system, @c wxFONTFAMILY_UNKNOWN is returned.
435 Note that currently this function is rather unreliable (wxFONTFAMILY_UNKNOWN is
436 returned in too many cases) and not particularly useful.
437 Font families mostly make sense only for font creation; see SetFamily().
441 virtual wxFontFamily
GetFamily() const;
444 Returns the platform-dependent string completely describing this font.
445 Returned string is always non-empty.
447 Note that the returned string is not meant to be shown or edited by the user: a
448 typical use of this function is for serializing in string-form a wxFont object.
450 @see SetNativeFontInfo(), GetNativeFontInfoUserDesc()
452 wxString
GetNativeFontInfoDesc() const;
455 Returns a user-friendly string for this font object.
456 Returned string is always non-empty.
458 The string does not encode all wxFont infos under all platforms;
459 e.g. under wxMSW the font family is not present in the returned string.
461 Some examples of the formats of returned strings (which are platform-dependent)
462 are in SetNativeFontInfoUserDesc().
464 @see SetNativeFontInfoUserDesc(), GetNativeFontInfoDesc()
466 wxString
GetNativeFontInfoUserDesc() const;
473 virtual int GetPointSize() const;
478 Note that under wxMSW if you passed to SetPixelSize() (or to the ctor)
479 a wxSize object with a null width value, you'll get a null width in
484 virtual wxSize
GetPixelSize() const;
487 Gets the font style. See ::wxFontStyle for a list of valid styles.
491 virtual wxFontStyle
GetStyle() const;
494 Returns @true if the font is underlined, @false otherwise.
498 virtual bool GetUnderlined() const;
501 Gets the font weight. See ::wxFontWeight for a list of valid weight identifiers.
505 virtual wxFontWeight
GetWeight() const;
508 Returns @true if the font is a fixed width (or monospaced) font,
509 @false if it is a proportional one or font is invalid.
511 Note that this function under some platforms is different than just testing
512 for the font family being equal to @c wxFONTFAMILY_TELETYPE because native
513 platform-specific functions are used for the check (resulting in a more
514 accurate return value).
516 virtual bool IsFixedWidth() const;
519 Returns @true if this object is a valid font, @false otherwise.
521 virtual bool IsOk() const;
530 These functions internally recreate the native font object with the new
536 Sets the encoding for this font.
538 Note that under wxGTK this function has no effect (because the underlying
539 Pango library always uses @c wxFONTENCODING_UTF8).
543 virtual void SetEncoding(wxFontEncoding encoding
);
546 Sets the facename for the font.
547 Returns @true if the given face name exists; @false otherwise.
550 A valid facename, which should be on the end-user's system.
552 @remarks To avoid portability problems, don't rely on a specific face,
553 but specify the font family instead (see ::wxFontFamily).
554 A suitable font will be found on the end-user's system.
556 @see GetFaceName(), SetFamily()
558 virtual bool SetFaceName(const wxString
& faceName
);
561 Sets the font family.
563 As described in ::wxFontFamily docs the given @a family value acts as a rough,
564 basic indication of the main font properties (look, spacing).
566 Note that changing the font family results in changing the font face name.
569 One of the ::wxFontFamily values.
571 @see GetFamily(), SetFaceName()
573 virtual void SetFamily(wxFontFamily family
);
576 Creates the font corresponding to the given native font description string
577 which must have been previously returned by GetNativeFontInfoDesc().
579 If the string is invalid, font is unchanged.
580 This function is typically used for de-serializing a wxFont object
581 previously saved in a string-form.
583 @return @true if the creation was successful.
585 @see SetNativeFontInfoUserDesc()
587 bool SetNativeFontInfo(const wxString
& info
);
590 Creates the font corresponding to the given native font description string and
591 returns @true if the creation was successful.
593 Unlike SetNativeFontInfo(), this function accepts strings which are user-friendly.
594 Examples of accepted string formats are:
597 @hdr3col{platform, generic syntax, example}
598 @row3col{wxGTK2, <tt>[FACE-NAME] [bold] [oblique|italic] [POINTSIZE]</tt>, Monospace bold 10}
599 @row3col{wxMSW, <tt>[light|bold] [italic] [FACE-NAME] [POINTSIZE] [ENCODING]</tt>, Tahoma 10 WINDOWS-1252}
602 @todo add an example for wxMac
604 For more detailed information about the allowed syntaxes you can look at the
605 documentation of the native API used for font-rendering
606 (e.g. @c pango_font_description_from_string on GTK).
608 Note that unlike SetNativeFontInfo(), this function doesn't always restore all
609 attributes of the wxFont object under all platforms; e.g. on wxMSW the font family
610 is not restored (because GetNativeFontInfoUserDesc doesn't return it on wxMSW).
611 If you want to serialize/deserialize a font in string form, you should use
612 GetNativeFontInfoDesc() and SetNativeFontInfo() instead.
614 @see SetNativeFontInfo()
616 bool SetNativeFontInfoUserDesc(const wxString
& info
);
621 The <em>point size</em> is defined as 1/72 of the anglo-Saxon inch
622 (25.4 mm): it is approximately 0.0139 inch or 352.8 um.
629 virtual void SetPointSize(int pointSize
);
634 The height parameter of @a pixelSize must be positive while the width
635 parameter may also be zero (to indicate that you're not interested in the
636 width of the characters: a suitable width will be chosen for best rendering).
638 This feature (specifying the font pixel size) is directly supported only
639 under wxMSW and wxGTK currently; under other platforms a font with the
640 closest size to the given one is found using binary search (this maybe slower).
644 virtual void SetPixelSize(const wxSize
& pixelSize
);
650 One of the ::wxFontStyle enumeration values.
654 virtual void SetStyle(wxFontStyle style
);
660 @true to underline, @false otherwise.
664 virtual void SetUnderlined(bool underlined
);
667 Sets the font weight.
670 One of the ::wxFontWeight values.
674 virtual void SetWeight(wxFontWeight weight
);
682 See @ref overview_refcount_equality "reference-counted object comparison" for
685 bool operator!=(const wxFont
& font
) const;
690 See @ref overview_refcount_equality "reference-counted object comparison" for
693 bool operator==(const wxFont
& font
) const;
696 Assignment operator, using @ref overview_refcount "reference counting".
698 wxFont
& operator =(const wxFont
& font
);
704 Returns the current application's default encoding.
706 @see @ref overview_fontencoding, SetDefaultEncoding()
708 static wxFontEncoding
GetDefaultEncoding();
711 Sets the default font encoding.
713 @see @ref overview_fontencoding, GetDefaultEncoding()
715 static void SetDefaultEncoding(wxFontEncoding encoding
);
719 This function takes the same parameters as the relative
720 @ref wxFont::wxFont "wxFont constructor" and returns a new font
721 object allocated on the heap.
723 static wxFont
* New(int pointSize
, wxFontFamily family
, wxFontStyle style
,
725 bool underline
= false,
726 const wxString
& faceName
= wxEmptyString
,
727 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
728 static wxFont
* New(int pointSize
, wxFontFamily family
,
729 int flags
= wxFONTFLAG_DEFAULT
,
730 const wxString
& faceName
= wxEmptyString
,
731 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
732 static wxFont
* New(const wxSize
& pixelSize
,
736 bool underline
= false,
737 const wxString
& faceName
= wxEmptyString
,
738 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
739 static wxFont
* New(const wxSize
& pixelSize
,
741 int flags
= wxFONTFLAG_DEFAULT
,
742 const wxString
& faceName
= wxEmptyString
,
743 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
754 Equivalent to wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT).
756 @see wxSystemSettings
758 wxFont wxNORMAL_FONT
;
761 A font using the @c wxFONTFAMILY_SWISS family and 2 points smaller than
767 A font using the @c wxFONTFAMILY_ROMAN family and @c wxFONTSTYLE_ITALIC style and
768 of the same size of ::wxNORMAL_FONT.
770 wxFont wxITALIC_FONT
;
773 A font identic to ::wxNORMAL_FONT except for the family used which is
774 @c wxFONTFAMILY_SWISS.
782 A font list is a list containing all fonts which have been created.
783 There is only one instance of this class: ::wxTheFontList.
785 Use this object to search for a previously created font of the desired type
786 and create it if not already found.
788 In some windowing systems, the font may be a scarce resource, so it is best to
789 reuse old resources if possible. When an application finishes, all fonts will
790 be deleted and their resources freed, eliminating the possibility of 'memory
798 class wxFontList
: public wxList
802 Constructor. The application should not construct its own font list:
803 use the object pointer ::wxTheFontList.
808 Finds a font of the given specification, or creates one and adds it to the
809 list. See the @ref wxFont "wxFont constructor" for details of the arguments.
811 wxFont
* FindOrCreateFont(int point_size
, wxFontFamily family
, wxFontStyle style
,
812 wxFontWeight weight
, bool underline
= false,
813 const wxString
& facename
= wxEmptyString
,
814 wxFontEncoding encoding
= wxFONTENCODING_DEFAULT
);
819 The global wxFontList instance.
821 wxFontList
* wxTheFontList
;
824 // ============================================================================
825 // Global functions/macros
826 // ============================================================================
828 /** @addtogroup group_funcmacro_misc */
832 Converts string to a wxFont best represented by the given string. Returns
835 @see wxToString(const wxFont&)
839 bool wxFromString(const wxString
& string
, wxFont
* font
);
842 Converts the given wxFont into a string.
844 @see wxFromString(const wxString&, wxFont*)
848 wxString
wxToString(const wxFont
& font
);