| -rw-r--r-- | korganizer/interfaces/korganizer/baseview.h | 192 | ||||
| -rw-r--r-- | korganizer/interfaces/korganizer/calendarviewbase.h | 65 |
2 files changed, 257 insertions, 0 deletions
diff --git a/korganizer/interfaces/korganizer/baseview.h b/korganizer/interfaces/korganizer/baseview.h new file mode 100644 index 0000000..09f8ba3 --- a/dev/null +++ b/korganizer/interfaces/korganizer/baseview.h @@ -0,0 +1,192 @@ +/* + This file is part of the KOrganizer interfaces. + Copyright (c) 1999 Cornelius Schumacher <schumacher@kde.org> + Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library 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 + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public License + along with this library; see the file COPYING.LIB. If not, write to + the Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. +*/ +#ifndef KORG_BASEVIEW_H +#define KORG_BASEVIEW_H +// $Id$ +// KOBaseView is the abstract base class of all calendar views. + +#include <qwidget.h> +#include <qptrlist.h> +#include <qvaluelist.h> + +#include <klocale.h> +#include <kdebug.h> +#include <kmessagebox.h> + +#include <libkcal/event.h> +#include <libkcal/calendar.h> + +using namespace KCal; + +class CalPrinter; + +namespace KOrg { + +class CalPrinterBase +{ + public: + enum PrintType { Day, Week, Month, Todolist }; +}; + + +/** + This class provides an interface for all views being displayed within the main + calendar view. It has functions to update the view, to specify date range and + other display parameter and to return selected objects. An important class, + which inherits KOBaseView is KOEventView, which provides the interface for all + views of event data like the agenda or the month view. + + @short Base class for calendar views + @author Preston Brown, Cornelius Schumacher + @see KOTodoView, KOEventView, KOListView, KOAgendaView, KOMonthView +*/ +class BaseView : public QWidget +{ + Q_OBJECT + public: + /** + Constructs a view. + + @param cal Pointer to the calendar object from which events + will be retrieved for display. + @param parent parent widget. + @param name name of this widget. + */ + BaseView(Calendar *cal, QWidget *parent = 0, const char *name = 0) : + QWidget(parent, name), mCalendar(cal) {} + + /** + Destructor. Views will do view-specific cleanups here. + */ + virtual ~BaseView() {} + + /** + Return calendar object of this view. + */ + Calendar *calendar() { return mCalendar; } + + /** + @return a list of selected events. Most views can probably only + select a single event at a time, but some may be able to select + more than one. + */ + virtual QPtrList<Incidence> selectedIncidences() = 0; + + /** + @return a list of the dates of selected events. Most views can probably only + select a single event at a time, but some may be able to select + more than one. + */ + virtual DateList selectedDates() = 0; + + /** + Generate a print preview of this event view. + + @param calPrinter Calendar printer object used for printing + @param fd from date + @param td to date + */ +/* + The date parameters should be determined by the view itself and not given as + parameters. At the moment I just move the code from the topwidget to the + individual views. +*/ + virtual void printPreview(CalPrinter *, + const QDate &, const QDate &) + { + KMessageBox::sorry(this, i18n("Unfortunately, we don't handle printing for\n" + "that view yet.\n")); + } + + /** + Print this view. + + @param calPrinter Calendar printer object used for printing + */ + virtual void print(CalPrinter *) + { + KMessageBox::sorry(this, i18n("Unfortunately, we don't handle printing for\n" + "that view yet.\n")); + } + + /** + Return number of currently shown dates. A return value of 0 means no idea. + */ + virtual int currentDateCount() = 0; + + /** Return if this view is a view for displaying events. */ + virtual bool isEventView() { return false; } + + public slots: + /** + Show incidences for the given date range. The date range actually shown may be + different from the requested range, depending on the particular requirements + of the view. + + @param start Start of date range. + @param end End of date range. + */ + virtual void showDates( const QDate &start, const QDate &end ) = 0; + + /** + Show given events. Depending on the actual view it might not be possible to + show all given events. + + @param eventList a list of events to show. + */ + virtual void showEvents(QPtrList<Event> eventList) = 0; + + /** + Updates the current display to reflect changes that may have happened + in the calendar since the last display refresh. + */ + virtual void updateView() = 0; + + /** + Write all unsaved data back to calendar store. + */ + virtual void flushView() {} + + /** + Updates the current display to reflect the changes to one particular event. + */ + virtual void changeEventDisplay(Event *, int) = 0; + + /** + Re-reads the KOrganizer configuration and picks up relevant + changes which are applicable to the view. + */ + virtual void updateConfig() {} + + /** + Clear selection. The incidenceSelected signal is not emitted. + */ + virtual void clearSelection() {} + + signals: + void incidenceSelected( Incidence * ); + + protected: + Calendar *mCalendar; +}; + +} +#endif diff --git a/korganizer/interfaces/korganizer/calendarviewbase.h b/korganizer/interfaces/korganizer/calendarviewbase.h new file mode 100644 index 0000000..3c715b1 --- a/dev/null +++ b/korganizer/interfaces/korganizer/calendarviewbase.h @@ -0,0 +1,65 @@ +/* + This file is part of the KOrganizer interfaces. + Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org> + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Library General Public + License as published by the Free Software Foundation; either + version 2 of the License, or (at your option) any later version. + + This library 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 + Library General Public License for more details. + + You should have received a copy of the GNU Library General Public License + along with this library; see the file COPYING.LIB. If not, write to + the Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA. +*/ +#ifndef KORG_CALENDARVIEWBASE_H +#define KORG_CALENDARVIEWBASE_H +// $Id$ + +#include <qwidget.h> +#include <qlayout.h> + + +#include <libkcal/calendar.h> + +#include <korganizer/baseview.h> + +namespace KOrg { + +/** + @short interface for main calendar view widget + @author Cornelius Schumacher +*/ +class CalendarViewBase : public QWidget +{ + Q_OBJECT + public: + CalendarViewBase(QWidget *parent, const char *name) : + QWidget(parent,name) {new QVBoxLayout(this);} + virtual ~CalendarViewBase() {}; + + virtual KCal::Calendar *calendar() = 0; + + virtual QDate startDate() = 0; + virtual QDate endDate() = 0; + + virtual Incidence *currentSelection() = 0; + + virtual void addView(KOrg::BaseView *) = 0; + + /** changes the view to be the currently selected view */ + virtual void showView(KOrg::BaseView *) = 0; + + public slots: + virtual void updateView() = 0; + +}; + +} + +#endif |