kalarm/lib

DateEdit Class Reference

#include <dateedit.h>

Inheritance diagram for DateEdit:

KDateEdit List of all members.

Detailed Description

Date edit widget with range limits.

The DateEdit class provides a date editor with the ability to set limits on the dates which can be entered.

Minimum and/or maximum permissible dates may be set, together with corresponding error messages. If the user tries to enter a date outside the allowed range, the appropriate error message (if any) is output using KMessageBox::sorry().

Author:
David Jarvie <software@astrojar.org.uk>

Definition at line 37 of file dateedit.h.


Public Member Functions

 DateEdit (QWidget *parent=0, const char *name=0)
bool isValid () const
const QDate & minDate () const
const QDate & maxDate () const
void setMinDate (const QDate &date, const QString &errorDate=QString::null)
void setMaxDate (const QDate &date, const QString &errorDate=QString::null)
void setInvalid ()

Protected Member Functions

virtual void mousePressEvent (QMouseEvent *)
virtual void mouseReleaseEvent (QMouseEvent *)
virtual void mouseMoveEvent (QMouseEvent *)
virtual void keyPressEvent (QKeyEvent *)
virtual void keyReleaseEvent (QKeyEvent *)
virtual bool assignDate (const QDate &date)

Constructor & Destructor Documentation

DateEdit::DateEdit ( QWidget *  parent = 0,
const char *  name = 0 
)

Constructor.

Parameters:
parent The parent object of this widget.
name The name of this widget.

Definition at line 28 of file dateedit.cpp.


Member Function Documentation

bool DateEdit::isValid (  )  const [inline]

Returns true if the widget contains a valid date.

Definition at line 47 of file dateedit.h.

const QDate& DateEdit::minDate (  )  const [inline]

Returns the earliest date which can be entered.

If there is no minimum date, returns an invalid date.

Definition at line 51 of file dateedit.h.

const QDate& DateEdit::maxDate (  )  const [inline]

Returns the latest date which can be entered.

If there is no maximum date, returns an invalid date.

Definition at line 55 of file dateedit.h.

void DateEdit::setMinDate ( const QDate &  date,
const QString &  errorDate = QString::null 
)

Sets the earliest date which can be entered.

Parameters:
date Earliest date allowed. If invalid, any minimum limit is removed.
errorDate Error message to be displayed when a date earlier than date is entered. Set to QString::null to use the default error message.

Definition at line 33 of file dateedit.cpp.

void DateEdit::setMaxDate ( const QDate &  date,
const QString &  errorDate = QString::null 
)

Sets the latest date which can be entered.

Parameters:
date Latest date allowed. If invalid, any maximum limit is removed.
errorDate Error message to be displayed when a date later than date is entered. Set to QString::null to use the default error message.

Definition at line 41 of file dateedit.cpp.

void DateEdit::setInvalid (  ) 

Sets the date held in the widget to an invalid date.

Definition at line 49 of file dateedit.cpp.

bool DateEdit::assignDate ( const QDate &  date  )  [protected, virtual]

Checks whether date lies within the allowed range of values.

If so, sets the new value. If not, an error message is displayed.

Reimplemented from KDateEdit.

Definition at line 55 of file dateedit.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys