Qt Mobility Reference Documentation

QLandmarkFetchRequest Class Reference

The QLandmarkFetchRequest class allows a client to asynchronously request a list of landmarks from a landmark manager. More...

 #include <QLandmarkFetchRequest>

Inherits QLandmarkAbstractRequest.


Public Functions

QLandmarkFetchRequest ( QLandmarkManager * manager, QObject * parent = 0 )
~QLandmarkFetchRequest ()
QLandmarkFetchHint fetchHint () const
QLandmarkFilter filter () const
QList<QLandmark> landmarks () const
void setFetchHint ( const QLandmarkFetchHint & fetchHint )
void setFilter ( const QLandmarkFilter & filter )
void setLandmarkIds ( const QList<QLandmarkId> & ids )
void setSorting ( const QList<QLandmarkSortOrder> & sorting )
void setSorting ( const QLandmarkSortOrder & sorting )
QList<QLandmarkSortOrder> sorting () const

Additional Inherited Members


Detailed Description

The QLandmarkFetchRequest class allows a client to asynchronously request a list of landmarks from a landmark manager.

For a QLandmarkFetchRequest, the resultsAvailable() signal will be emitted when the resultant landmarks (which may be retrieved by calling landmarks()), are updated, as well as if the overall operation error (which may be retrieved by calling error()) is updated.


Member Function Documentation

QLandmarkFetchRequest::QLandmarkFetchRequest ( QLandmarkManager * manager, QObject * parent = 0 )

Creates a new landmark fetch request object with the given manager parent.

QLandmarkFetchRequest::~QLandmarkFetchRequest ()

Destroys the request object.

QLandmarkFetchHint QLandmarkFetchRequest::fetchHint () const

Returns the request's fetch hint.

See also setFetchHint().

QLandmarkFilter QLandmarkFetchRequest::filter () const

Returns the filter which will be used to select the landmarks.

By default, the filter's type will be a LandmarkFilter::DefaultFilter and thus match all landmarks.

See also setFilter().

QList<QLandmark> QLandmarkFetchRequest::landmarks () const

Returns the list of landmarks which matched the filter.

void QLandmarkFetchRequest::setFetchHint ( const QLandmarkFetchHint & fetchHint )

Sets the request's fetchHint

See also fetchHint().

void QLandmarkFetchRequest::setFilter ( const QLandmarkFilter & filter )

Sets the filter which will be used to select landmarks.

See also filter() and setLandmarkIds().

void QLandmarkFetchRequest::setLandmarkIds ( const QList<QLandmarkId> & ids )

This is a convenience function which will set a QLandmarkIdFilter based on the given list of landmark ids.

See also setFilter().

void QLandmarkFetchRequest::setSorting ( const QList<QLandmarkSortOrder> & sorting )

Sets the sort ordering of the request to sorting. This function will only have an effect on the results if invoked prior to calling QLandmarkAbstractRequest::start().

See also sorting().

void QLandmarkFetchRequest::setSorting ( const QLandmarkSortOrder & sorting )

Sets the sort ordering of the request to a singlesorting. This function will only have an effect on results if invoked prior to calling QLandmarkAbstractRequest::start()

QList<QLandmarkSortOrder> QLandmarkFetchRequest::sorting () const

Returns the sort ordering which is used to sort the result.

See also setSorting().


Copyright © 2009-2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.1.0