|
Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions | |
The QAppointmentModel class provides access to the Calendar data. More...
#include <QAppointmentModel>
Inherits QPimModel.
The QAppointmentModel class provides access to the Calendar data.
User appointments are represented in the appointment model as a table, with each row corresponding to a particular appointment and each column as on of the fields of the appointment. Complete QAppointment objects can be retrieved using the appointment() function which takes either a row, index, or unique identifier.
The appointment model is a descendant of QAbstractItemModel, so it is suitable for use with the Qt View classes such as QListView and QTableView, as well as any custom views.
The appointment model provides functions for sorting and some filtering of items. For filters or sorting that is not provided by the appointment model it is recommended that QSortFilterProxyModel is used to wrap the appointment model.
A QAppointmentModel instance will also reflect changes made in other instances of QAppointmentModel, both within this application and from other applications. This will result in the modelReset() signal being emitted.
See also QAppointment, QSortFilterProxyModel, and Pim Library.
Describes the set of occurrences that should be shown by the model
| Constant | Value | Description |
|---|---|---|
| QAppointmentModel::TimedDuration | 0x01 | Occurrences that have times and dates specified for when they start and end. |
| QAppointmentModel::AllDayDuration | 0x2 | Occurrences that only have a date specified for when they start and end. |
| QAppointmentModel::AnyDuration | TimedDuration | AllDayDuration | Occurrences with either date only or date and time specified for when they start and end. |
Enumerates the columns when in table mode and columns used for sorting. This is a subset of data retrievable from a QAppointment.
| Constant | Value | Description |
|---|---|---|
| QAppointmentModel::Invalid | -1 | An invalid field |
| QAppointmentModel::Description | 0 | The description of the appointment |
| QAppointmentModel::Location | 1 | The location of the appointment |
| QAppointmentModel::Start | 2 | The start time of the appointment |
| QAppointmentModel::End | 3 | The end time of the appointment |
| QAppointmentModel::AllDay | 4 | Whether the appointment is an all day event |
| QAppointmentModel::TimeZone | 5 | The time zone of the appointment |
| QAppointmentModel::Notes | 6 | The notes of the appointment |
| QAppointmentModel::Alarm | 7 | The type of alarm of the appointment |
| QAppointmentModel::RepeatRule | 8 | The repeat rule of the appointment |
| QAppointmentModel::RepeatFrequency | 9 | The repeat frequency of the appointment |
| QAppointmentModel::RepeatEndDate | 10 | The date a repeating appointment repeats until. If null the appointment repeats forever |
| QAppointmentModel::RepeatWeekFlags | 11 | The flags specifying what days of the week the appointment repeats on |
| QAppointmentModel::Identifier | 12 | The identifier of the appointment |
| QAppointmentModel::Categories | 13 | The list of categories the appointment belongs to |
Extends Qt::ItemDataRole
| Constant | Value | Description |
|---|---|---|
| QAppointmentModel::LabelRole | Qt::UserRole | A short formatted text label of the appointments name. |
Constructs an appointment model with the given parent.
Destroys the appointment model.
Adds the appointment to the model under the specified storage source. If source is null the function will add the appointment to the default storage source.
Returns a valid identifier for the appointment if the appointment was successfully added. Otherwise returns a null identifier.
Note the current identifier of the specified appointment is ignored.
Adds the PIM record encoded in bytes to the model under the specified storage source. The format of the record in bytes is given by the format string. An empty format string will cause the record to be read using the data stream operators for the PIM data type of the model. If the specified source is null the function will add the record to the default storage source.
Returns a valid identifier for the record if the record was successfully added. Otherwise returns a null identifier.
Can only add PIM data that is represented by the model. This means that only appointment data can be added using a appointment model. Valid formats are "vCalendar" or an empty string.
Reimplemented from QPimModel.
See also addAppointment().
Returns the appointment for the row specified by index. The column of index is ignored.
This is an overloaded member function, provided for convenience.
Returns the appointment in the model with the given identifier. The appointment does not have to be in the current filter mode for it to be returned.
This is an overloaded member function, provided for convenience.
Returns the appointment for given row.
Returns the value for the specified field of the given appointment.
See also setAppointmentField() and data().
Returns the data stored under the given role for the item referred to by the index.
Reimplemented from QAbstractItemModel.
See also setData().
Returns the duration type of appointments currently included in the model.
See also setDurationType().
Returns a icon representing the appointment model field.
Returns a null icon if no icon is available.
See also fieldLabel(), fieldIdentifier(), and identifierField().
Returns a non-translated string describing the appointment model field.
See also fieldLabel(), fieldIcon(), and identifierField().
Returns a translated string describing the appointment model field.
See also fieldIcon(), fieldIdentifier(), and identifierField().
Returns the appointment model field for the non-translated field identifier
See also fieldLabel(), fieldIcon(), and fieldIdentifier().
Returns the end of the range filter for the model A null date time will be returned if there is no restriction on the range end.
See also setRange().
Returns the start of the range filter for the model. A null date time will be returned if there is no restriction on the range start.
See also setRange().
Returns the record in the model with the specified identifier encoded in the format specified by the format string. An empty format string will cause the record to be written using the data stream operators for the PIM data type of the model.
Valid formats are "vCalendar" or an empty string.
Reimplemented from QPimModel.
See also appointment().
Removes the appointment from the model with the same identifier as the specified appointment.
Returns true if a appointment was successfully removed.
This is an overloaded member function, provided for convenience.
Removes the appointment from the model with the specified identifier.
Returns true if a appointment was successfully removed.
Removes the records in the model specified by the list of identifiers.
Returns true if appointments were successfully removed. Otherwise returns false.
Updates the appointment in the model with the same identifier as the specified occurrence to have an exception on the date of the occurrence.
Returns true if the exception was successfully added.
This is an overloaded member function, provided for convenience.
Updates the appointment in the model with the same identifier as the specified appointment to have an exception on the specified date.
Returns true if the exception was successfully added.
This is an overloaded member function, provided for convenience.
Updates the appointment in the model with the specified identifier to have an exception on the specified date.
Returns true if the appointment was successfully updated.
Removes the record from the model with the specified identifier.
Returns true if the record was successfully removed.
Reimplemented from QPimModel.
See also removeAppointment().
Updates the appointment in the model with the same identifier as the specified appointment to have an exception on the specified date. The occurrence will be added as a child occurrence of the modified appointment. If the specified date is null, the start date of the occurrence will be used to create the exception.
Returns a valid identifier for the occurrence if the exception was successfully added. Otherwise returns a null identifier.
Updates the appointment in the model with the same identifier as the specified appointment to no longer repeat on or after the specified date. If the specified date is null, the start date of the replacement will be used. The replacement appointment will be added to the model.
Returns a valid identifier for the replacement appointment if the model was successfully modified. Otherwise returns a null identifier.
If an recurring appointment in the model with the specified identifier has an exception listed for the given date, restores the original occurrence for that date. If the exception included a replacement appointment will also remove the replacement.
Returns true if the appointment was successfully updated.
Sets the value for the specified field of the given appointment to value.
Returns true if the appointment was modified.
See also appointmentField() and setData().
Sets the role data for the item at index to value. Returns true if successful.
The appointment model only accepts data for the EditRole. The column of the specified index specifies the QAppointmentModel::Field to set and the row of the index specifies which appointment to modify.
Reimplemented from QAbstractItemModel.
See also data() and setAppointmentField().
Sets the model to only contain appointments of the specified duration type
See also durationType().
Sets the occurrence model to contain only occurrences that end on or after the specified range start time and start before the specified range end time. Both start and end time specified should be in local time.
Updates the appointment in the model with the same identifier as the specified appointment to equal the specified appointment.
Returns true if a appointment was successfully updated.
Updates the corresponding record in the model to equal the record encoded in bytes. The format of the record in bytes is given by the format string. An empty format string will cause the record to be read using the data stream operators for the PIM data type of the model. If id is not null will set the record identifier to id before attempting to update the record.
Returns true if the record was successfully updated.
Reimplemented from QPimModel.
See also updateAppointment().
| Copyright © 2009 Trolltech | Trademarks | Qt Extended 4.4.3 |