#ifndef _WX_FONTMAPPER_H_
#define _WX_FONTMAPPER_H_
-#if defined(__GNUG__) && !defined(__APPLE__)
- #pragma interface "fontmap.h"
-#endif
-
// ----------------------------------------------------------------------------
// headers
// ----------------------------------------------------------------------------
#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 WXDLLEXPORT wxFontMapper;
+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 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
// in knowledge of the encodings equivalence
// ----------------------------------------------------------------------------
-class WXDLLEXPORT wxFontMapperBase
+class WXDLLIMPEXP_BASE wxFontMapperBase
{
public:
- // constructtor and such
+ // constructor and such
// ---------------------
// default ctor
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 sigleton to 'mapper' instance and return previous one
+ // 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
// --------------------------------------
virtual wxFontEncoding CharsetToEncoding(const wxString& charset,
bool interactive = true);
-
// information about supported encodings
// -------------------------------------
// 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
// 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();
+ 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
- // get the config object we're using -- if it wasn't set explicitly, this
- // function will use wxConfig::Get() to get the global one
+#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 it wasn't set explicitly, 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
+ // 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;
#if wxUSE_GUI
-class WXDLLEXPORT wxFontMapper : public wxFontMapperBase
+class WXDLLIMPEXP_CORE wxFontMapper : public wxFontMapperBase
{
public:
// default ctor
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);
// 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
DECLARE_NO_COPY_CLASS(wxFontMapper)
};
-#else // !wxUSE_GUI
-
-class WXDLLEXPORT 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())
projects / wxWidgets.git / blobdiff