kdatetable.h

Go to the documentation of this file.

/*  -*- 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)
              (C) 2007 John Layt <john@layt.net>
    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 KDATETABLE_H
#define KDATETABLE_H

#include <kdeui_export.h>

#include <QtGui/QValidator>
#include <QtGui/QLineEdit>
#include <QtCore/QDateTime>

#include <klocale.h>

class KMenu;
class KCalendarSystem;
class KColorScheme;

class KDEUI_EXPORT KPopupFrame : public QFrame
{
    Q_OBJECT
protected:
    virtual void keyPressEvent( QKeyEvent *e );

public Q_SLOTS:
    void close( int r );

public:
    KPopupFrame( QWidget *parent = 0 );

    ~KPopupFrame();

    void setMainWidget( QWidget* m );

    virtual void resizeEvent( QResizeEvent *resize );

    void popup( const QPoint &pos );

    int exec( const QPoint &p );

    int exec( int x, int y );

Q_SIGNALS:
    void leaveModality();

private:
    class KPopupFramePrivate;
    friend class KPopupFramePrivate;
    KPopupFramePrivate * const d;

    Q_DISABLE_COPY( KPopupFrame )
};

class KDEUI_EXPORT KDateValidator : public QValidator
{
public:
    KDateValidator( QWidget *parent = 0 );
    virtual State validate( QString &text, int &e ) const;
    virtual void fixup ( QString &input ) const;
    State date( const QString &text, QDate &date ) const;
private:
    class KDateValidatorPrivate;
    friend class KDateValidatorPrivate;
    KDateValidatorPrivate * const d;
};

class KDEUI_EXPORT KDateTable : public QWidget
{
    Q_OBJECT
    Q_PROPERTY( QDate date READ date WRITE setDate )
//FIXME    Q_PROPERTY( KCalendarSystem calendar READ calendar WRITE setCalendar USER true )
    Q_PROPERTY( bool popupMenu READ popupMenuEnabled WRITE setPopupMenuEnabled )

public:
    explicit KDateTable( QWidget* parent = 0 );

    explicit KDateTable( const QDate&, QWidget *parent = 0 );

    ~KDateTable();

    virtual QSize sizeHint() const;

    void setFontSize( int size );

    bool setDate( const QDate &date );

    // KDE5 remove the const & from the returned QDate
    const QDate &date() const;

    const KCalendarSystem *calendar() const;

    bool setCalendar( KCalendarSystem *calendar = 0 );

    bool setCalendar( const QString &calendarType );

    bool setCalendarSystem( KLocale::CalendarSystem calendarSystem );

    void setPopupMenuEnabled( bool enable );

    bool popupMenuEnabled() const;

    enum BackgroundMode { NoBgMode = 0, RectangleMode, CircleMode };

    void setCustomDatePainting( const QDate &date, const QColor &fgColor, 
                                BackgroundMode bgMode = NoBgMode, const QColor &bgColor = QColor() );

    void unsetCustomDatePainting( const QDate &date );

protected:
    virtual int posFromDate( const QDate &date );

    virtual QDate dateFromPos( int pos );

    virtual void paintEvent( QPaintEvent *e );

    virtual void mousePressEvent( QMouseEvent *e );
    virtual void wheelEvent( QWheelEvent *e );
    virtual void keyPressEvent( QKeyEvent *e );
    virtual void focusInEvent( QFocusEvent *e );
    virtual void focusOutEvent( QFocusEvent *e );

    virtual bool event(QEvent *e);

Q_SIGNALS:
    void dateChanged( const QDate &date );

    void dateChanged( const QDate &cur, const QDate &old );

    void tableClicked();

    void aboutToShowContextMenu( KMenu *menu, const QDate &date );

private:
    Q_PRIVATE_SLOT( d, void nextMonth() )
    Q_PRIVATE_SLOT( d, void previousMonth() )
    Q_PRIVATE_SLOT( d, void beginningOfMonth() )
    Q_PRIVATE_SLOT( d, void endOfMonth() )
    Q_PRIVATE_SLOT( d, void beginningOfWeek() )
    Q_PRIVATE_SLOT( d, void endOfWeek() )

private:
    class KDateTablePrivate;
    friend class KDateTablePrivate;
    KDateTablePrivate * const d;

    void init( const QDate &date );
    void initAccels();
    void paintCell( QPainter *painter, int row, int col, const KColorScheme &colorScheme );

    Q_DISABLE_COPY( KDateTable )
};

#endif // KDATETABLE_H