]> git.saurik.com Git - wxWidgets.git/blobdiff - wxPython/src/_checkbox.i
Allow for Cmd-click on wxMac
[wxWidgets.git] / wxPython / src / _checkbox.i
index 74b6bbc3e42b80d9d2b4fd404df53f2b2517b063..1b553a151b6e288dc1eeba9f93a50262da260ad6 100644 (file)
@@ -45,97 +45,115 @@ 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.
+"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()       ""
 
-    RefDoc(wxCheckBox, ""); // turn it off for the ctors
-    
     DocCtorStr(
-        wxCheckBox(wxWindow* parent, wxWindowID id, const wxString& label,
+        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");
+        "Creates and shows a CheckBox control", "");
 
     DocCtorStrName(
         wxCheckBox(),
-        "Precreate a CheckBox for 2-phase creation.",
+        "Precreate a CheckBox for 2-phase creation.", "",
         PreCheckBox);
 
     
     DocDeclStr(
-        bool, Create(wxWindow* parent, wxWindowID id, const wxString& label,
+        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.");
+        "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.");
+        "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.");
+        "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.");
+        "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\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.");
+        "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\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.");
+        "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.");
+        "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.");
+        "Returns whether or not the user can set the CheckBox to the third
+state.", "");
     
+    static wxVisualAttributes
+    GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL);
 };
 
 //---------------------------------------------------------------------------