QtMobility Reference Documentation

QLandmarkCategoryFetchByIdRequest Class Reference

The QLandmarkCategoryFetchByIdRequest class allows a client to asynchronously request a list of categories by ID from a landmark manager. More...

 #include <QLandmarkCategoryFetchByIdRequest>

Inherits: QLandmarkAbstractRequest.

This class was introduced in Qt Mobility 1.1.

Public Functions

QLandmarkCategoryFetchByIdRequest ( QLandmarkManager * manager, QObject * parent = 0 )
~QLandmarkCategoryFetchByIdRequest ()
QList<QLandmarkCategory> categories () const
QList<QLandmarkCategoryId> categoryIds () const
QMap<int, QLandmarkManager::Error> errorMap () const
void setCategoryId ( const QLandmarkCategoryId & categoryId )
void setCategoryIds ( const QList<QLandmarkCategoryId> & categoryIds )

Additional Inherited Members

Detailed Description

The QLandmarkCategoryFetchByIdRequest class allows a client to asynchronously request a list of categories by ID from a landmark manager.

The categories fetched by the manager should have a one-to-one correspondence to the IDs passed into this class. That is, the nth category in the returned list should have an ID which is equal to the nth ID in the list of IDs. Any invalid ID should correspond to an empty QLandmarkCategory.

For a QLandmarkCategoryFetchByIdRequest, the resultsAvailable() signal will be emitted as resultant categories are found (these are retrievable by calling categories()), whenever individual items error out(individual errors may be retrieved by calling errorMap()), as well as if an overall operation error occurred(which may be retrieved by calling QLandmarkAbstractRequest::error()).

Please see the class documentation for QLandmarkAbstractRequest for more information about he usage of request classes and ownership semantics.

Member Function Documentation

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

Creates a new a request object with the given manager and parent.

QLandmarkCategoryFetchByIdRequest::~QLandmarkCategoryFetchByIdRequest ()

Destroys the request object.

QList<QLandmarkCategory> QLandmarkCategoryFetchByIdRequest::categories () const

Returns the list of categories fetched by this request

This function was introduced in Qt Mobility 1.1.

QList<QLandmarkCategoryId> QLandmarkCategoryFetchByIdRequest::categoryIds () const

Returns a list of identifiers of categories which are to be retrieved by this request.

This function was introduced in Qt Mobility 1.1.

See also setCategoryIds().

QMap<int, QLandmarkManager::Error> QLandmarkCategoryFetchByIdRequest::errorMap () const

Returns the mapping of input category id list indices to the errors which occurred.

This function was introduced in Qt Mobility 1.1.

void QLandmarkCategoryFetchByIdRequest::setCategoryId ( const QLandmarkCategoryId & categoryId )

Convenience function that sets a single category, specified by categoryId, to be retrieved by this request.

This function was introduced in Qt Mobility 1.1.

void QLandmarkCategoryFetchByIdRequest::setCategoryIds ( const QList<QLandmarkCategoryId> & categoryIds )

Sets this request to retrieve a list of categories identified by categoryIds.

This function was introduced in Qt Mobility 1.1.

See also categoryIds().

X

Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.