Sophie

Sophie

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

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" />
<!-- qmessagemanager.cpp -->
  <title>Qt Mobility 1.2: QMessageManager 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="qtmessaging.html">QtMessaging</a></li>
<li>QMessageManager</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-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QMessageManager Class Reference</h1>
<!-- $$$QMessageManager-brief -->
<p>The QMessageManager class represents the main interface for storage and retrieval of messages, folders and accounts in the system message store. <a href="#details">More...</a></p>
<!-- @@@QMessageManager -->
<pre class="cpp"> <span class="preprocessor">#include &lt;QMessageManager&gt;</span></pre><p><b>Inherits: </b><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a>.</p>
<p>This class was introduced in Qt Mobility 1.0.</p>
<ul>
<li><a href="qmessagemanager-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#Error-enum">Error</a></b> { NoError, InvalidId, ConstraintFailure, ContentInaccessible, ..., RequestIncomplete }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#NotificationFilterId-typedef">NotificationFilterId</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#NotificationFilterIdSet-typedef">NotificationFilterIdSet</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#RemovalOption-enum">RemovalOption</a></b> { RemoveLocalCopyOnly, RemoveOnOriginatingServer }</td></tr>
</table>
<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="qmessagemanager.html#QMessageManager">QMessageManager</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#dtor.QMessageManager">~QMessageManager</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageAccount </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#account">account</a></b> ( const QMessageAccountId &amp; <i>id</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#addMessage">addMessage</a></b> ( QMessage * <i>message</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#countAccounts">countAccounts</a></b> ( const QMessageAccountFilter &amp; <i>filter</i> = QMessageAccountFilter() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#countFolders">countFolders</a></b> ( const QMessageFolderFilter &amp; <i>filter</i> = QMessageFolderFilter() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#countMessages">countMessages</a></b> ( const QMessageFilter &amp; <i>filter</i> = QMessageFilter() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageManager::Error </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageFolder </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#folder">folder</a></b> ( const QMessageFolderId &amp; <i>id</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessage </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#message">message</a></b> ( const QMessageId &amp; <i>id</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageAccountIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryAccounts">queryAccounts</a></b> ( const QMessageAccountFilter &amp; <i>filter</i> = QMessageAccountFilter(), const QMessageAccountSortOrder &amp; <i>sortOrder</i> = QMessageAccountSortOrder(), uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageAccountIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryAccounts-2">queryAccounts</a></b> ( const QMessageAccountFilter &amp; <i>filter</i>, const QList&lt;QMessageAccountSortOrder&gt; &amp; <i>sortOrders</i>, uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageFolderIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryFolders">queryFolders</a></b> ( const QMessageFolderFilter &amp; <i>filter</i> = QMessageFolderFilter(), const QMessageFolderSortOrder &amp; <i>sortOrder</i> = QMessageFolderSortOrder(), uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageFolderIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryFolders-2">queryFolders</a></b> ( const QMessageFolderFilter &amp; <i>filter</i>, const QList&lt;QMessageFolderSortOrder&gt; &amp; <i>sortOrders</i>, uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryMessages">queryMessages</a></b> ( const QMessageFilter &amp; <i>filter</i> = QMessageFilter(), const QMessageSortOrder &amp; <i>sortOrder</i> = QMessageSortOrder(), uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryMessages-2">queryMessages</a></b> ( const QMessageFilter &amp; <i>filter</i>, const QList&lt;QMessageSortOrder&gt; &amp; <i>sortOrders</i>, uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryMessages-3">queryMessages</a></b> ( const QMessageFilter &amp; <i>filter</i>, const QString &amp; <i>body</i>, QMessageDataComparator::MatchFlags <i>matchFlags</i> = 0, const QMessageSortOrder &amp; <i>sortOrder</i> = QMessageSortOrder(), uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMessageIdList </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#queryMessages-4">queryMessages</a></b> ( const QMessageFilter &amp; <i>filter</i>, const QString &amp; <i>body</i>, QMessageDataComparator::MatchFlags <i>matchFlags</i>, const QList&lt;QMessageSortOrder&gt; &amp; <i>sortOrders</i>, uint <i>limit</i> = 0, uint <i>offset</i> = 0 ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> NotificationFilterId </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#registerNotificationFilter">registerNotificationFilter</a></b> ( const QMessageFilter &amp; <i>filter</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#removeAccount">removeAccount</a></b> ( const QMessageAccountId &amp; <i>id</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#removeMessage">removeMessage</a></b> ( const QMessageId &amp; <i>id</i>, RemovalOption <i>option</i> = RemoveOnOriginatingServer )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#removeMessages">removeMessages</a></b> ( const QMessageFilter &amp; <i>filter</i>, RemovalOption <i>option</i> = RemoveOnOriginatingServer )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#unregisterNotificationFilter">unregisterNotificationFilter</a></b> ( NotificationFilterId <i>notificationFilterId</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#updateMessage">updateMessage</a></b> ( QMessage * <i>message</i> )</td></tr>
</table>
<ul>
<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>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#accountRemoved">accountRemoved</a></b> ( const QMessageAccountId &amp; <i>id</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#messageAdded">messageAdded</a></b> ( const QMessageId &amp; <i>id</i>, const QMessageManager::NotificationFilterIdSet &amp; <i>matchingFilterIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#messageRemoved">messageRemoved</a></b> ( const QMessageId &amp; <i>id</i>, const QMessageManager::NotificationFilterIdSet &amp; <i>matchingFilterIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmessagemanager.html#messageUpdated">messageUpdated</a></b> ( const QMessageId &amp; <i>id</i>, const QMessageManager::NotificationFilterIdSet &amp; <i>matchingFilterIds</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">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">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">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>
<!-- $$$QMessageManager-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QMessageManager class represents the main interface for storage and retrieval of messages, folders and accounts in the system message store.</p>
<p>The system contains a single store for messages, which is accessed via the handle class QMessageManager. QMessageManager provides the interface for adding, updating and deleting messages in the system's message store.</p>
<p>QMessageManager provides the <a href="qmessagemanager.html#countFolders">countFolders</a>() and <a href="qmessagemanager.html#queryFolders">queryFolders</a>() functions for counting and listing the folders contained by the messaging store, and the <a href="qmessagemanager.html#countAccounts">countAccounts</a>() and <a href="qmessagemanager.html#queryAccounts">queryAccounts</a>() functions for counting and listing the accounts contained by the store. These functions use the <a href="qmessagefolderfilter.html">QMessageFolderFilter</a> and <a href="qmessagefoldersortorder.html">QMessageFolderSortOrder</a> classes, and the <a href="qmessageaccountfilter.html">QMessageAccountFilter</a> and <a href="qmessageaccountsortorder.html">QMessageAccountSortOrder</a> classes to constrain their searches.</p>
<p>QMessageManager also implements functionality allowing the messages contained by the store to be counted or listed, using various filtering and <a href="location-overview.html#sortorders">sortOrder</a> constraints. Clients can access this functionality via the <a href="qmessageservice.html#countMessages">countMessages</a> and <a href="qmessageservice.html#queryMessages">queryMessages</a> functions of the <a href="qmessageservice.html">QMessageService</a> class.</p>
<p>With the exception of Windows mobile and desktop platforms, QMessageManager functions should not initiate network activity. Instead functions are restricted to operating on data already on the device. See <a href="qmessageservice.html">QMessageService</a> for functions related to initiating network activity.</p>
<p>If a QMessageManager operation fails, the <a href="qmessagemanager.html#error">error</a>() function will return an error code value indicating the failure mode encountered. A successful operation will set the <a href="qmessagemanager.html#error">error</a>() result to <a href="qmessagemanager.html#Error-enum">QMessageManager::NoError</a>.</p>
<p>Messages in the messaging store are identified by <a href="qmessageid.html">QMessageId</a> objects. The data associated with a message is retrieved in the form of a <a href="qmessage.html">QMessage</a> object using <a href="qmessagemanager.html#message">message</a>(). Likewise a folder is retrieved in the form of a <a href="qmessagefolder.html">QMessageFolder</a> object using <a href="qmessagemanager.html#folder">folder</a>(), and an account is retrieved in the form of a <a href="qmessageaccount.html">QMessageAccount</a> object using <a href="qmessagemanager.html#account">account</a>().</p>
<p>Messages can be inserted into the store using the <a href="qmessagemanager.html#addMessage">addMessage</a>() function, messages in the store can be manipulated via the <a href="qmessagemanager.html#updateMessage">updateMessage</a>() function, and removed by the <a href="qmessagemanager.html#removeMessage">removeMessage</a>() functions.</p>
<p>Messaging store manipulations involving messages are reported via the messagesAdded(), messagesUpdated() and messagesRemoved() signals.</p>
</div>
<p><b>See also </b><a href="qmessage.html">QMessage</a>, <a href="qmessageid.html">QMessageId</a>, <a href="qmessagecontentcontainerid.html">QMessageContentContainerId</a>, and <a href="qmessageservice.html">QMessageService</a>.</p>
<!-- @@@QMessageManager -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$Error$$$NoError$$$InvalidId$$$ConstraintFailure$$$ContentInaccessible$$$NotYetImplemented$$$FrameworkFault$$$WorkingMemoryOverflow$$$Busy$$$RequestIncomplete -->
<h3 class="fn"><a name="Error-enum"></a>enum QMessageManager::<span class="name">Error</span></h3>
<p>Defines the result of attempting to perform a messaging store operation.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMessageManager::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The operation was successfully performed.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::InvalidId</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The operation failed due to the specification of an invalid identifier.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::ConstraintFailure</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The operation failed due to a constraint violation.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::ContentInaccessible</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">The operation failed because the content data cannot be accessed by the messaging store.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::NotYetImplemented</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The operation failed because the messaging store does not yet implement the operation.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::FrameworkFault</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">The operation failed because the messaging store encountered an error in performing the operation.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::WorkingMemoryOverflow</tt></td><td class="topAlign"><tt>6</tt></td><td class="topAlign">The operation failed because the messaging store exhausted all memory available for evaluating queries.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::Busy</tt></td><td class="topAlign"><tt>7</tt></td><td class="topAlign">The operation failed because the messaging store is being used by another thread.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::RequestIncomplete</tt></td><td class="topAlign"><tt>8</tt></td><td class="topAlign">The operation failed to report successful completion, although no specific error was reported.</td></tr>
</table>
<!-- @@@Error -->
<!-- $$$NotificationFilterId -->
<h3 class="fn"><a name="NotificationFilterId-typedef"></a>typedef QMessageManager::<span class="name">NotificationFilterId</span></h3>
<p>This type contains a value identifying a registered message filter.</p>
<!-- @@@NotificationFilterId -->
<!-- $$$NotificationFilterIdSet -->
<h3 class="fn"><a name="NotificationFilterIdSet-typedef"></a>typedef QMessageManager::<span class="name">NotificationFilterIdSet</span></h3>
<p>This type contains a set of values identifying registered message filters.</p>
<!-- @@@NotificationFilterIdSet -->
<!-- $$$RemovalOption$$$RemoveLocalCopyOnly$$$RemoveOnOriginatingServer -->
<h3 class="fn"><a name="RemovalOption-enum"></a>enum QMessageManager::<span class="name">RemovalOption</span></h3>
<p>Defines whether or not a message will be removed from the originating server.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMessageManager::RemoveLocalCopyOnly</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Do not remove the message from the originating server.</td></tr>
<tr><td class="topAlign"><tt>QMessageManager::RemoveOnOriginatingServer</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">Remove the message both from the local store and from the originating server if any.</td></tr>
</table>
<!-- @@@RemovalOption -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QMessageManager[overload1]$$$QMessageManagerQObject* -->
<h3 class="fn"><a name="QMessageManager"></a>QMessageManager::<span class="name">QMessageManager</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 handle to the message store.</p>
<p>If <i>parent</i> is not 0 then the handle will be deleted when <i>parent</i> is deleted.</p>
<!-- @@@QMessageManager -->
<!-- $$$~QMessageManager[overload1]$$$~QMessageManager -->
<h3 class="fn"><a name="dtor.QMessageManager"></a>QMessageManager::<span class="name">~QMessageManager</span> ()</h3>
<p>Destroys the handle to the message store.</p>
<!-- @@@~QMessageManager -->
<!-- $$$account[overload1]$$$accountconstQMessageAccountId& -->
<h3 class="fn"><a name="account"></a><span class="type"><a href="qmessageaccount.html">QMessageAccount</a></span> QMessageManager::<span class="name">account</span> ( const <span class="type"><a href="qmessageaccountid.html">QMessageAccountId</a></span> &amp; <i>id</i> ) const</h3>
<p>Returns the <a href="qmessageaccount.html">QMessageAccount</a> identified by <i>id</i> from the store.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@account -->
<!-- $$$accountRemoved[overload1]$$$accountRemovedconstQMessageAccountId& -->
<h3 class="fn"><a name="accountRemoved"></a><span class="type">void</span> QMessageManager::<span class="name">accountRemoved</span> ( const <span class="type"><a href="qmessageaccountid.html">QMessageAccountId</a></span> &amp; <i>id</i> )<tt> [signal]</tt></h3>
<!-- @@@accountRemoved -->
<!-- $$$addMessage[overload1]$$$addMessageQMessage* -->
<h3 class="fn"><a name="addMessage"></a><span class="type">bool</span> QMessageManager::<span class="name">addMessage</span> ( <span class="type"><a href="qmessage.html">QMessage</a></span> * <i>message</i> )</h3>
<p>Adds a copy of the message indicated by <i>message</i> to the messaging store and modifies the message indicated by <i>message</i> to contain the identifier of the created message.</p>
<p>Returns <tt>true</tt> if the operation successfully updates the store; otherwise returns <tt>false</tt>.</p>
<p>To ensure the change is propagated to any affected external server <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>() should be subsequently called.</p>
<p>On the Maemo 5 (Fremantle) platform for SMS type messages this function is not yet supported.</p>
<p>Using this function to explicitly set a size or date is not currently supported on some platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#message">message</a>(), <a href="qmessagemanager.html#updateMessage">updateMessage</a>(), <a href="qmessagemanager.html#removeMessage">removeMessage</a>(), and <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>().</p>
<!-- @@@addMessage -->
<!-- $$$countAccounts[overload1]$$$countAccountsconstQMessageAccountFilter& -->
<h3 class="fn"><a name="countAccounts"></a><span class="type">int</span> QMessageManager::<span class="name">countAccounts</span> ( const <span class="type"><a href="qmessageaccountfilter.html">QMessageAccountFilter</a></span> &amp; <i>filter</i> = QMessageAccountFilter() ) const</h3>
<p>Returns the number of messages which match the filtering criteria defined in <a href="qmessageaccountfilter.html">QMessageAccountFilter</a> <i>filter</i>. If <i>filter</i> is empty the count of all available accounts is returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#queryAccounts">queryAccounts</a>().</p>
<!-- @@@countAccounts -->
<!-- $$$countFolders[overload1]$$$countFoldersconstQMessageFolderFilter& -->
<h3 class="fn"><a name="countFolders"></a><span class="type">int</span> QMessageManager::<span class="name">countFolders</span> ( const <span class="type"><a href="qmessagefolderfilter.html">QMessageFolderFilter</a></span> &amp; <i>filter</i> = QMessageFolderFilter() ) const</h3>
<p>Returns the number of folders which match the filtering criteria defined in <a href="qmessagefolderfilter.html">QMessageFolderFilter</a> <i>filter</i>. If <i>filter</i> is empty the count of all available folders is returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#queryFolders">queryFolders</a>().</p>
<!-- @@@countFolders -->
<!-- $$$countMessages[overload1]$$$countMessagesconstQMessageFilter& -->
<h3 class="fn"><a name="countMessages"></a><span class="type">int</span> QMessageManager::<span class="name">countMessages</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i> = QMessageFilter() ) const</h3>
<p>Returns the number of messages which match the filtering criteria defined in <a href="qmessagefilter.html">QMessageFilter</a> <i>filter</i>. If <i>filter</i> is empty the count of all available messages is returned.</p>
<p>The performance of counting messages is currently significantly less than optimal for some filters on some platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#queryMessages">queryMessages</a>().</p>
<!-- @@@countMessages -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qmessagemanager.html#Error-enum">QMessageManager::Error</a></span> QMessageManager::<span class="name">error</span> () const</h3>
<p>Returns the code of the last error condition reported by the messaging store.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@error -->
<!-- $$$folder[overload1]$$$folderconstQMessageFolderId& -->
<h3 class="fn"><a name="folder"></a><span class="type"><a href="qmessagefolder.html">QMessageFolder</a></span> QMessageManager::<span class="name">folder</span> ( const <span class="type"><a href="qmessagefolderid.html">QMessageFolderId</a></span> &amp; <i>id</i> ) const</h3>
<p>Returns the <a href="qmessagefolder.html">QMessageFolder</a> identified by <i>id</i> from the store.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@folder -->
<!-- $$$message[overload1]$$$messageconstQMessageId& -->
<h3 class="fn"><a name="message"></a><span class="type"><a href="qmessage.html">QMessage</a></span> QMessageManager::<span class="name">message</span> ( const <span class="type"><a href="qmessageid.html">QMessageId</a></span> &amp; <i>id</i> ) const</h3>
<p>Returns the <a href="qmessage.html">QMessage</a> identified by <i>id</i> from the store.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<!-- @@@message -->
<!-- $$$messageAdded[overload1]$$$messageAddedconstQMessageId&constQMessageManager::NotificationFilterIdSet& -->
<h3 class="fn"><a name="messageAdded"></a><span class="type">void</span> QMessageManager::<span class="name">messageAdded</span> ( const <span class="type"><a href="qmessageid.html">QMessageId</a></span> &amp; <i>id</i>, const <span class="type"><a href="qmessagemanager.html#NotificationFilterIdSet-typedef">QMessageManager::NotificationFilterIdSet</a></span> &amp; <i>matchingFilterIds</i> )<tt> [signal]</tt></h3>
<p>Signal that is emitted when the message identified by <i>id</i> is added to the message store. <i>matchingFilterIds</i> contains a set of values identifiying registered notification filters that matched the message.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#messageRemoved">messageRemoved</a>(), <a href="qmessagemanager.html#messageUpdated">messageUpdated</a>(), and <a href="qmessagemanager.html#registerNotificationFilter">registerNotificationFilter</a>().</p>
<!-- @@@messageAdded -->
<!-- $$$messageRemoved[overload1]$$$messageRemovedconstQMessageId&constQMessageManager::NotificationFilterIdSet& -->
<h3 class="fn"><a name="messageRemoved"></a><span class="type">void</span> QMessageManager::<span class="name">messageRemoved</span> ( const <span class="type"><a href="qmessageid.html">QMessageId</a></span> &amp; <i>id</i>, const <span class="type"><a href="qmessagemanager.html#NotificationFilterIdSet-typedef">QMessageManager::NotificationFilterIdSet</a></span> &amp; <i>matchingFilterIds</i> )<tt> [signal]</tt></h3>
<p>Signal that is emitted when the message identified by <i>id</i> is removed from the message store. <i>matchingFilterIds</i> contains a set of values identifiying registered notification filters that matched the message.</p>
<p>Since the filters apply to the state of the data after the message removal, the only data item that may be subject to filtration is the identifier of the removed message.</p>
<p>On Symbian^3 platform to get signals about removed emails the related mailbox must be manually synchronized.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#messageAdded">messageAdded</a>(), <a href="qmessagemanager.html#messageUpdated">messageUpdated</a>(), and <a href="qmessagemanager.html#registerNotificationFilter">registerNotificationFilter</a>().</p>
<!-- @@@messageRemoved -->
<!-- $$$messageUpdated[overload1]$$$messageUpdatedconstQMessageId&constQMessageManager::NotificationFilterIdSet& -->
<h3 class="fn"><a name="messageUpdated"></a><span class="type">void</span> QMessageManager::<span class="name">messageUpdated</span> ( const <span class="type"><a href="qmessageid.html">QMessageId</a></span> &amp; <i>id</i>, const <span class="type"><a href="qmessagemanager.html#NotificationFilterIdSet-typedef">QMessageManager::NotificationFilterIdSet</a></span> &amp; <i>matchingFilterIds</i> )<tt> [signal]</tt></h3>
<p>Signal that is emitted when the message identified by <i>id</i> is updated in the message store. <i>matchingFilterIds</i> contains a set of values identifiying registered notification filters that matched the message.</p>
<p>Since the filters apply to the state of the data after the message modification, updates to messages which matched a given filter prior to modification but not afterwards will not result in the emission of the messageUpdated signal.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#messageAdded">messageAdded</a>(), <a href="qmessagemanager.html#messageRemoved">messageRemoved</a>(), and <a href="qmessagemanager.html#registerNotificationFilter">registerNotificationFilter</a>().</p>
<!-- @@@messageUpdated -->
<!-- $$$queryAccounts[overload1]$$$queryAccountsconstQMessageAccountFilter&constQMessageAccountSortOrder&uintuint -->
<h3 class="fn"><a name="queryAccounts"></a><span class="type">QMessageAccountIdList</span> QMessageManager::<span class="name">queryAccounts</span> ( const <span class="type"><a href="qmessageaccountfilter.html">QMessageAccountFilter</a></span> &amp; <i>filter</i> = QMessageAccountFilter(), const <span class="type"><a href="qmessageaccountsortorder.html">QMessageAccountSortOrder</a></span> &amp; <i>sortOrder</i> = QMessageAccountSortOrder(), <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessageaccountid.html">QMessageAccountId</a>s of accounts in the messaging store. If <i>filter</i> is not empty only accounts matching the parameters set by <i>filter</i> will be returned, otherwise identifiers for all accounts will be returned. If <i>sortOrder</i> is not empty, then the identifiers will be sorted by the parameters set by <i>sortOrder</i>. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countAccounts">countAccounts</a>().</p>
<!-- @@@queryAccounts -->
<!-- $$$queryAccounts$$$queryAccountsconstQMessageAccountFilter&constQList<QMessageAccountSortOrder>&uintuint -->
<h3 class="fn"><a name="queryAccounts-2"></a><span class="type">QMessageAccountIdList</span> QMessageManager::<span class="name">queryAccounts</span> ( const <span class="type"><a href="qmessageaccountfilter.html">QMessageAccountFilter</a></span> &amp; <i>filter</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qmessageaccountsortorder.html">QMessageAccountSortOrder</a></span>&gt; &amp; <i>sortOrders</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessageaccountid.html">QMessageAccountId</a>s of accounts in the messaging store. If <i>filter</i> is not empty only accounts matching the parameters set by <i>filter</i> will be returned, otherwise identifiers for all accounts will be returned. If <i>sortOrders</i> is not empty, then the identifiers will be sorted by applying each sort order element in sequence. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countAccounts">countAccounts</a>().</p>
<!-- @@@queryAccounts -->
<!-- $$$queryFolders[overload1]$$$queryFoldersconstQMessageFolderFilter&constQMessageFolderSortOrder&uintuint -->
<h3 class="fn"><a name="queryFolders"></a><span class="type">QMessageFolderIdList</span> QMessageManager::<span class="name">queryFolders</span> ( const <span class="type"><a href="qmessagefolderfilter.html">QMessageFolderFilter</a></span> &amp; <i>filter</i> = QMessageFolderFilter(), const <span class="type"><a href="qmessagefoldersortorder.html">QMessageFolderSortOrder</a></span> &amp; <i>sortOrder</i> = QMessageFolderSortOrder(), <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessagefolderid.html">QMessageFolderId</a>s of folders in the messaging store. If <i>filter</i> is not empty only folders matching the parameters set by <i>filter</i> will be returned, otherwise identifiers for all folders will be returned. If <i>sortOrder</i> is not empty, then the identifiers will be sorted by the parameters set by <i>sortOrder</i>. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countFolders">countFolders</a>().</p>
<!-- @@@queryFolders -->
<!-- $$$queryFolders$$$queryFoldersconstQMessageFolderFilter&constQList<QMessageFolderSortOrder>&uintuint -->
<h3 class="fn"><a name="queryFolders-2"></a><span class="type">QMessageFolderIdList</span> QMessageManager::<span class="name">queryFolders</span> ( const <span class="type"><a href="qmessagefolderfilter.html">QMessageFolderFilter</a></span> &amp; <i>filter</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qmessagefoldersortorder.html">QMessageFolderSortOrder</a></span>&gt; &amp; <i>sortOrders</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessagefolderid.html">QMessageFolderId</a>s of folders in the messaging store. If <i>filter</i> is not empty only folders matching the parameters set by <i>filter</i> will be returned, otherwise identifiers for all folders will be returned. If <i>sortOrders</i> is not empty, then the identifiers will be sorted by applying each sort order element in sequence. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countFolders">countFolders</a>().</p>
<!-- @@@queryFolders -->
<!-- $$$queryMessages[overload1]$$$queryMessagesconstQMessageFilter&constQMessageSortOrder&uintuint -->
<h3 class="fn"><a name="queryMessages"></a><span class="type">QMessageIdList</span> QMessageManager::<span class="name">queryMessages</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i> = QMessageFilter(), const <span class="type"><a href="qmessagesortorder.html">QMessageSortOrder</a></span> &amp; <i>sortOrder</i> = QMessageSortOrder(), <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessageid.html">QMessageId</a>s of messages in the messaging store. If <i>filter</i> is not empty only messages matching the parameters set by <i>filter</i> will be returned, otherwise identifiers for all messages will be returned. If <i>sortOrder</i> is not empty, then the identifiers will be sorted by the parameters set by <i>sortOrder</i>. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned.</p>
<p>The performance of querying messages is currently significantly less than optimal for some querying criteria on some platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countMessages">countMessages</a>().</p>
<!-- @@@queryMessages -->
<!-- $$$queryMessages$$$queryMessagesconstQMessageFilter&constQList<QMessageSortOrder>&uintuint -->
<h3 class="fn"><a name="queryMessages-2"></a><span class="type">QMessageIdList</span> QMessageManager::<span class="name">queryMessages</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qmessagesortorder.html">QMessageSortOrder</a></span>&gt; &amp; <i>sortOrders</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessageid.html">QMessageId</a>s of messages in the messaging store. If <i>filter</i> is not empty only messages matching the parameters set by <i>filter</i> will be returned, otherwise identifiers for all messages will be returned. If <i>sortOrders</i> is not empty, then the identifiers will be sorted by applying each sort order element in sequence. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned.</p>
<p>The performance of querying messages is currently significantly less than optimal for some querying criteria on some platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countMessages">countMessages</a>().</p>
<!-- @@@queryMessages -->
<!-- $$$queryMessages$$$queryMessagesconstQMessageFilter&constQString&QMessageDataComparator::MatchFlagsconstQMessageSortOrder&uintuint -->
<h3 class="fn"><a name="queryMessages-3"></a><span class="type">QMessageIdList</span> QMessageManager::<span class="name">queryMessages</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>body</i>, <span class="type"><a href="qmessagedatacomparator.html#MatchFlag-enum">QMessageDataComparator::MatchFlags</a></span> <i>matchFlags</i> = 0, const <span class="type"><a href="qmessagesortorder.html">QMessageSortOrder</a></span> &amp; <i>sortOrder</i> = QMessageSortOrder(), <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessageid.html">QMessageId</a>s of messages in the messaging store. If <i>filter</i> is not empty only messages matching the parameters set by <i>filter</i> and with a body containing the string <i>body</i> will be returned, otherwise identifiers for all messages with a body containing <i>body</i> will be returned. If <i>sortOrder</i> is not empty, then the identifiers will be sorted by the parameters set by <i>sortOrder</i>. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned. <i>matchFlags</i> specifies the matching method to use.</p>
<p>The performance of querying messages is currently significantly less than optimal for some querying criteria on some platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countMessages">countMessages</a>().</p>
<!-- @@@queryMessages -->
<!-- $$$queryMessages$$$queryMessagesconstQMessageFilter&constQString&QMessageDataComparator::MatchFlagsconstQList<QMessageSortOrder>&uintuint -->
<h3 class="fn"><a name="queryMessages-4"></a><span class="type">QMessageIdList</span> QMessageManager::<span class="name">queryMessages</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> &amp; <i>body</i>, <span class="type"><a href="qmessagedatacomparator.html#MatchFlag-enum">QMessageDataComparator::MatchFlags</a></span> <i>matchFlags</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span>&lt;<span class="type"><a href="qmessagesortorder.html">QMessageSortOrder</a></span>&gt; &amp; <i>sortOrders</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>limit</i> = 0, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qtglobal.html#uint-typedef">uint</a></span> <i>offset</i> = 0 ) const</h3>
<p>Returns the <a href="qmessageid.html">QMessageId</a>s of messages in the messaging store. If <i>filter</i> is not empty only messages matching the parameters set by <i>filter</i> and with a body containing the string <i>body</i> will be returned, otherwise identifiers for all messages with a body containing <i>body</i> will be returned. If <i>sortOrders</i> is not empty, then the identifiers will be sorted by applying each sort order element in sequence. If <i>limit</i> is not zero, then <i>limit</i> places an upper bound on the number of ids in the list returned. <i>offset</i> specifies how many ids to skip at the beginning of the list returned. <i>matchFlags</i> specifies the matching method to use.</p>
<p>The performance of querying messages is currently significantly less than optimal for some querying criteria on some platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#error">error</a>() and <a href="qmessagemanager.html#countMessages">countMessages</a>().</p>
<!-- @@@queryMessages -->
<!-- $$$registerNotificationFilter[overload1]$$$registerNotificationFilterconstQMessageFilter& -->
<h3 class="fn"><a name="registerNotificationFilter"></a><span class="type"><a href="qmessagemanager.html#NotificationFilterId-typedef">NotificationFilterId</a></span> QMessageManager::<span class="name">registerNotificationFilter</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i> )</h3>
<p>Registers a message filter that will be used to generate <a href="qmessagemanager.html#messageAdded">messageAdded</a>(), <a href="qmessagemanager.html#messageRemoved">messageRemoved</a>() and <a href="qmessagemanager.html#messageUpdated">messageUpdated</a>() signals. Returns an identifier value that can be used to identify the reason that a signal was emitted, and to unregister the filter at a later time.</p>
<p>The <i>filter</i> is applied to the state of the data after the occurrence of the event for which a notification may be emitted.</p>
<p>On Linux and Meego.com it is only possible to filter <a href="qmessagemanager.html#messageRemoved">messageRemoved</a>() signals with an empty QMessageFilter() that matches all messages.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#unregisterNotificationFilter">unregisterNotificationFilter</a>(), <a href="qmessagemanager.html#messageAdded">messageAdded</a>(), <a href="qmessagemanager.html#messageRemoved">messageRemoved</a>(), and <a href="qmessagemanager.html#messageUpdated">messageUpdated</a>().</p>
<!-- @@@registerNotificationFilter -->
<!-- $$$removeAccount[overload1]$$$removeAccountconstQMessageAccountId& -->
<h3 class="fn"><a name="removeAccount"></a><span class="type">bool</span> QMessageManager::<span class="name">removeAccount</span> ( const <span class="type"><a href="qmessageaccountid.html">QMessageAccountId</a></span> &amp; <i>id</i> )</h3>
<p>Remove account <i>id</i> and all associated information (folders, messages etc.)</p>
<p>On Windows mobile and desktop platforms, Maemo 5, and Symbian prior to SR1.11 this function performs no operation.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@removeAccount -->
<!-- $$$removeMessage[overload1]$$$removeMessageconstQMessageId&RemovalOption -->
<h3 class="fn"><a name="removeMessage"></a><span class="type">bool</span> QMessageManager::<span class="name">removeMessage</span> ( const <span class="type"><a href="qmessageid.html">QMessageId</a></span> &amp; <i>id</i>, <span class="type"><a href="qmessagemanager.html#RemovalOption-enum">RemovalOption</a></span> <i>option</i> = RemoveOnOriginatingServer )</h3>
<p>Removes the message with <a href="qmessageid.html">QMessageId</a> <i>id</i> from the messaging store. If <i>option</i> is <a href="qmessagemanager.html#RemovalOption-enum">QMessageManager::RemoveOnOriginatingServer</a> then when synchronization is performed the message should be removed from both the local message store and the originating server if any.</p>
<p>Returns <tt>true</tt> if the operation successfully updates the store; otherwise returns <tt>false</tt>.</p>
<p>To ensure the change is propagated to any affected external server <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>() should be subsequently called.</p>
<p><i>option</i> is ignored on Windows mobile and desktop platforms.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#removeMessages">removeMessages</a>(), <a href="qmessagemanager.html#addMessage">addMessage</a>(), <a href="qmessagemanager.html#updateMessage">updateMessage</a>(), and <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>().</p>
<!-- @@@removeMessage -->
<!-- $$$removeMessages[overload1]$$$removeMessagesconstQMessageFilter&RemovalOption -->
<h3 class="fn"><a name="removeMessages"></a><span class="type">bool</span> QMessageManager::<span class="name">removeMessages</span> ( const <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> &amp; <i>filter</i>, <span class="type"><a href="qmessagemanager.html#RemovalOption-enum">RemovalOption</a></span> <i>option</i> = RemoveOnOriginatingServer )</h3>
<p>Removes all messages identified by the filter <i>filter</i> from the messaging store. If <i>option</i> is <a href="qmessagemanager.html#RemovalOption-enum">QMessageManager::RemoveOnOriginatingServer</a> then when synchronization is performed the messages should be removed from both the local message store and the originating server if any.</p>
<p>Returns <tt>true</tt> if the operation successfully updates the store; otherwise returns <tt>false</tt>.</p>
<p>To ensure the change is propagated to any affected external server <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>() should be subsequently called.</p>
<p><i>option</i> is ignored on Windows mobile and desktop platforms.</p>
<p>For example:</p>
<p>To implement a function to remove a list messages identified by QMessageIds from the messaging store.</p>
<pre class="cpp"> <span class="type">bool</span> removeMessages(<span class="keyword">const</span> <span class="type">QMessageIdList</span><span class="operator">&amp;</span> ids)
 {
     <span class="type"><a href="qmessagefilter.html">QMessageFilter</a></span> idsFilter(ids);
     <span class="keyword">return</span> <span class="type"><a href="qmessagemanager.html">QMessageManager</a></span>()<span class="operator">.</span>removeMessages(idsFilter);
 }</pre>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#removeMessage">removeMessage</a>(), <a href="qmessagemanager.html#addMessage">addMessage</a>(), <a href="qmessagemanager.html#updateMessage">updateMessage</a>(), and <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>().</p>
<!-- @@@removeMessages -->
<!-- $$$unregisterNotificationFilter[overload1]$$$unregisterNotificationFilterNotificationFilterId -->
<h3 class="fn"><a name="unregisterNotificationFilter"></a><span class="type">void</span> QMessageManager::<span class="name">unregisterNotificationFilter</span> ( <span class="type"><a href="qmessagemanager.html#NotificationFilterId-typedef">NotificationFilterId</a></span> <i>notificationFilterId</i> )</h3>
<p>Removes the message filter associated with <i>notificationFilterId</i> from the set used to generate message event signals.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#registerNotificationFilter">registerNotificationFilter</a>(), <a href="qmessagemanager.html#messageAdded">messageAdded</a>(), <a href="qmessagemanager.html#messageRemoved">messageRemoved</a>(), and <a href="qmessagemanager.html#messageUpdated">messageUpdated</a>().</p>
<!-- @@@unregisterNotificationFilter -->
<!-- $$$updateMessage[overload1]$$$updateMessageQMessage* -->
<h3 class="fn"><a name="updateMessage"></a><span class="type">bool</span> QMessageManager::<span class="name">updateMessage</span> ( <span class="type"><a href="qmessage.html">QMessage</a></span> * <i>message</i> )</h3>
<p>Updates the messaging store so that the message whose identifier is contained by the message at <i>message</i> contains the content at <i>message</i>. If <i>message</i> does not contain a valid identifier, no changes will result. Internal data of the <a href="qmessage.html">QMessage</a> object at <i>message</i> can be modified by this operation.</p>
<p>Returns <tt>true</tt> if the operation successfully updates the store; otherwise returns <tt>false</tt>.</p>
<p>To ensure the change is propagated to any affected external server <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>() should be subsequently called.</p>
<p>Using this function to explicitly set a size or date is not currently supported on some platforms.</p>
<p>On the Maemo 5 (Fremantle) platform this function may only be used to update the priority and status of email type messages.</p>
<p>This function was introduced in Qt Mobility 1.0.</p>
<p><b>See also </b><a href="qmessagemanager.html#addMessage">addMessage</a>(), <a href="qmessagemanager.html#removeMessage">removeMessage</a>(), and <a href="qmessageservice.html#exportUpdates">QMessageService::exportUpdates</a>().</p>
<!-- @@@updateMessage -->
</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