author | zautrix <zautrix> | 2004-06-26 19:01:18 (UTC) |
---|---|---|
committer | zautrix <zautrix> | 2004-06-26 19:01:18 (UTC) |
commit | b9aad1f15dc600e4dbe4c62d3fcced6363188ba3 (patch) (side-by-side diff) | |
tree | 2c3d4004fb21c72cba65793859f9bcd8ffd3a49c /korganizer/calendarview.h | |
download | kdepimpi-b9aad1f15dc600e4dbe4c62d3fcced6363188ba3.zip kdepimpi-b9aad1f15dc600e4dbe4c62d3fcced6363188ba3.tar.gz kdepimpi-b9aad1f15dc600e4dbe4c62d3fcced6363188ba3.tar.bz2 |
Initial revision
-rw-r--r-- | korganizer/calendarview.h | 586 |
1 files changed, 586 insertions, 0 deletions
diff --git a/korganizer/calendarview.h b/korganizer/calendarview.h new file mode 100644 index 0000000..e7aa351 --- a/dev/null +++ b/korganizer/calendarview.h @@ -0,0 +1,586 @@ +/* + This file is part of KOrganizer. + Copyright (c) 2000, 2001 + Cornelius Schumacher <schumacher@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., 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 CALENDARVIEW_H +#define CALENDARVIEW_H + +#include <qframe.h> +#include <qlayout.h> +#include <qwidget.h> +#include <qptrlist.h> +#include <qvbox.h> +#include <qmap.h> +#ifndef DESKTOP_VERSION +#include <qtopia/ir.h> +#else +#define Ir char +#endif +#include <libkcal/calendar.h> +#include <libkcal/scheduler.h> +#include <libkcal/calendarresources.h> +#include <libkcal/resourcecalendar.h> + +#include <korganizer/calendarviewbase.h> + +class QWidgetStack; +class QSplitter; + +class CalPrinter; +class KOFilterView; +class KOViewManager; +class KODialogManager; +class KOTodoView; +class KDateNavigator; +class DateNavigator; +class KOIncidenceEditor; +class KDatePicker; +class ResourceView; +class NavigatorBar; +class KOEventEditor; +class KOTodoEditor ; +class KOEventViewerDialog; +class KOBeamPrefs; +class KSyncProfile; +class AlarmDialog; +class KCal::Attendee; + +namespace KCal { class FileStorage; } + +using namespace KCal; + +/** + This is the main calendar widget. It provides the different vies on t he + calendar data as well as the date navigator. It also handles synchronisation + of the different views and controls the different dialogs like preferences, + event editor, search dialog etc. + + @short main calendar view widget + @author Cornelius Schumacher +*/ +class CalendarView : public KOrg::CalendarViewBase, public KCal::Calendar::Observer +{ + Q_OBJECT + public: + /** + Constructs a new calendar view widget. + + @param calendar calendar document + @param parent parent window + @param name Qt internal widget object name + */ + CalendarView( CalendarResources *calendar, QWidget *parent = 0, + const char *name = 0 ); + CalendarView( Calendar *calendar, QWidget *parent = 0, + const char *name = 0 ); + virtual ~CalendarView(); + + Calendar *calendar() { return mCalendar; } + + KOViewManager *viewManager(); + KODialogManager *dialogManager(); + + QDate startDate(); + QDate endDate(); + + QWidgetStack *viewStack(); + QWidget *leftFrame(); + NavigatorBar *navigatorBar(); + + DateNavigator *dateNavigator(); + KDateNavigator *dateNavigatorWidget(); + + void addView(KOrg::BaseView *); + void showView(KOrg::BaseView *); + KOEventViewerDialog* getEventViewerDialog(); + Incidence *currentSelection(); + + signals: + /** This todo has been modified */ + void todoModified(Todo *, int); + + /** when change is made to options dialog, the topwidget will catch this + * and emit this signal which notifies all widgets which have registered + * for notification to update their settings. */ + void configChanged(); + /** emitted when the topwidget is closing down, so that any attached + child windows can also close. */ + void closingDown(); + /** emitted right before we die */ + void closed(QWidget *); + + /** Emitted when state of modified flag changes */ + void modifiedChanged(bool); + void signalmodified(); + + /** Emitted when state of read-only flag changes */ + void readOnlyChanged(bool); + + /** Emitted when the unit of navigation changes */ + void changeNavStringPrev(const QString &); + void changeNavStringNext(const QString &); + + /** Emitted when state of events selection has changed and user is organizer*/ + void organizerEventsSelected(bool); + /** Emitted when state of events selection has changed and user is attendee*/ + void groupEventsSelected(bool); + /** + Emitted when an incidence gets selected. If the selection is cleared the + signal is emitted with 0 as argument. + */ + void incidenceSelected( Incidence * ); + /** Emitted, when a todoitem is selected or deselected. */ + void todoSelected( bool ); + + /** + Emitted, when clipboard content changes. Parameter indicates if paste + is possible or not. + */ + void pasteEnabled(bool); + + /** Emitted, when the number of incoming messages has changed. */ + void numIncomingChanged(int); + + /** Emitted, when the number of outgoing messages has changed. */ + void numOutgoingChanged(int); + + /** Send status message, which can e.g. be displayed in the status bar. */ + void statusMessage(const QString &); + + void calendarViewExpanded( bool ); + void updateSearchDialog(); + + + public slots: + + void addAlarm(const QDateTime &qdt, const QString ¬i ); + void addSuspendAlarm(const QDateTime &qdt, const QString ¬i ); + void removeAlarm(const QDateTime &qdt, const QString ¬i ); + + /** options dialog made a changed to the configuration. we catch this + * and notify all widgets which need to update their configuration. */ + void updateConfig(); + + /** + Load calendar from file \a filename. If \a merge is true, load + calendar into existing one, if it is false, clear calendar, before + loading. Return true, if calendar could be successfully loaded. + */ + bool openCalendar(QString filename, bool merge=false); + bool syncCalendar(QString filename,int mode = 0 ); + + /** + Save calendar data to file. Return true if calendar could be + successfully saved. + */ + bool saveCalendar(QString filename); + + /** + Close calendar. Clear calendar data and reset views to display an empty + calendar. + */ + void closeCalendar(); + + /** Archive old events of calendar */ + void archiveCalendar(); + + void showIncidence(); + void editIncidence(); + void editIncidenceDescription(); + void deleteIncidence(); + + /** create an editeventwin with supplied date/time, and if bool is true, + * make the event take all day. */ + void newEvent(QDateTime, QDateTime, bool allDay = false); + void newEvent(QDateTime fh); + void newEvent(QDate dt); + /** create new event without having a date hint. Takes current date as + default hint. */ + void newEvent(); + void newFloatingEvent(); + + /** Create a read-only viewer dialog for the supplied incidence. It calls the correct showXXX method*/ + void showIncidence(Incidence *); + /** Create an editor for the supplied incidence. It calls the correct editXXX method*/ + void editIncidence(Incidence *); + /** Delete the supplied incidence. It calls the correct deleteXXX method*/ + void deleteIncidence(Incidence *); + void cloneIncidence(Incidence *); + void cancelIncidence(Incidence *); + /** Create an editor for the supplied event. */ + void editEvent(Event *); + /** Delete the supplied event. */ + void deleteEvent(Event *); + /** Delete the event with the given unique ID. Returns false, if event wasn't + found. */ + bool deleteEvent(const QString &uid); + /** Create a read-only viewer dialog for the supplied event. */ + void showEvent(Event *); + + void editJournal(Journal *); + void showJournal(Journal *); + void deleteJournal(Journal *); + /** Create an editor dialog for a todo */ + void editTodo(Todo *); + /** Create a read-only viewer dialog for the supplied todo */ + void showTodo(Todo *); + /** create new todo */ + void newTodo(); + /** create new todo with a parent todo */ + void newSubTodo(); + /** create new todo with a parent todo */ + void newSubTodo(Todo *); + /** Delete todo */ + void deleteTodo(Todo *); + + + /** Check if clipboard contains vCalendar event. The signal pasteEnabled() is + * emitted as result. */ + void checkClipboard(); + + /** using the KConfig associated with the kapp variable, read in the + * settings from the config file. + */ + void readSettings(); + + /** write current state to config file. */ + void writeSettings(); + + /** read settings for calendar filters */ + void readFilterSettings(KConfig *config); + + /** write settings for calendar filters */ + void writeFilterSettings(KConfig *config); + + /** passes on the message that an event has changed to the currently + * activated view so that it can make appropriate display changes. */ + void changeEventDisplay(Event *, int); + void changeIncidenceDisplay(Incidence *, int); + void changeTodoDisplay(Todo *, int); + + void eventAdded(Event *); + void eventChanged(Event *); + void eventToBeDeleted(Event *); + void eventDeleted(); + + void todoAdded(Todo *); + void todoChanged(Todo *); + void todoToBeDeleted(Todo *); + void todoDeleted(); + + void updateView(const QDate &start, const QDate &end); + void updateView(); + + /** Full update of visible todo views */ + void updateTodoViews(); + + void updateUnmanagedViews(); + + /** cut the current appointment to the clipboard */ + void edit_cut(); + + /** copy the current appointment(s) to the clipboard */ + void edit_copy(); + + /** paste the current vobject(s) in the clipboard buffer into calendar */ + void edit_paste(); + + /** edit viewing and configuration options. */ + void edit_options(); + void edit_sync_options(); + /** + Functions for printing, previewing a print, and setting up printing + parameters. + */ + void print(); + void printSetup(); + void printPreview(); + + /** Export as iCalendar file */ + void exportICalendar(); + + /** Export as vCalendar file */ + bool exportVCalendar( QString fn); + + /** pop up a dialog to show an existing appointment. */ + void appointment_show(); + /** + * pop up an Appointment Dialog to edit an existing appointment. Get + * information on the appointment from the list of unique IDs that is + * currently in the View, called currIds. + */ + void appointment_edit(); + /** + * pop up dialog confirming deletion of currently selected event in the + * View. + */ + void appointment_delete(); + + /** mails the currently selected event to a particular user as a vCalendar + attachment. */ + void action_mail(); + + /* frees a subtodo from it's relation */ + void todo_unsub( Todo * ); + + /** Take ownership of selected event. */ + void takeOverEvent(); + + /** Take ownership of all events in calendar. */ + void takeOverCalendar(); + + /** query whether or not the calendar is "dirty". */ + bool isModified(); + /** set the state of calendar. Modified means "dirty", i.e. needing a save. */ + void setModified(bool modified=true); + + /** query if the calendar is read-only. */ + bool isReadOnly(); + /** set state of calendar to read-only */ + void setReadOnly(bool readOnly=true); + + void eventUpdated(Incidence *); + + /* iTIP scheduling actions */ + void schedule_publish(Incidence *incidence = 0); + void schedule_request(Incidence *incidence = 0); + void schedule_refresh(Incidence *incidence = 0); + void schedule_cancel(Incidence *incidence = 0); + void schedule_add(Incidence *incidence = 0); + void schedule_reply(Incidence *incidence = 0); + void schedule_counter(Incidence *incidence = 0); + void schedule_declinecounter(Incidence *incidence = 0); + void schedule_publish_freebusy(int daysToPublish = 30); + + void openAddressbook(); + + void editFilters(); + void toggleFilerEnabled(); + + void toggleFilter(); + void showFilter(bool visible); + void updateFilter(); + void filterEdited(); + void selectFilter( int ); + + void showIntro(); + + /** Move the curdatepient view date to today */ + void goToday(); + + /** Move to the next date(s) in the current view */ + void goNext(); + + /** Move to the previous date(s) in the current view */ + void goPrevious(); + /** Move to the next date(s) in the current view */ + void goNextMonth(); + + /** Move to the previous date(s) in the current view */ + void goPreviousMonth(); + + void toggleExpand(); + void toggleDateNavigatorWidget(); + void toggleAllDaySize(); + void dialogClosing(Incidence *); + + /** Look for new messages in the inbox */ + void lookForIncomingMessages(); + /** Look for new messages in the outbox */ + void lookForOutgoingMessages(); + + void processMainViewSelection( Incidence * ); + void processTodoListSelection( Incidence * ); + + void processIncidenceSelection( Incidence * ); + + void purgeCompleted(); + bool removeCompletedSubTodos( Todo* ); + void slotCalendarChanged(); + bool importBday(); + bool addAnniversary( QDate data, QString name, KCal::Attendee* a , bool birthday ); + bool importQtopia( const QString &categoriesFile, + const QString &datebookFile, + const QString &tasklistFile ); + void syncSharp( ); + void slotSelectPickerDate( QDate ) ; + void showDatePicker( ) ; + void moveIncidence(Incidence *) ; + void beamIncidence(Incidence *) ; + void beamCalendar() ; + void beamFilteredCalendar() ; + void beamIncidenceList(QPtrList<Incidence>) ; + void manageCategories(); + int addCategories(); + void removeCategories(); + void setSyncDevice( QString ); + void setSyncName( QString ); + protected slots: + void timerAlarm(); + void suspendAlarm(); + void beamDone( Ir *ir ); + /** Select a view or adapt the current view to display the specified dates. */ + void showDates( const KCal::DateList & ); + void selectWeekNum ( int ); + + public: + // show a standard warning + // returns KMsgBox::yesNoCancel() + int msgCalModified(); + void confSync(); + void setLoadedFileVersion(QDateTime); + bool checkFileVersion(QString fn); + bool checkFileChanged(QString fn); + Event* getLastSyncEvent(); + /** Adapt navigation units correpsonding to step size of navigation of the + * current view. + */ + void adaptNavigationUnits(); + bool synchronizeCalendar( Calendar* local, Calendar* remote, int mode ); + int takeEvent( Incidence* local, Incidence* remote, int mode, bool full = false ); + //Attendee* getYourAttendee(Event *event); + protected: + void schedule(Scheduler::Method, Incidence *incidence = 0); + + // returns KMsgBox::OKCandel() + int msgItemDelete(); + void showEventEditor(); + void showTodoEditor(); + void writeLocale(); + Todo *selectedTodo(); + + private: + AlarmDialog * mAlarmDialog; + QString mAlarmNotification; + QString mSuspendAlarmNotification; + QTimer* mSuspendTimer; + QTimer* mAlarmTimer; + void computeAlarm( QString ); + void startAlarm( QString, QString ); + void setSyncEventsReadOnly(); + + QDateTime loadedFileVersion; + void checkSharpEvent( Event* lastSync, Incidence* toDelete ); + QPtrList<KSyncProfile> mSyncProfiles; + QStringList mSyncProfileNames; + void checkZaurusId( int id, bool todo = false ); + int mGlobalSyncMode; + QString mCurrentSyncDevice; + QString mCurrentSyncName; + KOBeamPrefs* beamDialog; + void init(); + int mDatePickerMode; + bool mFlagEditDescription; + QDateTime mLastCalendarSync; + void createPrinter(); + + void calendarModified( bool, Calendar * ); + + CalPrinter *mCalPrinter; + + QSplitter *mPanner; + QSplitter *mLeftSplitter; + QWidget *mLeftFrame; + QWidgetStack *mRightFrame; + + KDatePicker* mDatePicker; + QVBox* mDateFrame; + NavigatorBar *mNavigatorBar; + + KDateNavigator *mDateNavigator; // widget showing small month view. + + KOFilterView *mFilterView; + + ResourceView *mResourceView; + + // calendar object for this viewing instance + Calendar *mCalendar; + + CalendarResourceManager *mResourceManager; + + FileStorage *mStorage; + + DateNavigator *mNavigator; + + KOViewManager *mViewManager; + KODialogManager *mDialogManager; + + // Calendar filters + QPtrList<CalFilter> mFilters; + + // various housekeeping variables. + bool mModified; // flag indicating if calendar is modified + bool mReadOnly; // flag indicating if calendar is read-only + QDate mSaveSingleDate; + + Incidence *mSelectedIncidence; + Incidence *mMoveIncidence; + + KOTodoView *mTodoList; + KOEventEditor * mEventEditor; + KOTodoEditor * mTodoEditor; + KOEventViewerDialog * mEventViewerDialog; + void keyPressEvent ( QKeyEvent *e) ; + //QMap<Incidence*,KOIncidenceEditor*> mDialogList; +}; + + +class CalendarViewVisitor : public Incidence::Visitor +{ + public: + CalendarViewVisitor() : mView( 0 ) {} + + bool act( Incidence *incidence, CalendarView *view ) + { + mView = view; + return incidence->accept( *this ); + } + + protected: + CalendarView *mView; +}; + +class ShowIncidenceVisitor : public CalendarViewVisitor +{ + protected: + bool visit( Event *event ) { mView->showEvent( event ); return true; } + bool visit( Todo *todo ) { mView->showTodo( todo ); return true; } + bool visit( Journal * j ) { mView->showJournal( j );return true; } +}; + +class EditIncidenceVisitor : public CalendarViewVisitor +{ + protected: + bool visit( Event *event ) { mView->editEvent( event ); return true; } + bool visit( Todo *todo ) { mView->editTodo( todo ); return true; } + bool visit( Journal *j ) { mView->editJournal( j); return true; } +}; + +class DeleteIncidenceVisitor : public CalendarViewVisitor +{ + protected: + bool visit( Event *event ) { mView->deleteEvent( event ); return true; } + bool visit( Todo *todo ) { mView->deleteTodo( todo ); return true; } + bool visit( Journal * j) {mView->deleteJournal( j ); return true; } +}; + +#endif |