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:
Robin Dunn
2004-04-30 06:14:22 +00:00
parent 68ae5821b6
commit dce2bd223c
21 changed files with 1216 additions and 665 deletions

View File

@@ -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.");
};