Small usability improvements

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

diff --git a/include/wx/fontenum.h b/include/wx/fontenum.h
index 01af35089f52defde7d93603a33ba452a4d7b9c6..29127061a8bcf78899e5c21cd9efac0143c494dd 100644 (file)
--- a/include/wx/fontenum.h
+++ b/include/wx/fontenum.h
@@ -1,5 +1,5 @@
 /////////////////////////////////////////////////////////////////////////////
 /////////////////////////////////////////////////////////////////////////////

-// Name:        fontenum.h
+// Name:        wx/fontenum.h

 // Purpose:     wxFontEnumerator class for getting available fonts
 // Author:      Julian Smart, Vadim Zeitlin
 // Modified by: extended to enumerate more than just font facenames and works
 // Purpose:     wxFontEnumerator class for getting available fonts
 // Author:      Julian Smart, Vadim Zeitlin
 // Modified by: extended to enumerate more than just font facenames and works


@@ -13,9 +13,9 @@
 #ifndef _WX_FONTENUM_H_
 #define _WX_FONTENUM_H_
 
 #ifndef _WX_FONTENUM_H_
 #define _WX_FONTENUM_H_
 

-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
-    #pragma interface "fontenum.h"
-#endif
+#include "wx/defs.h"
+
+#if wxUSE_FONTENUM

 
 #include "wx/fontenc.h"
 #include "wx/arrstr.h"
 
 #include "wx/fontenc.h"
 #include "wx/arrstr.h"


@@ -28,7 +28,10 @@
 class WXDLLEXPORT wxFontEnumerator
 {
 public:
 class WXDLLEXPORT wxFontEnumerator
 {
 public:

-    wxFontEnumerator() : m_Facenames(NULL), m_Encodings(NULL) { }
+    wxFontEnumerator() {}
+
+    // virtual dtor for the base class
+    virtual ~wxFontEnumerator() {}

 
     // start enumerating font facenames (either all of them or those which
     // support the given encoding) - will result in OnFacename() being
 
     // start enumerating font facenames (either all of them or those which
     // support the given encoding) - will result in OnFacename() being


@@ -50,43 +53,37 @@ public:
     // true to continue with it
 
     // called by EnumerateFacenames
     // true to continue with it
 
     // called by EnumerateFacenames

-    virtual bool OnFacename(const wxString& facename)
-        {
-            if (m_Facenames == NULL) m_Facenames = new wxArrayString;
-            m_Facenames -> Add(facename);
-            return true;
-        }
+    virtual bool OnFacename(const wxString& WXUNUSED(facename))
+        { return true; }

 
     // called by EnumerateEncodings
     virtual bool OnFontEncoding(const wxString& WXUNUSED(facename),
 
     // called by EnumerateEncodings
     virtual bool OnFontEncoding(const wxString& WXUNUSED(facename),

-                                const wxString& encoding)
-        {
-            if (m_Encodings == NULL) m_Encodings = new wxArrayString;
-            m_Encodings -> Add(encoding);
-            return true;
-        }
-
-    // convenience function that returns array of facenames. Cannot be called
-    // before EnumerateFacenames.
-    wxArrayString *GetFacenames()
-        { return m_Facenames; }
-
-    // convenience function that returns array of encodings.
-    // Cannot be called before EnumerateEncodings.
-    wxArrayString *GetEncodings()
-        { return m_Encodings; }
+                                const wxString& WXUNUSED(encoding))
+        { return true; }
+

 
 

-    // virtual dtor for the base class
-    virtual ~wxFontEnumerator()
-        {
-            if (m_Facenames) delete m_Facenames;
-            if (m_Encodings) delete m_Encodings;
-        }
+
+    // convenience function that returns array of facenames.
+    static wxArrayString
+    GetFacenames(wxFontEncoding encoding = wxFONTENCODING_SYSTEM, // all
+                 bool fixedWidthOnly = false);
+
+    // convenience function that returns array of all available encodings.
+    static wxArrayString GetEncodings(const wxString& facename = wxEmptyString);
+
+    // convenience function that returns true if the given face name exist
+    // in the user's system
+    static bool IsValidFacename(const wxString &str);

 
 private:
 
 private:

-    wxArrayString *m_Facenames, *m_Encodings;
+#ifdef wxHAS_UTF8_FONTS
+    // helper for ports that only use UTF-8 encoding natively
+    bool EnumerateEncodingsUTF8(const wxString& facename);
+#endif

 
     DECLARE_NO_COPY_CLASS(wxFontEnumerator)
 };
 
 
     DECLARE_NO_COPY_CLASS(wxFontEnumerator)
 };
 

+#endif // wxUSE_FONTENUM
+

 #endif // _WX_FONTENUM_H_
 #endif // _WX_FONTENUM_H_