MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QOrganizerItemOccurrenceFetchRequest Class Reference

The QOrganizerItemOccurrenceFetchRequest class allows a client to asynchronously request occurrences generated by a recurring item. More...

 #include <QOrganizerItemOccurrenceFetchRequest>

Inherits: QOrganizerAbstractRequest.

This class was introduced in Qt Mobility 1.1.

Public Functions

QOrganizerItemOccurrenceFetchRequest ( QObject * parent = 0 )
~QOrganizerItemOccurrenceFetchRequest ()
QDateTime endDate () const
QOrganizerItemFetchHint fetchHint () const
QList<QOrganizerItem> itemOccurrences () const
int maxOccurrences () const
QOrganizerItem parentItem () const
void setEndDate ( const QDateTime & date )
void setFetchHint ( const QOrganizerItemFetchHint & hint )
void setMaxOccurrences ( int maxCount )
void setParentItem ( const QOrganizerItem & item )
void setStartDate ( const QDateTime & date )
QDateTime startDate () const

Additional Inherited Members

Detailed Description

The QOrganizerItemOccurrenceFetchRequest class allows a client to asynchronously request occurrences generated by a recurring item.

For a QOrganizerItemOccurrenceFetchRequest, the resultsAvailable() signal will be emitted when the resultant organizer items (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

QOrganizerItemOccurrenceFetchRequest::QOrganizerItemOccurrenceFetchRequest ( 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.

QOrganizerItemOccurrenceFetchRequest::~QOrganizerItemOccurrenceFetchRequest ()

Frees memory in use by this request

This function was introduced in Qt Mobility 1.2.

QDateTime QOrganizerItemOccurrenceFetchRequest::endDate () const

Returns the end date of the request.

This function was introduced in Qt Mobility 1.1.

See also setEndDate().

QOrganizerItemFetchHint QOrganizerItemOccurrenceFetchRequest::fetchHint () const

Returns the fetch hint associated with the request

This function was introduced in Qt Mobility 1.1.

See also setFetchHint().

QList<QOrganizerItem> QOrganizerItemOccurrenceFetchRequest::itemOccurrences () const

Returns the list of organizer item occurrences retrieved by this request

This function was introduced in Qt Mobility 1.1.

int QOrganizerItemOccurrenceFetchRequest::maxOccurrences () const

Returns the maximum number of items to fetch.

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

QOrganizerItem QOrganizerItemOccurrenceFetchRequest::parentItem () const

Returns the parent item, whose occurrences are to be fetched.

This function was introduced in Qt Mobility 1.1.

See also setParentItem().

void QOrganizerItemOccurrenceFetchRequest::setEndDate ( const QDateTime & date )

Sets the end period of the request to date. All occurrences fetched will have a date on or * before date.

This function was introduced in Qt Mobility 1.1.

See also endDate().

void QOrganizerItemOccurrenceFetchRequest::setFetchHint ( const QOrganizerItemFetchHint & hint )

Sets the fetch hint which the manager can use to optimize occurrence retrieval to hint. The fetch hint may be ignored by the manager, in which case each occurrence will include all available information.

This function was introduced in Qt Mobility 1.1.

See also fetchHint().

void QOrganizerItemOccurrenceFetchRequest::setMaxOccurrences ( int maxCount )

Sets the maximum number of items to fetch to maxCount.

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.1.

See also maxOccurrences().

void QOrganizerItemOccurrenceFetchRequest::setParentItem ( const QOrganizerItem & item )

Sets the parent item, whose occurrences are to be fetched to item.

This function was introduced in Qt Mobility 1.1.

See also parentItem().

void QOrganizerItemOccurrenceFetchRequest::setStartDate ( const QDateTime & date )

Sets the start date of the request to date. All occurrences fetched will have a date on or * after date.

This function was introduced in Qt Mobility 1.1.

See also startDate().

QDateTime QOrganizerItemOccurrenceFetchRequest::startDate () const

Returns the start date of the request.

This function was introduced in Qt Mobility 1.1.

See also setStartDate().