//---------------------------------------------------------------------------
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);
+
+ %property(ThreeStateValue, Get3StateValue, Set3StateValue, doc="See `Get3StateValue` and `Set3StateValue`");
+ %property(Value, GetValue, SetValue, doc="See `GetValue` and `SetValue`");
};