Sophie

Sophie

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

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" />
<!-- qgeopositioninfosourcefactory.cpp -->
  <title>Qt Mobility 1.2: QGeoPositionInfoSourceFactory 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>QGeoPositionInfoSourceFactory</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="#details">Detailed Description</a></li>
<li class="level2"><a href="#default-plugins">Default plugins</a></li>
</ul>
</div>
<h1 class="title">QGeoPositionInfoSourceFactory Class Reference</h1>
<!-- $$$QGeoPositionInfoSourceFactory-brief -->
<p>The QGeoPositionInfoSourceFactory class is a factory class used as the plugin interface for external providers of positioning data. <a href="#details">More...</a></p>
<!-- @@@QGeoPositionInfoSourceFactory -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QGeoPositionInfoSourceFactory&gt;</span></pre><p>This class was introduced in Qt Mobility 1.2.</p>
<ul>
<li><a href="qgeopositioninfosourcefactory-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"> virtual </td><td class="memItemRight bottomAlign"><b><a href="qgeopositioninfosourcefactory.html#dtor.QGeoPositionInfoSourceFactory">~QGeoPositionInfoSourceFactory</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QGeoPositionInfoSource * </td><td class="memItemRight bottomAlign"><b><a href="qgeopositioninfosourcefactory.html#positionInfoSource">positionInfoSource</a></b> ( QObject * <i>parent</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QGeoSatelliteInfoSource * </td><td class="memItemRight bottomAlign"><b><a href="qgeopositioninfosourcefactory.html#satelliteInfoSource">satelliteInfoSource</a></b> ( QObject * <i>parent</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QString </td><td class="memItemRight bottomAlign"><b><a href="qgeopositioninfosourcefactory.html#sourceName">sourceName</a></b> () const = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qgeopositioninfosourcefactory.html#sourcePriority">sourcePriority</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qgeopositioninfosourcefactory.html#sourceVersion">sourceVersion</a></b> () const = 0</td></tr>
</table>
<a name="details"></a>
<!-- $$$QGeoPositionInfoSourceFactory-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QGeoPositionInfoSourceFactory class is a factory class used as the plugin interface for external providers of positioning data.</p>
<p>Implementers must provide a unique combination of <a href="qgeopositioninfosourcefactory.html#sourceName">sourceName</a>() and <a href="qgeopositioninfosourcefactory.html#sourceVersion">sourceVersion</a>() per plugin.</p>
<p>The other functions must be overridden by all plugins, other than <a href="qgeopositioninfosourcefactory.html#sourcePriority">sourcePriority</a>() which defaults to returning 0. Higher values of priority will be preferred to lower ones.</p>
<a name="default-plugins"></a>
<h3>Default plugins</h3>
<p>Normally, the platform default position source will always overrule any plugin-based position source during a call to createDefaultSource(). However, a limited measure is available where needed to change this behaviour, using a system-wide configuration file.</p>
<p>The configuration file is in the system's default <a href="http://qt.nokia.com/doc/4.7/qsettings.html">QSettings</a> format, under <tt>Nokia/QtLocationPosAndSat</tt> (for example, on most Linux variants this is <tt>/etc/xdg/Nokia/QtLocationPosAndSat.conf</tt>). To set a default plugin source, set the value <tt>position.plugin.operator.whitelist</tt> to a string of the format <tt>&quot;name,filename,hash,size&quot;</tt> where <i>name</i> is the same as returned by the plugin's <tt>sourceName()</tt> function, <i>size</i> is the size of the shared library and <i>hash</i> is the library's SHA1 hash in hex format.</p>
</div>
<!-- @@@QGeoPositionInfoSourceFactory -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$~QGeoPositionInfoSourceFactory[overload1]$$$~QGeoPositionInfoSourceFactory -->
<h3 class="fn"><a name="dtor.QGeoPositionInfoSourceFactory"></a>QGeoPositionInfoSourceFactory::<span class="name">~QGeoPositionInfoSourceFactory</span> ()<tt> [virtual]</tt></h3>
<p>Destroys the position info source factory.</p>
<!-- @@@~QGeoPositionInfoSourceFactory -->
<!-- $$$positionInfoSource[overload1]$$$positionInfoSourceQObject* -->
<h3 class="fn"><a name="positionInfoSource"></a><span class="type"><a href="qgeopositioninfosource.html">QGeoPositionInfoSource</a></span> * QGeoPositionInfoSourceFactory::<span class="name">positionInfoSource</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> )<tt> [pure virtual]</tt></h3>
<p>Returns a new <a href="qgeopositioninfosource.html">QGeoPositionInfoSource</a> associated with this plugin with parent <i>parent</i> . Can also return 0, in which case the factory with the next highest priority will be used instead.</p>
<!-- @@@positionInfoSource -->
<!-- $$$satelliteInfoSource[overload1]$$$satelliteInfoSourceQObject* -->
<h3 class="fn"><a name="satelliteInfoSource"></a><span class="type"><a href="qgeosatelliteinfosource.html">QGeoSatelliteInfoSource</a></span> * QGeoPositionInfoSourceFactory::<span class="name">satelliteInfoSource</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> )<tt> [pure virtual]</tt></h3>
<p>Returns a new <a href="qgeosatelliteinfosource.html">QGeoSatelliteInfoSource</a> associated with this plugin with parent <i>parent</i>. Can also return 0, in which case the factory with the next highest priority will be used instead.</p>
<!-- @@@satelliteInfoSource -->
<!-- $$$sourceName[overload1]$$$sourceName -->
<h3 class="fn"><a name="sourceName"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QGeoPositionInfoSourceFactory::<span class="name">sourceName</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the string used to identify the position provider behind this implementation.</p>
<p>The combination of sourceName() and <a href="qgeopositioninfosourcefactory.html#sourceVersion">sourceVersion</a>() should be unique amongst the plugins.</p>
<!-- @@@sourceName -->
<!-- $$$sourcePriority[overload1]$$$sourcePriority -->
<h3 class="fn"><a name="sourcePriority"></a><span class="type">int</span> QGeoPositionInfoSourceFactory::<span class="name">sourcePriority</span> () const<tt> [virtual]</tt></h3>
<p>Returns the priority of this factory in the list of available factories. Factories with higher values of priority will be preferred to those with lower values.</p>
<!-- @@@sourcePriority -->
<!-- $$$sourceVersion[overload1]$$$sourceVersion -->
<h3 class="fn"><a name="sourceVersion"></a><span class="type">int</span> QGeoPositionInfoSourceFactory::<span class="name">sourceVersion</span> () const<tt> [pure virtual]</tt></h3>
<p>Returns the version of the plugin.</p>
<p>The combination of <a href="qgeopositioninfosourcefactory.html#sourceName">sourceName</a>() and sourceVersion() should be unique amongst the plugins.</p>
<!-- @@@sourceVersion -->
</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>