1999-11-03 23:51:07 +00:00
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
%% Name: fontenum.tex
|
|
|
|
%% Purpose: wxFontEnumerator documentation
|
|
|
|
%% Author: Vadim Zeitlin
|
|
|
|
%% Modified by:
|
|
|
|
%% Created: 03.11.99
|
|
|
|
%% RCS-ID: $Id$
|
|
|
|
%% Copyright: (c) Vadim Zeitlin
|
|
|
|
%% Licence: wxWindows licence
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
|
|
|
|
\section{\class{wxFontEnumerator}}\label{wxfontenumerator}
|
|
|
|
|
|
|
|
wxFontEnumerator enumerates either all available fonts on the system or only
|
|
|
|
the ones with given attributes - either only fixed-width (suited for use in
|
|
|
|
programs such as terminal emulators and the like) or the fonts available in
|
|
|
|
the given \helpref{encoding}{wxfontencodingoverview}.
|
|
|
|
|
|
|
|
To do this, you just have to call one of EnumerateXXX() functions - either
|
1999-11-04 20:40:41 +00:00
|
|
|
\helpref{EnumerateFacenames}{wxfontenumeratorenumeratefacenames} or
|
1999-11-03 23:51:07 +00:00
|
|
|
\helpref{EnumerateEncodings}{wxfontenumeratorenumerateencodings} and the
|
|
|
|
corresponding callback (
|
1999-11-04 20:40:41 +00:00
|
|
|
\helpref{OnFacename}{wxFontEnumeratoronfacename} or
|
1999-11-03 23:51:07 +00:00
|
|
|
\helpref{OnFontEncoding}{wxfontenumeratoronfontencoding}) will be called
|
|
|
|
repeatedly until either all fonts (satisfying the specified criteria) are
|
|
|
|
exhausted or the callback returns FALSE.
|
|
|
|
|
|
|
|
\wxheading{Virtual functions to override}
|
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
Either \helpref{OnFacename}{wxfontenumeratoronfacename} or
|
1999-11-03 23:51:07 +00:00
|
|
|
\helpref{OnFontEncoding}{wxfontenumeratoronfontencoding} should be overridden
|
|
|
|
depending on whether you plan to call
|
1999-11-04 20:40:41 +00:00
|
|
|
\helpref{EnumerateFacenames}{wxfontenumeratorenumeratefacenames} or
|
1999-11-03 23:51:07 +00:00
|
|
|
\helpref{EnumerateEncodings}{wxfontenumeratorenumerateencodings}. Of course,
|
|
|
|
if you call both of them, you should override both functions.
|
|
|
|
|
|
|
|
\wxheading{Derived from}
|
|
|
|
|
|
|
|
None
|
|
|
|
|
|
|
|
\wxheading{Include files}
|
|
|
|
|
|
|
|
<wx/fontenum.h>
|
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{Font encoding overview}{wxfontencodingoverview},
|
|
|
|
\helpref{Font sample}{samplefont},
|
|
|
|
\helpref{wxFont}{wxfont},
|
|
|
|
\helpref{wxFontMapper}{wxfontmapper}
|
|
|
|
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
\membersection{wxFontEnumerator::EnumerateFacenames}\label{wxfontenumeratorenumeratefacenames}
|
1999-11-03 23:51:07 +00:00
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
\func{virtual bool}{EnumerateFacenames}{
|
1999-11-03 23:51:07 +00:00
|
|
|
\param{wxFontEncoding }{encoding = wxFONTENCODING\_SYSTEM},
|
|
|
|
\param{bool }{fixedWidthOnly = FALSE}}
|
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
Call \helpref{OnFacename}{wxfontenumeratoronfacename} for each font which
|
1999-11-03 23:51:07 +00:00
|
|
|
supports given encoding (only if it is not wxFONTENCODING\_SYSTEM) and is of
|
|
|
|
fixed width (if {\it fixedWidthOnly} is TRUE).
|
|
|
|
|
|
|
|
Calling this function with default arguments will result in enumerating all
|
|
|
|
fonts available on the system.
|
|
|
|
|
|
|
|
\membersection{wxFontEnumerator::EnumerateEncodings}\label{wxfontenumeratorenumerateencodings}
|
|
|
|
|
|
|
|
\func{virtual bool}{EnumerateEncodings}{\param{const wxString\& }{font = ""}}
|
|
|
|
|
|
|
|
Call \helpref{OnFontEncoding}{wxfontenumeratoronfontencoding} for each
|
|
|
|
encoding supported by the given font - or for each encoding supported by at
|
|
|
|
least some font if {\it font} is not specified.
|
|
|
|
|
1999-11-06 15:38:23 +00:00
|
|
|
|
|
|
|
\membersection{wxFontEnumerator::GetEncodings}\label{wxfontenumeratorgetencodings}
|
|
|
|
|
|
|
|
\func{wxArrayString*}{GetEncodings}{\void}
|
|
|
|
|
|
|
|
Return array of strings containing all encodings found by
|
|
|
|
\helpref{EnumerateEncodings}{wxfontenumeratorenumerateencodings}. This is convenience function. It is
|
|
|
|
based on default implementation of \helpref{OnFontEncoding}{wxfontenumeratoronfontencoding} so don't expect
|
|
|
|
it to work if you overwrite that method.
|
|
|
|
|
|
|
|
\membersection{wxFontEnumerator::GetFacenames}\label{wxfontenumeratorgetfacenames}
|
|
|
|
|
|
|
|
\func{wxArrayString*}{GetFacenames}{\void}
|
|
|
|
|
|
|
|
Return array of strings containing all facenames found by
|
|
|
|
\helpref{EnumerateFacenames}{wxfontenumeratorenumeratefacenames}. This is convenience function. It is
|
|
|
|
based on default implementation of \helpref{OnFacename}{wxfontenumeratoronfacename} so don't expect
|
|
|
|
it to work if you overwrite that method.
|
|
|
|
|
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
\membersection{wxFontEnumerator::OnFacename}\label{wxfontenumeratoronfacename}
|
1999-11-03 23:51:07 +00:00
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
\func{virtual bool}{OnFacename}{\param{const wxString\& }{font}}
|
1999-11-03 23:51:07 +00:00
|
|
|
|
1999-11-04 20:40:41 +00:00
|
|
|
Called by \helpref{EnumerateFacenames}{wxfontenumeratorenumeratefacenames} for
|
1999-11-03 23:51:07 +00:00
|
|
|
each match. Return TRUE to continue enumeration or FALSE to stop it.
|
|
|
|
|
|
|
|
\membersection{wxFontEnumerator::OnFontEncoding}\label{wxfontenumeratoronfontencoding}
|
|
|
|
|
|
|
|
\func{virtual bool}{OnFontEncoding}{
|
1999-11-04 20:43:52 +00:00
|
|
|
\param{const wxString\& }{font},
|
|
|
|
\param{const wxString\& }{encoding}
|
1999-11-03 23:51:07 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
Called by \helpref{EnumerateEncodings}{wxfontenumeratorenumerateencodings} for
|
|
|
|
each match. Return TRUE to continue enumeration or FALSE to stop it.
|
|
|
|
|