~ubuntu-branches/ubuntu/quantal/qtmobility/quantal

« back to all changes in this revision

Viewing changes to doc/html/qorganizeritem.html

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2010-11-16 16:18:07 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20101116161807-k2dzt2nyse975r3l
Tags: 1.1.0-0ubuntu1
* New upstream release
* Syncronise with Debian, no remaining changes

Show diffs side-by-side

added added

removed removed

Lines of Context:
47
47
    </div>
48
48
    <div id="shortCut">
49
49
      <ul>
50
 
        <li class="shortCut-topleft-inactive"><span><a href="index.html">Mobility 1.1 BETA</a></span></li>
 
50
        <li class="shortCut-topleft-inactive"><span><a href="index.html">Mobility 1.1</a></span></li>
51
51
        <li class="shortCut-topleft-active"><a href="http://doc.qt.nokia.com">ALL VERSIONS        </a></li>
52
52
      </ul>
53
53
     </div>
180
180
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#guid">guid</a></b> () const</td></tr>
181
181
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerItemId </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#id">id</a></b> () const</td></tr>
182
182
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#isEmpty">isEmpty</a></b> () const</td></tr>
183
 
<tr><td class="memItemLeft rightAlign topAlign"> QOrganizerItemLocalId </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#localId">localId</a></b> () const</td></tr>
184
183
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#removeDetail">removeDetail</a></b> ( QOrganizerItemDetail * <i>detail</i> )</td></tr>
185
184
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#saveDetail">saveDetail</a></b> ( QOrganizerItemDetail * <i>detail</i> )</td></tr>
 
185
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#setCollectionId">setCollectionId</a></b> ( const QOrganizerCollectionId &amp; <i>collectionId</i> )</td></tr>
186
186
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#setDescription">setDescription</a></b> ( const QString &amp; <i>description</i> )</td></tr>
187
187
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#setDescription-2">setDescription</a></b> ( const QOrganizerItemDescription &amp; <i>description</i> )</td></tr>
188
188
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#setDisplayLabel">setDisplayLabel</a></b> ( const QString &amp; <i>label</i> )</td></tr>
200
200
<a name="related-non-members"></a>
201
201
<h2>Related Non-Members</h2>
202
202
<table class="alignedsummary">
203
 
<tr><td class="memItemLeft rightAlign topAlign"> uint </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#qHash">qHash</a></b> ( const QOrganizerItem &amp; <i>key</i> )</td></tr>
 
203
<tr><td class="memItemLeft rightAlign topAlign"> uint </td><td class="memItemRight bottomAlign"><b><a href="qorganizeritem.html#qHash-22">qHash</a></b> ( const QOrganizerItem &amp; <i>key</i> )</td></tr>
204
204
</table>
205
205
<hr />
206
206
<a name="macros"></a>
213
213
<div class="descr"/>
214
214
<h2>Detailed Description</h2>
215
215
<p>The QOrganizerItem class represents an event, todo, note, or journal entry</p>
216
 
<p>A QOrganizerItem object has an id and a collection of details (like a start date and location). Each detail (which can have multiple fields) is stored in an appropriate subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>, and the QOrganizerItem allows retrieving these details in various ways.</p>
217
 
<p>A QOrganizerItem instance represents the in-memory version of a calendar organizer item, and has no tie to a specific <a href="qorganizeritemmanager.html">QOrganizerItemManager</a>. It is possible for the contents of a QOrganizerItem to change independently of the contents that are stored persistently in a <a href="qorganizeritemmanager.html">QOrganizerItemManager</a>. A QOrganizerItem has an ID associated with it when it is first retrieved from a <a href="qorganizeritemmanager.html">QOrganizerItemManager</a>, or after it has been first saved, and this allows clients to track changes using the signals in <a href="qorganizeritemmanager.html">QOrganizerItemManager</a>.</p>
218
 
<p>A QOrganizerItem has a number of mandatory details:</p>
219
 
<ul>
220
 
<li>A <a href="qorganizeritemtype.html">QOrganizerItemType</a>, with the type of the organizer item (individual event, todo, journal etc)</li>
221
 
<li>A <a href="qorganizeritemdescription.html">QOrganizerItemDescription</a>, which describes the item</li>
222
 
<li>A <a href="qorganizeritemdisplaylabel.html">QOrganizerItemDisplayLabel</a>, which is the default label of the item</li>
223
 
</ul>
224
 
<p>Different subclasses of QOrganizerItem (i.e&#x2e;, <a href="qorganizerevent.html">QOrganizerEvent</a>, <a href="qorganizertodo.html">QOrganizerTodo</a>, <a href="qorganizerjournal.html">QOrganizerJournal</a> and <a href="qorganizernote.html">QOrganizerNote</a>) may have more mandatory details.</p>
 
216
<p>A QOrganizerItem object has an id and a collection of details (like a start date and location), as well as a collection id which identifies which <a href="qorganizercollection.html">QOrganizerCollection</a> the item is part of in a manager. Each detail (which can have multiple fields) is stored in an appropriate subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>, and the QOrganizerItem allows retrieving these details in various ways.</p>
 
217
<p>Most clients will want to use the convenient subclasses of QOrganizerItem (i.e&#x2e;, <a href="qorganizerevent.html">QOrganizerEvent</a> (and QOrganizerEventOccurence), <a href="qorganizertodo.html">QOrganizerTodo</a> (and QOrganizerTodoOccurence), <a href="qorganizerjournal.html">QOrganizerJournal</a> and <a href="qorganizernote.html">QOrganizerNote</a>) instead of manipulating instances of QOrganizerItem directly.</p>
 
218
<p>A QOrganizerItem instance represents the in-memory version of a calendar organizer item. It is possible for the contents of a QOrganizerItem to change independently of the contents that are stored persistently in a <a href="qorganizermanager.html">QOrganizerManager</a>. A QOrganizerItem has an id associated with it when it is first retrieved from a <a href="qorganizermanager.html">QOrganizerManager</a>, or after it has been first saved, and this allows clients to track changes using the signals in <a href="qorganizermanager.html">QOrganizerManager</a>. When saved in a manager, every item is placed into a <a href="qorganizercollection.html">QOrganizerCollection</a> in that manager, according to the collection id set in the item prior to save (or the default collection if no collection id was set in the item).</p>
 
219
<p>Different QOrganizerManagers may require an item to have certain details saved in it before it can be stored in that manager. By default, every item must have a <a href="qorganizeritemtype.html">QOrganizerItemType</a> detail which identifies the type of the item. Different subclasses of QOrganizerItem (i.e&#x2e;, <a href="qorganizerevent.html">QOrganizerEvent</a> (and QOrganizerEventOccurence), <a href="qorganizertodo.html">QOrganizerTodo</a> (and QOrganizerTodoOccurence), <a href="qorganizerjournal.html">QOrganizerJournal</a> and <a href="qorganizernote.html">QOrganizerNote</a>) may have other mandatory details, depending on the manager.</p>
225
220
</div>
226
 
<p>See also <a href="qorganizeritemmanager.html">QOrganizerItemManager</a> and <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
 
221
<p>See also <a href="qorganizermanager.html">QOrganizerManager</a> and <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
227
222
<hr />
228
223
<div class="func"/>
229
224
<h2>Member Function Documentation</h2>
234
229
<p>Initializes this <a href="qorganizeritem.html">QOrganizerItem</a> from <i>other</i></p>
235
230
<h3 class="fn"><a name="dtor.QOrganizerItem"></a>QOrganizerItem::~QOrganizerItem ()</h3>
236
231
<p>Frees the memory used by this <a href="qorganizeritem.html">QOrganizerItem</a></p>
237
 
<h3 class="fn"><a name="addComment"></a>void QOrganizerItem::addComment ( const QString &amp; <i>comment</i> )</h3>
 
232
<h3 class="fn"><a name="addComment"></a>void QOrganizerItem::addComment ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>comment</i> )</h3>
238
233
<p>Adds the comment <i>comment</i> to this item</p>
239
234
<h3 class="fn"><a name="clearComments"></a>void QOrganizerItem::clearComments ()</h3>
240
235
<p>Clears the comments (arbitrary notes) about this item</p>
241
236
<h3 class="fn"><a name="clearDetails"></a>void QOrganizerItem::clearDetails ()</h3>
242
237
<p>Removes all details of the organizer item. This function does not modify the id or type of the organizer item. Calling <a href="qorganizeritem.html#isEmpty">isEmpty</a>() after calling this function will return true. The empty item becomes a <a href="qorganizernote.html">QOrganizerNote</a>.</p>
243
238
<h3 class="fn"><a name="collectionId"></a><a href="qorganizercollectionid.html">QOrganizerCollectionId</a> QOrganizerItem::collectionId () const</h3>
244
 
<p>Note: only returns meaningful id if it has been saved in a manager. An item always belongs to exactly one collection (default, if not set).</p>
245
 
<h3 class="fn"><a name="comments"></a>QStringList QOrganizerItem::comments () const</h3>
 
239
<p>Returns the id of the collection which this item is part of, in the manager in which the item has been saved, if the item has previously been saved in a manager. If the item has not previously been saved in a manager, this function will return the id of the collection into which the client wishes the item to be saved when <a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>() is called, which is set by calling <a href="qorganizeritem.html#setId">setId</a>(); otherwise, returns a null id.</p>
 
240
<p>An item always belongs to exactly one collection in a particular manager after it has been saved in the manager. If the item has previously been saved in the manager, in a particular collection, and the client sets the collection id of the item to the id of a different collection within that manager and then resaves the item, the item will be moved from its original collection into the specified collection if the move operation is supported by the manager; otherwise, the <a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>() operation will fail and calling <a href="qorganizermanager.html#error">QOrganizerManager::error</a>() will return <tt>QOrganizerManager::NotSupportedError</tt>.</p>
 
241
<p>See also <a href="qorganizeritem.html#setCollectionId">setCollectionId</a>().</p>
 
242
<h3 class="fn"><a name="comments"></a><a href="http://qt.nokia.com/doc/4.6/qstringlist.html">QStringList</a> QOrganizerItem::comments () const</h3>
246
243
<p>Returns the list of comments (or arbitrary notes about the item) which pertain to this item</p>
247
 
<h3 class="fn"><a name="description"></a>QString QOrganizerItem::description () const</h3>
 
244
<h3 class="fn"><a name="description"></a><a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> QOrganizerItem::description () const</h3>
248
245
<p>Returns the human-readable description of the item</p>
249
246
<p>See also <a href="qorganizeritem.html#setDescription">setDescription</a>().</p>
250
 
<h3 class="fn"><a name="detail"></a><a href="qorganizeritemdetail.html">QOrganizerItemDetail</a> QOrganizerItem::detail ( const QString &amp; <i>definitionName</i> ) const</h3>
 
247
<h3 class="fn"><a name="detail"></a><a href="qorganizeritemdetail.html">QOrganizerItemDetail</a> QOrganizerItem::detail ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>definitionName</i> ) const</h3>
251
248
<p>Returns the first detail stored in the organizer item with the given <i>definitionName</i></p>
252
249
<h3 class="fn"><a name="detail-3"></a><a href="qorganizeritemdetail.html">QOrganizerItemDetail</a> QOrganizerItem::detail ( const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>definitionName</i> ) const</h3>
253
250
<p>Returns the first detail stored in the organizer item which with the given <i>definitionName</i>. The <i>definitionName</i> argument is typically the detail name constant provided by a specific subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
254
251
<p>It would usually be more convenient to use the template version of this function.</p>
255
252
<h3 class="fn"><a name="detail-4"></a>T QOrganizerItem::detail () const</h3>
256
253
<p>Returns the first detail of the template parameter type, as returned by the template <a href="qorganizeritem.html#details">details</a>() function. The type must be a subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
257
 
<h3 class="fn"><a name="details"></a>QList&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const QString &amp; <i>definitionName</i> = QString() ) const</h3>
258
 
<p>Returns a list of details with the given <i>definitionName</i> The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g&#x2e; QOrganizerItemPhoneNumber::DefinitionName) or by requesting a list of all the definition names using <a href="qorganizeritemmanager.html#detailDefinitions">detailDefinitions()</a> or the asynchronous <a href="qorganizeritemdetaildefinitionfetchrequest.html#definitionNames">definitionNames()</a>.</p>
259
 
<h3 class="fn"><a name="details-2"></a>QList&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const QString &amp; <i>definitionName</i>, const QString &amp; <i>fieldName</i>, const QString &amp; <i>value</i> ) const</h3>
260
 
<p>Returns a list of details of the given <i>definitionName</i>, with fields named <i>fieldName</i> and with value <i>value</i>. The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g&#x2e; QOrganizerItemPhoneNumber::DefinitionName) or by requesting a list of all the definition names using <a href="qorganizeritemmanager.html#detailDefinitions">detailDefinitions()</a> or the asynchronous <a href="qorganizeritemdetaildefinitionfetchrequest.html#definitionNames">definitionNames()</a>.</p>
261
 
<h3 class="fn"><a name="details-5"></a>QList&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>definitionName</i> ) const</h3>
 
254
<h3 class="fn"><a name="details"></a><a href="http://qt.nokia.com/doc/4.6/qlist.html">QList</a>&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>definitionName</i> = QString() ) const</h3>
 
255
<p>Returns a list of details with the given <i>definitionName</i> The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g&#x2e; QOrganizerItemPhoneNumber::DefinitionName) or by requesting a list of all the definition names using <a href="qorganizermanager.html#detailDefinitions">detailDefinitions()</a> or the asynchronous <a href="qorganizeritemdetaildefinitionfetchrequest.html#definitionNames">definitionNames()</a>.</p>
 
256
<h3 class="fn"><a name="details-2"></a><a href="http://qt.nokia.com/doc/4.6/qlist.html">QList</a>&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>definitionName</i>, const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>fieldName</i>, const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>value</i> ) const</h3>
 
257
<p>Returns a list of details of the given <i>definitionName</i>, with fields named <i>fieldName</i> and with value <i>value</i>. The definitionName string can be determined by the DefinitionName attribute of defined objects (e.g&#x2e; QOrganizerItemPhoneNumber::DefinitionName) or by requesting a list of all the definition names using <a href="qorganizermanager.html#detailDefinitions">detailDefinitions()</a> or the asynchronous <a href="qorganizeritemdetaildefinitionfetchrequest.html#definitionNames">definitionNames()</a>.</p>
 
258
<h3 class="fn"><a name="details-5"></a><a href="http://qt.nokia.com/doc/4.6/qlist.html">QList</a>&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>definitionName</i> ) const</h3>
262
259
<p>Returns a list of details of the given <i>definitionName</i>.</p>
263
260
<p>The <i>definitionName</i> argument is typically the detail name constant provided by a specific subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
264
261
<p>It would usually be more convenient to use the template version of this function.</p>
265
 
<h3 class="fn"><a name="details-6"></a>QList&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>definitionName</i>, const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>fieldName</i>, const QString &amp; <i>value</i> )</h3>
 
262
<h3 class="fn"><a name="details-6"></a><a href="http://qt.nokia.com/doc/4.6/qlist.html">QList</a>&lt;<a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>&gt; QOrganizerItem::details ( const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>definitionName</i>, const <a href="qlatin1constant.html">QLatin1Constant</a> &amp; <i>fieldName</i>, const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>value</i> )</h3>
266
263
<p>Returns a list of details of the given <i>definitionName</i>, with fields named <i>fieldName</i> and with value <i>value</i>.</p>
267
 
<h3 class="fn"><a name="details-7"></a>QList&lt;T&gt; QOrganizerItem::details () const</h3>
 
264
<h3 class="fn"><a name="details-7"></a><a href="http://qt.nokia.com/doc/4.6/qlist.html">QList</a>&lt;T&gt; QOrganizerItem::details () const</h3>
268
265
<p>Returns a list of details of the template parameter type. The type must be a subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
269
 
<h3 class="fn"><a name="details-8"></a>QList&lt;T&gt; QOrganizerItem::details ( const QString &amp; <i>fieldName</i>, const QString &amp; <i>value</i> ) const</h3>
 
266
<h3 class="fn"><a name="details-8"></a><a href="http://qt.nokia.com/doc/4.6/qlist.html">QList</a>&lt;T&gt; QOrganizerItem::details ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>fieldName</i>, const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>value</i> ) const</h3>
270
267
<p>Returns a list of details of the template parameter type which have field called <i>fieldName</i>, with matching <i>value</i>. The type must be a subclass of <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a>.</p>
271
 
<h3 class="fn"><a name="displayLabel"></a>QString QOrganizerItem::displayLabel () const</h3>
 
268
<h3 class="fn"><a name="displayLabel"></a><a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> QOrganizerItem::displayLabel () const</h3>
272
269
<p>Returns the display label of the item</p>
273
270
<p>See also <a href="qorganizeritem.html#setDisplayLabel">setDisplayLabel</a>().</p>
274
 
<h3 class="fn"><a name="guid"></a>QString QOrganizerItem::guid () const</h3>
 
271
<h3 class="fn"><a name="guid"></a><a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> QOrganizerItem::guid () const</h3>
275
272
<p>Returns the globally unique identifier which identifies this item, which is used for synchronization purposes.</p>
276
273
<p>See also <a href="qorganizeritem.html#setGuid">setGuid</a>().</p>
277
274
<h3 class="fn"><a name="id"></a><a href="qorganizeritemid.html">QOrganizerItemId</a> QOrganizerItem::id () const</h3>
278
275
<p>Returns the <a href="qorganizeritemid.html">QOrganizerItemId</a> that identifies this organizer item.</p>
279
 
<p>This may have been set when the organizer item was retrieved from a particular manager, or when the organizer item was first saved in a manager. The <a href="qorganizeritemid.html">QOrganizerItemId</a> is only valid with a specific manager. See <a href="qorganizeritemmanager.html#saveItem">QOrganizerItemManager::saveItem</a>() for more information.</p>
280
 
<p>See also <a href="qorganizeritem.html#setId">setId</a>() and <a href="qorganizeritem.html#localId">localId</a>().</p>
 
276
<p>This may have been set when the organizer item was retrieved from a particular manager, or when the organizer item was first saved in a manager. The <a href="qorganizeritemid.html">QOrganizerItemId</a> is only valid within a specific manager. See <a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>() for more information.</p>
 
277
<p>See also <a href="qorganizeritem.html#setId">setId</a>().</p>
281
278
<h3 class="fn"><a name="isEmpty"></a>bool QOrganizerItem::isEmpty () const</h3>
282
279
<p>Returns true if this <a href="qorganizeritem.html">QOrganizerItem</a> is empty, false if not.</p>
283
280
<p>An empty <a href="qorganizeritem.html">QOrganizerItem</a> has an empty label and no extra details. The type of the organizer item is irrelevant.</p>
284
 
<h3 class="fn"><a name="localId"></a><a href="qorganizeritemid.html#QOrganizerItemLocalId-typedef">QOrganizerItemLocalId</a> QOrganizerItem::localId () const</h3>
285
 
<p>Returns the <a href="qorganizeritemid.html#QOrganizerItemLocalId-typedef">QOrganizerItemLocalId</a> that identifies this organizer item within its manager</p>
286
 
<p>This may have been set when the organizer item was retrieved from a particular manager, or when the organizer item was first saved in a manager. The <a href="qorganizeritemid.html#QOrganizerItemLocalId-typedef">QOrganizerItemLocalId</a> is associated with a specific manager, but other organizer items with the same local id might exist in different managers.</p>
287
 
<p>See <a href="qorganizeritemmanager.html#saveItem">QOrganizerItemManager::saveItem</a>() for more information.</p>
288
 
<p>See also <a href="qorganizeritem.html#id">id</a>().</p>
289
281
<h3 class="fn"><a name="removeDetail"></a>bool QOrganizerItem::removeDetail ( <a href="qorganizeritemdetail.html">QOrganizerItemDetail</a> * <i>detail</i> )</h3>
290
282
<p>Removes the <i>detail</i> from the organizer item.</p>
291
283
<p>The detail in the organizer item which has the same key as that of the given <i>detail</i> will be removed if it exists. Only the key is used for comparison - that is, the information in the detail may be different.</p>
298
290
<p>If <i>detail</i> is a <a href="qorganizeritemtype.html">QOrganizerItemType</a>, the existing organizer item type will be overwritten with <i>detail</i>. There is never more than one organizer item type in a organizer item.</p>
299
291
<p>Returns true if the detail was saved successfully, otherwise returns false.</p>
300
292
<p>Note that the caller retains ownership of the detail.</p>
301
 
<h3 class="fn"><a name="setDescription"></a>void QOrganizerItem::setDescription ( const QString &amp; <i>description</i> )</h3>
 
293
<h3 class="fn"><a name="setCollectionId"></a>void QOrganizerItem::setCollectionId ( const <a href="qorganizercollectionid.html">QOrganizerCollectionId</a> &amp; <i>collectionId</i> )</h3>
 
294
<p>Sets the id of the collection into which the client wishes the item to be saved to the given <i>collectionId</i>.</p>
 
295
<p>If the given <i>collectionId</i> is the null collection id, the client is specifying that the item should be saved into the collection in which the item is already saved (if the item has previously been saved in the manager, without having been removed since), or into the default collection of the manager (if the item has not previously been saved in the manager, or has been removed since the last time it was saved).</p>
 
296
<p>If the item has previously been saved in a particular manager, and the given <i>collectionId</i> is the id of a different collection than the one which the item is currently a part of in that manager, saving the item with <a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>() will move the item from its original collection to the collection whose id is <i>collectionId</i>, if <i>collectionId</i> identifies a valid collection and the operation is supported by the manager.</p>
 
297
<p>See also <a href="qorganizeritem.html#collectionId">collectionId</a>().</p>
 
298
<h3 class="fn"><a name="setDescription"></a>void QOrganizerItem::setDescription ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>description</i> )</h3>
302
299
<p>Sets the human-readable description of the item to <i>description</i></p>
303
300
<p>See also <a href="qorganizeritem.html#description">description</a>().</p>
304
301
<h3 class="fn"><a name="setDescription-2"></a>void QOrganizerItem::setDescription ( const <a href="qorganizeritemdescription.html">QOrganizerItemDescription</a> &amp; <i>description</i> )</h3>
305
302
<p>Sets the human-readable description of the item to <i>description</i></p>
306
 
<h3 class="fn"><a name="setDisplayLabel"></a>void QOrganizerItem::setDisplayLabel ( const QString &amp; <i>label</i> )</h3>
 
303
<h3 class="fn"><a name="setDisplayLabel"></a>void QOrganizerItem::setDisplayLabel ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>label</i> )</h3>
307
304
<p>Sets the display label of the item to <i>label</i></p>
308
305
<p>See also <a href="qorganizeritem.html#displayLabel">displayLabel</a>().</p>
309
306
<h3 class="fn"><a name="setDisplayLabel-2"></a>void QOrganizerItem::setDisplayLabel ( const <a href="qorganizeritemdisplaylabel.html">QOrganizerItemDisplayLabel</a> &amp; <i>label</i> )</h3>
310
307
<p>Sets the display label of the item to <i>label</i></p>
311
 
<h3 class="fn"><a name="setGuid"></a>void QOrganizerItem::setGuid ( const QString &amp; <i>guid</i> )</h3>
 
308
<h3 class="fn"><a name="setGuid"></a>void QOrganizerItem::setGuid ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>guid</i> )</h3>
312
309
<p>Sets the item's globally unique identifier to <i>guid</i></p>
313
310
<p>See also <a href="qorganizeritem.html#guid">guid</a>().</p>
314
311
<h3 class="fn"><a name="setId"></a>void QOrganizerItem::setId ( const <a href="qorganizeritemid.html">QOrganizerItemId</a> &amp; <i>id</i> )</h3>
315
312
<p>Sets the id of this organizer item to <i>id</i>.</p>
316
 
<p>Note that this only affects this object, not any corresponding structures stored by a <a href="qorganizeritemmanager.html">QOrganizerItemManager</a>.</p>
 
313
<p>Note that this only affects this object, not any corresponding structures stored by a <a href="qorganizermanager.html">QOrganizerManager</a>.</p>
317
314
<p>If you change the id of a organizer item and save the organizer item in a manager, the previously existing organizer item will still exist. You can do this to create copies (possibly modified) of an existing organizer item, or to save a organizer item in a different manager.</p>
318
 
<p>See also <a href="qorganizeritem.html#id">id</a>() and <a href="qorganizeritemmanager.html#saveItem">QOrganizerItemManager::saveItem</a>().</p>
319
 
<h3 class="fn"><a name="setType"></a>void QOrganizerItem::setType ( const QString &amp; <i>type</i> )</h3>
 
315
<p>See also <a href="qorganizeritem.html#id">id</a>() and <a href="qorganizermanager.html#saveItem">QOrganizerManager::saveItem</a>().</p>
 
316
<h3 class="fn"><a name="setType"></a>void QOrganizerItem::setType ( const <a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> &amp; <i>type</i> )</h3>
320
317
<p>Sets the type of the organizer item to the given <i>type</i>.</p>
321
318
<p>See also <a href="qorganizeritem.html#type">type</a>().</p>
322
319
<h3 class="fn"><a name="setType-2"></a>void QOrganizerItem::setType ( const <a href="qorganizeritemtype.html">QOrganizerItemType</a> &amp; <i>type</i> )</h3>
323
320
<p>Sets the type of the organizer item to the given <i>type</i> detail.</p>
324
 
<h3 class="fn"><a name="type"></a>QString QOrganizerItem::type () const</h3>
 
321
<h3 class="fn"><a name="type"></a><a href="http://qt.nokia.com/doc/4.6/qstring.html">QString</a> QOrganizerItem::type () const</h3>
325
322
<p>Returns the type of the organizer item. Every organizer item has exactly one type which is either set manually (by saving a modified copy of the <a href="qorganizeritemtype.html">QOrganizerItemType</a> in the organizer item, or by calling <a href="qorganizeritem.html#setType">setType</a>()) or synthesized automatically.</p>
326
323
<p>See also <a href="qorganizeritem.html#setType">setType</a>().</p>
327
324
<h3 class="fn"><a name="operator-not-eq"></a>bool QOrganizerItem::operator!= ( const QOrganizerItem &amp; <i>other</i> ) const</h3>
329
326
<h3 class="fn"><a name="operator-eq"></a>QOrganizerItem &amp; QOrganizerItem::operator= ( const QOrganizerItem &amp; <i>other</i> )</h3>
330
327
<p>Replace the contents of this <a href="qorganizeritem.html">QOrganizerItem</a> with <i>other</i></p>
331
328
<h3 class="fn"><a name="operator-eq-eq"></a>bool QOrganizerItem::operator== ( const QOrganizerItem &amp; <i>other</i> ) const</h3>
332
 
<p>Returns true if this organizer item is equal to the <i>other</i> organizer item, false if either the id or stored details are not the same</p>
 
329
<p>Returns true if this organizer item is equal to the <i>other</i> organizer item, false if either the id, collection id or stored details are not the same</p>
333
330
</div>
334
331
<hr />
335
332
<div class="relnonmem"/>
336
333
<h2>Related Non-Members</h2>
337
 
<h3 class="fn"><a name="qHash"></a>uint qHash ( const QOrganizerItem &amp; <i>key</i> )</h3>
 
334
<h3 class="fn"><a name="qHash-22"></a><a href="http://qt.nokia.com/doc/4.6/qtglobal.html#uint-typedef">uint</a> qHash ( const QOrganizerItem &amp; <i>key</i> )</h3>
338
335
<p>Returns the hash value for <i>key</i>.</p>
339
336
</div>
340
337
<hr />