KDatePicker Class Reference
Provides a widget for calendar date input. A date selection widget. More...
#include <kdatepicker.h>
Inheritance diagram for KDatePicker:


Signals | |
void | dateChanged (QDate) |
This signal is emitted each time the selected date is changed. | |
void | dateSelected (QDate) |
This signal is emitted each time a day has been selected by clicking on the table (hitting a day in the current month). | |
void | dateEntered (QDate) |
This signal is emitted when enter is pressed and a VALID date has been entered before into the line edit. | |
void | tableClicked () |
This signal is emitted when the day has been selected by clicking on it in the table. | |
Public Member Functions | |
KDatePicker (QWidget *parent=0, QDate=QDate::currentDate(), const char *name=0) | |
The usual constructor. | |
KDatePicker (QWidget *parent, QDate, const char *name, WFlags f) | |
The usual constructor. | |
KDatePicker (QWidget *parent, const char *name) | |
Standard qt widget constructor. | |
virtual | ~KDatePicker () |
The destructor. | |
QSize | sizeHint () const |
The size hint for date pickers. | |
bool | setDate (const QDate &) |
Sets the date. | |
const QDate & | getDate () const |
Returns the selected date. | |
const QDate & | date () const |
void | setEnabled (bool) |
Enables or disables the widget. | |
void | setFontSize (int) |
Sets the font size of the widgets elements. | |
int | fontSize () const |
Returns the font size of the widget elements. | |
void | setCloseButton (bool enable) |
By calling this method with enable = true, KDatePicker will show a little close-button in the upper button-row. | |
bool | hasCloseButton () const |
Protected Slots | |
void | dateChangedSlot (QDate) |
void | tableClickedSlot () |
void | monthForwardClicked () |
void | monthBackwardClicked () |
void | yearForwardClicked () |
void | yearBackwardClicked () |
void | selectWeekClicked () |
| |
void | selectMonthClicked () |
void | selectYearClicked () |
void | lineEnterPressed () |
Protected Member Functions | |
virtual bool | eventFilter (QObject *o, QEvent *e) |
to catch move keyEvents when QLineEdit has keyFocus | |
virtual void | resizeEvent (QResizeEvent *) |
the resize event | |
virtual void | virtual_hook (int id, void *data) |
Protected Attributes | |
QToolButton * | yearForward |
the year forward button | |
QToolButton * | yearBackward |
the year backward button | |
QToolButton * | monthForward |
the month forward button | |
QToolButton * | monthBackward |
the month backward button | |
QToolButton * | selectMonth |
the button for selecting the month directly | |
QToolButton * | selectYear |
the button for selecting the year directly | |
QLineEdit * | line |
the line edit to enter the date directly | |
KDateValidator * | val |
the validator for the line edit: | |
KDateTable * | table |
the date table | |
QSize | maxMonthRect |
the widest month string in pixels: |
Detailed Description
Provides a widget for calendar date input. A date selection widget.Different from the previous versions, it now emits two types of signals, either dateSelected() or dateEntered() (see documentation for both signals).
A line edit has been added in the newer versions to allow the user to select a date directly by entering numbers like 19990101 or 990101.

KDE Date Widget
- Version:
- Id
- kdatepicker.h,v 1.30 2002/09/28 15:16:22 tjansen Exp
- Author:
- Tim Gilman, Mirko Boehm
Definition at line 49 of file kdatepicker.h.
Constructor & Destructor Documentation
|
The usual constructor. The given date will be displayed initially. Definition at line 50 of file kdatepicker.cpp. References KStdAccel::name(). |
|
The usual constructor. The given date will be displayed initially.
Definition at line 56 of file kdatepicker.cpp. References KStdAccel::name(). |
|
Standard qt widget constructor. The initial date will be the current date.
Definition at line 62 of file kdatepicker.cpp. References QDate::currentDate(), and KStdAccel::name(). |
|
The destructor.
Definition at line 114 of file kdatepicker.cpp. |
Member Function Documentation
|
The size hint for date pickers. The size hint recommends the minimum size of the widget so that all elements may be placed without clipping. This sometimes looks ugly, so when using the size hint, try adding 28 to each of the reported numbers of pixels. Definition at line 396 of file kdatepicker.cpp. References QSize::height(), line, maxMonthRect, monthBackward, monthForward, selectMonth, selectYear, QLineEdit::sizeHint(), QWidget::sizeHint(), KDateTable::sizeHint(), QApplication::style(), table, QSize::width(), yearBackward, and yearForward. |
|
Sets the date.
Definition at line 224 of file kdatepicker.cpp. References QDate::isValid(), line, KGlobal::locale(), QDate::month(), selectMonth, selectYear, KDateTable::setDate(), QString::setNum(), QLineEdit::setText(), table, and QDate::year(). Referenced by selectWeekClicked(). |
|
Returns the selected date. This class or method is obsolete, it is provided for compatibility only. Definition at line 212 of file kdatepicker.cpp. References KDateTable::getDate(), and table. |
|
Definition at line 218 of file kdatepicker.cpp. References KDateTable::getDate(), and table. |
|
Enables or disables the widget.
Definition at line 364 of file kdatepicker.cpp. References line, monthBackward, monthForward, selectMonth, selectYear, QWidget::setEnabled(), table, yearBackward, and yearForward. |
|
Sets the font size of the widgets elements.
Definition at line 436 of file kdatepicker.cpp. References QFontMetrics::boundingRect(), QWidget::font(), QSize::height(), QRect::height(), KGlobal::locale(), maxMonthRect, selectMonth, selectYear, KDateTable::setFontSize(), QSize::setHeight(), QFont::setPointSize(), QSize::setWidth(), table, QSize::width(), and QRect::width(). |
|
Returns the font size of the widget elements.
Definition at line 123 of file kdatepicker.h. |
|
By calling this method with Clicking the close-button will cause the KDatePicker's topLevelWidget()'s close() method being called. This is mostly useful for toplevel datepickers without a window manager decoration.
Definition at line 469 of file kdatepicker.cpp. References QToolTip::add(), and KStdAccel::close(). |
|
Definition at line 489 of file kdatepicker.cpp. |
|
to catch move keyEvents when QLineEdit has keyFocus
Definition at line 120 of file kdatepicker.cpp. References QKeyEvent::key(), QApplication::sendEvent(), table, and QEvent::type(). |
|
the resize event
Reimplemented from QFrame. Definition at line 139 of file kdatepicker.cpp. References line, maxMonthRect, monthBackward, monthForward, selectMonth, selectYear, QWidget::setGeometry(), QSize::setWidth(), QLineEdit::sizeHint(), QWidget::sizeHint(), QApplication::style(), table, QSize::width(), yearBackward, and yearForward. |
|
Definition at line 267 of file kdatepicker.cpp. References QDate::addDays(), KNotifyClient::beep(), KStdAccel::close(), KPopupFrame::exec(), KDateTable::getDate(), KDateInternalWeekSelector::getWeek(), setDate(), KPopupFrame::setMainWidget(), QDate::setYMD(), QLineEdit::sizeHint(), table, and QDate::year(). |
|
This signal is emitted each time the selected date is changed. Usually, this does not mean that the date has been entered, since the date also changes, for example, when another month is selected.
|
|
This signal is emitted each time a day has been selected by clicking on the table (hitting a day in the current month). It has the same meaning as dateSelected() in older versions of KDatePicker. |
|
This signal is emitted when enter is pressed and a VALID date has been entered before into the line edit. Connect to both dateEntered() and dateSelected() to receive all events where the user really enters a date. |
|
This signal is emitted when the day has been selected by clicking on it in the table.
|
Member Data Documentation
|
the year forward button
Definition at line 150 of file kdatepicker.h. Referenced by resizeEvent(), setEnabled(), and sizeHint(). |
|
the year backward button
Definition at line 152 of file kdatepicker.h. Referenced by resizeEvent(), setEnabled(), and sizeHint(). |
|
the month forward button
Definition at line 154 of file kdatepicker.h. Referenced by resizeEvent(), setEnabled(), and sizeHint(). |
|
the month backward button
Definition at line 156 of file kdatepicker.h. Referenced by resizeEvent(), setEnabled(), and sizeHint(). |
|
the button for selecting the month directly
Definition at line 158 of file kdatepicker.h. Referenced by resizeEvent(), setDate(), setEnabled(), setFontSize(), and sizeHint(). |
|
the button for selecting the year directly
Definition at line 160 of file kdatepicker.h. Referenced by resizeEvent(), setDate(), setEnabled(), setFontSize(), and sizeHint(). |
|
the line edit to enter the date directly
Definition at line 162 of file kdatepicker.h. Referenced by resizeEvent(), setDate(), setEnabled(), and sizeHint(). |
|
the validator for the line edit:
Definition at line 164 of file kdatepicker.h. |
|
the date table
Definition at line 166 of file kdatepicker.h. Referenced by date(), eventFilter(), getDate(), resizeEvent(), selectWeekClicked(), setDate(), setEnabled(), setFontSize(), and sizeHint(). |
|
the widest month string in pixels:
Definition at line 170 of file kdatepicker.h. Referenced by resizeEvent(), setFontSize(), and sizeHint(). |
The documentation for this class was generated from the following files: