AuroraMiddleware/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Replaced @returns with @return for more standard command use and compatibility.

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53549 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Bryan Petty 2008-05-11 01:38:53 +00:00
parent a15c16bfd1
commit d29a9a8ac8
81 changed files with 383 additions and 383 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
include/wx/generic/progdlgg.h
View File

@ -50,7 +50,7 @@ public:
/* Update the status bar to the new value.
@param value new value
@param newmsg if used, new message to display
@returns true if ABORT button has not been pressed
@return true if ABORT button has not been pressed
*/
virtual bool Update(int value, const wxString& newmsg = wxEmptyString, bool *skip = NULL);

4
interface/accel.h
View File

@ -116,8 +116,8 @@ public:
@param str
Should be a string in the form "flags-keycode"
@returns @true if the given string correctly initialized this object
(i.e. if IsOk() returns true after this call)
@return @true if the given string correctly initialized this object
(i.e. if IsOk() returns true after this call)
*/
bool FromString(const wxString& str);

5
interface/access.h
View File

@ -274,9 +274,8 @@ public:
@a childId is 0 (the action for this object) or greater than 0 (the action
for a child).
@returns
wxACC_NOT_SUPPORTED if there is no default action for this window
(e.g. an edit control).
@return wxACC_NOT_SUPPORTED if there is no default action for this
window (e.g. an edit control).
*/
virtual wxAccStatus DoDefaultAction(int childId);

8
interface/animate.h
View File

@ -90,8 +90,8 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
creation failed.
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,
const wxAnimation& anim = wxNullAnimation,
@ -246,7 +246,7 @@ public:
@li wxANIMATION_TYPE_ANI: load an ANI file;
@li wxANIMATION_TYPE_ANY: tries to autodetect the filetype.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
*/
virtual bool Load(wxInputStream& stream,
wxAnimationType type = wxANIMATION_TYPE_ANY);
@ -260,7 +260,7 @@ public:
One of the wxAnimationType values; wxANIMATION_TYPE_ANY
means that the function should try to autodetect the filetype.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
*/
virtual bool LoadFile(const wxString& name,
wxAnimationType type = wxANIMATION_TYPE_ANY);

3
interface/app.h
View File

@ -203,8 +203,7 @@ public:
Called by wxWidgets on creation of the application. Override this if you wish
to provide your own (environment-dependent) main loop.
@returns Returns 0 under X, and the wParam of the WM_QUIT message under
Windows.
@return 0 under X, and the wParam of the WM_QUIT message under Windows.
*/
virtual int MainLoop();

8
interface/artprov.h
View File

@ -178,8 +178,8 @@ public:
@param size
Size of the returned bitmap or wxDefaultSize if size doesn't matter.
@returns The bitmap if one of registered providers recognizes the ID or
wxNullBitmap otherwise.
@return The bitmap if one of registered providers recognizes the ID or
wxNullBitmap otherwise.
*/
static wxBitmap GetBitmap(const wxArtID& id,
const wxArtClient& client = wxART_OTHER,
@ -212,8 +212,8 @@ public:
wxArtClient identifier of the client (i.e. who is asking for the icon
bundle).
@returns The icon bundle if one of registered providers recognizes the ID
or wxNullIconBundle otherwise.
@return The icon bundle if one of registered providers recognizes the ID
or wxNullIconBundle otherwise.
*/
static wxIconBundle GetIconBundle(const wxArtID& id,
const wxArtClient& client = wxART_OTHER);

2
interface/base64.h
View File

@ -33,7 +33,7 @@
@param srcLen
The length of the input data.
@returns @c wxCONV_FAILED if the output buffer is too small.
@return @c wxCONV_FAILED if the output buffer is too small.
@header{wx/base64.h}
*/

20
interface/bitmap.h
View File

@ -64,7 +64,7 @@ public:
A bitmap type identifier - see ::wxBitmapType for a list
of possible values.
@returns @true if the call succeeded, @false otherwise (the default).
@return @true if the call succeeded, @false otherwise (the default).
*/
virtual bool Create(wxBitmap* bitmap, const void* data, wxBitmapType type,
int width, int height, int depth = 1);
@ -100,7 +100,7 @@ public:
@param desiredHeight
The desired height for the loaded bitmap.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@see wxBitmap::LoadFile, wxBitmap::SaveFile, SaveFile()
*/
@ -119,7 +119,7 @@ public:
@param palette
An optional palette used for saving the bitmap.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@see wxBitmap::LoadFile, wxBitmap::SaveFile, LoadFile()
*/
@ -376,7 +376,7 @@ public:
@param depth
The depth of the bitmap in pixels. If this is -1, the screen depth is used.
@returns @true if the call succeeded, @false otherwise.
@return @true if the call succeeded, @false otherwise.
This overload depends on the @a type of data.
@ -389,7 +389,7 @@ public:
/**
Finds the handler with the given @a name.
@returns A pointer to the handler if found, @NULL otherwise.
@return A pointer to the handler if found, @NULL otherwise.
*/
static wxBitmapHandler* FindHandler(const wxString& name);
@ -401,7 +401,7 @@ public:
@param bitmapType
The bitmap type managed by the handler, see ::wxBitmapType.
@returns A pointer to the handler if found, @NULL otherwise.
@return A pointer to the handler if found, @NULL otherwise.
*/
static wxBitmapHandler* FindHandler(const wxString& extension,
wxBitmapType bitmapType);
@ -412,7 +412,7 @@ public:
@param bitmapType
The bitmap type managed by the handler, see ::wxBitmapType.
@returns A pointer to the handler if found, @NULL otherwise.
@return A pointer to the handler if found, @NULL otherwise.
@see wxBitmapHandler
*/
@ -503,7 +503,7 @@ public:
One of the ::wxBitmapType values; see the note in the class
detailed description.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@remarks A palette may be associated with the bitmap if one exists
(especially for colour Windows bitmaps), and if the
@ -521,7 +521,7 @@ public:
@param name
The handler name.
@returns @true if the handler was found and removed, @false otherwise.
@return @true if the handler was found and removed, @false otherwise.
@see wxBitmapHandler
*/
@ -538,7 +538,7 @@ public:
@param palette
An optional palette used for saving the bitmap.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@remarks Depending on how wxWidgets has been configured, not all formats
may be available.

8
interface/bmpbuttn.h
View File

@ -131,7 +131,7 @@ public:
/**
Returns the bitmap for the disabled state, which may be invalid.
@returns A reference to the disabled state bitmap.
@return A reference to the disabled state bitmap.
@see SetBitmapDisabled()
*/
@ -143,7 +143,7 @@ public:
/**
Returns the bitmap for the focused state, which may be invalid.
@returns A reference to the focused state bitmap.
@return A reference to the focused state bitmap.
@see SetBitmapFocus()
*/
@ -165,7 +165,7 @@ public:
/**
Returns the label bitmap (the one passed to the constructor), always valid.
@returns A reference to the button's label bitmap.
@return A reference to the button's label bitmap.
@see SetBitmapLabel()
*/
@ -176,7 +176,7 @@ public:
/**
Returns the bitmap for the selected state.
@returns A reference to the selected state bitmap.
@return A reference to the selected state bitmap.
@see SetBitmapSelected()
*/

2
interface/button.h
View File

@ -131,7 +131,7 @@ public:
@remarks Under Windows, only dialog box buttons respond to this function.
@returns the old default item (possibly NULL)
@return the old default item (possibly NULL)
*/
virtual wxWindow* SetDefault();

12
interface/checkbox.h
View File

@ -114,7 +114,7 @@ public:
/**
Gets the state of a 2-state checkbox.
@returns Returns @true if it is checked, @false otherwise.
@return Returns @true if it is checked, @false otherwise.
*/
bool GetValue() const;
@ -127,8 +127,8 @@ public:
/**
Returns whether or not the checkbox is a 3-state checkbox.
@returns Returns @true if this checkbox is a 3-state checkbox, @false
if it's a 2-state checkbox.
@return @true if this checkbox is a 3-state checkbox, @false if it's
a 2-state checkbox.
*/
bool Is3State() const;
@ -136,9 +136,9 @@ public:
Returns whether or not the user can set the checkbox to the third
state.
@returns Returns @true if the user can set the third state of this
checkbox, @false if it can only be set programmatically or if
it's a 2-state checkbox.
@return @true if the user can set the third state of this checkbox,
@false if it can only be set programmatically or if it's a
2-state checkbox.
*/
bool Is3rdStateAllowedForUser() const;

6
interface/clipbrd.h
View File

@ -103,7 +103,7 @@ public:
(possibly eating memory), otherwise the clipboard will be emptied on
exit.
@returns @false if the operation is unsuccessful for any reason.
@return @false if the operation is unsuccessful for any reason.
*/
bool Flush();
@ -142,8 +142,8 @@ public:
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. This should be tested (as in the sample
shown above).
@return @true on success. This should be tested (as in the sample
shown above).
*/
bool Open();

4
interface/clrpicker.h
View File

@ -78,8 +78,8 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
creation failed.
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,
const wxColour& colour = wxBLACK,

16
interface/cmdproc.h
View File

@ -52,10 +52,10 @@ public:
Override this member function to execute the appropriate action when
called.
@returns @true to indicate that the action has taken place, @false
otherwise. Returning @false will indicate to the command
processor that the action is not undoable and should not be
added to the command history.
@return @true to indicate that the action has taken place, @false
otherwise. Returning @false will indicate to the command
processor that the action is not undoable and should not be
added to the command history.
*/
bool Do();
@ -81,10 +81,10 @@ public:
execute" operation is hard to write. The docview sample uses the
first method, to remove or restore segments in the drawing.
@returns @true to indicate that the action has taken place, @false
otherwise. Returning @false will indicate to the command
processor that the action is not redoable and no change should
be made to the command history.
@return @true to indicate that the action has taken place, @false
otherwise. Returning @false will indicate to the command
processor that the action is not redoable and no change should
be made to the command history.
*/
bool Undo();
};

4
interface/collpane.h
View File

@ -136,8 +136,8 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
creation failed.
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,
const wxString& label,

20
interface/combo.h
View File

@ -33,7 +33,7 @@ public:
/**
The derived class must implement this to create the popup control.
@returns @true if the call succeeded, @false otherwise.
@return @true if the call succeeded, @false otherwise.
*/
virtual bool Create(wxWindow* parent);
@ -359,9 +359,9 @@ public:
The parameters are the same as those for DoShowPopup().
@returns @true if animation finishes before the function returns,
@false otherwise. In the latter case you need to manually call
DoShowPopup() after the animation ends.
@return @true if animation finishes before the function returns,
@false otherwise. In the latter case you need to manually call
DoShowPopup() after the animation ends.
*/
virtual bool AnimateShow(const wxRect& rect, int flags);
@ -430,7 +430,7 @@ public:
Returns disabled button bitmap that has been set with
SetButtonBitmaps().
@returns A reference to the disabled state bitmap.
@return A reference to the disabled state bitmap.
*/
const wxBitmap GetBitmapDisabled() const;
@ -438,7 +438,7 @@ public:
Returns button mouse hover bitmap that has been set with
SetButtonBitmaps().
@returns A reference to the mouse hover state bitmap.
@return A reference to the mouse hover state bitmap.
*/
const wxBitmap GetBitmapHover() const;
@ -446,7 +446,7 @@ public:
Returns default button bitmap that has been set with
SetButtonBitmaps().
@returns A reference to the normal state bitmap.
@return A reference to the normal state bitmap.
*/
const wxBitmap GetBitmapNormal() const;
@ -454,7 +454,7 @@ public:
Returns depressed button bitmap that has been set with
SetButtonBitmaps().
@returns A reference to the depressed state bitmap.
@return A reference to the depressed state bitmap.
*/
const wxBitmap GetBitmapPressed() const;
@ -475,8 +475,8 @@ public:
missing, you need to instead use wxGenericComboCtrl, which however may
lack a native look and feel (but otherwise sports identical API).
@returns Value returned is a combination of the flags defined in
wxComboCtrlFeatures.
@return Value returned is a combination of the flags defined in
wxComboCtrlFeatures.
*/
static int GetFeatures();

16
interface/config.h
View File

@ -437,7 +437,7 @@ public:
//@{
/**
@returns @true if either a group or an entry with a given name exists.
@return @true if either a group or an entry with a given name exists.
*/
bool Exists(wxString& strName) const;
@ -451,12 +451,12 @@ public:
wxConfigBase::EntryType GetEntryType(const wxString& name) const;
/**
@returns @true if the entry by this name exists.
@return @true if the entry by this name exists.
*/
bool HasEntry(wxString& strName) const;
/**
@returns @true if the group by this name exists.
@return @true if the group by this name exists.
*/
bool HasGroup(const wxString& strName) const;
@ -503,7 +503,7 @@ public:
Read a string from the key. The default value is returned if the key
was not found.
@returns @true if value was really read, @false if the default was used.
@return @true if value was really read, @false if the default was used.
*/
const bool Read(const wxString& key, wxString* str,
const wxString& defaultVal) const;
@ -637,8 +637,8 @@ public:
and the new one) shouldn't contain backslashes, i.e. only simple names
and not arbitrary paths are accepted by this function.
@returns @false if @a oldName doesn't exist or if @a newName already
exists.
@return @false if @a oldName doesn't exist or if @a newName already
exists.
*/
bool RenameEntry(const wxString& oldName, const wxString& newName);
@ -647,8 +647,8 @@ public:
old and the new one) shouldn't contain backslashes, i.e. only simple
names and not arbitrary paths are accepted by this function.
@returns @false if @a oldName doesn't exist or if @a newName already
exists.
@return @false if @a oldName doesn't exist or if @a newName already
exists.
*/
bool RenameGroup(const wxString& oldName, const wxString& newName);

4
interface/cshelp.h
View File

@ -107,8 +107,8 @@ public:
@param origin
Help event origin, see wxHelpEvent::GetOrigin.
@returns @true if help was shown, or @false if no help was available
for this window.
@return @true if help was shown, or @false if no help was available
for this window.
@since 2.7.0
*/

54
interface/ctrlsub.h
View File

@ -56,8 +56,8 @@ public:
@param n
The zero-based index.
@returns The label of the item or an empty string if the position was
invalid.
@return The label of the item or an empty string if the position was
invalid.
*/
virtual wxString GetString(unsigned int n) const;
@ -84,8 +84,8 @@ public:
@param caseSensitive
Whether search is case sensitive (default is not).
@returns The zero-based position of the item, or wxNOT_FOUND if the
string was not found.
@return The zero-based position of the item, or wxNOT_FOUND if the
string was not found.
*/
virtual int FindString(const wxString& s, bool bCase = false) const;
@ -113,7 +113,7 @@ public:
Returns the index of the selected item or @c wxNOT_FOUND if no item is
selected.
@returns The position of the current selection.
@return The position of the current selection.
@remarks This method can be used with single selection list boxes only,
you should use wxListBox::GetSelections() for the list
@ -130,8 +130,8 @@ public:
@param string
The string to select.
@returns @true if the specified string has been selected, @false if it
wasn't found in the control.
@return @true if the specified string has been selected, @false if it
wasn't found in the control.
*/
bool SetStringSelection(const wxString& string);
@ -203,10 +203,10 @@ public:
@param item
String to add.
@returns The return value is the index of the newly inserted item.
Note that this may be different from the last one if the
control is sorted (e.g. has @c wxLB_SORT or @c wxCB_SORT
style).
@return The return value is the index of the newly inserted item.
Note that this may be different from the last one if the
control is sorted (e.g. has @c wxLB_SORT or @c wxCB_SORT
style).
*/
int Append(const wxString& item);
@ -218,10 +218,10 @@ public:
@param clientData
Pointer to client data to associate with the new item.
@returns The return value is the index of the newly inserted item.
Note that this may be different from the last one if the
control is sorted (e.g. has @c wxLB_SORT or @c wxCB_SORT
style).
@return The return value is the index of the newly inserted item.
Note that this may be different from the last one if the
control is sorted (e.g. has @c wxLB_SORT or @c wxCB_SORT
style).
*/
int Append(const wxString& item, void* clientData);
@ -233,10 +233,10 @@ public:
@param clientData
Pointer to client data to associate with the new item.
@returns The return value is the index of the newly inserted item.
Note that this may be different from the last one if the
control is sorted (e.g. has @c wxLB_SORT or @c wxCB_SORT
style).
@return The return value is the index of the newly inserted item.
Note that this may be different from the last one if the
control is sorted (e.g. has @c wxLB_SORT or @c wxCB_SORT
style).
*/
int Append(const wxString& item, wxClientData* clientData);
@ -361,7 +361,7 @@ public:
@param n
The zero-based position of the item.
@returns A pointer to the client data, or @NULL if not present.
@return A pointer to the client data, or @NULL if not present.
*/
void* GetClientData(unsigned int n) const;
@ -375,7 +375,7 @@ public:
@param n
The zero-based position of the item.
@returns A pointer to the client data, or @NULL if not present.
@return A pointer to the client data, or @NULL if not present.
*/
wxClientData* GetClientObject(unsigned int n) const;
@ -418,8 +418,8 @@ public:
@param pos
Position to insert item before, zero based.
@returns The return value is the index of the newly inserted item.
If the insertion failed for some reason, -1 is returned.
@return The return value is the index of the newly inserted item.
If the insertion failed for some reason, -1 is returned.
*/
int Insert(const wxString& item, unsigned int pos);
@ -433,8 +433,8 @@ public:
@param clientData
Pointer to client data to associate with the new item.
@returns The return value is the index of the newly inserted item.
If the insertion failed for some reason, -1 is returned.
@return The return value is the index of the newly inserted item.
If the insertion failed for some reason, -1 is returned.
*/
int Insert(const wxString& item, unsigned int pos, void* clientData);
@ -448,8 +448,8 @@ public:
@param clientData
Pointer to client data to associate with the new item.
@returns The return value is the index of the newly inserted item.
If the insertion failed for some reason, -1 is returned.
@return The return value is the index of the newly inserted item.
If the insertion failed for some reason, -1 is returned.
*/
int Insert(const wxString& item, unsigned int pos,
wxClientData* clientData);

2
interface/dataobj.h
View File

@ -587,7 +587,7 @@ public:
Set the data in the format @a format of the length @a len provided in
the buffer @a buf.
@returns @true on success, @false on failure.
@return @true on success, @false on failure.
*/
virtual bool SetData(const wxDataFormat& format, size_t len,
const void buf);

4
interface/datectrl.h
View File

@ -89,7 +89,7 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,
@ -113,7 +113,7 @@ public:
@param dt2
Same as above but for the upper limit.
@returns @false if no range limits are currently set, @true if at least
@return @false if no range limits are currently set, @true if at least
one bound is set.
*/
bool GetRange(wxDateTime* dt1, wxDateTime dt2) const;

66
interface/datetime.h
View File

@ -761,7 +761,7 @@ public:
be specified. It is thus less flexible then ParseDateTime(), but also
has less chances to misinterpret the user input.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseDate(const wxString& date,
@ -771,7 +771,7 @@ public:
be specified. It is thus less flexible then ParseDateTime(), but also
has less chances to misinterpret the user input.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseDate(const char* date);
@ -780,7 +780,7 @@ public:
be specified. It is thus less flexible then ParseDateTime(), but also
has less chances to misinterpret the user input.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const wchar_t* ParseDate(const wchar_t* date);
@ -792,7 +792,7 @@ public:
anything that may be accepted and will only reject strings which can
not be parsed in any way at all.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseDateTime(const wxString& datetime,
@ -804,7 +804,7 @@ public:
anything that may be accepted and will only reject strings which can
not be parsed in any way at all.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseDateTime(const char* datetime);
@ -815,7 +815,7 @@ public:
anything that may be accepted and will only reject strings which can
not be parsed in any way at all.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const wchar_t* ParseDateTime(const wchar_t* datetime);
@ -839,7 +839,7 @@ public:
@a dateDef. If it is not specified, Today() is used as the default
date.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseFormat(const wxString& date,
@ -865,7 +865,7 @@ public:
@a dateDef. If it is not specified, Today() is used as the default
date.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseFormat(const char* date,
@ -890,7 +890,7 @@ public:
@a dateDef. If it is not specified, Today() is used as the default
date.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const wchar_t* ParseFormat(const wchar_t* date,
@ -903,7 +903,7 @@ public:
the date and time parts must be equal to @a sep for the function to
succeed.
@returns @true if the entire string was parsed successfully, @false
@return @true if the entire string was parsed successfully, @false
otherwise.
*/
bool ParseISOCombined(const wxString& date, char sep = 'T');
@ -911,7 +911,7 @@ public:
/**
This function parses the date in ISO 8601 format @c "YYYY-MM-DD".
@returns @true if the entire string was parsed successfully, @false
@return @true if the entire string was parsed successfully, @false
otherwise.
*/
bool ParseISODate(const wxString& date);
@ -919,7 +919,7 @@ public:
/**
This function parses the time in ISO 8601 format @c "HH:MM:SS".
@returns @true if the entire string was parsed successfully, @false
@return @true if the entire string was parsed successfully, @false
otherwise.
*/
bool ParseISOTime(const wxString& date);
@ -987,7 +987,7 @@ public:
This functions is like ParseDateTime(), but only allows the time to be
specified in the input string.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseTime(const wxString& time,
@ -996,7 +996,7 @@ public:
This functions is like ParseDateTime(), but only allows the time to be
specified in the input string.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const char* ParseTime(const char* time);
@ -1004,7 +1004,7 @@ public:
This functions is like ParseDateTime(), but only allows the time to be
specified in the input string.
@returns @NULL if the conversion failed, otherwise return the pointer
@return @NULL if the conversion failed, otherwise return the pointer
to the character which stopped the scan.
*/
const wchar_t* ParseTime(const wchar_t* time);
@ -1074,7 +1074,7 @@ public:
Sets the date to the last day in the specified month (the current one
by default).
@returns The reference to the modified object itself.
@return The reference to the modified object itself.
*/
wxDateTime SetToLastMonthDay(Month month = Inv_Month,
int year = Inv_Year);
@ -1092,7 +1092,7 @@ public:
Sets the date so that it will be the first @a weekday following the
current date.
@returns The reference to the modified object itself.
@return The reference to the modified object itself.
*/
wxDateTime& SetToNextWeekDay(WeekDay weekday);
@ -1100,7 +1100,7 @@ public:
Sets the date so that it will be the last @a weekday before the current
date.
@returns The reference to the modified object itself.
@return The reference to the modified object itself.
*/
wxDateTime& SetToPrevWeekDay(WeekDay weekday);
@ -1115,7 +1115,7 @@ public:
SetToWeekDay(-1, wxDateTime::Sun) will set the date to the last Sunday
in the current month.
@returns @true if the date was modified successfully, @false otherwise
@return @true if the date was modified successfully, @false otherwise
meaning that the specified date doesn't exist.
*/
bool SetToWeekDay(WeekDay weekday, int n = 1,
@ -1125,7 +1125,7 @@ public:
Adjusts the date so that it will still lie in the same week as before,
but its week day will be the given one.
@returns The reference to the modified object itself.
@return The reference to the modified object itself.
*/
wxDateTime SetToWeekDayInSameWeek(WeekDay weekday,
WeekFlags flags = Monday_First);
@ -1136,7 +1136,7 @@ public:
number should be in the range 1-366 for the leap years and 1-365 for
the other ones.
@returns The reference to the modified object itself.
@return The reference to the modified object itself.
*/
wxDateTime& SetToYearDay(wxDateTime_t yday);
@ -1209,7 +1209,7 @@ public:
Transform the date from the given time zone to the local one. If
@a noDST is @true, no DST adjustments will be made.
@returns The date in the local time zone.
@return The date in the local time zone.
*/
wxDateTime FromTimezone(const TimeZone& tz, bool noDST = false) const;
@ -1240,7 +1240,7 @@ public:
Transform the date to the given time zone. If @a noDST is @true, no DST
adjustments will be made.
@returns The date in the new time zone.
@return The date in the new time zone.
*/
wxDateTime ToTimezone(const TimeZone& tz, bool noDST = false) const;
@ -1542,7 +1542,7 @@ public:
/**
Returns the sum of two date spans.
@returns A new wxDateSpan object with the result.
@return A new wxDateSpan object with the result.
*/
wxDateSpan Add(const wxDateSpan& other) const;
/**
@ -1618,14 +1618,14 @@ public:
product is computed by multiplying each of the components by the
@a factor.
@returns A new wxDateSpan object with the result.
@return A new wxDateSpan object with the result.
*/
wxDateSpan Multiply(int factor) const;
/**
Multiplies this date span by the specified @a factor. The product is
computed by multiplying each of the components by the @a factor.
@returns A reference to this wxDateSpan object modified in place.
@return A reference to this wxDateSpan object modified in place.
*/
wxDateSpan& Multiply(int factor);
@ -1670,7 +1670,7 @@ public:
/**
Returns the difference of two date spans.
@returns A new wxDateSpan object with the result.
@return A new wxDateSpan object with the result.
*/
wxDateSpan Subtract(const wxDateSpan& other) const;
/**
@ -1729,7 +1729,7 @@ public:
Multiplies this date span by the specified @a factor. The product is
computed by multiplying each of the components by the @a factor.
@returns A reference to this wxDateSpan object modified in place.
@return A reference to this wxDateSpan object modified in place.
*/
wxDateSpan& operator*=(int factor);
@ -1782,7 +1782,7 @@ public:
/**
Returns the sum of two time spans.
@returns A new wxDateSpan object with the result.
@return A new wxDateSpan object with the result.
*/
wxTimeSpan Add(const wxTimeSpan& diff) const;
/**
@ -1931,13 +1931,13 @@ public:
/**
Returns the product of this time span by @a n.
@returns A new wxTimeSpan object with the result.
@return A new wxTimeSpan object with the result.
*/
wxTimeSpan Multiply(int n) const;
/**
Multiplies this time span by @a n.
@returns A reference to this wxTimeSpan object modified in place.
@return A reference to this wxTimeSpan object modified in place.
*/
wxTimeSpan& Multiply(int n);
@ -1968,7 +1968,7 @@ public:
/**
Returns the difference of two time spans.
@returns A new wxDateSpan object with the result.
@return A new wxDateSpan object with the result.
*/
wxTimeSpan Subtract(const wxTimeSpan& diff) const;
/**
@ -1995,7 +1995,7 @@ public:
/**
Multiplies this time span by @a n.
@returns A reference to this wxTimeSpan object modified in place.
@return A reference to this wxTimeSpan object modified in place.
*/
wxTimeSpan& operator*=(int n);

4
interface/dc.h
View File

@ -468,7 +468,7 @@ public:
- wxFLOOD_BORDER: The area to be flooded is bounded by the given
colour.
@returns @false if the operation failed.
@return @false if the operation failed.
@note The present implementation for non-Windows platforms may fail to
find colour borders if the pixels do not match the colour
@ -581,7 +581,7 @@ public:
@a string is the text string to measure, @e heightLine, if non @NULL,
is where to store the height of a single line.
@returns The text extent as a wxSize object.
@return The text extent as a wxSize object.
@note This function works with both single-line and multi-line strings.

14
interface/dde.h
View File

@ -68,7 +68,7 @@ public:
the data associated with the given item. Causes the client connection's
OnAdvise() member to be called.
@returns @true if successful.
@return @true if successful.
*/
bool Advise(const wxString& item, const void* data, size_t size,
wxIPCFormat format = wxIPC_PRIVATE);
@ -85,7 +85,7 @@ public:
calling application must explicitly delete its side of the connection
having called Disconnect().
@returns @true if successful.
@return @true if successful.
*/
bool Disconnect();
@ -96,7 +96,7 @@ public:
Poke() in that respect). Causes the server connection's OnExecute()
member to be called.
@returns @true if successful.
@return @true if successful.
*/
bool Execute(const void* data, size_t size,
wxIPCFormat format = wxIPC_PRIVATE);
@ -164,7 +164,7 @@ public:
used to transfer arbitrary data to the server. Causes the server
connection's OnPoke() member to be called.
@returns @true if successful.
@return @true if successful.
*/
bool Poke(const wxString& item, const void* data, size_t size,
wxIPCFormat format = wxIPC_PRIVATE);
@ -177,7 +177,7 @@ public:
Called by the client application to request data from the server.
Causes the server connection's OnRequest() member to be called.
@returns A character string (actually a pointer to the connection's
@return A character string (actually a pointer to the connection's
buffer) if successful, @NULL otherwise.
*/
const void* Request(const wxString& item, size_t* size,
@ -188,7 +188,7 @@ public:
started with the server. Causes the server connection's OnStartAdvise()
member to be called.
@returns @true if the server okays it, @false otherwise.
@return @true if the server okays it, @false otherwise.
*/
bool StartAdvise(const wxString& item);
@ -197,7 +197,7 @@ public:
stopped. Causes the server connection's OnStopAdvise() member to be
called.
@returns @true if the server okays it, @false otherwise.
@return @true if the server okays it, @false otherwise.
*/
bool StopAdvise(const wxString& item);
};

6
interface/debugrpt.h
View File

@ -41,7 +41,7 @@ public:
Present the report to the user and allow him to modify it by removing
some or all of the files and, potentially, adding some notes.
@returns @true if the report should be processed or @false if the user
@return @true if the report should be processed or @false if the user
chose to cancel report generation or removed all files from
it.
*/
@ -198,7 +198,7 @@ public:
the given @a name and writes @a text to it, then adds the file to the
report. The @a filename shouldn't contain the path.
@returns @true if file could be added successfully, @false if an IO
@return @true if file could be added successfully, @false if an IO
error occurred.
*/
bool AddText(const wxString& filename, const wxString& text,
@ -232,7 +232,7 @@ public:
This method should be used to construct the full name of the files
which you wish to add to the report using AddFile().
@returns The name of the temporary directory used for the files in this
@return The name of the temporary directory used for the files in this
report.
*/
const wxString GetDirectory() const;

2
interface/dialog.h
View File

@ -556,7 +556,7 @@ public:
Shows a modal dialog. Program flow does not return until the dialog has
been dismissed with EndModal().
@returns The value set with SetReturnCode().
@return The value set with SetReturnCode().
@see EndModal(), GetReturnCode(), SetReturnCode()
*/

2
interface/dialup.h
View File

@ -101,7 +101,7 @@ public:
by the system and so we don't do any polling and this parameter is
ignored.
@returns @false if couldn't set up automatic check for online status.
@return @false if couldn't set up automatic check for online status.
*/
bool EnableAutoCheckOnlineStatus(size_t nSeconds = 60);

12
interface/dnd.h
View File

@ -121,7 +121,7 @@ public:
Suggested value for return value. Determined by SHIFT or CONTROL
key states.
@returns The desired operation or wxDragNone. This is used for optical
@return The desired operation or wxDragNone. This is used for optical
feedback from the side of the drop source, typically in form
of changing the icon.
*/
@ -136,7 +136,7 @@ public:
@param y
The y coordinate of the mouse.
@returns @true to accept the data, or @false to veto the operation.
@return @true to accept the data, or @false to veto the operation.
*/
virtual bool OnDrop(wxCoord x, wxCoord y);
@ -152,7 +152,7 @@ public:
Suggested default for return value. Determined by SHIFT or CONTROL
key states.
@returns The desired operation or wxDragNone. This is used for optical
@return The desired operation or wxDragNone. This is used for optical
feedback from the side of the drop source, typically in form
of changing the icon.
*/
@ -244,7 +244,7 @@ public:
(which includes the previous flag), this is even the default
operation.
@returns The operation requested by the user, may be ::wxDragCopy,
@return The operation requested by the user, may be ::wxDragCopy,
::wxDragMove, ::wxDragLink, ::wxDragCancel or ::wxDragNone if
an error occurred.
*/
@ -266,7 +266,7 @@ public:
@param scrolling
@true if the window is scrolling. MSW only.
@returns @false if you want default feedback, or @true if you implement
@return @false if you want default feedback, or @true if you implement
your own feedback. The return values is ignored under GTK.
*/
virtual bool GiveFeedback(wxDragResult effect);
@ -349,7 +349,7 @@ public:
This macro should be used with wxDropSource::wxDropSource().
@returns wxCursor on MSW, otherwise returns a wxIcon
@return wxCursor on MSW, otherwise returns a wxIcon
@header{wx/dnd.h}
*/

2
interface/dynlib.h
View File

@ -32,7 +32,7 @@ public:
Pointer to the location to return the size of this module in
memory in, may be @NULL.
@returns @true if the load address and module size were retrieved,
@return @true if the load address and module size were retrieved,
@false if this information is not available.
*/
bool GetAddress(void** addr, size_t len) const;

6
interface/event.h
View File

@ -528,7 +528,7 @@ public:
@param event
Event to process.
@returns @true if a suitable event handler function was found and
@return @true if a suitable event handler function was found and
executed, and the function did not call wxEvent::Skip.
@see SearchEventTable()
@ -543,7 +543,7 @@ public:
@param event
Event to process.
@returns @true if the event was processed, @false if no handler was found
@return @true if the event was processed, @false if no handler was found
or an exception was thrown.
@see wxWindow::HandleWindowEvent
@ -559,7 +559,7 @@ public:
@param event
Event to be matched against an event table entry.
@returns @true if a suitable event handler function was found and
@return @true if a suitable event handler function was found and
executed, and the function did not call wxEvent::Skip.
@remarks This function looks through the object's event table and tries

6
interface/ffile.h
View File

@ -177,7 +177,7 @@ public:
@param count
The number of bytes to read.
@returns The number of bytes read.
@return The number of bytes read.
*/
size_t Read(void* buffer, size_t count);
@ -190,7 +190,7 @@ public:
Conversion object to use in Unicode build; by default supposes
that file contents is encoded in UTF-8.
@returns @true if file was read successfully, @false otherwise.
@return @true if file was read successfully, @false otherwise.
*/
bool ReadAll(wxString* str, const wxMBConv& conv = wxConvAuto());
@ -234,7 +234,7 @@ public:
@param count
The number of bytes to write.
@returns The number of bytes written.
@return The number of bytes written.
*/
size_t Write(const void* buffer, size_t count);

4
interface/file.h
View File

@ -281,7 +281,7 @@ public:
@param mode
One of wxFromStart, wxFromEnd, wxFromCurrent.
@returns The actual offset position achieved, or wxInvalidOffset on
@return The actual offset position achieved, or wxInvalidOffset on
failure.
*/
wxFileOffset Seek(wxFileOffset ofs,
@ -295,7 +295,7 @@ public:
@param ofs
Number of bytes before the end of the file.
@returns The actual offset position achieved, or wxInvalidOffset on
@return The actual offset position achieved, or wxInvalidOffset on
failure.
*/
wxFileOffset SeekEnd(wxFileOffset ofs = 0);

6
interface/filectrl.h
View File

@ -78,7 +78,7 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
@return @true if the control was successfully created or @false if
creation failed.
*/
@ -154,14 +154,14 @@ public:
/**
Sets(changes) the current directory displayed in the control.
@returns Returns @true on success, @false otherwise.
@return Returns @true on success, @false otherwise.
*/
bool SetDirectory(const wxString& directory);
/**
Selects a certain file.
@returns Returns @true on success, @false otherwise
@return Returns @true on success, @false otherwise
*/
bool SetFilename(const wxString& filename);

2
interface/filefn.h
View File

@ -124,7 +124,7 @@ public:
@note The generic Unix implementation depends on the system having the
@c statfs() or @c statvfs() function.
@returns @true on success, @false if an error occurred (for example, the
@return @true on success, @false if an error occurred (for example, the
directory doesn’t exist).
@header{wx/filefn.h}

12
interface/filename.h
View File

@ -178,7 +178,7 @@ public:
@param fileTemp
The file to open or @NULL to just get the name
@returns The full temporary file name or an empty string on error.
@return The full temporary file name or an empty string on error.
*/
static wxString CreateTempFileName(const wxString& prefix,
wxFile* fileTemp = NULL);
@ -333,7 +333,7 @@ public:
the volume is empty, the program's current working directory is returned for the
current volume.
@returns The string containing the current working directory or an empty
@return The string containing the current working directory or an empty
string on error.
@see AssignCwd()
@ -511,7 +511,7 @@ public:
Any of the pointers may be @NULL if the corresponding time is not
needed.
@returns @true on success, @false if we failed to retrieve the times.
@return @true on success, @false if we failed to retrieve the times.
*/
bool GetTimes(wxDateTime* dtAccess, wxDateTime* dtMod,
wxDateTime* dtCreate) const;
@ -681,7 +681,7 @@ public:
@param format
the file name format, native by default
@returns @true if the file name has been changed, @false if we failed to do
@return @true if the file name has been changed, @false if we failed to do
anything with it (currently this only happens if the
file name is on a volume different from the volume
specified by pathBase).
@ -702,7 +702,7 @@ public:
try to create each directory in the path and also don't return an error
if the target directory already exists.
@returns Returns @true if the directory was successfully created, @false
@return Returns @true if the directory was successfully created, @false
otherwise.
*/
bool Mkdir(int perm = 0777, int flags = 0);
@ -814,7 +814,7 @@ public:
@param format
The file name format to use when processing the paths, native by default.
@returns @true if normalization was successfully or @false otherwise.
@return @true if normalization was successfully or @false otherwise.
*/
bool Normalize(int flags = wxPATH_NORM_ALL,
const wxString& cwd = wxEmptyString,

4
interface/filepicker.h
View File

@ -88,7 +88,7 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,
@ -202,7 +202,7 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,

2
interface/fontpicker.h
View File

@ -76,7 +76,7 @@ public:
@param name
Control name.
@returns @true if the control was successfully created or @false if
@return @true if the control was successfully created or @false if
creation failed.
*/
bool Create(wxWindow* parent, wxWindowID id,

8
interface/frame.h
View File

@ -196,7 +196,7 @@ public:
@param name
The status bar window name.
@returns A pointer to the status bar if it was created successfully, @NULL
@return A pointer to the status bar if it was created successfully, @NULL
otherwise.
@remarks The width of the status bar is the whole width of the frame
@ -222,7 +222,7 @@ public:
@param name
The toolbar window name.
@returns A pointer to the toolbar if it was created successfully, @NULL
@return A pointer to the toolbar if it was created successfully, @NULL
otherwise.
@remarks By default, the toolbar is an instance of wxToolBar (which is
@ -286,7 +286,7 @@ public:
@param name
The window name.
@returns A status bar object.
@return A status bar object.
@remarks An application can override this function to return a different
kind of status bar. The default implementation returns
@ -310,7 +310,7 @@ public:
@param name
The toolbar window name.
@returns A toolbar object.
@return A toolbar object.
@remarks An application can override this function to return a different
kind of toolbar. The default implementation returns an

2
interface/gbsizer.h
View File

@ -86,7 +86,7 @@ public:
/**
Adds the given item to the given position.
@returns A valid pointer if the item was successfully placed at the
@return A valid pointer if the item was successfully placed at the
given position, or @NULL if something was already there.
*/
wxSizerItem* Add(wxWindow* window, const wxGBPosition& pos,

2
interface/gdicmn.h
View File

@ -723,7 +723,7 @@ public:
to scale both dimensions by the same factor you can also use
operator*=().
@returns A reference to this object (so that you can concatenate other
@return A reference to this object (so that you can concatenate other
operations in the same line).
*/
wxSize& Scale(float xscale, float yscale);

2
interface/html/htmlcell.h
View File

@ -277,7 +277,7 @@ public:
@param event
mouse event that triggered the call
@returns @true if a link was clicked, @false otherwise.
@return @true if a link was clicked, @false otherwise.
*/
virtual bool ProcessMouseClick(wxHtmlWindowInterface* window,
const wxPoint& pos,

2
interface/html/htmlpars.h
View File

@ -35,7 +35,7 @@ public:
one of supported tags is detected. @a tag contains all necessary
info (see wxHtmlTag for details).
@returns @true if ParseInner was called, @false otherwise.
@return @true if ParseInner was called, @false otherwise.
*/
virtual bool HandleTag(const wxHtmlTag& tag);

10
interface/html/htmlwin.h
View File

@ -72,7 +72,7 @@ public:
@param source
HTML code fragment
@returns @false if an error occurred, @true otherwise.
@return @false if an error occurred, @true otherwise.
*/
bool AppendToPage(const wxString& source);
@ -140,7 +140,7 @@ public:
/**
Loads HTML page from file and displays it.
@returns @false if an error occurred, @true otherwise
@return @false if an error occurred, @true otherwise
@see LoadPage()
*/
@ -154,7 +154,7 @@ public:
The address of document. See wxFileSystem for details on address format and
behaviour of "opener".
@returns @false if an error occurred, @true otherwise
@return @false if an error occurred, @true otherwise
@see LoadFile()
*/
@ -176,7 +176,7 @@ public:
@param event
The mouse event containing other information about the click
@returns @true if a link was clicked, @false otherwise.
@return @true if a link was clicked, @false otherwise.
*/
virtual bool OnCellClicked(wxHtmlCell cell, wxCoord x, wxCoord y,
const wxMouseEvent& event);
@ -351,7 +351,7 @@ public:
@param source
The HTML document source to be displayed.
@returns @false if an error occurred, @true otherwise.
@return @false if an error occurred, @true otherwise.
*/
bool SetPage(const wxString& source);

2
interface/icon.h
View File

@ -274,7 +274,7 @@ public:
The validity of these flags depends on the platform and wxWidgets
configuration.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@see wxIcon()
*/

32
interface/image.h
View File

@ -25,6 +25,8 @@
@category{FIXME}
@see wxImage, wxInitAllImageHandlers()
@todo Document all image handler types, indicating their library.
*/
class wxImageHandler : public wxObject
{
@ -54,7 +56,7 @@ public:
Opened input stream for reading image data. Currently, the stream must
support seeking.
@returns Number of available images. For most image handlers, this is 1
@return Number of available images. For most image handlers, this is 1
(exceptions are TIFF and ICO formats).
*/
int GetImageCount(wxInputStream& stream);
@ -91,7 +93,7 @@ public:
@param index
The index of the image in the file (starting from zero).
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@see wxImage::LoadFile, wxImage::SaveFile, SaveFile()
*/
@ -106,7 +108,7 @@ public:
@param stream
Opened output stream for writing the data.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@see wxImage::LoadFile, wxImage::SaveFile, LoadFile()
*/
@ -359,7 +361,7 @@ public:
wxImageHistogram object. wxImageHistogram is a specialization of
wxHashMap "template" and is defined as follows:
@returns Returns number of colours in the histogram.
@return Returns number of colours in the histogram.
*/
unsigned long ComputeHistogram(wxImageHistogram& histogram) const;
@ -371,7 +373,7 @@ public:
If the image image doesn't have alpha channel,
ConvertAlphaToMask does nothing.
@returns @false if FindFirstUnusedColour returns @false, @true otherwise.
@return @false if FindFirstUnusedColour returns @false, @true otherwise.
*/
bool ConvertAlphaToMask(unsigned char threshold = 128);
@ -413,7 +415,7 @@ public:
@param height
The height of the image in pixels.
@returns @true if the call succeeded, @false otherwise.
@return @true if the call succeeded, @false otherwise.
*/
bool Create(int width, int height, bool clear = true);
@ -429,7 +431,7 @@ public:
Initial values of the colour. Returned colour
will have RGB values equal to or greater than these.
@returns Returns @false if there is no unused colour left, @true on success.
@return Returns @false if there is no unused colour left, @true on success.
*/
bool FindFirstUnusedColour(unsigned char* r, unsigned char* g,
unsigned char* b,
@ -450,7 +452,7 @@ public:
@param mimetype
MIME type.
@returns A pointer to the handler if found, @NULL otherwise.
@return A pointer to the handler if found, @NULL otherwise.
@see wxImageHandler
*/
@ -536,7 +538,7 @@ public:
@li wxBITMAP_TYPE_ANI: Load a Windows animated cursor file (ANI).
@li wxBITMAP_TYPE_ANY: Will try to autodetect the format.
@returns Number of available images. For most image handlers, this is 1
@return Number of available images. For most image handlers, this is 1
(exceptions are TIFF and ICO formats).
*/
static int GetImageCount(const wxString& filename,
@ -550,7 +552,7 @@ public:
file extension masks
suitable for passing to file open/save dialog boxes.
@returns The format of the returned string is
@return The format of the returned string is
"(*.ext1;*.ext2)|*.ext1;*.ext2".
@see wxImageHandler
@ -739,7 +741,7 @@ public:
interpreted as the first image (index=0) by the GIF and TIFF handler
and as the largest and most colourful one by the ICO handler.
@returns @true if the operation succeeded, @false otherwise. If the
@return @true if the operation succeeded, @false otherwise. If the
optional index parameter is out of range, @false is
returned and a call to wxLogError() takes place.
@ -793,7 +795,7 @@ public:
@param name
The handler name.
@returns @true if the handler was found and removed, @false otherwise.
@return @true if the handler was found and removed, @false otherwise.
@see wxImageHandler
*/
@ -884,7 +886,7 @@ public:
@param mimetype
MIME type.
@returns @true if the operation succeeded, @false otherwise.
@return @true if the operation succeeded, @false otherwise.
@remarks Depending on how wxWidgets has been configured, not all formats
may be available.
@ -980,7 +982,7 @@ public:
@param mr,mg,mb
RGB value of pixels in mask that will be used to create the mask.
@returns Returns @false if mask does not have same dimensions as the image
@return Returns @false if mask does not have same dimensions as the image
or if there is no unused colour left. Returns @true if
the mask was successfully applied.
*/
@ -1039,7 +1041,7 @@ public:
@param image
Image to assign.
@returns Returns 'this' object.
@return Returns 'this' object.
*/
wxImage operator =(const wxImage& image);
};

6
interface/imaglist.h
View File

@ -60,7 +60,7 @@ public:
@param icon
Icon to use as the image.
@returns The new zero-based image index.
@return The new zero-based image index.
@remarks The original bitmap or icon is not affected by the Add
operation, and can be deleted afterwards.
@ -169,7 +169,7 @@ public:
@param height
receives the height of the images in the list
@returns @true if the function succeeded, @false if it failed (for example,
@return @true if the function succeeded, @false if it failed (for example,
if the image list was not yet initialized).
*/
bool GetSize(int index, int& width, int& height) const;
@ -195,7 +195,7 @@ public:
@param icon
Icon to use as the image.
@returns @true if the replacement was successful, @false otherwise.
@return @true if the replacement was successful, @false otherwise.
@remarks The original bitmap or icon is not affected by the Replace
operation, and can be deleted afterwards.

4
interface/intl.h
View File

@ -544,7 +544,7 @@ public:
This macro is identical to _() but for the plural variant of
wxGetTranslation().
@returns A const wxString.
@return A const wxString.
@header{wx/intl.h}
*/
@ -587,7 +587,7 @@ public:
would be no translations for the weekday names in the program message
catalog and wxGetTranslation() wouldn't find them.
@returns A const wxChar*.
@return A const wxChar*.
@header{wx/intl.h}
*/

4
interface/joystick.h
View File

@ -240,7 +240,7 @@ public:
/**
Releases the capture set by @b SetCapture.
@returns @true if the capture release succeeded.
@return @true if the capture release succeeded.
@see SetCapture(), wxJoystickEvent
*/
@ -256,7 +256,7 @@ public:
threshold. If greater than zero, events are received every pollingFreq
milliseconds.
@returns @true if the capture succeeded.
@return @true if the capture succeeded.
@see ReleaseCapture(), wxJoystickEvent
*/

6
interface/listbox.h
View File

@ -150,7 +150,7 @@ public:
A reference to an wxArrayInt instance that is used to store the result of
the query.
@returns The number of selections.
@return The number of selections.
@remarks Use this with a multiple selection listbox.
@ -168,7 +168,7 @@ public:
@param point
Point of item (in client coordinates) to obtain
@returns Item located at point, or wxNOT_FOUND if unimplemented or the
@return Item located at point, or wxNOT_FOUND if unimplemented or the
item does not exist.
@since 2.7.0
@ -200,7 +200,7 @@ public:
@param n
The zero-based item index.
@returns @true if the given item is selected, @false otherwise.
@return @true if the given item is selected, @false otherwise.
*/
bool IsSelected(int n) const;

4
interface/listctrl.h
View File

@ -1149,7 +1149,7 @@ public:
Together with GetNextSelected() it can be
used to iterate over all selected items in the control.
@returns The first selected item, if any, -1 otherwise.
@return The first selected item, if any, -1 otherwise.
*/
long GetFirstSelected() const;
@ -1164,7 +1164,7 @@ public:
Used together with GetFirstSelected() to
iterate over all selected items in the control.
@returns Returns the next selected item or -1 if there are no more of
@return Returns the next selected item or -1 if there are no more of
them.
*/
long GetNextSelected(long item) const;

4
interface/memory.h
View File

@ -54,7 +54,7 @@ public:
Checks the memory blocks for errors, starting from the currently set
checkpoint.
@returns Returns the number of errors, so a value of zero represents
@return Returns the number of errors, so a value of zero represents
success. Returns -1 if an error was detected that
prevents further checking.
*/
@ -65,7 +65,7 @@ public:
current debug stream. Calls the @b Dump member function for each wxObject
derived instance.
@returns @true if the function succeeded, @false otherwise.
@return @true if the function succeeded, @false otherwise.
*/
bool Dump();

50
interface/menu.h
View File

@ -59,7 +59,7 @@ public:
@param title
The title of the menu.
@returns @true on success, @false if an error occurred.
@return @true on success, @false if an error occurred.
@see Insert()
*/
@ -111,7 +111,7 @@ public:
@param menu
If not @NULL, menu will get set to the associated menu.
@returns The found menu item object, or @NULL if one was not found.
@return The found menu item object, or @NULL if one was not found.
*/
wxMenuItem* FindItem(int id, wxMenu menu = NULL) const;
@ -131,7 +131,7 @@ public:
@param itemString
Item to find.
@returns The menu item identifier, or wxNOT_FOUND if none was found.
@return The menu item identifier, or wxNOT_FOUND if none was found.
@remarks Any special menu codes are stripped out of source and target
strings before matching.
@ -145,8 +145,8 @@ public:
@param id
The menu item identifier.
@returns The help string, or the empty string if there was no help string
or the menu item was not found.
@return The help string, or the empty string if there was no help string
or the menu item was not found.
@see SetHelpString()
*/
@ -158,8 +158,8 @@ public:
@param id
The menu item identifier.
@returns The menu item label, or the empty string if the item was not
found.
@return The menu item label, or the empty string if the item was not
found.
@remarks Use only after the menubar has been associated with a frame.
*/
@ -173,7 +173,7 @@ public:
@param pos
Position of the menu on the menu bar, starting from zero.
@returns The menu label, or the empty string if the menu was not found.
@return The menu label, or the empty string if the menu was not found.
@remarks Use only after the menubar has been associated with a frame.
@ -199,7 +199,7 @@ public:
@param pos
Position of the menu on the menu bar, starting from zero.
@returns The menu label, or the empty string if the menu was not found.
@return The menu label, or the empty string if the menu was not found.
@remarks Use only after the menubar has been associated with a frame.
@ -215,7 +215,7 @@ public:
@param pos
Position of the menu on the menu bar, starting from zero.
@returns The menu label, or the empty string if the menu was not found.
@return The menu label, or the empty string if the menu was not found.
@remarks Use only after the menubar has been associated with a frame.
@ -236,7 +236,7 @@ public:
@param title
The title of the menu.
@returns @true on success, @false if an error occurred.
@return @true on success, @false if an error occurred.
@see Append()
*/
@ -248,7 +248,7 @@ public:
@param id
The menu item identifier.
@returns @true if the item was found and is checked, @false otherwise.
@return @true if the item was found and is checked, @false otherwise.
*/
bool IsChecked(int id) const;
@ -258,7 +258,7 @@ public:
@param id
The menu item identifier.
@returns @true if the item was found and is enabled, @false otherwise.
@return @true if the item was found and is enabled, @false otherwise.
*/
bool IsEnabled(int id) const;
@ -287,8 +287,8 @@ public:
@param title
The title of the menu.
@returns The menu which was previously at position pos. The caller is
responsible for deleting it.
@return The menu which was previously at position pos. The caller is
responsible for deleting it.
@see Insert(), Remove()
*/
@ -601,7 +601,7 @@ public:
@param itemString
Menu item string to find.
@returns Menu item identifier, or wxNOT_FOUND if none is found.
@return Menu item identifier, or wxNOT_FOUND if none is found.
@remarks Any special menu codes are stripped out of source and target
strings before matching.
@ -618,7 +618,7 @@ public:
If the pointer is not @NULL, it will be filled with the item's
parent menu (if the item was found)
@returns Menu item object or NULL if none is found.
@return Menu item object or NULL if none is found.
*/
const wxMenuItem * FindItem(int id, wxMenu** menu = NULL) const;
@ -633,8 +633,8 @@ public:
@param id
The menu item identifier.
@returns The help string, or the empty string if there is no help string
or the item was not found.
@return The help string, or the empty string if there is no help string
or the item was not found.
@see SetHelpString(), Append()
*/
@ -646,7 +646,7 @@ public:
@param id
The menu item identifier.
@returns The item label, or the empty string if the item was not found.
@return The item label, or the empty string if the item was not found.
@see GetLabelText(), SetLabel()
*/
@ -659,7 +659,7 @@ public:
@param id
The menu item identifier.
@returns The item label, or the empty string if the item was not found.
@return The item label, or the empty string if the item was not found.
@see GetLabel(), SetLabel()
*/
@ -738,7 +738,7 @@ public:
@param id
The menu item identifier.
@returns @true if the menu item is checked, @false otherwise.
@return @true if the menu item is checked, @false otherwise.
@see Check()
*/
@ -750,7 +750,7 @@ public:
@param id
The menu item identifier.
@returns @true if the menu item is enabled, @false otherwise.
@return @true if the menu item is enabled, @false otherwise.
@see Enable()
*/
@ -805,7 +805,7 @@ public:
@param id
The identifier of the menu item to remove.
@returns The item which was detached from the menu.
@return The item which was detached from the menu.
*/
wxMenuItem* Remove(int id);
@ -817,7 +817,7 @@ public:
@param item
The menu item to remove.
@returns The item which was detached from the menu.
@return The item which was detached from the menu.
*/
wxMenuItem* Remove(wxMenuItem* item);

2
interface/msw/ole/automtn.h
View File

@ -156,7 +156,7 @@ public:
@param ptrArgs
If non-null, contains an array of constant pointers to variants.
@returns @true if the operation was successful, @false otherwise.
@return @true if the operation was successful, @false otherwise.
@remarks Two types of argument array are provided, so that when possible
pointers are used for efficiency.

6
interface/notebook.h
View File

@ -162,7 +162,7 @@ public:
@param imageId
Specifies the optional image index for the new page.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@remarks Do not delete the page, it will be deleted by the notebook.
@ -339,7 +339,7 @@ public:
The point was over a currently selected page, not over any tab. Note that
this flag is present only if wxNOT_FOUND is returned.
@returns Returns the zero-based tab index or wxNOT_FOUND if there is no
@return Returns the zero-based tab index or wxNOT_FOUND if there is no
tab is at the specified position.
*/
virtual int HitTest(const wxPoint& pt, long* = NULL) const;
@ -358,7 +358,7 @@ public:
@param imageId
Specifies the optional image index for the new page.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@remarks Do not delete the page, it will be deleted by the notebook.

4
interface/object.h
View File

@ -250,7 +250,7 @@ public:
A pointer to a class information object, which may be obtained
by using the ::CLASSINFO macro.
@returns @true if the class represented by info is the same class as this
@return @true if the class represented by info is the same class as this
one or is derived from it.
*/
bool IsKindOf(wxClassInfo* info);
@ -368,7 +368,7 @@ public:
/**
Creates an object of the appropriate kind.
@returns @NULL if the class has not been declared dynamically creatable
@return @NULL if the class has not been declared dynamically creatable
(typically, this happens for abstract classes).
*/
wxObject* CreateObject() const;

6
interface/palette.h
View File

@ -86,7 +86,7 @@ public:
@param blue
An array of blue values.
@returns @true if the creation was successful, @false otherwise.
@return @true if the creation was successful, @false otherwise.
@see wxPalette()
*/
@ -109,7 +109,7 @@ public:
@param blue
Blue value.
@returns The nearest palette index or @c wxNOT_FOUND for unexpected errors.
@return The nearest palette index or @c wxNOT_FOUND for unexpected errors.
@see GetRGB()
*/
@ -128,7 +128,7 @@ public:
@param blue
Receives the blue value.
@returns @true if the operation was successful.
@return @true if the operation was successful.
@see GetPixel()
*/

2
interface/process.h
View File

@ -237,7 +237,7 @@ public:
The flags to pass to ::wxExecute().
Note: @c wxEXEC_SYNC should not be used.
@returns A pointer to new wxProcess object or @NULL on error.
@return A pointer to new wxProcess object or @NULL on error.
@see ::wxExecute()
*/

8
interface/protocol/ftp.h
View File

@ -116,7 +116,7 @@ public:
Send the specified @a command to the FTP server. @a ret specifies
the expected result.
@returns @true if the command has been sent successfully, else @false.
@return @true if the command has been sent successfully, else @false.
*/
bool CheckCommand(const wxString& command, char ret);
@ -173,7 +173,7 @@ public:
This list always has the same format and contains one full (including the
directory path) file name per line.
@returns @true if the file list was successfully retrieved, @false otherwise.
@return @true if the file list was successfully retrieved, @false otherwise.
@see GetDirList()
*/
@ -190,7 +190,7 @@ public:
You will be notified when the EOF is reached by an error.
@returns Returns @NULL if an error occurred (it could be a network failure
@return Returns @NULL if an error occurred (it could be a network failure
or the fact that the file doesn't exist).
*/
wxInputStream* GetInputStream(const wxString& path);
@ -206,7 +206,7 @@ public:
The returned stream has all but the seek functionality of wxStreams.
When the user finishes writing data, he has to delete the stream to close it.
@returns An initialized write-only stream.
@return An initialized write-only stream.
@see wxOutputStream
*/

2
interface/protocol/http.h
View File

@ -43,7 +43,7 @@ public:
In such case, you may want to use wxInputStream::LastRead() method in a loop
to get the total size.
@returns Returns the initialized stream. You must delete it yourself
@return Returns the initialized stream. You must delete it yourself
once you don't use it anymore and this must be done before
the wxHTTP object itself is destroyed. The destructor
closes the network connection. The next time you will

6
interface/protocol/protocol.h
View File

@ -44,7 +44,7 @@ public:
It is advised to destroy the input stream instead of aborting the stream
this way.
@returns Returns @true, if successful, else @false.
@return Returns @true, if successful, else @false.
*/
bool Abort();
@ -69,7 +69,7 @@ public:
available for the moment for this sort of stream.
You will be notified when the EOF is reached by an error.
@returns Returns the initialized stream. You will have to delete it
@return Returns the initialized stream. You will have to delete it
yourself once you don't use it anymore. The destructor
closes the network connection.
@ -81,7 +81,7 @@ public:
Tries to reestablish a previous opened connection (close and renegotiate
connection).
@returns @true, if the connection is established, else @false.
@return @true, if the connection is established, else @false.
*/
bool Reconnect();

12
interface/region.h
View File

@ -155,7 +155,7 @@ public:
Returns a value indicating whether the given rectangle is contained within the
region.
@returns The return value is one of wxOutRegion, wxPartRegion and
@return The return value is one of wxOutRegion, wxPartRegion and
wxInRegion.
*/
wxRegionContain Contains(long& x, long& y) const;
@ -185,7 +185,7 @@ public:
/**
Finds the intersection of this region and another region.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@remarks Creates the intersection of the two regions, that is, the parts
which are in both regions. The result is stored in this
@ -214,7 +214,7 @@ public:
Moves the region by the specified offsets in horizontal and vertical
directions.
@returns @true if successful, @false otherwise (the region is unchanged
@return @true if successful, @false otherwise (the region is unchanged
then).
*/
bool Offset(wxCoord x, wxCoord y);
@ -225,7 +225,7 @@ public:
/**
Subtracts a region from this region.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@remarks This operation combines the parts of 'this' region that are not
part of the second region. The result is stored in this
@ -242,7 +242,7 @@ public:
@a transColour argument, along with an
optional colour tolerance value.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@remarks This operation creates a region that combines all of this region
and the second region. The result is stored in this
@ -260,7 +260,7 @@ public:
/**
Finds the Xor of this region and another region.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@remarks This operation creates a region that combines all of this region
and the second region, except for any overlapping

4
interface/sizer.h
View File

@ -585,7 +585,7 @@ public:
Returns a wxOrientation value that specifies whether the sizer flexibly
resizes its columns, rows, or both (default).
@returns One of the following values:
@return One of the following values:
@see SetFlexibleDirection()
*/
@ -595,7 +595,7 @@ public:
Returns the value that specifies how the sizer grows in the "non-flexible"
direction if there is one.
@returns One of the following values:
@return One of the following values:
@see SetFlexibleDirection(),
SetNonFlexibleGrowMode()

2
interface/snglinst.h
View File

@ -91,7 +91,7 @@ public:
create the lock file in under Unix (default is
wxGetHomeDir())
@returns Returns @false if initialization failed, it doesn't mean that
@return Returns @false if initialization failed, it doesn't mean that
another instance is running - use IsAnotherRunning()
to check for it.
*/

48
interface/socket.h
View File

@ -24,7 +24,7 @@ public:
problems. Internally, this is the same as setting the IP address
to @b INADDR_ANY.
@returns Returns @true on success, @false if something went wrong.
@return Returns @true on success, @false if something went wrong.
*/
bool AnyAddress();
@ -107,7 +107,7 @@ public:
or catch @b wxSOCKET_CONNECTION events, then call Accept once you know
that there is an incoming connection waiting to be accepted.
@returns Returns an opened socket connection, or @NULL if an error
@return Returns an opened socket connection, or @NULL if an error
occurred or if the wait parameter was @false and there
were no pending connections.
@ -122,7 +122,7 @@ public:
@param socket
Socket to be initialized
@returns Returns @true on success, or @false if an error occurred or if the
@return Returns @true on success, or @false if an error occurred or if the
wait parameter was @false and there were no pending
connections.
*/
@ -141,7 +141,7 @@ public:
@param millisecond
Number of milliseconds to wait.
@returns Returns @true if an incoming connection arrived, @false if the
@return Returns @true if an incoming connection arrived, @false if the
timeout elapsed.
*/
bool WaitForAccept(long seconds = -1, long millisecond = 0);
@ -170,7 +170,7 @@ public:
On IPV4 implementations, 0.0.0.0
On IPV6 implementations, ::
@returns Returns @true on success, @false if something went wrong.
@return Returns @true on success, @false if something went wrong.
*/
virtual bool AnyAddress();
@ -179,7 +179,7 @@ public:
to @b INADDR_BROADCAST.
On IPV4 implementations, 255.255.255.255
@returns Returns @true on success, @false if something went wrong.
@return Returns @true on success, @false if something went wrong.
*/
virtual bool BroadcastAddress();
@ -206,7 +206,7 @@ public:
On IPV4 implementations, 127.0.0.1
On IPV6 implementations, ::1
@returns Returns @true on success, @false if something went wrong.
@return Returns @true on success, @false if something went wrong.
*/
virtual bool LocalHost();
@ -270,7 +270,7 @@ public:
@param wait
If @true, waits for the connection to complete.
@returns Returns @true if the connection is established and no error
@return Returns @true if the connection is established and no error
occurs.
@see WaitOnConnect(), wxSocketBase::SetNotify,
@ -293,7 +293,7 @@ public:
@param millisecond
Number of milliseconds to wait.
@returns WaitOnConnect returns @true if the connection request completes.
@return WaitOnConnect returns @true if the connection request completes.
This does not necessarily mean that the connection was
successfully established; it might also happen that the
connection was refused by the peer. Use IsConnected to
@ -490,7 +490,7 @@ public:
socket objects in the stack.
Destroy calls Close() automatically.
@returns Always @true.
@return Always @true.
*/
bool Destroy();
@ -525,7 +525,7 @@ public:
address field contains the complete local address of the socket (local
address, local port, ...).
@returns @true if no error happened, @false otherwise.
@return @true if no error happened, @false otherwise.
*/
bool GetLocal(wxSockAddress& addr) const;
@ -534,7 +534,7 @@ public:
address field contains the complete peer host address of the socket
(address, port, ...).
@returns @true if no error happened, @false otherwise.
@return @true if no error happened, @false otherwise.
*/
bool GetPeer(wxSockAddress& addr) const;
@ -634,7 +634,7 @@ public:
@param nbytes
Number of bytes.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
@see Error(), LastError(), LastCount(),
SetFlags()
@ -651,7 +651,7 @@ public:
@param nbytes
Number of bytes.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
@see Error(), LastError(), LastCount(),
SetFlags()
@ -671,7 +671,7 @@ public:
@param nbytes
Size of the buffer.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
@see Error(), LastError(), LastCount(),
SetFlags(), WriteMsg()
@ -896,7 +896,7 @@ public:
@param nbytes
Number of bytes.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
@see Error(), LastCount(), LastError()
*/
@ -920,7 +920,7 @@ public:
@param millisecond
Number of milliseconds to wait.
@returns Returns @true when any of the above conditions is satisfied,
@return Returns @true when any of the above conditions is satisfied,
@false if the timeout was reached.
@see InterruptWait(), wxSocketServer::WaitForAccept,
@ -940,7 +940,7 @@ public:
@param millisecond
Number of milliseconds to wait.
@returns Returns @true if the connection was lost, @false if the timeout
@return Returns @true if the connection was lost, @false if the timeout
was reached.
@see InterruptWait(), Wait()
@ -961,7 +961,7 @@ public:
@param millisecond
Number of milliseconds to wait.
@returns Returns @true if the socket becomes readable, @false on timeout.
@return Returns @true if the socket becomes readable, @false on timeout.
@see InterruptWait(), Wait()
*/
@ -981,7 +981,7 @@ public:
@param millisecond
Number of milliseconds to wait.
@returns Returns @true if the socket becomes writable, @false on timeout.
@return Returns @true if the socket becomes writable, @false on timeout.
@see InterruptWait(), Wait()
*/
@ -997,7 +997,7 @@ public:
@param nbytes
Number of bytes.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
@see Error(), LastError(), LastCount(),
SetFlags()
@ -1018,7 +1018,7 @@ public:
@param nbytes
Number of bytes to send.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
*/
wxSocketBase WriteMsg(const void* buffer, wxUint32 nbytes);
};
@ -1065,7 +1065,7 @@ public:
@param nbytes
Number of bytes.
@returns Returns a reference to the current object, and the address of
@return Returns a reference to the current object, and the address of
the peer that sent the data on address param.
@see wxSocketBase::Error, wxSocketBase::LastError, wxSocketBase::LastCount,
@ -1087,7 +1087,7 @@ public:
@param nbytes
Number of bytes.
@returns Returns a reference to the current object.
@return Returns a reference to the current object.
*/
wxDatagramSocket SendTo(const wxSockAddress& address,
const void* buffer,

2
interface/sound.h
View File

@ -50,7 +50,7 @@ public:
@param isResource
@true if fileName is a resource, @false if it is a filename.
@returns @true if the call was successful, @false otherwise.
@return @true if the call was successful, @false otherwise.
*/
bool Create(const wxString& fileName, bool isResource = false);

6
interface/splitter.h
View File

@ -290,7 +290,7 @@ public:
(default)
to choose the default position (half of the total window height).
@returns @true if successful, @false otherwise (the window was already
@return @true if successful, @false otherwise (the window was already
split).
@remarks This should be called if you wish to initially view two panes.
@ -319,7 +319,7 @@ public:
(default)
to choose the default position (half of the total window width).
@returns @true if successful, @false otherwise (the window was already
@return @true if successful, @false otherwise (the window was already
split).
@remarks This should be called if you wish to initially view two panes.
@ -339,7 +339,7 @@ public:
@param toRemove
The pane to remove, or @NULL to remove the right or bottom pane.
@returns @true if successful, @false otherwise (the window was not split).
@return @true if successful, @false otherwise (the window was not split).
@remarks This call will not actually delete the pane being removed; it
calls OnUnsplit which can be overridden for the desired

4
interface/statusbr.h
View File

@ -82,7 +82,7 @@ public:
@param rect
The rectangle values are placed in this variable.
@returns @true if the field index is valid, @false otherwise.
@return @true if the field index is valid, @false otherwise.
@see wxRect
*/
@ -99,7 +99,7 @@ public:
@param i
The number of the status field to retrieve, starting from zero.
@returns The status field string if the field is valid, otherwise the
@return The status field string if the field is valid, otherwise the
empty string.
@see SetStatusText()

2
interface/strconv.h
View File

@ -330,7 +330,7 @@ public:
The length of the output buffer but including
NUL, ignored if out is @NULL
@returns The length of the converted string excluding the trailing NUL.
@return The length of the converted string excluding the trailing NUL.
*/
virtual size_t MB2WC(wchar_t* out, const char* in,
size_t outLen) const;

10
interface/stream.h
View File

@ -217,7 +217,7 @@ public:
The position is counted from the end of the stream.
@returns Upon successful completion, it returns the new offset as
@return Upon successful completion, it returns the new offset as
measured in bytes from the beginning of the stream.
Otherwise, it returns wxInvalidOffset.
*/
@ -256,7 +256,7 @@ public:
it gives you the position in the @e real stream counted from the start of
the stream.
@returns Returns the current position in the stream if possible,
@return Returns the current position in the stream if possible,
wxInvalidOffset in the other case.
*/
off_t Tell() const;
@ -332,7 +332,7 @@ public:
@param mode
One of wxFromStart, wxFromEnd, wxFromCurrent.
@returns The new stream position or wxInvalidOffset on error.
@return The new stream position or wxInvalidOffset on error.
*/
off_t SeekO(off_t pos, wxSeekMode mode = wxFromStart);
@ -634,7 +634,7 @@ public:
Reads data from the input queue and stores it in the specified output stream.
The data is read until an error is raised by one of the two streams.
@returns This function returns a reference on the current object, so the
@return This function returns a reference on the current object, so the
user can test any states of the stream right away.
*/
wxInputStream Read(void* buffer, size_t size);
@ -652,7 +652,7 @@ public:
@param mode
One of wxFromStart, wxFromEnd, wxFromCurrent.
@returns The new stream position or wxInvalidOffset on error.
@return The new stream position or wxInvalidOffset on error.
*/
off_t SeekI(off_t pos, wxSeekMode mode = wxFromStart);

24
interface/textctrl.h
View File

@ -771,7 +771,7 @@ public:
@since 2.9.0
@returns @true if the auto-completion was enabled or @false if the
@return @true if the auto-completion was enabled or @false if the
operation failed, typically because auto-completion is
not supported by the current platform.
@ -787,7 +787,7 @@ public:
@since 2.9.0
@returns @true if the auto-completion was enabled or @false if the
@return @true if the auto-completion was enabled or @false if the
operation failed, typically because auto-completion is
not supported by the current platform.
@ -884,7 +884,7 @@ public:
Please note that this function doesn't currently work correctly for all keys
under any platform but MSW.
@returns @true if the event resulted in a change to the control, @false
@return @true if the event resulted in a change to the control, @false
otherwise.
*/
bool EmulateKeyPress(const wxKeyEvent& event);
@ -920,7 +920,7 @@ public:
@param lineNo
Line number (starting from zero).
@returns The length of the line, or -1 if lineNo was invalid.
@return The length of the line, or -1 if lineNo was invalid.
*/
int GetLineLength(long lineNo) const;
@ -931,7 +931,7 @@ public:
@param lineNo
The line number, starting from zero.
@returns The contents of the line.
@return The contents of the line.
*/
wxString GetLineText(long lineNo) const;
@ -984,7 +984,7 @@ public:
Returns the style at this position in the text control. Not all platforms
support this function.
@returns @true on success, @false if an error occurred - it may also mean
@return @true on success, @false if an error occurred - it may also mean
that the styles are not supported under this platform.
@see SetStyle(), wxTextAttr
@ -1062,7 +1062,7 @@ public:
@param fileType
The type of file to load. This is currently ignored in wxTextCtrl.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
*/
bool LoadFile(const wxString& filename,
int fileType = wxTEXT_TYPE_ANY);
@ -1102,7 +1102,7 @@ public:
@param y
Receives zero based line number.
@returns @true on success, @false on failure (most likely due to a too
@return @true on success, @false on failure (most likely due to a too
large position parameter).
@see XYToPosition()
@ -1148,7 +1148,7 @@ public:
@param fileType
The type of file to save. This is currently ignored in wxTextCtrl.
@returns @true if the operation was successful, @false otherwise.
@return @true if the operation was successful, @false otherwise.
*/
bool SaveFile(const wxString& filename,
int fileType = wxTEXT_TYPE_ANY);
@ -1168,7 +1168,7 @@ public:
@param style
The style for the new text.
@returns @true on success, @false if an error occurred - may also mean that
@return @true on success, @false if an error occurred - may also mean that
the styles are not supported under this platform.
@see GetDefaultStyle()
@ -1255,7 +1255,7 @@ public:
@param style
The new style for the range.
@returns @true on success, @false if an error occurred - it may also mean
@return @true on success, @false if an error occurred - it may also mean
that the styles are not supported under this platform.
@see GetStyle(), wxTextAttr
@ -1313,7 +1313,7 @@ public:
@param y
The line number.
@returns The position value, or -1 if x or y was invalid.
@return The position value, or -1 if x or y was invalid.
*/
long XYToPosition(long x, long y);

4
interface/tglbtn.h
View File

@ -89,7 +89,7 @@ public:
/**
Gets the state of the toggle button.
@returns Returns @true if it is pressed, @false otherwise.
@return Returns @true if it is pressed, @false otherwise.
*/
bool GetValue() const;
@ -154,7 +154,7 @@ public:
/**
Gets the state of the toggle button.
@returns Returns @true if it is pressed, @false otherwise.
@return Returns @true if it is pressed, @false otherwise.
*/
virtual bool GetValue() const;

20
interface/thread.h
View File

@ -91,7 +91,7 @@ public:
and so it is important to ensure that the condition will be signalled after
Wait or the thread may sleep forever.
@returns Returns wxCOND_NO_ERROR on success, another value if an error
@return Returns wxCOND_NO_ERROR on success, another value if an error
occurred.
@see WaitTimeout()
@ -226,7 +226,7 @@ public:
it. You may optionally specify the stack size to be allocated to it (Ignored on
platforms that don't support setting it explicitly, eg. Unix).
@returns One of:
@return One of:
*/
wxThreadError Create(unsigned int stackSize = 0);
@ -382,7 +382,7 @@ public:
unless you explicitly specify a smaller amount of thread stack space for each
thread.
@returns One of:
@return One of:
*/
wxThreadError Create(unsigned int stackSize = 0);
@ -788,14 +788,14 @@ public:
threads in an atomic way. Returns wxSEMA_OVERFLOW if the count
would increase the counter past the maximum.
@returns One of:
@return One of:
*/
wxSemaError Post();
/**
Same as Wait(), but returns immediately.
@returns One of:
@return One of:
*/
wxSemaError TryWait();
@ -803,7 +803,7 @@ public:
Wait indefinitely until the semaphore count becomes strictly positive
and then decrement it and return.
@returns One of:
@return One of:
*/
wxSemaError Wait();
};
@ -894,28 +894,28 @@ public:
Locks the mutex object. This is equivalent to
LockTimeout() with infinite timeout.
@returns One of:
@return One of:
*/
wxMutexError Lock();
/**
Try to lock the mutex object during the specified time interval.
@returns One of:
@return One of:
*/
wxMutexError LockTimeout(unsigned long msec);
/**
Tries to lock the mutex object. If it can't, returns immediately with an error.
@returns One of:
@return One of:
*/
wxMutexError TryLock();
/**
Unlocks the mutex object.
@returns One of:
@return One of:
*/
wxMutexError Unlock();
};

10
interface/toolbar.h
View File

@ -265,7 +265,7 @@ public:
@param y
Y position.
@returns A pointer to a tool if a tool is found, or @NULL otherwise.
@return A pointer to a tool if a tool is found, or @NULL otherwise.
@remarks Currently not implemented in wxGTK (always returns @NULL there).
*/
@ -297,7 +297,7 @@ public:
@param toolId
Id of the tool, as passed to AddTool().
@returns Client data, or @NULL if there is none.
@return Client data, or @NULL if there is none.
*/
wxObject* GetToolClientData(int toolId) const;
@ -307,7 +307,7 @@ public:
@param toolId
Id of the tool in question.
@returns @true if the tool is enabled, @false otherwise.
@return @true if the tool is enabled, @false otherwise.
@see EnableTool()
*/
@ -368,7 +368,7 @@ public:
@param toolId
The tool in question.
@returns @true if the tool is toggled on, @false otherwise.
@return @true if the tool is toggled on, @false otherwise.
@see ToggleTool()
*/
@ -424,7 +424,7 @@ public:
@param toggleDown
@true if the tool is a toggle and the toggle is down, otherwise is @false.
@returns If the tool is a toggle and this function returns @false, the
@return If the tool is a toggle and this function returns @false, the
toggle toggle state (internal and visual) will not be
changed. This provides a way of specifying that toggle
operations are not permitted in some circumstances.

2
interface/url.h
View File

@ -85,7 +85,7 @@ public:
}
@endcode
@returns Returns the initialized stream. You will have to delete it
@return Returns the initialized stream. You will have to delete it
yourself.
@see wxInputStream

18
interface/utils.h
View File

@ -515,7 +515,7 @@ wxString wxStripMenuCodes(const wxString& str, int flags = wxStrip_All);
Copies the user's email address into the supplied buffer, by concatenating
the values returned by wxGetFullHostName() and wxGetUserId().
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@header{wx/utils.h}
*/
@ -527,7 +527,7 @@ wxString wxGetEmailAddress();
@param buf Buffer to store the email address in.
@param sz Size of the buffer.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@header{wx/utils.h}
*/
@ -559,7 +559,7 @@ wxString wxGetHomeDir();
SYSTEM_NAME; if this is not found, the entry @b HostName in the wxWidgets
section of the WIN.INI file is tried.
@returns The hostname if successful or an empty string otherwise.
@return The hostname if successful or an empty string otherwise.
@see wxGetFullHostName()
@ -573,7 +573,7 @@ wxString wxGetHostName();
@param buf Buffer to store the host name in.
@param sz Size of the buffer.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@header{wx/utils.h}
*/
@ -607,7 +607,7 @@ wxString wxGetUserHome(const wxString& user = "");
environment variables USER and LOGNAME; if neither of these is found, the
entry @b UserId in the @b wxWidgets section of the WIN.INI file is tried.
@returns The login name if successful or an empty string otherwise.
@return The login name if successful or an empty string otherwise.
@see wxGetUserName()
@ -621,7 +621,7 @@ wxString wxGetUserId();
@param buf Buffer to store the login name in.
@param sz Size of the buffer.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@header{wx/utils.h}
*/
@ -634,7 +634,7 @@ bool wxGetUserId(char* buf, int sz);
wxWidgets section of the WIN.INI file. If PenWindows is running, the entry
Current in the section User of the PENWIN.INI file is used.
@returns The full user name if successful or an empty string otherwise.
@return The full user name if successful or an empty string otherwise.
@see wxGetUserId()
@ -648,7 +648,7 @@ wxString wxGetUserName();
@param buf Buffer to store the full user name in.
@param sz Size of the buffer.
@returns @true if successful, @false otherwise.
@return @true if successful, @false otherwise.
@header{wx/utils.h}
*/
@ -950,7 +950,7 @@ bool wxShell(const wxString& command = NULL);
@param flags
Either wxSHUTDOWN_POWEROFF or wxSHUTDOWN_REBOOT
@returns @true on success, @false if an error occurred.
@return @true on success, @false if an error occurred.
@header{wx/utils.h}
*/

2
interface/validate.h
View File

@ -63,7 +63,7 @@ public:
brushes, it does not make sense to have a reference counting scheme to
do this cloning because all validators should have separate data.
@returns This base function returns @NULL.
@return This base function returns @NULL.
*/
virtual wxObject* Clone() const;

10
interface/vlbox.h
View File

@ -68,7 +68,7 @@ public:
@c wxLB_MULTIPLE which indicates that the listbox should support
multiple selection.
@returns @true on success or @false if the control couldn't be created.
@return @true on success or @false if the control couldn't be created.
*/
bool Create(wxWindow* parent, wxWindowID id = wxID_ANY,
const wxPoint& pos = wxDefaultPosition,
@ -79,7 +79,7 @@ public:
Deselects all the items in the listbox. This method is only valid for
multi selection listboxes.
@returns @true if any items were changed, i.e. if there had been any
@return @true if any items were changed, i.e. if there had been any
selected items before, or @false if all the items were already
deselected.
@ -239,7 +239,7 @@ public:
Selects or deselects the specified item which must be valid (i.e. not
equal to @c wxNOT_FOUND).
@returns @true if the items selection status has changed or @false
@return @true if the items selection status has changed or @false
otherwise.
This function is only valid for the multiple selection listboxes, use
@ -250,7 +250,7 @@ public:
/**
Selects all the items in the listbox.
@returns @true if any items were changed, i.e. if there had been any
@return @true if any items were changed, i.e. if there had been any
unselected items before, or @false if all the items were
already selected.
@ -264,7 +264,7 @@ public:
Selects all items in the specified range which may be given in any
order.
@returns @true if the items selection status has changed or @false
@return @true if the items selection status has changed or @false
otherwise.
This method is only valid for multi selection listboxes.

16
interface/vscroll.h
View File

@ -304,9 +304,9 @@ public:
Scroll by the specified number of rows which may be positive (to scroll
down) or negative (to scroll up).
@returns @true if the window was scrolled, @false otherwise (for
example, if we're trying to scroll down but we are already
showing the last row).
@return @true if the window was scrolled, @false otherwise (for
example, if we're trying to scroll down but we are already
showing the last row).
*/
virtual bool ScrollRows(int rows);
@ -314,7 +314,7 @@ public:
Scroll to the specified row. It will become the first visible row in
the window.
@returns @true if we scrolled the window, @false if nothing was done.
@return @true if we scrolled the window, @false if nothing was done.
*/
bool ScrollToRow(size_t row);
@ -441,9 +441,9 @@ public:
Scroll by the specified number of columns which may be positive (to
scroll right) or negative (to scroll left).
@returns @true if the window was scrolled, @false otherwise (for
example, if we're trying to scroll right but we are already
showing the last column).
@return @true if the window was scrolled, @false otherwise (for
example, if we're trying to scroll right but we are already
showing the last column).
*/
virtual bool ScrollColumns(int columns);
@ -451,7 +451,7 @@ public:
Scroll to the specified column. It will become the first visible column
in the window.
@returns @true if we scrolled the window, @false if nothing was done.
@return @true if we scrolled the window, @false if nothing was done.
*/
bool ScrollToColumn(size_t column);

34
interface/window.h
View File

@ -422,7 +422,7 @@ public:
non-existent
windows.
@returns @true if the window has either been successfully deleted, or it
@return @true if the window has either been successfully deleted, or it
has been added to the list of windows pending real
deletion.
*/
@ -436,7 +436,7 @@ public:
/**
Disables the window, same as @ref enable() Enable(@false).
@returns Returns @true if the window has been disabled, @false if it had
@return Returns @true if the window has been disabled, @false if it had
been already disabled before the call to this function.
*/
bool Disable();
@ -491,7 +491,7 @@ public:
@param enable
If @true, enables the window for input. If @false, disables the window.
@returns Returns @true if the window has been enabled or disabled, @false
@return Returns @true if the window has been enabled or disabled, @false
if nothing was done, i.e. if the window had already
been in the specified state.
@ -978,7 +978,7 @@ public:
@param y
The vertical position of the menu
@returns The selected menu item id or wxID_NONE if none selected or an
@return The selected menu item id or wxID_NONE if none selected or an
error occurred.
*/
int GetPopupMenuSelectionFromUser(wxMenu& menu,
@ -1180,7 +1180,7 @@ public:
Navigate() if the key event is one normally used for
keyboard navigation and return @true in this case.
@returns Returns @true if the key pressed was for navigation and was
@return Returns @true if the key pressed was for navigation and was
handled, @false otherwise.
@see Navigate()
@ -1473,7 +1473,7 @@ public:
A combination of wxNavigationKeyEvent::IsForward and
wxNavigationKeyEvent::WinChange.
@returns Returns @true if the focus was moved to another window or @false
@return Returns @true if the focus was moved to another window or @false
if nothing changed.
@remarks You may wish to call this from a text control custom keypress
@ -1501,7 +1501,7 @@ public:
@param count
The number of sequential IDs to reserve.
@returns Returns the ID or the first ID of the range, or wxID_NONE if the
@return Returns the ID or the first ID of the range, or wxID_NONE if the
specified number of identifiers couldn't be allocated.
@see UnreserveControlId(), wxIdManager, @ref overview_windowidsoverview
@ -1656,7 +1656,7 @@ public:
@param virtualKeyCode
The virtual key code of the hotkey.
@returns @true if the hotkey was registered successfully. @false if some
@return @true if the hotkey was registered successfully. @false if some
other application already registered a hotkey with this
modifier/virtualKeyCode combination.
@ -1697,7 +1697,7 @@ public:
The event handler to remove, must be non-@NULL and
must be present in this windows event handlers chain
@returns Returns @true if it was found and @false otherwise (this also
@return Returns @true if it was found and @false otherwise (this also
results in an assert failure so this function should
only be called when the handler is supposed to be
there).
@ -1735,7 +1735,7 @@ public:
Scrolls the window by the given number of lines down (if @a lines is
positive) or up.
@returns Returns @true if the window was scrolled, @false if it was already
@return Returns @true if the window was scrolled, @false if it was already
on top/bottom and nothing was done.
@remarks This function is currently only implemented under MSW and
@ -1750,7 +1750,7 @@ public:
Scrolls the window by the given number of pages down (if @a pages is
positive) or up.
@returns Returns @true if the window was scrolled, @false if it was already
@return Returns @true if the window was scrolled, @false if it was already
on top/bottom and nothing was done.
@remarks This function is currently only implemented under MSW and wxGTK.
@ -2021,7 +2021,7 @@ public:
Font to associate with this window, pass
wxNullFont to reset to the default font.
@returns @true if the want was really changed, @false if it was already set
@return @true if the want was really changed, @false if it was already set
to this font and so nothing was done.
@see GetFont(), InheritAttributes()
@ -2446,7 +2446,7 @@ public:
@param show
If @true displays the window. Otherwise, hides it.
@returns @true if the window has been shown or hidden or @false if nothing
@return @true if the window has been shown or hidden or @false if nothing
was done because it already was in the requested state.
@see IsShown(), Hide(), wxRadioBox::Show
@ -2494,7 +2494,7 @@ public:
Also, please notice that not all styles can be changed after the control
creation.
@returns Returns @true if the style was turned on by this function, @false
@return Returns @true if the style was turned on by this function, @false
if it was switched off.
@see SetWindowStyleFlag(), HasFlag()
@ -2518,7 +2518,7 @@ public:
If the window has @c wxWS_EX_VALIDATE_RECURSIVELY extra style flag set,
the method will also call TransferDataToWindow() of all child windows.
@returns Returns @false if a transfer failed.
@return Returns @false if a transfer failed.
@see TransferDataFromWindow(), wxValidator, Validate()
*/
@ -2531,7 +2531,7 @@ public:
Numeric identifier of the hotkey. Must be the same id that was passed to
RegisterHotKey.
@returns @true if the hotkey was unregistered successfully, @false if the
@return @true if the hotkey was unregistered successfully, @false if the
id was invalid.
@remarks This function is currently only implemented under MSW.
@ -2596,7 +2596,7 @@ public:
If the window has @c wxWS_EX_VALIDATE_RECURSIVELY extra style flag set,
the method will also call Validate() of all child windows.
@returns Returns @false if any of the validations failed.
@return Returns @false if any of the validations failed.
@see TransferDataFromWindow(), TransferDataToWindow(),
wxValidator

2
interface/windowid.h
View File

@ -35,7 +35,7 @@ public:
@param count
The number of sequential IDs to reserve.
@returns The value of the first ID in the sequence, or wxID_NONE.
@return The value of the first ID in the sequence, or wxID_NONE.
*/
static wxWindowID ReserveControlId(int count = 1);
};

6
interface/wxcrt.h
View File

@ -10,7 +10,7 @@
//@{
/**
@returns @true if the pointer is either @NULL or points to an empty string,
@return @true if the pointer is either @NULL or points to an empty string,
@false otherwise.
@header{wx/wxcrt.h}
@ -30,7 +30,7 @@ size_t wxStrlen(const char* p);
This function complements the standard C function @e stricmp() which
performs case-insensitive comparison.
@returns A negative value, 0, or positive value if @a p1 is less than,
@return A negative value, 0, or positive value if @a p1 is less than,
equal to or greater than @a p2. The comparison is case-sensitive.
@header{wx/wxcrt.h}
@ -41,7 +41,7 @@ int wxStrcmp(const char* p1, const char* p2);
This function complements the standard C function @e strcmp() which performs
case-sensitive comparison.
@returns A negative value, 0, or positive value if @a p1 is less than,
@return A negative value, 0, or positive value if @a p1 is less than,
equal to or greater than @e p2. The comparison is case-insensitive.
@header{wx/wxcrt.h}