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 KOViewManager;
00042 class KODialogManager;
00043 class KOTodoView;
00044 class KOEventEditor;
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();
00275     void newEvent( const QDate &startDt );
00276     void newEvent( const QDateTime &startDt );
00277     void newEvent( const QDateTime &startDt, const QDateTime &EndDt, bool allDay = false );
00282     void newEvent( const QString &summary, const QString &description = QString::null,
00283                    const QStringList &attachment = QStringList(), const QStringList &attendees = QStringList(),
00284                    const QStringList &attachmentMimetypes = QStringList(), bool inlineAttachment = false );
00285     void newFloatingEvent();
00286 
00288     void showIncidence( Incidence * );
00290     bool editIncidence( Incidence * );
00296     void deleteIncidence( Incidence *, bool force = false );
00300     void cutIncidence( Incidence * );
00304     void copyIncidence( Incidence *);
00306     void deleteSubTodosIncidence ( Todo *todo );
00312     void deleteTodoIncidence ( Todo *todo, bool force = false );
00314     bool deleteEvent( Event * ) { return true; }
00316     bool deleteTodo( Todo * ) {return true; }
00318     bool deleteJournal( Journal * ) { return true; }
00325     bool deleteIncidence( const QString &uid, bool force = false );
00326 
00328     void newTodo();
00330     void newTodo( const QDate &date );
00332     void newSubTodo();
00334     void newSubTodo( Todo * );
00335 
00336     void newTodo( const QString &summary, const QString &description = QString::null,
00337                   const QStringList &attachments = QStringList(), const QStringList &attendees = QStringList(),
00338                   const QStringList &attachmentMimetypes = QStringList(), bool inlineAttachment = false );
00339 
00340     void newJournal();
00341     void newJournal( const QDate &date );
00342     void newJournal( const QString &text, const QDate &date = QDate() );
00343 
00344     void toggleAlarm( Incidence * );
00345     void dissociateOccurrence( Incidence *, const QDate & );
00346     void dissociateFutureOccurrence( Incidence *, const QDate & );
00347 
00348 
00353     void checkClipboard();
00354 
00361     void readSettings();
00362 
00364     void writeSettings();
00365 
00367     void readFilterSettings( KConfig *config );
00368 
00370     void writeFilterSettings( KConfig *config );
00371 
00374     void changeIncidenceDisplay( Incidence *, int );
00375 
00376     void incidenceAdded( Incidence * );
00377     void incidenceChanged( Incidence *oldEvent, Incidence *newEvent );
00378     void incidenceChanged( Incidence *oldEvent, Incidence *newEvent, int what );
00379     void incidenceToBeDeleted( Incidence *incidence );
00380     void incidenceDeleted( Incidence * );
00381     void startMultiModify( const QString &text );
00382     void endMultiModify();
00383 
00384     void editCanceled( Incidence * );
00385 
00386     void updateView( const QDate &start, const QDate &end );
00387     void updateView();
00388 
00389     void updateUnmanagedViews();
00390 
00392     void edit_cut();
00393 
00395     void edit_copy();
00396 
00398     void edit_paste();
00399 
00401     void edit_options();
00402 
00407     void print();
00408 
00410     void exportWeb();
00411 
00413     void exportICalendar();
00414 
00416     void exportVCalendar();
00417 
00419     void appointment_show();
00425     void appointment_edit();
00430     void appointment_delete();
00431 
00432     /* frees a subtodo from it's relation, update the view */
00433     void todo_unsub();
00434     /* Free a subtodo from it's relation, without update the view */
00435     bool todo_unsub( Todo *todo );
00437     bool makeSubTodosIndependents ( );
00439     bool makeSubTodosIndependents ( Todo *todo );
00440 
00442     void takeOverEvent();
00443 
00445     void takeOverCalendar();
00446 
00448     bool isModified();
00450     void setModified( bool modified = true );
00451 
00453     bool isReadOnly();
00455     void setReadOnly( bool readOnly = true );
00456 
00457     void eventUpdated( Incidence * );
00458 
00459     /* iTIP scheduling actions */
00460     void schedule_publish( Incidence *incidence = 0 );
00461     void schedule_request( Incidence *incidence = 0 );
00462     void schedule_refresh( Incidence *incidence = 0 );
00463     void schedule_cancel( Incidence *incidence = 0 );
00464     void schedule_add( Incidence *incidence = 0 );
00465     void schedule_reply( Incidence *incidence = 0 );
00466     void schedule_counter( Incidence *incidence = 0 );
00467     void schedule_declinecounter( Incidence *incidence = 0 );
00468     void schedule_forward( Incidence *incidence = 0 );
00469     void mailFreeBusy( int daysToPublish = 30 );
00470     void uploadFreeBusy();
00471 
00472     void openAddressbook();
00473 
00474     void editFilters();
00475 
00476     void updateFilter();
00477 
00478     void showIntro();
00479 
00480     void showDateNavigator( bool );
00481     void showTodoView( bool );
00482     void showEventViewer( bool );
00483 
00485     void goDate( const QDate& date );
00486 
00488     void showDate( const QDate &date );
00489 
00491     void goToday();
00492 
00494     void goNext();
00495 
00497     void goPrevious();
00498 
00499     void toggleExpand();
00500     void showLeftFrame( bool show = true );
00501 
00502     void dialogClosing( Incidence * );
00503 
00504     void processMainViewSelection( Incidence * );
00505     void processTodoListSelection( Incidence * );
00506 
00507     void processIncidenceSelection( Incidence * );
00508 
00509     void purgeCompleted();
00510 
00511     void slotCalendarChanged();
00512 
00513     void slotAutoArchivingSettingsModified() { emit autoArchivingSettingsModified(); }
00514 
00515     void showErrorMessage( const QString & );
00516     void schedule( Scheduler::Method, Incidence *incidence );
00517     void addIncidenceOn( Incidence *, const QDate & );
00518     void moveIncidenceTo( Incidence *, const QDate & );
00519     void filterActivated( int filterNum );
00520   protected slots:
00522     void showDates( const KCal::DateList & );
00523 
00524   public:
00525     // show a standard warning
00526     // returns KMsgBox::yesNoCancel()
00527     int msgCalModified();
00528 
00532     void adaptNavigationUnits();
00533 
00534     //Attendee* getYourAttendee( Event *event );
00535 
00536   protected:
00537     void setIncidenceChanger( IncidenceChangerBase *changer );
00538 
00539 //     // returns KMsgBox::OKCancel()
00540     int msgItemDelete( Incidence *incidence );
00541 
00542     Todo *selectedTodo();
00543 
00544     void warningChangeFailed( Incidence * );
00545     void checkForFilteredChange( Incidence *incidence );
00549     void dateTimesForNewEvent( QDateTime &startDt, QDateTime &endDt, bool &allDay );
00550     KOEventEditor *newEventEditor( const QDateTime &startDtParam = QDateTime(),
00551          const QDateTime &endDtParam = QDateTime() , bool allDayParam = false );
00552 
00553   private:
00554     void init();
00555 
00556     void calendarModified( bool, Calendar * );
00557     // Helper function for purgeCompleted that recursively purges a todo and
00558     // its subitems. If it cannot delete a completed todo (because it has
00559     // uncompleted subitems), notAllPurged is set to true.
00560     bool purgeCompletedSubTodos( Todo* todo, bool &notAllPurged );
00561 
00562     KOrg::History *mHistory;
00563 
00564     QSplitter    *mPanner;
00565     QSplitter    *mLeftSplitter;
00566     QWidget      *mLeftFrame;
00567     QWidgetStack *mRightFrame;
00568 
00569     NavigatorBar *mNavigatorBar;
00570 
00571     DateNavigatorContainer *mDateNavigator;
00572 
00573 
00574     QPtrList<CalendarViewExtension> mExtensions;
00575 
00576     Calendar *mCalendar;
00577 
00578     DateNavigator *mNavigator;
00579     DateChecker *mDateChecker;
00580 
00581     KOEventViewer *mEventViewer;
00582     KOViewManager *mViewManager;
00583     KODialogManager *mDialogManager;
00584 
00585     // Calendar filters
00586     QPtrList<CalFilter> mFilters;
00587     CalFilter *mCurrentFilter;
00588 
00589     // various housekeeping variables.
00590     bool            mModified; // flag indicating if calendar is modified
00591     bool            mReadOnly; // flag indicating if calendar is read-only
00592     QDate mSaveSingleDate;
00593 
00594     Incidence *mSelectedIncidence;
00595 
00596     KOTodoView *mTodoList;
00597     QMap<Incidence*,KOIncidenceEditor*> mDialogList;
00598 
00599     KOrg::IncidenceChangerBase *mChanger;
00600 };
00601 
00602 
00603 
00604 
00605 #endif
KDE Home | KDE Accessibility Home | Description of Access Keys