Sophie

Sophie

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

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" />
<!-- qcontact.cpp -->
  <title>Qt Mobility 1.2: QContact 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="qtcontacts.html">QtContacts</a></li>
<li>QContact</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="#related-non-members">Related Non-Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QContact Class Reference</h1>
<!-- $$$QContact-brief -->
<p>The QContact class represents an addressbook contact. <a href="#details">More...</a></p>
<!-- @@@QContact -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QContact&gt;</span></pre><p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qcontact-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="qcontact.html#QContact">QContact</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#QContact-2">QContact</a></b> ( const QContact &amp; <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#dtor.QContact">~QContact</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#addTag">addTag</a></b> ( const QString &amp; <i>tag</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactActionDescriptor&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#availableActions">availableActions</a></b> ( const QString &amp; <i>serviceName</i> = QString() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#clearDetails">clearDetails</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#clearTags">clearTags</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactDetail </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#detail">detail</a></b> ( const QString &amp; <i>definitionName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactDetail </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#detail-3">detail</a></b> ( const QLatin1Constant &amp; <i>definitionName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> T </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#detail-4">detail</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactDetail&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#details">details</a></b> ( const QString &amp; <i>definitionName</i> = QString() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactDetail&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#details-2">details</a></b> ( const QString &amp; <i>definitionName</i>, const QString &amp; <i>fieldName</i>, const QString &amp; <i>value</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactDetail&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#details-5">details</a></b> ( const QLatin1Constant &amp; <i>definitionName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactDetail&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#details-6">details</a></b> ( const QLatin1Constant &amp; <i>definitionName</i>, const QLatin1Constant &amp; <i>fieldName</i>, const QString &amp; <i>value</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;T&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#details-7">details</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;T&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#details-8">details</a></b> ( const QString &amp; <i>fieldName</i>, const QString &amp; <i>value</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#displayLabel">displayLabel</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactId </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#id">id</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#isEmpty">isEmpty</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#isPreferredDetail">isPreferredDetail</a></b> ( const QString &amp; <i>actionName</i>, const QContactDetail &amp; <i>detail</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactLocalId </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#localId">localId</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactDetail </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#preferredDetail">preferredDetail</a></b> ( const QString &amp; <i>actionName</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap&lt;QString, QContactDetail&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#preferredDetails">preferredDetails</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactId&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#relatedContacts">relatedContacts</a></b> ( const QString &amp; <i>relationshipType</i> = QString(), QContactRelationship::Role <i>role</i> = QContactRelationship::Either ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList&lt;QContactRelationship&gt; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#relationships">relationships</a></b> ( const QString &amp; <i>relationshipType</i> = QString() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#removeDetail">removeDetail</a></b> ( QContactDetail * <i>detail</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#saveDetail">saveDetail</a></b> ( QContactDetail * <i>detail</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#setId">setId</a></b> ( const QContactId &amp; <i>id</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#setPreferredDetail">setPreferredDetail</a></b> ( const QString &amp; <i>actionName</i>, const QContactDetail &amp; <i>preferredDetail</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#setTags">setTags</a></b> ( const QStringList &amp; <i>tags</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#setType">setType</a></b> ( const QString &amp; <i>type</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#setType-2">setType</a></b> ( const QContactType &amp; <i>type</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#tags">tags</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#type">type</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#operator-not-eq">operator!=</a></b> ( const QContact &amp; <i>other</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContact &amp; </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#operator-eq">operator=</a></b> ( const QContact &amp; <i>other</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#operator-eq-eq">operator==</a></b> ( const QContact &amp; <i>other</i> ) const</td></tr>
</table>
<a name="related-non-members"></a>
<h2>Related Non-Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> uint </td><td class="memItemRight bottomAlign"><b><a href="qcontact.html#qHash-34">qHash</a></b> ( const QContact &amp; <i>key</i> )</td></tr>
</table>
<a name="details"></a>
<!-- $$$QContact-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QContact class represents an addressbook contact.</p>
<p>Individual contacts, groups, and other types of contacts are represented with a QContact object. In addition to the type, a QContact consists of information that belongs to the contact, some information about the relationships that the contact has, and the preferred ways to interact with the contact.</p>
<p>A QContact object has a collection of details (like a name, phone numbers and email addresses). Each detail (which can have multiple fields) is stored in an appropriate subclass of <a href="qcontactdetail.html">QContactDetail</a>, and the QContact allows retrieving these details in various ways.</p>
<p>Depending on the details of the QContact, certain actions are available for a contact. An instance of a QContact can return a list of actions that can be performed on it, and a list of details supported by a specific action can be retrieved (for example - a list of phone numbers supported by a specific &quot;Call&quot; action). It is also possible to store one detail for each type of action that is the &quot;preferred&quot; detail to use.</p>
<p>A QContact may have zero or more relationships with other contacts. For example, a group contact would have a <tt>&quot;HasMember&quot;</tt> relationship with the QContacts that are its members. Spouses, managers and assistants can also be represented this way.</p>
<p>A QContact instance represents the in-memory version of an addressbook contact, and has no tie to a specific <a href="qcontactmanager.html">QContactManager</a>. It is possible for the contents of a QContact to change independently of the contents that are stored persistently in a <a href="qcontactmanager.html">QContactManager</a>. A QContact has an ID associated with it when it is first retrieved from a <a href="qcontactmanager.html">QContactManager</a>, or after it has been first saved, and this allows clients to track changes using the signals in <a href="qcontactmanager.html">QContactManager</a>.</p>
<p>A QContact has a number of mandatory details:</p>
<ul>
<li>A <a href="qcontacttype.html">QContactType</a>, with the type of the contact (individual contact, group etc)</li>
<li>A <a href="qcontactdisplaylabel.html">QContactDisplayLabel</a>, representing the text to display</li>
</ul>
<p>If you have edited the contents of a QContact (via saving or removing details), you will need to ask a specific <a href="qcontactmanager.html">QContactManager</a> for the new display label for the contact, since system settings (like the order of first or last names) can vary between managers.</p>
</div>
<p><b>See also </b><a href="qcontactmanager.html">QContactManager</a> and <a href="qcontactdetail.html">QContactDetail</a>.</p>
<!-- @@@QContact -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QContact[overload1]$$$QContact -->
<h3 class="fn"><a name="QContact"></a>QContact::<span class="name">QContact</span> ()</h3>
<p>Construct an empty contact.</p>
<p>The contact will have an empty display label, an empty id, and have type <a href="qcontacttype.html#TypeContact-var">QContactType::TypeContact</a>. The <a href="qcontact.html#isEmpty">isEmpty</a>() function will return true.</p>
<!-- @@@QContact -->
<!-- $$$QContact$$$QContactconstQContact& -->
<h3 class="fn"><a name="QContact-2"></a>QContact::<span class="name">QContact</span> ( const <span class="type">QContact</span> &amp; <i>other</i> )</h3>
<p>Initializes this <a href="qcontact.html">QContact</a> from <i>other</i></p>
<!-- @@@QContact -->
<!-- $$$~QContact[overload1]$$$~QContact -->
<h3 class="fn"><a name="dtor.QContact"></a>QContact::<span class="name">~QContact</span> ()</h3>
<p>Frees the memory used by this <a href="qcontact.html">QContact</a></p>
<!-- @@@~QContact -->
<!-- $$$addTag[overload1]$$$addTagconstQString& -->
<h3 class="fn"><a name="addTag"></a><span class="type">void</span> QContact::<span class="name">addTag</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>tag</i> )</h3>
<p>Adds the <i>tag</i> to this contact.</p>
<p><b>See also </b><a href="qcontacttag.html">QContactTag</a>.</p>
<!-- @@@addTag -->
<!-- $$$availableActions[overload1]$$$availableActionsconstQString& -->
<h3 class="fn"><a name="availableActions"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qcontactactiondescriptor.html">QContactActionDescriptor</a></span>&gt; QContact::<span class="name">availableActions</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>serviceName</i> = QString() ) const</h3>
<p>Return a list of descriptors for the actions available to be performed on this contact.</p>
<p>The actions considered can be restricted by the optional parameters The actions can be restricted to those provided by a specific service with the <i>serviceName</i> parameter. If <i>serviceName</i> is empty, actions provided by any service will be returned if the contact meets the required criteria (contains details of the correct type, etc).</p>
<p>Each action that matches the above criteria will be tested to see if this contact is supported by the action, and a list of the action descriptors that are supported will be returned.</p>
<!-- @@@availableActions -->
<!-- $$$clearDetails[overload1]$$$clearDetails -->
<h3 class="fn"><a name="clearDetails"></a><span class="type">void</span> QContact::<span class="name">clearDetails</span> ()</h3>
<p>Removes all details of the contact. This function does not modify the id or type of the contact. Calling <a href="qcontact.html#isEmpty">isEmpty</a>() after calling this function will return true.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@clearDetails -->
<!-- $$$clearTags[overload1]$$$clearTags -->
<h3 class="fn"><a name="clearTags"></a><span class="type">void</span> QContact::<span class="name">clearTags</span> ()</h3>
<p>Removes all tags associated with the contact.</p>
<p><b>See also </b><a href="qcontacttag.html">QContactTag</a>.</p>
<!-- @@@clearTags -->
<!-- $$$detail[overload1]$$$detailconstQString& -->
<h3 class="fn"><a name="detail"></a><span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> QContact::<span class="name">detail</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>definitionName</i> ) const</h3>
<p>Returns the first detail stored in the contact with the given <i>definitionName</i></p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@detail -->
<!-- $$$detail$$$detailconstQLatin1Constant& -->
<h3 class="fn"><a name="detail-3"></a><span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> QContact::<span class="name">detail</span> ( const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> &amp; <i>definitionName</i> ) const</h3>
<p>Returns the first detail stored in the contact which with the given <i>definitionName</i>. The <i>definitionName</i> argument is typically the detail name constant provided by a specific subclass of <a href="qcontactdetail.html">QContactDetail</a>. For example:</p>
<pre class="cpp"> <span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> detail <span class="operator">=</span> contact<span class="operator">.</span>detail(<span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">::</span>DefinitionName);</pre>
<p>It would usually be more convenient to use the template version of this function, in the following manner:</p>
<pre class="cpp"> <span class="type"><a href="qcontactname.html">QContactName</a></span> name <span class="operator">=</span> contact<span class="operator">.</span>detail<span class="operator">&lt;</span><span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">&gt;</span>();</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@detail -->
<!-- $$$detail$$$detail -->
<h3 class="fn"><a name="detail-4"></a><span class="type">T</span> QContact::<span class="name">detail</span> () const</h3>
<p>Returns the first detail of the template parameter type, as returned by the template <a href="qcontact.html#details">details</a>() function. The type must be a subclass of <a href="qcontactdetail.html">QContactDetail</a>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@detail -->
<!-- $$$details[overload1]$$$detailsconstQString& -->
<h3 class="fn"><a name="details"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qcontactdetail.html">QContactDetail</a></span>&gt; QContact::<span class="name">details</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>definitionName</i> = QString() ) const</h3>
<p>Returns a list of details with the given <i>definitionName</i> The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g&#x2e; <a href="qcontactphonenumber.html#DefinitionName-var">QContactPhoneNumber::DefinitionName</a>) or by requesting a list of all the definitions synchronously with <a href="qcontactmanager.html#detailDefinitions">detailDefinitions()</a> or asynchronously with a <a href="qcontactdetaildefinitionfetchrequest.html">detail definition fetch request</a>, and then inspecting the <a href="qcontactdetaildefinition.html#name">name()</a> of each definition. If <i>definitionName</i> is empty, all details of any definition will be returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@details -->
<!-- $$$details$$$detailsconstQString&constQString&constQString& -->
<h3 class="fn"><a name="details-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="qcontactdetail.html">QContactDetail</a></span>&gt; QContact::<span class="name">details</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>definitionName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>fieldName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>value</i> ) const</h3>
<p>Returns a list of details of the given <i>definitionName</i>, with fields named <i>fieldName</i> and with value <i>value</i>. The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g&#x2e; <a href="qcontactphonenumber.html#DefinitionName-var">QContactPhoneNumber::DefinitionName</a>) or by requesting a list of all the definitions synchronously with <a href="qcontactmanager.html#detailDefinitions">detailDefinitions()</a> or asynchronously with a <a href="qcontactdetaildefinitionfetchrequest.html">detail definition fetch request</a>, and then inspecting the <a href="qcontactdetaildefinition.html#name">name()</a> of each definition. If <i>definitionName</i> is empty, all details of any definition will be returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@details -->
<!-- $$$details$$$detailsconstQLatin1Constant& -->
<h3 class="fn"><a name="details-5"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qcontactdetail.html">QContactDetail</a></span>&gt; QContact::<span class="name">details</span> ( const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> &amp; <i>definitionName</i> ) const</h3>
<p>Returns a list of details of the given <i>definitionName</i>.</p>
<p>The <i>definitionName</i> argument is typically the detail name constant provided by a specific subclass of <a href="qcontactdetail.html">QContactDetail</a>. For example:</p>
<pre class="cpp"> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactdetail.html">QContactDetail</a></span><span class="operator">&gt;</span> details <span class="operator">=</span> contact<span class="operator">.</span>details(<span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">::</span>DefinitionName);</pre>
<p>It would usually be more convenient to use the template version of this function, in the following manner:</p>
<pre class="cpp"> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">&gt;</span> phoneNumbers <span class="operator">=</span> contact<span class="operator">.</span>details<span class="operator">&lt;</span><span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">&gt;</span>();</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@details -->
<!-- $$$details$$$detailsconstQLatin1Constant&constQLatin1Constant&constQString& -->
<h3 class="fn"><a name="details-6"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qcontactdetail.html">QContactDetail</a></span>&gt; QContact::<span class="name">details</span> ( const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> &amp; <i>definitionName</i>, const <span class="type"><a href="qlatin1constant.html">QLatin1Constant</a></span> &amp; <i>fieldName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>value</i> )</h3>
<p>Returns a list of details of the given <i>definitionName</i>, with fields named <i>fieldName</i> and with value <i>value</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@details -->
<!-- $$$details$$$details -->
<h3 class="fn"><a name="details-7"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type">T</span>&gt; QContact::<span class="name">details</span> () const</h3>
<p>Returns a list of details of the template parameter type. The type must be a subclass of <a href="qcontactdetail.html">QContactDetail</a>.</p>
<p>For example:</p>
<pre class="cpp"> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">&gt;</span> phoneNumbers <span class="operator">=</span> contact<span class="operator">.</span>details<span class="operator">&lt;</span><span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">&gt;</span>();</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@details -->
<!-- $$$details$$$detailsconstQString&constQString& -->
<h3 class="fn"><a name="details-8"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type">T</span>&gt; QContact::<span class="name">details</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>fieldName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>value</i> ) const</h3>
<p>Returns a list of details of the template parameter type which have field called <i>fieldName</i>, with matching <i>value</i>. The type must be a subclass of <a href="qcontactdetail.html">QContactDetail</a>.</p>
<p>For example:</p>
<pre class="cpp"> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">&gt;</span> homePhones <span class="operator">=</span> contact<span class="operator">.</span>details<span class="operator">&lt;</span><span class="type"><a href="qcontactphonenumber.html">QContactPhoneNumber</a></span><span class="operator">&gt;</span>(<span class="string">&quot;Context&quot;</span><span class="operator">,</span> <span class="string">&quot;Home&quot;</span>);</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@details -->
<!-- $$$displayLabel[overload1]$$$displayLabel -->
<h3 class="fn"><a name="displayLabel"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QContact::<span class="name">displayLabel</span> () const</h3>
<p>Returns the display label of this contact.</p>
<p>A contact which has been retrieved from a manager will have a display label set when the contact is retrieved.</p>
<p>The display label is usually read-only, since some managers do not support arbitrary labels (see also <a href="qcontactname.html#setCustomLabel">QContactName::setCustomLabel</a>()). If you modify the contact in a way that would affect the display label, you can call <a href="qcontactmanager.html#synthesizeContactDisplayLabel">QContactManager::synthesizeContactDisplayLabel</a>() to get an up-to-date display label.</p>
<p>See the following example for more information:</p>
<pre class="cpp">     <span class="comment">/* Retrieve a contact */</span>
     <span class="type"><a href="qcontact.html">QContact</a></span> c <span class="operator">=</span> manager<span class="operator">-</span><span class="operator">&gt;</span>contact(myId);
     <a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qDebug">qDebug</a>() <span class="operator">&lt;</span><span class="operator">&lt;</span> <span class="string">&quot;Current display label&quot;</span> <span class="operator">&lt;</span><span class="operator">&lt;</span> c<span class="operator">.</span>displayLabel();

     <span class="comment">/* Update some fields that might influence the display label */</span>
     <span class="type"><a href="qcontactname.html">QContactName</a></span> name <span class="operator">=</span> c<span class="operator">.</span>detail<span class="operator">&lt;</span><span class="type"><a href="qcontactname.html">QContactName</a></span><span class="operator">&gt;</span>();
     name<span class="operator">.</span>setFirstName(<span class="string">&quot;Abigail&quot;</span>);
     name<span class="operator">.</span>setLastName(<span class="string">&quot;Arkansas&quot;</span>);
     c<span class="operator">.</span>saveDetail(<span class="operator">&amp;</span>name);

     <span class="comment">/* Update the display label */</span>
     manager<span class="operator">-</span><span class="operator">&gt;</span>synthesizeContactDisplayLabel(<span class="operator">&amp;</span>c);
     <a href="http://qt.nokia.com/doc/4.7/qtglobal.html#qDebug">qDebug</a>() <span class="operator">&lt;</span><span class="operator">&lt;</span> <span class="string">&quot;Now the label is:&quot;</span> <span class="operator">&lt;</span><span class="operator">&lt;</span> c<span class="operator">.</span>displayLabel();</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactmanager.html#synthesizeContactDisplayLabel">QContactManager::synthesizeContactDisplayLabel</a>().</p>
<!-- @@@displayLabel -->
<!-- $$$id[overload1]$$$id -->
<h3 class="fn"><a name="id"></a><span class="type"><a href="qcontactid.html">QContactId</a></span> QContact::<span class="name">id</span> () const</h3>
<p>Returns the <a href="qcontactid.html">QContactId</a> that identifies this contact.</p>
<p>This may have been set when the contact was retrieved from a particular manager, or when the contact was first saved in a manager. The <a href="qcontactid.html">QContactId</a> is only valid with a specific manager. See <a href="qcontactmanager.html#saveContact">QContactManager::saveContact</a>() for more information.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontact.html#setId">setId</a>() and <a href="qcontact.html#localId">localId</a>().</p>
<!-- @@@id -->
<!-- $$$isEmpty[overload1]$$$isEmpty -->
<h3 class="fn"><a name="isEmpty"></a><span class="type">bool</span> QContact::<span class="name">isEmpty</span> () const</h3>
<p>Returns true if this <a href="qcontact.html">QContact</a> is empty, false if not.</p>
<p>An empty <a href="qcontact.html">QContact</a> has an empty label and no extra details. The type of the contact is irrelevant.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@isEmpty -->
<!-- $$$isPreferredDetail[overload1]$$$isPreferredDetailconstQString&constQContactDetail& -->
<h3 class="fn"><a name="isPreferredDetail"></a><span class="type">bool</span> QContact::<span class="name">isPreferredDetail</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>actionName</i>, const <span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> &amp; <i>detail</i> ) const</h3>
<p>Returns true if the given <i>detail</i> is a preferred detail for the given <i>actionName</i>, or for any action if the <i>actionName</i> is empty.</p>
<p><b>See also </b><a href="qcontact.html#preferredDetail">preferredDetail</a>().</p>
<!-- @@@isPreferredDetail -->
<!-- $$$localId[overload1]$$$localId -->
<h3 class="fn"><a name="localId"></a><span class="type"><a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a></span> QContact::<span class="name">localId</span> () const</h3>
<p>Returns the <a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a> that identifies this contact within its manager</p>
<p>This may have been set when the contact was retrieved from a particular manager, or when the contact was first saved in a manager. The <a href="qcontactid.html#QContactLocalId-typedef">QContactLocalId</a> is associated with a specific manager, but other contacts with the same local id might exist in different managers.</p>
<p>See <a href="qcontactmanager.html#saveContact">QContactManager::saveContact</a>() for more information.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontact.html#id">id</a>().</p>
<!-- @@@localId -->
<!-- $$$preferredDetail[overload1]$$$preferredDetailconstQString& -->
<h3 class="fn"><a name="preferredDetail"></a><span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> QContact::<span class="name">preferredDetail</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>actionName</i> ) const</h3>
<p>Returns the preferred detail for a given <i>actionName</i>.</p>
<p>If the <i>actionName</i> is empty, or there is no preference recorded for the supplied <i>actionName</i>, returns an empty <a href="qcontactdetail.html">QContactDetail</a>.</p>
<p><b>See also </b><a href="qcontact.html#setPreferredDetail">setPreferredDetail</a>() and <a href="qcontact.html#preferredDetails">preferredDetails</a>().</p>
<!-- @@@preferredDetail -->
<!-- $$$preferredDetails[overload1]$$$preferredDetails -->
<h3 class="fn"><a name="preferredDetails"></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="qcontactdetail.html">QContactDetail</a></span>&gt; QContact::<span class="name">preferredDetails</span> () const</h3>
<p>Returns the recorded detail preferences for action names.</p>
<p>Each entry in the map has the action name as the key, and the corresponding preferred detail as the value.</p>
<!-- @@@preferredDetails -->
<!-- $$$relatedContacts[overload1]$$$relatedContactsconstQString&QContactRelationship::Role -->
<h3 class="fn"><a name="relatedContacts"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qcontactid.html">QContactId</a></span>&gt; QContact::<span class="name">relatedContacts</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>relationshipType</i> = QString(), <span class="type"><a href="qcontactrelationship.html#Role-enum">QContactRelationship::Role</a></span> <i>role</i> = QContactRelationship::Either ) const</h3>
<p>Returns a list of the ids of contacts which have a relationship of the given <i>relationshipType</i> with this contact. The <i>role</i> parameter describes the role that the related contacts have in the relationship.</p>
<p>If <i>relationshipType</i> is empty, relationships of all types will be considered.</p>
<p><b>Note:</b> This function only examines the relationships that were present when this contact was retrieved from a manager. You can also query the manager directly, if you require the most up to date information.</p>
<pre class="cpp"> <span class="comment">// Who are the members of a group contact?</span>
 <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactid.html">QContactId</a></span><span class="operator">&gt;</span> groupMembers <span class="operator">=</span> groupContact<span class="operator">.</span>relatedContacts(<span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>HasMember<span class="operator">,</span> <span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>Second);
 <span class="comment">// What groups is this contact in?</span>
 <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactid.html">QContactId</a></span><span class="operator">&gt;</span> contactGroups <span class="operator">=</span> contact<span class="operator">.</span>relatedContacts(<span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>HasMember<span class="operator">,</span> <span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>First);
 <span class="comment">// An alternative to QContact::relationships()</span>
 <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactid.html">QContactId</a></span><span class="operator">&gt;</span> spouses <span class="operator">=</span> contact<span class="operator">.</span>relatedContacts(<span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>HasSpouse<span class="operator">,</span> <span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>Either);
 <span class="keyword">if</span> (spouses<span class="operator">.</span>count() <span class="operator">&gt;</span> <span class="number">1</span>) {
     <span class="comment">// Custom relationship type</span>
     <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactid.html">QContactId</a></span><span class="operator">&gt;</span> therapists <span class="operator">=</span> contact<span class="operator">.</span>relatedContacts(<span class="string">&quot;HasTherapist&quot;</span><span class="operator">,</span> <span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>Second);
 }</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactrelationshipfetchrequest.html">QContactRelationshipFetchRequest</a> and <a href="qcontactmanager.html#relationships">QContactManager::relationships</a>().</p>
<!-- @@@relatedContacts -->
<!-- $$$relationships[overload1]$$$relationshipsconstQString& -->
<h3 class="fn"><a name="relationships"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span>&gt; QContact::<span class="name">relationships</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>relationshipType</i> = QString() ) const</h3>
<p>Returns a list of relationships of the given <i>relationshipType</i> in which this contact is a participant.</p>
<p>If <i>relationshipType</i> is empty, all relationships will be returned.</p>
<p><b>Note:</b> This function only examines the relationships that were present when this contact was retrieved from a manager. You can also query the manager directly, if you require the most up to date information.</p>
<pre class="cpp"> <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator">&lt;</span><span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">&gt;</span> spouseRelationships <span class="operator">=</span> contact<span class="operator">.</span>relationships(<span class="type"><a href="qcontactrelationship.html">QContactRelationship</a></span><span class="operator">::</span>HasSpouse);
 <span class="comment">// For each relationship in spouseRelationships, contact.id() will either be first() or second()</span></pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactrelationshipfetchrequest.html">QContactRelationshipFetchRequest</a> and <a href="qcontactmanager.html#relationships">QContactManager::relationships</a>().</p>
<!-- @@@relationships -->
<!-- $$$removeDetail[overload1]$$$removeDetailQContactDetail* -->
<h3 class="fn"><a name="removeDetail"></a><span class="type">bool</span> QContact::<span class="name">removeDetail</span> ( <span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> * <i>detail</i> )</h3>
<p>Removes the <i>detail</i> from the contact.</p>
<p>The detail in the contact which has the same key as that of the given <i>detail</i> will be removed if it exists. Only the key is used for comparison - that is, the information in the detail may be different.</p>
<p>Any action preferences for the matching detail is also removed.</p>
<p>Be aware that if a contact is retrieved (or reloaded) from the backend, the keys of any details it contains may have been changed by the backend, or other threads may have modified the contact details in the backend. Therefore, clients should reload the detail that they wish to remove from a contact after retrieving the contact, in order to ensure that the remove operation is successful.</p>
<p>If the detail's access constraint includes <tt>QContactDetail::Irremovable</tt>, this function will return false.</p>
<p>Returns true if the detail was removed successfully, false if an error occurred.</p>
<p>Note that the caller retains ownership of the detail.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@removeDetail -->
<!-- $$$saveDetail[overload1]$$$saveDetailQContactDetail* -->
<h3 class="fn"><a name="saveDetail"></a><span class="type">bool</span> QContact::<span class="name">saveDetail</span> ( <span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> * <i>detail</i> )</h3>
<p>Saves the given <i>detail</i> in the list of stored details, and sets the detail's id. If another detail of the same type and id has been previously saved in this contact, that detail is overwritten. Otherwise, a new id is generated and set in the detail, and the detail is added to the contact.</p>
<p>If the detail's access constraint includes <tt>QContactDetail::ReadOnly</tt>, this function will return true and save the detail in the contact, however attempting to save the contact in a manager may fail (if that manager decides that the read only detail should not be updated). Details with the <tt>QContactDetail::ReadOnly</tt> constraint set are typically provided in a contact by the manager, and are usually information that is either synthesized, or not intended to be changed by the user (e.g&#x2e; presence information for other contacts).</p>
<p>If <i>detail</i> is a <a href="qcontacttype.html">QContactType</a>, the existing contact type will be overwritten with <i>detail</i>. There is never more than one contact type in a contact.</p>
<p>If <i>detail</i> is a <a href="qcontactdisplaylabel.html">QContactDisplayLabel</a>, the contact will not be updated, and the function will return false. Since the display label formatting is specific to each manager, use the <a href="qcontactmanager.html#synthesizeContactDisplayLabel">QContactManager::synthesizeContactDisplayLabel</a>() function instead.</p>
<p>Be aware that if a contact is retrieved (or reloaded) from the backend, the keys of any details it contains may have been changed by the backend, or other threads may have modified the contact details in the backend. Therefore, clients should reload the detail that they wish to save in a contact after retrieving the contact, in order to avoid creating unwanted duplicated details.</p>
<p>Returns true if the detail was saved successfully, otherwise returns false.</p>
<p>Note that the caller retains ownership of the detail.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactmanager.html#synthesizeContactDisplayLabel">QContactManager::synthesizeContactDisplayLabel</a>().</p>
<!-- @@@saveDetail -->
<!-- $$$setId[overload1]$$$setIdconstQContactId& -->
<h3 class="fn"><a name="setId"></a><span class="type">void</span> QContact::<span class="name">setId</span> ( const <span class="type"><a href="qcontactid.html">QContactId</a></span> &amp; <i>id</i> )</h3>
<p>Sets the id of this contact to <i>id</i>.</p>
<p>Note that this only affects this object, not any corresponding structures stored by a <a href="qcontactmanager.html">QContactManager</a>.</p>
<p>If you change the id of a contact and save the contact in a manager, the previously existing contact will still exist. You can do this to create copies (possibly modified) of an existing contact, or to save a contact in a different manager.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontact.html#id">id</a>() and <a href="qcontactmanager.html#saveContact">QContactManager::saveContact</a>().</p>
<!-- @@@setId -->
<!-- $$$setPreferredDetail[overload1]$$$setPreferredDetailconstQString&constQContactDetail& -->
<h3 class="fn"><a name="setPreferredDetail"></a><span class="type">bool</span> QContact::<span class="name">setPreferredDetail</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>actionName</i>, const <span class="type"><a href="qcontactdetail.html">QContactDetail</a></span> &amp; <i>preferredDetail</i> )</h3>
<p>Set a particular detail (<i>preferredDetail</i>) as the preferred detail for any actions with the given <i>actionName</i>.</p>
<p>The <i>preferredDetail</i> object must exist in this object, and the <i>actionName</i> cannot be empty.</p>
<p>Returns true if the preference could be recorded, and false otherwise.</p>
<p><b>See also </b><a href="qcontact.html#preferredDetail">preferredDetail</a>().</p>
<!-- @@@setPreferredDetail -->
<!-- $$$setTags[overload1]$$$setTagsconstQStringList& -->
<h3 class="fn"><a name="setTags"></a><span class="type">void</span> QContact::<span class="name">setTags</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> &amp; <i>tags</i> )</h3>
<p>Sets the list of tags associated with the contact to <i>tags</i>.</p>
<p><b>See also </b><a href="qcontact.html#tags">tags</a>() and <a href="qcontacttag.html">QContactTag</a>.</p>
<!-- @@@setTags -->
<!-- $$$setType[overload1]$$$setTypeconstQString& -->
<h3 class="fn"><a name="setType"></a><span class="type">void</span> QContact::<span class="name">setType</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>type</i> )</h3>
<p>Sets the type of the contact to the given <i>type</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontact.html#type">type</a>().</p>
<!-- @@@setType -->
<!-- $$$setType$$$setTypeconstQContactType& -->
<h3 class="fn"><a name="setType-2"></a><span class="type">void</span> QContact::<span class="name">setType</span> ( const <span class="type"><a href="qcontacttype.html">QContactType</a></span> &amp; <i>type</i> )</h3>
<p>Sets the type of the contact to the given <i>type</i> detail.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@setType -->
<!-- $$$tags[overload1]$$$tags -->
<h3 class="fn"><a name="tags"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QContact::<span class="name">tags</span> () const</h3>
<p>Returns the list of tags for this contact. Tags are used for non-exclusive categorization.</p>
<p><b>See also </b><a href="qcontact.html#setTags">setTags</a>() and <a href="qcontacttag.html">QContactTag</a>.</p>
<!-- @@@tags -->
<!-- $$$type[overload1]$$$type -->
<h3 class="fn"><a name="type"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QContact::<span class="name">type</span> () const</h3>
<p>Returns the type of the contact. Every contact has exactly one type which is either set manually (by saving a modified copy of the <a href="qcontacttype.html">QContactType</a> in the contact, or by calling <a href="qcontact.html#setType">setType</a>()) or synthesized automatically.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontact.html#setType">setType</a>().</p>
<!-- @@@type -->
<!-- $$$operator!=[overload1]$$$operator!=constQContact& -->
<h3 class="fn"><a name="operator-not-eq"></a><span class="type">bool</span> QContact::<span class="name">operator!=</span> ( const <span class="type">QContact</span> &amp; <i>other</i> ) const</h3>
<p>Returns true if this contacts id or details are different to those of the <i>other</i> contact.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@operator!= -->
<!-- $$$operator=[overload1]$$$operator=constQContact& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">QContact</span> &amp; QContact::<span class="name">operator=</span> ( const <span class="type">QContact</span> &amp; <i>other</i> )</h3>
<p>Replace the contents of this <a href="qcontact.html">QContact</a> with <i>other</i> *</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@operator= -->
<!-- $$$operator==[overload1]$$$operator==constQContact& -->
<h3 class="fn"><a name="operator-eq-eq"></a><span class="type">bool</span> QContact::<span class="name">operator==</span> ( const <span class="type">QContact</span> &amp; <i>other</i> ) const</h3>
<p>Returns true if this contact is equal to the <i>other</i> contact, false if either the id or stored details are not the same</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@operator== -->
</div>
<div class="relnonmem">
<h2>Related Non-Members</h2>
<!-- $$$qHash$$$qHashconstQContact& -->
<h3 class="fn"><a name="qHash-34"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <span class="name">qHash</span> ( const <span class="type">QContact</span> &amp; <i>key</i> )</h3>
<p>Returns the hash value for <i>key</i>.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@qHash -->
</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>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional