X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7c913512a4c9f36e11e07ea707002fab1608d324..e4e487e2a5d51c93cae3a73745128e3dbd23b168:/interface/html/winpars.h?ds=sidebyside

diff --git a/interface/html/winpars.h b/interface/html/winpars.h
index e18a0f90e2..ed5d5348b1 100644
--- a/interface/html/winpars.h
+++ b/interface/html/winpars.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        html/winpars.h
-// Purpose:     documentation for wxHtmlTagsModule class
+// Purpose:     interface of wxHtmlTagsModule
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -17,8 +17,8 @@
     @library{wxhtml}
     @category{FIXME}
 
-    @seealso
-    @ref overview_handlers "Tag Handlers", wxHtmlTagHandler, wxHtmlWinTagHandler,
+    @see @ref overview_handlers "Tag Handlers", wxHtmlTagHandler,
+    wxHtmlWinTagHandler,
 */
 class wxHtmlTagsModule : public wxModule
 {
@@ -26,15 +26,17 @@ public:
     /**
         You must override this method. In most common case its body consists
         only of lines of the following type:
+        
         I recommend using the @b TAGS_MODULE_* macros.
         
         @param parser
-        Pointer to the parser that requested tables filling.
+            Pointer to the parser that requested tables filling.
     */
     virtual void FillHandlersTable(wxHtmlWinParser parser);
 };
 
 
+
 /**
     @class wxHtmlWinTagHandler
     @headerfile winpars.h wx/html/winpars.h
@@ -52,7 +54,6 @@ class wxHtmlWinTagHandler : public wxHtmlTagHandler
 public:
     /**
         @b wxHtmlWinParser* m_WParser
-        
         Value of this attribute is identical to value of m_Parser. The only different
         is that m_WParser points to wxHtmlWinParser object while m_Parser
         points to wxHtmlParser object. (The same object, but overcast.)
@@ -60,6 +61,7 @@ public:
 };
 
 
+
 /**
     @class wxHtmlWinParser
     @headerfile winpars.h wx/html/winpars.h
@@ -72,8 +74,7 @@ public:
     @library{wxhtml}
     @category{html}
 
-    @seealso
-    @ref overview_handlers "Handlers overview"
+    @see @ref overview_handlers "Handlers overview"
 */
 class wxHtmlWinParser : public wxHtmlParser
 {
@@ -81,7 +82,7 @@ public:
     //@{
     /**
         Constructor. Don't use the default one, use constructor with
-        @e wndIface parameter (@e wndIface is a pointer to interface object for
+        @a wndIface parameter (@a wndIface is a pointer to interface object for
         the associated wxHtmlWindow or other HTML rendering
         window such as wxHtmlListBox).
     */
@@ -90,13 +91,13 @@ public:
     //@}
 
     /**
-        Adds module to the list of wxHtmlWinParser tag handler.
+        Adds module() to the list of wxHtmlWinParser tag handler.
     */
     static void AddModule(wxHtmlTagsModule module);
 
     /**
         Closes the container, sets actual container to the parent one
-        and returns pointer to it (see Overview).
+        and returns pointer to it (see Overview()).
     */
     wxHtmlContainerCell* CloseContainer();
 
@@ -115,83 +116,81 @@ public:
     /**
         Returns actual text colour.
     */
-    const wxColour GetActualColor();
+    const wxColour GetActualColor() const;
 
     /**
         Returns default horizontal alignment.
     */
-    int GetAlign();
+    int GetAlign() const;
 
     /**
         Returns (average) char height in standard font. It is used as DC-independent
         metrics.
-        
-        @b Note: This function doesn't return the @e actual height. If you want to
+        @note This function doesn't return the @e actual height. If you want to
         know the height of the current font, call @c GetDC - GetCharHeight().
     */
-    int GetCharHeight();
+    int GetCharHeight() const;
 
     /**
         Returns average char width in standard font. It is used as DC-independent
         metrics.
-        
-        @b Note: This function doesn't return the @e actual width. If you want to
+        @note This function doesn't return the @e actual width. If you want to
         know the height of the current font, call @c GetDC - GetCharWidth()
     */
-    int GetCharWidth();
+    int GetCharWidth() const;
 
     /**
-        Returns pointer to the currently opened container (see Overview).
+        Returns pointer to the currently opened container (see Overview()).
         Common use:
     */
-    wxHtmlContainerCell* GetContainer();
+    wxHtmlContainerCell* GetContainer() const;
 
     /**
         Returns pointer to the DC used during parsing.
     */
-#define wxDC* GetDC()     /* implementation is private */
+    wxDC* GetDC();
 
     /**
         Returns wxEncodingConverter class used
         to do conversion between @ref getinputencoding() "input encoding"
         and @ref getoutputencoding() "output encoding".
     */
-    wxEncodingConverter * GetEncodingConverter();
+    wxEncodingConverter* GetEncodingConverter() const;
 
     /**
         Returns @true if actual font is bold, @false otherwise.
     */
-    int GetFontBold();
+    int GetFontBold() const;
 
     /**
         Returns actual font face name.
     */
-    wxString GetFontFace();
+    wxString GetFontFace() const;
 
     /**
         Returns @true if actual font is fixed face, @false otherwise.
     */
-    int GetFontFixed();
+    int GetFontFixed() const;
 
     /**
         Returns @true if actual font is italic, @false otherwise.
     */
-    int GetFontItalic();
+    int GetFontItalic() const;
 
     /**
         Returns actual font size (HTML size varies from -2 to +4)
     */
-    int GetFontSize();
+    int GetFontSize() const;
 
     /**
         Returns @true if actual font is underlined, @false otherwise.
     */
-    int GetFontUnderlined();
+    int GetFontUnderlined() const;
 
     /**
         Returns input encoding.
     */
-    wxFontEncoding GetInputEncoding();
+    wxFontEncoding GetInputEncoding() const;
 
     /**
         Returns actual hypertext link. (This value has a non-empty
@@ -199,18 +198,18 @@ public:
         if the parser is between @c A and @c /A tags,
         wxEmptyString otherwise.)
     */
-    const wxHtmlLinkInfo GetLink();
+    const wxHtmlLinkInfo GetLink() const;
 
     /**
         Returns the colour of hypertext link text.
     */
-    const wxColour GetLinkColor();
+    const wxColour GetLinkColor() const;
 
     /**
         Returns output encoding, i.e. closest match to document's input encoding
         that is supported by operating system.
     */
-    wxFontEncoding GetOutputEncoding();
+    wxFontEncoding GetOutputEncoding() const;
 
     /**
         Returns associated window (wxHtmlWindow). This may be @NULL! (You should always
@@ -220,7 +219,7 @@ public:
     wxHtmlWindow* GetWindow();
 
     /**
-        Opens new container and returns pointer to it (see Overview).
+        Opens new container and returns pointer to it (see Overview()).
     */
     wxHtmlContainerCell* OpenContainer();
 
@@ -242,19 +241,19 @@ public:
         should use OpenContainer
         wherever possible.
     */
-    wxHtmlContainerCell* SetContainer(wxHtmlContainerCell * c);
+    wxHtmlContainerCell* SetContainer(wxHtmlContainerCell* c);
 
     /**
         Sets the DC. This must be called before wxHtmlParser::Parse!
-        @e pixel_scale  can be used when rendering to high-resolution
+        @a pixel_scale  can be used when rendering to high-resolution
         DCs (e.g. printer) to adjust size of pixel metrics. (Many dimensions in
         HTML are given in pixels -- e.g. image sizes. 300x300 image would be only one
         inch wide on typical printer. With pixel_scale = 3.0 it would be 3 inches.)
     */
-#define virtual void SetDC(wxDC dc, double pixel_scale = 1.0)     /* implementation is private */
+    virtual void SetDC(wxDC dc, double pixel_scale = 1.0);
 
     /**
-        Sets bold flag of actualfont. @e x is either @true of @false.
+        Sets bold flag of actualfont. @a x is either @true of @false.
     */
     void SetFontBold(int x);
 
@@ -266,12 +265,12 @@ public:
     void SetFontFace(const wxString& face);
 
     /**
-        Sets fixed face flag of actualfont. @e x is either @true of @false.
+        Sets fixed face flag of actualfont. @a x is either @true of @false.
     */
     void SetFontFixed(int x);
 
     /**
-        Sets italic flag of actualfont. @e x is either @true of @false.
+        Sets italic flag of actualfont. @a x is either @true of @false.
     */
     void SetFontItalic(int x);
 
@@ -281,7 +280,7 @@ public:
     void SetFontSize(int s);
 
     /**
-        Sets underlined flag of actualfont. @e x is either @true of @false.
+        Sets underlined flag of actualfont. @a x is either @true of @false.
     */
     void SetFontUnderlined(int x);
 
@@ -291,7 +290,7 @@ public:
     */
     void SetFonts(const wxString& normal_face,
                   const wxString& fixed_face,
-                  const int sizes = @NULL);
+                  const int sizes = NULL);
 
     /**
         Sets input encoding. The parser uses this information to build conversion
@@ -312,3 +311,4 @@ public:
     */
     void SetLinkColor(const wxColour& clr);
 };
+