# font.h File Reference

## Classes

class | wxFont
| A font is an object which determines the appearance of text. More...
class | wxFontList
| A font list is a list containing all fonts which have been created. More...

## Enumerations

enum | wxFontFamily { wxFONTFAMILY_DEFAULT = wxDEFAULT, wxFONTFAMILY_DECORATIVE = wxDECORATIVE, wxFONTFAMILY_ROMAN = wxROMAN, wxFONTFAMILY_SCRIPT = wxSCRIPT, wxFONTFAMILY_SWISS = wxSWISS, wxFONTFAMILY_MODERN = wxMODERN, wxFONTFAMILY_TELETYPE = wxTELETYPE, wxFONTFAMILY_UNKNOWN }
| Standard font families: these are used mainly during wxFont creation to specify the generic properties of the font without hardcoding in the sources a specific face name. More...
enum | wxFontStyle { wxFONTSTYLE_NORMAL = wxNORMAL, wxFONTSTYLE_ITALIC = wxITALIC, wxFONTSTYLE_SLANT = wxSLANT, wxFONTSTYLE_MAX }
| Font styles. More...
enum | wxFontWeight { wxFONTWEIGHT_NORMAL = wxNORMAL, wxFONTWEIGHT_LIGHT = wxLIGHT, wxFONTWEIGHT_BOLD = wxBOLD, wxFONTWEIGHT_MAX }
| Font weights. More...
enum | wxFontSymbolicSize { wxFONTSIZE_XX_SMALL = -3, wxFONTSIZE_X_SMALL, wxFONTSIZE_SMALL, wxFONTSIZE_MEDIUM, wxFONTSIZE_LARGE, wxFONTSIZE_X_LARGE, wxFONTSIZE_XX_LARGE }
| Symbolic font sizes. More...
enum | wxFontFlag { wxFONTFLAG_DEFAULT = 0, wxFONTFLAG_ITALIC = 1 << 0, wxFONTFLAG_SLANT = 1 << 1, wxFONTFLAG_LIGHT = 1 << 2, wxFONTFLAG_BOLD = 1 << 3, wxFONTFLAG_ANTIALIASED = 1 << 4, wxFONTFLAG_NOT_ANTIALIASED = 1 << 5, wxFONTFLAG_UNDERLINED = 1 << 6, wxFONTFLAG_STRIKETHROUGH = 1 << 7, wxFONTFLAG_MASK }
| The font flag bits for the new font ctor accepting one combined flags word. More...

enum

wxFontEncoding {
wxFONTENCODING_SYSTEM = -1,
wxFONTENCODING_DEFAULT,
wxFONTENCODING_ISO8859_1,
wxFONTENCODING_ISO8859_2,
wxFONTENCODING_ISO8859_3,
wxFONTENCODING_ISO8859_4,
wxFONTENCODING_ISO8859_5,
wxFONTENCODING_ISO8859_6,
wxFONTENCODING_ISO8859_7,
wxFONTENCODING_ISO8859_8,
wxFONTENCODING_ISO8859_9,
wxFONTENCODING_ISO8859_10,
wxFONTENCODING_ISO8859_11,
wxFONTENCODING_ISO8859_12,
wxFONTENCODING_ISO8859_13,
wxFONTENCODING_ISO8859_14,
wxFONTENCODING_ISO8859_15,
wxFONTENCODING_ISO8859_MAX,
wxFONTENCODING_KOI8,
wxFONTENCODING_KOI8_U,
wxFONTENCODING_ALTERNATIVE,
wxFONTENCODING_BULGARIAN,
wxFONTENCODING_CP437,
wxFONTENCODING_CP850,
wxFONTENCODING_CP852,
wxFONTENCODING_CP855,
wxFONTENCODING_CP866,
wxFONTENCODING_CP874,
wxFONTENCODING_CP932,
wxFONTENCODING_CP936,
wxFONTENCODING_CP949,
wxFONTENCODING_CP950,
wxFONTENCODING_CP1250,
wxFONTENCODING_CP1251,
wxFONTENCODING_CP1252,
wxFONTENCODING_CP1253,
wxFONTENCODING_CP1254,
wxFONTENCODING_CP1255,
wxFONTENCODING_CP1256,
wxFONTENCODING_CP1257,
wxFONTENCODING_CP12_MAX,
wxFONTENCODING_UTF7,
wxFONTENCODING_UTF8,
wxFONTENCODING_EUC_JP,
wxFONTENCODING_UTF16BE,
wxFONTENCODING_UTF16LE,
wxFONTENCODING_UTF32BE,
wxFONTENCODING_UTF32LE,
wxFONTENCODING_MACROMAN,
wxFONTENCODING_MACJAPANESE,
wxFONTENCODING_MACCHINESETRAD,
wxFONTENCODING_MACKOREAN,
wxFONTENCODING_MACARABIC,
wxFONTENCODING_MACHEBREW,
wxFONTENCODING_MACGREEK,
wxFONTENCODING_MACCYRILLIC,
wxFONTENCODING_MACDEVANAGARI,
wxFONTENCODING_MACGURMUKHI,
wxFONTENCODING_MACGUJARATI,
wxFONTENCODING_MACORIYA,
wxFONTENCODING_MACBENGALI,
wxFONTENCODING_MACTAMIL,
wxFONTENCODING_MACTELUGU,
wxFONTENCODING_MACKANNADA,
wxFONTENCODING_MACMALAJALAM,
wxFONTENCODING_MACSINHALESE,
wxFONTENCODING_MACBURMESE,
wxFONTENCODING_MACKHMER,
wxFONTENCODING_MACTHAI,
wxFONTENCODING_MACLAOTIAN,
wxFONTENCODING_MACGEORGIAN,
wxFONTENCODING_MACARMENIAN,
wxFONTENCODING_MACCHINESESIMP,
wxFONTENCODING_MACTIBETAN,
wxFONTENCODING_MACMONGOLIAN,
wxFONTENCODING_MACETHIOPIC,
wxFONTENCODING_MACCENTRALEUR,
wxFONTENCODING_MACVIATNAMESE,
wxFONTENCODING_MACARABICEXT,
wxFONTENCODING_MACSYMBOL,
wxFONTENCODING_MACDINGBATS,
wxFONTENCODING_MACTURKISH,
wxFONTENCODING_MACCROATIAN,
wxFONTENCODING_MACICELANDIC,
wxFONTENCODING_MACROMANIAN,
wxFONTENCODING_MACCELTIC,
wxFONTENCODING_MACGAELIC,
wxFONTENCODING_MACKEYBOARD,
wxFONTENCODING_ISO2022_JP,
wxFONTENCODING_MAX,
wxFONTENCODING_MACMIN = wxFONTENCODING_MACROMAN,
wxFONTENCODING_MACMAX = wxFONTENCODING_MACKEYBOARD,
wxFONTENCODING_UTF16,
wxFONTENCODING_UTF32,
wxFONTENCODING_UNICODE,
wxFONTENCODING_GB2312 = wxFONTENCODING_CP936,
wxFONTENCODING_BIG5 = wxFONTENCODING_CP950,
wxFONTENCODING_SHIFT_JIS = wxFONTENCODING_CP932,
wxFONTENCODING_EUC_KR = wxFONTENCODING_CP949
}

| Font encodings. More...

## Functions

bool | wxFromString (const wxString &string, wxFont *font)
| Converts string to a wxFont best represented by the given string.
wxString | wxToString (const wxFont &font)
| Converts the given wxFont into a string.

## Variables

wxFont | wxNullFont
| An empty wxFont.
wxFont | wxNORMAL_FONT
| Equivalent to wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT).
wxFont | wxSMALL_FONT
| A font using the `wxFONTFAMILY_SWISS` family and 2 points smaller than wxNORMAL_FONT.
wxFont | wxITALIC_FONT
| A font using the `wxFONTFAMILY_ROMAN` family and `wxFONTSTYLE_ITALIC` style and of the same size of wxNORMAL_FONT.
wxFont | wxSWISS_FONT
| A font identic to wxNORMAL_FONT except for the family used which is `wxFONTFAMILY_SWISS`.
wxFontList * | wxTheFontList
| The global wxFontList instance.

## Enumeration Type Documentation

enum wxFontEncoding

Font encodings.

See wxFont::SetEncoding().

Enumerator:

  wxFONTENCODING_SYSTEM | Default system encoding.
  wxFONTENCODING_DEFAULT | Default application encoding.
  wxFONTENCODING_ISO8859_1 | West European (Latin1).
  wxFONTENCODING_ISO8859_2 | Central and East European (Latin2).
  wxFONTENCODING_ISO8859_3 | Esperanto (Latin3).
  wxFONTENCODING_ISO8859_4 | Baltic (old) (Latin4).
  wxFONTENCODING_ISO8859_5 | Cyrillic.
  wxFONTENCODING_ISO8859_6 | Arabic.
  wxFONTENCODING_ISO8859_7 | Greek.
  wxFONTENCODING_ISO8859_8 | Hebrew.
  wxFONTENCODING_ISO8859_9 | Turkish (Latin5).
  wxFONTENCODING_ISO8859_10 | Variation of Latin4 (Latin6).
  wxFONTENCODING_ISO8859_11 | Thai.
  wxFONTENCODING_ISO8859_12 | doesn't exist currently, but put it here anyhow to make all ISO8859 consecutive numbers
  wxFONTENCODING_ISO8859_13 | Baltic (Latin7).
  wxFONTENCODING_ISO8859_14 | Latin8.
  wxFONTENCODING_ISO8859_15 | Latin9 (a.k.a. Latin0, includes euro).
  wxFONTENCODING_ISO8859_MAX |
  wxFONTENCODING_KOI8 | KOI8 Russian.
  wxFONTENCODING_KOI8_U | KOI8 Ukrainian.
  wxFONTENCODING_ALTERNATIVE | same as MS-DOS CP866
  wxFONTENCODING_BULGARIAN | used under Linux in Bulgaria
  wxFONTENCODING_CP437 | original MS-DOS codepage
  wxFONTENCODING_CP850 | CP437 merged with Latin1.
  wxFONTENCODING_CP852 | CP437 merged with Latin2.
  wxFONTENCODING_CP855 | another cyrillic encoding
  wxFONTENCODING_CP866 | and another one
  wxFONTENCODING_CP874 | WinThai.
  wxFONTENCODING_CP932 | Japanese (shift-JIS).
  wxFONTENCODING_CP936 | Chinese simplified (GB).
  wxFONTENCODING_CP949 | Korean (Hangul charset).
  wxFONTENCODING_CP950 | Chinese (traditional - Big5).
  wxFONTENCODING_CP1250 | WinLatin2.
  wxFONTENCODING_CP1251 | WinCyrillic.
  wxFONTENCODING_CP1252 | WinLatin1.
  wxFONTENCODING_CP1253 | WinGreek (8859-7).
  wxFONTENCODING_CP1254 | WinTurkish.
  wxFONTENCODING_CP1255 | WinHebrew.
  wxFONTENCODING_CP1256 | WinArabic.
  wxFONTENCODING_CP1257 | WinBaltic (same as Latin 7).
  wxFONTENCODING_CP12_MAX |
  wxFONTENCODING_UTF7 | UTF-7 Unicode encoding.
  wxFONTENCODING_UTF8 | UTF-8 Unicode encoding.
  wxFONTENCODING_EUC_JP | Extended Unix Codepage for Japanese.
  wxFONTENCODING_UTF16BE | UTF-16 Big Endian Unicode encoding.
  wxFONTENCODING_UTF16LE | UTF-16 Little Endian Unicode encoding.
  wxFONTENCODING_UTF32BE | UTF-32 Big Endian Unicode encoding.
  wxFONTENCODING_UTF32LE |
  wxFONTENCODING_MACROMAN | the standard mac encodings
  wxFONTENCODING_MACJAPANESE |
  wxFONTENCODING_MACCHINESETRAD |
  wxFONTENCODING_MACKOREAN |
  wxFONTENCODING_MACARABIC |
  wxFONTENCODING_MACHEBREW |
  wxFONTENCODING_MACGREEK |
  wxFONTENCODING_MACCYRILLIC |
  wxFONTENCODING_MACDEVANAGARI |
  wxFONTENCODING_MACGURMUKHI |
  wxFONTENCODING_MACGUJARATI |
  wxFONTENCODING_MACORIYA |
  wxFONTENCODING_MACBENGALI |
  wxFONTENCODING_MACTAMIL |
  wxFONTENCODING_MACTELUGU |
  wxFONTENCODING_MACKANNADA |
  wxFONTENCODING_MACMALAJALAM |
  wxFONTENCODING_MACSINHALESE |
  wxFONTENCODING_MACBURMESE |
  wxFONTENCODING_MACKHMER |
  wxFONTENCODING_MACTHAI |
  wxFONTENCODING_MACLAOTIAN |
  wxFONTENCODING_MACGEORGIAN |
  wxFONTENCODING_MACARMENIAN |
  wxFONTENCODING_MACCHINESESIMP |
  wxFONTENCODING_MACTIBETAN |
  wxFONTENCODING_MACMONGOLIAN |
  wxFONTENCODING_MACETHIOPIC |
  wxFONTENCODING_MACCENTRALEUR |
  wxFONTENCODING_MACVIATNAMESE |
  wxFONTENCODING_MACARABICEXT |
  wxFONTENCODING_MACSYMBOL |
  wxFONTENCODING_MACDINGBATS |
  wxFONTENCODING_MACTURKISH |
  wxFONTENCODING_MACCROATIAN |
  wxFONTENCODING_MACICELANDIC |
  wxFONTENCODING_MACROMANIAN |
  wxFONTENCODING_MACCELTIC |
  wxFONTENCODING_MACGAELIC |
  wxFONTENCODING_MACKEYBOARD |
  wxFONTENCODING_ISO2022_JP | ISO-2022-JP JIS encoding.
  wxFONTENCODING_MAX | highest enumerated encoding value
  wxFONTENCODING_MACMIN |
  wxFONTENCODING_MACMAX |
  wxFONTENCODING_UTF16 | native UTF-16
  wxFONTENCODING_UTF32 | native UTF-32
  wxFONTENCODING_UNICODE | Alias for the native Unicode encoding on this platform (this is used by wxEncodingConverter and wxUTFFile only for now).
  wxFONTENCODING_GB2312 | Simplified Chinese.
  wxFONTENCODING_BIG5 | Traditional Chinese.
  wxFONTENCODING_SHIFT_JIS | Shift JIS.
  wxFONTENCODING_EUC_KR | Korean.

enum wxFontFamily

Standard font families: these are used mainly during wxFont creation to specify the generic properties of the font without hardcoding in the sources a specific face name.

wxFontFamily thus allows to group the font face names of fonts with similar properties. Most wxWidgets ports use lists of fonts for each font family inspired by the data taken from http://www.codestyle.org/css/font-family.

Enumerator:

  wxFONTFAMILY_DEFAULT | Chooses a default font.
  wxFONTFAMILY_DECORATIVE | A decorative font.
  wxFONTFAMILY_ROMAN | A formal, serif font.
  wxFONTFAMILY_SCRIPT | A handwriting font.
  wxFONTFAMILY_SWISS | A sans-serif font.
  wxFONTFAMILY_MODERN | A fixed pitch font. Note that wxFont currently does not make distinctions between `wxFONTFAMILY_MODERN` and `wxFONTFAMILY_TELETYPE`.
  wxFONTFAMILY_TELETYPE | A teletype (i.e. monospaced) font. Monospace fonts have a fixed width like typewriters and often have strong angular or block serifs. Monospace font faces are often used code samples and have a simple, functional font style. See also wxFont::IsFixedWidth() for an easy way to test for monospace property.
  wxFONTFAMILY_UNKNOWN | Invalid font family value, returned by wxFont::GetFamily() when the font is invalid for example.

enum wxFontFlag

The font flag bits for the new font ctor accepting one combined flags word.

Enumerator:

  wxFONTFLAG_DEFAULT | no special flags: font with default weight/slant/anti-aliasing
  wxFONTFLAG_ITALIC | slant flags (default: no slant)
  wxFONTFLAG_SLANT |
  wxFONTFLAG_LIGHT | weight flags (default: medium)
  wxFONTFLAG_BOLD |
  wxFONTFLAG_ANTIALIASED | anti-aliasing flag: force on or off (default: the current system default)
  wxFONTFLAG_NOT_ANTIALIASED |
  wxFONTFLAG_UNDERLINED | underlined/strikethrough flags (default: no lines)
  wxFONTFLAG_STRIKETHROUGH |
  wxFONTFLAG_MASK | the mask of all currently used flags

enum wxFontStyle

Font styles.

Enumerator:

  wxFONTSTYLE_NORMAL | The font is drawn without slant.
  wxFONTSTYLE_ITALIC | The font is slanted in an italic style.
  wxFONTSTYLE_SLANT | The font is slanted, but in a roman style. Note that under wxMSW this style is the same as `wxFONTSTYLE_ITALIC`.
  wxFONTSTYLE_MAX |

enum wxFontSymbolicSize

Symbolic font sizes.

The elements of this enum correspond to CSS absolute size specifications, see http://www.w3.org/TR/CSS21/fonts.html#font-size-props

See also:
  wxFont::SetSymbolicSize()

Since:
  2.9.2

Enumerator:

  wxFONTSIZE_XX_SMALL | Extra small.
  wxFONTSIZE_X_SMALL | Very small.
  wxFONTSIZE_SMALL | Small.
  wxFONTSIZE_MEDIUM | Normal.
  wxFONTSIZE_LARGE | Large.
  wxFONTSIZE_X_LARGE | Very large.
  wxFONTSIZE_XX_LARGE | Extra large.

enum wxFontWeight

Font weights.

Enumerator:

  wxFONTWEIGHT_NORMAL | Normal font.
  wxFONTWEIGHT_LIGHT | Light font.
  wxFONTWEIGHT_BOLD | Bold font.
  wxFONTWEIGHT_MAX |

## Variable Documentation

wxFont wxITALIC_FONT

A font using the `wxFONTFAMILY_ROMAN` family and `wxFONTSTYLE_ITALIC` style and of the same size of wxNORMAL_FONT.

wxFont wxNORMAL_FONT

Equivalent to wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT).

See also:
  wxSystemSettings

wxFont wxNullFont

An empty wxFont.

wxFont wxSMALL_FONT

A font using the `wxFONTFAMILY_SWISS` family and 2 points smaller than wxNORMAL_FONT.

wxFont wxSWISS_FONT

A font identic to wxNORMAL_FONT except for the family used which is `wxFONTFAMILY_SWISS`.

wxFontList* wxTheFontList

The global wxFontList instance.

|  | [ top ]