<?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" />
<!-- qorganizeritemsaverequest.cpp -->
<title>Qt Mobility 1.2: QOrganizerItemSaveRequest 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>QOrganizerItemSaveRequest</li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QOrganizerItemSaveRequest Class Reference</h1>
<!-- $$$QOrganizerItemSaveRequest-brief -->
<p>The QOrganizerItemSaveRequest class allows a client to asynchronously request that certain organizer items be saved to an organizer item store. <a href="#details">More...</a></p>
<!-- @@@QOrganizerItemSaveRequest -->
<pre class="cpp"> <span class="preprocessor">#include <QOrganizerItemSaveRequest></span></pre><p><b>Inherits: </b><a href="qorganizerabstractrequest.html">QOrganizerAbstractRequest</a>.</p>
<p>This class was introduced in Qt Mobility 1.1.</p>
<ul>
<li><a href="qorganizeritemsaverequest-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#QOrganizerItemSaveRequest">QOrganizerItemSaveRequest</a></b> ( QObject * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#dtor.QOrganizerItemSaveRequest">~QOrganizerItemSaveRequest</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QStringList </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#definitionMask">definitionMask</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMap<int, QOrganizerManager::Error> </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#errorMap">errorMap</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QOrganizerItem> </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#items">items</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#setDefinitionMask">setDefinitionMask</a></b> ( const QStringList & <i>definitionMask</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#setItem">setItem</a></b> ( const QOrganizerItem & <i>organizeritem</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritemsaverequest.html#setItems">setItems</a></b> ( const QList<QOrganizerItem> & <i>organizeritems</i> )</td></tr>
</table>
<ul>
<li class="fn">9 public functions inherited from <a href="qorganizerabstractrequest.html#public-functions">QOrganizerAbstractRequest</a></li>
<li class="fn">29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
<li class="fn">3 public slots inherited from <a href="qorganizerabstractrequest.html#public-slots">QOrganizerAbstractRequest</a></li>
<li class="fn">1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
<li class="fn">2 signals inherited from <a href="qorganizerabstractrequest.html#signals">QOrganizerAbstractRequest</a></li>
<li class="fn">1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">QObject</a></li>
<li class="fn">1 public variable inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-variables">QObject</a></li>
<li class="fn">4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">QObject</a></li>
<li class="fn">7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li class="fn">2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<!-- $$$QOrganizerItemSaveRequest-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QOrganizerItemSaveRequest class allows a client to asynchronously request that certain organizer items be saved to an organizer item store.</p>
<p>For a QOrganizerItemSaveRequest, the <a href="qorganizerabstractrequest.html#resultsAvailable">resultsAvailable</a>() signal will be emitted when either the individual item errors (which may be retrieved by calling <a href="qorganizeritemsaverequest.html#errorMap">errorMap</a>()), or the resultant organizer items (which may be retrieved by calling <a href="qorganizeritemsaverequest.html#items">items</a>()), are updated, as well as if the overall operation error (which may be retrieved by calling <a href="qorganizerabstractrequest.html#error">error</a>()) is updated.</p>
</div>
<!-- @@@QOrganizerItemSaveRequest -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QOrganizerItemSaveRequest[overload1]$$$QOrganizerItemSaveRequestQObject* -->
<h3 class="fn"><a name="QOrganizerItemSaveRequest"></a>QOrganizerItemSaveRequest::<span class="name">QOrganizerItemSaveRequest</span> ( <span class="type"><a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs a new organizer item save request whose parent is the specified <i>parent</i></p>
<!-- @@@QOrganizerItemSaveRequest -->
<!-- $$$~QOrganizerItemSaveRequest[overload1]$$$~QOrganizerItemSaveRequest -->
<h3 class="fn"><a name="dtor.QOrganizerItemSaveRequest"></a>QOrganizerItemSaveRequest::<span class="name">~QOrganizerItemSaveRequest</span> ()</h3>
<p>Frees memory in use by this request</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<!-- @@@~QOrganizerItemSaveRequest -->
<!-- $$$definitionMask[overload1]$$$definitionMask -->
<h3 class="fn"><a name="definitionMask"></a><span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> QOrganizerItemSaveRequest::<span class="name">definitionMask</span> () const</h3>
<p>Returns the list of definitions that this request will operate on.</p>
<p>If the list is empty, the request will operate on all details.</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qorganizeritemsaverequest.html#setDefinitionMask">setDefinitionMask</a>().</p>
<!-- @@@definitionMask -->
<!-- $$$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>> QOrganizerItemSaveRequest::<span class="name">errorMap</span> () const</h3>
<p>Returns the map of input definition list indices to errors which occurred</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@errorMap -->
<!-- $$$items[overload1]$$$items -->
<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>> QOrganizerItemSaveRequest::<span class="name">items</span> () const</h3>
<p>Returns the list of organizer items which will be saved if called prior to calling <tt>start()</tt>, otherwise returns the list of organizer items as they were saved in the organizer item store</p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizeritemsaverequest.html#setItems">setItems</a>().</p>
<!-- @@@items -->
<!-- $$$setDefinitionMask[overload1]$$$setDefinitionMaskconstQStringList& -->
<h3 class="fn"><a name="setDefinitionMask"></a><span class="type">void</span> QOrganizerItemSaveRequest::<span class="name">setDefinitionMask</span> ( const <span class="type"><a href="http://qt.nokia.com/doc/4.7/qstringlist.html">QStringList</a></span> & <i>definitionMask</i> )</h3>
<p>Set the list of definitions to restrict saving to <i>definitionMask</i>. This allows you to perform partial save (and remove) operations on existing items.</p>
<p>If <i>definitionMask</i> is empty (the default), no restrictions will apply, and the passed in items will be saved as is. Otherwise, only details whose definitions are in the list will be saved. If a definition name is present in the list, but there are no corresponding details in the item passed into this request, any existing details in the manager for that item will be removed.</p>
<p>This is useful if you've used a fetch hint to fetch a partial item from a manager so that you can save changes to the details you actually fetched without removing the details you didn't.</p>
<p>Additionally, when performing synchronization operations with other managers that don't support the full range of details, you can restrict the update operation to only those details so that you don't lose the extra details that are supported in this manager.</p>
<p><b>Note:</b> Some managers do not support partial updates natively, in which case the <a href="qtorganizer.html">QtOrganizer</a> framework will emulate the functionality (fetching the whole item, applying the new restricted details, and saving the item back).</p>
<p>This function was introduced in Qt Mobility 1.2.</p>
<p><b>See also </b><a href="qorganizeritemsaverequest.html#definitionMask">definitionMask</a>().</p>
<!-- @@@setDefinitionMask -->
<!-- $$$setItem[overload1]$$$setItemconstQOrganizerItem& -->
<h3 class="fn"><a name="setItem"></a><span class="type">void</span> QOrganizerItemSaveRequest::<span class="name">setItem</span> ( const <span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span> & <i>organizeritem</i> )</h3>
<p>Sets the organizer item to be saved to <i>organizeritem</i>. Equivalent to calling:</p>
<pre class="cpp"> setOrganizerItems(<span class="type"><a href="http://qt.nokia.com/doc/4.7/qlist.html">QList</a></span><span class="operator"><</span><span class="type"><a href="qorganizeritem.html">QOrganizerItem</a></span><span class="operator">></span>() <span class="operator"><</span><span class="operator"><</span> organizeritem);</pre>
<p>This function was introduced in Qt Mobility 1.1.</p>
<!-- @@@setItem -->
<!-- $$$setItems[overload1]$$$setItemsconstQList<QOrganizerItem>& -->
<h3 class="fn"><a name="setItems"></a><span class="type">void</span> QOrganizerItemSaveRequest::<span class="name">setItems</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>organizeritems</i> )</h3>
<p>Sets the list of organizer items to be saved to <i>organizeritems</i></p>
<p>This function was introduced in Qt Mobility 1.1.</p>
<p><b>See also </b><a href="qorganizeritemsaverequest.html#items">items</a>().</p>
<!-- @@@setItems -->
</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
>
1610
