Update ReST docs

[wxWidgets.git] / wxPython / src / _checkbox.i

diff --git a/wxPython/src/_checkbox.i b/wxPython/src/_checkbox.i
index 7d2b4a1fce402b01fde360755b8a4c671d5b6425..2e6287c00a298265bcfd7256214a4f11c49e8626 100644 (file)
--- a/wxPython/src/_checkbox.i
+++ b/wxPython/src/_checkbox.i
@@ -44,34 +44,120 @@ enum wxCheckBoxState
 
 //---------------------------------------------------------------------------
 
+DocStr(wxCheckBox,
+"A checkbox is a labelled box which by default is either on (the
+checkmark is visible) or off (no checkmark). Optionally (When the
+wx.CHK_3STATE style flag is set) it can have a third state, called the
+mixed or undetermined state. Often this is used as a \"Does Not
+Apply\" state.", "
+
+Window Styles
+-------------
+    =================================  ===============================
+    wx.CHK_2STATE                      Create a 2-state checkbox. 
+                                       This is the default.
+    wx.CHK_3STATE                      Create a 3-state checkbox.
+    wx.CHK_ALLOW_3RD_STATE_FOR_USER    By default a user can't set a
+                                       3-state checkbox to the
+                                       third state. It can only be
+                                       done from code. Using this
+                                       flags allows the user to set
+                                       the checkbox to the third
+                                       state by clicking.
+                                       wx.ALIGN_RIGHT Makes the
+                                       text appear on the left of
+                                       the checkbox.
+    =================================  ===============================
+
+Events
+------
+    ===============================  ===============================
+    EVT_CHECKBOX                     Sent when checkbox is clicked.
+    ===============================  ===============================
+");
+
+
+        
+MustHaveApp(wxCheckBox);
+
 class wxCheckBox : public wxControl
 {
 public:
     %pythonAppend wxCheckBox         "self._setOORInfo(self)"
     %pythonAppend wxCheckBox()       ""
+
+    DocCtorStr(
+        wxCheckBox(wxWindow* parent, wxWindowID id=-1,
+                   const wxString& label = wxPyEmptyString,
+                   const wxPoint& pos = wxDefaultPosition,
+                   const wxSize& size = wxDefaultSize,
+                   long style = 0,
+                   const wxValidator& validator = wxDefaultValidator,
+                   const wxString& name = wxPyCheckBoxNameStr),
+        "Creates and shows a CheckBox control", "");
+
+    DocCtorStrName(
+        wxCheckBox(),
+        "Precreate a CheckBox for 2-phase creation.", "",
+        PreCheckBox);
+
+    
+    DocDeclStr(
+        bool, Create(wxWindow* parent, wxWindowID id=-1,
+                     const wxString& label = wxPyEmptyString,
+                     const wxPoint& pos = wxDefaultPosition,
+                     const wxSize& size = wxDefaultSize,
+                     long style = 0,
+                     const wxValidator& validator = wxDefaultValidator,
+                     const wxString& name = wxPyCheckBoxNameStr),
+        "Actually create the GUI CheckBox for 2-phase creation.", "");
+
+    
+    DocDeclStr(
+        bool, GetValue(),
+        "Gets the state of a 2-state CheckBox.  Returns True if it is checked,
+False otherwise.", "");
+    
+    DocDeclStr(
+        bool, IsChecked(),
+        "Similar to GetValue, but raises an exception if it is not a 2-state
+CheckBox.", "");
+    
+    DocDeclStr(
+        void, SetValue(const bool state),
+        "Set the state of a 2-state CheckBox.  Pass True for checked, False for
+unchecked.", "");
+    
+    DocDeclStr(
+        wxCheckBoxState, Get3StateValue() const,
+        "Returns wx.CHK_UNCHECKED when the CheckBox is unchecked,
+wx.CHK_CHECKED when it is checked and wx.CHK_UNDETERMINED when it's in
+the undetermined state.  Raises an exceptiion when the function is
+used with a 2-state CheckBox.", "");
+    
+    DocDeclStr(
+        void, Set3StateValue(wxCheckBoxState state),
+        "Sets the CheckBox to the given state.  The state parameter can be one
+of the following: wx.CHK_UNCHECKED (Check is off), wx.CHK_CHECKED (the
+Check is on) or wx.CHK_UNDETERMINED (Check is mixed). Raises an
+exception when the CheckBox is a 2-state checkbox and setting the
+state to wx.CHK_UNDETERMINED.", "");
+    
+    DocDeclStr(
+        bool, Is3State() const,
+        "Returns whether or not the CheckBox is a 3-state CheckBox.", "");
+    
+    DocDeclStr(
+        bool, Is3rdStateAllowedForUser() const,
+        "Returns whether or not the user can set the CheckBox to the third
+state.", "");
+    
+    static wxVisualAttributes
+    GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
+
+    %property(ThreeStateValue, Get3StateValue, Set3StateValue, doc="See `Get3StateValue` and `Set3StateValue`");
+    %property(Value, GetValue, SetValue, doc="See `GetValue` and `SetValue`");
     
-    wxCheckBox(wxWindow* parent, wxWindowID id, const wxString& label,
-               const wxPoint& pos = wxDefaultPosition,
-               const wxSize& size = wxDefaultSize,
-               long style = 0,
-               const wxValidator& validator = wxDefaultValidator,
-               const wxString& name = wxPyCheckBoxNameStr);
-    %name(PreCheckBox)wxCheckBox();
-
-    bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
-               const wxPoint& pos = wxDefaultPosition,
-               const wxSize& size = wxDefaultSize,
-               long style = 0,
-               const wxValidator& validator = wxDefaultValidator,
-               const wxString& name = wxPyCheckBoxNameStr);
-
-    bool GetValue();
-    bool IsChecked();
-    void SetValue(const bool state);
-    wxCheckBoxState Get3StateValue() const;
-    void Set3StateValue(wxCheckBoxState state);
-    bool Is3State() const;
-    bool Is3rdStateAllowedForUser() const;
 };
 
 //---------------------------------------------------------------------------