[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::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
775a998e VZ	177	\membersection{wxFont::GetDefaultEncoding}\label{wxfontgetdefaultencoding}
	178
	179	\func{static wxFontEncoding}{GetDefaultEncoding}{\void}
	180
	181	Returns the current applications default encoding.
	182
	183	\wxheading{See also}
	184
	185	\helpref{Font encoding overview}{wxfontencodingoverview},
	186	\helpref{SetDefaultEncoding}{wxfontsetdefaultencoding}
	187
a660d684 KB	188	\membersection{wxFont::GetFaceName}\label{wxfontgetfacename}
	189
	190	\constfunc{wxString}{GetFaceName}{\void}
	191
	192	Returns the typeface name associated with the font, or the empty string if there is no
	193	typeface information.
	194
	195	\wxheading{See also}
	196
	197	\helpref{wxFont::SetFaceName}{wxfontsetfacename}
	198
	199	\membersection{wxFont::GetFamily}\label{wxfontgetfamily}
	200
	201	\constfunc{int}{GetFamily}{\void}
	202
	203	Gets the font family. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
	204	family identifiers.
	205
	206	\wxheading{See also}
	207
	208	\helpref{wxFont::SetFamily}{wxfontsetfamily}
	209
dccb75b6	210	\membersection{wxFont::GetNativeFontInfoDesc}\label{wxfontgetnativefontinfodesc}
a660d684	211
dccb75b6	212	\constfunc{wxString}{GetNativeFontInfoDesc}{\void}
a660d684	213
dccb75b6 VZ	214	Returns the platform-dependent string completely describing this font or an
	215	empty string if the font wasn't constructed using the native font description.
	216
	217	\wxheading{See also}
	218
	219	\helpref{wxFont::SetNativeFontInfo}{wxfontsetnativefontinfo}
a660d684 KB	220
	221	\membersection{wxFont::GetPointSize}\label{wxfontgetpointsize}
	222
	223	\constfunc{int}{GetPointSize}{\void}
	224
	225	Gets the point size.
	226
	227	\wxheading{See also}
	228
	229	\helpref{wxFont::SetPointSize}{wxfontsetpointsize}
	230
	231	\membersection{wxFont::GetStyle}\label{wxfontgetstyle}
	232
	233	\constfunc{int}{GetStyle}{\void}
	234
	235	Gets the font style. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
	236	styles.
	237
	238	\wxheading{See also}
	239
	240	\helpref{wxFont::SetStyle}{wxfontsetstyle}
	241
	242	\membersection{wxFont::GetUnderlined}\label{wxfontgetunderlined}
	243
	244	\constfunc{bool}{GetUnderlined}{\void}
	245
	246	Returns TRUE if the font is underlined, FALSE otherwise.
	247
	248	\wxheading{See also}
	249
	250	\helpref{wxFont::SetUnderlined}{wxfontsetunderlined}
	251
	252	\membersection{wxFont::GetWeight}\label{wxfontgetweight}
	253
	254	\constfunc{int}{GetWeight}{\void}
	255
	256	Gets the font weight. See \helpref{wxFont::wxFont}{wxfontconstr} for a list of valid
	257	weight identifiers.
	258
	259	\wxheading{See also}
	260
	261	\helpref{wxFont::SetWeight}{wxfontsetweight}
	262
88b1927c JS	263	\membersection{wxFont::SetDefaultEncoding}\label{wxfontsetdefaultencoding}
	264
	265	\func{static void}{SetDefaultEncoding}{\param{wxFontEncoding }{encoding}}
	266
	267	Sets the default font encoding.
	268
775a998e VZ	269	\wxheading{See also}
	270
	271	\helpref{Font encoding overview}{wxfontencodingoverview},
	272	\helpref{GetDefaultEncoding}{wxfontgetdefaultencoding}
	273
a660d684 KB	274	\membersection{wxFont::SetFaceName}\label{wxfontsetfacename}
	275
	276	\func{void}{SetFaceName}{\param{const wxString\& }{faceName}}
	277
	278	Sets the facename for the font.
	279
	280	\wxheading{Parameters}
	281
	282	\docparam{faceName}{A valid facename, which should be on the end-user's system.}
	283
	284	\wxheading{Remarks}
	285
	286	To avoid portability problems, don't rely on a specific face, but specify the font family
	287	instead or as well. A suitable font will be found on the end-user's system. If both the
	288	family and the facename are specified, wxWindows will first search for the specific face,
	289	and then for a font belonging to the same family.
	290
	291	\wxheading{See also}
	292
	293	\helpref{wxFont::GetFaceName}{wxfontgetfacename}, \helpref{wxFont::SetFamily}{wxfontsetfamily}
	294
	295	\membersection{wxFont::SetFamily}\label{wxfontsetfamily}
	296
eaaa6a06	297	\func{void}{SetFamily}{\param{int}{ family}}
a660d684 KB	298
	299	Sets the font family.
	300
	301	\wxheading{Parameters}
	302
	303	\docparam{family}{One of:
	304
	305	\twocolwidtha{5cm}
	306	\begin{twocollist}\itemsep=0pt
	307	\twocolitem{{\bf wxDEFAULT}}{Chooses a default font.}
	308	\twocolitem{{\bf wxDECORATIVE}}{A decorative font.}
	309	\twocolitem{{\bf wxROMAN}}{A formal, serif font.}
	310	\twocolitem{{\bf wxSCRIPT}}{A handwriting font.}
	311	\twocolitem{{\bf wxSWISS}}{A sans-serif font.}
	312	\twocolitem{{\bf wxMODERN}}{A fixed pitch font.}
	313	\end{twocollist}}
	314
	315	\wxheading{See also}
	316
	317	\helpref{wxFont::GetFamily}{wxfontgetfamily}, \helpref{wxFont::SetFaceName}{wxfontsetfacename}
	318
dccb75b6 VZ	319	\membersection{wxFont::SetNativeFontInfo}\label{wxfontsetnativefontinfo}
	320
	321	\func{void}{SetNativeFontInfo}{\param{const wxString\& }{info}}
	322
	323	Creates the font corresponding to the given native font description string
	324	which must have been previously returned by
	325	\helpref{GetNativeFontInfoDesc}{wxfontgetnativefontinfodesc}. If the string is
	326	invalid, font is unchanged.
	327
a660d684 KB	328	\membersection{wxFont::SetPointSize}\label{wxfontsetpointsize}
a660d684 KB	329
eaaa6a06	330	\func{void}{SetPointSize}{\param{int}{ pointSize}}
a660d684 KB	331
	332	Sets the point size.
	333
	334	\wxheading{Parameters}
	335
	336	\docparam{pointSize}{Size in points.}
	337
	338	\wxheading{See also}
	339
	340	\helpref{wxFont::GetPointSize}{wxfontgetpointsize}
	341
	342	\membersection{wxFont::SetStyle}\label{wxfontsetstyle}
	343
eaaa6a06	344	\func{void}{SetStyle}{\param{int}{ style}}
a660d684 KB	345
	346	Sets the font style.
	347
	348	\wxheading{Parameters}
	349
	350	\docparam{style}{One of {\bf wxNORMAL}, {\bf wxSLANT} and {\bf wxITALIC}.}
	351
	352	\wxheading{See also}
	353
	354	\helpref{wxFont::GetStyle}{wxfontgetstyle}
	355
	356	\membersection{wxFont::SetUnderlined}\label{wxfontsetunderlined}
	357
	358	\func{void}{SetUnderlined}{\param{const bool}{ underlined}}
	359
	360	Sets underlining.
	361
	362	\wxheading{Parameters}
	363
	364	\docparam{underlining}{TRUE to underline, FALSE otherwise.}
	365
	366	\wxheading{See also}
	367
	368	\helpref{wxFont::GetUnderlined}{wxfontgetunderlined}
	369
	370	\membersection{wxFont::SetWeight}\label{wxfontsetweight}
	371
eaaa6a06	372	\func{void}{SetWeight}{\param{int}{ weight}}
a660d684 KB	373
	374	Sets the font weight.
	375
	376	\wxheading{Parameters}
	377
	378	\docparam{weight}{One of {\bf wxNORMAL}, {\bf wxLIGHT} and {\bf wxBOLD}.}
	379
	380	\wxheading{See also}
	381
	382	\helpref{wxFont::GetWeight}{wxfontgetweight}
	383
	384	\membersection{wxFont::operator $=$}\label{wxfontassignment}
	385
	386	\func{wxFont\&}{operator $=$}{\param{const wxFont\& }{font}}
	387
	388	Assignment operator, using reference counting. Returns a reference
	389	to `this'.
	390
	391	\membersection{wxFont::operator $==$}\label{wxfontequals}
	392
	393	\func{bool}{operator $==$}{\param{const wxFont\& }{font}}
	394
	395	Equality operator. Two fonts are equal if they contain pointers
	396	to the same underlying font data. It does not compare each attribute,
	397	so two indefontdently-created fonts using the same parameters will
	398	fail the test.
	399
	400	\membersection{wxFont::operator $!=$}\label{wxfontnotequals}
	401
	402	\func{bool}{operator $!=$}{\param{const wxFont\& }{font}}
	403
	404	Inequality operator. Two fonts are not equal if they contain pointers
	405	to different underlying font data. It does not compare each attribute.
	406
	407