timespinbox.h

/*
 *  timespinbox.h  -  time spinbox widget
 *  Program:  kalarm
 *  Copyright © 2001-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 TIMESPINBOX_H
#define TIMESPINBOX_H
 
#include <tqdatetime.h>
#include "spinbox2.h"
 
 
class TimeSpinBox : public SpinBox2
{
        TQ_OBJECT
  
    public:
        explicit TimeSpinBox(bool use24hour, TQWidget* parent = 0, const char* name = 0);
        TimeSpinBox(int minMinute, int maxMinute, TQWidget* parent = 0, const char* name = 0);
        bool            isValid() const;
        void            setValid(bool);
        TQTime           time() const;
        virtual void    setMinValue(int minutes);
        virtual void    setMaxValue(int minutes)     { SpinBox2::setMaxValue(minutes); }
        void            setMaxValue(const TQTime& t)  { SpinBox2::setMaxValue(t.hour()*60 + t.minute()); }
        TQTime           maxTime() const              { int mv = maxValue();  return TQTime(mv/60, mv%60); }
        static TQString  shiftWhatsThis();
 
        virtual TQSize   sizeHint() const;
        virtual TQSize   minimumSizeHint() const;
 
    public slots:
        virtual void    setValue(int minutes);
        void            setValue(const TQTime& t)     { setValue(t.hour()*60 + t.minute()); }
        virtual void    stepUp();
        virtual void    stepDown();
 
    protected:
        virtual TQString mapValueToText(int v);
        virtual int     mapTextToValue(bool* ok);
    private slots:
        void            slotValueChanged(int value);
    private:
        class TimeValidator;
        TimeValidator*  mValidator;
        int             mMinimumValue;       // real minimum value, excluding special value for "**:**"
        bool            m12Hour;             // use 12-hour clock
        bool            mPm;                 // use PM for manually entered values (with 12-hour clock)
        bool            mInvalid;            // value is currently invalid (asterisks)
        bool            mEnteredSetValue;    // to prevent infinite recursion in setValue()
};
 
#endif // TIMESPINBOX_H