reverted the change of r56246 and keep the old behaviour of MB2WC/WC2MB; document...

[wxWidgets.git] / interface / wx / dcsvg.h

diff --git a/interface/wx/dcsvg.h b/interface/wx/dcsvg.h
index bae993d5a35338513a9c9c4ea8d9f7b1965aa760..17f92831cb1a0741488d12123b557860bc3fd14a 100644 (file)
--- a/interface/wx/dcsvg.h
+++ b/interface/wx/dcsvg.h
@@ -8,7 +8,6 @@
 
 /**
     @class wxSVGFileDC
 
 /**
     @class wxSVGFileDC

-    @wxheader{dcsvg.h}

 
     A wxSVGFileDC is a device context onto which graphics and text can be
     drawn, and the output produced as a vector file, in SVG format (see the W3C
 
     A wxSVGFileDC is a device context onto which graphics and text can be
     drawn, and the output produced as a vector file, in SVG format (see the W3C


@@ -56,7 +55,7 @@ public:
     /**
         Destructor.
     */
     /**
         Destructor.
     */

-    ~wxSVGFileDC();
+    virtual ~wxSVGFileDC();

 
     /**
         Copies from a source DC to this DC, specifying the destination
 
     /**
         Copies from a source DC to this DC, specifying the destination


@@ -97,27 +96,27 @@ public:
         Convert device X coordinate to logical coordinate, using the current
         mapping mode.
     */
         Convert device X coordinate to logical coordinate, using the current
         mapping mode.
     */

-    wxCoord DeviceToLogicalX(wxCoord x);
+    wxCoord DeviceToLogicalX(wxCoord x) const;

 
     /**
         Convert device X coordinate to relative logical coordinate, using the
         current mapping mode but ignoring the x axis orientation. Use this
         function for converting a width, for example.
     */
 
     /**
         Convert device X coordinate to relative logical coordinate, using the
         current mapping mode but ignoring the x axis orientation. Use this
         function for converting a width, for example.
     */

-    wxCoord DeviceToLogicalXRel(wxCoord x);
+    wxCoord DeviceToLogicalXRel(wxCoord x) const;

 
     /**
         Converts device Y coordinate to logical coordinate, using the current
         mapping mode.
     */
 
     /**
         Converts device Y coordinate to logical coordinate, using the current
         mapping mode.
     */

-    wxCoord DeviceToLogicalY(wxCoord y);
+    wxCoord DeviceToLogicalY(wxCoord y) const;

 
     /**
         Convert device Y coordinate to relative logical coordinate, using the
         current mapping mode but ignoring the y axis orientation. Use this
         function for converting a height, for example.
     */
 
     /**
         Convert device Y coordinate to relative logical coordinate, using the
         current mapping mode but ignoring the y axis orientation. Use this
         function for converting a height, for example.
     */

-    wxCoord DeviceToLogicalYRel(wxCoord y);
+    wxCoord DeviceToLogicalYRel(wxCoord y) const;

 
     /**
         Draws an arc of a circle, centred on (@a xc, @a yc), with starting
 
     /**
         Draws an arc of a circle, centred on (@a xc, @a yc), with starting


@@ -280,14 +279,13 @@ public:
 
     /**
         Draws a spline between all given control points, using the current pen.
 
     /**
         Draws a spline between all given control points, using the current pen.

-        The programmer is responsible for deleting the list of points. The
-        spline is drawn using a series of lines, using an algorithm taken from
+        The programmer is responsible for deleting the list of points.
+        The spline is drawn using a series of lines, using an algorithm taken from

         the X drawing program "XFIG".
     */
     void DrawSpline(wxList* points);
         the X drawing program "XFIG".
     */
     void DrawSpline(wxList* points);

+

     /**
     /**

-        @param string
-            The text string to measure.

         Draws a three-point spline using the current pen.
     */
     void DrawSpline(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2,
         Draws a three-point spline using the current pen.
     */
     void DrawSpline(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2,


@@ -354,12 +352,12 @@ public:
     /**
         Gets the character height of the currently set font.
     */
     /**
         Gets the character height of the currently set font.
     */

-    wxCoord GetCharHeight();
+    wxCoord GetCharHeight() const;

 
     /**
         Gets the average character width of the currently set font.
     */
 
     /**
         Gets the average character width of the currently set font.
     */

-    wxCoord GetCharWidth();
+    wxCoord GetCharWidth() const;

 
     /**
         Not implemented.
 
     /**
         Not implemented.


@@ -381,14 +379,14 @@ public:
 
         @see SetLogicalFunction()
     */
 
         @see SetLogicalFunction()
     */

-    int GetLogicalFunction();
+    int GetLogicalFunction() const;

 
     /**
         Gets the mapping mode for the device context.
 
         @see SetMapMode()
     */
 
     /**
         Gets the mapping mode for the device context.
 
         @see SetMapMode()
     */

-    int GetMapMode();
+    int GetMapMode() const;

 
     //@{
     /**
 
     //@{
     /**


@@ -403,7 +401,7 @@ public:
     /**
         Not implemented.
     */
     /**
         Not implemented.
     */

-    bool GetPixel(wxCoord x, wxCoord y, wxColour* colour);
+    bool GetPixel(wxCoord x, wxCoord y, wxColour* colour) const;

 
     /**
         For a Windows printer device context, this gets the horizontal and
 
     /**
         For a Windows printer device context, this gets the horizontal and


@@ -418,7 +416,7 @@ public:
         @see SetTextBackground()
     */
     wxColour GetTextBackground() const;
         @see SetTextBackground()
     */
     wxColour GetTextBackground() const;

-    const wxColour GetTextBackground() const;
+    const wxColour& GetTextBackground() const;

     //@}
 
     /**
     //@}
 
     /**


@@ -436,10 +434,10 @@ public:
         @param externalLeading
             Any extra vertical space added to the font by the font designer
             (usually is zero).
         @param externalLeading
             Any extra vertical space added to the font by the font designer
             (usually is zero).

-
-        The optional parameter @a font specifies an alternative to the
-        currently selected font: but note that this does not yet work under
-        Windows, so you need to set a font for the device context first.
+        @param font
+            Specifies an alternative to the currently selected font: but note
+            that this does not yet work under Windows, so you need to set a
+            font for the device context first.

 
         @see wxFont, SetFont()
     */
 
         @see wxFont, SetFont()
     */


@@ -469,47 +467,47 @@ public:
         Converts logical X coordinate to device coordinate, using the current
         mapping mode.
     */
         Converts logical X coordinate to device coordinate, using the current
         mapping mode.
     */

-    wxCoord LogicalToDeviceX(wxCoord x);
+    wxCoord LogicalToDeviceX(wxCoord x) const;

 
     /**
         Converts logical X coordinate to relative device coordinate, using the
         current mapping mode but ignoring the x axis orientation. Use this for
         converting a width, for example.
     */
 
     /**
         Converts logical X coordinate to relative device coordinate, using the
         current mapping mode but ignoring the x axis orientation. Use this for
         converting a width, for example.
     */

-    wxCoord LogicalToDeviceXRel(wxCoord x);
+    wxCoord LogicalToDeviceXRel(wxCoord x) const;

 
     /**
         Converts logical Y coordinate to device coordinate, using the current
         mapping mode.
     */
 
     /**
         Converts logical Y coordinate to device coordinate, using the current
         mapping mode.
     */

-    wxCoord LogicalToDeviceY(wxCoord y);
+    wxCoord LogicalToDeviceY(wxCoord y) const;

 
     /**
         Converts logical Y coordinate to relative device coordinate, using the
         current mapping mode but ignoring the y axis orientation. Use this for
         converting a height, for example.
     */
 
     /**
         Converts logical Y coordinate to relative device coordinate, using the
         current mapping mode but ignoring the y axis orientation. Use this for
         converting a height, for example.
     */

-    wxCoord LogicalToDeviceYRel(wxCoord y);
+    wxCoord LogicalToDeviceYRel(wxCoord y) const;

 
     /**
         Gets the maximum horizontal extent used in drawing commands so far.
     */
 
     /**
         Gets the maximum horizontal extent used in drawing commands so far.
     */

-    wxCoord MaxX();
+    wxCoord MaxX() const;

 
     /**
         Gets the maximum vertical extent used in drawing commands so far.
     */
 
     /**
         Gets the maximum vertical extent used in drawing commands so far.
     */

-    wxCoord MaxY();
+    wxCoord MaxY() const;

 
     /**
         Gets the minimum horizontal extent used in drawing commands so far.
     */
 
     /**
         Gets the minimum horizontal extent used in drawing commands so far.
     */

-    wxCoord MinX();
+    wxCoord MinX() const;

 
     /**
         Gets the minimum vertical extent used in drawing commands so far.
     */
 
     /**
         Gets the minimum vertical extent used in drawing commands so far.
     */

-    wxCoord MinY();
+    wxCoord MinY() const;

 
     /**
         Returns @true if the DC is ok to use. @false values arise from being
 
     /**
         Returns @true if the DC is ok to use. @false values arise from being