MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

Contents

QLandmarkSaveRequest Class Reference

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

 #include <QLandmarkSaveRequest>

Inherits: QLandmarkAbstractRequest.

This class was introduced in Qt Mobility 1.1.

Public Functions

QLandmarkSaveRequest ( QLandmarkManager * manager, QObject * parent = 0 )
~QLandmarkSaveRequest ()
QMap<int, QLandmarkManager::Error> errorMap () const
QList<QLandmark> landmarks () const
void setLandmark ( const QLandmark & landmark )
void setLandmarks ( const QList<QLandmark> & landmarks )

Additional Inherited Members

Detailed Description

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

For a QLandmarkSaveRequest, the resultsAvailable() signal will be emitted when either an individual items error out (individaul errors may be retrieved by calling errorMap()), or when 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

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

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

QLandmarkSaveRequest::~QLandmarkSaveRequest ()

Destroys the request object.

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

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

This function was introduced in Qt Mobility 1.1.

QList<QLandmark> QLandmarkSaveRequest::landmarks () const

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

This function was introduced in Qt Mobility 1.1.

See also setLandmarks().

void QLandmarkSaveRequest::setLandmark ( const QLandmark & landmark )

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

This function was introduced in Qt Mobility 1.1.

See also setLandmarks().

void QLandmarkSaveRequest::setLandmarks ( const QList<QLandmark> & landmarks )

Sets the list of landmarks to be saved.

This function was introduced in Qt Mobility 1.1.

See also landmarks() and setLandmark().

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