Sophie

Sophie

distrib > Mageia > 5 > i586 > media > core-release > by-pkgid > 50facae208d4a6f280e44a513b104320 > files > 1002

qt-mobility-doc-1.2.0-13.mga5.noarch.rpm

<?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" />
<!-- qlandmarkmanagerengine.cpp -->
  <title>Qt Mobility 1.2: QLandmarkManagerEngine 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>QLandmarkManagerEngine</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-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>
</ul>
</div>
<h1 class="title">QLandmarkManagerEngine Class Reference</h1>
<!-- $$$QLandmarkManagerEngine-brief -->
<p>The QLandmarkManagerEngine class provides the interface for all implementations of the landmark manager backend functionality. <a href="#details">More...</a></p>
<!-- @@@QLandmarkManagerEngine -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QLandmarkManagerEngine&gt;</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="qlandmarkmanagerengine-members.html">List of all members, including inherited members</a></li>
</ul>
<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="qlandmarkmanagerengine.html#QLandmarkManagerEngine">QLandmarkManagerEngine</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#dtor.QLandmarkManagerEngine">~QLandmarkManagerEngine</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#cancelRequest">cancelRequest</a></b> ( QLandmarkAbstractRequest * <i>request</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList&lt;QLandmarkCategory&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#categories">categories</a></b> ( const QList&lt;QLandmarkCategoryId&gt; &amp; <i>categoryIds</i>, QMap&lt;int, QLandmarkManager::Error&gt; * <i>errorMap</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList&lt;QLandmarkCategory&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#categories-2">categories</a></b> ( int <i>limit</i>, int <i>offset</i>, const QLandmarkNameSort &amp; <i>nameSort</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QLandmarkCategory </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#category">category</a></b> ( const QLandmarkCategoryId &amp; <i>categoryId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList&lt;QLandmarkCategoryId&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#categoryIds">categoryIds</a></b> ( int <i>limit</i>, int <i>offset</i>, const QLandmarkNameSort &amp; <i>nameSort</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#exportLandmarks">exportLandmarks</a></b> ( QIODevice * <i>device</i>, const QString &amp; <i>format</i>, const QList&lt;QLandmarkId&gt; &amp; <i>landmarkIds</i>, QLandmarkManager::TransferOption <i>option</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QLandmarkManager::SupportLevel </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#filterSupportLevel">filterSupportLevel</a></b> ( const QLandmarkFilter &amp; <i>filter</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#importLandmarks">importLandmarks</a></b> ( QIODevice * <i>device</i>, const QString &amp; <i>format</i>, QLandmarkManager::TransferOption <i>option</i>, const QLandmarkCategoryId &amp; <i>categoryId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#isFeatureSupported">isFeatureSupported</a></b> ( QLandmarkManager::ManagerFeature <i>feature</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#isReadOnly">isReadOnly</a></b> ( QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#isReadOnly-2">isReadOnly</a></b> ( const QLandmarkId &amp; <i>landmarkId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#isReadOnly-3">isReadOnly</a></b> ( const QLandmarkCategoryId &amp; <i>categoryId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QLandmark </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmark">landmark</a></b> ( const QLandmarkId &amp; <i>landmarkId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList&lt;QLandmarkId&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmarkIds">landmarkIds</a></b> ( const QLandmarkFilter &amp; <i>filter</i>, int <i>limit</i>, int <i>offset</i>, const QList&lt;QLandmarkSortOrder&gt; &amp; <i>sortOrders</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList&lt;QLandmark&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmarks">landmarks</a></b> ( const QList&lt;QLandmarkId&gt; &amp; <i>landmarkIds</i>, QMap&lt;int, QLandmarkManager::Error&gt; * <i>errorMap</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QList&lt;QLandmark&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmarks-2">landmarks</a></b> ( const QLandmarkFilter &amp; <i>filter</i>, int <i>limit</i>, int <i>offset</i>, const QList&lt;QLandmarkSortOrder&gt; &amp; <i>sortOrders</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QString </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#managerName">managerName</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QMap&lt;QString, QString&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#managerParameters">managerParameters</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#managerUri">managerUri</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#managerVersion">managerVersion</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#removeCategory">removeCategory</a></b> ( const QLandmarkCategoryId &amp; <i>categoryId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#removeLandmark">removeLandmark</a></b> ( const QLandmarkId &amp; <i>landmarkId</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#removeLandmarks">removeLandmarks</a></b> ( const QList&lt;QLandmarkId&gt; &amp; <i>landmarkIds</i>, QMap&lt;int, QLandmarkManager::Error&gt; * <i>errorMap</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#requestDestroyed">requestDestroyed</a></b> ( QLandmarkAbstractRequest * <i>request</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#saveCategory">saveCategory</a></b> ( QLandmarkCategory * <i>category</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#saveLandmark">saveLandmark</a></b> ( QLandmark * <i>landmark</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#saveLandmarks">saveLandmarks</a></b> ( QList&lt;QLandmark&gt; * <i>landmarks</i>, QMap&lt;int, QLandmarkManager::Error&gt; * <i>errorMap</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QStringList </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#searchableLandmarkAttributeKeys">searchableLandmarkAttributeKeys</a></b> ( QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QLandmarkManager::SupportLevel </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#sortOrderSupportLevel">sortOrderSupportLevel</a></b> ( const QLandmarkSortOrder &amp; <i>sortOrder</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#startRequest">startRequest</a></b> ( QLandmarkAbstractRequest * <i>request</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QStringList </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#supportedFormats">supportedFormats</a></b> ( QLandmarkManager::TransferOperation <i>operation</i>, QLandmarkManager::Error * <i>error</i>, QString * <i>errorString</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#waitForRequestFinished">waitForRequestFinished</a></b> ( QLandmarkAbstractRequest * <i>request</i>, int <i>msecs</i> ) = 0</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="qlandmarkmanagerengine.html#categoriesAdded">categoriesAdded</a></b> ( const QList&lt;QLandmarkCategoryId&gt; &amp; <i>categoryIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#categoriesChanged">categoriesChanged</a></b> ( const QList&lt;QLandmarkCategoryId&gt; &amp; <i>categoryIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#categoriesRemoved">categoriesRemoved</a></b> ( const QList&lt;QLandmarkCategoryId&gt; &amp; <i>categoryIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmarksAdded">landmarksAdded</a></b> ( const QList&lt;QLandmarkId&gt; &amp; <i>landmarkIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmarksChanged">landmarksChanged</a></b> ( const QList&lt;QLandmarkId&gt; &amp; <i>landmarkIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#landmarksRemoved">landmarksRemoved</a></b> ( const QList&lt;QLandmarkId&gt; &amp; <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"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#addSorted">addSorted</a></b> ( QList&lt;QLandmark&gt; * <i>sorted</i>, const QLandmark &amp; <i>landmark</i>, const QList&lt;QLandmarkSortOrder&gt; &amp; <i>sortOrders</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#compareLandmark">compareLandmark</a></b> ( const QLandmark &amp; <i>a</i>, const QLandmark &amp; <i>b</i>, const QList&lt;QLandmarkSortOrder&gt; &amp; <i>sortOrders</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#compareName">compareName</a></b> ( const QLandmark &amp; <i>a</i>, const QLandmark &amp; <i>b</i>, const QLandmarkNameSort &amp; <i>nameSort</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QLandmarkId&gt; </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#sortLandmarks">sortLandmarks</a></b> ( const QList&lt;QLandmark&gt; &amp; <i>landmarks</i>, const QList&lt;QLandmarkSortOrder&gt; &amp; <i>sortOrders</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#testFilter">testFilter</a></b> ( const QLandmarkFilter &amp; <i>filter</i>, const QLandmark &amp; <i>landmark</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkCategoryFetchByIdRequest">updateLandmarkCategoryFetchByIdRequest</a></b> ( QLandmarkCategoryFetchByIdRequest * <i>req</i>, const QList&lt;QLandmarkCategory&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, const QMap&lt;int, QLandmarkManager::Error&gt; &amp; <i>errorMap</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkCategoryFetchRequest">updateLandmarkCategoryFetchRequest</a></b> ( QLandmarkCategoryFetchRequest * <i>req</i>, const QList&lt;QLandmarkCategory&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkCategoryIdFetchRequest">updateLandmarkCategoryIdFetchRequest</a></b> ( QLandmarkCategoryIdFetchRequest * <i>req</i>, const QList&lt;QLandmarkCategoryId&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkCategoryRemoveRequest">updateLandmarkCategoryRemoveRequest</a></b> ( QLandmarkCategoryRemoveRequest * <i>req</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, const QMap&lt;int, QLandmarkManager::Error&gt; &amp; <i>errorMap</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkCategorySaveRequest">updateLandmarkCategorySaveRequest</a></b> ( QLandmarkCategorySaveRequest * <i>req</i>, const QList&lt;QLandmarkCategory&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, const QMap&lt;int, QLandmarkManager::Error&gt; &amp; <i>errorMap</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkExportRequest">updateLandmarkExportRequest</a></b> ( QLandmarkExportRequest * <i>req</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkFetchByIdRequest">updateLandmarkFetchByIdRequest</a></b> ( QLandmarkFetchByIdRequest * <i>req</i>, const QList&lt;QLandmark&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, const QMap&lt;int, QLandmarkManager::Error&gt; &amp; <i>errorMap</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkFetchRequest">updateLandmarkFetchRequest</a></b> ( QLandmarkFetchRequest * <i>req</i>, const QList&lt;QLandmark&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkIdFetchRequest">updateLandmarkIdFetchRequest</a></b> ( QLandmarkIdFetchRequest * <i>req</i>, const QList&lt;QLandmarkId&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkImportRequest">updateLandmarkImportRequest</a></b> ( QLandmarkImportRequest * <i>req</i>, const QList&lt;QLandmarkId&gt; &amp; <i>ids</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkRemoveRequest">updateLandmarkRemoveRequest</a></b> ( QLandmarkRemoveRequest * <i>req</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, const QMap&lt;int, QLandmarkManager::Error&gt; &amp; <i>errorMap</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateLandmarkSaveRequest">updateLandmarkSaveRequest</a></b> ( QLandmarkSaveRequest * <i>req</i>, const QList&lt;QLandmark&gt; &amp; <i>result</i>, QLandmarkManager::Error <i>error</i>, const QString &amp; <i>errorString</i>, const QMap&lt;int, QLandmarkManager::Error&gt; &amp; <i>errorMap</i>, QLandmarkAbstractRequest::State <i>newState</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qlandmarkmanagerengine.html#updateRequestState">updateRequestState</a></b> ( QLandmarkAbstractRequest * <i>req</i>, QLandmarkAbstractRequest::State <i>state</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>
<!-- $$$QLandmarkManagerEngine-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QLandmarkManagerEngine class provides the interface for all implementations of the landmark manager backend functionality.</p>
<p>Instances of this class are usually provided by <a href="qlandmarkmanagerenginefactory.html">QLandmarkManagerEngineFactory</a>, which is loaded from a plugin.</p>
</div>
<!-- @@@QLandmarkManagerEngine -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QLandmarkManagerEngine[overload1]$$$QLandmarkManagerEngine -->
<h3 class="fn"><a name="QLandmarkManagerEngine"></a>QLandmarkManagerEngine::<span class="name">QLandmarkManagerEngine</span> ()</h3>
<p>Constructs a landmark manager engine.</p>
<!-- @@@QLandmarkManagerEngine -->
<!-- $$$~QLandmarkManagerEngine[overload1]$$$~QLandmarkManagerEngine -->
<h3 class="fn"><a name="dtor.QLandmarkManagerEngine"></a>QLandmarkManagerEngine::<span class="name">~QLandmarkManagerEngine</span> ()<tt> [virtual]</tt></h3>
<p>Destructor.</p>
<!-- @@@~QLandmarkManagerEngine -->
<!-- $$$addSorted[overload1]$$$addSortedQList<QLandmark>*constQLandmark&constQList<QLandmarkSortOrder>& -->
<h3 class="fn"><a name="addSorted"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">addSorted</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; * <i>sorted</i>, const <span class="type"><a href="qlandmark.html">QLandmark</a></span> &amp; <i>landmark</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>&gt; &amp; <i>sortOrders</i> )<tt> [static]</tt></h3>
<p>Performs an insertion sort <i>landmark</i> into the <i>sorted</i> list, according to the provided <i>sortOrders</i> list. The first <a href="qlandmarksortorder.html">QLandmarkSortOrder</a> in the list has the highest priority; if the <i>landmark</i> is deemed equal to another in the <i>sorted</i> list, the second <a href="qlandmarksortorder.html">QLandmarkSortOrder</a> in the list is used (and so on until either the landmark is inserted or there are no more sort order objects in the list).</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@addSorted -->
<!-- $$$cancelRequest[overload1]$$$cancelRequestQLandmarkAbstractRequest* -->
<h3 class="fn"><a name="cancelRequest"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">cancelRequest</span> ( <span class="type"><a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a></span> * <i>request</i> )<tt> [pure virtual]</tt></h3>
<p>Asks the manager engine to cancel the given <i>request</i> which was previously started and is currently in a cancellable state. Returns true if cancelation of the request was started successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#startRequest">startRequest</a>() and <a href="qlandmarkabstractrequest.html#cancel">QLandmarkAbstractRequest::cancel</a>().</p>
<!-- @@@cancelRequest -->
<!-- $$$categories[overload1]$$$categoriesconstQList<QLandmarkCategoryId>&QMap<int,QLandmarkManager::Error>*QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="categories"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>&gt; QLandmarkManagerEngine::<span class="name">categories</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>&gt; &amp; <i>categoryIds</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; * <i>errorMap</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns a list of categories which match the given <i>categoryIds</i>. The engine will populate <i>errorMap</i> (the map of indices of the <i>categoryIds</i> list to errors) for the indexes where the category could not be retrieved.</p>
<p>Overall operation errors are stored in <i>error</i> and <i>errorString</i>. <i>error</i> is set to <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::NoError</a>, if all categories were successfully retrieved.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@categories -->
<!-- $$$categories$$$categoriesintintconstQLandmarkNameSort&QLandmarkManager::Error*QString* -->
<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>&lt;<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>&gt; QLandmarkManagerEngine::<span class="name">categories</span> ( <span class="type">int</span> <i>limit</i>, <span class="type">int</span> <i>offset</i>, const <span class="type"><a href="qlandmarknamesort.html">QLandmarkNameSort</a></span> &amp; <i>nameSort</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></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. The returned categories ordered according to the given <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> QLandmarkManagerEngine::<span class="name">categoriesAdded</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>&gt; &amp; <i>categoryIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted some time after a set of categories has been added to the datastore managed by this engine and where the <a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>() signal was not emitted for those changes. As it is possible that other processes(or other devices) may have added the landmarks, the exact timing cannot be determined.</p>
<p>There may be one or more category identifiers in the <i>categoryIds</i> list.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>(), <a href="qlandmarkmanagerengine.html#categoriesChanged">categoriesChanged</a>(), and <a href="qlandmarkmanagerengine.html#categoriesRemoved">categoriesRemoved</a>().</p>
<!-- @@@categoriesAdded -->
<!-- $$$categoriesChanged[overload1]$$$categoriesChangedconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="categoriesChanged"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">categoriesChanged</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>&gt; &amp; <i>categoryIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted some time after a set of categories have been modified in the datastore managed by the engine and where the <a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>() signal was not emitted for those changes. As it is possible that other processes(or other devices) may have modified the categories, the timing cannot be determined.</p>
<p>There may be one ore more category identifiers in the <i>categoryIds</i> list.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>(), <a href="qlandmarkmanagerengine.html#categoriesAdded">categoriesAdded</a>(), and <a href="qlandmarkmanagerengine.html#categoriesRemoved">categoriesRemoved</a>().</p>
<!-- @@@categoriesChanged -->
<!-- $$$categoriesRemoved[overload1]$$$categoriesRemovedconstQList<QLandmarkCategoryId>& -->
<h3 class="fn"><a name="categoriesRemoved"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">categoriesRemoved</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>&gt; &amp; <i>categoryIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted some time after a set of categories have been removed from the datastore managed by this engine and where the <a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>() signal was not emitted for those changes. As it is possible that other processes(or other devices) may have removed the categories, the timing cannot be determined.</p>
<p>There may be one ore more category identifiers in the <i>categoryIds</i> list.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>(), <a href="qlandmarkmanagerengine.html#categoriesAdded">categoriesAdded</a>(), and <a href="qlandmarkmanagerengine.html#categoriesChanged">categoriesChanged</a>().</p>
<!-- @@@categoriesRemoved -->
<!-- $$$category[overload1]$$$categoryconstQLandmarkCategoryId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="category"></a><span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span> QLandmarkManagerEngine::<span class="name">category</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> &amp; <i>categoryId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns the category in the datastore identified by <i>categoryId</i>.</p>
<p>Any errors encountered are stored in <i>error</i> and <i>errorString</i>. A QLandmarkManager::CategoryDoesNotExist error is set if the category could not be found.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@category -->
<!-- $$$categoryIds[overload1]$$$categoryIdsintintconstQLandmarkNameSort&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="categoryIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>&gt; QLandmarkManagerEngine::<span class="name">categoryIds</span> ( <span class="type">int</span> <i>limit</i>, <span class="type">int</span> <i>offset</i>, const <span class="type"><a href="qlandmarknamesort.html">QLandmarkNameSort</a></span> &amp; <i>nameSort</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></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. Any error which occurs will be saved in <i>error</i> and <i>errorString</i>. The identifiers are returned in order according to the given <i>nameSort</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@categoryIds -->
<!-- $$$compareLandmark[overload1]$$$compareLandmarkconstQLandmark&constQLandmark&constQList<QLandmarkSortOrder>& -->
<h3 class="fn"><a name="compareLandmark"></a><span class="type">int</span> QLandmarkManagerEngine::<span class="name">compareLandmark</span> ( const <span class="type"><a href="qlandmark.html">QLandmark</a></span> &amp; <i>a</i>, const <span class="type"><a href="qlandmark.html">QLandmark</a></span> &amp; <i>b</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>&gt; &amp; <i>sortOrders</i> )<tt> [static]</tt></h3>
<p>Compares two landmarks (<i>a</i> and <i>b</i>) using the given list of <i>sortOrders</i>. Returns a negative number if <i>a</i> should appear before <i>b</i> according to the sort order, a positive number if <i>a</i> should appear after <i>b</i> according to the sort order, and zero if the two are unable to be sorted.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@compareLandmark -->
<!-- $$$compareName[overload1]$$$compareNameconstQLandmark&constQLandmark&constQLandmarkNameSort& -->
<h3 class="fn"><a name="compareName"></a><span class="type">int</span> QLandmarkManagerEngine::<span class="name">compareName</span> ( const <span class="type"><a href="qlandmark.html">QLandmark</a></span> &amp; <i>a</i>, const <span class="type"><a href="qlandmark.html">QLandmark</a></span> &amp; <i>b</i>, const <span class="type"><a href="qlandmarknamesort.html">QLandmarkNameSort</a></span> &amp; <i>nameSort</i> )<tt> [static]</tt></h3>
<p>Compares two landmarks (<i>a</i> and <i>b</i>) by name.</p>
<p>Returns a negative number if <i>a</i> should appear before <i>b</i> according to the <i>nameSort</i>, a positive number if <i>a</i> should appear after <i>b</i> according to the <i>nameSort</i>, and zero if the two are unable to be sorted.</p>
<p>Assuming an ascending order sort, an integer less than, equal to, or greater than zero is returned if <i>a</i> is less than, equal to or greater than <i>b</i>.</p>
<p><i>nameSort</i> specifies whether an ascending or descending order is used and whether the sort is case sensitive or not.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@compareName -->
<!-- $$$dataChanged[overload1]$$$dataChanged -->
<h3 class="fn"><a name="dataChanged"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">dataChanged</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted some time after changes occur to the datastore managed by this engine, and the engine is unable to precisely determine which changes occurred, or if the engine considers the changes to be radical enough to require clients to reload all data.</p>
<p>If this signal is emitted, no other signals may be emitted for the associated changes.</p>
<p>As it is possible that other processes (or other devices) may have caused the changes, the timing can not be determined.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#landmarksAdded">landmarksAdded</a>(), <a href="qlandmarkmanagerengine.html#landmarksChanged">landmarksChanged</a>(), <a href="qlandmarkmanagerengine.html#landmarksRemoved">landmarksRemoved</a>(), <a href="qlandmarkmanagerengine.html#categoriesAdded">categoriesAdded</a>(), <a href="qlandmarkmanagerengine.html#categoriesChanged">categoriesChanged</a>(), and <a href="qlandmarkmanagerengine.html#categoriesRemoved">categoriesRemoved</a>().</p>
<!-- @@@dataChanged -->
<!-- $$$exportLandmarks[overload1]$$$exportLandmarksQIODevice*constQString&constQList<QLandmarkId>&QLandmarkManager::TransferOptionQLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="exportLandmarks"></a><span class="type">bool</span> QLandmarkManagerEngine::<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> &amp; <i>format</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>landmarkIds</i>, <span class="type"><a href="qlandmarkmanager.html#TransferOption-enum">QLandmarkManager::TransferOption</a></span> <i>option</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></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.</p>
<p>Overall operation errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@exportLandmarks -->
<!-- $$$filterSupportLevel[overload1]$$$filterSupportLevelconstQLandmarkFilter&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="filterSupportLevel"></a><span class="type"><a href="qlandmarkmanager.html#SupportLevel-enum">QLandmarkManager::SupportLevel</a></span> QLandmarkManagerEngine::<span class="name">filterSupportLevel</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> &amp; <i>filter</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns the support level the manager engine provides for the given <i>filter</i>. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@filterSupportLevel -->
<!-- $$$importLandmarks[overload1]$$$importLandmarksQIODevice*constQString&QLandmarkManager::TransferOptionconstQLandmarkCategoryId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="importLandmarks"></a><span class="type">bool</span> QLandmarkManagerEngine::<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> &amp; <i>format</i>, <span class="type"><a href="qlandmarkmanager.html#TransferOption-enum">QLandmarkManager::TransferOption</a></span> <i>option</i>, const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> &amp; <i>categoryId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></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 engine tries to autodetect 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>, QLandmarkManager::CategoryDoesNotExist error is returned. 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>Overall operational errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@importLandmarks -->
<!-- $$$isFeatureSupported[overload1]$$$isFeatureSupportedQLandmarkManager::ManagerFeatureQLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="isFeatureSupported"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">isFeatureSupported</span> ( <span class="type"><a href="qlandmarkmanager.html#ManagerFeature-enum">QLandmarkManager::ManagerFeature</a></span> <i>feature</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns true if the manager engine supports the given <i>feature</i>, otherwise returns false; Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isFeatureSupported -->
<!-- $$$isReadOnly[overload1]$$$isReadOnlyQLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="isReadOnly"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">isReadOnly</span> ( <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns true if the manager engine is exclusively read only. Meaning landmarks and categories cannot be added, modified or removed. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isReadOnly -->
<!-- $$$isReadOnly$$$isReadOnlyconstQLandmarkId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="isReadOnly-2"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">isReadOnly</span> ( const <span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span> &amp; <i>landmarkId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns true if the landmark identified by <i>landmarkId</i> considered read-only by the manager engine.</p>
<p>If the <i>landmarkId</i> does not refer to an existing landmark, it is considered writable unless the manager engine is exclusively read-only. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isReadOnly -->
<!-- $$$isReadOnly$$$isReadOnlyconstQLandmarkCategoryId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="isReadOnly-3"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">isReadOnly</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> &amp; <i>categoryId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns true if the category identified by <i>categoryId</i> is considered read-only by the manager engine.</p>
<p>If <i>categoryId</i> does not refer to an existing category, it is considered writable unless the manager engine is exclusively read-only. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isReadOnly -->
<!-- $$$landmark[overload1]$$$landmarkconstQLandmarkId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="landmark"></a><span class="type"><a href="qlandmark.html">QLandmark</a></span> QLandmarkManagerEngine::<span class="name">landmark</span> ( const <span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span> &amp; <i>landmarkId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns the landmark in the datastore identified by <i>landmarkId</i>.</p>
<p>Any errors encountered are:stored in <i>error</i> and <i>errorString</i>. The <i>error</i> is set to <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::LandmarkDoesNotExistError</a> if the landmark could not be found.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmark -->
<!-- $$$landmarkIds[overload1]$$$landmarkIdsconstQLandmarkFilter&intintconstQList<QLandmarkSortOrder>&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="landmarkIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; QLandmarkManagerEngine::<span class="name">landmarkIds</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> &amp; <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>&lt;<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>&gt; &amp; <i>sortOrders</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></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.</p>
<p>Any error which occurs will be saved in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarkIds -->
<!-- $$$landmarks[overload1]$$$landmarksconstQList<QLandmarkId>&QMap<int,QLandmarkManager::Error>*QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="landmarks"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; QLandmarkManagerEngine::<span class="name">landmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>landmarkIds</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; * <i>errorMap</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns a list of landmarks which match the given <i>landmarkIds</i>. The engine will populate <i>errorMap</i> (the map of indices of the <i>landmarkIds</i> list to errors) for the indexes where the landmark could not be retrieved.</p>
<p>Overall operation errors are stored in <i>error</i> and <i>errorString</i>. <i>error</i> is set to <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::NoError</a>, all landmarks were successfully retrieved.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@landmarks -->
<!-- $$$landmarks$$$landmarksconstQLandmarkFilter&intintconstQList<QLandmarkSortOrder>&QLandmarkManager::Error*QString* -->
<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>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; QLandmarkManagerEngine::<span class="name">landmarks</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> &amp; <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>&lt;<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>&gt; &amp; <i>sortOrders</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></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>Overall operation errors are stored in <i>error</i> and <i>errorString</i>.</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> QLandmarkManagerEngine::<span class="name">landmarksAdded</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>landmarkIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted some time after a set of landmarks has been added to the datastore managed by the engine and where the <a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>() signal was not emitted for those changes. As it is possible that other processes(or other devices) may have added the landmarks, the exact timing cannot be determined.</p>
<p>There may be one or more landmark identifiers in the <i>landmarkIds</i> list.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>(), <a href="qlandmarkmanagerengine.html#landmarksChanged">landmarksChanged</a>(), and <a href="qlandmarkmanagerengine.html#landmarksRemoved">landmarksRemoved</a>().</p>
<!-- @@@landmarksAdded -->
<!-- $$$landmarksChanged[overload1]$$$landmarksChangedconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="landmarksChanged"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">landmarksChanged</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>landmarkIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted some time after a set of landmarks have been modified in the datastore managed by this engine and where the <a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>() signal was not emitted for those changes. As it is possible that other processes(or other devices) may have modified the landmarks, the timing cannot be determined.</p>
<p>Note that removal of a category will not trigger a <tt>landmarksChanged</tt> signal for landmarks belonging to that category.</p>
<p>There may be one ore more landmark identifiers in the <i>landmarkIds</i> list.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>(), <a href="qlandmarkmanagerengine.html#landmarksAdded">landmarksAdded</a>(), and <a href="qlandmarkmanagerengine.html#landmarksRemoved">landmarksRemoved</a>().</p>
<!-- @@@landmarksChanged -->
<!-- $$$landmarksRemoved[overload1]$$$landmarksRemovedconstQList<QLandmarkId>& -->
<h3 class="fn"><a name="landmarksRemoved"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">landmarksRemoved</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>landmarkIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted some time after a set of landmarks have been removed from the datastore managed by this engine and where the <a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>() signal was not emitted for those changes. As it is possible that other processes(or other devices) may have removed the landmarks, the timing cannot be determined.</p>
<p>There may be one ore more landmark identifiers in the <i>landmarkIds</i> list.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#dataChanged">dataChanged</a>(), <a href="qlandmarkmanagerengine.html#landmarksAdded">landmarksAdded</a>(), and <a href="qlandmarkmanagerengine.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> QLandmarkManagerEngine::<span class="name">managerName</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the manager name for this <a href="qlandmarkmanagerengine.html">QLandmarkManagerEngine</a></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>&lt;<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>&gt; QLandmarkManagerEngine::<span class="name">managerParameters</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the parameters with which this engine was constructed. Note that the engine may have discarded unused or invalid parameters at the time of construction, and these will not be returned.</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> QLandmarkManagerEngine::<span class="name">managerUri</span> () const</h3>
<p>Returns the unique URI of this manager, which is built from the manager name and the parameters used to construct it.</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> QLandmarkManagerEngine::<span class="name">managerVersion</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the engine backend implementation version number</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerVersion -->
<!-- $$$removeCategory[overload1]$$$removeCategoryconstQLandmarkCategoryId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="removeCategory"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">removeCategory</span> ( const <span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span> &amp; <i>categoryId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></h3>
<p>Removes the category identified by <i>categoryId</i> from the datastore.</p>
<p>Returns true if the category was removed successfully, otherwise returnse false.</p>
<p>The engine emits the appropriate signals to inform clients of changes to the datastore resulting from this operation</p>
<p>Overall operational errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeCategory -->
<!-- $$$removeLandmark[overload1]$$$removeLandmarkconstQLandmarkId&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="removeLandmark"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">removeLandmark</span> ( const <span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span> &amp; <i>landmarkId</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></h3>
<p>Remove the landmark identified by <i>landmarkId</i> from the datastore.</p>
<p>Returns true if the landmark was removed successfully, otherwise returnse false.</p>
<p>The engine emits the appropriate signals to inform clients of changes to the datastore resulting from this operation.</p>
<p>Any errors encountered during this operation should be stored to <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeLandmark -->
<!-- $$$removeLandmarks[overload1]$$$removeLandmarksconstQList<QLandmarkId>&QMap<int,QLandmarkManager::Error>*QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="removeLandmarks"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">removeLandmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>landmarkIds</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; * <i>errorMap</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></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>The engine populates <i>errorMap</i> (the map of indices of the <i>landmarkIds</i> list to errors) for every index for which the landmark could not be removed.</p>
<p>The engine also emits the appropriate signals to inform clients of changes to the datastore resulting from this operation.</p>
<p>Overall operation errors are stored in <i>error</i> and <i>errorString</i>. <i>error</i> is set to <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::NoError</a>, if all landmarks were successfully removed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#removeLandmark">QLandmarkManagerEngine::removeLandmark</a>().</p>
<!-- @@@removeLandmarks -->
<!-- $$$requestDestroyed[overload1]$$$requestDestroyedQLandmarkAbstractRequest* -->
<h3 class="fn"><a name="requestDestroyed"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">requestDestroyed</span> ( <span class="type"><a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a></span> * <i>request</i> )<tt> [pure virtual]</tt></h3>
<p>Notifies the manager engine that the given <i>request</i> has been destroyed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@requestDestroyed -->
<!-- $$$saveCategory[overload1]$$$saveCategoryQLandmarkCategory*QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="saveCategory"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">saveCategory</span> ( <span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span> * <i>category</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></h3>
<p>Adds the given <i>category</i> to the datastore 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 should fail and <i>error</i> should be set to <tt>QLandmarkManager::CategoryDoesNotExistError</tt>.</p>
<p>Alternatively, the function should update the existing category in the datastore if <i>category</i> has a non-empty id and currently exists within the datastore.</p>
<p>Returns false on failure or true on success. On successful save of a category with an invalid id, it should be assigned a valid id and have its manager URI set to the URI of this manager.</p>
<p>The engine returns the appropriate signals to inform clients of changes to the datastore resulting from this operation.</p>
<p>Overall operations errors should be stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@saveCategory -->
<!-- $$$saveLandmark[overload1]$$$saveLandmarkQLandmark*QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="saveLandmark"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">saveLandmark</span> ( <span class="type"><a href="qlandmark.html">QLandmark</a></span> * <i>landmark</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></h3>
<p>Adds the given <i>landmark</i> to the datastore 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 and <i>error</i> will be set to <tt>QLandmarkManager::LandmarkDoesNotExistError</tt>.</p>
<p>Alternatively, the function will update the existing landmark in the datastore if <i>landmark</i> has a non-empty id and currently exists within the datastore.</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>The engine must emit the appropriate signals to inform clients of changes to the datastore resulting from this operation.</p>
<p>Any errors encountered during this operation should be stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@saveLandmark -->
<!-- $$$saveLandmarks[overload1]$$$saveLandmarksQList<QLandmark>*QMap<int,QLandmarkManager::Error>*QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="saveLandmarks"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">saveLandmarks</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; * <i>landmarks</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; * <i>errorMap</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> )<tt> [pure virtual]</tt></h3>
<p>Adds the list of <i>landmarks</i> to the datastore. Returns true if the landmarks were saved successfully, otherwise returns false.</p>
<p>The engine will populate <i>errorMap</i> (the map of indices of the <i>landmarks</i> list to errors) for every index for which the landmark could not be saved.</p>
<p>For each newly saved landmark that was successful, the identifier of the landmark will be updated with a new value.</p>
<p>The engine emits the appropriate signals to inform clients of changes to the datastore resulting from this operation.</p>
<p>Overall operation errors are stored in <i>error</i> and <i>errorString</i>. <i>error</i> is set to <a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::NoError</a>, if all <i>landmarks</i> were successfully saved.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#saveLandmark">QLandmarkManagerEngine::saveLandmark</a>().</p>
<!-- @@@saveLandmarks -->
<!-- $$$searchableLandmarkAttributeKeys[overload1]$$$searchableLandmarkAttributeKeysQLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="searchableLandmarkAttributeKeys"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QLandmarkManagerEngine::<span class="name">searchableLandmarkAttributeKeys</span> ( <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns the list of landmark attribute keys that may be used in a <a href="qlandmarkattributefilter.html">QLandmarkAttributeFilter</a>. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@searchableLandmarkAttributeKeys -->
<!-- $$$sortLandmarks[overload1]$$$sortLandmarksconstQList<QLandmark>&constQList<QLandmarkSortOrder>& -->
<h3 class="fn"><a name="sortLandmarks"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; QLandmarkManagerEngine::<span class="name">sortLandmarks</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; &amp; <i>landmarks</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span>&gt; &amp; <i>sortOrders</i> )<tt> [static]</tt></h3>
<p>Sorts the given list of <i>landmarks</i> according to the provided <i>sortOrders</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@sortLandmarks -->
<!-- $$$sortOrderSupportLevel[overload1]$$$sortOrderSupportLevelconstQLandmarkSortOrder&QLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="sortOrderSupportLevel"></a><span class="type"><a href="qlandmarkmanager.html#SupportLevel-enum">QLandmarkManager::SupportLevel</a></span> QLandmarkManagerEngine::<span class="name">sortOrderSupportLevel</span> ( const <span class="type"><a href="qlandmarksortorder.html">QLandmarkSortOrder</a></span> &amp; <i>sortOrder</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [pure virtual]</tt></h3>
<p>Returns the support level the manager engine provides for the given <i>sortOrder</i>. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@sortOrderSupportLevel -->
<!-- $$$startRequest[overload1]$$$startRequestQLandmarkAbstractRequest* -->
<h3 class="fn"><a name="startRequest"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">startRequest</span> ( <span class="type"><a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a></span> * <i>request</i> )<tt> [pure virtual]</tt></h3>
<p>Asks the manager engine to begin the given <i>request</i> which is currently in a re(startable) state.</p>
<p>Returns true if the request was started successfully, else returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkabstractrequest.html#start">QLandmarkAbstractRequest::start</a>().</p>
<!-- @@@startRequest -->
<!-- $$$supportedFormats[overload1]$$$supportedFormatsQLandmarkManager::TransferOperationQLandmarkManager::Error*QString* -->
<h3 class="fn"><a name="supportedFormats"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QLandmarkManagerEngine::<span class="name">supportedFormats</span> ( <span class="type"><a href="qlandmarkmanager.html#TransferOperation-enum">QLandmarkManager::TransferOperation</a></span> <i>operation</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> * <i>error</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>errorString</i> ) const<tt> [virtual]</tt></h3>
<p>Returns the supported file formats for the given transfer <i>operation</i>, i.e&#x2e; import or export. Errors are stored in <i>error</i> and <i>errorString</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedFormats -->
<!-- $$$testFilter[overload1]$$$testFilterconstQLandmarkFilter&constQLandmark& -->
<h3 class="fn"><a name="testFilter"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">testFilter</span> ( const <span class="type"><a href="qlandmarkfilter.html">QLandmarkFilter</a></span> &amp; <i>filter</i>, const <span class="type"><a href="qlandmark.html">QLandmark</a></span> &amp; <i>landmark</i> )<tt> [static]</tt></h3>
<p>Returns true if the supplied <i>landmark</i> matches the supplied <i>filter</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@testFilter -->
<!-- $$$updateLandmarkCategoryFetchByIdRequest[overload1]$$$updateLandmarkCategoryFetchByIdRequestQLandmarkCategoryFetchByIdRequest*constQList<QLandmarkCategory>&QLandmarkManager::ErrorconstQString&constQMap<int,QLandmarkManager::Error>&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkCategoryFetchByIdRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkCategoryFetchByIdRequest</span> ( <span class="type"><a href="qlandmarkcategoryfetchbyidrequest.html">QLandmarkCategoryFetchByIdRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; &amp; <i>errorMap</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkcategoryfetchbyidrequest.html">QLandmarkCategoryFetchByIdRequest</a> <i>req</i> with the latest <i>result</i>, and operation <i>error</i> and <i>errorString</i>, and map of input index to individual errors, <i>errorMap</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkCategoryFetchByIdRequest -->
<!-- $$$updateLandmarkCategoryFetchRequest[overload1]$$$updateLandmarkCategoryFetchRequestQLandmarkCategoryFetchRequest*constQList<QLandmarkCategory>&QLandmarkManager::ErrorconstQString&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkCategoryFetchRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkCategoryFetchRequest</span> ( <span class="type"><a href="qlandmarkcategoryfetchrequest.html">QLandmarkCategoryFetchRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkcategoryfetchrequest.html">QLandmarkCategoryFetchRequest</a> <i>req</i> with the latest <i>result</i>, and operation <i>error</i> and <i>errorString</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkCategoryFetchRequest -->
<!-- $$$updateLandmarkCategoryIdFetchRequest[overload1]$$$updateLandmarkCategoryIdFetchRequestQLandmarkCategoryIdFetchRequest*constQList<QLandmarkCategoryId>&QLandmarkManager::ErrorconstQString&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkCategoryIdFetchRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkCategoryIdFetchRequest</span> ( <span class="type"><a href="qlandmarkcategoryidfetchrequest.html">QLandmarkCategoryIdFetchRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategoryid.html">QLandmarkCategoryId</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkcategoryidfetchrequest.html">QLandmarkCategoryIdFetchRequest</a> <i>req</i> with the latest <i>result</i>, and operation <i>error</i> and <i>errorString</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkCategoryIdFetchRequest -->
<!-- $$$updateLandmarkCategoryRemoveRequest[overload1]$$$updateLandmarkCategoryRemoveRequestQLandmarkCategoryRemoveRequest*QLandmarkManager::ErrorconstQString&constQMap<int,QLandmarkManager::Error>&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkCategoryRemoveRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkCategoryRemoveRequest</span> ( <span class="type"><a href="qlandmarkcategoryremoverequest.html">QLandmarkCategoryRemoveRequest</a></span> * <i>req</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; &amp; <i>errorMap</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkcategoryremoverequest.html">QLandmarkCategoryRemoveRequest</a> <i>req</i> with the operation <i>error</i> and <i>errorString</i> and map of input index to individual errors, <i>errorMap</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkCategoryRemoveRequest -->
<!-- $$$updateLandmarkCategorySaveRequest[overload1]$$$updateLandmarkCategorySaveRequestQLandmarkCategorySaveRequest*constQList<QLandmarkCategory>&QLandmarkManager::ErrorconstQString&constQMap<int,QLandmarkManager::Error>&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkCategorySaveRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkCategorySaveRequest</span> ( <span class="type"><a href="qlandmarkcategorysaverequest.html">QLandmarkCategorySaveRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkcategory.html">QLandmarkCategory</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; &amp; <i>errorMap</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given QLandmarkSaveCategoryRequest <i>req</i> with the latest <i>result</i>, operation error <i>error</i> and <i>errorString</i>, and map of input index to individual errors, <i>errorMap</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkCategorySaveRequest -->
<!-- $$$updateLandmarkExportRequest[overload1]$$$updateLandmarkExportRequestQLandmarkExportRequest*QLandmarkManager::ErrorconstQString&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkExportRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkExportRequest</span> ( <span class="type"><a href="qlandmarkexportrequest.html">QLandmarkExportRequest</a></span> * <i>req</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkexportrequest.html">QLandmarkExportRequest</a> <i>req</i> with the operation <i>error</i> and <i>errorString</i>. In addition the state of the request is changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify the clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkExportRequest -->
<!-- $$$updateLandmarkFetchByIdRequest[overload1]$$$updateLandmarkFetchByIdRequestQLandmarkFetchByIdRequest*constQList<QLandmark>&QLandmarkManager::ErrorconstQString&constQMap<int,QLandmarkManager::Error>&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkFetchByIdRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkFetchByIdRequest</span> ( <span class="type"><a href="qlandmarkfetchbyidrequest.html">QLandmarkFetchByIdRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; &amp; <i>errorMap</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkfetchbyidrequest.html">QLandmarkFetchByIdRequest</a> <i>req</i> with the latest <i>result</i>, operation <i>error</i> and <i>errorString</i> and map of input index to individual errors, <i>errorMap</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkFetchByIdRequest -->
<!-- $$$updateLandmarkFetchRequest[overload1]$$$updateLandmarkFetchRequestQLandmarkFetchRequest*constQList<QLandmark>&QLandmarkManager::ErrorconstQString&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkFetchRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkFetchRequest</span> ( <span class="type"><a href="qlandmarkfetchrequest.html">QLandmarkFetchRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkfetchrequest.html">QLandmarkFetchRequest</a> <i>req</i> with the latest <i>result</i>, and operation <i>error</i> and <i>errorString</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkFetchRequest -->
<!-- $$$updateLandmarkIdFetchRequest[overload1]$$$updateLandmarkIdFetchRequestQLandmarkIdFetchRequest*constQList<QLandmarkId>&QLandmarkManager::ErrorconstQString&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkIdFetchRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkIdFetchRequest</span> ( <span class="type"><a href="qlandmarkidfetchrequest.html">QLandmarkIdFetchRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkidfetchrequest.html">QLandmarkIdFetchRequest</a> <i>req</i> with the latest <i>result</i>, and operation <i>error</i> and <i>errorString</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkIdFetchRequest -->
<!-- $$$updateLandmarkImportRequest[overload1]$$$updateLandmarkImportRequestQLandmarkImportRequest*constQList<QLandmarkId>&QLandmarkManager::ErrorconstQString&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkImportRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkImportRequest</span> ( <span class="type"><a href="qlandmarkimportrequest.html">QLandmarkImportRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmarkid.html">QLandmarkId</a></span>&gt; &amp; <i>ids</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkimportrequest.html">QLandmarkImportRequest</a> <i>req</i> with the operation <i>error</i> and <i>errorString</i>. In addition the state of the request is changed to <i>newState</i>. This function may also be used to update the <i>ids</i> of the landmarks which have been imported.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify the clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkImportRequest -->
<!-- $$$updateLandmarkRemoveRequest[overload1]$$$updateLandmarkRemoveRequestQLandmarkRemoveRequest*QLandmarkManager::ErrorconstQString&constQMap<int,QLandmarkManager::Error>&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkRemoveRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkRemoveRequest</span> ( <span class="type"><a href="qlandmarkremoverequest.html">QLandmarkRemoveRequest</a></span> * <i>req</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; &amp; <i>errorMap</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarkremoverequest.html">QLandmarkRemoveRequest</a> <i>req</i> with the operation <i>error</i> and <i>errorString</i> and map of input index to individual errors, <i>errorMap</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkRemoveRequest -->
<!-- $$$updateLandmarkSaveRequest[overload1]$$$updateLandmarkSaveRequestQLandmarkSaveRequest*constQList<QLandmark>&QLandmarkManager::ErrorconstQString&constQMap<int,QLandmarkManager::Error>&QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateLandmarkSaveRequest"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateLandmarkSaveRequest</span> ( <span class="type"><a href="qlandmarksaverequest.html">QLandmarkSaveRequest</a></span> * <i>req</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qlandmark.html">QLandmark</a></span>&gt; &amp; <i>result</i>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span> <i>error</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>errorString</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span>&lt;<span class="type">int</span>, <span class="type"><a href="qlandmarkmanager.html#Error-enum">QLandmarkManager::Error</a></span>&gt; &amp; <i>errorMap</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>newState</i> )<tt> [static]</tt></h3>
<p>Updates the given <a href="qlandmarksaverequest.html">QLandmarkSaveRequest</a> <i>req</i> with the latest <i>result</i>, operation <i>error</i> and <i>errorString</i>, and map of input index to individual errors, <i>errorMap</i>. In addition, the state of the request will be changed to <i>newState</i>.</p>
<p>It then causes the request to emit its resultsAvailable() signal to notify clients of the request progress.</p>
<p>If the new request state is different from the previous state, the stateChanged() signal will also be emitted from the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateLandmarkSaveRequest -->
<!-- $$$updateRequestState[overload1]$$$updateRequestStateQLandmarkAbstractRequest*QLandmarkAbstractRequest::State -->
<h3 class="fn"><a name="updateRequestState"></a><span class="type">void</span> QLandmarkManagerEngine::<span class="name">updateRequestState</span> ( <span class="type"><a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a></span> * <i>req</i>, <span class="type"><a href="qlandmarkabstractrequest.html#State-enum">QLandmarkAbstractRequest::State</a></span> <i>state</i> )<tt> [static]</tt></h3>
<p>Updates the given asynchronous request <i>req</i> by setting the new <i>state</i> of the request. If the new state is different, the stateChanged() signal will be emitted by the request.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@updateRequestState -->
<!-- $$$waitForRequestFinished[overload1]$$$waitForRequestFinishedQLandmarkAbstractRequest*int -->
<h3 class="fn"><a name="waitForRequestFinished"></a><span class="type">bool</span> QLandmarkManagerEngine::<span class="name">waitForRequestFinished</span> ( <span class="type"><a href="qlandmarkabstractrequest.html">QLandmarkAbstractRequest</a></span> * <i>request</i>, <span class="type">int</span> <i>msecs</i> )<tt> [pure virtual]</tt></h3>
<p>Blocks until the manager engine has completed the given <i>request</i> which was previously started, or until <i>msecs</i> milliseconds have passed. Returns true if the request was completed, and false if the request was not in the <tt>QLandmarkAbstractRequest::Active</tt> state, no progress could be reported or if the engine does not support waitForFinished functionality.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qlandmarkmanagerengine.html#startRequest">startRequest</a>().</p>
<!-- @@@waitForRequestFinished -->
</div>
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
  <p>
     <acronym title="Copyright">&copy;</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>