diff options
Diffstat (limited to 'kdeui/kdatepicker.h')
| -rw-r--r-- | kdeui/kdatepicker.h | 257 |
1 files changed, 0 insertions, 257 deletions
diff --git a/kdeui/kdatepicker.h b/kdeui/kdatepicker.h deleted file mode 100644 index fb51732f3..000000000 --- a/kdeui/kdatepicker.h +++ /dev/null @@ -1,257 +0,0 @@ -/* -*- C++ -*- - This file is part of the KDE libraries - Copyright (C) 1997 Tim D. Gilman (tdgilman@best.org) - (C) 1998-2001 Mirko Boehm (mirko@kde.org) - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Library General Public - License as published by the Free Software Foundation; either - version 2 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Library General Public License for more details. - - You should have received a copy of the GNU Library General Public License - along with this library; see the file COPYING.LIB. If not, write to - the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, - Boston, MA 02110-1301, USA. -*/ -#ifndef KDATEPICKER_H -#define KDATEPICKER_H -#include <tqdatetime.h> -#include <tqframe.h> -#include <kdelibs_export.h> - -class TQLineEdit; -class TQToolButton; -class KDateValidator; -class KDateTable; - -/** - * @short A date selection widget. - * - * Provides a widget for calendar date input. - * - * 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. - * - * \image html kdatepicker.png "KDE Date Widget" - * - * @version $Id$ - * @author Tim Gilman, Mirko Boehm - * - **/ -class KDEUI_EXPORT KDatePicker: public TQFrame -{ - Q_OBJECT - Q_PROPERTY( TQDate date READ date WRITE setDate) - Q_PROPERTY( bool closeButton READ hasCloseButton WRITE setCloseButton ) - Q_PROPERTY( int fontSize READ fontSize WRITE setFontSize ) - -public: - /** The usual constructor. The given date will be displayed - * initially. - **/ - KDatePicker(TQWidget *parent=0, - TQDate=TQDate::currentDate(), - const char *name=0); - - /** The usual constructor. The given date will be displayed - * initially. - * @since 3.1 - **/ - KDatePicker(TQWidget *parent, - TQDate, - const char *name, - WFlags f); // ### KDE 4.0: Merge - - /** - * Standard qt widget constructor. The initial date will be the - * current date. - * @since 3.1 - */ - KDatePicker( TQWidget *parent, const char *name ); - - /** - * The destructor. - **/ - virtual ~KDatePicker(); - - /** 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. - **/ - TQSize tqsizeHint() const; - - /** - * Sets the date. - * - * @returns @p false and does not change anything - * if the date given is invalid. - **/ - bool setDate(const TQDate&); - - /** - * Returns the selected date. - * @deprecated - **/ - const TQDate& getDate() const KDE_DEPRECATED; - - /** - * @returns the selected date. - */ - const TQDate &date() const; - - /** - * Enables or disables the widget. - **/ - void setEnabled(bool); - - /** - * @returns the KDateTable widget child of this KDatePicker - * widget. - * @since 3.2 - */ - KDateTable *dateTable() const { return table; } - - /** - * Sets the font size of the widgets elements. - **/ - void setFontSize(int); - /** - * Returns the font size of the widget elements. - */ - int fontSize() const - { return fontsize; } - - /** - * By calling this method with @p enable = true, KDatePicker will show - * a little close-button in the upper button-row. Clicking the - * close-button will cause the KDatePicker's tqtopLevelWidget()'s close() - * method being called. This is mostly useful for toplevel datepickers - * without a window manager decoration. - * @see hasCloseButton - * @since 3.1 - */ - void setCloseButton( bool enable ); - - /** - * @returns true if a KDatePicker shows a close-button. - * @see setCloseButton - * @since 3.1 - */ - bool hasCloseButton() const; - -protected: - /// to catch move keyEvents when TQLineEdit has keyFocus - virtual bool eventFilter(TQObject *o, TQEvent *e ); - /// the resize event - virtual void resizeEvent(TQResizeEvent*); - /// the year forward button - TQToolButton *yearForward; - /// the year backward button - TQToolButton *yearBackward; - /// the month forward button - TQToolButton *monthForward; - /// the month backward button - TQToolButton *monthBackward; - /// the button for selecting the month directly - TQToolButton *selectMonth; - /// the button for selecting the year directly - TQToolButton *selectYear; - /// the line edit to enter the date directly - TQLineEdit *line; - /// the validator for the line edit: - KDateValidator *val; - /// the date table - KDateTable *table; - /// the size calculated during resize events - // TQSize sizehint; - /// the widest month string in pixels: - TQSize maxMonthRect; -protected slots: - void dateChangedSlot(TQDate); - void tableClickedSlot(); - void monthForwardClicked(); - void monthBackwardClicked(); - void yearForwardClicked(); - void yearBackwardClicked(); - /** - * @since 3.1 - * @deprecated in 3.2 - */ - void selectWeekClicked(); - /** - * @since 3.1 - */ - void selectMonthClicked(); - /** - * @since 3.1 - */ - void selectYearClicked(); - /** - * @since 3.1 - */ - void lineEnterPressed(); - /** - * @since 3.2 - */ - void todayButtonClicked(); - /** - * @since 3.2 - */ - void weekSelected(int); - -signals: - // ### KDE 4.0 Make all TQDate parameters const references - - /** 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. - * @see dateSelected - */ - void dateChanged(TQDate); - /** 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. - */ - void dateSelected(TQDate); - /** 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. - */ - void dateEntered(TQDate); - /** This signal is emitted when the day has been selected by - * clicking on it in the table. - */ - void tableClicked(); - -private slots: - void ensureSelectYearIsUp(); - -private: - /// the font size for the widget - int fontsize; - -protected: - virtual void virtual_hook( int id, void* data ); -private: - void init( const TQDate &dt ); - void fillWeeksCombo(const TQDate &date); - class KDatePickerPrivate; - KDatePickerPrivate *d; -}; - -#endif // KDATEPICKER_H |