Sophie

Sophie

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

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" />
<!-- qversitcontactexporter.cpp -->
  <title>Qt Mobility 1.2: QVersitContactExporterDetailHandlerV2 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="qtversit.html">QtVersit</a></li>
<li>QVersitContactExporterDetailHandlerV2</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>
</ul>
</div>
<h1 class="title">QVersitContactExporterDetailHandlerV2 Class Reference</h1>
<!-- $$$QVersitContactExporterDetailHandlerV2-brief -->
<p>The QVersitContactExporterDetailHandlerV2 class is an interface for specifying custom export behaviour for certain contact details. <a href="#details">More...</a></p>
<!-- @@@QVersitContactExporterDetailHandlerV2 -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QVersitContactExporterDetailHandlerV2&gt;</span></pre><p><b>Inherited by: </b><a href="qversitcontacthandler.html">QVersitContactHandler</a>.</p>
<ul>
<li><a href="qversitcontactexporterdetailhandlerv2-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="qversitcontactexporterdetailhandlerv2.html#dtor.QVersitContactExporterDetailHandlerV2">~QVersitContactExporterDetailHandlerV2</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qversitcontactexporterdetailhandlerv2.html#contactProcessed">contactProcessed</a></b> ( const QContact &amp; <i>contact</i>, QVersitDocument * <i>document</i> ) = 0</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qversitcontactexporterdetailhandlerv2.html#detailProcessed">detailProcessed</a></b> ( const QContact &amp; <i>contact</i>, const QContactDetail &amp; <i>detail</i>, const QVersitDocument &amp; <i>document</i>, QSet&lt;QString&gt; * <i>processedFields</i>, QList&lt;QVersitProperty&gt; * <i>toBeRemoved</i>, QList&lt;QVersitProperty&gt; * <i>toBeAdded</i> ) = 0</td></tr>
</table>
<a name="details"></a>
<!-- $$$QVersitContactExporterDetailHandlerV2-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QVersitContactExporterDetailHandlerV2 class is an interface for specifying custom export behaviour for certain contact details.</p>
<p>This interface supercedes <a href="qversitcontactexporterdetailhandler.html">QVersitContactExporterDetailHandler</a>. For general information on extending Qt Versit, see the document on <a href="versitplugins.html">Versit Plugins</a>.</p>
</div>
<p><b>See also </b><a href="qversitcontactexporter.html">QVersitContactExporter</a>.</p>
<!-- @@@QVersitContactExporterDetailHandlerV2 -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$~QVersitContactExporterDetailHandlerV2[overload1]$$$~QVersitContactExporterDetailHandlerV2 -->
<h3 class="fn"><a name="dtor.QVersitContactExporterDetailHandlerV2"></a>QVersitContactExporterDetailHandlerV2::<span class="name">~QVersitContactExporterDetailHandlerV2</span> ()<tt> [virtual]</tt></h3>
<p>Frees any memory in use by this handler.</p>
<!-- @@@~QVersitContactExporterDetailHandlerV2 -->
<!-- $$$contactProcessed[overload1]$$$contactProcessedconstQContact&QVersitDocument* -->
<h3 class="fn"><a name="contactProcessed"></a><span class="type">void</span> QVersitContactExporterDetailHandlerV2::<span class="name">contactProcessed</span> ( const <span class="type"><a href="qcontact.html">QContact</a></span> &amp; <i>contact</i>, <span class="type"><a href="qversitdocument.html">QVersitDocument</a></span> * <i>document</i> )<tt> [pure virtual]</tt></h3>
<p>Perform any final processing on the <i>document</i> generated by the <i>contact</i>. This can be implemented by the handler to clear any internal state before moving onto the next contact.</p>
<p>This function is called after all QContactDetails have been handled by the <a href="qversitcontactexporter.html">QVersitContactExporter</a>.</p>
<!-- @@@contactProcessed -->
<!-- $$$detailProcessed[overload1]$$$detailProcessedconstQContact&constQContactDetail&constQVersitDocument&QSet<QString>*QList<QVersitProperty>*QList<QVersitProperty>* -->
<h3 class="fn"><a name="detailProcessed"></a><span class="type">void</span> QVersitContactExporterDetailHandlerV2::<span class="name">detailProcessed</span> ( const <span class="type"><a href="qcontact.html">QContact</a></span> &amp; <i>contact</i>, const <span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> &amp; <i>detail</i>, const <span class="type"><a href="qversitdocument.html">QVersitDocument</a></span> &amp; <i>document</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qset.html">QSet</a></span>&lt;<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>&gt; * <i>processedFields</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qversitproperty.html">QVersitProperty</a></span>&gt; * <i>toBeRemoved</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qversitproperty.html">QVersitProperty</a></span>&gt; * <i>toBeAdded</i> )<tt> [pure virtual]</tt></h3>
<p>Process <i>detail</i> and provide a list of updated <a href="qversitproperty.html">QVersitProperties</a> by modifying the <i>toBeRemoved</i> and <i>toBeAdded</i> lists.</p>
<p>This function is called on every <a href="qcontactdetail.html">QContactDetail</a> encountered during an export, after the detail has been processed by the <a href="qversitcontactexporter.html">QVersitContactExporter</a>. An implementation of this function can be made to provide support for QContactDetails not supported by <a href="qversitcontactexporter.html">QVersitContactExporter</a>.</p>
<p>The supplied <i>contact</i> is the container for the <i>detail</i>. <i>processedFields</i> contains a list of fields in the <i>detail</i> that were considered by the <a href="qversitcontactexporter.html">QVersitContactExporter</a> or another handler in processing the detail. <i>document</i> holds the state of the document before the detail was processed by the exporter.</p>
<p><i>toBeRemoved</i> and <i>toBeAdded</i> are initially filled with a list of properties that the exporter will remove from and add to the document. These lists can be modified (by removing, modifying or adding properties) by the handler to control the changes that will actually be made to the document. If a property is to be modified in the document, the old version will appear in the <i>toBeRemoved</i> list and the new version will appear in the <i>toBeAdded</i> list. When the handler uses a field from the detail, it should update the processedFields set to reflect this to inform later handlers that the field has already been processed.</p>
<p>After the handler returns control back to the exporter, the properties in the <i>toBeRemoved</i> list will be removed and the properties in the <i>toBeAdded</i> list will be appended to the document.</p>
<!-- @@@detailProcessed -->
</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>