The QOrganizerItemRecurrenceRule class describes the a rule by which a QOrganizerItem repeats. More...
#include <QOrganizerItemRecurrenceRule>
enum | Frequency { Invalid, Daily, Weekly, Monthly, Yearly } |
enum | Month { January, February, March, April, ..., December } |
QOrganizerItemRecurrenceRule () | |
QOrganizerItemRecurrenceRule ( const QOrganizerItemRecurrenceRule & other ) | |
~QOrganizerItemRecurrenceRule () | |
int | count () const |
QList<int> | daysOfMonth () const |
QList<Qt::DayOfWeek> | daysOfWeek () const |
QList<int> | daysOfYear () const |
QDate | endDate () const |
Frequency | frequency () const |
int | interval () const |
QList<Month> | months () const |
QList<int> | positions () const |
void | setCount ( int count ) |
void | setDaysOfMonth ( const QList<int> & days ) |
void | setDaysOfWeek ( const QList<Qt::DayOfWeek> & days ) |
void | setDaysOfYear ( const QList<int> & days ) |
void | setEndDate ( const QDate & endDate ) |
void | setFrequency ( Frequency freq ) |
void | setInterval ( int interval ) |
void | setMonths ( const QList<Month> & months ) |
void | setPositions ( const QList<int> & pos ) |
void | setWeekStart ( Qt::DayOfWeek day ) |
void | setWeeksOfYear ( const QList<int> & weeks ) |
Qt::DayOfWeek | weekStart () const |
QList<int> | weeksOfYear () const |
QOrganizerItemRecurrenceRule & | operator= ( const QOrganizerItemRecurrenceRule & other ) |
* * *
The QOrganizerItemRecurrenceRule class describes the a rule by which a QOrganizerItem repeats.
* * This class is a mapping of a subset of the iCalendar RRULE property value, and each field in this * class corresponds to a fragment of iCalendar's RRULE. This class supports the same fragments as * those supported by RRULE, except for describing recurrences on a higher frequency than Daily. * That is, this class doesn't support hourly, minutely or secondly recurrences, nor does it support * specifying which hour, minute or second of a day to recur on. These types of rules are * unsupported because most calendaring backends don't support them, and it simplifies recurrences * by enforcing that there can be at most one occurrence of an item per day.
Constant | Value | Description |
---|---|---|
QOrganizerItemRecurrenceRule::Invalid | 0 | Signifies that the entire rrule is invalid. |
QOrganizerItemRecurrenceRule::Daily | 1 | |
QOrganizerItemRecurrenceRule::Weekly | 2 | |
QOrganizerItemRecurrenceRule::Monthly | 3 | |
QOrganizerItemRecurrenceRule::Yearly | 4 |
Constant | Value |
---|---|
QOrganizerItemRecurrenceRule::January | 1 |
QOrganizerItemRecurrenceRule::February | 2 |
QOrganizerItemRecurrenceRule::March | 3 |
QOrganizerItemRecurrenceRule::April | 4 |
QOrganizerItemRecurrenceRule::May | 5 |
QOrganizerItemRecurrenceRule::June | 6 |
QOrganizerItemRecurrenceRule::July | 7 |
QOrganizerItemRecurrenceRule::August | 8 |
QOrganizerItemRecurrenceRule::September | 9 |
QOrganizerItemRecurrenceRule::October | 10 |
QOrganizerItemRecurrenceRule::November | 11 |
QOrganizerItemRecurrenceRule::December | 12 |
Constructs a QOrganizerItemRecurrenceRule object describing a weekly recurrence.
Constructs a QOrganizerItemRecurrenceRule object as a copy of other.
Destroys the QOrganizerItemRecurrenceRule object.
Returns the "count" condition specified by the recurrence rule. The default count is 0 (ie. unlimited)
See also setCount().
Returns a list of the days of the month that the item should recur on. If not set, this is the empty list, which signifies that it should be implied, if necessary, by the day-of-month of the item.
See also setDaysOfMonth().
Returns a list of the days of week that the item should recur on. If not set, this is the empty list, which signifies that it should be implied, if necessary, by the day-of-week of the item.
See also setDaysOfWeek().
Returns a list of the days of the year that the item should recur on. If not set, this is the empty list, which signifies that it should be implied, if necessary, by the day-of-year of the item.
See also setDaysOfYear().
Returns the end-date condition specified by the recurrence rule. The default end date is the null date (ie. no end date).
See also setEndDate().
Returns the frequency with which the item recurs. The default frequency is Invalid.
See also setFrequency().
Returns the interval of recurrence. The default interval is 1.
See also setInterval().
Returns a list of the months that the item should recur on. If not set, this is the empty list, which signifies that it should be implied, if necessary, by the month of the item.
See also setMonths().
Returns the position-list of the recurrence rule. If not set, this is the empty list, which signifies that the recurrence dates should not be restricted by position.
See also setPositions().
Sets the "count" condition of the recurrence rule to count. If an end-date was previously set, it is removed as count and endDate are mutually exclusive.
The "count" condition is the maximum number of times the item should recur. Setting this to 0 or a negative value removes the count condition.
This corresponds to the COUNT fragment in iCalendar's RRULE.
See also count().
Sets the days of the month on which the item should recur to days. Negative values in the list represent the number of days from the end of the month. eg. 1 represents the first day of the month and -1 represents the last day of the month.
This corresponds to the BYMONTHDAY fragment in iCalendar's RRULE.
See also daysOfMonth().
Sets the days of week on which the item should recur to days.
This corresponds to the BYDAY fragment in iCalendar's RRULE.
See also daysOfWeek().
Sets the days of the year on which the item should recur to days. Negative values in the list represent the number of days from the end of the year. eg. 1 represents the first day of the year and -1 represents the last day of the year.
This corresponds to the BYYEARDAY fragment in iCalendar's RRULE.
See also daysOfYear().
Sets the end-date condition of the recurrence rule to endDate. If a "count" condition was previously set, it is removed as count and endDate are mutually exclusive.
The end-date condition is the date after which the item should not recur. Setting this to the null date removes the end-date condition.
This corresponds to the UNTIL fragment in iCalendar's RRULE.
See also endDate().
Sets the frequency with which the item recurs to freq.
This corresponds to the FREQ fragment in iCalendar's RRULE.
See also frequency().
Sets the interval, between cycles of length given by frequency(), in which the item should recur to interval.
For example, if the frequency() is QOrganizerItemRecurrenceRule::Daily and the interval is set to 2, the item should recur every second day.
This corresponds to the INTERVAL fragment in iCalendar's RRULE.
See also interval().
Sets the months on which the item should recur to months.
This corresponds to the BYMONTHDAY fragment in iCalendar's RRULE.
See also months().
Sets the list of positions that the item should recur on to pos. This specifies that the item should only recur on the nth occurrence within the set of events otherwise specified by the rule, for the values of n in pos.
Negative values in the list represnet a position counting from the end of the set.
For example, if frequency() == Monthly and months() is the list Monday, Tuesday, Wednesday, Thursday, Friday, and positions() == -1, this specifies that the item should recur on the last weekday of each month.
This corresponds to the BYSETPOS fragment in iCalendar's RRULE.
See also positions().
Sets the day that the week starts on to day, for the purposes of calculating recurrences. This is significant when the frequency is Weekly and the interval is greater than 1, or when weekOfYear is set. See the iCalendar spec for examples of its significance.
This corresponds to the BYWKST fragment in iCalendar's RRULE.
See also weekStart().
Sets the weeks of the year on which the item should recur to weeks. Negative values in the list represent the number of weeks from the end of the year. eg. 1 represents the first week of the year and -1 represents the last week of the year.
This corresponds to the BYWEEK fragment in iCalendar's RRULE.
See also weeksOfYear().
Returns the day that the week starts on. If not set, this is Monday.
See also setWeekStart().
Returns a list of the weeks of the year that the item should recur on. If not set, this is the empty list, which signifies that it should be implied, if necessary, by the week number of the item.
See also setWeeksOfYear().
Assigns this detail to be equal to other.