MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9
QtMobility Reference Documentation

Contents

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

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