timeperiod.h

/*
 *  timeperiod.cpp  -  time period data entry widget
 *  Program:  kalarm
 *  Copyright © 2003,2004,2007,2008 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
 
#include <tqhbox.h>
#include <tqstring.h>
 
class TQWidgetStack;
class ComboBox;
class SpinBox;
class TimeSpinBox;
 
 
class TimePeriod : public TQHBox
{
        TQ_OBJECT
  
    public:
        enum Units { MINUTES, HOURS_MINUTES, DAYS, WEEKS };
 
        TimePeriod(bool allowMinute, TQWidget* parent, const char* name = 0);
        bool          isReadOnly() const             { return mReadOnly; }
        virtual void  setReadOnly(bool readOnly);
        int           minutes() const;
        void          setMinutes(int minutes, bool dateOnly, Units defaultUnits);
        void          setDateOnly(bool dateOnly)     { setDateOnly(minutes(), dateOnly, true); }
        void          setMaximum(int hourmin, int days);
        void          setSelectOnStep(bool select);
        void          setFocusOnCount();
        void          setWhatsThis(const TQString& units, const TQString& dayWeek, const TQString& hourMin = TQString());
 
        static TQString i18n_minutes();     // text of 'minutes' units, lower case
        static TQString i18n_Minutes();     // text of 'Minutes' units, initial capitals
        static TQString i18n_hours_mins();  // text of 'hours/minutes' units, lower case
        static TQString i18n_Hours_Mins();  // text of 'Hours/Minutes' units, initial capitals
        static TQString i18n_days();        // text of 'days' units, lower case
        static TQString i18n_Days();        // text of 'Days' units, initial capital
        static TQString i18n_weeks();       // text of 'weeks' units, lower case
        static TQString i18n_Weeks();       // text of 'Weeks' units, initial capital
 
    signals:
        void          valueChanged(int minutes);   // value has changed
 
    private slots:
        void          slotUnitsSelected(int index);
        void          slotDaysChanged(int);
        void          slotTimeChanged(int minutes);
 
    private:
        Units         setDateOnly(int minutes, bool dateOnly, bool signal);
        void          setUnitRange();
        void          showHourMin(bool hourMin);
        void          adjustDayWeekShown();
 
        TQWidgetStack* 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 are 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