X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ed39ff57b30a70a2395e07887a70bc01e7a3b7ec..438959cca892a7651634cc3a7aad4819ac49b23c:/include/wx/fontenum.h diff --git a/include/wx/fontenum.h b/include/wx/fontenum.h index 105693a202..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,77 +13,77 @@ #ifndef _WX_FONTENUM_H_ #define _WX_FONTENUM_H_ -#if defined(__GNUG__) && !defined(__APPLE__) - #pragma interface "fontenum.h" -#endif +#include "wx/defs.h" + +#if wxUSE_FONTENUM + +#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() : m_Facenames(NULL), m_Encodings(NULL) { } + 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& facename) - { - if (m_Facenames == NULL) m_Facenames = new wxArrayString; - m_Facenames -> Add(facename); - return TRUE; - } + virtual bool OnFacename(const wxString& WXUNUSED(facename)) + { return true; } // called by EnumerateEncodings virtual bool OnFontEncoding(const wxString& WXUNUSED(facename), - const wxString& encoding) - { - if (m_Encodings == NULL) m_Encodings = new wxArrayString; - m_Encodings -> Add(encoding); - return TRUE; - } - - // convenience function that returns array of facenames. Cannot be called - // before EnumerateFacenames. - wxArrayString *GetFacenames() - { return m_Facenames; } - - // convenience function that returns array of encodings. - // Cannot be called before EnumerateEncodings. - wxArrayString *GetEncodings() - { return m_Encodings; } - - // virtual dtor for the base class - virtual ~wxFontEnumerator() - { - if (m_Facenames) delete m_Facenames; - if (m_Encodings) delete m_Encodings; - } - + const wxString& WXUNUSED(encoding)) + { return true; } + + + + // 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: - wxArrayString *m_Facenames, *m_Encodings; +#ifdef wxHAS_UTF8_FONTS + // helper for ports that only use UTF-8 encoding natively + bool EnumerateEncodingsUTF8(const wxString& facename); +#endif - DECLARE_NO_COPY_CLASS(wxFontEnumerator) + wxDECLARE_NO_COPY_CLASS(wxFontEnumerator); }; +#endif // wxUSE_FONTENUM + #endif // _WX_FONTENUM_H_