timeperiod.h

Go to the documentation of this file.

/*
 *  timeperiod.cpp  -  time period data entry widget
 *  Program:  kalarm
 *  Copyright © 2003-2005,2007,2008,2010 by David Jarvie <djarvie@kde.org>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program 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 General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with this program; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

#ifndef TIMEPERIOD_H
#define TIMEPERIOD_H

#ifdef USE_AKONADI
#include <kcalcore/duration.h>
#else
#include <kcal/duration.h>
#endif
#include <khbox.h>
#include <QString>

class QStackedWidget;
class ComboBox;
class SpinBox;
class TimeSpinBox;


class TimePeriod : public KHBox
{
        Q_OBJECT
    public:
        enum Units { Minutes, HoursMinutes, Days, Weeks };

        TimePeriod(bool allowMinute, QWidget* parent);
        bool          isReadOnly() const             { return mReadOnly; }
        virtual void  setReadOnly(bool readOnly);
        Units         units() const;
        void          setUnits(Units units);
#ifdef USE_AKONADI
        KCalCore::Duration period() const;
#else
        KCal::Duration period() const;
#endif

#ifdef USE_AKONADI
        void          setPeriod(const KCalCore::Duration& period, bool dateOnly, Units defaultUnits);
#else
        void          setPeriod(const KCal::Duration& period, bool dateOnly, Units defaultUnits);
#endif

        bool          isDateOnly() const             { return mDateOnlyOffset; }
        void          setDateOnly(bool dateOnly)     { setDateOnly(period(), dateOnly, true); }
        void          setMaximum(int hourmin, int days);
        void          setSelectOnStep(bool select);
        void          setFocusOnCount();
        void          setWhatsThises(const QString& units, const QString& dayWeek, const QString& hourMin = QString());

    signals:
#ifdef USE_AKONADI
        void            valueChanged(const KCalCore::Duration& period);
#else
        void            valueChanged(const KCal::Duration& period);
#endif

    private slots:
        void            slotUnitsSelected(int index);
        void            slotDaysChanged(int);
        void            slotTimeChanged(int minutes);

    private:
#ifdef USE_AKONADI
        Units           setDateOnly(const KCalCore::Duration&, bool dateOnly, bool signal);
#else
        Units           setDateOnly(const KCal::Duration&, bool dateOnly, bool signal);
#endif
        void            setUnitRange();
        void            showHourMin(bool hourMin);
        void            adjustDayWeekShown();

        static QString i18n_minutes();       // text of 'minutes' units, lower case
        static QString i18n_hours_mins();    // text of 'hours/minutes' units
        static QString i18n_days();          // text of 'days' units
        static QString i18n_weeks();         // text of 'weeks' units

        QStackedWidget* mSpinStack;          // displays either the days/weeks or hours:minutes spinbox
        SpinBox*        mSpinBox;            // the minutes/days/weeks value spinbox
        TimeSpinBox*    mTimeSpinBox;        // the hours:minutes value spinbox
        ComboBox*       mUnitsCombo;
        int             mMaxDays;            // maximum day count
        int             mDateOnlyOffset;     // for mUnitsCombo: 2 if minutes & hours/minutes is disabled, else 0
        Units           mMaxUnitShown;       // for mUnitsCombo: maximum units shown
        bool            mNoHourMinute;       // hours/minutes cannot be displayed, ever
        bool            mReadOnly;           // the widget is read only
        bool            mHourMinuteRaised;   // hours:minutes spinbox is currently displayed
};

#endif // TIMEPERIOD_H

// vim: et sw=4: