| -rw-r--r-- | korganizer/kodaymatrix.h | 308 |
1 files changed, 308 insertions, 0 deletions
diff --git a/korganizer/kodaymatrix.h b/korganizer/kodaymatrix.h new file mode 100644 index 0000000..b4eb2a8 --- a/dev/null +++ b/korganizer/kodaymatrix.h @@ -0,0 +1,308 @@ +/* + This file is part of KOrganizer. + Copyright (c) 2001 Eitzenberger Thomas <thomas.eitzenberger@siemens.at> + + 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + + As a special exception, permission is given to link this program + with any edition of Qt, and distribute the resulting executable, + without including the source code for Qt in the source distribution. +*/ +#ifndef _KODAYMAT_H +#define _KODAYMAT_H + +#include <libkcal/calendar.h> + +#include <qstring.h> +#include <qframe.h> +#include <qcolor.h> +#include <qpen.h> +#include <qdatetime.h> +#include <qtooltip.h> + +#include <qmap.h> + +class QDragEnterEvent; +class QDragMoveEvent; +class QDragLeaveEvent; +class QDropEvent; + +class KODayMatrix; + +using namespace KCal; + + +/** + * small helper class to dynamically show tooltips inside the day matrix. + * This class asks the day matrix object for a appropriate label which + * is in our special case the name of the holiday or null if this day is no holiday. + */ +class DynamicTip : public QToolTip +{ +public: + + /** + * Constructor that expects a KODayMatrix object as parent. + * + * @param parent the parent KODayMatrix control. + */ + DynamicTip(QWidget* parent ); + +protected: + + /** + * Qt's callback to ask the object to provide an approrpiate text for the + * tooltip to be shown. + * + * @param pos coordinates of the mouse. + */ + void maybeTip( const QPoint & pos); + +private: + + /** the parent control this tooltip is designed for. */ + KODayMatrix* matrix; +}; + +/** + * replacement for kdpdatebuton.cpp that used 42 widgets for the day matrix to be displayed. + * Cornelius thought this was a waste of memory and a lot of overhead. + * In addition the selection was not very intuitive so I decided to rewrite it using a QFrame + * that draws the labels and allows for dragging selection while maintaining nearly full + * compatibility in behaviour with its predecessor. + * + * The following functionality has been changed: + * + * o when shifting events in the agenda view from one day to another the day matrix is updated now + * o TODO ET dragging an event to the matrix will MOVE not COPY the event to the new date. + * o no support for Ctrl+click to create groups of dates + * (This has not really been supported in the predecessor. It was not very intuitive nor was it + * user friendly.) + * This feature has been replaced with dragging a selection on the matrix. The matrix will + * automatically choose the appropriate selection (e.g. you are not any longer able to select + * two distinct groups of date selections as in the old class) + * o now that you can select more then a week it can happen that not all selected days are + * displayed in the matrix. However this is preferred to the alternative which would mean to + * adjust the selection and leave some days undisplayed while scrolling through the months + * + * @short day matrix widget of the KDateNavigator + * + * @author Eitzenberger Thomas + */ +class KODayMatrix: public QFrame { + + Q_OBJECT + +public: + + /** constructor to create a day matrix widget. + * + * @param parent widget that is the parent of the day matrix. Normally this should + * be a KDateNavigator + * @param calendar instance of a calendar on which all calculations are based + * @param date start date of the matrix (is expected to be already fixed). It is + * assumed that this date is the first week day to be shown in the matrix. + * @param name name of the widget + */ + KODayMatrix(QWidget *parent, Calendar* calendar, QDate date, const char *name ); + + /** destructor that deallocates all dynamically allocated private members. + */ + ~KODayMatrix(); + + /** updates the day matrix to start with the given date. Does all the necessary + * checks for holidays or events on a day and stores them for display later on. + * Does NOT update the view visually. Call repaint() for this. + * + * @param actdate recalculates the day matrix to show NUMDAYS starting from this + * date. + */ + void updateView(QDate actdate); + + /** returns the QDate object associated with day indexed by the + * supplied offset. + */ + const QDate& getDate(int offset); + + /** returns the official name of this holy day or 0 if there is no label + * for this day. + */ + QString getHolidayLabel(int offset); + + /** adds all actual selected days from mSelStart to mSelEnd to the supplied + * DateList. + */ + void addSelectedDaysTo(DateList&); + + /** sets the actual to be displayed selection in the day matrix starting from + * start and ending with end. Theview must be manually updated by calling + * repaint. (?) + */ + void setSelectedDaysFrom(const QDate& start, const QDate& end); + + + /** Is today visible in the view? Keep this in sync with + * the values today (below) can take. + */ + bool isTodayVisible() const { return today>=0; } ; + + /** If today is visible, then we can find out if today is + * near the beginning or the end of the month. + * This is dependent on today remaining the index + * in the array of visible dates and going from + * top left (0) to bottom right (41). + */ + bool isBeginningOfMonth() const { return today<=8; } ; + bool isEndOfMonth() const { return today>=27; } ; + +public slots: + /** Recalculates all the flags of the days in the matrix like holidays or events + * on a day (Actually calls above method with the actual startdate). + */ + void updateView(); + + /** + * Calculate which square in the matrix should be + * hilighted to indicate it's today. + */ + void recalculateToday(); + +/* + void setStartDate(QDate); +*/ + +signals: + + /** emitted if the user selects a block of days with the mouse by dragging a rectangle + * inside the matrix + * + * @param daylist list of days that have been selected by the user + */ + void selected( const KCal::DateList &daylist ); + + /** emitted if the user has dropped an event inside the matrix + * + * @param event the dropped calendar event + */ + void eventDropped(Event *event); + +protected: + + void paintEvent(QPaintEvent *ev); + + void mousePressEvent (QMouseEvent* e); + + void mouseReleaseEvent (QMouseEvent* e); + + void mouseMoveEvent (QMouseEvent* e); + + void dragEnterEvent(QDragEnterEvent *); + + void dragMoveEvent(QDragMoveEvent *); + + void dragLeaveEvent(QDragLeaveEvent *); + + void dropEvent(QDropEvent *); + + void resizeEvent(QResizeEvent *); + +private: + + /** returns the index of the day located at the matrix's widget (x,y) position. + * + * @param x horizontal coordinate + * @param y vertical coordinate + */ + int getDayIndexFrom(int x, int y); + + /** calculates a "shaded" color from the supplied color object. + * (Copied from Cornelius's kdpdatebutton.cpp) + * + * @param color source based on which a shaded color should be calculated. + */ + QColor getShadedColor(QColor color); + + /** number of days to be displayed. For now there is no support for any other number then 42. + so change it at your own risk :o) */ + static const int NUMDAYS; + + /** calendar instance to be queried for holidays, events, ... */ + Calendar *mCalendar; + + /** starting date of the matrix */ + QDate startdate; + + /** array of day labels to optimeize drawing performance. */ + QString *daylbls; + + /** array of days displayed to reduce memory consumption by + subsequently calling QDate::addDays(). */ + QDate *days; + + /** array of storing the number of events on a given day. + * used for drawing a bold font if there is at least one event on that day. + */ + int *events; + + /** stores holiday names of the days shown in the matrix. */ + QMap<int,QString> mHolidays; + + /** indey of today or -1 if today is not visible in the matrix. */ + int today; + + /** index of day where dragged selection was initiated. + used to detect "negative" timely selections */ + int mSelInit; + + /** if mSelStart has this value it indicates that there is no + actual selection in the matrix. */ + static const int NOSELECTION; + + /** index of first selected day. */ + int mSelStart; + + /** index of last selected day. */ + int mSelEnd; + + /** dynamic tooltip to handle mouse dependent tips for each day in the matrix. */ + DynamicTip* mToolTip; + + + /** default background colour of the matrix. */ + QColor mDefaultBackColor; + + /** default text color of the matrix. */ + QColor mDefaultTextColor; + + /** default text color for days not in the actual month. */ + QColor mDefaultTextColorShaded; + + /** default text color for holidays not in the actual month. */ + QColor mHolidayColorShaded; + + /** text color for selected days. */ + QColor mSelectedDaysColor; + + /** default width of the frame drawn around today if it is visible in the matrix. */ + int mTodayMarginWidth; + + /** stores actual size of each day in the widget so that I dont need to ask this data + * on every repaint. + */ + QRect daysize; + +}; + +#endif |