<?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" />
<!-- qcontactfetchrequest.cpp -->
<title>Qt Mobility 1.2: QContactFetchRequest 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>QContactFetchRequest</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">QContactFetchRequest Class Reference</h1>
<!-- $$$QContactFetchRequest-brief -->
<p>The QContactFetchRequest class allows a client to asynchronously request contacts from a contacts store manager. <a href="#details">More...</a></p>
<!-- @@@QContactFetchRequest -->
<pre class="cpp"> <span class="preprocessor">#include <QContactFetchRequest></span></pre><p><b>Inherits: </b><a href="qcontactabstractrequest.html">QContactAbstractRequest</a>.</p>
<p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qcontactfetchrequest-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="qcontactfetchrequest.html#QContactFetchRequest">QContactFetchRequest</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#dtor.QContactFetchRequest">~QContactFetchRequest</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QContact> </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#contacts">contacts</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactFetchHint </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#fetchHint">fetchHint</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QContactFilter </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#filter">filter</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#setFetchHint">setFetchHint</a></b> ( const QContactFetchHint & <i>fetchHint</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#setFilter">setFilter</a></b> ( const QContactFilter & <i>filter</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#setSorting">setSorting</a></b> ( const QList<QContactSortOrder> & <i>sorting</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QContactSortOrder> </td><td class="memItemRight bottomAlign"><b><a href="qcontactfetchrequest.html#sorting">sorting</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">9 public functions inherited from <a href="qcontactabstractrequest.html#public-functions">QContactAbstractRequest</a></li>
<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>
<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">3 public slots inherited from <a href="qcontactabstractrequest.html#public-slots">QContactAbstractRequest</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">2 signals inherited from <a href="qcontactabstractrequest.html#signals">QContactAbstractRequest</a></li>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">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">4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">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>
<!-- $$$QContactFetchRequest-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QContactFetchRequest class allows a client to asynchronously request contacts from a contacts store manager.</p>
<p>For a QContactFetchRequest, the <a href="qcontactabstractrequest.html#resultsAvailable">resultsAvailable</a>() signal will be emitted when the resultant contacts (which may be retrieved by calling <a href="qcontactfetchrequest.html#contacts">contacts</a>()), are updated, as well as if the overall operation error (which may be retrieved by calling <a href="qcontactabstractrequest.html#error">error</a>()) is updated.</p>
<p>Please see the class documentation of <a href="qcontactabstractrequest.html">QContactAbstractRequest</a> for more information about the usage of request classes and ownership semantics.</p>
</div>
<!-- @@@QContactFetchRequest -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QContactFetchRequest[overload1]$$$QContactFetchRequestQObject* -->
<h3 class="fn"><a name="QContactFetchRequest"></a>QContactFetchRequest::<span class="name">QContactFetchRequest</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a new contact fetch request whose parent is the specified <i>parent</i></p>
<!-- @@@QContactFetchRequest -->
<!-- $$$~QContactFetchRequest[overload1]$$$~QContactFetchRequest -->
<h3 class="fn"><a name="dtor.QContactFetchRequest"></a>QContactFetchRequest::<span class="name">~QContactFetchRequest</span> ()</h3>
<p>Frees any memory used by this request</p>
<!-- @@@~QContactFetchRequest -->
<!-- $$$contacts[overload1]$$$contacts -->
<h3 class="fn"><a name="contacts"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qcontact.html">QContact</a></span>> QContactFetchRequest::<span class="name">contacts</span> () const</h3>
<p>Returns the list of contacts retrieved by this request</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@contacts -->
<!-- $$$fetchHint[overload1]$$$fetchHint -->
<h3 class="fn"><a name="fetchHint"></a><span class="type"><a href="qcontactfetchhint.html">QContactFetchHint</a></span> QContactFetchRequest::<span class="name">fetchHint</span> () const</h3>
<p>Returns the fetch hint which may be used by the backend to optimize contact retrieval. A client should not make changes to a contact which has been retrieved using a fetch hint other than the default fetch hint. Doing so will result in information loss when saving the contact back to the manager (as the "new" restricted contact will replace the previously saved contact in the backend).</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactfetchrequest.html#setFetchHint">setFetchHint</a>() and <a href="qcontactfetchhint.html">QContactFetchHint</a>.</p>
<!-- @@@fetchHint -->
<!-- $$$filter[overload1]$$$filter -->
<h3 class="fn"><a name="filter"></a><span class="type"><a href="qcontactfilter.html">QContactFilter</a></span> QContactFetchRequest::<span class="name">filter</span> () const</h3>
<p>Returns the filter that will be used to select contacts to be returned</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactfetchrequest.html#setFilter">setFilter</a>().</p>
<!-- @@@filter -->
<!-- $$$setFetchHint[overload1]$$$setFetchHintconstQContactFetchHint& -->
<h3 class="fn"><a name="setFetchHint"></a><span class="type">void</span> QContactFetchRequest::<span class="name">setFetchHint</span> ( const <span class="type"><a href="qcontactfetchhint.html">QContactFetchHint</a></span> & <i>fetchHint</i> )</h3>
<p>Sets the fetch hint which may be used by the backend to optimize contact retrieval to <i>fetchHint</i>. A client should not make changes to a contact which has been retrieved using a fetch hint other than the default fetch hint. Doing so will result in information loss when saving the contact back to the manager (as the "new" restricted contact will replace the previously saved contact in the backend).</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactfetchrequest.html#fetchHint">fetchHint</a>() and <a href="qcontactfetchhint.html">QContactFetchHint</a>.</p>
<!-- @@@setFetchHint -->
<!-- $$$setFilter[overload1]$$$setFilterconstQContactFilter& -->
<h3 class="fn"><a name="setFilter"></a><span class="type">void</span> QContactFetchRequest::<span class="name">setFilter</span> ( const <span class="type"><a href="qcontactfilter.html">QContactFilter</a></span> & <i>filter</i> )</h3>
<p>Sets the contact filter used to determine which contacts will be retrieved to <i>filter</i></p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactfetchrequest.html#filter">filter</a>().</p>
<!-- @@@setFilter -->
<!-- $$$setSorting[overload1]$$$setSortingconstQList<QContactSortOrder>& -->
<h3 class="fn"><a name="setSorting"></a><span class="type">void</span> QContactFetchRequest::<span class="name">setSorting</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qcontactsortorder.html">QContactSortOrder</a></span>> & <i>sorting</i> )</h3>
<p>Sets the sort order of the result to <i>sorting</i>. Only has an effect if called prior to calling <tt>start()</tt></p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactfetchrequest.html#sorting">sorting</a>().</p>
<!-- @@@setSorting -->
<!-- $$$sorting[overload1]$$$sorting -->
<h3 class="fn"><a name="sorting"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qcontactsortorder.html">QContactSortOrder</a></span>> QContactFetchRequest::<span class="name">sorting</span> () const</h3>
<p>Returns the sort ordering that will be used sort the results of this request</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qcontactfetchrequest.html#setSorting">setSorting</a>().</p>
<!-- @@@sorting -->
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</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>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
50facae208d4a6f280e44a513b104320
>
files
>
724
