Script updates

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

diff --git a/wxPython/src/_checkbox.i b/wxPython/src/_checkbox.i
index f6f4e376865b9e4ff9b783d163628000ad1f663f..39fd4105e71bbea98789e498ca79bb339e63f1db 100644 (file)
--- a/wxPython/src/_checkbox.i
+++ b/wxPython/src/_checkbox.i
@@ -16,9 +16,7 @@
 //---------------------------------------------------------------------------
 %newgroup;
 
-%{
-    DECLARE_DEF_STRING(CheckBoxNameStr);
-%}
+MAKE_CONST_WXSTRING(CheckBoxNameStr);
 
 
 enum {
@@ -46,34 +44,96 @@ enum wxCheckBoxState
 
 //---------------------------------------------------------------------------
 
+DocStr(wxCheckBox,
+"A checkbox is a labelled box which by default is either on (checkmark is
+visible) or off (no checkmark). Optionally (When the wxCHK_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.");
+
+RefDoc(wxCheckBox, "
+ 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.
+");
+
+
+        
 class wxCheckBox : public wxControl
 {
 public:
-    %addtofunc wxCheckBox         "self._setOORInfo(self)"
-    %addtofunc wxCheckBox()       ""
+    %pythonAppend wxCheckBox         "self._setOORInfo(self)"
+    %pythonAppend wxCheckBox()       ""
+
+    DocCtorStr(
+        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),
+        "Creates and shows a CheckBox control");
+
+    DocCtorStrName(
+        wxCheckBox(),
+        "Precreate a CheckBox for 2-phase creation.",
+        PreCheckBox);
+
+    
+    DocDeclStr(
+        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),
+        "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,\n"
+        "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,\n"
+        "False for unchecked.");
+    
+    DocDeclStr(
+        wxCheckBoxState, Get3StateValue() const,
+        "Returns wx.CHK_UNCHECKED when the CheckBox is unchecked, wx.CHK_CHECKED when\n"
+        "it is checked and wx.CHK_UNDETERMINED when it's in the undetermined state.\n"
+        "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\n"
+        "one of the following: wx.CHK_UNCHECKED (Check is off), wx.CHK_CHECKED\n"
+        "(Check is on) or wx.CHK_UNDETERMINED (Check is mixed). Raises an\n"
+        "exception  when the CheckBox is a 2-state checkbox and setting the state\n"
+        "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.");
     
-    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;
 };
 
 //---------------------------------------------------------------------------