korganizer/src/koviewmanager.h

   1 /*
   2   This file is part of KOrganizer.
   3
   4   Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org>
   5   Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>
   6
   7   This program is free software; you can redistribute it and/or modify
   8   it under the terms of the GNU General Public License as published by
   9   the Free Software Foundation; either version 2 of the License, or
  10   (at your option) any later version.
  11
  12   This program is distributed in the hope that it will be useful,
  13   but WITHOUT ANY WARRANTY; without even the implied warranty of
  14   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15   GNU General Public License for more details.
  16
  17   You should have received a copy of the GNU General Public License along
  18   with this program; if not, write to the Free Software Foundation, Inc.,
  19   51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  20
  21   As a special exception, permission is given to link this program
  22   with any edition of Qt, and distribute the resulting executable,
  23   without including the source code for Qt in the source distribution.
  24 */
  25
  26 #ifndef KORG_KOVIEWMANAGER_H
  27 #define KORG_KOVIEWMANAGER_H
  28
  29 #include <EventViews/EventView>
  30
  31 #include <KCalCore/IncidenceBase> //for KCalCore::DateList typedef
  32
  33 #include <QDate>
  34 #include <QObject>
  35
  36 class CalendarView;
  37 class KOAgendaView;
  38 class KOJournalView;
  39 class KOListView;
  40 class KOTimelineView;
  41 class KOTimeSpentView;
  42 class KOTodoView;
  43 class KOWhatsNextView;
  44 namespace KOrg
  45 {
  46 class BaseView;
  47 class MultiAgendaView;
  48 class MonthView;
  49 }
  50
  51 namespace Akonadi
  52 {
  53 class Item;
  54 }
  55
  56 class KConfig;
  57 class QTabWidget;
  58
  59 /**
  60   This class manages the views of the calendar. It owns the objects and handles
  61   creation and selection.
  62 */
  63 class KOViewManager : public QObject
  64 {
  65
  66     Q_OBJECT
  67 public:
  68
  69     enum RangeMode {
  70         NO_RANGE,
  71         DAY_RANGE,
  72         WORK_WEEK_RANGE,
  73         WEEK_RANGE,
  74         NEXTX_RANGE,
  75         OTHER_RANGE // for example, showing 8 days
  76     };
  77
  78     explicit KOViewManager(CalendarView *);
  79     virtual ~KOViewManager();
  80
  81     /** changes the view to be the currently selected view */
  82     void showView(KOrg::BaseView *);
  83
  84     void readSettings(KConfig *config);
  85     void writeSettings(KConfig *config);
  86
  87     /** Read which view was shown last from config file */
  88     void readCurrentView(KConfig *config);
  89     /** Write which view is currently shown to config file */
  90     void writeCurrentView(KConfig *config);
  91
  92     KOrg::BaseView *currentView();
  93
  94     void setDocumentId(const QString &);
  95
  96     void updateView();
  97     void updateView(const QDate &start, const QDate &end, const QDate &preferredMonth);
  98
  99     void goMenu(bool enable);
 100     void raiseCurrentView();
 101
 102     void connectView(KOrg::BaseView *);
 103     void addView(KOrg::BaseView *, bool isTab = false);
 104
 105     Akonadi::Item currentSelection();
 106
 107     /**
 108      * If there's a selected incidence, it's date is returned, otherwise
 109      * an invalid QDate is returned.
 110      */
 111     QDate currentSelectionDate();
 112
 113     KOAgendaView *agendaView() const
 114     {
 115         return mAgendaView;
 116     }
 117     KOrg::MultiAgendaView *multiAgendaView() const
 118     {
 119         return mAgendaSideBySideView;
 120     }
 121     KOTodoView *todoView() const
 122     {
 123         return mTodoView;
 124     }
 125     KOrg::MonthView *monthView() const
 126     {
 127         return mMonthView;
 128     }
 129
 130     void updateMultiCalendarDisplay();
 131
 132     /**
 133      * Returns true if agenda is the current view.
 134      *
 135      * Never use the pointer returned by agendaView()
 136      * to know if agenda is selected, because agenda has other modes
 137      * (tabbed, side by side). Use this function instead.
 138      */
 139     bool agendaIsSelected() const;
 140
 141     /**
 142       Return the current range mode:
 143       week, work week, day or nextX days, etc.
 144     */
 145     RangeMode rangeMode() const
 146     {
 147         return mRangeMode;
 148     }
 149
 150 Q_SIGNALS:
 151     void configChanged();
 152     void datesSelected(const KCalCore::DateList &);
 153
 154 public Q_SLOTS:
 155     void showWhatsNextView();
 156     void showListView();
 157     void showAgendaView();
 158     void showTodoView();
 159     void showTimeLineView();
 160     void showTimeSpentView();
 161     void showMonthView();
 162     void showJournalView();
 163     void showEventView();
 164
 165     void selectDay();
 166     void selectWorkWeek();
 167     void selectWeek();
 168     void selectNextX();
 169
 170     void connectTodoView(KOTodoView *todoView);
 171
 172     void zoomInHorizontally();
 173     void zoomOutHorizontally();
 174     void zoomInVertically();
 175     void zoomOutVertically();
 176
 177     /**
 178        Notifies all views that an update is needed. This means that the
 179        next time CalendarView::updateView() is called, views won't try to be smart
 180        and ignore the update for performance reasons.
 181     */
 182     void addChange(EventViews::EventView::Change change);
 183
 184 private Q_SLOTS:
 185     void currentAgendaViewTabChanged(int index);
 186
 187 private:
 188     QWidget *widgetForView(KOrg::BaseView *) const;
 189     QList<KOrg::BaseView *> mViews;
 190     CalendarView *mMainView;
 191
 192     KOAgendaView *mAgendaView;
 193     KOrg::MultiAgendaView *mAgendaSideBySideView;
 194     KOListView *mListView;
 195     KOTodoView *mTodoView;
 196     KOWhatsNextView *mWhatsNextView;
 197     KOJournalView *mJournalView;
 198     KOTimelineView *mTimelineView;
 199     KOTimeSpentView *mTimeSpentView;
 200     KOrg::MonthView *mMonthView;
 201     KOrg::BaseView *mCurrentView;
 202
 203     KOrg::BaseView *mLastEventView;
 204     QTabWidget *mAgendaViewTabs;
 205     int mAgendaViewTabIndex;
 206
 207     RangeMode mRangeMode;
 208 };
 209
 210 #endif