<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qlandmarkmanager.cpp -->
<title>Qt Mobility 1.2: QLandmarkManager Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="content">
<a href="index.html" class="qtref"><span>QtMobility Reference Documentation</span></a>
</div>
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtlocation.html">QtLocation</a></li>
<li>QLandmarkManager</li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
<li class="level2"><a href="#retrieval-operations">Retrieval Operations</a></li>
<li class="level2"><a href="#saving-and-deleting">Saving and Deleting</a></li>
<li class="level2"><a href="#importing-and-exporting">Importing and Exporting</a></li>
</ul>
</div>
<h1 class="title">QLandmarkManager Class Reference</h1>
<!-- $$$QLandmarkManager-brief -->
<p>The QLandmarkManager class provides an interface for storage and retrieval of landmarks from a landmark store. <a href="#details">More...</a></p>
<!-- @@@QLandmarkManager -->
<pre class="cpp"> <span class="preprocessor">#include <QLandmarkManager></span></pre><p><b>Inherits: </b><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a>.</p>
<p>This class was introduced in Qt Mobility 1.1.</p>
<ul>
<li><a href="qlandmarkmanager-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#Error-enum">Error</a></b> { NoError, DoesNotExistError, LandmarkDoesNotExistError, CategoryDoesNotExistError, ..., UnknownError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#ManagerFeature-enum">ManagerFeature</a></b> { ImportExportFeature, NotificationsFeature }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#SupportLevel-enum">SupportLevel</a></b> { NativeSupport, EmulatedSupport, NoSupport }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#TransferOperation-enum">TransferOperation</a></b> { ImportOperation, ExportOperation }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#TransferOption-enum">TransferOption</a></b> { IncludeCategoryData, ExcludeCategoryData, AttachSingleCategory }</td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#QLandmarkManager">QLandmarkManager</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#QLandmarkManager-2">QLandmarkManager</a></b> ( const QString & <i>managerName</i>, const QMap<QString, QString> & <i>parameters</i> = 0, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#dtor.QLandmarkManager">~QLandmarkManager</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkCategory> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#categories">categories</a></b> ( const QList<QLandmarkCategoryId> & <i>categoryIds</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkCategory> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#categories-2">categories</a></b> ( int <i>limit</i> = -1, int <i>offset</i> = 0, const QLandmarkNameSort & <i>nameSort</i> = QLandmarkNameSort() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLandmarkCategory </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#category">category</a></b> ( const QLandmarkCategoryId & <i>categoryId</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkCategoryId> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#categoryIds">categoryIds</a></b> ( int <i>limit</i> = -1, int <i>offset</i> = 0, const QLandmarkNameSort & <i>nameSort</i> = QLandmarkNameSort() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Error </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<int, QLandmarkManager::Error> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#errorMap">errorMap</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#errorString">errorString</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#exportLandmarks">exportLandmarks</a></b> ( QIODevice * <i>device</i>, const QString & <i>format</i>, const QList<QLandmarkId> & <i>landmarkIds</i> = QList<QLandmarkId> (), QLandmarkManager::TransferOption <i>option</i> = IncludeCategoryData ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#exportLandmarks-2">exportLandmarks</a></b> ( const QString & <i>fileName</i>, const QString & <i>format</i>, const QList<QLandmarkId> & <i>landmarkIds</i> = QList<QLandmarkId> (), QLandmarkManager::TransferOption <i>option</i> = IncludeCategoryData ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> SupportLevel </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#filterSupportLevel">filterSupportLevel</a></b> ( const QLandmarkFilter & <i>filter</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#importLandmarks">importLandmarks</a></b> ( QIODevice * <i>device</i>, const QString & <i>format</i> = QString(), QLandmarkManager::TransferOption <i>option</i> = IncludeCategoryData, const QLandmarkCategoryId & <i>categoryId</i> = QLandmarkCategoryId() )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#importLandmarks-2">importLandmarks</a></b> ( const QString & <i>fileName</i>, const QString & <i>format</i> = QString(), QLandmarkManager::TransferOption <i>option</i> = IncludeCategoryData, const QLandmarkCategoryId & <i>categoryId</i> = QLandmarkCategoryId() )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#isFeatureSupported">isFeatureSupported</a></b> ( ManagerFeature <i>feature</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#isReadOnly">isReadOnly</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#isReadOnly-2">isReadOnly</a></b> ( const QLandmarkId & <i>landmarkId</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#isReadOnly-3">isReadOnly</a></b> ( const QLandmarkCategoryId & <i>categoryId</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLandmark </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmark">landmark</a></b> ( const QLandmarkId & <i>landmarkId</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkId> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarkIds">landmarkIds</a></b> ( const QLandmarkFilter & <i>filter</i>, int <i>limit</i>, int <i>offset</i>, const QList<QLandmarkSortOrder> & <i>sortOrders</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmarkId> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarkIds-2">landmarkIds</a></b> ( const QLandmarkFilter & <i>filter</i> = QLandmarkFilter(), int <i>limit</i> = -1, int <i>offset</i> = 0, const QLandmarkSortOrder & <i>sortOrder</i> = QLandmarkSortOrder() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmark> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarks">landmarks</a></b> ( const QLandmarkFilter & <i>filter</i>, int <i>limit</i>, int <i>offset</i>, const QList<QLandmarkSortOrder> & <i>sortOrders</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmark> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarks-2">landmarks</a></b> ( const QLandmarkFilter & <i>filter</i> = QLandmarkFilter(), int <i>limit</i> = -1, int <i>offset</i> = 0, const QLandmarkSortOrder & <i>sortOrder</i> = QLandmarkSortOrder() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QLandmark> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarks-3">landmarks</a></b> ( const QList<QLandmarkId> & <i>landmarkIds</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#managerName">managerName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<QString, QString> </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#managerParameters">managerParameters</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#managerUri">managerUri</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#managerVersion">managerVersion</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#removeCategory">removeCategory</a></b> ( const QLandmarkCategoryId & <i>categoryId</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#removeCategory-2">removeCategory</a></b> ( const QLandmarkCategory & <i>category</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#removeLandmark">removeLandmark</a></b> ( const QLandmarkId & <i>landmarkId</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#removeLandmark-2">removeLandmark</a></b> ( const QLandmark & <i>landmark</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#removeLandmarks">removeLandmarks</a></b> ( const QList<QLandmarkId> & <i>landmarkIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#removeLandmarks-2">removeLandmarks</a></b> ( const QList<QLandmark> & <i>landmarks</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#saveCategory">saveCategory</a></b> ( QLandmarkCategory * <i>category</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#saveLandmark">saveLandmark</a></b> ( QLandmark * <i>landmark</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#saveLandmarks">saveLandmarks</a></b> ( QList<QLandmark> * <i>landmarks</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#searchableLandmarkAttributeKeys">searchableLandmarkAttributeKeys</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> SupportLevel </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#sortOrderSupportLevel">sortOrderSupportLevel</a></b> ( const QLandmarkSortOrder & <i>sortOrder</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#supportedFormats">supportedFormats</a></b> ( TransferOperation <i>operation</i> ) const</td></tr>
</table>
<ul>
<li class="fn">29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#categoriesAdded">categoriesAdded</a></b> ( const QList<QLandmarkCategoryId> & <i>categoryIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#categoriesChanged">categoriesChanged</a></b> ( const QList<QLandmarkCategoryId> & <i>categoryIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#categoriesRemoved">categoriesRemoved</a></b> ( const QList<QLandmarkCategoryId> & <i>categoryIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#dataChanged">dataChanged</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarksAdded">landmarksAdded</a></b> ( const QList<QLandmarkId> & <i>landmarkIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarksChanged">landmarksChanged</a></b> ( const QList<QLandmarkId> & <i>landmarkIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#landmarksRemoved">landmarksRemoved</a></b> ( const QList<QLandmarkId> & <i>landmarkIds</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">QObject</a></li>
</ul>
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> const QLatin1Constant </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#Gpx-var">Gpx</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QLatin1Constant </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#Kml-var">Kml</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QLatin1Constant </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#Kmz-var">Kmz</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> const QLatin1Constant </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#Lmx-var">Lmx</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#availableManagers">availableManagers</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#buildUri">buildUri</a></b> ( const QString & <i>managerName</i>, const QMap<QString, QString> & <i>params</i>, int <i>implementationVersion</i> = -1 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QLandmarkManager * </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#fromUri">fromUri</a></b> ( const QString & <i>storeUri</i>, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanager.html#parseUri">parseUri</a></b> ( const QString & <i>uri</i>, QString * <i>pManagerName</i>, QMap<QString, QString> * <i>pParams</i> )</td></tr>
</table>
<ul>
<li class="fn">4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
<li class="fn">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
<li class="fn">1 public variable inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-variables">QObject</a></li>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li class="fn">2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QLandmarkManager-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QLandmarkManager class provides an interface for storage and retrieval of landmarks from a landmark store.</p>
<p>The QLandmarkManager is the starting class to use when working with landmarks. It effectively represents a landmark datastore and it provides the synchronous operations for the creation, retrieval, updating and deletion of both landmarks and categories. For asynchronous operations use the <a href="location-overview.html#asynchronous-landmark-requests">request classes</a> which use the manager as a parameter. The manager provides notifications whenever landmarks or categories are added, updated or removed.</p>
<p>Each manager is identified by a manager name which typically takes the form of a reverse domain string such as <tt>com.nokia.qt.landmarks.engines.sqlite</tt>. However every supported platform provides a default manager which may be instantiated without having to provide a name like so:</p>
<pre class="cpp"> <span class="type">QLandmarkManager</span> <span class="operator">*</span>landmarkManager <span class="operator">=</span> <span class="keyword">new</span> <span class="type">QLandmarkManager</span>();</pre>
<a name="retrieval-operations"></a>
<h3>Retrieval Operations</h3>
<p>To retrieve a set of landmarks we provide may provide a <a href="qlandmarkfilter.html">QLandmarkFilter</a>, <a href="qlandmarksortorder.html">QLandmarkSortOrder</a> and limit and offset as necessary. The <a href="qlandmarkfilter.html">QLandmarkFilter</a> defines the criteria for selecting landmarks; for example, a <a href="qlandmarkcategoryfilter.html">QLandmarkCategoryFilter</a> may be used to choose landmarks that belong to a certain category. A <a href="qlandmarksortorder.html">QLandmarkSortOrder</a> order defines how the results should be sorted. (Note that if you wish to sort by distance, you should use a proxmity filter, see <a href="qlandmarkproximityfilter.html">QLandmarkProximityFilter</a>). The limit allows specification of the maximum number of items to return and the offset defines the index of the first item. The following demonstrates how to search for the first 100 landmarks belonging to a given category, sorted by name.</p>
<pre class="cpp"> <span class="type"><a href="qlandmarkcategoryfilter.html">QLandmarkCategoryFilter</a></span> filter;
filter<span class="operator">.</span>setCategoryId(category<span class="operator">.</span>categoryId());
<span class="type"><a href="qlandmarknamesort.html">QLandmarkNameSort</a></span> nameSort;
nameSort<span class="operator">.</span>setDirection(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qt.html">Qt</a></span><span class="operator">::</span>AscendingOrder);
landmarkManager<span class="operator">-</span><span class="operator">></span>landmarks(filter<span class="operator">,</span> <span class="number">100</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> nameSort);</pre>
<p>The set of parameters described above are not always necessary as defaults are provided, if we wanted to retrieve all landmarks, then the appropriate call is:</p>
<pre class="cpp"> landmarkManager<span class="operator">-</span><span class="operator">></span>landmarks();</pre>
<p><b>Note:</b> Landmark retrieval is potentially a long operation, the synchronous API provided by the manager is subject to blocking. It is generally recommended that the <a href="qlandmarkfetchrequest.html">QLandmarkFetchRequest</a> be used because it behaves asynchronously.</p>
<p>Categories may be retrieved in a similar manner:</p>
<pre class="cpp"> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator"><</span><span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span><span class="operator">></span> categories <span class="operator">=</span> landmarkManager<span class="operator">-</span><span class="operator">></span>categories();</pre>
<a name="saving-and-deleting"></a>
<h3>Saving and Deleting</h3>
<p>Saving and deleting landmarks and categories are fairly straightforward. To add a new landmark or category simply instantiate a <a href="qlandmark.html">QLandmark</a> or <a href="qlandmarkcategory.html">QLandmarkCategory</a>, set its data fields (e.g., name, coordinate, etc.) and pass a pointer to the appropriate save operation. For example:</p>
<pre class="cpp"> <span class="type"><a href="qlandmark.html">QLandmark</a></span> monks;
monks<span class="operator">.</span>setName(<span class="string">"Monk's cafe"</span>);
<span class="comment">//..</span>
landmarkManager<span class="operator">-</span><span class="operator">></span>saveLandmark(<span class="operator">&</span>monks);</pre>
<p>We pass the landmark by pointer bcause it will be assigned a new <a href="qlandmarkid.html">QLandmarkId</a> when the function call is done. Saving a landmark with a valid id already set will update the existing landmark.</p>
<p>Removal of landmark may be done as follows:</p>
<pre class="cpp"> landmarkManager<span class="operator">-</span><span class="operator">></span>removeLandmark(landmark);</pre>
<a name="importing-and-exporting"></a>
<h3>Importing and Exporting</h3>
<p>Import and export are potentially long operations, to perform these operations asynchronously see <a href="qlandmarkimportrequest.html">QLandmarkImportRequest</a> and <a href="qlandmarkexportrequest.html">QLandmarkExportRequest</a>. The simplest way to perform an import is to supply a file name while an export will need both a file name and format.</p>
<pre class="cpp"> landmarkManager<span class="operator">-</span><span class="operator">></span>importLandmarks(<span class="string">"places.gpx"</span>);
landmarkManager<span class="operator">-</span><span class="operator">></span>exportLandmarks(<span class="string">"myplaces.gpx"</span><span class="operator">,</span><span class="type">QLandmarkManager</span><span class="operator">::</span>Gpx);</pre>
<p>The formats supported for import and export can be found by calling the <a href="qlandmarkmanager.html#supportedFormats">supportedFormats</a>() function with the type of operation to be performed, either <a href="qlandmarkmanager.html#TransferOperation-enum">ImportOperation</a> or <a href="qlandmarkmanager.html#TransferOperation-enum">ExportOperation</a>.</p>
</div>
<!-- @@@QLandmarkManager -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$Error$$$NoError$$$DoesNotExistError$$$LandmarkDoesNotExistError$$$CategoryDoesNotExistError$$$AlreadyExistsError$$$LockedError$$$PermissionsError$$$OutOfMemoryError$$$VersionMismatchError$$$NotSupportedError$$$BadArgumentError$$$InvalidManagerError$$$ParsingError$$$CancelError$$$UnknownError -->
<h3 class="fn"><a name="Error-enum"></a>enum QLandmarkManager::<span class="name">Error</span></h3>
<p>Defines the possible errors for the landmark manager.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">No error occurred</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::DoesNotExistError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The most recent operation failed due to an item not being found, usually an import file.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::LandmarkDoesNotExistError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The most recent operation failed due to a specified landmark not being found.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::CategoryDoesNotExistError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">The most recent operation faied due to a specified category not being found.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::AlreadyExistsError</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The most recent operation failed because the specified landmark or category already exists.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::LockedError</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">The most recent operation failed because the datastore specified is currently locked.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::PermissionsError</tt></td><td class="topAlign"><tt>6</tt></td><td class="topAlign">The most recent operation failed because the caller does not have permission to perform the operation.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::OutOfMemoryError</tt></td><td class="topAlign"><tt>7</tt></td><td class="topAlign">The most recent operation failed due to running out of memory.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::VersionMismatchError</tt></td><td class="topAlign"><tt>8</tt></td><td class="topAlign">The most recent operation failed because the backend of the manager is not of the required version.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::NotSupportedError</tt></td><td class="topAlign"><tt>9</tt></td><td class="topAlign">The most recent operation failed because the requested operation is not supported by the manager.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::BadArgumentError</tt></td><td class="topAlign"><tt>10</tt></td><td class="topAlign">The most recent operation failed because one or more of the parameters to the operation were invalid.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::InvalidManagerError</tt></td><td class="topAlign"><tt>11</tt></td><td class="topAlign">The most recent operation failed because the manager failed to initialize correctly and is invalid. This could be due using a manager name that is not recognised/available. A landmark request object will return this error if if is assigned a null manager pointer.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::ParsingError</tt></td><td class="topAlign"><tt>12</tt></td><td class="topAlign">The most recent operation failed because the imported file could not be parsed.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::CancelError</tt></td><td class="topAlign"><tt>13</tt></td><td class="topAlign">The most recent operation failed to complete due to user cancelation.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::UnknownError</tt></td><td class="topAlign"><tt>14</tt></td><td class="topAlign">The most recent operation failed for an unknown reason.</td></tr>
</table>
<!-- @@@Error -->
<!-- $$$ManagerFeature$$$ImportExportFeature$$$NotificationsFeature -->
<h3 class="fn"><a name="ManagerFeature-enum"></a>enum QLandmarkManager::<span class="name">ManagerFeature</span></h3>
<p>Defines the possible features the landmark manager can support.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::ImportExportFeature</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The manager supports import and/or export operations</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::NotificationsFeature</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The manager will emit notification signals when landmarks/categories have been added/modified/removed from the datastore it manages.</td></tr>
</table>
<!-- @@@ManagerFeature -->
<!-- $$$SupportLevel$$$NativeSupport$$$EmulatedSupport$$$NoSupport -->
<h3 class="fn"><a name="SupportLevel-enum"></a>enum QLandmarkManager::<span class="name">SupportLevel</span></h3>
<p>Defines the possible support levels the manager can provide for a given filter or sort order list.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::NativeSupport</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The manager natively supports the filter or sort order list.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::EmulatedSupport</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The manager emulates the behaviour of the filter or sort order list. Emulated behaviour will inherently be slower than a natively supported implementation.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::NoSupport</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The manager does not support the filter or sort order list at all.</td></tr>
</table>
<!-- @@@SupportLevel -->
<!-- $$$TransferOperation$$$ImportOperation$$$ExportOperation -->
<h3 class="fn"><a name="TransferOperation-enum"></a>enum QLandmarkManager::<span class="name">TransferOperation</span></h3>
<p>Defines the type of transfer.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::ImportOperation</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Landmarks are being copied from a file to the device.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::ExportOperation</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Landmarks are being copied from the device to a file.</td></tr>
</table>
<!-- @@@TransferOperation -->
<!-- $$$TransferOption$$$IncludeCategoryData$$$ExcludeCategoryData$$$AttachSingleCategory -->
<h3 class="fn"><a name="TransferOption-enum"></a>enum QLandmarkManager::<span class="name">TransferOption</span></h3>
<p>Defines the possible options when transferring landmarks during import or export.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::IncludeCategoryData</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">During an import, category data is included. If an imported category doesn't exist the category is created. If the imported category name matches an existing category name, then the landmark is added to that category. For exports, categories are included in the exported file if the file format allows it.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::ExcludeCategoryData</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Landmarks are imported or exported without any categories assigned to the landmarks.</td></tr>
<tr><td class="topAlign"><tt>QLandmarkManager::AttachSingleCategory</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Only relevant for import operations. When landmarks are imported they are all assigned to a given category.</td></tr>
</table>
<!-- @@@TransferOption -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QLandmarkManager[overload1]$$$QLandmarkManagerQObject* -->
<h3 class="fn"><a name="QLandmarkManager"></a>QLandmarkManager::<span class="name">QLandmarkManager</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a <a href="qlandmarkmanager.html">QLandmarkManager</a>. The default manager implementation for the platform will be used.</p>
<p>The <i>parent</i> <a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> will be used as the parent of this <a href="qlandmarkmanager.html">QLandmarkManager</a>.</p>
<!-- @@@QLandmarkManager -->
<!-- $$$QLandmarkManager$$$QLandmarkManagerconstQString&constQMap<QString,QString>&QObject* -->
<h3 class="fn"><a name="QLandmarkManager-2"></a>QLandmarkManager::<span class="name">QLandmarkManager</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>managerName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> & <i>parameters</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a <a href="qlandmarkmanager.html">QLandmarkManager</a> whose implementation is identified by <i>managerName</i> with the given <i>parameters</i>.</p>
<p>The <i>parent</i> <a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> will be used as the parent of this <a href="qlandmarkmanager.html">QLandmarkManager</a>.</p>
<p>If an empty <i>managerName</i> is specified, the default manager implementation for the platform will be used.</p>
<!-- @@@QLandmarkManager -->
<!-- $$$~QLandmarkManager[overload1]$$$~QLandmarkManager -->
<h3 class="fn"><a name="dtor.QLandmarkManager"></a>QLandmarkManager::<span class="name">~QLandmarkManager</span> ()<tt> [virtual]</tt></h3>
<p>Frees the memory used by the <a href="qlandmarkmanager.html">QLandmarkManager</a></p>
<!-- @@@~QLandmarkManager -->
<!-- $$$availableManagers[overload1]$$$availableManagers -->
<h3 class="fn"><a name="availableManagers"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QLandmarkManager::<span class="name">availableManagers</span> ()<tt> [static]</tt></h3>
<p>Returns a list of available manager names that can be used when constructing a <a href="qlandmarkmanager.html">QLandmarkManager</a></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@availableManagers -->
<!-- $$$buildUri[overload1]$$$buildUriconstQString&constQMap<QString,QString>&int -->
<h3 class="fn"><a name="buildUri"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QLandmarkManager::<span class="name">buildUri</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>managerName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> & <i>params</i>, <span class="type">int</span> <i>implementationVersion</i> = -1 )<tt> [static]</tt></h3>
<p>Returns a URI that completely describes a manager implementation/datastore, and the parameters with which to instantiate the manager, from the given <i>managerName</i>, <i>params</i> and an optional <i>implementationVersion</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@buildUri -->
<!-- $$$categories[overload1]$$$categoriesconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="categories"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>> QLandmarkManager::<span class="name">categories</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> & <i>categoryIds</i> ) const</h3>
<p>Returns a list of categories which match the given <i>categoryIds</i>.</p>
<p>This batch function will set per-input errors in the <a href="qlandmarkmanager.html#errorMap">QLandmarkManager::errorMap</a>();</p>
<p>The <a href="qlandmarkmanager.html#error">QLandmarkManager::error</a>() function will only return <tt>QLandmarkManager::NoError</tt> if all categories were successfully retrieved.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@categories -->
<!-- $$$categories$$$categoriesintintconstQLandmarkNameSort& -->
<h3 class="fn"><a name="categories-2"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>> QLandmarkManager::<span class="name">categories</span> ( <span class="type">int</span> <i>limit</i> = -1, <span class="type">int</span> <i>offset</i> = 0, const <span class="type"><a href="qlandmarknamesort.html">QLandmarkNameSort</a></span> & <i>nameSort</i> = QLandmarkNameSort() ) const</h3>
<p>Returns a list of categories.The <i>limit</i> defines the maximum number of categories to return and the <i>offset</i> defines the index offset of the first category. A <i>limit</i> of -1 means all categories should be returned(a limit of 0 means zero categories are returned). The categories are returned in the order as designated by <i>nameSort</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@categories -->
<!-- $$$categoriesAdded[overload1]$$$categoriesAddedconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="categoriesAdded"></a><span class="type">void</span> QLandmarkManager::<span class="name">categoriesAdded</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> & <i>categoryIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when categories (identified by <i>categoryIds</i>) have been added to the datastore managed by this manager. This signal is not emitted if the <a href="qlandmarkmanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#categoriesChanged">categoriesChanged</a>() and <a href="qlandmarkmanager.html#categoriesRemoved">categoriesRemoved</a>().</p>
<!-- @@@categoriesAdded -->
<!-- $$$categoriesChanged[overload1]$$$categoriesChangedconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="categoriesChanged"></a><span class="type">void</span> QLandmarkManager::<span class="name">categoriesChanged</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> & <i>categoryIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when categories (identified by <i>categoryIds</i>) have been modified in the datastore managed by this manager. This signal is not emitted if the <a href="qlandmarkmanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#categoriesAdded">categoriesAdded</a>() and <a href="qlandmarkmanager.html#categoriesRemoved">categoriesRemoved</a>().</p>
<!-- @@@categoriesChanged -->
<!-- $$$categoriesRemoved[overload1]$$$categoriesRemovedconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="categoriesRemoved"></a><span class="type">void</span> QLandmarkManager::<span class="name">categoriesRemoved</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> & <i>categoryIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when categories (identified by <i>categoryIds</i>) have been removed from the datastore managed by this manager. This signal is not emitted if the <a href="qlandmarkmanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#categoriesAdded">categoriesAdded</a>() and <a href="qlandmarkmanager.html#categoriesChanged">categoriesChanged</a>().</p>
<!-- @@@categoriesRemoved -->
<!-- $$$category[overload1]$$$categoryconstQLandmarkCategoryId& -->
<h3 class="fn"><a name="category"></a><span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span> QLandmarkManager::<span class="name">category</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> & <i>categoryId</i> ) const</h3>
<p>Returns the cateory in the database identified by <i>categoryId</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@category -->
<!-- $$$categoryIds[overload1]$$$categoryIdsintintconstQLandmarkNameSort& -->
<h3 class="fn"><a name="categoryIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>> QLandmarkManager::<span class="name">categoryIds</span> ( <span class="type">int</span> <i>limit</i> = -1, <span class="type">int</span> <i>offset</i> = 0, const <span class="type"><a href="qlandmarknamesort.html">QLandmarkNameSort</a></span> & <i>nameSort</i> = QLandmarkNameSort() ) const</h3>
<p>Returns a list of category identifiers. The <i>limit</i> defines the maximum number of ids to return and the <i>offset</i> defines the index offset of the first id. A <i>limit</i> of -1 means ids for all categories should be returned. The identifiers are returned in order as designed by <i>nameSort</i>. Note that a limit of 0 will return zero category ids.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@categoryIds -->
<!-- $$$dataChanged[overload1]$$$dataChanged -->
<h3 class="fn"><a name="dataChanged"></a><span class="type">void</span> QLandmarkManager::<span class="name">dataChanged</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted by the manager if its internal state changes and it is unable to precisely determine the changes which occurred, or if the manager considers the changes to be radical enough to require clients to reload all data. If the signal is emitted, no other signals will be emitted for the associated changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@dataChanged -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qlandmarkmanager.html#Error-enum">Error</a></span> QLandmarkManager::<span class="name">error</span> () const</h3>
<p>Returns the error code of the most recent operation. All functions will modify the error based on whether the operation successfully or not.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@error -->
<!-- $$$errorMap[overload1]$$$errorMap -->
<h3 class="fn"><a name="errorMap"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>> QLandmarkManager::<span class="name">errorMap</span> () const</h3>
<p>Returns per-input error codes for the most recent operation. This function only returns meaningful information if the most recent operation was a batch operation. The keys in the map correspond to the index of the input list. The error map is only populated for indexes at which an error occurred. Eg If we saved 5 landmarks and an error occurred at index 3, the error map will have only a single key for index 3.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#error">error</a>(), <a href="qlandmarkmanager.html#categories">categories</a>(), <a href="qlandmarkmanager.html#landmarks">landmarks</a>(), <a href="qlandmarkmanager.html#saveLandmarks">saveLandmarks</a>(), <a href="qlandmarkmanager.html#removeCategory">removeCategory</a>(), and <a href="qlandmarkmanager.html#removeLandmarks">removeLandmarks</a>().</p>
<!-- @@@errorMap -->
<!-- $$$errorString[overload1]$$$errorString -->
<h3 class="fn"><a name="errorString"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QLandmarkManager::<span class="name">errorString</span> () const</h3>
<p>Returns a short human-readable description of the error that occurred in the most recent operation. The error string is intended to be used by developers and is not suitable for showing to end users.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@errorString -->
<!-- $$$exportLandmarks[overload1]$$$exportLandmarksQIODevice*constQString&constQList<QLandmarkId>&QLandmarkManager::TransferOption -->
<h3 class="fn"><a name="exportLandmarks"></a><span class="type">bool</span> QLandmarkManager::<span class="name">exportLandmarks</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a></span> * <i>device</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>format</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> = QList<QLandmarkId> (), <span class="type"><a href="qlandmarkmanager.html#TransferOption-enum">QLandmarkManager::TransferOption</a></span> <i>option</i> = IncludeCategoryData ) const</h3>
<p>Writes landmarks to the given <i>device</i>. The landmarks will be written according to the specified <i>format</i>. If <i>landmarkIds</i> is empty, then all landmarks will be exported, otherwise only those landmarks that match <i>landmarkIds</i> will be exported.</p>
<p>The <i>option</i> can be used to control whether categories will be exported or not. Note that the <tt>AttachSingleCategory</tt> option has no meaning during export and the manager will export as if <i>option</i> was <tt>IncludeCategoryData</tt>. Also, be aware that some file formats may not support categories at all and for these formats, the <i>option</i> is always treated as if it was <tt>ExcludeCategoryData</tt>.</p>
<p>Returns true if all specified landmarks were successfully exported, otherwise returns false. It may be possible that only a subset of landmarks are exported.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@exportLandmarks -->
<!-- $$$exportLandmarks$$$exportLandmarksconstQString&constQString&constQList<QLandmarkId>&QLandmarkManager::TransferOption -->
<h3 class="fn"><a name="exportLandmarks-2"></a><span class="type">bool</span> QLandmarkManager::<span class="name">exportLandmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>fileName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>format</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> = QList<QLandmarkId> (), <span class="type"><a href="qlandmarkmanager.html#TransferOption-enum">QLandmarkManager::TransferOption</a></span> <i>option</i> = IncludeCategoryData ) const</h3>
<p>Convenience function that will write landmarks to <i>fileName</i> in the expected <i>format</i>. Internally a <a href="http://qt.nokia.com/doc/4.7/qfile.html">QFile</a> is opened with <a href="http://qt.nokia.com/doc/4.7/qiodevice.html#OpenModeFlag-enum">QIODevice::WriteOnly</a> permissions. If <i>landmarkIds</i> is empty, then all landmarks will be exported, otherwise only those landmarks that match <i>landmarkIds</i> will be exported.</p>
<p>The <i>option</i> can be used to control whether categories will be exported or not. Note that the <tt>AttachSingleCategory</tt> option has no meaning during export and the manager will export as if <i>option</i> was <tt>IncludeCategoryData</tt>. Also, be aware that some file formats may not support categories at all and for these formats, the <i>option</i> is always treated as if it was <tt>ExcludeCategoryData</tt>.</p>
<p>Returns true if all specified landmarks were successfully exported, otherwise returns false. It may be possible that only a subset of landmarks are exported.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@exportLandmarks -->
<!-- $$$filterSupportLevel[overload1]$$$filterSupportLevelconstQLandmarkFilter& -->
<h3 class="fn"><a name="filterSupportLevel"></a><span class="type"><a href="qlandmarkmanager.html#SupportLevel-enum">SupportLevel</a></span> QLandmarkManager::<span class="name">filterSupportLevel</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> & <i>filter</i> ) const</h3>
<p>Returns the support level the manager provides for the given <i>filter</i>. For the case of intersection and union filters, whether the elements will be individually processed is dependent on the particular manager implementation.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@filterSupportLevel -->
<!-- $$$fromUri[overload1]$$$fromUriconstQString&QObject* -->
<h3 class="fn"><a name="fromUri"></a><span class="type">QLandmarkManager</span> * QLandmarkManager::<span class="name">fromUri</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>storeUri</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )<tt> [static]</tt></h3>
<p>Constructs a <a href="qlandmarkmanager.html">QLandmarkManager</a> whose implementation, store and parameters are specified in the given <i>storeUri</i>, and whose parent object is <i>parent</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@fromUri -->
<!-- $$$importLandmarks[overload1]$$$importLandmarksQIODevice*constQString&QLandmarkManager::TransferOptionconstQLandmarkCategoryId& -->
<h3 class="fn"><a name="importLandmarks"></a><span class="type">bool</span> QLandmarkManager::<span class="name">importLandmarks</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qiodevice.html">QIODevice</a></span> * <i>device</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>format</i> = QString(), <span class="type"><a href="qlandmarkmanager.html#TransferOption-enum">QLandmarkManager::TransferOption</a></span> <i>option</i> = IncludeCategoryData, const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> & <i>categoryId</i> = QLandmarkCategoryId() )</h3>
<p>Reads landmarks from the given <i>device</i> and saves them. The data from the <i>device</i> is expected to adhere to the provided <i>format</i>. If no <i>format</i> is provided, the manager tries to auto detect the <i>format</i>.</p>
<p>The <i>option</i> can be used to control whether categories in the imported file will be added during the import. If the <tt>AttachSingleCategory</tt> option is used, then all the landmarks in the import file are assigned to the category identified by <i>categoryId</i>, in all other circumstances <i>categoryId</i> is ignored. If <i>categoryId</i> doesn't exist when using <tt>AttachSingleCategory</tt>, <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::CategoryDoesNotExistError</a> is set. Note that some file formats may not support categories at all.</p>
<p>Returns true if all landmarks could be imported, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@importLandmarks -->
<!-- $$$importLandmarks$$$importLandmarksconstQString&constQString&QLandmarkManager::TransferOptionconstQLandmarkCategoryId& -->
<h3 class="fn"><a name="importLandmarks-2"></a><span class="type">bool</span> QLandmarkManager::<span class="name">importLandmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>fileName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>format</i> = QString(), <span class="type"><a href="qlandmarkmanager.html#TransferOption-enum">QLandmarkManager::TransferOption</a></span> <i>option</i> = IncludeCategoryData, const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> & <i>categoryId</i> = QLandmarkCategoryId() )</h3>
<p>Convenience function that will read landmarks from <i>fileName</i> in the expected <i>format</i>. If no <i>format</i> is provided, the manager tries to auto detect the <i>format</i>. Internally a <a href="http://qt.nokia.com/doc/4.7/qfile.html">QFile</a> is opened with <a href="http://qt.nokia.com/doc/4.7/qiodevice.html#OpenModeFlag-enum">QIODevice::ReadOnly</a> permissions.</p>
<p>The <i>option</i> can be used to control whether categories in the imported file will be added during the import. If the <tt>AttachSingleCategory</tt> option is used, then all the landmarks in the import file are assigned to the category identified by <i>categoryId</i>, in all other circumstances <i>categoryId</i> is ignored. If <i>categoryId</i> doesn't exist when using <tt>AttachSingleCategory</tt>, <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::CategoryDoesNotExistError</a> is set. Note that some file formats may not support categories at all.</p>
<p>Returns true if all landmarks could be imported, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@importLandmarks -->
<!-- $$$isFeatureSupported[overload1]$$$isFeatureSupportedManagerFeature -->
<h3 class="fn"><a name="isFeatureSupported"></a><span class="type">bool</span> QLandmarkManager::<span class="name">isFeatureSupported</span> ( <span class="type"><a href="qlandmarkmanager.html#ManagerFeature-enum">ManagerFeature</a></span> <i>feature</i> ) const</h3>
<p>Returns whether the manager supports the given <i>feature</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isFeatureSupported -->
<!-- $$$isReadOnly[overload1]$$$isReadOnly -->
<h3 class="fn"><a name="isReadOnly"></a><span class="type">bool</span> QLandmarkManager::<span class="name">isReadOnly</span> () const</h3>
<p>Returns true if the manager is entirely read-only. Meaning landmarks and categories cannot be added, modified or removed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isReadOnly -->
<!-- $$$isReadOnly$$$isReadOnlyconstQLandmarkId& -->
<h3 class="fn"><a name="isReadOnly-2"></a><span class="type">bool</span> QLandmarkManager::<span class="name">isReadOnly</span> ( const <span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span> & <i>landmarkId</i> ) const</h3>
<p>Returns true if the landmark identified by <i>landmarkId</i> considered read-only by the manager.</p>
<p>If the <i>landmarkId</i> does not refer to an existing landmark, it is considered writable unless the manager is exclusively read-only.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isReadOnly -->
<!-- $$$isReadOnly$$$isReadOnlyconstQLandmarkCategoryId& -->
<h3 class="fn"><a name="isReadOnly-3"></a><span class="type">bool</span> QLandmarkManager::<span class="name">isReadOnly</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> & <i>categoryId</i> ) const</h3>
<p>Returns true if the category identified by <i>categoryId</i> is considered read-only by the manager.</p>
<p>If <i>categoryId</i> does not refer to an existing category, it is considered writable unless the manager is exclusively read-only.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isReadOnly -->
<!-- $$$landmark[overload1]$$$landmarkconstQLandmarkId& -->
<h3 class="fn"><a name="landmark"></a><span class="type"><a href="qlandmark.html">QLandmark</a></span> QLandmarkManager::<span class="name">landmark</span> ( const <span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span> & <i>landmarkId</i> ) const</h3>
<p>Returns the landmark in the database identified by <i>landmarkId</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmark -->
<!-- $$$landmarkIds[overload1]$$$landmarkIdsconstQLandmarkFilter&intintconstQList<QLandmarkSortOrder>& -->
<h3 class="fn"><a name="landmarkIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> QLandmarkManager::<span class="name">landmarkIds</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> & <i>filter</i>, <span class="type">int</span> <i>limit</i>, <span class="type">int</span> <i>offset</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>> & <i>sortOrders</i> ) const</h3>
<p>Returns a list of landmark identifiers which match the given <i>filter</i> and are sorted according to the given <i>sortOrders</i>. The <i>limit</i> defines the maximum number of landmark ids to return and the <i>offset</i> defines the index offset of the first landmark id. A <i>limit</i> of -1 means that ids of all matching landmarks should be returned. Note that a limit of 0 will return zero landmark ids.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarkIds -->
<!-- $$$landmarkIds$$$landmarkIdsconstQLandmarkFilter&intintconstQLandmarkSortOrder& -->
<h3 class="fn"><a name="landmarkIds-2"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> QLandmarkManager::<span class="name">landmarkIds</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> & <i>filter</i> = QLandmarkFilter(), <span class="type">int</span> <i>limit</i> = -1, <span class="type">int</span> <i>offset</i> = 0, const <span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span> & <i>sortOrder</i> = QLandmarkSortOrder() ) const</h3>
<p>Convenience function to returns a list of landmark identifiers which match the given <i>filter</i> and are sorted according to the given <i>sortOrder</i>. The <i>limit</i> defines the maximum number of landmark ids to return and the <i>offset</i> defines the index offset of the first landmark id. A <i>limit</i> of -1 means that ids of all matching landmarks should be returned. Note that a limit of 0 will return zero landmark ids.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarkIds -->
<!-- $$$landmarks[overload1]$$$landmarksconstQLandmarkFilter&intintconstQList<QLandmarkSortOrder>& -->
<h3 class="fn"><a name="landmarks"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmark.html">QLandmark</a></span>> QLandmarkManager::<span class="name">landmarks</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> & <i>filter</i>, <span class="type">int</span> <i>limit</i>, <span class="type">int</span> <i>offset</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>> & <i>sortOrders</i> ) const</h3>
<p>Returns a list of landmarks which match the given <i>filter</i> and are sorted according to the <i>sortOrders</i>. The <i>limit</i> defines the maximum number of landmarks to return and the <i>offset</i> defines the index offset of the first landmark. A <i>limit</i> of -1 means all matching landmarks should be returned.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarks -->
<!-- $$$landmarks$$$landmarksconstQLandmarkFilter&intintconstQLandmarkSortOrder& -->
<h3 class="fn"><a name="landmarks-2"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmark.html">QLandmark</a></span>> QLandmarkManager::<span class="name">landmarks</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> & <i>filter</i> = QLandmarkFilter(), <span class="type">int</span> <i>limit</i> = -1, <span class="type">int</span> <i>offset</i> = 0, const <span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span> & <i>sortOrder</i> = QLandmarkSortOrder() ) const</h3>
<p>Returns a list of landmarks which match the given <i>filter</i> and are sorted according to the <i>sortOrder</i>. The <i>limit</i> defines the maximum number of landmarks to return and the <i>offset</i> defines the index offset of the first landmark. A <i>limit</i> of -1 means all matching landmarks should be returned and that a limit of 0 will return zero landmarks.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarks -->
<!-- $$$landmarks$$$landmarksconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="landmarks-3"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmark.html">QLandmark</a></span>> QLandmarkManager::<span class="name">landmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> ) const</h3>
<p>Returns a list of landmarks which match the given <i>landmarkIds</i>.</p>
<p>This batch function will set per-input errors in the <a href="qlandmarkmanager.html#errorMap">QLandmarkManager::errorMap</a>().</p>
<p>The <a href="qlandmarkmanager.html#error">QLandmarkManager::error</a>() function will only return <tt>QLandmarkManager::NoError</tt> if all landmarks were successfully retrieved.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarks -->
<!-- $$$landmarksAdded[overload1]$$$landmarksAddedconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="landmarksAdded"></a><span class="type">void</span> QLandmarkManager::<span class="name">landmarksAdded</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when landmarks (identified by <i>landmarkIds</i>) have been added to the datastore managed by this manager. This signal is not emitted if the <a href="qlandmarkmanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#landmarksChanged">landmarksChanged</a>() and <a href="qlandmarkmanager.html#landmarksRemoved">landmarksRemoved</a>().</p>
<!-- @@@landmarksAdded -->
<!-- $$$landmarksChanged[overload1]$$$landmarksChangedconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="landmarksChanged"></a><span class="type">void</span> QLandmarkManager::<span class="name">landmarksChanged</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when landmarks (identified by <i>landmarkIds</i>) have been modified in the datastore managed by this manager. This signal is not emitted if the <a href="qlandmarkmanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes. Note that removal of a category will not trigger a <tt>landmarksChanged</tt> signal for landmarks belonging to that category.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#landmarksAdded">landmarksAdded</a>() and <a href="qlandmarkmanager.html#landmarksRemoved">landmarksRemoved</a>().</p>
<!-- @@@landmarksChanged -->
<!-- $$$landmarksRemoved[overload1]$$$landmarksRemovedconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="landmarksRemoved"></a><span class="type">void</span> QLandmarkManager::<span class="name">landmarksRemoved</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted when landmarks (identified by <i>landmarkIds</i>) have been removed from the datastore managed by this manager. This signal is not emitted if the <a href="qlandmarkmanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#landmarksAdded">landmarksAdded</a>() and <a href="qlandmarkmanager.html#landmarksChanged">landmarksChanged</a>().</p>
<!-- @@@landmarksRemoved -->
<!-- $$$managerName[overload1]$$$managerName -->
<h3 class="fn"><a name="managerName"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QLandmarkManager::<span class="name">managerName</span> () const</h3>
<p>Returns the manager name for this <a href="qlandmarkmanager.html">QLandmarkManager</a>.</p>
<p>The manager name usually takes the format of a reverse domain string. An example of a manager name is <tt>com.nokia.qt.landmarks.engines.sqlite</tt></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerName -->
<!-- $$$managerParameters[overload1]$$$managerParameters -->
<h3 class="fn"><a name="managerParameters"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> QLandmarkManager::<span class="name">managerParameters</span> () const</h3>
<p>Return the parameters relevant to the creation of this <a href="qlandmarkmanager.html">QLandmarkManager</a>.</p>
<p>The parameters may be viewed as a set of key-value pairs. Each manager may have a different set of parameters depending upon its backend implementation.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerParameters -->
<!-- $$$managerUri[overload1]$$$managerUri -->
<h3 class="fn"><a name="managerUri"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QLandmarkManager::<span class="name">managerUri</span> () const</h3>
<p>Return the uri describing this <a href="qlandmarkmanager.html">QLandmarkManager</a>, consisting of the manager name and any parameters.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerUri -->
<!-- $$$managerVersion[overload1]$$$managerVersion -->
<h3 class="fn"><a name="managerVersion"></a><span class="type">int</span> QLandmarkManager::<span class="name">managerVersion</span> () const</h3>
<p>Returns the engine backend implementation version number.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerVersion -->
<!-- $$$parseUri[overload1]$$$parseUriconstQString&QString*QMap<QString,QString>* -->
<h3 class="fn"><a name="parseUri"></a><span class="type">bool</span> QLandmarkManager::<span class="name">parseUri</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>uri</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>pManagerName</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> * <i>pParams</i> )<tt> [static]</tt></h3>
<p>Splits the given <i>uri</i> into the manager name and parameters that it describes, and places the information into the memory addressed by <i>pManagerName</i> and <i>pParams</i> respectively. Returns true if <i>uri</i> could be split successfully, otherwise returns false</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@parseUri -->
<!-- $$$removeCategory[overload1]$$$removeCategoryconstQLandmarkCategoryId& -->
<h3 class="fn"><a name="removeCategory"></a><span class="type">bool</span> QLandmarkManager::<span class="name">removeCategory</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> & <i>categoryId</i> )</h3>
<p>Remove the category identified by <i>categoryId</i> from the database.</p>
<p>Returns true if the category was removed successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeCategory -->
<!-- $$$removeCategory$$$removeCategoryconstQLandmarkCategory& -->
<h3 class="fn"><a name="removeCategory-2"></a><span class="type">bool</span> QLandmarkManager::<span class="name">removeCategory</span> ( const <span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span> & <i>category</i> )</h3>
<p>Remove the given <i>category</i> from the database</p>
<p>Returns true if the category was removed successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeCategory -->
<!-- $$$removeLandmark[overload1]$$$removeLandmarkconstQLandmarkId& -->
<h3 class="fn"><a name="removeLandmark"></a><span class="type">bool</span> QLandmarkManager::<span class="name">removeLandmark</span> ( const <span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span> & <i>landmarkId</i> )</h3>
<p>Remove the landmark identified by <i>landmarkId</i> from the database.</p>
<p>Returns true if the landmark was removed successfully, otherwise returnse false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeLandmark -->
<!-- $$$removeLandmark$$$removeLandmarkconstQLandmark& -->
<h3 class="fn"><a name="removeLandmark-2"></a><span class="type">bool</span> QLandmarkManager::<span class="name">removeLandmark</span> ( const <span class="type"><a href="qlandmark.html">QLandmark</a></span> & <i>landmark</i> )</h3>
<p>Removes the <i>landmark</i> from the database.</p>
<p>Returns true if the landmark was removed successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeLandmark -->
<!-- $$$removeLandmarks[overload1]$$$removeLandmarksconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="removeLandmarks"></a><span class="type">bool</span> QLandmarkManager::<span class="name">removeLandmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>> & <i>landmarkIds</i> )</h3>
<p>Removes every landmark whose identifier is contained in the list of <i>landmarkIds</i>. Returns true if all landmarks were removed successfully, otherwise false.</p>
<p>This batch function will set per-input errors in the <a href="qlandmarkmanager.html#errorMap">QLandmarkManager::errorMap</a>().</p>
<p>The <a href="qlandmarkmanager.html#error">QLandmarkManager::error</a>() function will only return <tt>QLandmarkManager::NoError</tt> if all landmarks were removed successfully.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#removeLandmark">QLandmarkManager::removeLandmark</a>().</p>
<!-- @@@removeLandmarks -->
<!-- $$$removeLandmarks$$$removeLandmarksconstQList<QLandmark>& -->
<h3 class="fn"><a name="removeLandmarks-2"></a><span class="type">bool</span> QLandmarkManager::<span class="name">removeLandmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmark.html">QLandmark</a></span>> & <i>landmarks</i> )</h3>
<p>Convenience function to remove the given <i>landmarks</i> from the database. Returns true if all landmarks were removed successfully, otherwise false.</p>
<p>This batch function will set per input errors in the <a href="qlandmarkmanager.html#errorMap">QLandmarkManager::errorMap</a>().</p>
<p>The <a href="qlandmarkmanager.html#error">QLandmarkManager::error</a>() function will only return <tt>QLandmarkManager::NoError</tt> if all landmarks were removed successfully.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#removeLandmark">QLandmarkManager::removeLandmark</a>().</p>
<!-- @@@removeLandmarks -->
<!-- $$$saveCategory[overload1]$$$saveCategoryQLandmarkCategory* -->
<h3 class="fn"><a name="saveCategory"></a><span class="type">bool</span> QLandmarkManager::<span class="name">saveCategory</span> ( <span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span> * <i>category</i> )</h3>
<p>Adds the given <i>category</i> to the database if <i>category</i> has a default-constructed identifier, or an identifier with the manager URI set to the URI of this manager and an empty id.</p>
<p>If the manager URI of the identifier of the <i>category</i> is neither empty nor equal to the URI of this manager, or the id member of the identifier is not empty, but does not exist in the manager, the operation will fail and calling <a href="qlandmarkmanager.html#error">error</a>() will return <tt>QLandmarkManager::CategoryDoesNotExistError</tt>.</p>
<p>Alternatively, the function will update the existing category in the database if <i>category</i> has a non-empty id and currently exists within the database.</p>
<p>Returns false on failure or true on success. On successful save of a category with an invalid id, it will be assigned a valid id and have its manager URI set to the URI of this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@saveCategory -->
<!-- $$$saveLandmark[overload1]$$$saveLandmarkQLandmark* -->
<h3 class="fn"><a name="saveLandmark"></a><span class="type">bool</span> QLandmarkManager::<span class="name">saveLandmark</span> ( <span class="type"><a href="qlandmark.html">QLandmark</a></span> * <i>landmark</i> )</h3>
<p>Adds the given <i>landmark</i> to the database if <i>landmark</i> has a default-constructed identifer, or an identifier with the manager URI set to the URI of this manager and an empty id.</p>
<p>If the manager URI of the identifier of the <i>landmark</i> is neither empty nor equal to the URI of this manager, or the id member of the identifier is not empty, but does not exist in the manager, the operation will fail and calling <a href="qlandmarkmanager.html#error">error</a>() will return <tt>QLandmarkManager::LandmarkDoesNotExistError</tt>.</p>
<p>Alternatively, the function will update the existing landmark in the database if <i>landmark</i> has a non-empty id and currently exists within the database.</p>
<p>Returns false on failure or true on success. On successful save of a landmark with an empty id, it will be assigned a valid id and have its manager URI set to the URI of this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@saveLandmark -->
<!-- $$$saveLandmarks[overload1]$$$saveLandmarksQList<QLandmark>* -->
<h3 class="fn"><a name="saveLandmarks"></a><span class="type">bool</span> QLandmarkManager::<span class="name">saveLandmarks</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qlandmark.html">QLandmark</a></span>> * <i>landmarks</i> )</h3>
<p>Adds the list of <i>landmarks</i> to the database. Returns true if the landmarks were saved successfully, otherwise returns false.</p>
<p>This function will set per-input errors in the <a href="qlandmarkmanager.html#errorMap">QLandmarkManager::errorMap</a>().</p>
<p>The <a href="qlandmarkmanager.html#error">QLandmarkManager::error</a>() function will only return <tt>QLandmarkManager::NoError</tt> if all landmarks were saved successfully.</p>
<p>For each new landmark that was successfully saved, a landmark identifier is assigned to that landmark.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@saveLandmarks -->
<!-- $$$searchableLandmarkAttributeKeys[overload1]$$$searchableLandmarkAttributeKeys -->
<h3 class="fn"><a name="searchableLandmarkAttributeKeys"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QLandmarkManager::<span class="name">searchableLandmarkAttributeKeys</span> () const</h3>
<p>Returns a list of landmark attribute keys that may be used in a <a href="qlandmarkattributefilter.html">QLandmarkAttributeFilter</a>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@searchableLandmarkAttributeKeys -->
<!-- $$$sortOrderSupportLevel[overload1]$$$sortOrderSupportLevelconstQLandmarkSortOrder& -->
<h3 class="fn"><a name="sortOrderSupportLevel"></a><span class="type"><a href="qlandmarkmanager.html#SupportLevel-enum">SupportLevel</a></span> QLandmarkManager::<span class="name">sortOrderSupportLevel</span> ( const <span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span> & <i>sortOrder</i> ) const</h3>
<p>Returns the support level the manager provides for the given <i>sortOrder</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@sortOrderSupportLevel -->
<!-- $$$supportedFormats[overload1]$$$supportedFormatsTransferOperation -->
<h3 class="fn"><a name="supportedFormats"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QLandmarkManager::<span class="name">supportedFormats</span> ( <span class="type"><a href="qlandmarkmanager.html#TransferOperation-enum">TransferOperation</a></span> <i>operation</i> ) const</h3>
<p>Returns the file formats supported for the given transfer <i>operation</i>. ie import or export.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedFormats -->
</div>
<div class="vars">
<h2>Member Variable Documentation</h2>
<!-- $$$Gpx -->
<h3 class="fn"><a name="Gpx-var"></a>const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> QLandmarkManager::<span class="name">Gpx</span></h3>
<p>The format constant to define using the gpx format in the import and export functions.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#importLandmarks">importLandmarks</a>() and <a href="qlandmarkmanager.html#exportLandmarks">exportLandmarks</a>().</p>
<!-- @@@Gpx -->
<!-- $$$Kml -->
<h3 class="fn"><a name="Kml-var"></a>const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> QLandmarkManager::<span class="name">Kml</span></h3>
<p>The format constant to define using the kml format in the import and export functions.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#importLandmarks">importLandmarks</a>() and <a href="qlandmarkmanager.html#exportLandmarks">exportLandmarks</a>().</p>
<!-- @@@Kml -->
<!-- $$$Kmz -->
<h3 class="fn"><a name="Kmz-var"></a>const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> QLandmarkManager::<span class="name">Kmz</span></h3>
<p>The format constant to define using the kmz format in the import and export functions.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#importLandmarks">importLandmarks</a>() and <a href="qlandmarkmanager.html#exportLandmarks">exportLandmarks</a>().</p>
<!-- @@@Kmz -->
<!-- $$$Lmx -->
<h3 class="fn"><a name="Lmx-var"></a>const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> QLandmarkManager::<span class="name">Lmx</span></h3>
<p>The format constant to define using the lmx format in the import and export functions.</p>
<p><b>See also </b><a href="qlandmarkmanager.html#importLandmarks">importLandmarks</a>() and <a href="qlandmarkmanager.html#exportLandmarks">exportLandmarks</a>().</p>
<!-- @@@Lmx -->
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 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.</p>
<p>
All other trademarks are property of their respective owners. <a title="Privacy Policy"
href="http://qt.nokia.com/about/privacy-policy">Privacy Policy</a></p>
<br />
<p>
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.</p>
<p>
Alternatively, this document may be used under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU
Free Documentation License version 1.3</a>
as published by the Free Software Foundation.</p>
</div>
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
50facae208d4a6f280e44a513b104320
>
files
>
1000
