Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docstring updates and tweaks for epydoc

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

83
wxPython/src/_clipbrd.i
View File

@@ -20,33 +20,38 @@
%}
DocStr(wxClipboard,
"wx.Clipboard represents the system clipboard and provides methods to copy data
to or paste data from it. Normally, you should only use wx.TheClipboard which
is a reference to a global wx.Clipboard instance.
"wx.Clipboard represents the system clipboard and provides methods to
copy data to it or paste data from it. Normally, you should only use
``wx.TheClipboard`` which is a reference to a global wx.Clipboard
instance.
Call wx.TheClipboard.Open to get ownership of the clipboard. If this operation
returns True, you now own the clipboard. Call wx.TheClipboard.SetData to put
data on the clipboard, or wx.TheClipboard.GetData to retrieve data from the
clipboard. Call wx.TheClipboard.Close to close the clipboard and relinquish
ownership. You should keep the clipboard open only momentarily.
Call ``wx.TheClipboard``'s `Open` method to get ownership of the
clipboard. If this operation returns True, you now own the
clipboard. Call `SetData` to put data on the clipboard, or `GetData`
to retrieve data from the clipboard. Call `Close` to close the
clipboard and relinquish ownership. You should keep the clipboard open
only momentarily.
:see: `wx.DataObject`
");
class wxClipboard : public wxObject {
public:
DocCtorStr( wxClipboard(), "" );
DocCtorStr(
wxClipboard(),
"");
~wxClipboard();
DocDeclStr(
virtual bool , Open(),
"Call this function to open the clipboard before calling SetData\n"
"and GetData. Call Close when you have finished with the clipboard.\n"
"You should keep the clipboard open for only a very short time.\n"
"Returns true on success. ");
"Call this function to open the clipboard before calling SetData and
GetData. Call Close when you have finished with the clipboard. You
should keep the clipboard open for only a very short time. Returns
True on success.");
DocDeclStr(
@@ -64,50 +69,54 @@ public:
DocDeclStr(
virtual bool , AddData( wxDataObject *data ),
"Call this function to add the data object to the clipboard. You\n"
"may call this function repeatedly after having cleared the clipboard.\n"
"After this function has been called, the clipboard owns the data, so\n"
"do not delete the data explicitly.");
"Call this function to add the data object to the clipboard. You may
call this function repeatedly after having cleared the clipboard.
After this function has been called, the clipboard owns the data, so
do not delete the data explicitly.
:see: `wx.DataObject`");
DocDeclStr(
virtual bool , SetData( wxDataObject *data ),
"Set the clipboard data, this is the same as Clear followed by AddData.");
"Set the clipboard data, this is the same as `Clear` followed by
`AddData`.
:see: `wx.DataObject`");
%clear wxDataObject *data;
DocDeclStr(
virtual bool , IsSupported( const wxDataFormat& format ),
"Returns True if the given format is available in the data object(s) on\n"
"the clipboard.");
"Returns True if the given format is available in the data object(s) on
the clipboard.");
DocDeclStr(
virtual bool , GetData( wxDataObject& data ),
"Call this function to fill data with data on the clipboard, if available\n"
"in the required format. Returns true on success.");
"Call this function to fill data with data on the clipboard, if
available in the required format. Returns true on success.");
DocDeclStr(
virtual void , Clear(),
"Clears data from the clipboard object and also the system's clipboard\n"
"if possible.");
"Clears data from the clipboard object and also the system's clipboard
if possible.");
DocDeclStr(
virtual bool , Flush(),
"Flushes the clipboard: this means that the data which is currently on\n"
"clipboard will stay available even after the application exits (possibly\n"
"eating memory), otherwise the clipboard will be emptied on exit.\n"
"Returns False if the operation is unsuccesful for any reason.");
"Flushes the clipboard: this means that the data which is currently on
clipboard will stay available even after the application exits,
possibly eating memory, otherwise the clipboard will be emptied on
exit. Returns False if the operation is unsuccesful for any reason.");
DocDeclStr(
virtual void , UsePrimarySelection( bool primary = True ),
"On platforms supporting it (the X11 based platforms), selects the so\n"
"called PRIMARY SELECTION as the clipboard as opposed to the normal\n"
"clipboard, if primary is True.");
"On platforms supporting it (the X11 based platforms), selects the
so called PRIMARY SELECTION as the clipboard as opposed to the
normal clipboard, if primary is True.");
};
@@ -121,8 +130,8 @@ wxClipboard* const wxTheClipboard;
DocStr(wxClipboardLocker,
"A helpful class for opening the clipboard and automatically closing it when
the locker is destroyed.");
"A helpful class for opening the clipboard and automatically
closing it when the locker is destroyed.");
class wxClipboardLocker
{
@@ -131,8 +140,8 @@ public:
~wxClipboardLocker();
DocStr(__nonzero__,
"A ClipboardLocker instance evaluates to True if the clipboard was\n"
"successfully opened.")
"A ClipboardLocker instance evaluates to True if the clipboard was
successfully opened.")
%extend {
bool __nonzero__() { return !!(*self); }
}