X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..71a0f42d2a5606098e3e7abbb50b9bb1cd718f9e:/interface/wx/gauge.h

diff --git a/interface/wx/gauge.h b/interface/wx/gauge.h
index d617d7489b..7ec0c9bfc5 100644
--- a/interface/wx/gauge.h
+++ b/interface/wx/gauge.h
@@ -3,12 +3,11 @@
 // Purpose:     interface of wxGauge
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxGauge
-    @wxheader{gauge.h}
 
     A gauge is a horizontal or vertical bar which shows a quantity (often
     time).
@@ -38,7 +37,7 @@
 
     @library{wxcore}
     @category{ctrl}
-    <!-- @appearance{gauge.png} -->
+    @appearance{gauge.png}
 
     @see wxSlider, wxScrollBar
 */
@@ -49,6 +48,7 @@ public:
         Default constructor.
     */
     wxGauge();
+
     /**
         Constructor, creating and showing a gauge.
 
@@ -57,14 +57,17 @@ public:
         @param id
             Window identifier.
         @param range
-            Integer range (maximum value) of the gauge. It is ignored when the
-            gauge is used in indeterminate mode.
+            Integer range (maximum value) of the gauge.
+            See SetRange() for more details about the meaning of this value
+            when using the gauge in indeterminate mode.
         @param pos
             Window position.
         @param size
             Window size.
         @param style
             Gauge style.
+        @param validator
+            Window validator.
         @param name
             Window name.
 
@@ -75,12 +78,12 @@ public:
             const wxSize& size = wxDefaultSize,
             long style = wxGA_HORIZONTAL,
             const wxValidator& validator = wxDefaultValidator,
-            const wxString& name = "gauge");
+            const wxString& name = wxGaugeNameStr);
 
     /**
         Destructor, destroying the gauge.
     */
-    ~wxGauge();
+    virtual ~wxGauge();
 
     /**
         Creates the gauge for two-step construction. See wxGauge() for further
@@ -88,10 +91,9 @@ public:
     */
     bool Create(wxWindow* parent, wxWindowID id, int range,
                 const wxPoint& pos = wxDefaultPosition,
-                const wxSize& size = wxDefaultSize,
-                long style = wxGA_HORIZONTAL,
+                const wxSize& size = wxDefaultSize, long style = wxGA_HORIZONTAL,
                 const wxValidator& validator = wxDefaultValidator,
-                const wxString& name = "gauge");
+                const wxString& name = wxGaugeNameStr);
 
     /**
         Returns the width of the 3D bezel face.
@@ -139,7 +141,7 @@ public:
               undefined and thus you need to explicitely call SetValue() if you
               want to restore the determinate mode.
     */
-    void Pulse();
+    virtual void Pulse();
 
     /**
         Sets the 3D bezel face width.
@@ -155,6 +157,10 @@ public:
         Sets the range (maximum value) of the gauge. This function makes the
         gauge switch to determinate mode, if it's not already.
 
+        When the gauge is in indeterminate mode, under wxMSW the gauge
+        repeatedly goes from zero to @a range and back; under other ports
+        when in indeterminate mode, the @a range setting is ignored.
+
         @see GetRange()
     */
     void SetRange(int range);