MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QLandmarkCategoryRemoveRequest Class Reference

The QLandmarkCategoryRemoveRequest class allows a client to asynchronously request that certain categories be removed from a landmark manager. More...

 #include <QLandmarkCategoryRemoveRequest>

Inherits: QLandmarkAbstractRequest.

This class was introduced in Qt Mobility 1.1.

Public Functions

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

Additional Inherited Members

Detailed Description

The QLandmarkCategoryRemoveRequest class allows a client to asynchronously request that certain categories be removed from a landmark manager.

For a QLandmarkCategoryRemoveRequest, the resultsAvailable() signal will be emitted when either an individual items error out (individaul errors may be retrieved by calling errorMap()) or an overall operation error occurs(which may be retrieved by calling QLandmarkAbstractRequest::error()).

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

Member Function Documentation

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

Constructs a category remove request with the given manager and parent.

QLandmarkCategoryRemoveRequest::~QLandmarkCategoryRemoveRequest ()

Destroys the request object.

QList<QLandmarkCategoryId> QLandmarkCategoryRemoveRequest::categoryIds () const

Returns the list of identifiers of categories which will be removed.

This function was introduced in Qt Mobility 1.1.

See also setCategoryIds().

QMap<int, QLandmarkManager::Error> QLandmarkCategoryRemoveRequest::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 QLandmarkCategoryRemoveRequest::setCategories ( const QList<QLandmarkCategory> & categories )

Convenience function to set the list of categories which will be removed. This function effectively calls setCategoryIds() with the IDs of the categories.

This function was introduced in Qt Mobility 1.1.

See also setCategory() and setCategoryIds().

void QLandmarkCategoryRemoveRequest::setCategory ( const QLandmarkCategory & category )

Convenience function that sets a single category to be removed. This function effectively calls setCategoryIds() with the ID of category.

This function was introduced in Qt Mobility 1.1.

See also setCategories() and setCategoryId().

void QLandmarkCategoryRemoveRequest::setCategoryId ( const QLandmarkCategoryId & categoryId )

Convenience function to set the categoryId of a single category to be removed. It is the equivalent of calling setCategoryIds() with a single categoryId in the ID list.

This function was introduced in Qt Mobility 1.1.

See also setCategory() and setCategoryIds().

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

Sets the list of categoryIds of categories which will be removed.

This function was introduced in Qt Mobility 1.1.

See also categoryIds(), setCategories(), and setCategoryId().