removed @NULL,@true,@false tags from the function prototypes; fixed * and & displacing in the prototypes; changed @param as discussed on wx-dev; use @see instead of @sa; better indentation for @returns,@remarks,@see paragraphs; other misc fixes

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@52407 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2008-03-09 12:33:59 +00:00
parent 0aaf0255e4
commit 4cc4bfafe5
256 changed files with 8880 additions and 10701 deletions

View File

@@ -43,7 +43,7 @@
@endStyleTable
@beginEventTable
@event{EVT_DATE_CHANGED(id\, func)}:
@event{EVT_DATE_CHANGED(id, func)}:
This event fires when the user changes the current selection in the
control.
@endEventTable
@@ -62,7 +62,7 @@ public:
Initializes the object and calls Create() with
all the parameters.
*/
wxDatePickerCtrl(wxWindow * parent, wxWindowID id,
wxDatePickerCtrl(wxWindow* parent, wxWindowID id,
const wxDateTime& dt = wxDefaultDateTime,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
@@ -72,37 +72,30 @@ public:
/**
@param parent
Parent window, must not be non-@NULL.
Parent window, must not be non-@NULL.
@param id
The identifier for the control.
The identifier for the control.
@param dt
The initial value of the control, if an invalid date (such as the
default value) is used, the control is set to today.
The initial value of the control, if an invalid date (such as the
default value) is used, the control is set to today.
@param pos
Initial position.
Initial position.
@param size
Initial size. If left at default value, the control chooses its
own best size by using the height approximately equal to a text control and
width large enough to show the date string fully.
Initial size. If left at default value, the control chooses its
own best size by using the height approximately equal to a text control and
width large enough to show the date string fully.
@param style
The window style, should be left at 0 as there are no
special styles for this control in this version.
The window style, should be left at 0 as there are no
special styles for this control in this version.
@param validator
Validator which can be used for additional date checks.
Validator which can be used for additional date checks.
@param name
Control name.
Control name.
@returns @true if the control was successfully created or @false if
creation failed.
creation failed.
*/
bool Create(wxWindow * parent, wxWindowID id,
bool Create(wxWindow* parent, wxWindowID id,
const wxDateTime& dt = wxDefaultDateTime,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
@@ -114,20 +107,19 @@ public:
If the control had been previously limited to a range of dates using
SetRange(), returns the lower and upper
bounds of this range. If no range is set (or only one of the bounds is set),
@e dt1 and/or @e dt2 are set to be invalid.
@a dt1 and/or @a dt2 are set to be invalid.
@param dt1
Pointer to the object which receives the lower range limit or
becomes invalid if it is not set. May be @NULL if the caller is not
interested in lower limit
Pointer to the object which receives the lower range limit or
becomes invalid if it is not set. May be @NULL if the caller is not
interested in lower limit
@param dt2
Same as above but for the upper limit
Same as above but for the upper limit
@returns @false if no range limits are currently set, @true if at least one
bound is set.
bound is set.
*/
bool GetRange(wxDateTime * dt1, wxDateTime dt2);
bool GetRange(wxDateTime* dt1, wxDateTime dt2);
/**
Returns the currently selected. If there is no selection or the selection is
@@ -138,7 +130,6 @@ public:
/**
Please note that this function is only available in the generic version of this
control. The native version always uses the current system locale.
Sets the display format for the date in the control. See wxDateTime for the
meaning of format strings.
@@ -147,19 +138,18 @@ public:
void SetFormat(const wxChar* format);
/**
Sets the valid range for the date selection. If @e dt1 is valid, it becomes
the earliest date (inclusive) accepted by the control. If @e dt2 is valid,
Sets the valid range for the date selection. If @a dt1 is valid, it becomes
the earliest date (inclusive) accepted by the control. If @a dt2 is valid,
it becomes the latest possible date.
@remarks If the current value of the control is outside of the newly set
range bounds, the behaviour is undefined.
range bounds, the behaviour is undefined.
*/
void SetRange(const wxDateTime& dt1, const wxDateTime& dt2);
/**
Changes the current value of the control. The date should be valid and included
in the currently selected range, if any.
Calling this method does not result in a date change event.
*/
void SetValue(const wxDateTime& dt);