X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f1c75e0f93b4ec9f45827cc5a2d16ef17a675dfc..9ed8b5a7b2e41ecb07d2dab32bac32eb7b771fd3:/include/wx/fontmap.h diff --git a/include/wx/fontmap.h b/include/wx/fontmap.h index f13cf47a50..3d86a887ea 100644 --- a/include/wx/fontmap.h +++ b/include/wx/fontmap.h @@ -28,14 +28,14 @@ class WXDLLIMPEXP_BASE wxConfigBase; #endif // wxUSE_CONFIG -class WXDLLIMPEXP_BASE wxFontMapper; +class WXDLLIMPEXP_CORE wxFontMapper; #if wxUSE_GUI class WXDLLIMPEXP_CORE wxWindow; #endif // wxUSE_GUI // ============================================================================ -// wxFontMapper manages user-definable correspondence between wxWindows font +// wxFontMapper manages user-definable correspondence between wxWidgets font // encodings and the fonts present on the machine. // // This is a singleton class, font mapper objects can only be accessed using @@ -50,7 +50,7 @@ class WXDLLIMPEXP_BASE wxFontMapper; class WXDLLIMPEXP_BASE wxFontMapperBase { public: - // constructtor and such + // constructor and such // --------------------- // default ctor @@ -60,11 +60,18 @@ public: virtual ~wxFontMapperBase(); // return instance of the wxFontMapper singleton - static wxFontMapper *Get(); + // 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); + // delete the existing font mapper if any + static void Reset(); + + // translates charset strings to encoding // -------------------------------------- @@ -85,15 +92,24 @@ public: // get the n-th supported encoding static wxFontEncoding GetEncoding(size_t n); - // return internal string identifier for the encoding (see also - // GetEncodingDescription()) + // 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); + // 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); + // functions which allow to configure the config object used: by default, // the global one (from wxConfigBase::Get() will be used) and the default @@ -102,21 +118,22 @@ public: // ---------------------------------------------------------------------- #if wxUSE_CONFIG && wxUSE_FILECONFIG - // set the config object to use (may be NULL to use default) - void SetConfig(wxConfigBase *config) { m_config = config; } - // 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(); + static const wxString& GetDefaultConfigPath(); #endif // wxUSE_CONFIG + // 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 -- if it wasn't set explicitly, this - // function will use wxConfig::Get() to get the global one + // 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 it wasn't set explicitly, use @@ -135,12 +152,18 @@ protected: void RestorePath(const wxString& pathOld); // config object and path (in it) to use - wxConfigBase *m_config; - bool m_configIsDummy; + 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; @@ -199,7 +222,9 @@ public: bool interactive = true); // checks whether given encoding is available in given face or not. - // If no facename is given, + // + // 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); @@ -213,6 +238,12 @@ public: // 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 @@ -236,19 +267,13 @@ private: DECLARE_NO_COPY_CLASS(wxFontMapper) }; -#else // !wxUSE_GUI - -class WXDLLIMPEXP_BASE wxFontMapper : public wxFontMapperBase -{ -}; - -#endif // wxUSE_GUI/!wxUSE_GUI +#endif // wxUSE_GUI // ---------------------------------------------------------------------------- // global variables // ---------------------------------------------------------------------------- -// the default font mapper for wxWindows programs do NOT use! This is for +// the default font mapper for wxWidgets programs do NOT use! This is for // backward compatibility, use wxFontMapper::Get() instead #define wxTheFontMapper (wxFontMapper::Get())