Initial revision

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