KCalendarCore::MemoryCalendar Class

class KCalendarCore::MemoryCalendar

This class provides a calendar stored in memory. More...

Header: #include <KCalendarCore/MemoryCalendar>
CMake: find_package(KF6 REQUIRED COMPONENTS CalendarCore)
target_link_libraries(mytarget PRIVATE KF6::CalendarCore)
Inherits: KCalendarCore::Calendar

Public Types

Ptr

Public Functions

MemoryCalendar(const QByteArray &timeZoneId)
MemoryCalendar(const QTimeZone &timeZone)
virtual ~MemoryCalendar() override
Incidence::Ptr instance(const QString &identifier) const
void setUpdateLastModifiedOnChange(bool update)
bool updateLastModifiedOnChange() const

Reimplemented Public Functions

virtual bool addEvent(const Event::Ptr &event) override
virtual bool addIncidence(const Incidence::Ptr &incidence) override
virtual bool addJournal(const Journal::Ptr &journal) override
virtual bool addTodo(const Todo::Ptr &todo) override
virtual Alarm::List alarms(const QDateTime &from, const QDateTime &to, bool excludeBlockedAlarms = false) const override
virtual bool deleteEvent(const Event::Ptr &event) override
virtual bool deleteEventInstances(const Event::Ptr &event) override
virtual bool deleteIncidence(const Incidence::Ptr &incidence) override
virtual bool deleteIncidenceInstances(const Incidence::Ptr &incidence) override
virtual bool deleteJournal(const Journal::Ptr &journal) override
virtual bool deleteJournalInstances(const Journal::Ptr &journal) override
virtual bool deleteTodo(const Todo::Ptr &todo) override
virtual bool deleteTodoInstances(const Todo::Ptr &todo) override
virtual void doSetTimeZone(const QTimeZone &timeZone) override
virtual Event::Ptr event(const QString &uid, const QDateTime &recurrenceId = {}) const override
virtual Event::List eventInstances(const Incidence::Ptr &event, KCalendarCore::EventSortField sortField = EventSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override
virtual void incidenceUpdate(const QString &uid, const QDateTime &recurrenceId) override
virtual void incidenceUpdated(const QString &uid, const QDateTime &recurrenceId) override
virtual Journal::Ptr journal(const QString &uid, const QDateTime &recurrenceId = {}) const override
virtual Journal::List journalInstances(const Incidence::Ptr &journal, KCalendarCore::JournalSortField sortField = JournalSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override
virtual Event::List rawEvents(KCalendarCore::EventSortField sortField = EventSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override
virtual Event::List rawEvents(const QDate &start, const QDate &end, const QTimeZone &timeZone = {}, bool inclusive = false) const override
virtual Event::List rawEventsForDate(const QDate &date, const QTimeZone &timeZone = {}, KCalendarCore::EventSortField sortField = EventSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override
virtual Journal::List rawJournals(KCalendarCore::JournalSortField sortField = JournalSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override
virtual Journal::List rawJournalsForDate(const QDate &date) const override
virtual Todo::List rawTodos(KCalendarCore::TodoSortField sortField = TodoSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override
virtual Todo::List rawTodos(const QDate &start, const QDate &end, const QTimeZone &timeZone = {}, bool inclusive = false) const override
virtual Todo::List rawTodosForDate(const QDate &date) const override
virtual Todo::Ptr todo(const QString &uid, const QDateTime &recurrenceId = {}) const override
virtual Todo::List todoInstances(const Incidence::Ptr &todo, KCalendarCore::TodoSortField sortField = TodoSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const override

Reimplemented Protected Functions

virtual void virtual_hook(int id, void *data) override

Detailed Description

Member Type Documentation

MemoryCalendar::Ptr

A shared pointer to a MemoryCalendar

Member Function Documentation

[explicit] MemoryCalendar::MemoryCalendar(const QByteArray &timeZoneId)

Constructs a MemoryCalendar object using a time zone ID. The time zone ID is used as the default for creating or modifying incidences in the Calendar. The time zone does not alter existing incidences.

timeZoneId is a string containing a time zone ID, which is assumed to be valid. If no time zone is found, the viewing time specification is set to local time zone.

Example: "Europe/Berlin"

[explicit] MemoryCalendar::MemoryCalendar(const QTimeZone &timeZone)

Constructs a MemoryCalendar object with a specified time zone timeZone. The time zone is used as the default for creating or modifying incidences in the Calendar. The time zone does not alter existing incidences.

timeZone is the time specification

[override virtual noexcept] MemoryCalendar::~MemoryCalendar()

Destroys the calendar.

[override virtual] bool MemoryCalendar::addEvent(const Event::Ptr &event)

Reimplements: Calendar::addEvent(const Event::Ptr &event).

[override virtual] bool MemoryCalendar::addIncidence(const Incidence::Ptr &incidence)

Reimplements: Calendar::addIncidence(const Incidence::Ptr &incidence).

[override virtual] bool MemoryCalendar::addJournal(const Journal::Ptr &journal)

Reimplements: Calendar::addJournal(const Journal::Ptr &journal).

[override virtual] bool MemoryCalendar::addTodo(const Todo::Ptr &todo)

Reimplements: Calendar::addTodo(const Todo::Ptr &todo).

[override virtual] Alarm::List MemoryCalendar::alarms(const QDateTime &from, const QDateTime &to, bool excludeBlockedAlarms = false) const

Reimplements: Calendar::alarms(const QDateTime &from, const QDateTime &to, bool excludeBlockedAlarms) const.

[override virtual] bool MemoryCalendar::deleteEvent(const Event::Ptr &event)

Reimplements: Calendar::deleteEvent(const Event::Ptr &event).

[override virtual] bool MemoryCalendar::deleteEventInstances(const Event::Ptr &event)

Reimplements: Calendar::deleteEventInstances(const Event::Ptr &event).

[override virtual] bool MemoryCalendar::deleteIncidence(const Incidence::Ptr &incidence)

Reimplements: Calendar::deleteIncidence(const Incidence::Ptr &incidence).

[override virtual] bool MemoryCalendar::deleteIncidenceInstances(const Incidence::Ptr &incidence)

Reimplements: Calendar::deleteIncidenceInstances(const Incidence::Ptr &incidence).

[override virtual] bool MemoryCalendar::deleteJournal(const Journal::Ptr &journal)

Reimplements: Calendar::deleteJournal(const Journal::Ptr &journal).

[override virtual] bool MemoryCalendar::deleteJournalInstances(const Journal::Ptr &journal)

Reimplements: Calendar::deleteJournalInstances(const Journal::Ptr &journal).

[override virtual] bool MemoryCalendar::deleteTodo(const Todo::Ptr &todo)

Reimplements: Calendar::deleteTodo(const Todo::Ptr &todo).

[override virtual] bool MemoryCalendar::deleteTodoInstances(const Todo::Ptr &todo)

Reimplements: Calendar::deleteTodoInstances(const Todo::Ptr &todo).

[override virtual] void MemoryCalendar::doSetTimeZone(const QTimeZone &timeZone)

Reimplements: Calendar::doSetTimeZone(const QTimeZone &timeZone).

[override virtual] Event::Ptr MemoryCalendar::event(const QString &uid, const QDateTime &recurrenceId = {}) const

Reimplements: Calendar::event(const QString &uid, const QDateTime &recurrenceId) const.

[override virtual] Event::List MemoryCalendar::eventInstances(const Incidence::Ptr &event, KCalendarCore::EventSortField sortField = EventSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::eventInstances(const Incidence::Ptr &event, KCalendarCore::EventSortField sortField, KCalendarCore::SortDirection sortDirection) const.

[override virtual] void MemoryCalendar::incidenceUpdate(const QString &uid, const QDateTime &recurrenceId)

Reimplements: IncidenceObserver::incidenceUpdate(const QString &uid, const QDateTime &recurrenceId).

[override virtual] void MemoryCalendar::incidenceUpdated(const QString &uid, const QDateTime &recurrenceId)

Reimplements: Calendar::incidenceUpdated(const QString &uid, const QDateTime &recurrenceId).

Incidence::Ptr MemoryCalendar::instance(const QString &identifier) const

Returns an incidence by identifier.

See also Incidence::instanceIdentifier().

[override virtual] Journal::Ptr MemoryCalendar::journal(const QString &uid, const QDateTime &recurrenceId = {}) const

Reimplements: Calendar::journal(const QString &uid, const QDateTime &recurrenceId) const.

[override virtual] Journal::List MemoryCalendar::journalInstances(const Incidence::Ptr &journal, KCalendarCore::JournalSortField sortField = JournalSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::journalInstances(const Incidence::Ptr &journal, KCalendarCore::JournalSortField sortField, KCalendarCore::SortDirection sortDirection) const.

JournalSortField, SortDirection)const

[override virtual] Event::List MemoryCalendar::rawEvents(KCalendarCore::EventSortField sortField = EventSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::rawEvents(KCalendarCore::EventSortField sortField, KCalendarCore::SortDirection sortDirection) const.

[override virtual] Event::List MemoryCalendar::rawEvents(const QDate &start, const QDate &end, const QTimeZone &timeZone = {}, bool inclusive = false) const

Reimplements: Calendar::rawEvents(const QDate &start, const QDate &end, const QTimeZone &timeZone, bool inclusive) const.

[override virtual] Event::List MemoryCalendar::rawEventsForDate(const QDate &date, const QTimeZone &timeZone = {}, KCalendarCore::EventSortField sortField = EventSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::rawEventsForDate(const QDate &date, const QTimeZone &timeZone, KCalendarCore::EventSortField sortField, KCalendarCore::SortDirection sortDirection) const.

Returns an unfiltered list of all Events which occur on the given date.

date request unfiltered Event list for this QDate only.

timeZone time zone to interpret date, or the calendar's default time zone if none is specified

sortField specifies the EventSortField.

sortDirection specifies the SortDirection.

Returns the list of unfiltered Events occurring on the specified QDate.

[override virtual] Journal::List MemoryCalendar::rawJournals(KCalendarCore::JournalSortField sortField = JournalSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::rawJournals(KCalendarCore::JournalSortField sortField, KCalendarCore::SortDirection sortDirection) const.

[override virtual] Journal::List MemoryCalendar::rawJournalsForDate(const QDate &date) const

Reimplements: Calendar::rawJournalsForDate(const QDate &date) const.

[override virtual] Todo::List MemoryCalendar::rawTodos(KCalendarCore::TodoSortField sortField = TodoSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::rawTodos(KCalendarCore::TodoSortField sortField, KCalendarCore::SortDirection sortDirection) const.

[override virtual] Todo::List MemoryCalendar::rawTodos(const QDate &start, const QDate &end, const QTimeZone &timeZone = {}, bool inclusive = false) const

Reimplements: Calendar::rawTodos(const QDate &start, const QDate &end, const QTimeZone &timeZone, bool inclusive) const.

[override virtual] Todo::List MemoryCalendar::rawTodosForDate(const QDate &date) const

Reimplements: Calendar::rawTodosForDate(const QDate &date) const.

void MemoryCalendar::setUpdateLastModifiedOnChange(bool update)

Govern if the memory calendar is changing the lastModified field of incidence it owns, on incidence updates.

update, when true, the lastModified field of an incidence owned by the calendar is set to the current date time on any change of the incidence.

See also updateLastModifiedOnChange().

[override virtual] Todo::Ptr MemoryCalendar::todo(const QString &uid, const QDateTime &recurrenceId = {}) const

Reimplements: Calendar::todo(const QString &uid, const QDateTime &recurrenceId) const.

[override virtual] Todo::List MemoryCalendar::todoInstances(const Incidence::Ptr &todo, KCalendarCore::TodoSortField sortField = TodoSortUnsorted, KCalendarCore::SortDirection sortDirection = SortDirectionAscending) const

Reimplements: Calendar::todoInstances(const Incidence::Ptr &todo, KCalendarCore::TodoSortField sortField, KCalendarCore::SortDirection sortDirection) const.

bool MemoryCalendar::updateLastModifiedOnChange() const

Return true if the memory calendar is updating the lastModified field of incidence owned by the calendar on any incidence change.

See also setUpdateLastModifiedOnChange().

[override virtual protected] void MemoryCalendar::virtual_hook(int id, void *data)