]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/wx/fontenum.h
undo the last change as it results in buildbot configuration error
[wxWidgets.git] / interface / wx / fontenum.h
index 8cf2da6104d000034522feecea414413d76713fc..089443aed045e0598f6a0904cacb255727d645e5 100644 (file)
@@ -8,41 +8,44 @@
 
 /**
     @class wxFontEnumerator
 
 /**
     @class wxFontEnumerator
-    @wxheader{fontenum.h}
 
     wxFontEnumerator enumerates either all available fonts on the system or only
     the ones with given attributes - either only fixed-width (suited for use in
     programs such as terminal emulators and the like) or the fonts available in
 
     wxFontEnumerator enumerates either all available fonts on the system or only
     the ones with given attributes - either only fixed-width (suited for use in
     programs such as terminal emulators and the like) or the fonts available in
-    the given encoding().
+    the given encoding).
 
     To do this, you just have to call one of EnumerateXXX() functions - either
 
     To do this, you just have to call one of EnumerateXXX() functions - either
-    wxFontEnumerator::EnumerateFacenames or
-    wxFontEnumerator::EnumerateEncodings and the
-    corresponding callback (wxFontEnumerator::OnFacename or
-    wxFontEnumerator::OnFontEncoding) will be called
-    repeatedly until either all fonts satisfying the specified criteria are
-    exhausted or the callback returns @false.
+    wxFontEnumerator::EnumerateFacenames() or wxFontEnumerator::EnumerateEncodings()
+    and the corresponding callback (wxFontEnumerator::OnFacename() or
+    wxFontEnumerator::OnFontEncoding()) will be called repeatedly until either
+    all fonts satisfying the specified criteria are exhausted or the callback
+    returns @false.
+
+    @section fontenum_virtual Virtual functions to override
+
+    Either OnFacename or OnFontEncoding should be overridden depending on
+    whether you plan to call EnumerateFacenames or EnumerateEncodings.
+    Of course, if you call both of them, you should override both functions.
 
     @library{wxcore}
 
     @library{wxcore}
-    @category{FIXME}
+    @category{gdi}
 
 
-    @see @ref overview_wxfontencodingoverview, @ref overview_samplefont "Font
-    sample", wxFont, wxFontMapper
+    @see @ref overview_fontencoding, @ref page_samples_font, wxFont, wxFontMapper
 */
 class wxFontEnumerator
 {
 public:
     /**
 */
 class wxFontEnumerator
 {
 public:
     /**
-        Call OnFontEncoding() for each
-        encoding supported by the given font - or for each encoding supported by at
-        least some font if @a font is not specified.
+        Call OnFontEncoding() for each encoding supported by the given font -
+        or for each encoding supported by at least some font if @a font is not specified.
     */
     */
-    virtual bool EnumerateEncodings(const wxString& font = "");
+    virtual bool EnumerateEncodings(const wxString& font = wxEmptyString);
 
     /**
 
     /**
-        Call OnFacename() for each font which
-        supports given encoding (only if it is not wxFONTENCODING_SYSTEM) and is of
-        fixed width (if @a fixedWidthOnly is @true).
+        Call OnFacename() for each font which supports given encoding (only if
+        it is not @c wxFONTENCODING_SYSTEM) and is of fixed width
+        (if @a fixedWidthOnly is @true).
+
         Calling this function with default arguments will result in enumerating all
         fonts available on the system.
     */
         Calling this function with default arguments will result in enumerating all
         fonts available on the system.
     */
@@ -53,7 +56,7 @@ public:
         Return array of strings containing all encodings found by
         EnumerateEncodings().
     */
         Return array of strings containing all encodings found by
         EnumerateEncodings().
     */
-    static wxArrayString GetEncodings(const wxString& facename = "");
+    static wxArrayString GetEncodings(const wxString& facename = wxEmptyString);
 
     /**
         Return array of strings containing all facenames found by
 
     /**
         Return array of strings containing all facenames found by
@@ -64,20 +67,21 @@ public:
 
     /**
         Returns @true if the given string is valid face name, i.e. it's the face name
 
     /**
         Returns @true if the given string is valid face name, i.e. it's the face name
-        of an installed
-        font and it can safely be used with wxFont::SetFaceName.
+        of an installed font and it can safely be used with wxFont::SetFaceName.
     */
     static bool IsValidFacename(const wxString& facename);
 
     /**
     */
     static bool IsValidFacename(const wxString& facename);
 
     /**
-        Called by EnumerateFacenames() for
-        each match. Return @true to continue enumeration or @false to stop it.
+        Called by EnumerateFacenames() for each match.
+
+        Return @true to continue enumeration or @false to stop it.
     */
     virtual bool OnFacename(const wxString& font);
 
     /**
     */
     virtual bool OnFacename(const wxString& font);
 
     /**
-        Called by EnumerateEncodings() for
-        each match. Return @true to continue enumeration or @false to stop it.
+        Called by EnumerateEncodings() for each match.
+
+        Return @true to continue enumeration or @false to stop it.
     */
     virtual bool OnFontEncoding(const wxString& font,
                                 const wxString& encoding);
     */
     virtual bool OnFontEncoding(const wxString& font,
                                 const wxString& encoding);