The QOrganizerItemFetchRequest class allows a client to asynchronously request organizer items from an organizer item store manager. More...
#include <QOrganizerItemFetchRequest>
Inherits: QOrganizerAbstractRequest.
This class was introduced in Qt Mobility 1.1.
QOrganizerItemFetchRequest ( QObject * parent = 0 ) | |
~QOrganizerItemFetchRequest () | |
QDateTime | endDate () const |
QOrganizerItemFetchHint | fetchHint () const |
QOrganizerItemFilter | filter () const |
QList<QOrganizerItem> | items () const |
int | maxCount () const |
void | setEndDate ( const QDateTime & date ) |
void | setFetchHint ( const QOrganizerItemFetchHint & fetchHint ) |
void | setFilter ( const QOrganizerItemFilter & filter ) |
void | setMaxCount ( int maxCount ) |
void | setSorting ( const QList<QOrganizerItemSortOrder> & sorting ) |
void | setStartDate ( const QDateTime & date ) |
QList<QOrganizerItemSortOrder> | sorting () const |
QDateTime | startDate () const |
The QOrganizerItemFetchRequest class allows a client to asynchronously request organizer items from an organizer item store manager.
For a QOrganizerItemFetchRequest, the resultsAvailable() signal will be emitted when the resultant organizer item (which may be retrieved by calling items()), are updated, as well as if the overall operation error (which may be retrieved by calling error()) is updated.
Constructs a new organizer item fetch request whose parent is the specified parent
This function was introduced in Qt Mobility 1.1.
Frees memory in use by this request
This function was introduced in Qt Mobility 1.2.
Returns the end date of the request. The end date is the upper bound of the time-period within which an item must occur (that is, either it or one of its occurrences must have a time-period defined by its start-date and end-date which overlaps with the time-period defined in this request) in order to be returned by the request.
An empty or invalid end date signifies an end date of positive-infinity (that is, all items which occur at any point in time after the start date, will be returned).
This function was introduced in Qt Mobility 1.1.
See also setEndDate().
Returns the fetch hint which may be used by the backend to optimize organizer item retrieval. A client should not make changes to an organizer item which has been retrieved using a fetch hint other than the default fetch hint. Doing so will result in information loss when saving the organizer item back to the manager (as the "new" restricted organizer item will replace the previously saved organizer item in the backend).
This function was introduced in Qt Mobility 1.1.
See also setFetchHint() and QOrganizerItemFetchHint.
Returns the filter that will be used to select organizer items to be returned
This function was introduced in Qt Mobility 1.1.
See also setFilter().
Returns the list of organizer items retrieved by this request
This function was introduced in Qt Mobility 1.1.
Returns the maximum number of items to return for the request.
A negative value denotes that no limit will be imposed on the number of items to fetch.
The default value is -1.
This function was introduced in Qt Mobility 1.1.
See also setMaxCount().
Sets the end period of the request to date. Only has an effect if called prior to calling start()
This function was introduced in Qt Mobility 1.1.
See also endDate().
Sets the fetch hint which may be used by the backend to optimize organizer item retrieval to fetchHint. A client should not make changes to a organizer item which has been retrieved using a fetch hint other than the default fetch hint. Doing so will result in information loss when saving the organizer item back to the manager (as the "new" restricted organizer item will replace the previously saved organizer item in the backend).
This function was introduced in Qt Mobility 1.1.
See also fetchHint() and QOrganizerItemFetchHint.
Sets the organizer item filter used to determine which organizer items will be retrieved to filter
This function was introduced in Qt Mobility 1.1.
See also filter().
Sets the maximum number of items to maxCount. Only has an effect if called prior to calling start() * * A negative value denotes that no limit will be imposed on the number of items to fetch.
This function was introduced in Qt Mobility 1.2.
See also maxCount().
Sets the sort order of the result to sorting. Only has an effect if called prior to calling start()
This function was introduced in Qt Mobility 1.1.
See also sorting().
Sets the start period of the request to date. Only has an effect if called prior to calling start()
This function was introduced in Qt Mobility 1.1.
See also startDate().
Returns the sort ordering that will be used sort the results of this request
This function was introduced in Qt Mobility 1.1.
See also setSorting().
Returns the start date of the request. The start date is the lower bound of the time-period within which an item must occur (that is, either it or one of its occurrences must have a time-period defined by its start-date and end-date which overlaps with the time-period defined in this request) in order to be returned by the request.
An empty or invalid start date signifies a start date of negative-infinity (that is, all items which occur at any point in time, up until the end date, will be returned).
This function was introduced in Qt Mobility 1.1.
See also setStartDate().
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.