fixing warning and compile error against 10.4

[wxWidgets.git] / include / wx / fontmap.h

diff --git a/include/wx/fontmap.h b/include/wx/fontmap.h
index 7e3481db5b3921f1c04167716522149372f446f5..98a799a12b3284fecbb9e881d1265e6c55aa1f55 100644 (file)
--- a/include/wx/fontmap.h
+++ b/include/wx/fontmap.h
@@ -25,17 +25,17 @@
 #endif // wxUSE_GUI
 
 #if wxUSE_CONFIG && wxUSE_FILECONFIG
 #endif // wxUSE_GUI
 
 #if wxUSE_CONFIG && wxUSE_FILECONFIG

-    class WXDLLIMPEXP_BASE wxConfigBase;
+    class WXDLLIMPEXP_FWD_BASE wxConfigBase;

 #endif // wxUSE_CONFIG
 
 #endif // wxUSE_CONFIG
 

-class WXDLLIMPEXP_BASE wxFontMapper;
+class WXDLLIMPEXP_FWD_CORE wxFontMapper;

 
 #if wxUSE_GUI
 
 #if wxUSE_GUI

-    class WXDLLIMPEXP_CORE wxWindow;
+    class WXDLLIMPEXP_FWD_CORE wxWindow;

 #endif // wxUSE_GUI
 
 // ============================================================================
 #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
 // 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:
 class WXDLLIMPEXP_BASE wxFontMapperBase
 {
 public:

-    // constructtor and such
+    // constructor and such

     // ---------------------
 
     // default ctor
     // ---------------------
 
     // default ctor


@@ -60,11 +60,18 @@ public:
     virtual ~wxFontMapperBase();
 
     // return instance of the wxFontMapper singleton
     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);
 
 
     // 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
     // --------------------------------------
 
     // translates charset strings to encoding
     // --------------------------------------
 


@@ -85,15 +92,24 @@ public:
     // get the n-th supported encoding
     static wxFontEncoding GetEncoding(size_t n);
 
     // 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);
 
     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);
 
     // 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
 
     // 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
     // ----------------------------------------------------------------------
 
 #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
     // 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
 
 
 #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
 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
     wxConfigBase *GetConfig();
 
     // gets the root path for our settings -- if it wasn't set explicitly, use


@@ -135,8 +152,7 @@ protected:
     void RestorePath(const wxString& pathOld);
 
     // config object and path (in it) to use
     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
 
     wxString m_configRootPath;
 #endif // wxUSE_CONFIG


@@ -154,7 +170,7 @@ private:
 
     friend class wxFontMapperPathChanger;
 
 
     friend class wxFontMapperPathChanger;
 

-    DECLARE_NO_COPY_CLASS(wxFontMapperBase)
+    wxDECLARE_NO_COPY_CLASS(wxFontMapperBase);

 };
 
 // ----------------------------------------------------------------------------
 };
 
 // ----------------------------------------------------------------------------


@@ -206,7 +222,9 @@ public:
                            bool interactive = true);
 
     // checks whether given encoding is available in given face or not.
                            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);
 
     virtual bool IsEncodingAvailable(wxFontEncoding encoding,
                                      const wxString& facename = wxEmptyString);
 


@@ -220,6 +238,12 @@ public:
     // the title for the dialogs (note that default is quite reasonable)
     void SetDialogTitle(const wxString& title) { m_titleDialog = title; }
 
     // 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
 
 protected:
     // GetAltForEncoding() helper: tests for the existence of the given


@@ -240,22 +264,16 @@ protected:
     wxWindow *m_windowParent;
 
 private:
     wxWindow *m_windowParent;
 
 private:

-    DECLARE_NO_COPY_CLASS(wxFontMapper)
-};
-
-#else // !wxUSE_GUI
-
-class WXDLLIMPEXP_BASE wxFontMapper : public wxFontMapperBase
-{
+    wxDECLARE_NO_COPY_CLASS(wxFontMapper);

 };
 
 };
 

-#endif // wxUSE_GUI/!wxUSE_GUI
+#endif // wxUSE_GUI

 
 // ----------------------------------------------------------------------------
 // global variables
 // ----------------------------------------------------------------------------
 
 
 // ----------------------------------------------------------------------------
 // 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())
 
 // backward compatibility, use wxFontMapper::Get() instead
 #define wxTheFontMapper (wxFontMapper::Get())