X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7beba2fc73283f5b750227459da57e66bcd475f5..6968a3b87cee46f5c5af9b46e1ef97f17133cef7:/include/wx/fontenum.h?ds=sidebyside diff --git a/include/wx/fontenum.h b/include/wx/fontenum.h index 5b82956ddd..051ee572c1 100644 --- a/include/wx/fontenum.h +++ b/include/wx/fontenum.h @@ -1,5 +1,5 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: fontenum.h +// Name: wx/fontenum.h // Purpose: wxFontEnumerator class for getting available fonts // Author: Julian Smart, Vadim Zeitlin // Modified by: extended to enumerate more than just font facenames and works @@ -13,50 +13,77 @@ #ifndef _WX_FONTENUM_H_ #define _WX_FONTENUM_H_ -#ifdef __GNUG__ - #pragma interface "fontenum.h" -#endif +#include "wx/defs.h" + +#if wxUSE_FONTENUM -#include "wx/font.h" +#include "wx/fontenc.h" +#include "wx/arrstr.h" // ---------------------------------------------------------------------------- // wxFontEnumerator enumerates all available fonts on the system or only the // fonts with given attributes // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxFontEnumerator +class WXDLLIMPEXP_CORE wxFontEnumerator { public: + wxFontEnumerator() {} + + // virtual dtor for the base class + virtual ~wxFontEnumerator() {} + // start enumerating font facenames (either all of them or those which // support the given encoding) - will result in OnFacename() being // called for each available facename (until they are exhausted or - // OnFacename returns FALSE) + // OnFacename returns false) virtual bool EnumerateFacenames ( wxFontEncoding encoding = wxFONTENCODING_SYSTEM, // all - bool fixedWidthOnly = FALSE + bool fixedWidthOnly = false ); // enumerate the different encodings either for given font facename or for // all facenames - will result in OnFontEncoding() being called for each // available (facename, encoding) couple - virtual bool EnumerateEncodings(const wxString& facename = wxT("")); + virtual bool EnumerateEncodings(const wxString& facename = wxEmptyString); // callbacks which are called after one of EnumerateXXX() functions from - // above is invoked - all of them may return FALSE to stop enumeration or - // TRUE to continue with it + // above is invoked - all of them may return false to stop enumeration or + // true to continue with it // called by EnumerateFacenames virtual bool OnFacename(const wxString& WXUNUSED(facename)) - { return FALSE; } + { return true; } // called by EnumerateEncodings virtual bool OnFontEncoding(const wxString& WXUNUSED(facename), const wxString& WXUNUSED(encoding)) - { return FALSE; } + { return true; } - // virtual dtor for the base class - virtual ~wxFontEnumerator() { } + + + // convenience function that returns array of facenames. + static wxArrayString + GetFacenames(wxFontEncoding encoding = wxFONTENCODING_SYSTEM, // all + bool fixedWidthOnly = false); + + // convenience function that returns array of all available encodings. + static wxArrayString GetEncodings(const wxString& facename = wxEmptyString); + + // convenience function that returns true if the given face name exist + // in the user's system + static bool IsValidFacename(const wxString &str); + +private: +#ifdef wxHAS_UTF8_FONTS + // helper for ports that only use UTF-8 encoding natively + bool EnumerateEncodingsUTF8(const wxString& facename); +#endif + + wxDECLARE_NO_COPY_CLASS(wxFontEnumerator); }; +#endif // wxUSE_FONTENUM + #endif // _WX_FONTENUM_H_