Applied #15226 with modifications: wxRichTextCtrl: Implement setting properties with...

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

diff --git a/interface/wx/spinbutt.h b/interface/wx/spinbutt.h
index 054bce9150906dc7cbf141f02927adeaba7af7c1..c903ed67276bbdee89da2d5f44d44fb3239c9512 100644 (file)
--- a/interface/wx/spinbutt.h
+++ b/interface/wx/spinbutt.h
@@ -1,17 +1,27 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        spinbutt.h
-// Purpose:     interface of wxSpinEvent
+// Purpose:     interface of wxSpinEvent, wxSpinButton
 // Author:      wxWidgets team
-// RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxSpinEvent
-    @wxheader{spinbutt.h}
 
-    This event class is used for the events generated by
-    wxSpinButton and wxSpinCtrl.
+    This event class is used for the events generated by wxSpinButton and wxSpinCtrl.
+
+    @beginEventTable{wxSpinEvent}
+    @event{EVT_SPIN(id, func)}
+        Generated whenever an arrow is pressed.
+    @event{EVT_SPIN_UP(id, func)}
+        Generated when left/up arrow is pressed.
+    @event{EVT_SPIN_DOWN(id, func)}
+        Generated when right/down arrow is pressed.
+    @endEventTable
+
+    Note that if you handle both SPIN and UP or DOWN events, you will be notified
+    about each of them twice: first the UP/DOWN event will be received and then,
+    if it wasn't vetoed, the SPIN event will be sent.
 
     @library{wxcore}
     @category{events}
@@ -41,18 +51,18 @@ public:
 
 /**
     @class wxSpinButton
-    @wxheader{spinbutt.h}
 
-    A wxSpinButton has two small up and down (or left and right) arrow buttons. It
-    is often used next to a text control for increment and decrementing a value.
-    Portable programs should try to use wxSpinCtrl instead
-    as wxSpinButton is not implemented for all platforms but wxSpinCtrl is as it
-    degenerates to a simple wxTextCtrl on such platforms.
+    A wxSpinButton has two small up and down (or left and right) arrow buttons.
+
+    It is often used next to a text control for increment and decrementing a value.
+    Portable programs should try to use wxSpinCtrl instead as wxSpinButton is not
+    implemented for all platforms but wxSpinCtrl is as it degenerates to a simple
+    wxTextCtrl on such platforms.
 
     @note the range supported by this control (and wxSpinCtrl) depends on the
-    platform but is at least @c -0x8000 to @c 0x7fff. Under GTK and
-    Win32 with sufficiently new version of @c comctrl32.dll (at least 4.71 is
-    required, 5.80 is recommended) the full 32 bit range is supported.
+          platform but is at least @c -0x8000 to @c 0x7fff. Under GTK and
+          Win32 with sufficiently new version of @c comctrl32.dll (at least 4.71
+          is required, 5.80 is recommended) the full 32 bit range is supported.
 
     @beginStyleTable
     @style{wxSP_HORIZONTAL}
@@ -66,9 +76,22 @@ public:
            The value wraps at the minimum and maximum.
     @endStyleTable
 
+    @beginEventEmissionTable{wxSpinEvent}
+    @event{EVT_SPIN(id, func)}
+        Generated whenever an arrow is pressed.
+    @event{EVT_SPIN_UP(id, func)}
+        Generated when left/up arrow is pressed.
+    @event{EVT_SPIN_DOWN(id, func)}
+        Generated when right/down arrow is pressed.
+    @endEventTable
+
+    Note that if you handle both SPIN and UP or DOWN events, you will be notified
+    about each of them twice: first the UP/DOWN event will be received and then,
+    if it wasn't vetoed, the SPIN event will be sent.
+
     @library{wxcore}
     @category{ctrl}
-    <!-- @appearance{spinbutton.png} -->
+    @appearance{spinbutton}
 
     @see wxSpinCtrl
 */
@@ -79,7 +102,7 @@ public:
         Default constructor.
     */
     wxSpinButton();
-    
+
     /**
         Constructor, creating and showing a spin button.
 
@@ -88,59 +111,59 @@ public:
         @param id
             Window identifier. The value wxID_ANY indicates a default value.
         @param pos
-            Window position. If wxDefaultPosition is specified then a default
-        position is chosen.
+            Window position.
+            If ::wxDefaultPosition is specified then a default position is chosen.
         @param size
-            Window size. If wxDefaultSize is specified then a default size
-        is chosen.
+            Window size.
+            If ::wxDefaultSize is specified then a default size is chosen.
         @param style
-            Window style. See wxSpinButton.
+            Window style. See wxSpinButton class description.
         @param name
             Window name.
 
         @see Create()
     */
-    wxSpinButton(wxWindow* parent, wxWindowID id,
+    wxSpinButton(wxWindow* parent, wxWindowID id = -1,
                  const wxPoint& pos = wxDefaultPosition,
                  const wxSize& size = wxDefaultSize,
-                 long style = wxSP_HORIZONTAL,
+                 long style = wxSP_VERTICAL,
                  const wxString& name = "spinButton");
 
     /**
         Destructor, destroys the spin button control.
     */
-    ~wxSpinButton();
+    virtual ~wxSpinButton();
 
     /**
         Scrollbar creation function called by the spin button constructor.
         See wxSpinButton() for details.
     */
-    bool Create(wxWindow* parent, wxWindowID id,
+    bool Create(wxWindow* parent, wxWindowID id = -1,
                 const wxPoint& pos = wxDefaultPosition,
                 const wxSize& size = wxDefaultSize,
-                long style = wxSP_HORIZONTAL,
-                const wxString& name = "spinButton");
+                long style = wxSP_VERTICAL,
+                const wxString& name = "wxSpinButton");
 
     /**
         Returns the maximum permissible value.
 
         @see SetRange()
     */
-    int GetMax() const;
+    virtual int GetMax() const;
 
     /**
         Returns the minimum permissible value.
 
         @see SetRange()
     */
-    int GetMin() const;
+    virtual int GetMin() const;
 
     /**
         Returns the current spin button value.
 
         @see SetValue()
     */
-    int GetValue() const;
+    virtual int GetValue() const;
 
     /**
         Sets the range of the spin button.
@@ -152,7 +175,7 @@ public:
 
         @see GetMin(), GetMax()
     */
-    void SetRange(int min, int max);
+    virtual void SetRange(int min, int max);
 
     /**
         Sets the value of the spin button.
@@ -160,6 +183,6 @@ public:
         @param value
             The value for the spin button.
     */
-    void SetValue(int value);
+    virtual void SetValue(int value);
 };