Docstring updates and tweaks for epydoc
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@27016 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -45,24 +45,35 @@ 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.");
|
||||
"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.
|
||||
|
||||
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.
|
||||
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.
|
||||
Events
|
||||
------
|
||||
=============================== ===============================
|
||||
EVT_CHECKBOX Sent when checkbox is clicked.
|
||||
=============================== ===============================
|
||||
");
|
||||
|
||||
|
||||
@@ -102,31 +113,33 @@ public:
|
||||
|
||||
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,
|
||||
@@ -134,7 +147,8 @@ public:
|
||||
|
||||
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.");
|
||||
|
||||
};
|
||||
|
||||
|
Reference in New Issue
Block a user