libkdepim

KDateEdit Class Reference

#include <kdateedit.h>

List of all members.


Detailed Description

A date editing widget that consists of an editable combo box.

The combo box contains the date in text form, and clicking the combo box arrow will display a 'popup' style date picker.

This widget also supports advanced features like allowing the user to type in the day name to get the date. The following keywords are supported (in the native language): tomorrow, yesturday, today, monday, tuesday, wednesday, thursday, friday, saturday, sunday.

kdateedit.png

This is how it looks

Author:
Cornelius Schumacher <schumacher@kde.org>

Mike Pilone <mpilone@slac.com>

David Jarvie <software@astrojar.org.uk>

Tobias Koenig <tokoe@kde.org>

Definition at line 53 of file kdateedit.h.


Public Slots

void setDate (const QDate &date)

Signals

void dateChanged (const QDate &date)

Public Member Functions

 KDateEdit (QWidget *parent=0, const char *name=0)
virtual ~KDateEdit ()
QDate date () const
void setReadOnly (bool readOnly)
bool isReadOnly () const
virtual void popup ()

Protected Slots

void lineEnterPressed ()
void slotTextChanged (const QString &)
void dateEntered (QDate)
void dateSelected (QDate)

Protected Member Functions

virtual bool eventFilter (QObject *, QEvent *)
virtual void mousePressEvent (QMouseEvent *)
virtual bool assignDate (const QDate &date)
void setupKeywords ()

Member Function Documentation

QDate KDateEdit::date (  )  const

Returns:
The date entered.

This date could be invalid, you have to check validity yourself.

Definition at line 115 of file kdateedit.cpp.

void KDateEdit::setReadOnly ( bool  readOnly  ) 

Sets whether the widget is read-only for the user.

If read-only, the date picker pop-up is inactive, and the displayed date cannot be edited.

Parameters:
readOnly True to set the widget read-only, false to set it read-write.

Definition at line 120 of file kdateedit.cpp.

bool KDateEdit::isReadOnly (  )  const

Returns:
True if the widget is read-only, false if read-write.

Definition at line 126 of file kdateedit.cpp.

void KDateEdit::dateChanged ( const QDate &  date  )  [signal]

This signal is emitted whenever the user modifies the date.

The passed date can be invalid.

void KDateEdit::setDate ( const QDate &  date  )  [slot]

Sets the date.

Parameters:
date The new date to display. This date must be valid or it will not be set

Definition at line 109 of file kdateedit.cpp.

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

Sets the date, without altering the display.

This method is used internally to set the widget's date value. As a virtual method, it allows derived classes to perform additional validation on the date value before it is set. Derived classes should return true if QDate::isValid(date) returns false.

Parameters:
date The new date to set.
Returns:
True if the date was set, false if it was considered invalid and remains unchanged.

Definition at line 347 of file kdateedit.cpp.

void KDateEdit::setupKeywords (  )  [protected]

Fills the keyword map.

Reimplement it if you want additional keywords.

Definition at line 332 of file kdateedit.cpp.


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