kalarm

eventlistviewbase.h
1/*
2 * eventlistviewbase.h - base classes for widget showing list of events
3 * Program: kalarm
4 * Copyright (c) 2004-2006 by David Jarvie <software@astrojar.org.uk>
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19 */
20
21#ifndef EVENTLISTVIEWBASE_H
22#define EVENTLISTVIEWBASE_H
23
24#include "kalarm.h"
25
26#include <tqvaluelist.h>
27#include <tdelistview.h>
28
29#include "alarmevent.h"
30
31class TQPixmap;
32class EventListViewItemBase;
33class Find;
34
35
36class EventListViewBase : public TDEListView
37{
38 TQ_OBJECT
39
40 public:
41 typedef TQValueList<EventListViewBase*> InstanceList;
42 typedef TQValueListIterator<EventListViewBase*> InstanceListIterator;
43 typedef TQValueListConstIterator<EventListViewBase*> InstanceListConstIterator;
44
45 EventListViewBase(TQWidget* parent = 0, const char* name = 0);
46 virtual ~EventListViewBase() { }
47 EventListViewItemBase* getEntry(const TQString& eventID) const;
48 void addEvent(const KAEvent& e) { addEvent(e, instances(), this); }
49 void modifyEvent(const KAEvent& e)
50 { modifyEvent(e.id(), e, instances(), this); }
51 void modifyEvent(const TQString& oldEventID, const KAEvent& newEvent)
52 { modifyEvent(oldEventID, newEvent, instances(), this); }
53 void deleteEvent(const TQString& eventID) { deleteEvent(eventID, instances()); }
54 static void addEvent(const KAEvent&, const InstanceList&, EventListViewBase* selectionView);
55 static void modifyEvent(const KAEvent& e, const InstanceList& list, EventListViewBase* selectionView)
56 { modifyEvent(e.id(), e, list, selectionView); }
57 static void modifyEvent(const TQString& oldEventID, const KAEvent& newEvent, const InstanceList&, EventListViewBase* selectionView);
58 static void deleteEvent(const TQString& eventID, const InstanceList&);
59 static void undeleteEvent(const TQString& oldEventID, const KAEvent& event, const InstanceList& list, EventListViewBase* selectionView)
60 { modifyEvent(oldEventID, event, list, selectionView); }
61 void resizeLastColumn();
62 int itemHeight();
63 EventListViewItemBase* currentItem() const { return (EventListViewItemBase*)TDEListView::currentItem(); }
64 EventListViewItemBase* firstChild() const { return (EventListViewItemBase*)TDEListView::firstChild(); }
65 bool anySelected() const; // are any items selected?
66 const KAEvent* selectedEvent() const;
67 EventListViewItemBase* selectedItem() const;
68 TQValueList<EventListViewItemBase*> selectedItems() const;
69 int selectedCount() const;
70 int lastColumn() const { return mLastColumn; }
71 virtual TQString whatsThisText(int column) const = 0;
72 virtual InstanceList instances() = 0; // return all instances
73
74 public slots:
75 void refresh();
76 virtual void slotFind();
77 virtual void slotFindNext() { findNext(true); }
78 virtual void slotFindPrev() { findNext(false); }
79 virtual void slotSelectAll();
80 virtual void slotDeselect();
81
82 signals:
83 void itemDeleted();
84 void findActive(bool);
85
86 protected:
87 virtual void populate() = 0; // populate the list with all desired events
88 virtual EventListViewItemBase* createItem(const KAEvent&) = 0; // only used by default addEntry() method
89 virtual bool shouldShowEvent(const KAEvent&) const { return true; }
90 EventListViewItemBase* addEntry(const KAEvent&, bool setSize = false, bool reselect = false);
91 EventListViewItemBase* addEntry(EventListViewItemBase*, bool setSize, bool reselect);
92 EventListViewItemBase* updateEntry(EventListViewItemBase*, const KAEvent& newEvent, bool setSize = false, bool reselect = false);
93 void addLastColumn(const TQString& title);
94 virtual void showEvent(TQShowEvent*);
95 virtual void resizeEvent(TQResizeEvent*);
96
97 private:
98 void deleteEntry(EventListViewItemBase*, bool setSize = false);
99 void findNext(bool forward);
100
101 Find* mFind; // alarm search object
102 int mLastColumn; // index to last column
103 int mLastColumnHeaderWidth;
104};
105
106
107class EventListViewItemBase : public TQListViewItem
108{
109 public:
110 EventListViewItemBase(EventListViewBase* parent, const KAEvent&);
111 const KAEvent& event() const { return mEvent; }
112 TQPixmap* eventIcon() const;
113 int lastColumnWidth() const { return mLastColumnWidth; }
114 EventListViewItemBase* nextSibling() const { return (EventListViewItemBase*)TQListViewItem::nextSibling(); }
115 static int iconWidth();
116
117 protected:
118 void setLastColumnText();
119 virtual TQString lastColumnText() const = 0; // get the text to display in the last column
120
121 private:
122 static TQPixmap* mTextIcon;
123 static TQPixmap* mFileIcon;
124 static TQPixmap* mCommandIcon;
125 static TQPixmap* mEmailIcon;
126 static int mIconWidth; // maximum width of any icon
127
128 KAEvent mEvent; // the event for this item
129 int mLastColumnWidth; // width required to display message column
130};
131
132#endif // EVENTLISTVIEWBASE_H
133
alarmevent.h
represents calendar alarms and events
KAEvent
KAEvent corresponds to a KCal::Event instance.
Definition: alarmevent.h:232