Sophie

Sophie

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

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" />
<!-- qdeclarativelandmarkmodel.cpp -->
  <title>Qt Mobility 1.2: QML LandmarkAbstractModel Element</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="http://qt.nokia.com/doc/4.7/qdeclarativeelements.html">QML Elements</a></li>
<li>QML LandmarkAbstractModel Element</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#signal-handlers">Signal Handlers</a></li>
<li class="level1"><a href="#methods">Methods</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QML LandmarkAbstractModel Element</h1>
<span class="subtitle"></span>
<!-- $$$LandmarkAbstractModel-brief -->
<p>The LandmarkAbstractModel element is an uncreatable / uninstantiable base element for <a href="qml-landmarkmodel.html">LandmarkModel</a> and <a href="qml-landmarkcategorymodel.html">LandmarkCategoryModel</a>. It defines many common properties for the two models. <a href="#details">More...</a></p>
<!-- @@@LandmarkAbstractModel -->
<p>Inherited by <a href="qml-landmarkcategorymodel.html">LandmarkCategoryModel</a> and <a href="qml-landmarkmodel.html">LandmarkModel</a>.</p>
<p>This element was introduced in  Mobility 1.2.</p>
<ul>
<li><a href="qml-landmarkabstractmodel-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#autoUpdate-prop">autoUpdate</a></b></b> : bool</li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#count-prop">count</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#error-prop">error</a></b></b> : string</li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#limit-prop">limit</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#offset-prop">offset</a></b></b> : int</li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#sortBy-prop">sortBy</a></b></b> : enumeration</li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#sortOrder-prop">sortOrder</a></b></b> : enumeration</li>
</ul>
<a name="signal-handlers"></a>
<h2>Signal Handlers</h2>
<ul>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#databaseChanged-signal">databaseChanged</a></b></b></li>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#modelChanged-signal">modelChanged</a></b></b></li>
</ul>
<a name="methods"></a>
<h2>Methods</h2>
<ul>
<li class="fn"><b><b><a href="qml-landmarkabstractmodel.html#update-method">update</a></b></b></li>
</ul>
<!-- $$$LandmarkAbstractModel-description -->
<a name="details"></a>
<h2>Detailed Description</h2>
<p>The LandmarkAbstractModel element is an uncreatable / uninstantiable base element for <a href="qml-landmarkmodel.html">LandmarkModel</a> and <a href="qml-landmarkcategorymodel.html">LandmarkCategoryModel</a>. It defines many common properties for the two models.</p>
<p>This element is part of the <b>QtMobility.location 1.1</b> module.</p>
<p><b>See also </b><a href="qml-landmarkmodel.html">LandmarkModel</a> and <a href="qml-landmarkcategorymodel.html">LandmarkCategoryModel</a>.</p>
<!-- @@@LandmarkAbstractModel -->
<h2>Property Documentation</h2>
<!-- $$$autoUpdate -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="autoUpdate-prop"></a><span class="name">autoUpdate</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-bool.html">bool</a></span></p></td></tr></table></div><div class="qmldoc"><p>Controls whether the model data should be automatically updated when appropriate events occur: limit changes, offset changes, filter changes, filter contents change, or sorting rules change. Property also controls whether the data is updated automatically once model instantiation is completed.</p>
<p>Note: while autoUpdate adds to development comfort, each change in appropriate parameters cause full fetch from underlying database and therefore its use should be thought through. E.g&#x2e; if your application inherently behaves such that filters, their contents, and underlying database change very frequently, it may be wiser to bind a manual <a href="qml-landmarkabstractmodel.html#update-method">update</a> call to a less hectic trigger source.</p>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@autoUpdate -->
<br/>
<!-- $$$count -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="count-prop"></a><span class="qmlreadonly">read-only</span><span class="name">count</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span></p></td></tr></table></div><div class="qmldoc"><p>Indicates the number of items currently in the model (landmarks/categories).</p>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@count -->
<br/>
<!-- $$$error -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="error-prop"></a><span class="qmlreadonly">read-only</span><span class="name">error</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-string.html">string</a></span></p></td></tr></table></div><div class="qmldoc"><p>Human readable string of the last error that occurred (read-only).</p>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@error -->
<br/>
<!-- $$$limit -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="limit-prop"></a><span class="name">limit</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span></p></td></tr></table></div><div class="qmldoc"><p>Sets the maximum amount of items held by the model.</p>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@limit -->
<br/>
<!-- $$$offset -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="offset-prop"></a><span class="name">offset</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-int.html">int</a></span></p></td></tr></table></div><div class="qmldoc"><p>Sets the offset for the landmarks. For example if one creates a tabbed / paged application, the offset could be changed dynamically by a multiple of items per page.</p>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@offset -->
<br/>
<!-- $$$sortBy -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="sortBy-prop"></a><span class="name">sortBy</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><p>Specifies the role to sort the items by.</p>
<p>Note: both sortBy and <a href="qml-landmarkabstractmodel.html#sortOrder-prop">sortOrder</a> incur performance costs. If the order is not important (e.g&#x2e; when displaying landmarks as Map objects) it is advisable not to set them.</p>
<ul>
<li><a href="qml-landmarkabstractmodel.html">LandmarkAbstractModel</a>.None (default)</li>
<li><a href="qml-landmarkabstractmodel.html">LandmarkAbstractModel</a>.NameSort</li>
</ul>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@sortBy -->
<br/>
<!-- $$$sortOrder -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlPropNode"><p><a name="sortOrder-prop"></a><span class="name">sortOrder</span> : <span class="type"><a href="http://qt.nokia.com/doc/4.7/qml-enumeration.html">enumeration</a></span></p></td></tr></table></div><div class="qmldoc"><p>Specifies the sort order.</p>
<p>Note: both <a href="qml-landmarkabstractmodel.html#sortBy-prop">sortBy</a> and sortOrder incur performance costs. If the order is not important (e.g&#x2e; when displaying landmarks as Map objects) it is advisable not to set them.</p>
<ul>
<li><a href="qml-landmarkabstractmodel.html">LandmarkAbstractModel</a>.AscendingOrder</li>
<li><a href="qml-landmarkabstractmodel.html">LandmarkAbstractModel</a>.DescendingOrder</li>
</ul>
<p>This property group was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@sortOrder -->
<br/>
<h2>Signal Handler Documentation</h2>
<!-- $$$databaseChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="databaseChanged-signal"></a>LandmarkAbstractModel::<span class="name">databaseChanged</span> ()</p></td></tr></table></div><div class="qmldoc"><p>This handler is called when the data in the underlying data storage has changed. If <a href="qml-landmarkabstractmodel.html#autoUpdate-prop">autoUpdate</a> is true, model data will be updated shortly afterwards.</p>
<p>This documentation was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@databaseChanged -->
<br/>
<!-- $$$modelChanged -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="modelChanged-signal"></a>LandmarkAbstractModel::<span class="name">modelChanged</span> ()</p></td></tr></table></div><div class="qmldoc"><p>This handler is called when the model data has changed.</p>
<p>This documentation was introduced in  Mobility 1.2.</p>
</div></div><!-- @@@modelChanged -->
<br/>
<h2>Method Documentation</h2>
<!-- $$$update -->
<div class="qmlitem"><div class="qmlproto"><table class="qmlname"><tr valign="top" class="odd"><td class="tblQmlFuncNode"><p><a name="update-method"></a>LandmarkAbstractModel::<span class="name">update</span> ()</p></td></tr></table></div><div class="qmldoc"><p>Updates the items represented by the model from the underlying store.</p>
<p>This documentation was introduced in  Mobility 1.2.</p>
<p><b>See also </b><a href="qml-landmarkabstractmodel.html#autoUpdate-prop">autoUpdate</a>.</p>
</div></div><!-- @@@update -->
<br/>
  <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>