KCalendarCore::MemoryCalendar Class
class KCalendarCore::MemoryCalendarThis 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
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 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().