X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/910b9fc5c090b6d53a41b1fde661bce751b430b9..6445acc7832ccd1f2fc5211a68c90f4426ab4346:/include/wx/fontmap.h diff --git a/include/wx/fontmap.h b/include/wx/fontmap.h index bc14a74cbb..d057c16bd6 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 @@ -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,10 +92,13 @@ 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?) @@ -108,9 +118,6 @@ 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); @@ -119,10 +126,14 @@ public: #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 @@ -141,8 +152,7 @@ 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 @@ -228,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 @@ -251,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())