MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QLandmarkCategorySaveRequest Class Reference

The QLandmarkCategorySaveRequest class allows a client to asynchronously request that certain categories be saved by a landmark manager. More...

 #include <QLandmarkCategorySaveRequest>

Inherits: QLandmarkAbstractRequest.

This class was introduced in Qt Mobility 1.1.

Public Functions

QLandmarkCategorySaveRequest ( QLandmarkManager * manager, QObject * parent = 0 )
~QLandmarkCategorySaveRequest ()
QList<QLandmarkCategory> categories () const
QMap<int, QLandmarkManager::Error> errorMap () const
void setCategories ( const QList<QLandmarkCategory> & categories )
void setCategory ( const QLandmarkCategory & category )

Additional Inherited Members

Detailed Description

The QLandmarkCategorySaveRequest class allows a client to asynchronously request that certain categories be saved by a landmark manager.

For a QLandmarkCategorySaveRequest, 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 error()).

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

Member Function Documentation

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

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

QLandmarkCategorySaveRequest::~QLandmarkCategorySaveRequest ()

Destroys the request object.

QList<QLandmarkCategory> QLandmarkCategorySaveRequest::categories () const

Returns the list of categories to be saved. If called after the save operation has finished, any new categories saved will have had their QLandmarkCategoryId set. (Categories which were updated or failed to save will remain unchanged, use the errorMap() function to determine which particular categories failed to save.)

This function was introduced in Qt Mobility 1.1.

See also setCategories().

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

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

This function was introduced in Qt Mobility 1.1.

void QLandmarkCategorySaveRequest::setCategories ( const QList<QLandmarkCategory> & categories )

Sets the list of categories to be saved.

This function was introduced in Qt Mobility 1.1.

See also categories() and setCategory().

void QLandmarkCategorySaveRequest::setCategory ( const QLandmarkCategory & category )

Convenience function to set a single category to be saved. This function is the equivalent of calling setCategories() with a single category.

This function was introduced in Qt Mobility 1.1.

See also setCategories().