1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
/*
* 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;
/**
* @short Time period entry widget.
*
* The TimePeriod class provides a widget for entering a time period as a number of
* weeks, days, hours and minutes, or minutes.
*
* It displays a combo box to select the time units (weeks, days, hours and minutes, or
* minutes) alongside a spin box to enter the number of units. The type of spin box
* displayed alters according to the units selection: day, week and minute values are
* entered in a normal spin box, while hours and minutes are entered in a time spin box
* (with two pairs of spin buttons, one for hours and one for minutes).
*
* The widget may be set as read-only. This has the same effect as disabling it, except
* that its appearance is unchanged.
*
* @author David Jarvie <software@astrojar.org.uk>
*/
class TimePeriod : public TQHBox
{
Q_OBJECT
TQ_OBJECT
public:
/** Units for the time period.
* @li MINUTES - the time period is entered as a number of minutes.
* @li HOURS_MINUTES - the time period is entered as an hours/minutes value.
* @li DAYS - the time period is entered as a number of days.
* @li WEEKS - the time period is entered as a number of weeks.
*/
enum Units { MINUTES, HOURS_MINUTES, DAYS, WEEKS };
/** Constructor.
* @param allowMinute Set false to prevent hours/minutes or minutes from
* being allowed as units; only days and weeks can ever be used,
* regardless of other method calls. Set true to allow minutes,
* hours/minutes, days or weeks as units.
* @param tqparent The tqparent object of this widget.
* @param name The name of this widget.
*/
TimePeriod(bool allowMinute, TQWidget* tqparent, const char* name = 0);
/** Returns true if the widget is read only. */
bool isReadOnly() const { return mReadOnly; }
/** Sets whether the widget is read-only for the user. If read-only,
* the time period cannot be edited and the units combo box is inactive.
* @param readOnly True to set the widget read-only, false to set it read-write.
*/
virtual void setReadOnly(bool readOnly);
/** Gets the entered time period expressed in minutes. */
int minutes() const;
/** Initialises the time period value.
* @param minutes The value of the time period to set, expressed as a number of minutes.
* @param dateOnly True to restrict the units available in the combo box to days or weeks.
* @param defaultUnits The units to display initially in the combo box.
*/
void setMinutes(int minutes, bool dateOnly, Units defaultUnits);
/** Enables or disables minutes and hours/minutes units in the combo box. To
* disable minutes and hours/minutes, set @p dateOnly true; to enable minutes
* and hours/minutes, set @p dateOnly false. But note that minutes and
* hours/minutes cannot be enabled if it was disallowed in the constructor.
*/
void setDateOnly(bool dateOnly) { setDateOnly(minutes(), dateOnly, true); }
/** Sets the maximum values for the minutes and hours/minutes, and days/weeks
* spin boxes.
* Set @p hourmin = 0 to leave the minutes and hours/minutes maximum unchanged.
*/
void setMaximum(int hourmin, int days);
/** Sets whether the editor text is to be selected whenever spin buttons are
* clicked. The default is to select it.
*/
void setSelectOnStep(bool select);
/** Sets the input focus to the count field. */
void setFocusOnCount();
/** Sets separate WhatsThis texts for the count spin boxes and the units combo box.
* If @p hourMin is omitted, both spin boxes are set to the same WhatsThis text.
*/
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:
/** This signal is emitted whenever the value held in the widget changes.
* @param minutes The current value of the time period, expressed in minutes.
*/
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
|