summaryrefslogtreecommitdiffstats
path: root/kplato/kptcalendarpanel.h
blob: 8fc661a02e9a062dc13ab328a449a3267035f06b (plain)
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
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
/* This file is part of the KDE project
    Copyright (C) 1997 Tim D. Gilman (tdgilman@best.org)
              (C) 1998-2001 Mirko Boehm (mirko@kde.org)
              (C) 2004 Dag Andersen <danders@get2net.dk>

   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.
*/

/* This is based on KDatePicker. */

#ifndef KPTCALENDARPANEL_H
#define KPTCALENDARPANEL_H

#include "kptmap.h"

#include <tqdatetime.h>
#include <tqframe.h>

class TQLineEdit;
class TQToolButton;

namespace KPlato
{

class DateValidator;
class DateTable;
class Calendar;

/**
 * Provides a widget for calendar input.
 *
 **/
class CalendarPanel: public TQFrame
{
    TQ_OBJECT
  
    TQ_PROPERTY( TQDate date READ date WRITE setDate)
    TQ_PROPERTY( bool closeButton READ hasCloseButton WRITE setCloseButton )
    
public:
    /** The usual constructor.  The given date will be displayed
    * initially.
    **/
    CalendarPanel(TQWidget *parent=0, TQDate=TQDate::currentDate(), const char *name=0, WFlags f=0);
    
    /**
    * Standard tqt widget constructor. The initial date will be the
    * current date.
    */
    CalendarPanel( TQWidget *parent, const char *name );
    
    /**
    * The destructor.
    **/
    virtual ~CalendarPanel();
    
    /** The size hint for date pickers. The size hint recommends the
    *   minimum size of the widget so that all elements may be placed
    *  without clipping. This sometimes looks ugly, so when using the
    *  size hint, try adding 28 to each of the reported numbers of
    *  pixels.
    **/
    TQSize sizeHint() const;
    
    TQSize minimumSizeHint() const { return sizeHint(); }
    /**
    * Sets the date.
    *
    *  @returns @p false and does not change anything
    *      if the date given is invalid.
    **/
    bool setDate(const TQDate&);
    
    /**
    * Returns the selected date.
    * @deprecated
    **/
    const TQDate& getDate() const;
    
    /**
    * @returns the selected date.
    */
    const TQDate &date() const;
    
    /**
    * Enables or disables the widget.
    **/
    void setEnabled(bool);
    
    /**
    * Sets the font size of the widgets elements.
    **/
    void setFontSize(int);
    /**
    * Returns the font size of the widget elements.
    */
    int fontSize() const
        { return fontsize; }
    
    /**
    * By calling this method with @p enable = true, CalendarPanel will show
    * a little close-button in the upper button-row. Clicking the
    * close-button will cause the CalendarPanel's topLevelWidget()'s close()
    * method being called. This is mostly useful for toplevel datepickers
    * without a window manager decoration.
    * @see #hasCloseButton
    */
    void setCloseButton( bool enable );
    
    /**
    * @returns true if a CalendarPanel shows a close-button.
    * @see #setCloseButton
    */
    bool hasCloseButton() const;
    
    void setCalendar(Calendar *cal);
    
    DateMap selectedDates();
    IntMap selectedWeekdays();
    WeekMap selectedWeeks();
    
    DateMap markedDates();
    IntMap markedWeekdays();
    WeekMap markedWeeks();
    
    void clear();
    
    void markSelected(int state);
    
protected:
    /// to catch move keyEvents when TQLineEdit has keyFocus
    virtual bool eventFilter(TQObject *o, TQEvent *e );
    /// the resize event
    virtual void resizeEvent(TQResizeEvent*);
    /// the year forward button
    TQToolButton *yearForward;
    /// the year backward button
    TQToolButton *yearBackward;
    /// the month forward button
    TQToolButton *monthForward;
    /// the month backward button
    TQToolButton *monthBackward;
    /// the button for selecting the month directly
    TQToolButton *selectMonth;
    /// the button for selecting the year directly
    TQToolButton *selectYear;
    /// the line edit to enter the date directly
    TQLineEdit *line;
    /// the validator for the line edit:
    DateValidator *val;
    /// the date table
    DateTable *table;
    // the widest month string in pixels:
    TQSize maxMonthRect;

protected slots:
    void dateChangedSlot(TQDate);
    void tableClickedSlot();
    void monthForwardClicked();
    void monthBackwardClicked();
    void yearForwardClicked();
    void yearBackwardClicked();
    void selectWeekClicked();
    void selectMonthClicked();
    void selectYearClicked();
    void lineEnterPressed();
    
    void slotWeekdaySelected(int day);
    void slotWeekSelected(int week, int year);
    void slotSelectionCleared();
  
signals:
    /** This signal is emitted each time the selected date is changed.
     *  Usually, this does not mean that the date has been entered,
     *  since the date also changes, for example, when another month is
     *  selected.
     *  @see dateSelected
     */
    void dateChanged(TQDate);
    /** This signal is emitted each time a day has been selected by
     *  clicking on the table (hitting a day in the current month).
     */
    void dateSelected(TQDate);
    /** This signal is emitted when enter is pressed and a VALID date
     *  has been entered before into the line edit. Connect to both
     *  dateEntered() and dateSelected() to receive all events where the
     *  user really enters a date.
     */
    void dateEntered(TQDate);
    /** This signal is emitted when the day has been selected by
     *  clicking on it in the table.
     */
    void tableClicked();
    
    void weekSelected(int week, int year);
    void weekdaySelected(int day);
    /**
     * All selections have been cleared
     */
    void selectionCleared();
  
private:
    /// the font size for the widget
    int fontsize;
    
    bool m_selectedDays[7];
    
protected:
    virtual void virtual_hook( int id, void* data );
private:
    void init( const TQDate &dt );
    class CalendarPanelPrivate;
    CalendarPanelPrivate *d;
    // calculate ISO 8601 week number
    int weekOfYear(TQDate);
};

}  //KPlato namespace

#endif //  CALENDARPANEL_H