X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/af49c4b8a2d3553e733e71c7dd3911881f4c1a2a..ed903e42421d76ac96e0e48724c66afc611a740a:/include/wx/fontmap.h diff --git a/include/wx/fontmap.h b/include/wx/fontmap.h index eb4c48ea7d..3a260ce5a2 100644 --- a/include/wx/fontmap.h +++ b/include/wx/fontmap.h @@ -6,16 +6,12 @@ // Created: 04.11.99 // RCS-ID: $Id$ // Copyright: (c) Vadim Zeitlin -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// #ifndef _WX_FONTMAPPER_H_ #define _WX_FONTMAPPER_H_ -#if defined(__GNUG__) && !defined(__APPLE__) - #pragma interface "fontmap.h" -#endif - // ---------------------------------------------------------------------------- // headers // ---------------------------------------------------------------------------- @@ -28,92 +24,92 @@ #include "wx/fontutil.h" // for wxNativeEncodingInfo #endif // wxUSE_GUI -#if wxUSE_CONFIG - class WXDLLEXPORT wxConfigBase; +#if wxUSE_CONFIG && wxUSE_FILECONFIG + class WXDLLIMPEXP_FWD_BASE wxConfigBase; #endif // wxUSE_CONFIG +class WXDLLIMPEXP_FWD_CORE wxFontMapper; + #if wxUSE_GUI - class WXDLLEXPORT wxWindow; + class WXDLLIMPEXP_FWD_CORE wxWindow; #endif // wxUSE_GUI -// ---------------------------------------------------------------------------- -// wxFontMapper manages user-definable correspondence between logical font -// names and the fonts present on the machine. +// ============================================================================ +// wxFontMapper manages user-definable correspondence between wxWidgets font +// encodings and the fonts present on the machine. // -// The default implementations of all functions will ask the user if they are -// not capable of finding the answer themselves and store the answer in a -// config file (configurable via SetConfigXXX functions). This behaviour may -// be disabled by giving the value of FALSE to "interactive" parameter. -// However, the functions will always consult the config file to allow the -// user-defined values override the default logic and there is no way to -// disable this - which shouldn't be ever needed because if "interactive" was -// never TRUE, the config file is never created anyhow. +// This is a singleton class, font mapper objects can only be accessed using +// wxFontMapper::Get(). +// ============================================================================ + +// ---------------------------------------------------------------------------- +// wxFontMapperBase: this is a non-interactive class which just uses its built +// in knowledge of the encodings equivalence // ---------------------------------------------------------------------------- -class WXDLLEXPORT wxFontMapper +class WXDLLIMPEXP_BASE wxFontMapperBase { public: + // constructor and such + // --------------------- + // default ctor - wxFontMapper(); + wxFontMapperBase(); - // virtual dtor for a base class - virtual ~wxFontMapper(); + // virtual dtor for any base class + virtual ~wxFontMapperBase(); // return instance of the wxFontMapper singleton - static wxFontMapper *Get(); - // set the sigleton to 'mapper' instance and return previous one + // wxBase code only cares that it's a wxFontMapperBase + // In wxBase, wxFontMapper is only forward declared + // so one cannot implicitly cast from it to wxFontMapperBase. + static wxFontMapperBase *Get(); + + // set the singleton to 'mapper' instance and return previous one static wxFontMapper *Set(wxFontMapper *mapper); -#if wxUSE_GUI - // find an alternative for the given encoding (which is supposed to not be - // available on this system). If successful, return TRUE and fill info - // structure with the parameters required to create the font, otherwise - // return FALSE - virtual bool GetAltForEncoding(wxFontEncoding encoding, - wxNativeEncodingInfo *info, - const wxString& facename = wxEmptyString, - bool interactive = TRUE); + // delete the existing font mapper if any + static void Reset(); - // version better suitable for 'public' use. Returns wxFontEcoding - // that can be used it wxFont ctor - bool GetAltForEncoding(wxFontEncoding encoding, - wxFontEncoding *alt_encoding, - const wxString& facename = wxEmptyString, - bool interactive = TRUE); - // checks whether given encoding is available in given face or not. - // If no facename is given, - virtual bool IsEncodingAvailable(wxFontEncoding encoding, - const wxString& facename = wxEmptyString); -#endif // wxUSE_GUI + // translates charset strings to encoding + // -------------------------------------- // returns the encoding for the given charset (in the form of RFC 2046) or // wxFONTENCODING_SYSTEM if couldn't decode it + // + // interactive parameter is ignored in the base class, we behave as if it + // were always false virtual wxFontEncoding CharsetToEncoding(const wxString& charset, - bool interactive = TRUE); + bool interactive = true); + + // information about supported encodings + // ------------------------------------- - // encoding names - // -------------- + // get the number of font encodings we know about + static size_t GetSupportedEncodingsCount(); - // return internal string identifier for the encoding (see also - // GetEncodingDescription()) + // get the n-th supported encoding + static wxFontEncoding GetEncoding(size_t n); + + // return canonical name of this encoding (this is a short string, + // GetEncodingDescription() returns a longer one) static wxString GetEncodingName(wxFontEncoding encoding); + // return a list of all names of this encoding (see GetEncodingName) + static const wxChar** GetAllEncodingNames(wxFontEncoding encoding); + // return user-readable string describing the given encoding // // NB: hard-coded now, but might change later (read it from config?) static wxString GetEncodingDescription(wxFontEncoding encoding); - // configure the appearance of the dialogs we may popup - // ---------------------------------------------------- + // find the encoding corresponding to the given name, inverse of + // GetEncodingName() and less general than CharsetToEncoding() + // + // returns wxFONTENCODING_MAX if the name is not a supported encoding + static wxFontEncoding GetEncodingFromName(const wxString& name); -#if wxUSE_GUI - // the parent window for modal dialogs - void SetDialogParent(wxWindow *parent) { m_windowParent = parent; } - - // the title for the dialogs (note that default is quite reasonable) - void SetDialogTitle(const wxString& title) { m_titleDialog = title; } -#endif // wxUSE_GUI // functions which allow to configure the config object used: by default, // the global one (from wxConfigBase::Get() will be used) and the default @@ -121,31 +117,31 @@ public: // GetDefaultConfigPath() // ---------------------------------------------------------------------- -#if wxUSE_CONFIG - // set the config object to use (may be NULL to use default) - void SetConfig(wxConfigBase *config) { m_config = config; } - +#if wxUSE_CONFIG && wxUSE_FILECONFIG // set the root config path to use (should be an absolute path) void SetConfigPath(const wxString& prefix); // return default config path - static const wxChar *GetDefaultConfigPath(); -#endif + static const wxString& GetDefaultConfigPath(); +#endif // wxUSE_CONFIG -protected: -#if wxUSE_CONFIG - // get the config object we're using - if it wasn't set explicitly, this - // function will use wxConfig::Get() to get the global one + // returns true for the base class and false for a "real" font mapper object + // (implementation-only) + virtual bool IsDummy() { return true; } + +protected: +#if wxUSE_CONFIG && wxUSE_FILECONFIG + // get the config object we're using -- either the global config object + // or a wxMemoryConfig object created by this class otherwise wxConfigBase *GetConfig(); - // gets the root path for our settings - if itwasn't set explicitly, use + // gets the root path for our settings -- if it wasn't set explicitly, use // GetDefaultConfigPath() const wxString& GetConfigPath(); -#endif - // change to the given (relative) path in the config, return TRUE if ok - // (then GetConfig() will return something !NULL), FALSE if no config + // change to the given (relative) path in the config, return true if ok + // (then GetConfig() will return something !NULL), false if no config // object // // caller should provide a pointer to the string variable which should be @@ -155,7 +151,101 @@ protected: // restore the config path after use void RestorePath(const wxString& pathOld); + // config object and path (in it) to use + wxConfigBase *m_configDummy; + + wxString m_configRootPath; +#endif // wxUSE_CONFIG + + // the real implementation of the base class version of CharsetToEncoding() + // + // returns wxFONTENCODING_UNKNOWN if encoding is unknown and we shouldn't + // ask the user about it, wxFONTENCODING_SYSTEM if it is unknown but we + // should/could ask the user + int NonInteractiveCharsetToEncoding(const wxString& charset); + +private: + // the global fontmapper object or NULL + static wxFontMapper *sm_instance; + + friend class wxFontMapperPathChanger; + + DECLARE_NO_COPY_CLASS(wxFontMapperBase) +}; + +// ---------------------------------------------------------------------------- +// wxFontMapper: interactive extension of wxFontMapperBase +// +// The default implementations of all functions will ask the user if they are +// not capable of finding the answer themselves and store the answer in a +// config file (configurable via SetConfigXXX functions). This behaviour may +// be disabled by giving the value of false to "interactive" parameter. +// However, the functions will always consult the config file to allow the +// user-defined values override the default logic and there is no way to +// disable this -- which shouldn't be ever needed because if "interactive" was +// never true, the config file is never created anyhow. +// ---------------------------------------------------------------------------- + #if wxUSE_GUI + +class WXDLLIMPEXP_CORE wxFontMapper : public wxFontMapperBase +{ +public: + // default ctor + wxFontMapper(); + + // virtual dtor for a base class + virtual ~wxFontMapper(); + + // working with the encodings + // -------------------------- + + // returns the encoding for the given charset (in the form of RFC 2046) or + // wxFONTENCODING_SYSTEM if couldn't decode it + virtual wxFontEncoding CharsetToEncoding(const wxString& charset, + bool interactive = true); + + // find an alternative for the given encoding (which is supposed to not be + // available on this system). If successful, return true and fill info + // structure with the parameters required to create the font, otherwise + // return false + virtual bool GetAltForEncoding(wxFontEncoding encoding, + wxNativeEncodingInfo *info, + const wxString& facename = wxEmptyString, + bool interactive = true); + + // version better suitable for 'public' use. Returns wxFontEcoding + // that can be used it wxFont ctor + bool GetAltForEncoding(wxFontEncoding encoding, + wxFontEncoding *alt_encoding, + const wxString& facename = wxEmptyString, + bool interactive = true); + + // checks whether given encoding is available in given face or not. + // + // if no facename is given (default), return true if it's available in any + // facename at alll. + virtual bool IsEncodingAvailable(wxFontEncoding encoding, + const wxString& facename = wxEmptyString); + + + // configure the appearance of the dialogs we may popup + // ---------------------------------------------------- + + // the parent window for modal dialogs + void SetDialogParent(wxWindow *parent) { m_windowParent = parent; } + + // the title for the dialogs (note that default is quite reasonable) + void SetDialogTitle(const wxString& title) { m_titleDialog = title; } + + // GUI code needs to know it's a wxFontMapper because there + // are additional methods in the subclass. + static wxFontMapper *Get(); + + // pseudo-RTTI since we aren't a wxObject. + virtual bool IsDummy() { return false; } + +protected: // GetAltForEncoding() helper: tests for the existence of the given // encoding and saves the result in config if ok - this results in the // following (desired) behaviour: when an unknown/unavailable encoding is @@ -166,38 +256,35 @@ protected: bool TestAltEncoding(const wxString& configEntry, wxFontEncoding encReplacement, wxNativeEncodingInfo *info); -#endif // wxUSE_GUI - -#if wxUSE_CONFIG - // config object and path (in it) to use - wxConfigBase *m_config; - bool m_configIsDummy; -#endif - wxString m_configRootPath; - -#if wxUSE_GUI // the title for our dialogs wxString m_titleDialog; // the parent window for our dialogs wxWindow *m_windowParent; -#endif // wxUSE_GUI - friend class wxFontMapperPathChanger; - private: - static wxFontMapper *sm_instance; + DECLARE_NO_COPY_CLASS(wxFontMapper) }; +#endif // wxUSE_GUI + // ---------------------------------------------------------------------------- // global variables // ---------------------------------------------------------------------------- -// the default font mapper for wxWindows programs -// do NOT use! This is for backward compatibility, use wxFontMapper::Get() instead +// the default font mapper for wxWidgets programs do NOT use! This is for +// backward compatibility, use wxFontMapper::Get() instead #define wxTheFontMapper (wxFontMapper::Get()) -#endif // wxUSE_FONTMAP +#else // !wxUSE_FONTMAP + +#if wxUSE_GUI + // wxEncodingToCodepage (utils.cpp) needs wxGetNativeFontEncoding + #include "wx/fontutil.h" +#endif + +#endif // wxUSE_FONTMAP/!wxUSE_FONTMAP #endif // _WX_FONTMAPPER_H_ +