• Skip to content
  • Skip to link menu
  • KDE API Reference
  • kdepimlibs-4.14.10 API Reference
  • KDE Home
  • Contact Us
 

KCal Library

  • kcal
calendar.h
Go to the documentation of this file.
1/*
2 This file is part of the kcal library.
3
4 Copyright (c) 1998 Preston Brown <pbrown@kde.org>
5 Copyright (c) 2001,2003,2004 Cornelius Schumacher <schumacher@kde.org>
6 Copyright (C) 2003-2004 Reinhold Kainhofer <reinhold@kainhofer.com>
7 Copyright (c) 2006 David Jarvie <software@astrojar.org.uk>
8
9 This library is free software; you can redistribute it and/or
10 modify it under the terms of the GNU Library General Public
11 License as published by the Free Software Foundation; either
12 version 2 of the License, or (at your option) any later version.
13
14 This library is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 Library General Public License for more details.
18
19 You should have received a copy of the GNU Library General Public License
20 along with this library; see the file COPYING.LIB. If not, write to
21 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
22 Boston, MA 02110-1301, USA.
23*/
34
35#ifndef KCAL_CALENDAR_H
36#define KCAL_CALENDAR_H
37
38#include <QtCore/QObject>
39#include <QtCore/QString>
40#include <QtCore/QList>
41#include <QtCore/QMultiHash>
42
43#include <kdatetime.h>
44
45#include "customproperties.h"
46#include "event.h"
47#include "todo.h"
48#include "journal.h"
49#include "kcalversion.h"
50
51namespace KCal {
52
53class ICalTimeZone;
54class ICalTimeZones;
55class CalFilter;
56class Person;
57
61enum SortDirection {
62 SortDirectionAscending,
63 SortDirectionDescending
64};
65
69enum EventSortField {
70 EventSortUnsorted,
71 EventSortStartDate,
72 EventSortEndDate,
73 EventSortSummary
74};
75
79enum TodoSortField {
80 TodoSortUnsorted,
81 TodoSortStartDate,
82 TodoSortDueDate,
83 TodoSortPriority,
84 TodoSortPercentComplete,
85 TodoSortSummary
86};
87
91enum JournalSortField {
92 JournalSortUnsorted,
93 JournalSortDate,
94 JournalSortSummary
95};
96
119class KCAL_DEPRECATED_EXPORT Calendar : public QObject, public CustomProperties,
120 public IncidenceBase::IncidenceObserver
121{
122 Q_OBJECT
123
124 public:
125
136 explicit Calendar( const KDateTime::Spec &timeSpec );
137
151 explicit Calendar( const QString &timeZoneId );
152
156 virtual ~Calendar();
157
165 void setProductId( const QString &id );
166
172 QString productId() const;
173
181 void setOwner( const Person &owner );
182
190 Person owner() const;
191
200 void setTimeSpec( const KDateTime::Spec &timeSpec );
201
208 KDateTime::Spec timeSpec() const;
209
223 void setTimeZoneId( const QString &timeZoneId );
224
232 QString timeZoneId() const;
233
248 void setViewTimeSpec( const KDateTime::Spec &timeSpec ) const;
249
268 void setViewTimeZoneId( const QString &timeZoneId ) const;
269
276 KDateTime::Spec viewTimeSpec() const;
277
284 QString viewTimeZoneId() const;
285
302 void shiftTimes( const KDateTime::Spec &oldSpec, const KDateTime::Spec &newSpec );
303
311 ICalTimeZones *timeZones() const;
312
319 void setTimeZones( const ICalTimeZones &zones );
320
329 void setModified( bool modified );
330
338 bool isModified() const;
339
343 virtual void close() = 0;
344
350 virtual bool save() = 0;
351
358 virtual bool reload() = 0;
359
365 virtual bool isSaving();
366
372 QStringList categories();
373
374 // Incidence Specific Methods //
375
385 virtual bool addIncidence( Incidence *incidence );
386
396 virtual bool deleteIncidence( Incidence *incidence );
397
403 virtual Incidence::List incidences();
404
412 virtual Incidence::List incidences( const QDate &date );
413
419 virtual Incidence::List rawIncidences();
420
429 Incidence *incidence( const QString &uid );
430
439 Incidence *incidenceFromSchedulingID( const QString &sid );
440
447 Incidence::List incidencesFromSchedulingID( const QString &sid );
448
458 static Incidence::List mergeIncidenceList( const Event::List &events,
459 const Todo::List &todos,
460 const Journal::List &journals );
461
467 virtual bool beginChange( Incidence *incidence );
468
474 virtual bool endChange( Incidence *incidence );
475
493 Incidence *dissociateOccurrence( Incidence *incidence, const QDate &date,
494 const KDateTime::Spec &spec,
495 bool single = true );
496
497 // Event Specific Methods //
498
508 virtual bool addEvent( Event *event ) = 0;
509
519 virtual bool deleteEvent( Event *event ) = 0;
520
525 virtual void deleteAllEvents() = 0;
526
536 static Event::List sortEvents( Event::List *eventList,
537 EventSortField sortField,
538 SortDirection sortDirection );
539
553 static Event::List sortEventsForDate( Event::List *eventList,
554 const QDate &date,
555 const KDateTime::Spec &timeSpec,
556 EventSortField sortField,
557 SortDirection sortDirection );
558
567 virtual Event::List events(
568 EventSortField sortField = EventSortUnsorted,
569 SortDirection sortDirection = SortDirectionAscending );
570
578 Event::List events( const KDateTime &dt );
579
593 Event::List events( const QDate &start, const QDate &end,
594 const KDateTime::Spec &timeSpec = KDateTime::Spec(),
595 bool inclusive = false );
596
610 Event::List events(
611 const QDate &date,
612 const KDateTime::Spec &timeSpec = KDateTime::Spec(),
613 EventSortField sortField = EventSortUnsorted,
614 SortDirection sortDirection = SortDirectionAscending );
615
624 virtual Event::List rawEvents(
625 EventSortField sortField = EventSortUnsorted,
626 SortDirection sortDirection = SortDirectionAscending ) = 0;
627
637 virtual Event::List rawEventsForDate( const KDateTime &dt ) = 0;
638
652 virtual Event::List rawEvents( const QDate &start, const QDate &end,
653 const KDateTime::Spec &timeSpec = KDateTime::Spec(),
654 bool inclusive = false ) = 0;
655
669 virtual Event::List rawEventsForDate(
670 const QDate &date, const KDateTime::Spec &timeSpec = KDateTime::Spec(),
671 EventSortField sortField = EventSortUnsorted,
672 SortDirection sortDirection = SortDirectionAscending ) = 0;
673
682 virtual Event *event( const QString &uid ) = 0;
683
684 // Todo Specific Methods //
685
695 virtual bool addTodo( Todo *todo ) = 0;
696
706 virtual bool deleteTodo( Todo *todo ) = 0;
707
712 virtual void deleteAllTodos() = 0;
713
723 static Todo::List sortTodos( Todo::List *todoList,
724 TodoSortField sortField,
725 SortDirection sortDirection );
726
735 virtual Todo::List todos(
736 TodoSortField sortField = TodoSortUnsorted,
737 SortDirection sortDirection = SortDirectionAscending );
738
746 virtual Todo::List todos( const QDate &date );
747
756 virtual Todo::List rawTodos(
757 TodoSortField sortField = TodoSortUnsorted,
758 SortDirection sortDirection = SortDirectionAscending ) = 0;
759
767 virtual Todo::List rawTodosForDate( const QDate &date ) = 0;
768
777 virtual Todo *todo( const QString &uid ) = 0;
778
779 // Journal Specific Methods //
780
790 virtual bool addJournal( Journal *journal ) = 0;
791
801 virtual bool deleteJournal( Journal *journal ) = 0;
802
807 virtual void deleteAllJournals() = 0;
808
818 static Journal::List sortJournals( Journal::List *journalList,
819 JournalSortField sortField,
820 SortDirection sortDirection );
829 virtual Journal::List journals(
830 JournalSortField sortField = JournalSortUnsorted,
831 SortDirection sortDirection = SortDirectionAscending );
832
840 virtual Journal::List journals( const QDate &date );
841
850 virtual Journal::List rawJournals(
851 JournalSortField sortField = JournalSortUnsorted,
852 SortDirection sortDirection = SortDirectionAscending ) = 0;
853
861 virtual Journal::List rawJournalsForDate( const QDate &date ) = 0;
862
871 virtual Journal *journal( const QString &uid ) = 0;
872
885 void beginBatchAdding();
886
895 void endBatchAdding();
896
897 // Relations Specific Methods //
898
905 virtual void setupRelations( Incidence *incidence );
906
913 virtual void removeRelations( Incidence *incidence );
914
921 bool isAncestorOf( Incidence *ancestor, Incidence *incidence );
922
923 // Filter Specific Methods //
924
934 void setFilter( CalFilter *filter );
935
944 CalFilter *filter();
945
946 // Alarm Specific Methods //
947
956 virtual Alarm::List alarms( const KDateTime &from,
957 const KDateTime &to ) = 0;
958
959 // Observer Specific Methods //
960
966 class KCAL_DEPRECATED_EXPORT CalendarObserver //krazy:exclude=dpointer
967 {
968 public:
972 virtual ~CalendarObserver() {}
973
981 virtual void calendarModified( bool modified, Calendar *calendar );
982
988 virtual void calendarIncidenceAdded( Incidence *incidence );
989
995 virtual void calendarIncidenceChanged( Incidence *incidence );
996
1002 virtual void calendarIncidenceDeleted( Incidence *incidence );
1003 };
1004
1013 void registerObserver( CalendarObserver *observer );
1014
1023 void unregisterObserver( CalendarObserver *observer );
1024
1025 using QObject::event; // prevent warning about hidden virtual method
1026
1027 Q_SIGNALS:
1031 void calendarChanged();
1032
1036 void calendarSaved();
1037
1041 void calendarLoaded();
1042
1047 void batchAddingBegins();
1048
1053 void batchAddingEnds();
1054
1055 protected:
1061 void incidenceUpdated( IncidenceBase *incidenceBase );
1062
1069 virtual void doSetTimeSpec( const KDateTime::Spec &timeSpec );
1070
1076 void notifyIncidenceAdded( Incidence *incidence );
1077
1083 void notifyIncidenceChanged( Incidence *incidence );
1084
1090 void notifyIncidenceDeleted( Incidence *incidence );
1091
1096 virtual void customPropertyUpdated();
1097
1104 void setObserversEnabled( bool enabled );
1105
1115 void appendAlarms( Alarm::List &alarms, Incidence *incidence,
1116 const KDateTime &from, const KDateTime &to );
1117
1127 void appendRecurringAlarms( Alarm::List &alarms, Incidence *incidence,
1128 const KDateTime &from, const KDateTime &to );
1129
1130 private:
1131 //@cond PRIVATE
1132 class Private;
1133 Private *const d;
1134 //@endcond
1135
1136 Q_DISABLE_COPY( Calendar )
1137};
1138
1139}
1140
1141#endif
KCal::TodoSortField
TodoSortField
Calendar Todo sort keys.
Definition calendar.h:79
KCal::TodoSortSummary
@ TodoSortSummary
Sort Todos alphabetically, by summary.
Definition calendar.h:85
KCal::TodoSortDueDate
@ TodoSortDueDate
Sort Todos chronologically, by due date.
Definition calendar.h:82
KCal::TodoSortPriority
@ TodoSortPriority
Sort Todos by priority.
Definition calendar.h:83
KCal::TodoSortPercentComplete
@ TodoSortPercentComplete
Sort Todos by percentage completed.
Definition calendar.h:84
KCal::TodoSortStartDate
@ TodoSortStartDate
Sort Todos chronologically, by start date.
Definition calendar.h:81
KCal::TodoSortUnsorted
@ TodoSortUnsorted
Do not sort Todos.
Definition calendar.h:80
KCal::JournalSortField
JournalSortField
Calendar Journal sort keys.
Definition calendar.h:91
KCal::JournalSortUnsorted
@ JournalSortUnsorted
Do not sort Journals.
Definition calendar.h:92
KCal::JournalSortDate
@ JournalSortDate
Sort Journals chronologically by date.
Definition calendar.h:93
KCal::JournalSortSummary
@ JournalSortSummary
Sort Journals alphabetically, by summary.
Definition calendar.h:94
KCal::EventSortField
EventSortField
Calendar Event sort keys.
Definition calendar.h:69
KCal::EventSortUnsorted
@ EventSortUnsorted
Do not sort Events.
Definition calendar.h:70
KCal::EventSortEndDate
@ EventSortEndDate
Sort Events chronologically, by end date.
Definition calendar.h:72
KCal::EventSortSummary
@ EventSortSummary
Sort Events alphabetically, by summary.
Definition calendar.h:73
KCal::EventSortStartDate
@ EventSortStartDate
Sort Events chronologically, by start date.
Definition calendar.h:71
KCal::SortDirection
SortDirection
Calendar Incidence sort directions.
Definition calendar.h:61
KCal::SortDirectionAscending
@ SortDirectionAscending
Sort in ascending order (first to last)
Definition calendar.h:62
KCal::SortDirectionDescending
@ SortDirectionDescending
Sort in descending order (last to first)
Definition calendar.h:63
KCal::Alarm::List
ListBase< Alarm > List
List of alarms.
Definition alarm.h:83
KCal::CalFilter
Provides a filter for calendars.
Definition calfilter.h:58
KCal::Calendar::CalendarObserver
The CalendarObserver class.
Definition calendar.h:967
KCal::Calendar::CalendarObserver::~CalendarObserver
virtual ~CalendarObserver()
Destructor.
Definition calendar.h:972
KCal::Calendar::setTimeZoneId
void setTimeZoneId(const QString &timeZoneId)
Sets the time zone ID used for creating or modifying incidences in the Calendar.
Definition calendar.cpp:150
KCal::Calendar::setViewTimeZoneId
void setViewTimeZoneId(const QString &timeZoneId) const
Notes the time zone Id which the client application intends to use for viewing the incidences in this...
Definition calendar.cpp:201
KCal::Calendar::sortTodos
static Todo::List sortTodos(Todo::List *todoList, TodoSortField sortField, SortDirection sortDirection)
Sort a list of Todos.
Definition calendar.cpp:712
KCal::Calendar::calendarLoaded
void calendarLoaded()
Signals that the calendar has been loaded into memory.
KCal::Calendar::reload
virtual bool reload()=0
Loads the calendar contents from storage.
KCal::Calendar::rawTodosForDate
virtual Todo::List rawTodosForDate(const QDate &date)=0
Returns an unfiltered list of all Todos which due on the specified date.
KCal::Calendar::appendRecurringAlarms
void appendRecurringAlarms(Alarm::List &alarms, Incidence *incidence, const KDateTime &from, const KDateTime &to)
Appends alarms of recurring events in interval to list of alarms.
Definition calendar.cpp:1263
KCal::Calendar::rawJournals
virtual Journal::List rawJournals(JournalSortField sortField=JournalSortUnsorted, SortDirection sortDirection=SortDirectionAscending)=0
Returns a sorted, unfiltered list of all Journals for this Calendar.
KCal::Calendar::addJournal
virtual bool addJournal(Journal *journal)=0
Inserts a Journal into the calendar.
KCal::Calendar::isSaving
virtual bool isSaving()
Determine if the calendar is currently being saved.
Definition calendar.cpp:1120
KCal::Calendar::setTimeSpec
void setTimeSpec(const KDateTime::Spec &timeSpec)
Sets the default time specification (time zone, etc.) used for creating or modifying incidences in th...
Definition calendar.cpp:136
KCal::Calendar::appendAlarms
void appendAlarms(Alarm::List &alarms, Incidence *incidence, const KDateTime &from, const KDateTime &to)
Appends alarms of incidence in interval to list of alarms.
Definition calendar.cpp:1246
KCal::Calendar::deleteAllTodos
virtual void deleteAllTodos()=0
Removes all To-dos from the calendar.
KCal::Calendar::addIncidence
virtual bool addIncidence(Incidence *incidence)
Inserts an Incidence into the calendar.
Definition calendar.cpp:573
KCal::Calendar::event
virtual Event * event(const QString &uid)=0
Returns the Event associated with the given unique identifier.
KCal::Calendar::beginChange
virtual bool beginChange(Incidence *incidence)
Flag that a change to a Calendar Incidence is starting.
Definition calendar.cpp:1229
KCal::Calendar::save
virtual bool save()=0
Syncs changes in memory to persistent storage.
KCal::Calendar::rawIncidences
virtual Incidence::List rawIncidences()
Returns an unfiltered list of all Incidences for this Calendar.
Definition calendar.cpp:287
KCal::Calendar::incidenceUpdated
void incidenceUpdated(IncidenceBase *incidenceBase)
The Observer interface.
Definition calendar.cpp:1141
KCal::Calendar::viewTimeZoneId
QString viewTimeZoneId() const
Returns the time zone Id used for viewing the incidences in this calendar.
Definition calendar.cpp:211
KCal::Calendar::timeZones
ICalTimeZones * timeZones() const
Returns the time zone collection used by the calendar.
Definition calendar.cpp:217
KCal::Calendar::incidences
virtual Incidence::List incidences()
Returns a filtered list of all Incidences for this Calendar.
Definition calendar.cpp:282
KCal::Calendar::mergeIncidenceList
static Incidence::List mergeIncidenceList(const Event::List &events, const Todo::List &todos, const Journal::List &journals)
Create a merged list of Events, Todos, and Journals.
Definition calendar.cpp:1207
KCal::Calendar::setupRelations
virtual void setupRelations(Incidence *incidence)
Setup Relations for an Incidence.
Definition calendar.cpp:951
KCal::Calendar::calendarSaved
void calendarSaved()
Signals that the calendar has been saved.
KCal::Calendar::dissociateOccurrence
Incidence * dissociateOccurrence(Incidence *incidence, const QDate &date, const KDateTime::Spec &spec, bool single=true)
Dissociate an Incidence from a recurring Incidence.
Definition calendar.cpp:595
KCal::Calendar::notifyIncidenceDeleted
void notifyIncidenceDeleted(Incidence *incidence)
Let Calendar subclasses notify that they removed an Incidence.
Definition calendar.cpp:1181
KCal::Calendar::setFilter
void setFilter(CalFilter *filter)
Sets the calendar filter.
Definition calendar.cpp:244
KCal::Calendar::rawEventsForDate
virtual Event::List rawEventsForDate(const QDate &date, const KDateTime::Spec &timeSpec=KDateTime::Spec(), EventSortField sortField=EventSortUnsorted, SortDirection sortDirection=SortDirectionAscending)=0
Returns a sorted, unfiltered list of all Events which occur on the given date.
KCal::Calendar::deleteIncidence
virtual bool deleteIncidence(Incidence *incidence)
Removes an Incidence from the calendar.
Definition calendar.cpp:580
KCal::Calendar::sortEvents
static Event::List sortEvents(Event::List *eventList, EventSortField sortField, SortDirection sortDirection)
Sort a list of Events.
Definition calendar.cpp:292
KCal::Calendar::addEvent
virtual bool addEvent(Event *event)=0
Inserts an Event into the calendar.
KCal::Calendar::rawEventsForDate
virtual Event::List rawEventsForDate(const KDateTime &dt)=0
Returns an unfiltered list of all Events which occur on the given timestamp.
KCal::Calendar::categories
QStringList categories()
Returns a list of all categories used by Incidences in this Calendar.
Definition calendar.cpp:258
KCal::Calendar::Calendar
Calendar(const KDateTime::Spec &timeSpec)
Constructs a calendar with a specified time zone timeZoneid.
Definition calendar.cpp:106
KCal::Calendar::notifyIncidenceChanged
void notifyIncidenceChanged(Incidence *incidence)
Let Calendar subclasses notify that they modified an Incidence.
Definition calendar.cpp:1170
KCal::Calendar::isModified
bool isModified() const
Determine the calendar's modification status.
Definition calendar.cpp:1136
KCal::Calendar::addTodo
virtual bool addTodo(Todo *todo)=0
Inserts a Todo into the calendar.
KCal::Calendar::doSetTimeSpec
virtual void doSetTimeSpec(const KDateTime::Spec &timeSpec)
Let Calendar subclasses set the time specification.
Definition calendar.cpp:1154
KCal::Calendar::customPropertyUpdated
virtual void customPropertyUpdated()
Definition calendar.cpp:1192
KCal::Calendar::viewTimeSpec
KDateTime::Spec viewTimeSpec() const
Returns the time specification used for viewing the incidences in this calendar.
Definition calendar.cpp:206
KCal::Calendar::setModified
void setModified(bool modified)
Sets if the calendar has been modified.
Definition calendar.cpp:1125
KCal::Calendar::removeRelations
virtual void removeRelations(Incidence *incidence)
Removes all Relations from an Incidence.
Definition calendar.cpp:997
KCal::Calendar::setProductId
void setProductId(const QString &id)
Sets the calendar Product ID to id.
Definition calendar.cpp:1197
KCal::Calendar::filter
CalFilter * filter()
Returns the calendar filter.
Definition calendar.cpp:253
KCal::Calendar::todo
virtual Todo * todo(const QString &uid)=0
Returns the Todo associated with the given unique identifier.
KCal::Calendar::timeZoneId
QString timeZoneId() const
Returns the time zone ID used for creating or modifying incidences in the calendar.
Definition calendar.cpp:189
KCal::Calendar::endChange
virtual bool endChange(Incidence *incidence)
Flag that a change to a Calendar Incidence has completed.
Definition calendar.cpp:1235
KCal::Calendar::shiftTimes
void shiftTimes(const KDateTime::Spec &oldSpec, const KDateTime::Spec &newSpec)
Shifts the times of all incidences so that they appear at the same clock time as before but in a new ...
Definition calendar.cpp:222
KCal::Calendar::sortEventsForDate
static Event::List sortEventsForDate(Event::List *eventList, const QDate &date, const KDateTime::Spec &timeSpec, EventSortField sortField, SortDirection sortDirection)
Sort a list of Events that occur on a specified date.
Definition calendar.cpp:395
KCal::Calendar::rawEvents
virtual Event::List rawEvents(const QDate &start, const QDate &end, const KDateTime::Spec &timeSpec=KDateTime::Spec(), bool inclusive=false)=0
Returns an unfiltered list of all Events occurring within a date range.
KCal::Calendar::deleteAllEvents
virtual void deleteAllEvents()=0
Removes all Events from the calendar.
KCal::Calendar::deleteEvent
virtual bool deleteEvent(Event *event)=0
Removes an Event from the calendar.
KCal::Calendar::setOwner
void setOwner(const Person &owner)
Sets the owner of the calendar to owner.
Definition calendar.cpp:129
KCal::Calendar::calendarChanged
void calendarChanged()
Signals that the calendar has been modified.
KCal::Calendar::setObserversEnabled
void setObserversEnabled(bool enabled)
Let Calendar subclasses notify that they enabled an Observer.
Definition calendar.cpp:1241
KCal::Calendar::rawEvents
virtual Event::List rawEvents(EventSortField sortField=EventSortUnsorted, SortDirection sortDirection=SortDirectionAscending)=0
Returns a sorted, unfiltered list of all Events for this Calendar.
KCal::Calendar::journal
virtual Journal * journal(const QString &uid)=0
Returns the Journal associated with the given unique identifier.
KCal::Calendar::events
virtual Event::List events(EventSortField sortField=EventSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Returns a sorted, filtered list of all Events for this Calendar.
Definition calendar.cpp:565
KCal::Calendar::incidencesFromSchedulingID
Incidence::List incidencesFromSchedulingID(const QString &sid)
Searches all events and todos for an incidence with this scheduling identifiere.
Definition calendar.cpp:685
KCal::Calendar::notifyIncidenceAdded
void notifyIncidenceAdded(Incidence *incidence)
Let Calendar subclasses notify that they inserted an Incidence.
Definition calendar.cpp:1159
KCal::Calendar::deleteTodo
virtual bool deleteTodo(Todo *todo)=0
Removes a Todo from the calendar.
KCal::Calendar::deleteJournal
virtual bool deleteJournal(Journal *journal)=0
Removes a Journal from the calendar.
KCal::Calendar::setViewTimeSpec
void setViewTimeSpec(const KDateTime::Spec &timeSpec) const
Notes the time specification which the client application intends to use for viewing the incidences i...
Definition calendar.cpp:195
KCal::Calendar::journals
virtual Journal::List journals(JournalSortField sortField=JournalSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Returns a sorted, filtered list of all Journals for this Calendar.
Definition calendar.cpp:924
KCal::Calendar::rawTodos
virtual Todo::List rawTodos(TodoSortField sortField=TodoSortUnsorted, SortDirection sortDirection=SortDirectionAscending)=0
Returns a sorted, unfiltered list of all Todos for this Calendar.
KCal::Calendar::batchAddingEnds
void batchAddingEnds()
KCal::Calendar::incidenceFromSchedulingID
Incidence * incidenceFromSchedulingID(const QString &sid)
Returns the Incidence associated with the given scheduling identifier.
Definition calendar.cpp:698
KCal::Calendar::beginBatchAdding
void beginBatchAdding()
Emits the beginBatchAdding() signal.
Definition calendar.cpp:939
KCal::Calendar::deleteAllJournals
virtual void deleteAllJournals()=0
Removes all Journals from the calendar.
KCal::Calendar::incidence
Incidence * incidence(const QString &uid)
Returns the Incidence associated with the given unique identifier.
Definition calendar.cpp:669
KCal::Calendar::batchAddingBegins
void batchAddingBegins()
KCal::Calendar::close
virtual void close()=0
Clears out the current calendar, freeing all used memory etc.
KCal::Calendar::rawJournalsForDate
virtual Journal::List rawJournalsForDate(const QDate &date)=0
Returns an unfiltered list of all Journals for on the specified date.
KCal::Calendar::isAncestorOf
bool isAncestorOf(Incidence *ancestor, Incidence *incidence)
Checks if ancestor is an ancestor of incidence.
Definition calendar.cpp:1075
KCal::Calendar::timeSpec
KDateTime::Spec timeSpec() const
Get the time specification (time zone etc.) used for creating or modifying incidences in the Calendar...
Definition calendar.cpp:145
KCal::Calendar::alarms
virtual Alarm::List alarms(const KDateTime &from, const KDateTime &to)=0
Returns a list of Alarms within a time range for this Calendar.
KCal::Calendar::todos
virtual Todo::List todos(TodoSortField sortField=TodoSortUnsorted, SortDirection sortDirection=SortDirectionAscending)
Returns a sorted, filtered list of all Todos for this Calendar.
Definition calendar.cpp:856
KCal::Calendar::productId
QString productId() const
Returns the calendar's Product ID.
Definition calendar.cpp:1202
KCal::Calendar::owner
Person owner() const
Returns the owner of the calendar.
Definition calendar.cpp:124
KCal::Calendar::sortJournals
static Journal::List sortJournals(Journal::List *journalList, JournalSortField sortField, SortDirection sortDirection)
Sort a list of Journals.
Definition calendar.cpp:871
KCal::Calendar::endBatchAdding
void endBatchAdding()
Emits the endBatchAdding() signal.
Definition calendar.cpp:944
KCal::Calendar::setTimeZones
void setTimeZones(const ICalTimeZones &zones)
Set the time zone collection used by the calendar.
KCal::CustomProperties::CustomProperties
CustomProperties()
Constructs an empty custom properties instance.
Definition customproperties.cpp:65
KCal::Event
This class provides an Event in the sense of RFC2445.
Definition event.h:42
KCal::Event::List
ListBase< Event > List
List of events.
Definition event.h:55
KCal::ICalTimeZone
The ICalTimeZone class represents an iCalendar VTIMEZONE component.
Definition icaltimezones.h:144
KCal::ICalTimeZones
The ICalTimeZones class represents a time zone database which consists of a collection of individual ...
Definition icaltimezones.h:65
KCal::IncidenceBase::IncidenceObserver
The IncidenceObserver class.
Definition incidencebase.h:158
KCal::IncidenceBase
An abstract class that provides a common base for all calendar incidence classes.
Definition incidencebase.h:103
KCal::Incidence
Provides the abstract base class common to non-FreeBusy (Events, To-dos, Journals) calendar component...
Definition incidence.h:70
KCal::Incidence::List
ListBase< Incidence > List
List of incidences.
Definition incidence.h:171
KCal::Journal
Provides a Journal in the sense of RFC2445.
Definition journal.h:44
KCal::Journal::List
ListBase< Journal > List
List of journals.
Definition journal.h:49
KCal::Person
Represents a person, by name ane email address.
Definition person.h:49
KCal::Todo
Provides a To-do in the sense of RFC2445.
Definition todo.h:45
KCal::Todo::List
ListBase< Todo > List
List of to-dos.
Definition todo.h:50
customproperties.h
This file is part of the API for handling calendar data and defines the CustomProperties class.
event.h
This file is part of the API for handling calendar data and defines the Event class.
journal.h
This file is part of the API for handling calendar data and defines the Journal class.
todo.h
This file is part of the API for handling calendar data and defines the Todo class.
This file is part of the KDE documentation.
Documentation copyright © 1996-2025 The KDE developers.
Generated on Fri Jan 17 2025 00:00:00 by doxygen 1.13.2 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

KCal Library

Skip menu "KCal Library"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdepimlibs-4.14.10 API Reference

Skip menu "kdepimlibs-4.14.10 API Reference"
  • akonadi
  •   contact
  •   kmime
  •   socialutils
  • kabc
  • kalarmcal
  • kblog
  • kcal
  • kcalcore
  • kcalutils
  • kholidays
  • kimap
  • kioslave
  •   imap4
  •   mbox
  •   nntp
  • kldap
  • kmbox
  • kmime
  • kontactinterface
  • kpimidentities
  • kpimtextedit
  • kpimutils
  • kresources
  • ktnef
  • kxmlrpcclient
  • mailtransport
  • microblog
  • qgpgme
  • syndication
  •   atom
  •   rdf
  •   rss2
Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal