korganizer

calendarview.h

00001 /*
00002     This file is part of KOrganizer.
00003 
00004     Copyright (c) 2000,2001,2003,2004 Cornelius Schumacher <schumacher@kde.org>
00005     Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>
00006 
00007     This program is free software; you can redistribute it and/or modify
00008     it under the terms of the GNU General Public License as published by
00009     the Free Software Foundation; either version 2 of the License, or
00010     (at your option) any later version.
00011 
00012     This program is distributed in the hope that it will be useful,
00013     but WITHOUT ANY WARRANTY; without even the implied warranty of
00014     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
00015     GNU General Public License for more details.
00016 
00017     You should have received a copy of the GNU General Public License
00018     along with this program; if not, write to the Free Software
00019     Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
00020 
00021     As a special exception, permission is given to link this program
00022     with any edition of Qt, and distribute the resulting executable,
00023     without including the source code for Qt in the source distribution.
00024 */
00025 #ifndef CALENDARVIEW_H
00026 #define CALENDARVIEW_H
00027 
00028 #include <qwidget.h>
00029 #include <qptrlist.h>
00030 #include <qmap.h>
00031 #include <kfile.h>
00032 #include <korganizer/koeventviewer.h>
00033 #include <libkcal/scheduler.h>
00034 #include <kdepimmacros.h>
00035 
00036 #include <korganizer/calendarviewbase.h>
00037 
00038 class QWidgetStack;
00039 class QSplitter;
00040 
00041 class CalPrinter;
00042 class KOViewManager;
00043 class KODialogManager;
00044 class KOTodoView;
00045 class DateNavigatorContainer;
00046 class DateNavigator;
00047 class KOIncidenceEditor;
00048 class ResourceView;
00049 class NavigatorBar;
00050 class DateChecker;
00051 
00052 namespace KOrg { class History; class IncidenceChangerBase; }
00053 class HTMLExportSettings;
00054 
00055 using namespace KOrg;
00056 using namespace KCal;
00057 
00058 class CalendarViewExtension : public QWidget
00059 {
00060   public:
00061     CalendarViewExtension( QWidget *parent, const char *name = 0 )
00062       : QWidget( parent, name ) {}
00063 
00064     class Factory
00065     {
00066       public:
00067         virtual CalendarViewExtension *create( QWidget *parent ) = 0;
00068     };
00069 };
00070 
00080 class KDE_EXPORT CalendarView : public KOrg::CalendarViewBase, public Calendar::Observer
00081 {
00082     Q_OBJECT
00083   public:
00090     CalendarView( QWidget *parent = 0, const char *name = 0 );
00091     virtual ~CalendarView();
00092 
00093 
00094     class CalendarViewVisitor : public IncidenceBase::Visitor
00095     {
00096       public:
00097         CalendarViewVisitor() : mView( 0 ) {}
00098         bool act( IncidenceBase *incidence, CalendarView *view )
00099         {
00100           mView = view;
00101           return incidence->accept( *this );
00102         }
00103       protected:
00104         CalendarView *mView;
00105     };
00106 
00107     class CanDeleteIncidenceVisitor : public CalendarViewVisitor
00108     {
00109       protected:
00110         bool visit( Event *event ) { return mView->deleteEvent( event ); }
00111         bool visit( Todo *todo ) { return mView->deleteTodo( todo ); }
00112         bool visit( Journal *journal ) { return mView->deleteJournal( journal ); }
00113     };
00114 
00115 
00116     void setCalendar( Calendar * );
00117     Calendar *calendar();
00118 
00119     KOrg::History *history() const { return mHistory; }
00120 
00121     KOViewManager *viewManager() const { return mViewManager; }
00122     KODialogManager *dialogManager() const { return mDialogManager; }
00123 
00124     QWidgetStack *viewStack() const { return mRightFrame; }
00125     QWidget *leftFrame() const { return mLeftFrame; }
00126     NavigatorBar *navigatorBar() const { return mNavigatorBar; }
00127     DateNavigator *dateNavigator() const { return mNavigator; }
00128 
00129     KOIncidenceEditor *editorDialog( Incidence* ) const;
00130     IncidenceChangerBase *incidenceChanger() const { return mChanger; }
00131 
00132     QDate startDate();
00133     QDate endDate();
00134 
00135 
00136     void addView( KOrg::BaseView * );
00137     void showView( KOrg::BaseView * );
00138 
00143     void addExtension( CalendarViewExtension::Factory * );
00144 
00146     Incidence *currentSelection();
00149     Incidence *selectedIncidence();
00151     QString currentFilterName() const;
00152 
00153   signals:
00157     void configChanged();
00160     void categoriesChanged();
00163     void closingDown();
00165     void closed( QWidget * );
00166 
00168     void modifiedChanged( bool );
00169 
00171     void readOnlyChanged( bool );
00172 
00174     void changeNavStringPrev( const QString & );
00175     void changeNavStringNext( const QString & );
00176 
00178     void organizerEventsSelected( bool );
00180     void groupEventsSelected( bool );
00185     void incidenceSelected( Incidence * );
00188     void todoSelected( bool );
00189     void subtodoSelected( bool );
00190 
00193     void dayPassed( const QDate & );
00199     void cancelAttendees( Incidence * );
00200 
00201 
00206     void pasteEnabled( bool );
00208     void statusMessage( const QString & );
00209 
00210     void calendarViewExpanded( bool );
00211 
00213     void autoArchivingSettingsModified();
00214 
00215     void newIncidenceChanger( IncidenceChangerBase* );
00216     void exportHTML( HTMLExportSettings* );
00217 
00218     void newFilterListSignal( const QStringList & );
00219     void selectFilterSignal( int );
00220     void filterChanged();
00221     
00222   public slots:
00225     void updateConfig( const QCString& );
00228     void updateCategories();
00229 
00230 
00236     bool openCalendar( const QString &filename, bool merge = false );
00237 
00242     bool saveCalendar( const QString &filename );
00243 
00248     void closeCalendar();
00249 
00251     void archiveCalendar();
00252 
00253     void showIncidence();
00254     void editIncidence();
00255     bool editIncidence( const QString& uid );
00256     void deleteIncidence();
00257 
00266     bool addIncidence( const QString &ical );
00267 
00268     void connectIncidenceEditor( KOIncidenceEditor * );
00269 
00272     void newEvent( const QDateTime &, const QDateTime &, bool allDay = false );
00273     void newEvent( const QDateTime &fh );
00274     void newEvent( const QDate &dt );
00277     void newEvent();
00281     void newEvent( const QString & );
00282     void newEvent( const QString &summary, const QString &description,
00283                    const QString &attachment );
00284     void newEvent( const QString &summary, const QString &description,
00285                    const QString &attachment, const QStringList &attendees );
00286     void newFloatingEvent();
00287 
00289     void showIncidence( Incidence * );
00291     bool editIncidence( Incidence * );
00297     void deleteIncidence( Incidence *, bool force = false );
00301     void cutIncidence( Incidence * );
00305     void copyIncidence( Incidence *);
00307     void deleteSubTodosIncidence ( Todo *todo );
00313     void deleteTodoIncidence ( Todo *todo, bool force = false );
00315     bool deleteEvent( Event * ) { return true; }
00317     bool deleteTodo( Todo * ) {return true; }
00319     bool deleteJournal( Journal * ) { return true; }
00326     bool deleteIncidence( const QString &uid, bool force = false );
00327 
00329     void newTodo();
00331     void newTodo( const QDate &date );
00333     void newSubTodo();
00335     void newSubTodo( Todo * );
00336 
00337     void newTodo( const QString & );
00338     void newTodo( const QString &summary, const QString &description,
00339                   const QString &attachment );
00340     void newTodo( const QString &summary, const QString &description,
00341                   const QString &attachment, const QStringList &attendees );
00342 
00343     void newJournal();
00344     void newJournal( const QDate &date );
00345     void newJournal( const QString &text, const QDate &date );
00346     void newJournal( const QString &text );
00347     //TODO:
00348     // void newJournal( const QString &summary,  const QString &description,
00349     //                  const QString &attachment );
00350 
00351     void toggleAlarm( Incidence * );
00352     void dissociateOccurrence( Incidence *, const QDate & );
00353     void dissociateFutureOccurrence( Incidence *, const QDate & );
00354 
00355         
00360     void checkClipboard();
00361 
00368     void readSettings();
00369 
00371     void writeSettings();
00372 
00374     void readFilterSettings( KConfig *config );
00375 
00377     void writeFilterSettings( KConfig *config );
00378 
00381     void changeIncidenceDisplay( Incidence *, int );
00382 
00383     void incidenceAdded( Incidence * );
00384     void incidenceChanged( Incidence *oldEvent, Incidence *newEvent );
00385     void incidenceChanged( Incidence *oldEvent, Incidence *newEvent, int what );
00386     void incidenceToBeDeleted( Incidence *incidence );
00387     void incidenceDeleted( Incidence * );
00388     void startMultiModify( const QString &text );
00389     void endMultiModify();
00390 
00391     void editCanceled( Incidence * );
00392 
00393     void updateView( const QDate &start, const QDate &end );
00394     void updateView();
00395 
00396     void updateUnmanagedViews();
00397 
00399     void edit_cut();
00400 
00402     void edit_copy();
00403 
00405     void edit_paste();
00406 
00408     void edit_options();
00409 
00414     void print();
00415 
00417     void exportWeb();
00418 
00420     void exportICalendar();
00421 
00423     void exportVCalendar();
00424 
00426     void appointment_show();
00432     void appointment_edit();
00437     void appointment_delete();
00438 
00439     /* frees a subtodo from it's relation, update the view */
00440     void todo_unsub();
00441     /* Free a subtodo from it's relation, without update the view */
00442     bool todo_unsub( Todo *todo );
00444     bool makeSubTodosIndependents ( );
00446     bool makeSubTodosIndependents ( Todo *todo );
00447 
00449     void takeOverEvent();
00450 
00452     void takeOverCalendar();
00453 
00455     bool isModified();
00457     void setModified( bool modified = true );
00458 
00460     bool isReadOnly();
00462     void setReadOnly( bool readOnly = true );
00463 
00464     void eventUpdated( Incidence * );
00465 
00466     /* iTIP scheduling actions */
00467     void schedule_publish( Incidence *incidence = 0 );
00468     void schedule_request( Incidence *incidence = 0 );
00469     void schedule_refresh( Incidence *incidence = 0 );
00470     void schedule_cancel( Incidence *incidence = 0 );
00471     void schedule_add( Incidence *incidence = 0 );
00472     void schedule_reply( Incidence *incidence = 0 );
00473     void schedule_counter( Incidence *incidence = 0 );
00474     void schedule_declinecounter( Incidence *incidence = 0 );
00475     void mailFreeBusy( int daysToPublish = 30 );
00476     void uploadFreeBusy();
00477 
00478     void openAddressbook();
00479 
00480     void editFilters();
00481 
00482     void updateFilter();
00483 
00484     void showIntro();
00485     
00486     void showDateNavigator( bool );
00487     void showTodoView( bool );
00488     void showEventViewer( bool );
00489 
00491     void goDate( const QDate& date );
00492 
00494     void goToday();
00495 
00497     void goNext();
00498 
00500     void goPrevious();
00501 
00502     void toggleExpand();
00503     void showLeftFrame( bool show = true );
00504 
00505     void dialogClosing( Incidence * );
00506 
00507     void processMainViewSelection( Incidence * );
00508     void processTodoListSelection( Incidence * );
00509 
00510     void processIncidenceSelection( Incidence * );
00511 
00512     void purgeCompleted();
00513 
00514     void slotCalendarChanged();
00515 
00516     void slotAutoArchivingSettingsModified() { emit autoArchivingSettingsModified(); }
00517 
00518     void importQtopia( const QString &categoriesFile,
00519                        const QString &datebookFile,
00520                        const QString &tasklistFile );
00521 
00522     void showErrorMessage( const QString & );
00523     void schedule( Scheduler::Method, Incidence *incidence );
00524     void addIncidenceOn( Incidence *, const QDate & );
00525     void moveIncidenceTo( Incidence *, const QDate & );
00526     void filterActivated( int filterNum );
00527   protected slots:
00529     void showDates( const KCal::DateList & );
00530 
00531   public:
00532     // show a standard warning
00533     // returns KMsgBox::yesNoCancel()
00534     int msgCalModified();
00535 
00539     void adaptNavigationUnits();
00540 
00541     //Attendee* getYourAttendee( Event *event );
00542 
00543   protected:
00544     void setIncidenceChanger( IncidenceChangerBase *changer );
00545 
00546 //     // returns KMsgBox::OKCancel()
00547     int msgItemDelete( Incidence *incidence );
00548 
00549     Todo *selectedTodo();
00550 
00551     void warningChangeFailed( Incidence * );
00552     void checkForFilteredChange( Incidence *incidence );
00553 
00554   private:
00555     void init();
00556 
00557     void createPrinter();
00558 
00559     void calendarModified( bool, Calendar * );
00560     // Helper function for purgeCompleted that recursively purges a todo and
00561     // its subitems. If it cannot delete a completed todo (because it has
00562     // uncompleted subitems), notAllPurged is set to true.
00563     bool purgeCompletedSubTodos( Todo* todo, bool &notAllPurged );
00564 
00565     KOrg::History *mHistory;
00566 
00567     CalPrinter *mCalPrinter;
00568 
00569     QSplitter    *mPanner;
00570     QSplitter    *mLeftSplitter;
00571     QWidget      *mLeftFrame;
00572     QWidgetStack *mRightFrame;
00573 
00574     NavigatorBar *mNavigatorBar;
00575 
00576     DateNavigatorContainer *mDateNavigator;
00577 
00578 
00579     QPtrList<CalendarViewExtension> mExtensions;
00580 
00581     Calendar *mCalendar;
00582 
00583     DateNavigator *mNavigator;
00584     DateChecker *mDateChecker;
00585     
00586     KOEventViewer *mEventViewer;
00587     KOViewManager *mViewManager;
00588     KODialogManager *mDialogManager;
00589 
00590     // Calendar filters
00591     QPtrList<CalFilter> mFilters;
00592     CalFilter *mCurrentFilter;
00593 
00594     // various housekeeping variables.
00595     bool            mModified; // flag indicating if calendar is modified
00596     bool            mReadOnly; // flag indicating if calendar is read-only
00597     QDate mSaveSingleDate;
00598 
00599     Incidence *mSelectedIncidence;
00600 
00601     KOTodoView *mTodoList;
00602     QMap<Incidence*,KOIncidenceEditor*> mDialogList;
00603 
00604     KOrg::IncidenceChangerBase *mChanger;
00605 };
00606 
00607 
00608 
00609 
00610 #endif
KDE Home | KDE Accessibility Home | Description of Access Keys