sharpetronics/QGIS
1
0
Fork 0
mirror of https://github.com/qgis/QGIS.git synced 2025-02-27 00:33:48 -05:00
Code Issues Packages Projects Releases Wiki Activity

doxymentattion

Browse Source
This commit is contained in:
Denis Rouzaud 2018-01-04 16:37:24 -04:00
parent d8cc285fd2
commit 2528639320
2 changed files with 24 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
python/gui/editorwidgets/qgsdatetimeedit.sip
View File

@ -12,6 +12,13 @@ class QgsDateTimeEdit : QDateTimeEdit
{
%Docstring
The QgsDateTimeEdit class is a QDateTimeEdit with the capability of setting/reading null date/times.
.. warning::
You should use the signal dateTimeChanged of this subclass QgsDateTimeEdit
rather than parent's one (QDateTimeEdit). If you consequently connect parent's
dateTimeChanged signal and call dateTime() afterwards there is no warranty to
have a proper NULL value handling.
%End
%TypeHeaderCode
@ -66,7 +73,13 @@ Resets the widget to show no value (ie, an "unknown" state).
%End
signals:
void dateTimeChanged( const QDateTime &date );
%Docstring
reimplements QDateTimeEdit.dateTimeChanged signal
to properly handles NULL values.
@param date the new date/time value.
%End
protected:
virtual void mousePressEvent( QMouseEvent *event );

11
src/gui/editorwidgets/qgsdatetimeedit.h
View File

@ -23,6 +23,11 @@
/**
* \ingroup gui
* \brief The QgsDateTimeEdit class is a QDateTimeEdit with the capability of setting/reading null date/times.
*
* \warning You should use the signal dateTimeChanged of this subclass QgsDateTimeEdit
* rather than parent's one (QDateTimeEdit). If you consequently connect parent's
* dateTimeChanged signal and call dateTime() afterwards there is no warranty to
* have a proper NULL value handling.
*/
class GUI_EXPORT QgsDateTimeEdit : public QDateTimeEdit
{
@ -63,6 +68,12 @@ class GUI_EXPORT QgsDateTimeEdit : public QDateTimeEdit
void setEmpty();
signals:
/**
* reimplements QDateTimeEdit::dateTimeChanged signal
* to properly handles NULL values.
* @param date the new date/time value.
*/
void dateTimeChanged( const QDateTime &date );
protected: