<?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" />
<!-- qorganizermanager.cpp -->
<title>Qt Mobility 1.2: QOrganizerManager 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="qtorganizer.html">QtOrganizer</a></li>
<li>QOrganizerManager</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="#static-public-members">Static Public Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QOrganizerManager Class Reference</h1>
<!-- $$$QOrganizerManager-brief -->
<p>The QOrganizerManager class provides an interface which allows clients with access to organizer item information stored in a particular backend. <a href="#details">More...</a></p>
<!-- @@@QOrganizerManager -->
<pre class="cpp"> <span class="preprocessor">#include <QOrganizerManager></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.1.</p>
<ul>
<li><a href="qorganizermanager-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="qorganizermanager.html#Error-enum">Error</a></b> { NoError, DoesNotExistError, AlreadyExistsError, InvalidDetailError, ..., TimeoutError }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#ManagerFeature-enum">ManagerFeature</a></b> { MutableDefinitions, ChangeLogs, Anonymous }</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="qorganizermanager.html#QOrganizerManager">QOrganizerManager</a></b> ( const QString & <i>managerName</i> = QString(), const QMap<QString, QString> & <i>parameters</i> = 0, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#QOrganizerManager-2">QOrganizerManager</a></b> ( const QString & <i>managerName</i>, int <i>implementationVersion</i>, const QMap<QString, QString> & <i>parameters</i> = 0, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#QOrganizerManager-3">QOrganizerManager</a></b> ( QObject * <i>parent</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#dtor.QOrganizerManager">~QOrganizerManager</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerCollection </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#collection">collection</a></b> ( const QOrganizerCollectionId & <i>collectionId</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerCollection> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#collections">collections</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerCollection </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#compatibleCollection">compatibleCollection</a></b> ( const QOrganizerCollection & <i>original</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerItem </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#compatibleItem">compatibleItem</a></b> ( const QOrganizerItem & <i>original</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerCollection </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#defaultCollection">defaultCollection</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerItemDetailDefinition </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#detailDefinition">detailDefinition</a></b> ( const QString & <i>definitionName</i>, const QString & <i>organizeritemType</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<QString, QOrganizerItemDetailDefinition> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#detailDefinitions">detailDefinitions</a></b> ( const QString & <i>organizeritemType</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerManager::Error </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#error">error</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<int, QOrganizerManager::Error> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#errorMap">errorMap</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#hasFeature">hasFeature</a></b> ( QOrganizerManager::ManagerFeature <i>feature</i>, const QString & <i>organizeritemType</i> = QOrganizerItemType::TypeEvent ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#isFilterSupported">isFilterSupported</a></b> ( const QOrganizerItemFilter & <i>filter</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerItem </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#item">item</a></b> ( const QOrganizerItemId & <i>itemId</i>, const QOrganizerItemFetchHint & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItemId> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemIds">itemIds</a></b> ( const QOrganizerItemFilter & <i>filter</i> = QOrganizerItemFilter(), const QList<QOrganizerItemSortOrder> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> () ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItemId> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemIds-2">itemIds</a></b> ( const QDateTime & <i>startDate</i>, const QDateTime & <i>endDate</i>, const QOrganizerItemFilter & <i>filter</i> = QOrganizerItemFilter(), const QList<QOrganizerItemSortOrder> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> () ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItem> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemOccurrences">itemOccurrences</a></b> ( const QOrganizerItem & <i>parentItem</i>, const QDateTime & <i>periodStart</i> = QDateTime(), const QDateTime & <i>periodEnd</i> = QDateTime(), int <i>maxCount</i> = -1, const QOrganizerItemFetchHint & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItem> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#items">items</a></b> ( const QOrganizerItemFilter & <i>filter</i> = QOrganizerItemFilter(), const QList<QOrganizerItemSortOrder> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> (), const QOrganizerItemFetchHint & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItem> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#items-2">items</a></b> ( const QDateTime & <i>startDate</i>, const QDateTime & <i>endDate</i>, const QOrganizerItemFilter & <i>filter</i> = QOrganizerItemFilter(), const QList<QOrganizerItemSortOrder> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> (), const QOrganizerItemFetchHint & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItem> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#items-3">items</a></b> ( const QDateTime & <i>startDate</i>, const QDateTime & <i>endDate</i>, int <i>maxCount</i>, const QOrganizerItemFilter & <i>filter</i> = QOrganizerItemFilter(), const QOrganizerItemFetchHint & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItem> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemsForExport">itemsForExport</a></b> ( const QDateTime & <i>startDate</i> = QDateTime(), const QDateTime & <i>endDate</i> = QDateTime(), const QOrganizerItemFilter & <i>filter</i> = QOrganizerItemFilter(), const QList<QOrganizerItemSortOrder> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> (), const QOrganizerItemFetchHint & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#managerName">managerName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<QString, QString> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#managerParameters">managerParameters</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#managerUri">managerUri</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#managerVersion">managerVersion</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#removeCollection">removeCollection</a></b> ( const QOrganizerCollectionId & <i>collectionId</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#removeDetailDefinition">removeDetailDefinition</a></b> ( const QString & <i>definitionName</i>, const QString & <i>organizeritemType</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#removeItem">removeItem</a></b> ( const QOrganizerItemId & <i>itemId</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#removeItems">removeItems</a></b> ( const QList<QOrganizerItemId> & <i>organizeritemIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#saveCollection">saveCollection</a></b> ( QOrganizerCollection * <i>collection</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#saveDetailDefinition">saveDetailDefinition</a></b> ( const QOrganizerItemDetailDefinition & <i>def</i>, const QString & <i>organizeritemType</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#saveItem">saveItem</a></b> ( QOrganizerItem * <i>item</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#saveItems">saveItems</a></b> ( QList<QOrganizerItem> * <i>items</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#saveItems-2">saveItems</a></b> ( QList<QOrganizerItem> * <i>items</i>, const QStringList & <i>definitionMask</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#supportedItemTypes">supportedItemTypes</a></b> () const</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="qorganizermanager.html#collectionsAdded">collectionsAdded</a></b> ( const QList<QOrganizerCollectionId> & <i>collectionIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#collectionsChanged">collectionsChanged</a></b> ( const QList<QOrganizerCollectionId> & <i>collectionIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#collectionsRemoved">collectionsRemoved</a></b> ( const QList<QOrganizerCollectionId> & <i>collectionIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#dataChanged">dataChanged</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemsAdded">itemsAdded</a></b> ( const QList<QOrganizerItemId> & <i>itemIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemsChanged">itemsChanged</a></b> ( const QList<QOrganizerItemId> & <i>itemIds</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#itemsRemoved">itemsRemoved</a></b> ( const QList<QOrganizerItemId> & <i>itemIds</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>
<a name="static-public-members"></a>
<h2>Static Public Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#availableManagers">availableManagers</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#buildUri">buildUri</a></b> ( const QString & <i>managerName</i>, const QMap<QString, QString> & <i>params</i>, int <i>implementationVersion</i> = -1 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItemId> </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#extractIds">extractIds</a></b> ( const QList<QOrganizerItem> & <i>items</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerManager * </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#fromUri">fromUri</a></b> ( const QString & <i>storeUri</i>, QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizermanager.html#parseUri">parseUri</a></b> ( const QString & <i>uri</i>, QString * <i>pManagerId</i>, QMap<QString, QString> * <i>pParams</i> )</td></tr>
</table>
<ul>
<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>
</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">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>
<!-- $$$QOrganizerManager-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QOrganizerManager class provides an interface which allows clients with access to organizer item information stored in a particular backend.</p>
<p>This class provides an abstraction of a datastore or aggregation of datastores which contains organizer item information. It provides methods to retrieve and manipulate organizer item information, collection information and supported schema definitions. It also provides metadata and error information reporting.</p>
<p>The functions provided by QOrganizerManager are purely synchronous; to access the same functionality in an asynchronous manner, clients should use the use-case-specific classes derived from <a href="qorganizerabstractrequest.html">QOrganizerAbstractRequest</a>.</p>
<p>Some functionality provided by QOrganizerManager directly is not accessible using the asynchronous API; see the <a href="organizersync.html">synchronous</a> and <a href="organizerasync.html">asynchronous</a> API information from the <a href="organizer.html">organizer module</a> API documentation.</p>
</div>
<!-- @@@QOrganizerManager -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$Error$$$NoError$$$DoesNotExistError$$$AlreadyExistsError$$$InvalidDetailError$$$LockedError$$$DetailAccessError$$$PermissionsError$$$OutOfMemoryError$$$NotSupportedError$$$BadArgumentError$$$UnspecifiedError$$$VersionMismatchError$$$LimitReachedError$$$InvalidItemTypeError$$$InvalidCollectionError$$$InvalidOccurrenceError$$$TimeoutError -->
<h3 class="fn"><a name="Error-enum"></a>enum QOrganizerManager::<span class="name">Error</span></h3>
<p>This enum specifies an error that occurred during the most recent 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>QOrganizerManager::NoError</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The most recent operation was successful</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::DoesNotExistError</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The most recent operation failed because the requested organizer item or detail definition does not exist</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::AlreadyExistsError</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The most recent operation failed because the specified organizer item or detail definition already exists</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::InvalidDetailError</tt></td><td class="topAlign"><tt>3</tt></td><td class="topAlign">The most recent operation failed because the specified organizer detail definition already exists</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::LockedError</tt></td><td class="topAlign"><tt>4</tt></td><td class="topAlign">The most recent operation failed because the datastore specified is currently locked</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::DetailAccessError</tt></td><td class="topAlign"><tt>5</tt></td><td class="topAlign">The most recent operation failed because a detail was modified or removed and its access method does not allow that</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::PermissionsError</tt></td><td class="topAlign"><tt>6</tt></td><td class="topAlign">The most recent operation failed because the caller does not have permission to perform the operation</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::OutOfMemoryError</tt></td><td class="topAlign"><tt>7</tt></td><td class="topAlign">The most recent operation failed due to running out of memory</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::NotSupportedError</tt></td><td class="topAlign"><tt>8</tt></td><td class="topAlign">The most recent operation failed because the requested operation is not supported in the specified store</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::BadArgumentError</tt></td><td class="topAlign"><tt>9</tt></td><td class="topAlign">The most recent operation failed because one or more of the parameters to the operation were invalid</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::UnspecifiedError</tt></td><td class="topAlign"><tt>10</tt></td><td class="topAlign">The most recent operation failed for an undocumented reason</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::VersionMismatchError</tt></td><td class="topAlign"><tt>11</tt></td><td class="topAlign">The most recent operation failed because the backend of the manager is not of the required version</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::LimitReachedError</tt></td><td class="topAlign"><tt>12</tt></td><td class="topAlign">The most recent operation failed because the limit for that type of object has been reached</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::InvalidItemTypeError</tt></td><td class="topAlign"><tt>13</tt></td><td class="topAlign">The most recent operation failed because the item given was of an invalid type for the operation</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::InvalidCollectionError</tt></td><td class="topAlign"><tt>14</tt></td><td class="topAlign">The most recent operation failed because the collection is invalid</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::InvalidOccurrenceError</tt></td><td class="topAlign"><tt>15</tt></td><td class="topAlign">The most recent operation failed because it was an attempt to save an occurrence without a correct InstanceOrigin detail</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::TimeoutError</tt></td><td class="topAlign"><tt>16</tt></td><td class="topAlign">The most recent operation failed because it took longer than expected. It may be possible to try again.</td></tr>
</table>
<!-- @@@Error -->
<!-- $$$ManagerFeature$$$MutableDefinitions$$$Anonymous$$$ChangeLogs -->
<h3 class="fn"><a name="ManagerFeature-enum"></a>enum QOrganizerManager::<span class="name">ManagerFeature</span></h3>
<p>This enum describes the possible features that a particular manager may support</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>QOrganizerManager::MutableDefinitions</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The manager supports saving, updating or removing detail definitions. Some built-in definitions may still be immutable</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::ChangeLogs</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The manager supports reporting of timestamps of changes, and filtering and sorting by those timestamps</td></tr>
<tr><td class="topAlign"><tt>QOrganizerManager::Anonymous</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The manager is isolated from other managers</td></tr>
</table>
<p>This enum was introduced or modified in Qt Mobility 1.1.</p>
<!-- @@@ManagerFeature -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QOrganizerManager[overload1]$$$QOrganizerManagerconstQString&constQMap<QString,QString>&QObject* -->
<h3 class="fn"><a name="QOrganizerManager"></a>QOrganizerManager::<span class="name">QOrganizerManager</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>managerName</i> = QString(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> & <i>parameters</i> = 0, <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 <a href="qorganizermanager.html">QOrganizerManager</a> whose implementation is identified by <i>managerName</i> with the given <i>parameters</i>.</p>
<p>The <i>parent</i> <a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> will be used as the parent of this <a href="qorganizermanager.html">QOrganizerManager</a>.</p>
<p>If an empty <i>managerName</i> is specified, the default implementation for the platform will be used.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@QOrganizerManager -->
<!-- $$$QOrganizerManager$$$QOrganizerManagerconstQString&intconstQMap<QString,QString>&QObject* -->
<h3 class="fn"><a name="QOrganizerManager-2"></a>QOrganizerManager::<span class="name">QOrganizerManager</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>managerName</i>, <span class="type">int</span> <i>implementationVersion</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> & <i>parameters</i> = 0, <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 <a href="qorganizermanager.html">QOrganizerManager</a> whose backend has the name <i>managerName</i> and version <i>implementationVersion</i>, where the manager is constructed with the provided <i>parameters</i>.</p>
<p>The <i>parent</i> <a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> will be used as the parent of this <a href="qorganizermanager.html">QOrganizerManager</a>.</p>
<p>If an empty <i>managerName</i> is specified, the default implementation for the platform will be instantiated. If the specified implementation version is not available, the manager with the name <i>managerName</i> with the default implementation version is instantiated.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@QOrganizerManager -->
<!-- $$$QOrganizerManager$$$QOrganizerManagerQObject* -->
<h3 class="fn"><a name="QOrganizerManager-3"></a>QOrganizerManager::<span class="name">QOrganizerManager</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> )</h3>
<p>Constructs a <a href="qorganizermanager.html">QOrganizerManager</a> whose parent <a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> is <i>parent</i>. The default implementation for the platform will be created.</p>
<!-- @@@QOrganizerManager -->
<!-- $$$~QOrganizerManager[overload1]$$$~QOrganizerManager -->
<h3 class="fn"><a name="dtor.QOrganizerManager"></a>QOrganizerManager::<span class="name">~QOrganizerManager</span> ()</h3>
<p>Frees the memory used by the <a href="qorganizermanager.html">QOrganizerManager</a></p>
<!-- @@@~QOrganizerManager -->
<!-- $$$availableManagers[overload1]$$$availableManagers -->
<h3 class="fn"><a name="availableManagers"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QOrganizerManager::<span class="name">availableManagers</span> ()<tt> [static]</tt></h3>
<p>Returns a list of available manager ids that can be used when constructing a <a href="qorganizermanager.html">QOrganizerManager</a>. If an empty id is specified to the constructor, the first value in this list will be used instead.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@availableManagers -->
<!-- $$$buildUri[overload1]$$$buildUriconstQString&constQMap<QString,QString>&int -->
<h3 class="fn"><a name="buildUri"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QOrganizerManager::<span class="name">buildUri</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>managerName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> & <i>params</i>, <span class="type">int</span> <i>implementationVersion</i> = -1 )<tt> [static]</tt></h3>
<p>Returns a URI that completely describes a manager implementation, datastore, and the parameters with which to instantiate the manager, from the given <i>managerName</i>, <i>params</i> and an optional <i>implementationVersion</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@buildUri -->
<!-- $$$collection[overload1]$$$collectionconstQOrganizerCollectionId& -->
<h3 class="fn"><a name="collection"></a><span class="type"><a href="qorganizercollection.html">QOrganizerCollection</a></span> QOrganizerManager::<span class="name">collection</span> ( const <span class="type"><a href="qorganizercollectionid.html">QOrganizerCollectionId</a></span> & <i>collectionId</i> ) const</h3>
<p>Returns the collection identified by the given <i>collectionId</i> which is managed by this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@collection -->
<!-- $$$collections[overload1]$$$collections -->
<h3 class="fn"><a name="collections"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizercollection.html">QOrganizerCollection</a></span>> QOrganizerManager::<span class="name">collections</span> () const</h3>
<p>Returns a list of all of the collections managed by this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@collections -->
<!-- $$$collectionsAdded[overload1]$$$collectionsAddedconstQList<QOrganizerCollectionId>& -->
<h3 class="fn"><a name="collectionsAdded"></a><span class="type">void</span> QOrganizerManager::<span class="name">collectionsAdded</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizercollectionid.html">QOrganizerCollectionId</a></span>> & <i>collectionIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted at some point once the collections identified by <i>collectionIds</i> have been added to a datastore managed by this manager. This signal will not be emitted if the <a href="qorganizermanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@collectionsAdded -->
<!-- $$$collectionsChanged[overload1]$$$collectionsChangedconstQList<QOrganizerCollectionId>& -->
<h3 class="fn"><a name="collectionsChanged"></a><span class="type">void</span> QOrganizerManager::<span class="name">collectionsChanged</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizercollectionid.html">QOrganizerCollectionId</a></span>> & <i>collectionIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted at some point once the metadata for the collections identified by <i>collectionIds</i> have been modified in a datastore managed by this manager. This signal is not emitted if one of the items in this collection has changed - <a href="qorganizermanager.html#itemsChanged">itemsChanged</a>() will be emitted instead. This signal will not be emitted if the <a href="qorganizermanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@collectionsChanged -->
<!-- $$$collectionsRemoved[overload1]$$$collectionsRemovedconstQList<QOrganizerCollectionId>& -->
<h3 class="fn"><a name="collectionsRemoved"></a><span class="type">void</span> QOrganizerManager::<span class="name">collectionsRemoved</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizercollectionid.html">QOrganizerCollectionId</a></span>> & <i>collectionIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted at some point once the collections identified by <i>collectionIds</i> have been removed from a datastore managed by this manager. This signal will not be emitted if the <a href="qorganizermanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@collectionsRemoved -->
<!-- $$$compatibleCollection[overload1]$$$compatibleCollectionconstQOrganizerCollection& -->
<h3 class="fn"><a name="compatibleCollection"></a><span class="type"><a href="qorganizercollection.html">QOrganizerCollection</a></span> QOrganizerManager::<span class="name">compatibleCollection</span> ( const <span class="type"><a href="qorganizercollection.html">QOrganizerCollection</a></span> & <i>original</i> ) const</h3>
<p>Returns a pruned or modified version of the <i>original</i> organizer collection which is valid and can be saved in the manager. The returned organizer collection might have meta data removed or arbitrarily changed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@compatibleCollection -->
<!-- $$$compatibleItem[overload1]$$$compatibleItemconstQOrganizerItem& -->
<h3 class="fn"><a name="compatibleItem"></a><span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span> QOrganizerManager::<span class="name">compatibleItem</span> ( const <span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span> & <i>original</i> ) const</h3>
<p>Returns a pruned or modified version of the <i>original</i> organizer item which is valid and can be saved in the manager. The returned organizer item might have entire details removed or arbitrarily changed.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@compatibleItem -->
<!-- $$$dataChanged[overload1]$$$dataChanged -->
<h3 class="fn"><a name="dataChanged"></a><span class="type">void</span> QOrganizerManager::<span class="name">dataChanged</span> ()<tt> [signal]</tt></h3>
<p>This signal is emitted by the manager if its internal state changes, and it is unable to determine the changes which occurred, or if the manager considers the changes to be radical enough to require clients to reload all data. If this signal is emitted, no other signals will be emitted for the associated changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@dataChanged -->
<!-- $$$defaultCollection[overload1]$$$defaultCollection -->
<h3 class="fn"><a name="defaultCollection"></a><span class="type"><a href="qorganizercollection.html">QOrganizerCollection</a></span> QOrganizerManager::<span class="name">defaultCollection</span> () const</h3>
<p>Returns the id of the default collection managed by this manager</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@defaultCollection -->
<!-- $$$detailDefinition[overload1]$$$detailDefinitionconstQString&constQString& -->
<h3 class="fn"><a name="detailDefinition"></a><span class="type"><a href="qorganizeritemdetaildefinition.html">QOrganizerItemDetailDefinition</a></span> QOrganizerManager::<span class="name">detailDefinition</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>definitionName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>organizeritemType</i> ) const</h3>
<p>Returns the definition identified by the given <i>definitionName</i> that is valid for the organizer items whose type is the given <i>organizeritemType</i> in this store, or a default-constructed <a href="qorganizeritemdetaildefinition.html">QOrganizerItemDetailDefinition</a> if no such definition exists</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@detailDefinition -->
<!-- $$$detailDefinitions[overload1]$$$detailDefinitionsconstQString& -->
<h3 class="fn"><a name="detailDefinitions"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="qorganizeritemdetaildefinition.html">QOrganizerItemDetailDefinition</a></span>> QOrganizerManager::<span class="name">detailDefinitions</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>organizeritemType</i> ) const</h3>
<p>Returns a map of identifier to detail definition for the registered detail definitions for items whose type is the given <i>organizeritemType</i> which are valid for the organizer items in this store</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@detailDefinitions -->
<!-- $$$error[overload1]$$$error -->
<h3 class="fn"><a name="error"></a><span class="type"><a href="qorganizermanager.html#Error-enum">QOrganizerManager::Error</a></span> QOrganizerManager::<span class="name">error</span> () const</h3>
<p>Return the error code of the most recent operation</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@error -->
<!-- $$$errorMap[overload1]$$$errorMap -->
<h3 class="fn"><a name="errorMap"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type">int</span>, <span class="type"><a href="qorganizermanager.html#Error-enum">QOrganizerManager::Error</a></span>> QOrganizerManager::<span class="name">errorMap</span> () const</h3>
<p>Returns per-input error codes for the most recent operation. This function only returns meaningful information if the most recent operation was a batch operation. Each key in the map is the index of the element in the input list for which the error (whose error code is stored in the value for that key in the map) occurred during the batch operation.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizermanager.html#error">error</a>(), <a href="qorganizermanager.html#saveItems">saveItems</a>(), and <a href="qorganizermanager.html#removeItems">removeItems</a>().</p>
<!-- @@@errorMap -->
<!-- $$$extractIds[overload1]$$$extractIdsconstQList<QOrganizerItem>& -->
<h3 class="fn"><a name="extractIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> QOrganizerManager::<span class="name">extractIds</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> & <i>items</i> )<tt> [static]</tt></h3>
<p>Return a list of <a href="qorganizeritemid.html">QOrganizerItemId</a> extracted from the <i>items</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@extractIds -->
<!-- $$$fromUri[overload1]$$$fromUriconstQString&QObject* -->
<h3 class="fn"><a name="fromUri"></a><span class="type">QOrganizerManager</span> * QOrganizerManager::<span class="name">fromUri</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>storeUri</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )<tt> [static]</tt></h3>
<p>Constructs a <a href="qorganizermanager.html">QOrganizerManager</a> whose implementation, store and parameters are specified in the given <i>storeUri</i>, and whose parent object is <i>parent</i>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@fromUri -->
<!-- $$$hasFeature[overload1]$$$hasFeatureQOrganizerManager::ManagerFeatureconstQString& -->
<h3 class="fn"><a name="hasFeature"></a><span class="type">bool</span> QOrganizerManager::<span class="name">hasFeature</span> ( <span class="type"><a href="qorganizermanager.html#ManagerFeature-enum">QOrganizerManager::ManagerFeature</a></span> <i>feature</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>organizeritemType</i> = QOrganizerItemType::TypeEvent ) const</h3>
<p>Returns true if the given feature <i>feature</i> is supported by the manager, for the specified type of organizer item <i>organizeritemType</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@hasFeature -->
<!-- $$$isFilterSupported[overload1]$$$isFilterSupportedconstQOrganizerItemFilter& -->
<h3 class="fn"><a name="isFilterSupported"></a><span class="type">bool</span> QOrganizerManager::<span class="name">isFilterSupported</span> ( const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> ) const</h3>
<p>Returns true if the given <i>filter</i> is supported natively by the manager, and false if the filter behaviour would be emulated.</p>
<p>Note: In some cases, the behaviour of an unsupported filter cannot be emulated. For example, a filter that requests organizer items that have changed since a given time depends on having that information available. In these cases, the filter will fail.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@isFilterSupported -->
<!-- $$$item[overload1]$$$itemconstQOrganizerItemId&constQOrganizerItemFetchHint& -->
<h3 class="fn"><a name="item"></a><span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span> QOrganizerManager::<span class="name">item</span> ( const <span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span> & <i>itemId</i>, const <span class="type"><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a></span> & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</h3>
<p>Returns the organizer item in the database identified by <i>itemId</i>.</p>
<p>If the organizer item does not exist, an empty, default constructed <a href="qorganizeritem.html">QOrganizerItem</a> will be returned, and the error returned by <a href="qorganizermanager.html#error">error</a>() will be <tt>QOrganizerManager::DoesNotExistError</tt>.</p>
<p>The <i>fetchHint</i> parameter describes the optimization hints that a manager may take. If the <i>fetchHint</i> is the default constructed hint, all existing details in the matching organizer items will be returned. If a client makes changes to an organizer item which has been retrieved with a fetch hint, they should save it back using a partial save, masked by the same set of detail names in order to avoid information loss.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a>.</p>
<!-- @@@item -->
<!-- $$$itemIds[overload1]$$$itemIdsconstQOrganizerItemFilter&constQList<QOrganizerItemSortOrder>& -->
<h3 class="fn"><a name="itemIds"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> QOrganizerManager::<span class="name">itemIds</span> ( const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> = QOrganizerItemFilter(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemsortorder.html">QOrganizerItemSortOrder</a></span>> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> () ) const</h3>
<p>Returns a list of organizer item ids that match the given <i>filter</i>, sorted according to the given list of <i>sortOrders</i>. Depending on the backend, this filtering operation may involve retrieving all organizer items.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@itemIds -->
<!-- $$$itemIds$$$itemIdsconstQDateTime&constQDateTime&constQOrganizerItemFilter&constQList<QOrganizerItemSortOrder>& -->
<h3 class="fn"><a name="itemIds-2"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> QOrganizerManager::<span class="name">itemIds</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>startDate</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>endDate</i>, const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> = QOrganizerItemFilter(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemsortorder.html">QOrganizerItemSortOrder</a></span>> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> () ) const</h3>
<p>Returns a list of organizer item ids of persisted items that match the given <i>filter</i>, sorted according to the given list of <i>sortOrders</i>, for any item which occurs (or has an occurrence which occurs) in the range specified by the given <i>startDate</i> and <i>endDate</i>, inclusive. A default-constructed (invalid) <i>startDate</i> specifies an open start date (matches anything which occurs up until the <i>endDate</i>), and a default-constructed (invalid) <i>endDate</i> specifies an open end date (matches anything which occurs after the <i>startDate</i>). If both the <i>startDate</i> and <i>endDate</i> are invalid, this function will return the ids of all items which match the <i>filter</i> criteria. Depending on the backend, this filtering operation may involve retrieving all organizer items.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@itemIds -->
<!-- $$$itemOccurrences[overload1]$$$itemOccurrencesconstQOrganizerItem&constQDateTime&constQDateTime&intconstQOrganizerItemFetchHint& -->
<h3 class="fn"><a name="itemOccurrences"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> QOrganizerManager::<span class="name">itemOccurrences</span> ( const <span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span> & <i>parentItem</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>periodStart</i> = QDateTime(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>periodEnd</i> = QDateTime(), <span class="type">int</span> <i>maxCount</i> = -1, const <span class="type"><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a></span> & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</h3>
<p>Return the list of a maximum of <i>maxCount</i> organizer item instances which are occurrences of the given <i>parentItem</i> recurring item, which occur between the given <i>periodStart</i> date and the given <i>periodEnd</i> date, inclusive.</p>
<p>If <i>periodStart</i> is after <i>periodEnd</i>, the operation will fail. If <i>maxCount</i> is negative, it is backend specific as to how many occurrences will be returned. Some backends may return no instances, others may return some limited number of occurrences.</p>
<p>The <i>fetchHint</i> allows clients to specify which pieces of information they are interested or not interested in, to allow backends to optimise data retrieval if possible. Note that it is simply a hint; backends can ignore the <i>fetchHint</i>, but if they do so they must return the full item.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@itemOccurrences -->
<!-- $$$items[overload1]$$$itemsconstQOrganizerItemFilter&constQList<QOrganizerItemSortOrder>&constQOrganizerItemFetchHint& -->
<h3 class="fn"><a name="items"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> QOrganizerManager::<span class="name">items</span> ( const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> = QOrganizerItemFilter(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemsortorder.html">QOrganizerItemSortOrder</a></span>> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> (), const <span class="type"><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a></span> & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</h3>
<p>Returns a list of organizer items that match the given <i>filter</i>, sorted according to the given list of <i>sortOrders</i>.</p>
<p>This function will return both persisted and generated occurrences of items which match the specified <i>filter</i>.</p>
<p>Depending on the manager implementation, this filtering operation might be slow and involve retrieving all organizer items and testing them against the supplied filter - see the <a href="qorganizermanager.html#isFilterSupported">isFilterSupported</a>() function.</p>
<p>The <i>fetchHint</i> parameter describes the optimization hints that a manager may take. If the <i>fetchHint</i> is the default constructed hint, all existing details in the matching organizer items will be returned. If a client makes changes to an organizer item which has been retrieved with a fetch hint, they should save it back using a partial save, masked by the same set of detail names in order to avoid information loss.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a>.</p>
<!-- @@@items -->
<!-- $$$items$$$itemsconstQDateTime&constQDateTime&constQOrganizerItemFilter&constQList<QOrganizerItemSortOrder>&constQOrganizerItemFetchHint& -->
<h3 class="fn"><a name="items-2"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> QOrganizerManager::<span class="name">items</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>startDate</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>endDate</i>, const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> = QOrganizerItemFilter(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemsortorder.html">QOrganizerItemSortOrder</a></span>> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> (), const <span class="type"><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a></span> & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</h3>
<p>Returns a list of organizer items that match the given <i>filter</i>, sorted according to the given list of <i>sortOrders</i>, for any item or occurrence of an item which occurs in the range specified by the given <i>startDate</i> and <i>endDate</i>, inclusive. A default-constructed (invalid) <i>startDate</i> specifies an open start date (matches anything which occurs up until the <i>endDate</i>), and a default-constructed (invalid) <i>endDate</i> specifies an open end date (matches anything which occurs after the <i>startDate</i>). If both the <i>startDate</i> and <i>endDate</i> are invalid, this function will return all items which match the <i>filter</i> criteria.</p>
<p>This function will return both persisted and generated occurrences of items which match the specified criteria.</p>
<p>Depending on the manager implementation, this filtering operation might be slow and involve retrieving all organizer items and testing them against the supplied filter - see the <a href="qorganizermanager.html#isFilterSupported">isFilterSupported</a>() function.</p>
<p>If no sort order is provided, the list is returned sorted by date.</p>
<p>The <i>fetchHint</i> parameter describes the optimization hints that a manager may take. If the <i>fetchHint</i> is the default constructed hint, all existing details in the matching organizer items will be returned. If a client makes changes to an organizer item which has been retrieved with a fetch hint, they should save it back using a partial save, masked by the same set of detail names in order to avoid information loss.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a>.</p>
<!-- @@@items -->
<!-- $$$items$$$itemsconstQDateTime&constQDateTime&intconstQOrganizerItemFilter&constQOrganizerItemFetchHint& -->
<h3 class="fn"><a name="items-3"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> QOrganizerManager::<span class="name">items</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>startDate</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>endDate</i>, <span class="type">int</span> <i>maxCount</i>, const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> = QOrganizerItemFilter(), const <span class="type"><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a></span> & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</h3>
<p>Returns a list of organizer items in the range specified by the given <i>startDate</i> and <i>endDate</i>, inclusive. The list will contain the first <i>maxCount</i> such items which match the given <i>filter</i>. A default-constructed (invalid) <i>startDate</i> specifies an open start date (matches anything which occurs up until the <i>endDate</i>), and a default-constructed (invalid) <i>endDate</i> specifies an open end date (matches anything which occurs after the <i>startDate</i>). The list is sorted by date.</p>
<p>This function will return both persisted and generated occurrences of items which match the specified criteria.</p>
<p>Depending on the manager implementation, this filtering operation might be slow and involve retrieving all organizer items and testing them against the supplied filter - see the <a href="qorganizermanager.html#isFilterSupported">isFilterSupported</a>() function.</p>
<p>The <i>fetchHint</i> parameter describes the optimization hints that a manager may take. If the <i>fetchHint</i> is the default constructed hint, all existing details in the matching organizer items will be returned. If a client makes changes to an organizer item which has been retrieved with a fetch hint, they should save it back using a partial save, masked by the same set of detail names in order to avoid information loss.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a>.</p>
<!-- @@@items -->
<!-- $$$itemsAdded[overload1]$$$itemsAddedconstQList<QOrganizerItemId>& -->
<h3 class="fn"><a name="itemsAdded"></a><span class="type">void</span> QOrganizerManager::<span class="name">itemsAdded</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> & <i>itemIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted at some point once the items identified by <i>itemIds</i> have been added to a datastore managed by this manager. This signal will not be emitted if the <a href="qorganizermanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@itemsAdded -->
<!-- $$$itemsChanged[overload1]$$$itemsChangedconstQList<QOrganizerItemId>& -->
<h3 class="fn"><a name="itemsChanged"></a><span class="type">void</span> QOrganizerManager::<span class="name">itemsChanged</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> & <i>itemIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted at some point once the items identified by <i>itemIds</i> have been modified in a datastore managed by this manager. This signal will not be emitted if the <a href="qorganizermanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@itemsChanged -->
<!-- $$$itemsForExport[overload1]$$$itemsForExportconstQDateTime&constQDateTime&constQOrganizerItemFilter&constQList<QOrganizerItemSortOrder>&constQOrganizerItemFetchHint& -->
<h3 class="fn"><a name="itemsForExport"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> QOrganizerManager::<span class="name">itemsForExport</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>startDate</i> = QDateTime(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qdatetime.html">QDateTime</a></span> & <i>endDate</i> = QDateTime(), const <span class="type"><a href="qorganizeritemfilter.html">QOrganizerItemFilter</a></span> & <i>filter</i> = QOrganizerItemFilter(), const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemsortorder.html">QOrganizerItemSortOrder</a></span>> & <i>sortOrders</i> = QList<QOrganizerItemSortOrder> (), const <span class="type"><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a></span> & <i>fetchHint</i> = QOrganizerItemFetchHint() ) const</h3>
<p>Returns a list of organizer items that match the given <i>filter</i>, sorted according to the given list of <i>sortOrders</i>, for any item which occurs (or has an occurrence which occurs) in the range specified by the given <i>startDate</i> and <i>endDate</i>, inclusive. A default-constructed (invalid) <i>startDate</i> specifies an open start date (matches anything which occurs up until the <i>endDate</i>), and a default-constructed (invalid) <i>endDate</i> specifies an open end date (matches anything which occurs after the <i>startDate</i>). If both the <i>startDate</i> and <i>endDate</i> are invalid, this function will return all items which match the <i>filter</i> criteria.</p>
<p>This function will only return parent items and persisted exceptions which match the specified criteria; not generated occurrences.</p>
<p>Depending on the manager implementation, this filtering operation might be slow and involve retrieving all organizer items and testing them against the supplied filter - see the <a href="qorganizermanager.html#isFilterSupported">isFilterSupported</a>() function.</p>
<p>The <i>fetchHint</i> parameter describes the optimization hints that a manager may take. If the <i>fetchHint</i> is the default constructed hint, all existing details in the matching organizer items will be returned. If a client makes changes to an organizer item which has been retrieved with a fetch hint, they should save it back using a partial save, masked by the same set of detail names in order to avoid information loss.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizeritemfetchhint.html">QOrganizerItemFetchHint</a>.</p>
<!-- @@@itemsForExport -->
<!-- $$$itemsRemoved[overload1]$$$itemsRemovedconstQList<QOrganizerItemId>& -->
<h3 class="fn"><a name="itemsRemoved"></a><span class="type">void</span> QOrganizerManager::<span class="name">itemsRemoved</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> & <i>itemIds</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted at some point once the items identified by <i>itemIds</i> have been removed from a datastore managed by this manager. This signal will not be emitted if the <a href="qorganizermanager.html#dataChanged">dataChanged</a>() signal was previously emitted for these changes.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@itemsRemoved -->
<!-- $$$managerName[overload1]$$$managerName -->
<h3 class="fn"><a name="managerName"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QOrganizerManager::<span class="name">managerName</span> () const</h3>
<p>Returns the manager name for this <a href="qorganizermanager.html">QOrganizerManager</a></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerName -->
<!-- $$$managerParameters[overload1]$$$managerParameters -->
<h3 class="fn"><a name="managerParameters"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> QOrganizerManager::<span class="name">managerParameters</span> () const</h3>
<p>Return the parameters relevant to the creation of this <a href="qorganizermanager.html">QOrganizerManager</a></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerParameters -->
<!-- $$$managerUri[overload1]$$$managerUri -->
<h3 class="fn"><a name="managerUri"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> QOrganizerManager::<span class="name">managerUri</span> () const</h3>
<p>Return the uri describing this <a href="qorganizermanager.html">QOrganizerManager</a>, consisting of the manager name and any parameters.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerUri -->
<!-- $$$managerVersion[overload1]$$$managerVersion -->
<h3 class="fn"><a name="managerVersion"></a><span class="type">int</span> QOrganizerManager::<span class="name">managerVersion</span> () const</h3>
<p>Returns the engine backend implementation version number</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@managerVersion -->
<!-- $$$parseUri[overload1]$$$parseUriconstQString&QString*QMap<QString,QString>* -->
<h3 class="fn"><a name="parseUri"></a><span class="type">bool</span> QOrganizerManager::<span class="name">parseUri</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>uri</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> * <i>pManagerId</i>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qmap.html">QMap</a></span><<span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>, <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span>> * <i>pParams</i> )<tt> [static]</tt></h3>
<p>Splits the given <i>uri</i> into the manager, store, and parameters that it describes, and places the information into the memory addressed by <i>pManagerId</i> and <i>pParams</i> respectively. Returns true if <i>uri</i> could be split successfully, otherwise returns false</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@parseUri -->
<!-- $$$removeCollection[overload1]$$$removeCollectionconstQOrganizerCollectionId& -->
<h3 class="fn"><a name="removeCollection"></a><span class="type">bool</span> QOrganizerManager::<span class="name">removeCollection</span> ( const <span class="type"><a href="qorganizercollectionid.html">QOrganizerCollectionId</a></span> & <i>collectionId</i> )</h3>
<p>Removes the collection identified by the given <i>collectionId</i> (and all items in the collection) from the manager if the given <i>collectionId</i> exists. Returns true on success, false on failure.</p>
<p>Attempting to remove the default collection will fail and calling <a href="qorganizermanager.html#error">error</a>() will return <a href="qorganizermanager.html#Error-enum">QOrganizerManager::PermissionsError</a>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeCollection -->
<!-- $$$removeDetailDefinition[overload1]$$$removeDetailDefinitionconstQString&constQString& -->
<h3 class="fn"><a name="removeDetailDefinition"></a><span class="type">bool</span> QOrganizerManager::<span class="name">removeDetailDefinition</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>definitionName</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>organizeritemType</i> )</h3>
<p>Removes the detail definition identified by <i>definitionName</i> from the database, which is valid for organizer items whose type is the given <i>organizeritemType</i>. Returns true if the definition was removed successfully, otherwise returns false</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeDetailDefinition -->
<!-- $$$removeItem[overload1]$$$removeItemconstQOrganizerItemId& -->
<h3 class="fn"><a name="removeItem"></a><span class="type">bool</span> QOrganizerManager::<span class="name">removeItem</span> ( const <span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span> & <i>itemId</i> )</h3>
<p>Remove the organizer item identified by <i>itemId</i> from the database. Returns true if the organizer item was removed successfully, otherwise returns false.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@removeItem -->
<!-- $$$removeItems[overload1]$$$removeItemsconstQList<QOrganizerItemId>& -->
<h3 class="fn"><a name="removeItems"></a><span class="type">bool</span> QOrganizerManager::<span class="name">removeItems</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritemid.html">QOrganizerItemId</a></span>> & <i>organizeritemIds</i> )</h3>
<p>Remove every organizer item whose id is contained in the list of organizer item ids <i>organizeritemIds</i>. Returns true if all organizer items were removed successfully, otherwise false.</p>
<p>Calling <a href="qorganizermanager.html#errorMap">errorMap</a>() will return the per-input errors for the latest batch function. The <a href="qorganizermanager.html#error">QOrganizerManager::error</a>() function will only return <tt>QOrganizerManager::NoError</tt> if all organizer items were removed successfully.</p>
<p>If the given list of organizer item ids <i>organizeritemIds</i> is empty, the function will return false and calling <a href="qorganizermanager.html#error">error</a>() will return <tt>QOrganizerManager::BadArgumentError</tt>. If the list is non-empty and contains ids which do not identify a valid organizer item in the manager, the function will remove any organizer items which are identified by ids in the <i>organizeritemIds</i> list, insert <tt>QOrganizerManager::DoesNotExist</tt> entries into the error map for the indices of invalid ids in the <i>organizeritemIds</i> list, return false, and set the overall operation error to <tt>QOrganizerManager::DoesNotExistError</tt>.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizermanager.html#removeItem">QOrganizerManager::removeItem</a>().</p>
<!-- @@@removeItems -->
<!-- $$$saveCollection[overload1]$$$saveCollectionQOrganizerCollection* -->
<h3 class="fn"><a name="saveCollection"></a><span class="type">bool</span> QOrganizerManager::<span class="name">saveCollection</span> ( <span class="type"><a href="qorganizercollection.html">QOrganizerCollection</a></span> * <i>collection</i> )</h3>
<p>Saves the given <i>collection</i> in the manager. Returns true on success, false on failure.</p>
<p>Some managers do not allow modifications to collections, and thus attempting to save a collection will always fail when attempted in such a manager.</p>
<p>Some managers do not allow adding new collections, and thus attempting to save a new collection will always fail when attempted in such a manager.</p>
<p>Some managers provide front-ends to read-only datastores, and attempting to save a new collection in such a manager will always fail.</p>
<p>Most managers will require a valid value for the <tt>QOrganizerCollection::KeyName</tt> meta data key to be set in a collection, before the collection can be saved correctly. Clients can call <a href="qorganizermanager.html#compatibleCollection">compatibleCollection</a>() to retrieve a pruned or updated version of the collection which is compatible with the manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizermanager.html#compatibleCollection">compatibleCollection</a>().</p>
<!-- @@@saveCollection -->
<!-- $$$saveDetailDefinition[overload1]$$$saveDetailDefinitionconstQOrganizerItemDetailDefinition&constQString& -->
<h3 class="fn"><a name="saveDetailDefinition"></a><span class="type">bool</span> QOrganizerManager::<span class="name">saveDetailDefinition</span> ( const <span class="type"><a href="qorganizeritemdetaildefinition.html">QOrganizerItemDetailDefinition</a></span> & <i>def</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a></span> & <i>organizeritemType</i> )</h3>
<p>Persists the given definition <i>def</i> in the database, which is valid for organizer items whose type is the given <i>organizeritemType</i>. Returns true if the definition was saved successfully, otherwise returns false</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@saveDetailDefinition -->
<!-- $$$saveItem[overload1]$$$saveItemQOrganizerItem* -->
<h3 class="fn"><a name="saveItem"></a><span class="type">bool</span> QOrganizerManager::<span class="name">saveItem</span> ( <span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span> * <i>item</i> )</h3>
<p>Adds the given <i>item</i> to the database if <i>item</i> has a default-constructed id, or an id with the manager URI set to the URI of this manager and a id of zero. It will be saved in the collection whose id is reported by calling item->collectionId() if the specified collection exists, or if no collectionId is specified in the item, or the collectionId is the default collection id, it will be saved in the collection in which the item is currently saved (if it is not a new item) or in the default collection (if it is a new item). As such, an item may be moved between collections with this save operation.</p>
<p>If the manager URI of the id of the <i>item</i> is neither empty nor equal to the URI of this manager, or id of the <i>item</i> is non-zero but does not exist in the manager, the operation will fail and calling <a href="qorganizermanager.html#error">error</a>() will return <tt>QOrganizerManager::DoesNotExistError</tt>.</p>
<p>Alternatively, the function will update the existing organizer item in the database if <i>item</i> has a non-zero id and currently exists in the database.</p>
<p>If the <i>item</i> contains one or more details whose definitions have not yet been saved with the manager, the operation will fail and calling <a href="qorganizermanager.html#error">error</a>() will return <tt>QOrganizerManager::UnsupportedError</tt>.</p>
<p>Returns false on failure, or true on success. On successful save of an organizer item with a null id, its id will be set to a new, valid id with the manager URI set to the URI of this manager, and the id set to a new, valid id. On successful save of an organizer item with a null collection id, the collection id will be set to the id of the default collection of the manager. The manager is not required to fetch updated details of the organizer item on save, and as such, clients should fetch an organizer item if they want the most up-to-date information by calling <a href="qorganizermanager.html#item">QOrganizerManager::item</a>().</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizermanager.html#managerUri">managerUri</a>().</p>
<!-- @@@saveItem -->
<!-- $$$saveItems[overload1]$$$saveItemsQList<QOrganizerItem>* -->
<h3 class="fn"><a name="saveItems"></a><span class="type">bool</span> QOrganizerManager::<span class="name">saveItems</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> * <i>items</i> )</h3>
<p>Adds the list of organizer items given by <i>items</i> list to the database. Each item in the list will be saved in the collection whose id is reported by calling item->collectionId() if the specified collection exists. If no collectionId is specified in the item, or if the collectionId is the default collection id, it will be saved in the collection in which the item is currently saved (if it is not a new item) or in the default collection (if it is a new item). As such, an item may be moved between collections with this save operation. Returns true if the organizer items were saved successfully, otherwise false.</p>
<p>Calling <a href="qorganizermanager.html#errorMap">errorMap</a>() will return the per-input errors for the latest batch function. The <a href="qorganizermanager.html#error">QOrganizerManager::error</a>() function will only return <tt>QOrganizerManager::NoError</tt> if all organizer items were saved successfully.</p>
<p>For each newly saved organizer item that was successful, the id of the organizer item in the <i>items</i> list will be updated with the new value.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>().</p>
<!-- @@@saveItems -->
<!-- $$$saveItems$$$saveItemsQList<QOrganizerItem>*constQStringList& -->
<h3 class="fn"><a name="saveItems-2"></a><span class="type">bool</span> QOrganizerManager::<span class="name">saveItems</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><<span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span>> * <i>items</i>, const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> & <i>definitionMask</i> )</h3>
<p>Adds the list of organizer items given by <i>items</i> list to the database. Each item in the list will be saved in the collection whose id is reported by calling item->collectionId() if the specified collection exists. If no collectionId is specified in the item, or if the collectionId is the default collection id, it will be saved in the collection in which the item is currently saved (if it is not a new item) or in the default collection (if it is a new item). As such, an item may be moved between collections with this save operation. Returns true if the organizer items were saved successfully, otherwise false.</p>
<p>This function accepts a <i>definitionMask</i>, which specifies which details of the items should be updated. Details with definition names not included in the definitionMask will not be updated or added.</p>
<p>Calling <a href="qorganizermanager.html#errorMap">errorMap</a>() will return the per-input errors for the latest batch function. The <a href="qorganizermanager.html#error">QOrganizerManager::error</a>() function will only return <tt>QOrganizerManager::NoError</tt> if all organizer items were saved successfully.</p>
<p>For each newly saved organizer item that was successful, the id of the organizer item in the <i>items</i> list will be updated with the new value.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>().</p>
<!-- @@@saveItems -->
<!-- $$$supportedItemTypes[overload1]$$$supportedItemTypes -->
<h3 class="fn"><a name="supportedItemTypes"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QOrganizerManager::<span class="name">supportedItemTypes</span> () const</h3>
<p>Returns the list of organizer item types which are supported by this manager. This is a convenience function, equivalent to retrieving the allowable values for the <tt>QOrganizerItemType::FieldType</tt> field of the <a href="qorganizeritemtype.html">QOrganizerItemType</a> definition which is valid in this manager.</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@supportedItemTypes -->
</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
>
1628
