QML OrganizerModel ElementThe OrganizerModel element provides access to organizer items from the organizer store. More... Properties
Methods
Detailed DescriptionThis element is part of the QtMobility.organizer 1.1 module. OrganizerModel provides a model of organizer items from the organizer store. The contents of the model can be specified with filter, sortOrders and fetchHint properties. Whether the model is automatically updated when the store or organizer item changes, can be controlled with OrganizerModel::autoUpdate property. There are two ways of accessing the organizer item data: via the model by using views and delegates, or alternatively via items list property. Of the two, the model access is preferred. Direct list access (i.e. non-model) is not guaranteed to be in order set by sortOrder. At the moment the model roles provided by OrganizerModel are display and item. Through the item role can access any data provided by the OrganizerItem element. Note: Both the startPeriod and endPeriod are set by default to the current time (when the OrganizerModel was created). In most cases, both (or at least one) of the startPeriod and endPeriod should be set; otherwise, the OrganizerModel will contain zero items because the startPeriod and endPeriod are the same value. For example, if only endPeriod is provided, the OrganizerModel will contain all items from now (the time of the OrganizerModel's creation) to the endPeriod time. See also OrganizerItem and QOrganizerManager. Property DocumentationThis property indicates whether or not the organizer model should be updated automatically, default value is true. See also OrganizerModel::update(). This property holds the list of available manager names. This property is read only. This property holds the end date and time period used by the organizer model to fetch organizer items. The default value is the datetime of OrganizerModel creation. This property holds the latest error code returned by the organizer manager. This property is read only. This property holds a list of event occurrences in the organizer model. See also EventOccurrence. This property holds a list of events in the organizer model. See also Event. This property holds the fetch hint instance used by the organizer model. See also FetchHint. This property holds the filter instance used by the organizer model. See also Filter. This property holds the size of organizer items the OrganizerModel currently holds. This property is read only. This property holds a list of organizer items in the organizer model. See also OrganizerItem. This property holds a list of journal items in the organizer model. See also Journal. This property holds the manager name or manager uri of the organizer backend engine. The manager uri format: qtorganizer:<managerid>:<key>=<value>&<key>=<value>. For example, memory organizer engine has an optional id parameter, if user want to share the same memory engine with multiple OrganizerModel instances, the manager property should declared like this: model : OrganizerModel { manager:"qtorganizer:memory:id=organizer1 } instead of just the manager name: model : OrganizerModel { manager:"memory" } See also QOrganizerManager::fromUri(). This property holds the manager name of the organizer backend engine. This property is read only. See also QOrganizerManager::fromUri(). This property holds a list of note items in the organizer model. See also Note. This property holds a list of event or todo occurrence items in the organizer model. Note: This property is not currently supported yet. See also Event, Todo, EventOccurrence, and TodoOccurrence. This property holds a list of sort orders used by the organizer model. See also SortOrder. This property holds the start date and time period used by the organizer model to fetch organizer items. The default value is the datetime of OrganizerModel creation. This property holds a list of todo occurrences in the organizer model. See also TodoOccurrence. This property holds a list of todos in the organizer model. See also Todo. Method DocumentationCancel the running organizer model content update request. See also OrganizerModel::autoUpdate and OrganizerModel::update. Returns true if there is at least one OrganizerItem between the given date range. Both the start and end parameters are optional, if no end parameter, returns true if there are item(s) after start, if neither start nor end date time provided, returns true if items in the current model is not empty, otherwise return false. This documentation was introduced in QtMobility organizer 1.1.1. See also itemIds(). Export organizer items into a vcalendar file to the given url by optional profiles. At the moment only the local file url is supported in export method. Fetch a list of organizer items from the organizer store by given itemIds. Import organizer items from a vcalendar by the given url and optional profiles. Returns the OrganizerItem object which item id is the given itemId. This documentation was introduced in QtMobility organizer 1.1.1. Returns the list of organizer item ids between the given date range start and end, Both the start and end parameters are optional, if no end parameter, returns all item ids from start, if neither start nor end date time provided, returns all item ids in the current model. This documentation was introduced in QtMobility organizer 1.1.1. See also containsItems(). Removes the organizer item with the given itemId from the backend. This documentation was introduced in QtMobility organizer 1.1.1. Saves the given item into the organizer backend. This documentation was introduced in QtMobility organizer 1.1.1. Manually update the organizer model content. See also OrganizerModel::autoUpdate. X
|