MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QOrganizerItemFetchForExportRequest Class Reference

The QOrganizerItemFetchForExportRequest class allows a client to asynchronously request organizer items from an organizer item store manager. More...

 #include <QOrganizerItemFetchForExportRequest>

Inherits: QOrganizerAbstractRequest.

This class was introduced in Qt Mobility 1.1.

Public Functions

QOrganizerItemFetchForExportRequest ( QObject * parent = 0 )
~QOrganizerItemFetchForExportRequest ()
QDateTime endDate () const
QOrganizerItemFetchHint fetchHint () const
QOrganizerItemFilter filter () const
QList<QOrganizerItem> items () const
void setEndDate ( const QDateTime & date )
void setFetchHint ( const QOrganizerItemFetchHint & fetchHint )
void setFilter ( const QOrganizerItemFilter & filter )
void setSorting ( const QList<QOrganizerItemSortOrder> & sorting )
void setStartDate ( const QDateTime & date )
QList<QOrganizerItemSortOrder> sorting () const
QDateTime startDate () const

Additional Inherited Members

Detailed Description

The QOrganizerItemFetchForExportRequest class allows a client to asynchronously request organizer items from an organizer item store manager.

For a QOrganizerItemFetchForExportRequest, 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.

Member Function Documentation

QOrganizerItemFetchForExportRequest::QOrganizerItemFetchForExportRequest ( QObject * parent = 0 )

Constructs a new organizer item fetch request whose parent is the specified parent

This function was introduced in Qt Mobility 1.1.

QOrganizerItemFetchForExportRequest::~QOrganizerItemFetchForExportRequest ()

Frees memory in use by this request

This function was introduced in Qt Mobility 1.2.

QDateTime QOrganizerItemFetchForExportRequest::endDate () const

Returns the date-time which is the upper bound for the range in which items will be returned. An invalid (default-constructed) date-time signifies that no upper bound is given (matches everything after the start date). Note that an item matches if either it or any of its occurrences occur within the defined range.

This function was introduced in Qt Mobility 1.1.

See also setEndDate().

QOrganizerItemFetchHint QOrganizerItemFetchForExportRequest::fetchHint () const

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.

QOrganizerItemFilter QOrganizerItemFetchForExportRequest::filter () const

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().

QList<QOrganizerItem> QOrganizerItemFetchForExportRequest::items () const

Returns the list of organizer items retrieved by this request

This function was introduced in Qt Mobility 1.1.

void QOrganizerItemFetchForExportRequest::setEndDate ( const QDateTime & date )

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().

void QOrganizerItemFetchForExportRequest::setFetchHint ( const QOrganizerItemFetchHint & fetchHint )

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.

void QOrganizerItemFetchForExportRequest::setFilter ( const QOrganizerItemFilter & filter )

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().

void QOrganizerItemFetchForExportRequest::setSorting ( const QList<QOrganizerItemSortOrder> & sorting )

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().

void QOrganizerItemFetchForExportRequest::setStartDate ( const QDateTime & date )

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().

QList<QOrganizerItemSortOrder> QOrganizerItemFetchForExportRequest::sorting () const

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().

QDateTime QOrganizerItemFetchForExportRequest::startDate () const

Returns the date-time which is the lower bound for the range in which items will be returned. An invalid (default-constructed) date-time signifies that no lower bound is given (matches everything up to the end date). Note that an item matches if either it or any of its occurrences occur within the defined range.

This function was introduced in Qt Mobility 1.1.

See also setStartDate().