[wxWidgets.git] / docs / latex / wx / font.tex

\section{\class{wxFont}}\label{wxfont}

A font is an object which determines the appearance of text. Fonts are
used for drawing text to a device context, and setting the appearance of
a window's text.

\wxheading{Derived from}

\helpref{wxGDIObject}{wxgdiobject}\\
\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/font.h>

\wxheading{Constants}

\begin{verbatim}
enum wxFontEncoding
{
    wxFONTENCODING_SYSTEM = -1,     // system default
    wxFONTENCODING_DEFAULT,         // current default encoding

    // ISO8859 standard defines a number of single-byte charsets
    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,

    // Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
    wxFONTENCODING_KOI8,            // we don't support any of KOI8 variants
    wxFONTENCODING_ALTERNATIVE,     // same as MS-DOS CP866
    wxFONTENCODING_BULGARIAN,       // used under Linux in Bulgaria

    // what would we do without Microsoft? They have their own encodings
        // for DOS
    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
        // and for Windows
    wxFONTENCODING_CP874,           // WinThai
    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_UNICODE,         // Unicode - currently used only by
                                    // wxEncodingConverter class

    wxFONTENCODING_MAX
};
\end{verbatim}

\wxheading{Predefined objects}

Objects:

{\bf wxNullFont}

Pointers:

{\bf wxNORMAL\_FONT\\
wxSMALL\_FONT\\
wxITALIC\_FONT\\
wxSWISS\_FONT}

\wxheading{See also}

\helpref{wxFont overview}{wxfontoverview}, \helpref{wxDC::SetFont}{wxdcsetfont},\rtfsp
\helpref{wxDC::DrawText}{wxdcdrawtext}, \helpref{wxDC::GetTextExtent}{wxdcgettextextent},\rtfsp
\helpref{wxFontDialog}{wxfontdialog}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxFont::wxFont}\label{wxfontconstr}

\func{}{wxFont}{\void}

Default constructor.

\func{}{wxFont}{\param{int}{ pointSize}, \param{int}{ family}, \param{int}{ style}, \param{int}{ weight},
 \param{const bool}{ underline = FALSE}, \param{const wxString\& }{faceName = ""},
 \param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}

Creates a font object (see \helpref{font encoding
overview}{wxfontencodingoverview} for the meaning of the last parameter).

\wxheading{Parameters}

\docparam{pointSize}{Size in points.}

\docparam{family}{Font family, a generic way of referring to fonts without specifying actual facename. One of:

\twocolwidtha{5cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxDEFAULT}}{Chooses a default font.}
\twocolitem{{\bf wxDECORATIVE}}{A decorative font.}
\twocolitem{{\bf wxROMAN}}{A formal, serif font.}
\twocolitem{{\bf wxSCRIPT}}{A handwriting font.}
\twocolitem{{\bf wxSWISS}}{A sans-serif font.}
\twocolitem{{\bf wxMODERN}}{A fixed pitch font.}
\end{twocollist}}

\docparam{style}{One of {\bf wxNORMAL}, {\bf wxSLANT} and {\bf wxITALIC}.}

\docparam{weight}{One of {\bf wxNORMAL}, {\bf wxLIGHT} and {\bf wxBOLD}.}

\docparam{underline}{The value can be TRUE or FALSE. At present this has an effect on Windows only.}

\docparam{faceName}{An optional string specifying the actual typeface to be used. If the empty string,
a default typeface will chosen based on the family.}

\docparam{encoding}{An encoding which may be one of
\twocolwidtha{5cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxFONTENCODING\_SYSTEM}}{Default system encoding.}
\twocolitem{{\bf wxFONTENCODING\_DEFAULT}}{Default application encoding: this
is the encoding set by calls to 
\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding} and which may be set to,
say, KOI8 to create all fonts by default with KOI8 encoding. Initially, the
default application encoding is the same as default system encoding.}
\twocolitem{{\bf wxFONTENCODING\_ISO8859\_1...15}}{ISO8859 encodings.}
\twocolitem{{\bf wxFONTENCODING\_KOI8}}{The standard russian encoding for Internet.}
\twocolitem{{\bf wxFONTENCODING\_CP1250...1252}}{Windows encodings similar to ISO8859 (but not identical).}
\end{twocollist}
If the specified encoding isn't available, no font is created.
}

\wxheading{Remarks}

If the desired font does not exist, the closest match will be chosen.
Under Windows, only scaleable TrueType fonts are used.

See also \helpref{wxDC::SetFont}{wxdcsetfont}, \helpref{wxDC::DrawText}{wxdcdrawtext}
and \helpref{wxDC::GetTextExtent}{wxdcgettextextent}.

\membersection{wxFont::\destruct{wxFont}}

\func{}{\destruct{wxFont}}{\void}

Destructor.

\wxheading{Remarks}

The destructor may not delete the underlying font object of the native windowing
system, since wxFont uses a reference counting system for efficiency.

Although all remaining fonts are deleted when the application exits,
the application should try to clean up all fonts itself. This is because
wxWindows cannot know if a pointer to the font object is stored in an
application data structure, and there is a risk of double deletion.

\membersection{wxFont::IsFixedWidth}\label{wxfontisfixedwidth}

\constfunc{bool}{IsFixedWidth}{\void}

Returns {\tt TRUE} if the font is a fixed width (or monospaced) font, 
{\tt FALSE} if it is a proportional one or font is invalid.

\membersection{wxFont::GetDefaultEncoding}\label{wxfontgetdefaultencoding}

\func{static wxFontEncoding}{GetDefaultEncoding}{\void}

Returns the current applications default encoding.

\wxheading{See also}

\helpref{Font encoding overview}{wxfontencodingoverview}, 
\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding}

\membersection{wxFont::GetFaceName}\label{wxfontgetfacename}

\constfunc{wxString}{GetFaceName}{\void}

Returns the typeface name associated with the font, or the empty string if there is no
typeface information.

\wxheading{See also}

\helpref{wxFont::SetFaceName}{wxfontsetfacename}

\membersection{wxFont::GetFamily}\label{wxfontgetfamily}

\constfunc{int}{GetFamily}{\void}

Gets the font family. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
family identifiers.

\wxheading{See also}

\helpref{wxFont::SetFamily}{wxfontsetfamily}

\membersection{wxFont::GetNativeFontInfoDesc}\label{wxfontgetnativefontinfodesc}

\constfunc{wxString}{GetNativeFontInfoDesc}{\void}

Returns the platform-dependent string completely describing this font or an
empty string if the font wasn't constructed using the native font description.

\wxheading{See also}

\helpref{wxFont::SetNativeFontInfo}{wxfontsetnativefontinfo}

\membersection{wxFont::GetPointSize}\label{wxfontgetpointsize}

\constfunc{int}{GetPointSize}{\void}

Gets the point size.

\wxheading{See also}

\helpref{wxFont::SetPointSize}{wxfontsetpointsize}

\membersection{wxFont::GetStyle}\label{wxfontgetstyle}

\constfunc{int}{GetStyle}{\void}

Gets the font style. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
styles.

\wxheading{See also}

\helpref{wxFont::SetStyle}{wxfontsetstyle}

\membersection{wxFont::GetUnderlined}\label{wxfontgetunderlined}

\constfunc{bool}{GetUnderlined}{\void}

Returns TRUE if the font is underlined, FALSE otherwise.

\wxheading{See also}

\helpref{wxFont::SetUnderlined}{wxfontsetunderlined}

\membersection{wxFont::GetWeight}\label{wxfontgetweight}

\constfunc{int}{GetWeight}{\void}

Gets the font weight. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
weight identifiers.

\wxheading{See also}

\helpref{wxFont::SetWeight}{wxfontsetweight}

\membersection{wxFont::SetDefaultEncoding}\label{wxfontsetdefaultencoding}

\func{static void}{SetDefaultEncoding}{\param{wxFontEncoding }{encoding}}

Sets the default font encoding.

\wxheading{See also}

\helpref{Font encoding overview}{wxfontencodingoverview}, 
\helpref{GetDefaultEncoding}{wxfontgetdefaultencoding}

\membersection{wxFont::SetFaceName}\label{wxfontsetfacename}

\func{void}{SetFaceName}{\param{const wxString\& }{faceName}}

Sets the facename for the font.

\wxheading{Parameters}

\docparam{faceName}{A valid facename, which should be on the end-user's system.}

\wxheading{Remarks}

To avoid portability problems, don't rely on a specific face, but specify the font family
instead or as well. A suitable font will be found on the end-user's system. If both the
family and the facename are specified, wxWindows will first search for the specific face,
and then for a font belonging to the same family.

\wxheading{See also}

\helpref{wxFont::GetFaceName}{wxfontgetfacename}, \helpref{wxFont::SetFamily}{wxfontsetfamily}

\membersection{wxFont::SetFamily}\label{wxfontsetfamily}

\func{void}{SetFamily}{\param{int}{ family}}

Sets the font family.

\wxheading{Parameters}

\docparam{family}{One of:

\twocolwidtha{5cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxDEFAULT}}{Chooses a default font.}
\twocolitem{{\bf wxDECORATIVE}}{A decorative font.}
\twocolitem{{\bf wxROMAN}}{A formal, serif font.}
\twocolitem{{\bf wxSCRIPT}}{A handwriting font.}
\twocolitem{{\bf wxSWISS}}{A sans-serif font.}
\twocolitem{{\bf wxMODERN}}{A fixed pitch font.}
\end{twocollist}}

\wxheading{See also}

\helpref{wxFont::GetFamily}{wxfontgetfamily}, \helpref{wxFont::SetFaceName}{wxfontsetfacename}

\membersection{wxFont::SetNativeFontInfo}\label{wxfontsetnativefontinfo}

\func{void}{SetNativeFontInfo}{\param{const wxString\& }{info}}

Creates the font corresponding to the given native font description string
which must have been previously returned by 
\helpref{GetNativeFontInfoDesc}{wxfontgetnativefontinfodesc}. If the string is
invalid, font is unchanged.

\membersection{wxFont::SetPointSize}\label{wxfontsetpointsize}

\func{void}{SetPointSize}{\param{int}{ pointSize}}

Sets the point size.

\wxheading{Parameters}

\docparam{pointSize}{Size in points.}

\wxheading{See also}

\helpref{wxFont::GetPointSize}{wxfontgetpointsize}

\membersection{wxFont::SetStyle}\label{wxfontsetstyle}

\func{void}{SetStyle}{\param{int}{ style}}

Sets the font style.

\wxheading{Parameters}

\docparam{style}{One of {\bf wxNORMAL}, {\bf wxSLANT} and {\bf wxITALIC}.}

\wxheading{See also}

\helpref{wxFont::GetStyle}{wxfontgetstyle}

\membersection{wxFont::SetUnderlined}\label{wxfontsetunderlined}

\func{void}{SetUnderlined}{\param{const bool}{ underlined}}

Sets underlining.

\wxheading{Parameters}

\docparam{underlining}{TRUE to underline, FALSE otherwise.}

\wxheading{See also}

\helpref{wxFont::GetUnderlined}{wxfontgetunderlined}

\membersection{wxFont::SetWeight}\label{wxfontsetweight}

\func{void}{SetWeight}{\param{int}{ weight}}

Sets the font weight.

\wxheading{Parameters}

\docparam{weight}{One of {\bf wxNORMAL}, {\bf wxLIGHT} and {\bf wxBOLD}.}

\wxheading{See also}

\helpref{wxFont::GetWeight}{wxfontgetweight}

\membersection{wxFont::operator $=$}\label{wxfontassignment}

\func{wxFont\&}{operator $=$}{\param{const wxFont\& }{font}}

Assignment operator, using reference counting. Returns a reference
to `this'.

\membersection{wxFont::operator $==$}\label{wxfontequals}

\func{bool}{operator $==$}{\param{const wxFont\& }{font}}

Equality operator. Two fonts are equal if they contain pointers
to the same underlying font data. It does not compare each attribute,
so two indefontdently-created fonts using the same parameters will
fail the test.

\membersection{wxFont::operator $!=$}\label{wxfontnotequals}

\func{bool}{operator $!=$}{\param{const wxFont\& }{font}}

Inequality operator. Two fonts are not equal if they contain pointers
to different underlying font data. It does not compare each attribute.
Commit	Line	Data
a660d684 KB	1	\section{\class{wxFont}}\label{wxfont}
	2
	3	A font is an object which determines the appearance of text. Fonts are
	4	used for drawing text to a device context, and setting the appearance of
	5	a window's text.
	6
	7	\wxheading{Derived from}
	8
	9	\helpref{wxGDIObject}{wxgdiobject}\\
	10	\helpref{wxObject}{wxobject}
	11
954b8ae6 JS	12	\wxheading{Include files}
	13
	14	<wx/font.h>
	15
dccce9ea VZ	16	\wxheading{Constants}
	17
	18	\begin{verbatim}
	19	enum wxFontEncoding
	20	{
	21	wxFONTENCODING_SYSTEM = -1, // system default
	22	wxFONTENCODING_DEFAULT, // current default encoding
	23
	24	// ISO8859 standard defines a number of single-byte charsets
	25	wxFONTENCODING_ISO8859_1, // West European (Latin1)
	26	wxFONTENCODING_ISO8859_2, // Central and East European (Latin2)
	27	wxFONTENCODING_ISO8859_3, // Esperanto (Latin3)
	28	wxFONTENCODING_ISO8859_4, // Baltic (old) (Latin4)
	29	wxFONTENCODING_ISO8859_5, // Cyrillic
	30	wxFONTENCODING_ISO8859_6, // Arabic
	31	wxFONTENCODING_ISO8859_7, // Greek
	32	wxFONTENCODING_ISO8859_8, // Hebrew
	33	wxFONTENCODING_ISO8859_9, // Turkish (Latin5)
	34	wxFONTENCODING_ISO8859_10, // Variation of Latin4 (Latin6)
	35	wxFONTENCODING_ISO8859_11, // Thai
	36	wxFONTENCODING_ISO8859_12, // doesn't exist currently, but put it
	37	// here anyhow to make all ISO8859
	38	// consecutive numbers
	39	wxFONTENCODING_ISO8859_13, // Baltic (Latin7)
	40	wxFONTENCODING_ISO8859_14, // Latin8
	41	wxFONTENCODING_ISO8859_15, // Latin9 (a.k.a. Latin0, includes euro)
	42	wxFONTENCODING_ISO8859_MAX,
	43
	44	// Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
	45	wxFONTENCODING_KOI8, // we don't support any of KOI8 variants
	46	wxFONTENCODING_ALTERNATIVE, // same as MS-DOS CP866
	47	wxFONTENCODING_BULGARIAN, // used under Linux in Bulgaria
	48
	49	// what would we do without Microsoft? They have their own encodings
	50	// for DOS
	51	wxFONTENCODING_CP437, // original MS-DOS codepage
	52	wxFONTENCODING_CP850, // CP437 merged with Latin1
	53	wxFONTENCODING_CP852, // CP437 merged with Latin2
	54	wxFONTENCODING_CP855, // another cyrillic encoding
	55	wxFONTENCODING_CP866, // and another one
	56	// and for Windows
	57	wxFONTENCODING_CP874, // WinThai
	58	wxFONTENCODING_CP1250, // WinLatin2
	59	wxFONTENCODING_CP1251, // WinCyrillic
	60	wxFONTENCODING_CP1252, // WinLatin1
	61	wxFONTENCODING_CP1253, // WinGreek (8859-7)
	62	wxFONTENCODING_CP1254, // WinTurkish
	63	wxFONTENCODING_CP1255, // WinHebrew
	64	wxFONTENCODING_CP1256, // WinArabic
	65	wxFONTENCODING_CP1257, // WinBaltic (same as Latin 7)
	66	wxFONTENCODING_CP12_MAX,
	67
	68	wxFONTENCODING_UTF7, // UTF-7 Unicode encoding
	69	wxFONTENCODING_UTF8, // UTF-8 Unicode encoding
	70
	71	wxFONTENCODING_UNICODE, // Unicode - currently used only by
	72	// wxEncodingConverter class
	73
	74	wxFONTENCODING_MAX
	75	};
	76	\end{verbatim}
	77
20e85460 JS	78	\wxheading{Predefined objects}
	79
	80	Objects:
	81
	82	{\bf wxNullFont}
	83
	84	Pointers:
	85
	86	{\bf wxNORMAL\_FONT\\
	87	wxSMALL\_FONT\\
	88	wxITALIC\_FONT\\
	89	wxSWISS\_FONT}
	90
a660d684 KB	91	\wxheading{See also}
	92
	93	\helpref{wxFont overview}{wxfontoverview}, \helpref{wxDC::SetFont}{wxdcsetfont},\rtfsp
	94	\helpref{wxDC::DrawText}{wxdcdrawtext}, \helpref{wxDC::GetTextExtent}{wxdcgettextextent},\rtfsp
	95	\helpref{wxFontDialog}{wxfontdialog}
	96
	97	\latexignore{\rtfignore{\wxheading{Members}}}
	98
	99	\membersection{wxFont::wxFont}\label{wxfontconstr}
	100
	101	\func{}{wxFont}{\void}
	102
	103	Default constructor.
	104
eaaa6a06	105	\func{}{wxFont}{\param{int}{ pointSize}, \param{int}{ family}, \param{int}{ style}, \param{int}{ weight},
0c5d3e1c VZ	106	\param{const bool}{ underline = FALSE}, \param{const wxString\& }{faceName = ""},
0c5d3e1c VZ	107	\param{wxFontEncoding }{encoding = wxFONTENCODING\_DEFAULT}}
a660d684	108
775a998e VZ	109	Creates a font object (see \helpref{font encoding
775a998e VZ	110	overview}{wxfontencodingoverview} for the meaning of the last parameter).
a660d684 KB	111
	112	\wxheading{Parameters}
	113
	114	\docparam{pointSize}{Size in points.}
	115
	116	\docparam{family}{Font family, a generic way of referring to fonts without specifying actual facename. One of:
	117
	118	\twocolwidtha{5cm}
	119	\begin{twocollist}\itemsep=0pt
	120	\twocolitem{{\bf wxDEFAULT}}{Chooses a default font.}
	121	\twocolitem{{\bf wxDECORATIVE}}{A decorative font.}
	122	\twocolitem{{\bf wxROMAN}}{A formal, serif font.}
	123	\twocolitem{{\bf wxSCRIPT}}{A handwriting font.}
	124	\twocolitem{{\bf wxSWISS}}{A sans-serif font.}
	125	\twocolitem{{\bf wxMODERN}}{A fixed pitch font.}
	126	\end{twocollist}}
	127
	128	\docparam{style}{One of {\bf wxNORMAL}, {\bf wxSLANT} and {\bf wxITALIC}.}
	129
	130	\docparam{weight}{One of {\bf wxNORMAL}, {\bf wxLIGHT} and {\bf wxBOLD}.}
	131
	132	\docparam{underline}{The value can be TRUE or FALSE. At present this has an effect on Windows only.}
	133
	134	\docparam{faceName}{An optional string specifying the actual typeface to be used. If the empty string,
	135	a default typeface will chosen based on the family.}
	136
0c5d3e1c VZ	137	\docparam{encoding}{An encoding which may be one of
	138	\twocolwidtha{5cm}
	139	\begin{twocollist}\itemsep=0pt
	140	\twocolitem{{\bf wxFONTENCODING\_SYSTEM}}{Default system encoding.}
	141	\twocolitem{{\bf wxFONTENCODING\_DEFAULT}}{Default application encoding: this
	142	is the encoding set by calls to
88b1927c	143	\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding} and which may be set to,
0c5d3e1c VZ	144	say, KOI8 to create all fonts by default with KOI8 encoding. Initially, the
	145	default application encoding is the same as default system encoding.}
	146	\twocolitem{{\bf wxFONTENCODING\_ISO8859\_1...15}}{ISO8859 encodings.}
	147	\twocolitem{{\bf wxFONTENCODING\_KOI8}}{The standard russian encoding for Internet.}
	148	\twocolitem{{\bf wxFONTENCODING\_CP1250...1252}}{Windows encodings similar to ISO8859 (but not identical).}
	149	\end{twocollist}
	150	If the specified encoding isn't available, no font is created.
	151	}
	152
a660d684 KB	153	\wxheading{Remarks}
	154
	155	If the desired font does not exist, the closest match will be chosen.
	156	Under Windows, only scaleable TrueType fonts are used.
	157
a660d684 KB	158	See also \helpref{wxDC::SetFont}{wxdcsetfont}, \helpref{wxDC::DrawText}{wxdcdrawtext}
	159	and \helpref{wxDC::GetTextExtent}{wxdcgettextextent}.
	160
	161	\membersection{wxFont::\destruct{wxFont}}
	162
	163	\func{}{\destruct{wxFont}}{\void}
	164
	165	Destructor.
	166
	167	\wxheading{Remarks}
	168
	169	The destructor may not delete the underlying font object of the native windowing
775a998e	170	system, since wxFont uses a reference counting system for efficiency.
a660d684 KB	171
	172	Although all remaining fonts are deleted when the application exits,
	173	the application should try to clean up all fonts itself. This is because
	174	wxWindows cannot know if a pointer to the font object is stored in an
	175	application data structure, and there is a risk of double deletion.
	176
53f6aab7 VZ	177	\membersection{wxFont::IsFixedWidth}\label{wxfontisfixedwidth}
	178
	179	\constfunc{bool}{IsFixedWidth}{\void}
	180
	181	Returns {\tt TRUE} if the font is a fixed width (or monospaced) font,
	182	{\tt FALSE} if it is a proportional one or font is invalid.
	183
775a998e VZ	184	\membersection{wxFont::GetDefaultEncoding}\label{wxfontgetdefaultencoding}
	185
	186	\func{static wxFontEncoding}{GetDefaultEncoding}{\void}
	187
	188	Returns the current applications default encoding.
	189
	190	\wxheading{See also}
	191
	192	\helpref{Font encoding overview}{wxfontencodingoverview},
	193	\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding}
	194
a660d684 KB	195	\membersection{wxFont::GetFaceName}\label{wxfontgetfacename}
	196
	197	\constfunc{wxString}{GetFaceName}{\void}
	198
	199	Returns the typeface name associated with the font, or the empty string if there is no
	200	typeface information.
	201
	202	\wxheading{See also}
	203
	204	\helpref{wxFont::SetFaceName}{wxfontsetfacename}
	205
	206	\membersection{wxFont::GetFamily}\label{wxfontgetfamily}
	207
	208	\constfunc{int}{GetFamily}{\void}
	209
	210	Gets the font family. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
	211	family identifiers.
	212
	213	\wxheading{See also}
	214
	215	\helpref{wxFont::SetFamily}{wxfontsetfamily}
	216
dccb75b6	217	\membersection{wxFont::GetNativeFontInfoDesc}\label{wxfontgetnativefontinfodesc}
a660d684	218
dccb75b6	219	\constfunc{wxString}{GetNativeFontInfoDesc}{\void}
a660d684	220
dccb75b6 VZ	221	Returns the platform-dependent string completely describing this font or an
	222	empty string if the font wasn't constructed using the native font description.
	223
	224	\wxheading{See also}
	225
	226	\helpref{wxFont::SetNativeFontInfo}{wxfontsetnativefontinfo}
a660d684 KB	227
	228	\membersection{wxFont::GetPointSize}\label{wxfontgetpointsize}
	229
	230	\constfunc{int}{GetPointSize}{\void}
	231
	232	Gets the point size.
	233
	234	\wxheading{See also}
	235
	236	\helpref{wxFont::SetPointSize}{wxfontsetpointsize}
	237
	238	\membersection{wxFont::GetStyle}\label{wxfontgetstyle}
	239
	240	\constfunc{int}{GetStyle}{\void}
	241
	242	Gets the font style. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
	243	styles.
	244
	245	\wxheading{See also}
	246
	247	\helpref{wxFont::SetStyle}{wxfontsetstyle}
	248
	249	\membersection{wxFont::GetUnderlined}\label{wxfontgetunderlined}
	250
	251	\constfunc{bool}{GetUnderlined}{\void}
	252
	253	Returns TRUE if the font is underlined, FALSE otherwise.
	254
	255	\wxheading{See also}
	256
	257	\helpref{wxFont::SetUnderlined}{wxfontsetunderlined}
	258
	259	\membersection{wxFont::GetWeight}\label{wxfontgetweight}
	260
	261	\constfunc{int}{GetWeight}{\void}
	262
	263	Gets the font weight. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
	264	weight identifiers.
	265
	266	\wxheading{See also}
	267
	268	\helpref{wxFont::SetWeight}{wxfontsetweight}
	269
88b1927c JS	270	\membersection{wxFont::SetDefaultEncoding}\label{wxfontsetdefaultencoding}
	271
	272	\func{static void}{SetDefaultEncoding}{\param{wxFontEncoding }{encoding}}
	273
	274	Sets the default font encoding.
	275
775a998e VZ	276	\wxheading{See also}
	277
	278	\helpref{Font encoding overview}{wxfontencodingoverview},
	279	\helpref{GetDefaultEncoding}{wxfontgetdefaultencoding}
	280
a660d684 KB	281	\membersection{wxFont::SetFaceName}\label{wxfontsetfacename}
	282
	283	\func{void}{SetFaceName}{\param{const wxString\& }{faceName}}
	284
	285	Sets the facename for the font.
	286
	287	\wxheading{Parameters}
	288
	289	\docparam{faceName}{A valid facename, which should be on the end-user's system.}
	290
	291	\wxheading{Remarks}
	292
	293	To avoid portability problems, don't rely on a specific face, but specify the font family
	294	instead or as well. A suitable font will be found on the end-user's system. If both the
	295	family and the facename are specified, wxWindows will first search for the specific face,
	296	and then for a font belonging to the same family.
	297
	298	\wxheading{See also}
	299
	300	\helpref{wxFont::GetFaceName}{wxfontgetfacename}, \helpref{wxFont::SetFamily}{wxfontsetfamily}
	301
	302	\membersection{wxFont::SetFamily}\label{wxfontsetfamily}
	303
eaaa6a06	304	\func{void}{SetFamily}{\param{int}{ family}}
a660d684 KB	305
	306	Sets the font family.
	307
	308	\wxheading{Parameters}
	309
	310	\docparam{family}{One of:
	311
	312	\twocolwidtha{5cm}
	313	\begin{twocollist}\itemsep=0pt
	314	\twocolitem{{\bf wxDEFAULT}}{Chooses a default font.}
	315	\twocolitem{{\bf wxDECORATIVE}}{A decorative font.}
	316	\twocolitem{{\bf wxROMAN}}{A formal, serif font.}
	317	\twocolitem{{\bf wxSCRIPT}}{A handwriting font.}
	318	\twocolitem{{\bf wxSWISS}}{A sans-serif font.}
	319	\twocolitem{{\bf wxMODERN}}{A fixed pitch font.}
	320	\end{twocollist}}
	321
	322	\wxheading{See also}
	323
	324	\helpref{wxFont::GetFamily}{wxfontgetfamily}, \helpref{wxFont::SetFaceName}{wxfontsetfacename}
	325
dccb75b6 VZ	326	\membersection{wxFont::SetNativeFontInfo}\label{wxfontsetnativefontinfo}
	327
	328	\func{void}{SetNativeFontInfo}{\param{const wxString\& }{info}}
	329
	330	Creates the font corresponding to the given native font description string
	331	which must have been previously returned by
	332	\helpref{GetNativeFontInfoDesc}{wxfontgetnativefontinfodesc}. If the string is
	333	invalid, font is unchanged.
	334
a660d684 KB	335	\membersection{wxFont::SetPointSize}\label{wxfontsetpointsize}
a660d684 KB	336
eaaa6a06	337	\func{void}{SetPointSize}{\param{int}{ pointSize}}
a660d684 KB	338
	339	Sets the point size.
	340
	341	\wxheading{Parameters}
	342
	343	\docparam{pointSize}{Size in points.}
	344
	345	\wxheading{See also}
	346
	347	\helpref{wxFont::GetPointSize}{wxfontgetpointsize}
	348
	349	\membersection{wxFont::SetStyle}\label{wxfontsetstyle}
	350
eaaa6a06	351	\func{void}{SetStyle}{\param{int}{ style}}
a660d684 KB	352
	353	Sets the font style.
	354
	355	\wxheading{Parameters}
	356
	357	\docparam{style}{One of {\bf wxNORMAL}, {\bf wxSLANT} and {\bf wxITALIC}.}
	358
	359	\wxheading{See also}
	360
	361	\helpref{wxFont::GetStyle}{wxfontgetstyle}
	362
	363	\membersection{wxFont::SetUnderlined}\label{wxfontsetunderlined}
	364
	365	\func{void}{SetUnderlined}{\param{const bool}{ underlined}}
	366
	367	Sets underlining.
	368
	369	\wxheading{Parameters}
	370
	371	\docparam{underlining}{TRUE to underline, FALSE otherwise.}
	372
	373	\wxheading{See also}
	374
	375	\helpref{wxFont::GetUnderlined}{wxfontgetunderlined}
	376
	377	\membersection{wxFont::SetWeight}\label{wxfontsetweight}
	378
eaaa6a06	379	\func{void}{SetWeight}{\param{int}{ weight}}
a660d684 KB	380
	381	Sets the font weight.
	382
	383	\wxheading{Parameters}
	384
	385	\docparam{weight}{One of {\bf wxNORMAL}, {\bf wxLIGHT} and {\bf wxBOLD}.}
	386
	387	\wxheading{See also}
	388
	389	\helpref{wxFont::GetWeight}{wxfontgetweight}
	390
	391	\membersection{wxFont::operator $=$}\label{wxfontassignment}
	392
	393	\func{wxFont\&}{operator $=$}{\param{const wxFont\& }{font}}
	394
	395	Assignment operator, using reference counting. Returns a reference
	396	to `this'.
	397
	398	\membersection{wxFont::operator $==$}\label{wxfontequals}
	399
	400	\func{bool}{operator $==$}{\param{const wxFont\& }{font}}
	401
	402	Equality operator. Two fonts are equal if they contain pointers
	403	to the same underlying font data. It does not compare each attribute,
	404	so two indefontdently-created fonts using the same parameters will
	405	fail the test.
	406
	407	\membersection{wxFont::operator $!=$}\label{wxfontnotequals}
	408
	409	\func{bool}{operator $!=$}{\param{const wxFont\& }{font}}
	410
	411	Inequality operator. Two fonts are not equal if they contain pointers
	412	to different underlying font data. It does not compare each attribute.
	413
	414