Sophie

Sophie

distrib > Mandriva > 2008.1 > x86_64 > by-pkgid > 98d6b53e11e983e268c3e19f14e091a0 > files > 3797

kdepim-devel-doc-3.5.9-9mdv2008.1.x86_64.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">

<head>
  <title>libkcal: calendar.cpp Source File (libkcal)</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

  <meta http-equiv="Content-Style-Type" content="text/css" />

  <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org"  r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org"  r (n 0 s 0 v 0 l 0))' />

  <meta name="trademark" content="KDE e.V." />
  <meta name="description" content="K Desktop Environment Homepage, KDE.org" />
  <meta name="MSSmartTagsPreventParsing" content="true" />
  <meta name="robots" content="all" />

  <link rel="shortcut icon" href="../../favicon.ico" />

<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />



<style type="text/css">
<!--
hr { display: none; }
#content h2 { margin-left: 0px; }
table.mdTable { background-color: #f8f8f8; border: .2em solid #d7d7d7; }
td.mdRow { padding: 8px 20px; }
td.md { font-weight: bold; }
td.mdname1 { font-weight: bold; color: #602020; }
td.mdname { font-weight: bold; color: #602020;  }

-->
</style>

</head>

<body>

<div id="nav_header_top" align="right">
  <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>

  <a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
  <span class="doNotDisplay">::</span>
  <img id="nav_header_logo_right" alt="" align="right" src="../../pimlogo.png" border="0" />

  <div id="nav_header_title" align="left">KDE PIM API Reference</div>


</div>

<div id="nav_header_bottom" align="right">
  <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
  <div id="nav_header_bottom_left" style="text-align: left;">
/ <a href="../../">API Reference</a>
 / <a href=".">libkcal</a>
  </div>
</div>


<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
      <td valign="top" class="menuheader" height="0"></td>

  <td id="contentcolumn" valign="top" rowspan="2" >
    <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
    <h2><a name="content"></a>libkcal</h2>


<!-- Generated by Doxygen 1.5.5 -->
<h1>calendar.cpp</h1><a href="calendar_8cpp.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment">    This file is part of libkcal.</span>
<a name="l00003"></a>00003 <span class="comment"></span>
<a name="l00004"></a>00004 <span class="comment">    Copyright (c) 1998 Preston Brown &lt;pbrown@kde.org&gt;</span>
<a name="l00005"></a>00005 <span class="comment">    Copyright (c) 2000-2004 Cornelius Schumacher &lt;schumacher@kde.org&gt;</span>
<a name="l00006"></a>00006 <span class="comment">    Copyright (C) 2003-2004 Reinhold Kainhofer &lt;reinhold@kainhofer.com&gt;</span>
<a name="l00007"></a>00007 <span class="comment"></span>
<a name="l00008"></a>00008 <span class="comment">    This library is free software; you can redistribute it and/or</span>
<a name="l00009"></a>00009 <span class="comment">    modify it under the terms of the GNU Library General Public</span>
<a name="l00010"></a>00010 <span class="comment">    License as published by the Free Software Foundation; either</span>
<a name="l00011"></a>00011 <span class="comment">    version 2 of the License, or (at your option) any later version.</span>
<a name="l00012"></a>00012 <span class="comment"></span>
<a name="l00013"></a>00013 <span class="comment">    This library is distributed in the hope that it will be useful,</span>
<a name="l00014"></a>00014 <span class="comment">    but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00015"></a>00015 <span class="comment">    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU</span>
<a name="l00016"></a>00016 <span class="comment">    Library General Public License for more details.</span>
<a name="l00017"></a>00017 <span class="comment"></span>
<a name="l00018"></a>00018 <span class="comment">    You should have received a copy of the GNU Library General Public License</span>
<a name="l00019"></a>00019 <span class="comment">    along with this library; see the file COPYING.LIB.  If not, write to</span>
<a name="l00020"></a>00020 <span class="comment">    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span>
<a name="l00021"></a>00021 <span class="comment">    Boston, MA 02110-1301, USA.</span>
<a name="l00022"></a>00022 <span class="comment">*/</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;stdlib.h&gt;</span>
<a name="l00032"></a>00032 
<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00034"></a>00034 <span class="preprocessor">#include &lt;klocale.h&gt;</span>
<a name="l00035"></a>00035 
<a name="l00036"></a>00036 <span class="preprocessor">#include "exceptions.h"</span>
<a name="l00037"></a>00037 <span class="preprocessor">#include "calfilter.h"</span>
<a name="l00038"></a>00038 
<a name="l00039"></a>00039 <span class="preprocessor">#include "<a class="code" href="calendar_8h.html" title="Provides the main &amp;quot;calendar&amp;quot; object class.">calendar.h</a>"</span>
<a name="l00040"></a>00040 
<a name="l00041"></a>00041 <span class="keyword">using namespace </span>KCal;
<a name="l00042"></a>00042 
<a name="l00043"></a><a class="code" href="classKCal_1_1Calendar.html#be401584ee2230c13cf8cfe940b19705">00043</a> Calendar::Calendar( <span class="keyword">const</span> QString &amp;timeZoneId )
<a name="l00044"></a>00044 {
<a name="l00045"></a>00045   mTimeZoneId = timeZoneId;
<a name="l00046"></a>00046   mLocalTime = <span class="keyword">false</span>;
<a name="l00047"></a>00047 
<a name="l00048"></a>00048   init();
<a name="l00049"></a>00049 }
<a name="l00050"></a>00050 
<a name="l00051"></a>00051 <span class="keywordtype">void</span> Calendar::init()
<a name="l00052"></a>00052 {
<a name="l00053"></a>00053   mNewObserver = <span class="keyword">false</span>;
<a name="l00054"></a>00054   mObserversEnabled = <span class="keyword">true</span>;
<a name="l00055"></a>00055 
<a name="l00056"></a>00056   mModified = <span class="keyword">false</span>;
<a name="l00057"></a>00057 
<a name="l00058"></a>00058   <span class="comment">// Setup default filter, which does nothing</span>
<a name="l00059"></a>00059   mDefaultFilter = <span class="keyword">new</span> <a class="code" href="classKCal_1_1CalFilter.html" title="Filter for calendar objects.">CalFilter</a>;
<a name="l00060"></a>00060   mFilter = mDefaultFilter;
<a name="l00061"></a>00061   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#4305cfd809c66945e92bf62788acc50c" title="Enable or disable filter.">setEnabled</a>( <span class="keyword">false</span> );
<a name="l00062"></a>00062 
<a name="l00063"></a>00063   <span class="comment">// user information...</span>
<a name="l00064"></a>00064   <a class="code" href="classKCal_1_1Calendar.html#925a2840710a883015e5c809696c3b02" title="Set the owner of the Calendar.">setOwner</a>( <a class="code" href="classKCal_1_1Person.html" title="This class represents a person.">Person</a>( i18n( <span class="stringliteral">"Unknown Name"</span> ), i18n( <span class="stringliteral">"unknown@nowhere"</span> ) ) );
<a name="l00065"></a>00065 }
<a name="l00066"></a>00066 
<a name="l00067"></a><a class="code" href="classKCal_1_1Calendar.html#23aa939f694874a8f98ec54326d80741">00067</a> <a class="code" href="classKCal_1_1Calendar.html#23aa939f694874a8f98ec54326d80741" title="Destructor.">Calendar::~Calendar</a>()
<a name="l00068"></a>00068 {
<a name="l00069"></a>00069   <span class="keyword">delete</span> mDefaultFilter;
<a name="l00070"></a>00070 }
<a name="l00071"></a>00071 
<a name="l00072"></a><a class="code" href="classKCal_1_1Calendar.html#fa7adad09698d0c4ab4fe8f0746b162a">00072</a> <span class="keyword">const</span> <a class="code" href="classKCal_1_1Person.html" title="This class represents a person.">Person</a> &amp;<a class="code" href="classKCal_1_1Calendar.html#fa7adad09698d0c4ab4fe8f0746b162a" title="Get the owner of the Calendar.">Calendar::getOwner</a>()<span class="keyword"> const</span>
<a name="l00073"></a>00073 <span class="keyword"></span>{
<a name="l00074"></a>00074   <span class="keywordflow">return</span> mOwner;
<a name="l00075"></a>00075 }
<a name="l00076"></a>00076 
<a name="l00077"></a><a class="code" href="classKCal_1_1Calendar.html#925a2840710a883015e5c809696c3b02">00077</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#925a2840710a883015e5c809696c3b02" title="Set the owner of the Calendar.">Calendar::setOwner</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1Person.html" title="This class represents a person.">Person</a> &amp;owner )
<a name="l00078"></a>00078 {
<a name="l00079"></a>00079   mOwner = owner;
<a name="l00080"></a>00080 
<a name="l00081"></a>00081   <a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50" title="Set if the Calendar had been modified.">setModified</a>( <span class="keyword">true</span> );
<a name="l00082"></a>00082 }
<a name="l00083"></a>00083 
<a name="l00084"></a><a class="code" href="classKCal_1_1Calendar.html#0140baff3c473d4404bd5172fc1aad2f">00084</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#0140baff3c473d4404bd5172fc1aad2f" title="Set the Time Zone Id for the Calendar.">Calendar::setTimeZoneId</a>( <span class="keyword">const</span> QString &amp;<a class="code" href="classKCal_1_1Calendar.html#dbb33ceb6de6668520995b95b4fd646b" title="Get the Time Zone ID for the Calendar.">timeZoneId</a> )
<a name="l00085"></a>00085 {
<a name="l00086"></a>00086   mTimeZoneId = timeZoneId;
<a name="l00087"></a>00087   mLocalTime = <span class="keyword">false</span>;
<a name="l00088"></a>00088 
<a name="l00089"></a>00089   <a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50" title="Set if the Calendar had been modified.">setModified</a>( <span class="keyword">true</span> );
<a name="l00090"></a>00090   <a class="code" href="classKCal_1_1Calendar.html#8fc9cdb8baf049d4802354f0a7a62c2a" title="Let Calendar subclasses set the Time Zone ID.">doSetTimeZoneId</a>( timeZoneId );
<a name="l00091"></a>00091 }
<a name="l00092"></a>00092 
<a name="l00093"></a><a class="code" href="classKCal_1_1Calendar.html#dbb33ceb6de6668520995b95b4fd646b">00093</a> QString <a class="code" href="classKCal_1_1Calendar.html#dbb33ceb6de6668520995b95b4fd646b" title="Get the Time Zone ID for the Calendar.">Calendar::timeZoneId</a>()<span class="keyword"> const</span>
<a name="l00094"></a>00094 <span class="keyword"></span>{
<a name="l00095"></a>00095   <span class="keywordflow">return</span> mTimeZoneId;
<a name="l00096"></a>00096 }
<a name="l00097"></a>00097 
<a name="l00098"></a><a class="code" href="classKCal_1_1Calendar.html#0b40a2702da7b25bcfbbfbfeefe7c073">00098</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#0b40a2702da7b25bcfbbfbfeefe7c073" title="Set to store calendar Incidences without a time zone.">Calendar::setLocalTime</a>()
<a name="l00099"></a>00099 {
<a name="l00100"></a>00100   mLocalTime = <span class="keyword">true</span>;
<a name="l00101"></a>00101   mTimeZoneId = <span class="stringliteral">""</span>;
<a name="l00102"></a>00102 
<a name="l00103"></a>00103   <a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50" title="Set if the Calendar had been modified.">setModified</a>( <span class="keyword">true</span> );
<a name="l00104"></a>00104 }
<a name="l00105"></a>00105 
<a name="l00106"></a><a class="code" href="classKCal_1_1Calendar.html#d672afd42fca707c93af7ae9653b7f07">00106</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Calendar.html#d672afd42fca707c93af7ae9653b7f07" title="Determine if Calendar Incidences are to be written without a time zone.">Calendar::isLocalTime</a>()<span class="keyword"> const</span>
<a name="l00107"></a>00107 <span class="keyword"></span>{
<a name="l00108"></a>00108   <span class="keywordflow">return</span> mLocalTime;
<a name="l00109"></a>00109 }
<a name="l00110"></a>00110 
<a name="l00111"></a><a class="code" href="classKCal_1_1Calendar.html#46e84475e7efa21e96cdda8373eb44d6">00111</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#46e84475e7efa21e96cdda8373eb44d6" title="Set the Calendar filter.">Calendar::setFilter</a>( <a class="code" href="classKCal_1_1CalFilter.html" title="Filter for calendar objects.">CalFilter</a> *<a class="code" href="classKCal_1_1Calendar.html#7aa8780fde5754abc19e7616fc179a8e" title="Return the Calendar filter.">filter</a> )
<a name="l00112"></a>00112 {
<a name="l00113"></a>00113   <span class="keywordflow">if</span> ( filter ) {
<a name="l00114"></a>00114     mFilter = filter;
<a name="l00115"></a>00115   } <span class="keywordflow">else</span> {
<a name="l00116"></a>00116     mFilter = mDefaultFilter;
<a name="l00117"></a>00117   }
<a name="l00118"></a>00118 }
<a name="l00119"></a>00119 
<a name="l00120"></a><a class="code" href="classKCal_1_1Calendar.html#7aa8780fde5754abc19e7616fc179a8e">00120</a> <a class="code" href="classKCal_1_1CalFilter.html" title="Filter for calendar objects.">CalFilter</a> *<a class="code" href="classKCal_1_1Calendar.html#7aa8780fde5754abc19e7616fc179a8e" title="Return the Calendar filter.">Calendar::filter</a>()
<a name="l00121"></a>00121 {
<a name="l00122"></a>00122   <span class="keywordflow">return</span> mFilter;
<a name="l00123"></a>00123 }
<a name="l00124"></a>00124 
<a name="l00125"></a><a class="code" href="classKCal_1_1Calendar.html#52fa5a88f952cb279e85032a74be88d7">00125</a> QStringList <a class="code" href="classKCal_1_1Calendar.html#52fa5a88f952cb279e85032a74be88d7" title="Return a list of all categories used by Incidences in this Calendar.">Calendar::categories</a>()
<a name="l00126"></a>00126 {
<a name="l00127"></a>00127   Incidence::List rawInc( <a class="code" href="classKCal_1_1Calendar.html#310db8f95e7abc7f20a5293e1bbd9ebb" title="Return an unfiltered list of all Incidences for this Calendar.">rawIncidences</a>() );
<a name="l00128"></a>00128   QStringList cats, thisCats;
<a name="l00129"></a>00129   <span class="comment">// @TODO: For now just iterate over all incidences. In the future,</span>
<a name="l00130"></a>00130   <span class="comment">// the list of categories should be built when reading the file.</span>
<a name="l00131"></a>00131   <span class="keywordflow">for</span> ( Incidence::List::ConstIterator i = rawInc.constBegin();
<a name="l00132"></a>00132         i != rawInc.constEnd(); ++i ) {
<a name="l00133"></a>00133     thisCats = (*i)-&gt;categories();
<a name="l00134"></a>00134     <span class="keywordflow">for</span> ( QStringList::ConstIterator si = thisCats.constBegin();
<a name="l00135"></a>00135           si != thisCats.constEnd(); ++si ) {
<a name="l00136"></a>00136       <span class="keywordflow">if</span> ( cats.find( *si ) == cats.end() ) {
<a name="l00137"></a>00137         cats.append( *si );
<a name="l00138"></a>00138       }
<a name="l00139"></a>00139     }
<a name="l00140"></a>00140   }
<a name="l00141"></a>00141   <span class="keywordflow">return</span> cats;
<a name="l00142"></a>00142 }
<a name="l00143"></a>00143 
<a name="l00144"></a><a class="code" href="classKCal_1_1Calendar.html#180b9c153934e74d62eaeb9fd1472858">00144</a> Incidence::List <a class="code" href="classKCal_1_1Calendar.html#356d431a6e1e0cf73edff7183595a364" title="Return a filtered list of all Incidences for this Calendar.">Calendar::incidences</a>( <span class="keyword">const</span> QDate &amp;date )
<a name="l00145"></a>00145 {
<a name="l00146"></a>00146   <span class="keywordflow">return</span> <a class="code" href="classKCal_1_1Calendar.html#36c4effeca9bdb52630a0e8762e08bb3" title="Create a merged list of Events, Todos, and Journals.">mergeIncidenceList</a>( <a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">events</a>( date ), <a class="code" href="classKCal_1_1Calendar.html#ed7c816d2cede2558b5624e8a34ee745" title="Return a sorted, filtered list of all Todos for this Calendar.">todos</a>( date ), <a class="code" href="classKCal_1_1Calendar.html#c6b55e4bc2dcc1557b63ffd9273bd6bc" title="Return a sorted, filtered list of all Journals for this Calendar.">journals</a>( date ) );
<a name="l00147"></a>00147 }
<a name="l00148"></a>00148 
<a name="l00149"></a><a class="code" href="classKCal_1_1Calendar.html#356d431a6e1e0cf73edff7183595a364">00149</a> Incidence::List <a class="code" href="classKCal_1_1Calendar.html#356d431a6e1e0cf73edff7183595a364" title="Return a filtered list of all Incidences for this Calendar.">Calendar::incidences</a>()
<a name="l00150"></a>00150 {
<a name="l00151"></a>00151   <span class="keywordflow">return</span> <a class="code" href="classKCal_1_1Calendar.html#36c4effeca9bdb52630a0e8762e08bb3" title="Create a merged list of Events, Todos, and Journals.">mergeIncidenceList</a>( <a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">events</a>(), <a class="code" href="classKCal_1_1Calendar.html#ed7c816d2cede2558b5624e8a34ee745" title="Return a sorted, filtered list of all Todos for this Calendar.">todos</a>(), <a class="code" href="classKCal_1_1Calendar.html#c6b55e4bc2dcc1557b63ffd9273bd6bc" title="Return a sorted, filtered list of all Journals for this Calendar.">journals</a>() );
<a name="l00152"></a>00152 }
<a name="l00153"></a>00153 
<a name="l00154"></a><a class="code" href="classKCal_1_1Calendar.html#310db8f95e7abc7f20a5293e1bbd9ebb">00154</a> Incidence::List <a class="code" href="classKCal_1_1Calendar.html#310db8f95e7abc7f20a5293e1bbd9ebb" title="Return an unfiltered list of all Incidences for this Calendar.">Calendar::rawIncidences</a>()
<a name="l00155"></a>00155 {
<a name="l00156"></a>00156   <span class="keywordflow">return</span> <a class="code" href="classKCal_1_1Calendar.html#36c4effeca9bdb52630a0e8762e08bb3" title="Create a merged list of Events, Todos, and Journals.">mergeIncidenceList</a>( <a class="code" href="classKCal_1_1Calendar.html#a03685d1878387b4b39769a7b967a232" title="Return a sorted, unfiltered list of all Events for this Calendar.">rawEvents</a>(), <a class="code" href="classKCal_1_1Calendar.html#c95bdb0d0e9399280396d1ff26a8377d" title="Return a sorted, unfiltered list of all Todos for this Calendar.">rawTodos</a>(), <a class="code" href="classKCal_1_1Calendar.html#1aef8f405e800d00fd23d84ea33dacfc" title="Return a sorted, unfiltered list of all Journals for this Calendar.">rawJournals</a>() );
<a name="l00157"></a>00157 }
<a name="l00158"></a>00158 
<a name="l00159"></a><a class="code" href="classKCal_1_1Calendar.html#4d8122d0bcfc5d887e45d1f87338f2db">00159</a> Event::List <a class="code" href="classKCal_1_1Calendar.html#4d8122d0bcfc5d887e45d1f87338f2db" title="Sort a list of Events.">Calendar::sortEvents</a>( Event::List *eventList,
<a name="l00160"></a>00160                                   <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f21" title="How Events are to be sorted.">EventSortField</a> sortField,
<a name="l00161"></a>00161                                   <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00162"></a>00162 {
<a name="l00163"></a>00163   Event::List eventListSorted;
<a name="l00164"></a>00164   Event::List tempList, t;
<a name="l00165"></a>00165   Event::List alphaList;
<a name="l00166"></a>00166   Event::List::Iterator sortIt;
<a name="l00167"></a>00167   Event::List::Iterator eit;
<a name="l00168"></a>00168 
<a name="l00169"></a>00169   <span class="comment">// Notice we alphabetically presort Summaries first.</span>
<a name="l00170"></a>00170   <span class="comment">// We do this so comparison "ties" stay in a nice order.</span>
<a name="l00171"></a>00171 
<a name="l00172"></a>00172   <span class="keywordflow">switch</span>( sortField ) {
<a name="l00173"></a>00173   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f2149c21b422159cd5177829d82cc26c60a" title="Events are to be unsorted.">EventSortUnsorted</a>:
<a name="l00174"></a>00174     eventListSorted = *eventList;
<a name="l00175"></a>00175     <span class="keywordflow">break</span>;
<a name="l00176"></a>00176 
<a name="l00177"></a>00177   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f21a5bf5e1beb9afa58353a1ac2cc14d252" title="Sort Events chronologically, by start date.">EventSortStartDate</a>:
<a name="l00178"></a>00178     alphaList = <a class="code" href="classKCal_1_1Calendar.html#4d8122d0bcfc5d887e45d1f87338f2db" title="Sort a list of Events.">sortEvents</a>( eventList, <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f219f0af75b03b5c3f2cc4b9ba66e3c1735" title="Sort Events alphabetically, by summary.">EventSortSummary</a>, sortDirection );
<a name="l00179"></a>00179     <span class="keywordflow">for</span> ( eit = alphaList.begin(); eit != alphaList.end(); ++eit ) {
<a name="l00180"></a>00180       sortIt = eventListSorted.begin();
<a name="l00181"></a>00181       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00182"></a>00182         <span class="keywordflow">while</span> ( sortIt != eventListSorted.end() &amp;&amp;
<a name="l00183"></a>00183                 (*eit)-&gt;dtStart() &gt;= (*sortIt)-&gt;dtStart() ) {
<a name="l00184"></a>00184           ++sortIt;
<a name="l00185"></a>00185         }
<a name="l00186"></a>00186       } <span class="keywordflow">else</span> {
<a name="l00187"></a>00187         <span class="keywordflow">while</span> ( sortIt != eventListSorted.end() &amp;&amp;
<a name="l00188"></a>00188                 (*eit)-&gt;dtStart() &lt; (*sortIt)-&gt;dtStart() ) {
<a name="l00189"></a>00189           ++sortIt;
<a name="l00190"></a>00190         }
<a name="l00191"></a>00191       }
<a name="l00192"></a>00192       eventListSorted.insert( sortIt, *eit );
<a name="l00193"></a>00193     }
<a name="l00194"></a>00194     <span class="keywordflow">break</span>;
<a name="l00195"></a>00195 
<a name="l00196"></a>00196   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f21519b81424701f6ea29b7eb6c2704734c" title="Sort Events chronologically, by end date.">EventSortEndDate</a>:
<a name="l00197"></a>00197     alphaList = <a class="code" href="classKCal_1_1Calendar.html#4d8122d0bcfc5d887e45d1f87338f2db" title="Sort a list of Events.">sortEvents</a>( eventList, <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f219f0af75b03b5c3f2cc4b9ba66e3c1735" title="Sort Events alphabetically, by summary.">EventSortSummary</a>, sortDirection );
<a name="l00198"></a>00198     <span class="keywordflow">for</span> ( eit = alphaList.begin(); eit != alphaList.end(); ++eit ) {
<a name="l00199"></a>00199       <span class="keywordflow">if</span> ( (*eit)-&gt;hasEndDate() ) {
<a name="l00200"></a>00200         sortIt = eventListSorted.begin();
<a name="l00201"></a>00201         <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00202"></a>00202           <span class="keywordflow">while</span> ( sortIt != eventListSorted.end() &amp;&amp;
<a name="l00203"></a>00203                   (*eit)-&gt;dtEnd() &gt;= (*sortIt)-&gt;dtEnd() ) {
<a name="l00204"></a>00204             ++sortIt;
<a name="l00205"></a>00205           }
<a name="l00206"></a>00206         } <span class="keywordflow">else</span> {
<a name="l00207"></a>00207           <span class="keywordflow">while</span> ( sortIt != eventListSorted.end() &amp;&amp;
<a name="l00208"></a>00208                   (*eit)-&gt;dtEnd() &lt; (*sortIt)-&gt;dtEnd() ) {
<a name="l00209"></a>00209             ++sortIt;
<a name="l00210"></a>00210           }
<a name="l00211"></a>00211         }
<a name="l00212"></a>00212       } <span class="keywordflow">else</span> {
<a name="l00213"></a>00213         <span class="comment">// Keep a list of the Events without End DateTimes</span>
<a name="l00214"></a>00214         tempList.append( *eit );
<a name="l00215"></a>00215       }
<a name="l00216"></a>00216       eventListSorted.insert( sortIt, *eit );
<a name="l00217"></a>00217     }
<a name="l00218"></a>00218     <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00219"></a>00219       <span class="comment">// Append the list of Events without End DateTimes</span>
<a name="l00220"></a>00220       eventListSorted += tempList;
<a name="l00221"></a>00221     } <span class="keywordflow">else</span> {
<a name="l00222"></a>00222       <span class="comment">// Prepend the list of Events without End DateTimes</span>
<a name="l00223"></a>00223       tempList += eventListSorted;
<a name="l00224"></a>00224       eventListSorted = tempList;
<a name="l00225"></a>00225     }
<a name="l00226"></a>00226     <span class="keywordflow">break</span>;
<a name="l00227"></a>00227 
<a name="l00228"></a>00228   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f219f0af75b03b5c3f2cc4b9ba66e3c1735" title="Sort Events alphabetically, by summary.">EventSortSummary</a>:
<a name="l00229"></a>00229     <span class="keywordflow">for</span> ( eit = eventList-&gt;begin(); eit != eventList-&gt;end(); ++eit ) {
<a name="l00230"></a>00230       sortIt = eventListSorted.begin();
<a name="l00231"></a>00231       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00232"></a>00232         <span class="keywordflow">while</span> ( sortIt != eventListSorted.end() &amp;&amp;
<a name="l00233"></a>00233                 (*eit)-&gt;summary() &gt;= (*sortIt)-&gt;summary() ) {
<a name="l00234"></a>00234           ++sortIt;
<a name="l00235"></a>00235         }
<a name="l00236"></a>00236       } <span class="keywordflow">else</span> {
<a name="l00237"></a>00237         <span class="keywordflow">while</span> ( sortIt != eventListSorted.end() &amp;&amp;
<a name="l00238"></a>00238                 (*eit)-&gt;summary() &lt; (*sortIt)-&gt;summary() ) {
<a name="l00239"></a>00239           ++sortIt;
<a name="l00240"></a>00240         }
<a name="l00241"></a>00241       }
<a name="l00242"></a>00242       eventListSorted.insert( sortIt, *eit );
<a name="l00243"></a>00243     }
<a name="l00244"></a>00244     <span class="keywordflow">break</span>;
<a name="l00245"></a>00245   }
<a name="l00246"></a>00246 
<a name="l00247"></a>00247   <span class="keywordflow">return</span> eventListSorted;
<a name="l00248"></a>00248 
<a name="l00249"></a>00249 }
<a name="l00250"></a>00250 
<a name="l00251"></a><a class="code" href="classKCal_1_1Calendar.html#f35c75839e9fc4bc1d859ca0ce41a4f8">00251</a> Event::List <a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">Calendar::events</a>( <span class="keyword">const</span> QDate &amp;date,
<a name="l00252"></a>00252                               <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f21" title="How Events are to be sorted.">EventSortField</a> sortField,
<a name="l00253"></a>00253                               <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00254"></a>00254 {
<a name="l00255"></a>00255   Event::List el = <a class="code" href="classKCal_1_1Calendar.html#a8b9671ec5e4927a18459d75f2f9fe0a" title="Return an unfiltered list of all Events which occur on the given timestamp.">rawEventsForDate</a>( date, sortField, sortDirection );
<a name="l00256"></a>00256   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;el );
<a name="l00257"></a>00257   <span class="keywordflow">return</span> el;
<a name="l00258"></a>00258 }
<a name="l00259"></a>00259 
<a name="l00260"></a><a class="code" href="classKCal_1_1Calendar.html#cf1def752c84b1c50b2999848d6d6099">00260</a> Event::List <a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">Calendar::events</a>( <span class="keyword">const</span> QDateTime &amp;qdt )
<a name="l00261"></a>00261 {
<a name="l00262"></a>00262   Event::List el = <a class="code" href="classKCal_1_1Calendar.html#a8b9671ec5e4927a18459d75f2f9fe0a" title="Return an unfiltered list of all Events which occur on the given timestamp.">rawEventsForDate</a>( qdt );
<a name="l00263"></a>00263   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;el );
<a name="l00264"></a>00264   <span class="keywordflow">return</span> el;
<a name="l00265"></a>00265 }
<a name="l00266"></a>00266 
<a name="l00267"></a><a class="code" href="classKCal_1_1Calendar.html#ed7ca72440dffbe694f806b51c84c772">00267</a> Event::List <a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">Calendar::events</a>( <span class="keyword">const</span> QDate &amp;start, <span class="keyword">const</span> QDate &amp;end,
<a name="l00268"></a>00268                               <span class="keywordtype">bool</span> inclusive)
<a name="l00269"></a>00269 {
<a name="l00270"></a>00270   Event::List el = <a class="code" href="classKCal_1_1Calendar.html#a03685d1878387b4b39769a7b967a232" title="Return a sorted, unfiltered list of all Events for this Calendar.">rawEvents</a>( start, end, inclusive );
<a name="l00271"></a>00271   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;el );
<a name="l00272"></a>00272   <span class="keywordflow">return</span> el;
<a name="l00273"></a>00273 }
<a name="l00274"></a>00274 
<a name="l00275"></a><a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147">00275</a> Event::List <a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">Calendar::events</a>( <a class="code" href="namespaceKCal.html#4adb61b1b3687a67349254a53c7a2f21" title="How Events are to be sorted.">EventSortField</a> sortField,
<a name="l00276"></a>00276                               <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00277"></a>00277 {
<a name="l00278"></a>00278   Event::List el = <a class="code" href="classKCal_1_1Calendar.html#a03685d1878387b4b39769a7b967a232" title="Return a sorted, unfiltered list of all Events for this Calendar.">rawEvents</a>( sortField, sortDirection );
<a name="l00279"></a>00279   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;el );
<a name="l00280"></a>00280   <span class="keywordflow">return</span> el;
<a name="l00281"></a>00281 }
<a name="l00282"></a>00282 
<a name="l00283"></a><a class="code" href="classKCal_1_1Calendar.html#2c803568803bb1b6f584cdd38e754063">00283</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Calendar.html#2c803568803bb1b6f584cdd38e754063" title="Insert an Incidence into the Calendar.">Calendar::addIncidence</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">incidence</a> )
<a name="l00284"></a>00284 {
<a name="l00285"></a>00285   <a class="code" href="classKCal_1_1Incidence_1_1AddVisitor.html" title="This class implements a visitor for adding an Incidence to a resource supporting...">Incidence::AddVisitor&lt;Calendar&gt;</a> v( <span class="keyword">this</span> );
<a name="l00286"></a>00286 
<a name="l00287"></a>00287   <span class="keywordflow">return</span> incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#d99ad7b4b99e8de052ffaf8541590ff3" title="Accept IncidenceVisitor.">accept</a>(v);
<a name="l00288"></a>00288 }
<a name="l00289"></a>00289 
<a name="l00290"></a><a class="code" href="classKCal_1_1Calendar.html#4c46fd01ec4084eef9e7a92370adfad0">00290</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Calendar.html#4c46fd01ec4084eef9e7a92370adfad0" title="Remove an Incidence from the Calendar.">Calendar::deleteIncidence</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">incidence</a> )
<a name="l00291"></a>00291 {
<a name="l00292"></a>00292   <span class="keywordflow">if</span> ( <a class="code" href="classKCal_1_1Calendar.html#2d9343cfa7d5956749d13d764bee1623" title="Flag that a change to a Calendar Incidence is starting.">beginChange</a>( incidence ) ) {
<a name="l00293"></a>00293     <a class="code" href="classKCal_1_1Incidence_1_1DeleteVisitor.html" title="This class implements a visitor for deleting an Incidence from a resource supporting...">Incidence::DeleteVisitor&lt;Calendar&gt;</a> v( <span class="keyword">this</span> );
<a name="l00294"></a>00294     <span class="keywordtype">bool</span> result = incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#d99ad7b4b99e8de052ffaf8541590ff3" title="Accept IncidenceVisitor.">accept</a>( v );
<a name="l00295"></a>00295     <a class="code" href="classKCal_1_1Calendar.html#7e89faf167259c9f92c3702fdf53b89b" title="Flag that a change to a Calendar Incidence has completed.">endChange</a>( incidence );
<a name="l00296"></a>00296     <span class="keywordflow">return</span> result;
<a name="l00297"></a>00297   } <span class="keywordflow">else</span>
<a name="l00298"></a>00298     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00299"></a>00299 }
<a name="l00300"></a>00300 
<a name="l00304"></a><a class="code" href="classKCal_1_1Calendar.html#f62ea6d835b9e816156dc756e9e04051">00304</a> <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#f62ea6d835b9e816156dc756e9e04051" title="Dissociate an Incidence from a recurring Incidence.">Calendar::dissociateOccurrence</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">incidence</a>, QDate date,
<a name="l00305"></a>00305                                            <span class="keywordtype">bool</span> single )
<a name="l00306"></a>00306 {
<a name="l00307"></a>00307   <span class="keywordflow">if</span> ( !incidence || !incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#81ad15662138be07f0d55be6b075b043" title="Forward to Recurrence::doesRecur().">doesRecur</a>() )
<a name="l00308"></a>00308     <span class="keywordflow">return</span> 0;
<a name="l00309"></a>00309 
<a name="l00310"></a>00310   <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *newInc = incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#176e62775d8267e8fb8a0c745b154607" title="Return copy of this object.">clone</a>();
<a name="l00311"></a>00311   newInc-&gt;<a class="code" href="classKCal_1_1Incidence.html#2ab366525e4ea376c8bfe334c10a347a" title="Recreate event.">recreate</a>();
<a name="l00312"></a>00312   newInc-&gt;<a class="code" href="classKCal_1_1Incidence.html#3cb36283ad2b012e5bf9a769d13593ad" title="Point at some other event to which the event relates.">setRelatedTo</a>( incidence );
<a name="l00313"></a>00313   <a class="code" href="classKCal_1_1Recurrence.html" title="This class represents a recurrence rule for a calendar incidence.">Recurrence</a> *recur = newInc-&gt;<a class="code" href="classKCal_1_1Incidence.html#d06004593e064a37d08c96f9ae16735e" title="Return the recurrence rule associated with this incidence.">recurrence</a>();
<a name="l00314"></a>00314   <span class="keywordflow">if</span> ( single ) {
<a name="l00315"></a>00315     recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#c7ac3073c65bf590a97c87ed53301655" title="Removes all recurrence and exception rules and dates.">clear</a>();
<a name="l00316"></a>00316   } <span class="keywordflow">else</span> {
<a name="l00317"></a>00317     <span class="comment">// Adjust the recurrence for the future incidences. In particular</span>
<a name="l00318"></a>00318     <span class="comment">// adjust the "end after n occurrences" rules! "No end date" and "end by ..."</span>
<a name="l00319"></a>00319     <span class="comment">// don't need to be modified.</span>
<a name="l00320"></a>00320     <span class="keywordtype">int</span> duration = recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#54913d2f0a66bae406a7b11945919a00" title="Returns -1 if the event recurs infinitely, 0 if the end date is set, otherwise the...">duration</a>();
<a name="l00321"></a>00321     <span class="keywordflow">if</span> ( duration &gt; 0 ) {
<a name="l00322"></a>00322       <span class="keywordtype">int</span> doneduration = recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#fdec5d242ea438e8f7e02f50a4834a8a" title="Returns the number of recurrences up to and including the date/time specified.">durationTo</a>( date.addDays(-1) );
<a name="l00323"></a>00323       <span class="keywordflow">if</span> ( doneduration &gt;= duration ) {
<a name="l00324"></a>00324         kdDebug(5850) &lt;&lt; <span class="stringliteral">"The dissociated event already occurred more often "</span>
<a name="l00325"></a>00325                       &lt;&lt; <span class="stringliteral">"than it was supposed to ever occur. ERROR!"</span> &lt;&lt; endl;
<a name="l00326"></a>00326         recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#c7ac3073c65bf590a97c87ed53301655" title="Removes all recurrence and exception rules and dates.">clear</a>();
<a name="l00327"></a>00327       } <span class="keywordflow">else</span> {
<a name="l00328"></a>00328         recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#f2d673a2430023d57e8f940cbbcd186a" title="Sets the total number of times the event is to occur, including both the first and...">setDuration</a>( duration - doneduration );
<a name="l00329"></a>00329       }
<a name="l00330"></a>00330     }
<a name="l00331"></a>00331   }
<a name="l00332"></a>00332   <span class="comment">// Adjust the date of the incidence</span>
<a name="l00333"></a>00333   <span class="keywordflow">if</span> ( incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#7981c13389e270b9e3e06a79d8564d5b">type</a>() == <span class="stringliteral">"Event"</span> ) {
<a name="l00334"></a>00334     <a class="code" href="classKCal_1_1Event.html" title="This class provides an Event in the sense of RFC2445.">Event</a> *ev = <span class="keyword">static_cast&lt;</span><a class="code" href="classKCal_1_1Event.html" title="This class provides an Event in the sense of RFC2445.">Event</a> *<span class="keyword">&gt;</span>( newInc );
<a name="l00335"></a>00335     QDateTime start( ev-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#5419a946a4e5715a0c34ec2c7e04cd9b" title="returns an event&amp;#39;s starting date/time as a QDateTime.">dtStart</a>() );
<a name="l00336"></a>00336     <span class="keywordtype">int</span> daysTo = start.date().daysTo( date );
<a name="l00337"></a>00337     ev-&gt;<a class="code" href="classKCal_1_1Incidence.html#e3042339856d8295139b32fc40064876" title="Set starting date/time.">setDtStart</a>( start.addDays( daysTo ) );
<a name="l00338"></a>00338     ev-&gt;<a class="code" href="classKCal_1_1Event.html#0d6840be8adf1a8fd37617ecf3da535b" title="Set end date and time.">setDtEnd</a>( ev-&gt;<a class="code" href="classKCal_1_1Event.html#0bc3052d40d160c7d58a5483dfcff693" title="Return end date and time.">dtEnd</a>().addDays( daysTo ) );
<a name="l00339"></a>00339   } <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#7981c13389e270b9e3e06a79d8564d5b">type</a>() == <span class="stringliteral">"Todo"</span> ) {
<a name="l00340"></a>00340     <a class="code" href="classKCal_1_1Todo.html" title="This class provides a Todo in the sense of RFC2445.">Todo</a> *td = <span class="keyword">static_cast&lt;</span><a class="code" href="classKCal_1_1Todo.html" title="This class provides a Todo in the sense of RFC2445.">Todo</a> *<span class="keyword">&gt;</span>( newInc );
<a name="l00341"></a>00341     <span class="keywordtype">bool</span> haveOffset = <span class="keyword">false</span>;
<a name="l00342"></a>00342     <span class="keywordtype">int</span> daysTo = 0;
<a name="l00343"></a>00343     <span class="keywordflow">if</span> ( td-&gt;<a class="code" href="classKCal_1_1Todo.html#a40c65f6e9024015f7546e8749436b12" title="Returns true if the todo has a due date, otherwise return false.">hasDueDate</a>() ) {
<a name="l00344"></a>00344       QDateTime due( td-&gt;<a class="code" href="classKCal_1_1Todo.html#09d6933ae42390339b27053faee3afec" title="Returns due date and time.">dtDue</a>() );
<a name="l00345"></a>00345       daysTo = due.date().daysTo( date );
<a name="l00346"></a>00346       td-&gt;<a class="code" href="classKCal_1_1Todo.html#68e50e47f65def4d8d58a68423952ddb" title="Sets due date and time.">setDtDue</a>( due.addDays( daysTo ), true );
<a name="l00347"></a>00347       haveOffset = <span class="keyword">true</span>;
<a name="l00348"></a>00348     }
<a name="l00349"></a>00349     <span class="keywordflow">if</span> ( td-&gt;<a class="code" href="classKCal_1_1Todo.html#1fb5a233b65e2c35f9cb03460bb68c30" title="Returns true if the todo has a start date, otherwise return false.">hasStartDate</a>() ) {
<a name="l00350"></a>00350       QDateTime start( td-&gt;<a class="code" href="classKCal_1_1Todo.html#30769e5e8bdc066ed4d92c68fb47c833" title="Returns the startdate of the todo.">dtStart</a>() );
<a name="l00351"></a>00351       <span class="keywordflow">if</span> ( !haveOffset )
<a name="l00352"></a>00352         daysTo = start.date().daysTo( date );
<a name="l00353"></a>00353       td-&gt;<a class="code" href="classKCal_1_1Todo.html#9b43603d86bf520cb5abcc686e8d1712" title="Sets the startdate of the todo.">setDtStart</a>( start.addDays( daysTo ) );
<a name="l00354"></a>00354       haveOffset = <span class="keyword">true</span>;
<a name="l00355"></a>00355     }
<a name="l00356"></a>00356   }
<a name="l00357"></a>00357   recur = incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#d06004593e064a37d08c96f9ae16735e" title="Return the recurrence rule associated with this incidence.">recurrence</a>();
<a name="l00358"></a>00358   <span class="keywordflow">if</span> ( recur ) {
<a name="l00359"></a>00359     <span class="keywordflow">if</span> ( single ) {
<a name="l00360"></a>00360       recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#12d7d0347442011c30b8152cfb429580">addExDate</a>( date );
<a name="l00361"></a>00361     } <span class="keywordflow">else</span> {
<a name="l00362"></a>00362       <span class="comment">// Make sure the recurrence of the past events ends</span>
<a name="l00363"></a>00363       <span class="comment">// at the corresponding day</span>
<a name="l00364"></a>00364       recur-&gt;<a class="code" href="classKCal_1_1Recurrence.html#bc15a53c9b3ffd469ee5b15c071da2f8" title="Sets the date of the last recurrence.">setEndDate</a>( date.addDays(-1) );
<a name="l00365"></a>00365     }
<a name="l00366"></a>00366   }
<a name="l00367"></a>00367   <span class="keywordflow">return</span> newInc;
<a name="l00368"></a>00368 }
<a name="l00369"></a>00369 
<a name="l00370"></a><a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4">00370</a> <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">Calendar::incidence</a>( <span class="keyword">const</span> QString &amp;uid )
<a name="l00371"></a>00371 {
<a name="l00372"></a>00372   <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *i = <a class="code" href="classKCal_1_1Calendar.html#79496465b9954a2e032805dcee3348a9" title="Returns the Event associated with the given unique identifier.">event</a>( uid );
<a name="l00373"></a>00373   <span class="keywordflow">if</span> ( i )
<a name="l00374"></a>00374     <span class="keywordflow">return</span> i;
<a name="l00375"></a>00375   i = <a class="code" href="classKCal_1_1Calendar.html#7130bd9ec592f5d1538b4d0b3f1b1332" title="Returns the Todo associated with the given unique identifier.">todo</a>( uid );
<a name="l00376"></a>00376   <span class="keywordflow">if</span> ( i )
<a name="l00377"></a>00377     <span class="keywordflow">return</span> i;
<a name="l00378"></a>00378   i = <a class="code" href="classKCal_1_1Calendar.html#9fa973297b596cd4dc32c184b8bb9d4d" title="Returns the Journal associated with the given unique identifier.">journal</a>( uid );
<a name="l00379"></a>00379   <span class="keywordflow">return</span> i;
<a name="l00380"></a>00380 }
<a name="l00381"></a>00381 
<a name="l00382"></a><a class="code" href="classKCal_1_1Calendar.html#234a3ff942596c433f63b637b9320bfb">00382</a> Incidence::List <a class="code" href="classKCal_1_1Calendar.html#234a3ff942596c433f63b637b9320bfb" title="Searches all events and todos for (an incidence with this scheduling ID.">Calendar::incidencesFromSchedulingID</a>( <span class="keyword">const</span> QString &amp;UID )
<a name="l00383"></a>00383 {
<a name="l00384"></a>00384   Incidence::List result;
<a name="l00385"></a>00385   Incidence::List <a class="code" href="classKCal_1_1Calendar.html#356d431a6e1e0cf73edff7183595a364" title="Return a filtered list of all Incidences for this Calendar.">incidences</a> = <a class="code" href="classKCal_1_1Calendar.html#310db8f95e7abc7f20a5293e1bbd9ebb" title="Return an unfiltered list of all Incidences for this Calendar.">rawIncidences</a>();
<a name="l00386"></a>00386   Incidence::List::iterator it = incidences.begin();
<a name="l00387"></a>00387   <span class="keywordflow">for</span> ( ; it != incidences.end(); ++it )
<a name="l00388"></a>00388     <span class="keywordflow">if</span> ( (*it)-&gt;schedulingID() == UID )
<a name="l00389"></a>00389       result.append( *it );
<a name="l00390"></a>00390   <span class="keywordflow">return</span> result;
<a name="l00391"></a>00391 }
<a name="l00392"></a>00392 
<a name="l00393"></a><a class="code" href="classKCal_1_1Calendar.html#cade42c20df980aec35db34a484deaed">00393</a> <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#cade42c20df980aec35db34a484deaed" title="Returns the Incidence associated with the given scheduling identifier.">Calendar::incidenceFromSchedulingID</a>( <span class="keyword">const</span> QString &amp;UID )
<a name="l00394"></a>00394 {
<a name="l00395"></a>00395   Incidence::List <a class="code" href="classKCal_1_1Calendar.html#356d431a6e1e0cf73edff7183595a364" title="Return a filtered list of all Incidences for this Calendar.">incidences</a> = <a class="code" href="classKCal_1_1Calendar.html#310db8f95e7abc7f20a5293e1bbd9ebb" title="Return an unfiltered list of all Incidences for this Calendar.">rawIncidences</a>();
<a name="l00396"></a>00396   Incidence::List::iterator it = incidences.begin();
<a name="l00397"></a>00397   <span class="keywordflow">for</span> ( ; it != incidences.end(); ++it )
<a name="l00398"></a>00398     <span class="keywordflow">if</span> ( (*it)-&gt;schedulingID() == UID )
<a name="l00399"></a>00399       <span class="comment">// Touchdown, and the crowd goes wild</span>
<a name="l00400"></a>00400       <span class="keywordflow">return</span> *it;
<a name="l00401"></a>00401   <span class="comment">// Not found</span>
<a name="l00402"></a>00402   <span class="keywordflow">return</span> 0;
<a name="l00403"></a>00403 }
<a name="l00404"></a>00404 
<a name="l00405"></a><a class="code" href="classKCal_1_1Calendar.html#040242aba6a4b11c00d8a34fb8f7d8d2">00405</a> Todo::List <a class="code" href="classKCal_1_1Calendar.html#040242aba6a4b11c00d8a34fb8f7d8d2" title="Sort a list of Todos.">Calendar::sortTodos</a>( Todo::List *todoList,
<a name="l00406"></a>00406                                 <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a082162" title="How Todos are to be sorted.">TodoSortField</a> sortField,
<a name="l00407"></a>00407                                 <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00408"></a>00408 {
<a name="l00409"></a>00409   Todo::List todoListSorted;
<a name="l00410"></a>00410   Todo::List tempList, t;
<a name="l00411"></a>00411   Todo::List alphaList;
<a name="l00412"></a>00412   Todo::List::Iterator sortIt;
<a name="l00413"></a>00413   Todo::List::Iterator eit;
<a name="l00414"></a>00414 
<a name="l00415"></a>00415   <span class="comment">// Notice we alphabetically presort Summaries first.</span>
<a name="l00416"></a>00416   <span class="comment">// We do this so comparison "ties" stay in a nice order.</span>
<a name="l00417"></a>00417 
<a name="l00418"></a>00418   <span class="comment">// Note that Todos may not have Start DateTimes nor due DateTimes.</span>
<a name="l00419"></a>00419 
<a name="l00420"></a>00420   <span class="keywordflow">switch</span>( sortField ) {
<a name="l00421"></a>00421   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a082162fdf0036a5925152f1d32af707fd503a3" title="Todos are to be unsorted.">TodoSortUnsorted</a>:
<a name="l00422"></a>00422     todoListSorted = *todoList;
<a name="l00423"></a>00423     <span class="keywordflow">break</span>;
<a name="l00424"></a>00424 
<a name="l00425"></a>00425   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a082162c3e473392609db03bb6783ccccfaa462" title="Sort Todos chronologically, by start date.">TodoSortStartDate</a>:
<a name="l00426"></a>00426     alphaList = <a class="code" href="classKCal_1_1Calendar.html#040242aba6a4b11c00d8a34fb8f7d8d2" title="Sort a list of Todos.">sortTodos</a>( todoList, <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a08216221e758adaae09115e016779c902cb7a7" title="Sort Todos alphabetically, by summary.">TodoSortSummary</a>, sortDirection );
<a name="l00427"></a>00427     <span class="keywordflow">for</span> ( eit = alphaList.begin(); eit != alphaList.end(); ++eit ) {
<a name="l00428"></a>00428       <span class="keywordflow">if</span> ( (*eit)-&gt;hasStartDate() ) {
<a name="l00429"></a>00429         sortIt = todoListSorted.begin();
<a name="l00430"></a>00430         <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00431"></a>00431           <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00432"></a>00432                   (*eit)-&gt;dtStart() &gt;= (*sortIt)-&gt;dtStart() ) {
<a name="l00433"></a>00433             ++sortIt;
<a name="l00434"></a>00434           }
<a name="l00435"></a>00435         } <span class="keywordflow">else</span> {
<a name="l00436"></a>00436           <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00437"></a>00437                   (*eit)-&gt;dtStart() &lt; (*sortIt)-&gt;dtStart() ) {
<a name="l00438"></a>00438             ++sortIt;
<a name="l00439"></a>00439           }
<a name="l00440"></a>00440         }
<a name="l00441"></a>00441         todoListSorted.insert( sortIt, *eit );
<a name="l00442"></a>00442       } <span class="keywordflow">else</span> {
<a name="l00443"></a>00443         <span class="comment">// Keep a list of the Todos without Start DateTimes</span>
<a name="l00444"></a>00444         tempList.append( *eit );
<a name="l00445"></a>00445       }
<a name="l00446"></a>00446     }
<a name="l00447"></a>00447     <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00448"></a>00448       <span class="comment">// Append the list of Todos without Start DateTimes</span>
<a name="l00449"></a>00449       todoListSorted += tempList;
<a name="l00450"></a>00450     } <span class="keywordflow">else</span> {
<a name="l00451"></a>00451       <span class="comment">// Prepend the list of Todos without Start DateTimes</span>
<a name="l00452"></a>00452       tempList += todoListSorted;
<a name="l00453"></a>00453       todoListSorted = tempList;
<a name="l00454"></a>00454     }
<a name="l00455"></a>00455     <span class="keywordflow">break</span>;
<a name="l00456"></a>00456 
<a name="l00457"></a>00457   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a08216228a8153d2fafc0ff73062b91076b8272" title="Sort Todos chronologically, by due date.">TodoSortDueDate</a>:
<a name="l00458"></a>00458     alphaList = <a class="code" href="classKCal_1_1Calendar.html#040242aba6a4b11c00d8a34fb8f7d8d2" title="Sort a list of Todos.">sortTodos</a>( todoList, <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a08216221e758adaae09115e016779c902cb7a7" title="Sort Todos alphabetically, by summary.">TodoSortSummary</a>, sortDirection );
<a name="l00459"></a>00459     <span class="keywordflow">for</span> ( eit = alphaList.begin(); eit != alphaList.end(); ++eit ) {
<a name="l00460"></a>00460       <span class="keywordflow">if</span> ( (*eit)-&gt;hasDueDate() ) {
<a name="l00461"></a>00461         sortIt = todoListSorted.begin();
<a name="l00462"></a>00462         <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00463"></a>00463           <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00464"></a>00464                   (*eit)-&gt;dtDue() &gt;= (*sortIt)-&gt;dtDue() ) {
<a name="l00465"></a>00465             ++sortIt;
<a name="l00466"></a>00466           }
<a name="l00467"></a>00467         } <span class="keywordflow">else</span> {
<a name="l00468"></a>00468           <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00469"></a>00469                   (*eit)-&gt;dtDue() &lt; (*sortIt)-&gt;dtDue() ) {
<a name="l00470"></a>00470             ++sortIt;
<a name="l00471"></a>00471           }
<a name="l00472"></a>00472         }
<a name="l00473"></a>00473         todoListSorted.insert( sortIt, *eit );
<a name="l00474"></a>00474       } <span class="keywordflow">else</span> {
<a name="l00475"></a>00475         <span class="comment">// Keep a list of the Todos without Due DateTimes</span>
<a name="l00476"></a>00476         tempList.append( *eit );
<a name="l00477"></a>00477       }
<a name="l00478"></a>00478     }
<a name="l00479"></a>00479     <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00480"></a>00480       <span class="comment">// Append the list of Todos without Due DateTimes</span>
<a name="l00481"></a>00481       todoListSorted += tempList;
<a name="l00482"></a>00482     } <span class="keywordflow">else</span> {
<a name="l00483"></a>00483       <span class="comment">// Prepend the list of Todos without Due DateTimes</span>
<a name="l00484"></a>00484       tempList += todoListSorted;
<a name="l00485"></a>00485       todoListSorted = tempList;
<a name="l00486"></a>00486     }
<a name="l00487"></a>00487     <span class="keywordflow">break</span>;
<a name="l00488"></a>00488 
<a name="l00489"></a>00489   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a0821625210f4a2b79838bf82079c869a5662ab" title="Sort Todos by priority.">TodoSortPriority</a>:
<a name="l00490"></a>00490     alphaList = <a class="code" href="classKCal_1_1Calendar.html#040242aba6a4b11c00d8a34fb8f7d8d2" title="Sort a list of Todos.">sortTodos</a>( todoList, <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a08216221e758adaae09115e016779c902cb7a7" title="Sort Todos alphabetically, by summary.">TodoSortSummary</a>, sortDirection );
<a name="l00491"></a>00491     <span class="keywordflow">for</span> ( eit = alphaList.begin(); eit != alphaList.end(); ++eit ) {
<a name="l00492"></a>00492       sortIt = todoListSorted.begin();
<a name="l00493"></a>00493       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00494"></a>00494         <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00495"></a>00495                 (*eit)-&gt;priority() &gt;= (*sortIt)-&gt;priority() ) {
<a name="l00496"></a>00496           ++sortIt;
<a name="l00497"></a>00497         }
<a name="l00498"></a>00498       } <span class="keywordflow">else</span> {
<a name="l00499"></a>00499         <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00500"></a>00500                 (*eit)-&gt;priority() &lt; (*sortIt)-&gt;priority() ) {
<a name="l00501"></a>00501           ++sortIt;
<a name="l00502"></a>00502         }
<a name="l00503"></a>00503       }
<a name="l00504"></a>00504       todoListSorted.insert( sortIt, *eit );
<a name="l00505"></a>00505     }
<a name="l00506"></a>00506     <span class="keywordflow">break</span>;
<a name="l00507"></a>00507 
<a name="l00508"></a>00508   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a0821626d453f8c2644b687428f4f906d9596ba" title="Sort Todos by percentage completed.">TodoSortPercentComplete</a>:
<a name="l00509"></a>00509     alphaList = <a class="code" href="classKCal_1_1Calendar.html#040242aba6a4b11c00d8a34fb8f7d8d2" title="Sort a list of Todos.">sortTodos</a>( todoList, <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a08216221e758adaae09115e016779c902cb7a7" title="Sort Todos alphabetically, by summary.">TodoSortSummary</a>, sortDirection );
<a name="l00510"></a>00510     <span class="keywordflow">for</span> ( eit = alphaList.begin(); eit != alphaList.end(); ++eit ) {
<a name="l00511"></a>00511       sortIt = todoListSorted.begin();
<a name="l00512"></a>00512       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00513"></a>00513         <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00514"></a>00514                 (*eit)-&gt;percentComplete() &gt;= (*sortIt)-&gt;percentComplete() ) {
<a name="l00515"></a>00515           ++sortIt;
<a name="l00516"></a>00516         }
<a name="l00517"></a>00517       } <span class="keywordflow">else</span> {
<a name="l00518"></a>00518         <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00519"></a>00519                 (*eit)-&gt;percentComplete() &lt; (*sortIt)-&gt;percentComplete() ) {
<a name="l00520"></a>00520           ++sortIt;
<a name="l00521"></a>00521         }
<a name="l00522"></a>00522       }
<a name="l00523"></a>00523       todoListSorted.insert( sortIt, *eit );
<a name="l00524"></a>00524     }
<a name="l00525"></a>00525     <span class="keywordflow">break</span>;
<a name="l00526"></a>00526 
<a name="l00527"></a>00527   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a08216221e758adaae09115e016779c902cb7a7" title="Sort Todos alphabetically, by summary.">TodoSortSummary</a>:
<a name="l00528"></a>00528     <span class="keywordflow">for</span> ( eit = todoList-&gt;begin(); eit != todoList-&gt;end(); ++eit ) {
<a name="l00529"></a>00529       sortIt = todoListSorted.begin();
<a name="l00530"></a>00530       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00531"></a>00531         <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00532"></a>00532                 (*eit)-&gt;summary() &gt;= (*sortIt)-&gt;summary() ) {
<a name="l00533"></a>00533           ++sortIt;
<a name="l00534"></a>00534         }
<a name="l00535"></a>00535       } <span class="keywordflow">else</span> {
<a name="l00536"></a>00536         <span class="keywordflow">while</span> ( sortIt != todoListSorted.end() &amp;&amp;
<a name="l00537"></a>00537                 (*eit)-&gt;summary() &lt; (*sortIt)-&gt;summary() ) {
<a name="l00538"></a>00538           ++sortIt;
<a name="l00539"></a>00539         }
<a name="l00540"></a>00540       }
<a name="l00541"></a>00541       todoListSorted.insert( sortIt, *eit );
<a name="l00542"></a>00542     }
<a name="l00543"></a>00543     <span class="keywordflow">break</span>;
<a name="l00544"></a>00544   }
<a name="l00545"></a>00545 
<a name="l00546"></a>00546   <span class="keywordflow">return</span> todoListSorted;
<a name="l00547"></a>00547 }
<a name="l00548"></a>00548 
<a name="l00549"></a><a class="code" href="classKCal_1_1Calendar.html#ed7c816d2cede2558b5624e8a34ee745">00549</a> Todo::List <a class="code" href="classKCal_1_1Calendar.html#ed7c816d2cede2558b5624e8a34ee745" title="Return a sorted, filtered list of all Todos for this Calendar.">Calendar::todos</a>( <a class="code" href="namespaceKCal.html#055336d90bea8a2c86fde0d94a082162" title="How Todos are to be sorted.">TodoSortField</a> sortField,
<a name="l00550"></a>00550                             <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00551"></a>00551 {
<a name="l00552"></a>00552   Todo::List tl = <a class="code" href="classKCal_1_1Calendar.html#c95bdb0d0e9399280396d1ff26a8377d" title="Return a sorted, unfiltered list of all Todos for this Calendar.">rawTodos</a>( sortField, sortDirection );
<a name="l00553"></a>00553   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;tl );
<a name="l00554"></a>00554   <span class="keywordflow">return</span> tl;
<a name="l00555"></a>00555 }
<a name="l00556"></a>00556 
<a name="l00557"></a><a class="code" href="classKCal_1_1Calendar.html#46a1fe0c57d4480c7b0b6ca1a009aaa2">00557</a> Todo::List <a class="code" href="classKCal_1_1Calendar.html#ed7c816d2cede2558b5624e8a34ee745" title="Return a sorted, filtered list of all Todos for this Calendar.">Calendar::todos</a>( <span class="keyword">const</span> QDate &amp;date )
<a name="l00558"></a>00558 {
<a name="l00559"></a>00559   Todo::List el = <a class="code" href="classKCal_1_1Calendar.html#0c9a6c03166e1b3989c57600da03033f" title="Return an unfiltered list of all Todos which due on the specified date.">rawTodosForDate</a>( date );
<a name="l00560"></a>00560   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;el );
<a name="l00561"></a>00561   <span class="keywordflow">return</span> el;
<a name="l00562"></a>00562 }
<a name="l00563"></a>00563 
<a name="l00564"></a><a class="code" href="classKCal_1_1Calendar.html#f24bc42d73c155856f99e8cb3a03bc1b">00564</a> Journal::List <a class="code" href="classKCal_1_1Calendar.html#f24bc42d73c155856f99e8cb3a03bc1b" title="Sort a list of Journals.">Calendar::sortJournals</a>( Journal::List *journalList,
<a name="l00565"></a>00565                                       <a class="code" href="namespaceKCal.html#12e348070fafa27c28e3291db357317f" title="How Journals are to be sorted.">JournalSortField</a> sortField,
<a name="l00566"></a>00566                                       <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00567"></a>00567 {
<a name="l00568"></a>00568   Journal::List journalListSorted;
<a name="l00569"></a>00569   Journal::List::Iterator sortIt;
<a name="l00570"></a>00570   Journal::List::Iterator eit;
<a name="l00571"></a>00571 
<a name="l00572"></a>00572   <span class="keywordflow">switch</span>( sortField ) {
<a name="l00573"></a>00573   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#12e348070fafa27c28e3291db357317f6a44efbfad0602bc6dc79d5941004742" title="Journals are to be unsorted.">JournalSortUnsorted</a>:
<a name="l00574"></a>00574     journalListSorted = *journalList;
<a name="l00575"></a>00575     <span class="keywordflow">break</span>;
<a name="l00576"></a>00576 
<a name="l00577"></a>00577   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#12e348070fafa27c28e3291db357317fe94f91ec8a162898dfc7da9613919a06" title="Sort Journals chronologically by date.">JournalSortDate</a>:
<a name="l00578"></a>00578     <span class="keywordflow">for</span> ( eit = journalList-&gt;begin(); eit != journalList-&gt;end(); ++eit ) {
<a name="l00579"></a>00579       sortIt = journalListSorted.begin();
<a name="l00580"></a>00580       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00581"></a>00581         <span class="keywordflow">while</span> ( sortIt != journalListSorted.end() &amp;&amp;
<a name="l00582"></a>00582                 (*eit)-&gt;dtStart() &gt;= (*sortIt)-&gt;dtStart() ) {
<a name="l00583"></a>00583           ++sortIt;
<a name="l00584"></a>00584         }
<a name="l00585"></a>00585       } <span class="keywordflow">else</span> {
<a name="l00586"></a>00586         <span class="keywordflow">while</span> ( sortIt != journalListSorted.end() &amp;&amp;
<a name="l00587"></a>00587                 (*eit)-&gt;dtStart() &lt; (*sortIt)-&gt;dtStart() ) {
<a name="l00588"></a>00588           ++sortIt;
<a name="l00589"></a>00589         }
<a name="l00590"></a>00590       }
<a name="l00591"></a>00591       journalListSorted.insert( sortIt, *eit );
<a name="l00592"></a>00592     }
<a name="l00593"></a>00593     <span class="keywordflow">break</span>;
<a name="l00594"></a>00594 
<a name="l00595"></a>00595   <span class="keywordflow">case</span> <a class="code" href="namespaceKCal.html#12e348070fafa27c28e3291db357317ff52a8c51c962bfdd6a8083169f1eaa6b" title="Sort Journals alphabetically, by summary.">JournalSortSummary</a>:
<a name="l00596"></a>00596     <span class="keywordflow">for</span> ( eit = journalList-&gt;begin(); eit != journalList-&gt;end(); ++eit ) {
<a name="l00597"></a>00597       sortIt = journalListSorted.begin();
<a name="l00598"></a>00598       <span class="keywordflow">if</span> ( sortDirection == <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb676513f25b5ee7c6f59ab9bb9188f937a0b4" title="Sort in ascending order (first to last).">SortDirectionAscending</a> ) {
<a name="l00599"></a>00599         <span class="keywordflow">while</span> ( sortIt != journalListSorted.end() &amp;&amp;
<a name="l00600"></a>00600                 (*eit)-&gt;summary() &gt;= (*sortIt)-&gt;summary() ) {
<a name="l00601"></a>00601           ++sortIt;
<a name="l00602"></a>00602         }
<a name="l00603"></a>00603       } <span class="keywordflow">else</span> {
<a name="l00604"></a>00604         <span class="keywordflow">while</span> ( sortIt != journalListSorted.end() &amp;&amp;
<a name="l00605"></a>00605                 (*eit)-&gt;summary() &lt; (*sortIt)-&gt;summary() ) {
<a name="l00606"></a>00606           ++sortIt;
<a name="l00607"></a>00607         }
<a name="l00608"></a>00608       }
<a name="l00609"></a>00609       journalListSorted.insert( sortIt, *eit );
<a name="l00610"></a>00610     }
<a name="l00611"></a>00611     <span class="keywordflow">break</span>;
<a name="l00612"></a>00612   }
<a name="l00613"></a>00613 
<a name="l00614"></a>00614   <span class="keywordflow">return</span> journalListSorted;
<a name="l00615"></a>00615 }
<a name="l00616"></a>00616 
<a name="l00617"></a><a class="code" href="classKCal_1_1Calendar.html#c6b55e4bc2dcc1557b63ffd9273bd6bc">00617</a> Journal::List <a class="code" href="classKCal_1_1Calendar.html#c6b55e4bc2dcc1557b63ffd9273bd6bc" title="Return a sorted, filtered list of all Journals for this Calendar.">Calendar::journals</a>( <a class="code" href="namespaceKCal.html#12e348070fafa27c28e3291db357317f" title="How Journals are to be sorted.">JournalSortField</a> sortField,
<a name="l00618"></a>00618                                   <a class="code" href="namespaceKCal.html#b79dc8179fdc021ae82c321b08fb6765" title="Sort direction.">SortDirection</a> sortDirection )
<a name="l00619"></a>00619 {
<a name="l00620"></a>00620   Journal::List jl = <a class="code" href="classKCal_1_1Calendar.html#1aef8f405e800d00fd23d84ea33dacfc" title="Return a sorted, unfiltered list of all Journals for this Calendar.">rawJournals</a>( sortField, sortDirection );
<a name="l00621"></a>00621   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;jl );
<a name="l00622"></a>00622   <span class="keywordflow">return</span> jl;
<a name="l00623"></a>00623 }
<a name="l00624"></a>00624 
<a name="l00625"></a><a class="code" href="classKCal_1_1Calendar.html#407b33adc9401ed31bcf8dba237692bd">00625</a> Journal::List <a class="code" href="classKCal_1_1Calendar.html#c6b55e4bc2dcc1557b63ffd9273bd6bc" title="Return a sorted, filtered list of all Journals for this Calendar.">Calendar::journals</a>( <span class="keyword">const</span> QDate &amp;date )
<a name="l00626"></a>00626 {
<a name="l00627"></a>00627   Journal::List el = <a class="code" href="classKCal_1_1Calendar.html#d6faef93706c1f51db05448f8fa8e4db" title="Return an unfiltered list of all Journals for on the specifed date.">rawJournalsForDate</a>( date );
<a name="l00628"></a>00628   mFilter-&gt;<a class="code" href="classKCal_1_1CalFilter.html#b3735bf76246938f68d978457c783a5d" title="Apply filter to eventlist, all events not matching filter criterias are removed from...">apply</a>( &amp;el );
<a name="l00629"></a>00629   <span class="keywordflow">return</span> el;
<a name="l00630"></a>00630 }
<a name="l00631"></a>00631 
<a name="l00632"></a>00632 <span class="comment">// When this is called, the todo have already been added to the calendar.</span>
<a name="l00633"></a>00633 <span class="comment">// This method is only about linking related todos</span>
<a name="l00634"></a><a class="code" href="classKCal_1_1Calendar.html#3f3de93b1c098488d3fcf8bc0bdcc09b">00634</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#3f3de93b1c098488d3fcf8bc0bdcc09b" title="Setup Relations for an Incidence.">Calendar::setupRelations</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *forincidence )
<a name="l00635"></a>00635 {
<a name="l00636"></a>00636   <span class="keywordflow">if</span> ( !forincidence ) <span class="keywordflow">return</span>;
<a name="l00637"></a>00637 <span class="comment">// kdDebug(5850) &lt;&lt; "Calendar::setupRelations for incidence " &lt;&lt; forincidence &lt;&lt; " with UID " &lt;&lt; forincidence-&gt;uid() &lt;&lt; ", summary: " &lt;&lt; forincidence-&gt;summary() &lt;&lt; endl;</span>
<a name="l00638"></a>00638   QString uid = forincidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#75c8bd2df73c5a62bd7cf77c2ac4d3c6" title="Return the unique id for the event.">uid</a>();
<a name="l00639"></a>00639 
<a name="l00640"></a>00640   <span class="comment">// First, go over the list of orphans and see if this is their parent</span>
<a name="l00641"></a>00641   <span class="keywordflow">while</span> ( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a>* i = mOrphans[ uid ] ) {
<a name="l00642"></a>00642     mOrphans.remove( uid );
<a name="l00643"></a>00643     i-&gt;setRelatedTo( forincidence );
<a name="l00644"></a>00644     forincidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#ef0e6e06aea25be849c1b177989d32e5" title="Add an event which is related to this event.">addRelation</a>( i );
<a name="l00645"></a>00645     mOrphanUids.remove( i-&gt;uid() );
<a name="l00646"></a>00646   }
<a name="l00647"></a>00647 
<a name="l00648"></a>00648   <span class="comment">// Now see about this incidences parent</span>
<a name="l00649"></a>00649   <span class="keywordflow">if</span> ( !forincidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#9b09c1637d3900ba0c2e768b39fff819" title="What event does this one relate to?">relatedTo</a>() &amp;&amp; !forincidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#26733e87a3cce01b792667febe752f4d" title="What event does this one relate to? This function should only be used when constructing...">relatedToUid</a>().isEmpty() ) {
<a name="l00650"></a>00650     <span class="comment">// This incidence has a uid it is related to but is not registered to it yet</span>
<a name="l00651"></a>00651     <span class="comment">// Try to find it</span>
<a name="l00652"></a>00652     <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a>* parent = <a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">incidence</a>( forincidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#26733e87a3cce01b792667febe752f4d" title="What event does this one relate to? This function should only be used when constructing...">relatedToUid</a>() );
<a name="l00653"></a>00653     <span class="keywordflow">if</span> ( parent ) {
<a name="l00654"></a>00654       <span class="comment">// Found it</span>
<a name="l00655"></a>00655       forincidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#3cb36283ad2b012e5bf9a769d13593ad" title="Point at some other event to which the event relates.">setRelatedTo</a>( parent );
<a name="l00656"></a>00656       parent-&gt;<a class="code" href="classKCal_1_1Incidence.html#ef0e6e06aea25be849c1b177989d32e5" title="Add an event which is related to this event.">addRelation</a>( forincidence );
<a name="l00657"></a>00657     } <span class="keywordflow">else</span> {
<a name="l00658"></a>00658       <span class="comment">// Not found, put this in the mOrphans list</span>
<a name="l00659"></a>00659       <span class="comment">// Note that the mOrphans dict might have several entries with the same key! That are</span>
<a name="l00660"></a>00660       <span class="comment">// multiple children that wait for the parent incidence to be inserted.</span>
<a name="l00661"></a>00661       mOrphans.insert( forincidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#26733e87a3cce01b792667febe752f4d" title="What event does this one relate to? This function should only be used when constructing...">relatedToUid</a>(), forincidence );
<a name="l00662"></a>00662       mOrphanUids.insert( forincidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#75c8bd2df73c5a62bd7cf77c2ac4d3c6" title="Return the unique id for the event.">uid</a>(), forincidence );
<a name="l00663"></a>00663     }
<a name="l00664"></a>00664   }
<a name="l00665"></a>00665 }
<a name="l00666"></a>00666 
<a name="l00667"></a>00667 <span class="comment">// If a task with subtasks is deleted, move it's subtasks to the orphans list</span>
<a name="l00668"></a><a class="code" href="classKCal_1_1Calendar.html#70a85f266e8a3f23f01850b7106e3d51">00668</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#70a85f266e8a3f23f01850b7106e3d51" title="Remove all Relations from an Incidence.">Calendar::removeRelations</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">incidence</a> )
<a name="l00669"></a>00669 {
<a name="l00670"></a>00670   <span class="keywordflow">if</span>( !incidence ) {
<a name="l00671"></a>00671     kdDebug(5800) &lt;&lt; <span class="stringliteral">"Warning: Calendar::removeRelations( 0 )!\n"</span>;
<a name="l00672"></a>00672     <span class="keywordflow">return</span>;
<a name="l00673"></a>00673   }
<a name="l00674"></a>00674 
<a name="l00675"></a>00675 <span class="comment">// kdDebug(5850) &lt;&lt; "Calendar::removeRelations for incidence " &lt;&lt; forincidence &lt;&lt; " with UID " &lt;&lt; forincidence-&gt;uid() &lt;&lt; ", summary: " &lt;&lt; forincidence-&gt;summary() &lt;&lt; endl;</span>
<a name="l00676"></a>00676   QString uid = incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#75c8bd2df73c5a62bd7cf77c2ac4d3c6" title="Return the unique id for the event.">uid</a>();
<a name="l00677"></a>00677 
<a name="l00678"></a>00678   Incidence::List relations = incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#a4543a67ede7777dda57b127fa8fdf88" title="All events that are related to this event.">relations</a>();
<a name="l00679"></a>00679   Incidence::List::ConstIterator it;
<a name="l00680"></a>00680   <span class="keywordflow">for</span> ( it = relations.begin(); it != relations.end(); ++it ) {
<a name="l00681"></a>00681     <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *i = *it;
<a name="l00682"></a>00682     <span class="keywordflow">if</span> ( !mOrphanUids.find( i-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#75c8bd2df73c5a62bd7cf77c2ac4d3c6" title="Return the unique id for the event.">uid</a>() ) ) {
<a name="l00683"></a>00683       mOrphans.insert( uid, i );
<a name="l00684"></a>00684       mOrphanUids.insert( i-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#75c8bd2df73c5a62bd7cf77c2ac4d3c6" title="Return the unique id for the event.">uid</a>(), i );
<a name="l00685"></a>00685       i-&gt;<a class="code" href="classKCal_1_1Incidence.html#3cb36283ad2b012e5bf9a769d13593ad" title="Point at some other event to which the event relates.">setRelatedTo</a>( 0 );
<a name="l00686"></a>00686       i-&gt;<a class="code" href="classKCal_1_1Incidence.html#61faeed6fc9b849d434d07c6198c5369" title="Point at some other event to which the event relates.">setRelatedToUid</a>( uid );
<a name="l00687"></a>00687     }
<a name="l00688"></a>00688   }
<a name="l00689"></a>00689 
<a name="l00690"></a>00690   <span class="comment">// If this incidence is related to something else, tell that about it</span>
<a name="l00691"></a>00691   <span class="keywordflow">if</span> ( incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#9b09c1637d3900ba0c2e768b39fff819" title="What event does this one relate to?">relatedTo</a>() )
<a name="l00692"></a>00692     incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#9b09c1637d3900ba0c2e768b39fff819" title="What event does this one relate to?">relatedTo</a>()-&gt;<a class="code" href="classKCal_1_1Incidence.html#7c5c08a90a1555a418b384b79882f09f" title="Remove event that is related to this event.">removeRelation</a>( incidence );
<a name="l00693"></a>00693 
<a name="l00694"></a>00694   <span class="comment">// Remove this one from the orphans list</span>
<a name="l00695"></a>00695   <span class="keywordflow">if</span> ( mOrphanUids.remove( uid ) ) {
<a name="l00696"></a>00696     <span class="comment">// This incidence is located in the orphans list - it should be removed</span>
<a name="l00697"></a>00697     <span class="comment">// Since the mOrphans dict might contain the same key (with different</span>
<a name="l00698"></a>00698     <span class="comment">// child incidence pointers!) multiple times, take care that we remove</span>
<a name="l00699"></a>00699     <span class="comment">// the correct one. So we need to remove all items with the given</span>
<a name="l00700"></a>00700     <span class="comment">// parent UID, and readd those that are not for this item. Also, there</span>
<a name="l00701"></a>00701     <span class="comment">// might be other entries with differnet UID that point to this</span>
<a name="l00702"></a>00702     <span class="comment">// incidence (this might happen when the relatedTo of the item is</span>
<a name="l00703"></a>00703     <span class="comment">// changed before its parent is inserted. This might happen with</span>
<a name="l00704"></a>00704     <span class="comment">// groupware servers....). Remove them, too</span>
<a name="l00705"></a>00705     QStringList relatedToUids;
<a name="l00706"></a>00706     <span class="comment">// First get the list of all keys in the mOrphans list that point to the removed item</span>
<a name="l00707"></a>00707     relatedToUids &lt;&lt; incidence-&gt;<a class="code" href="classKCal_1_1Incidence.html#26733e87a3cce01b792667febe752f4d" title="What event does this one relate to? This function should only be used when constructing...">relatedToUid</a>();
<a name="l00708"></a>00708     <span class="keywordflow">for</span> ( QDictIterator&lt;Incidence&gt; it( mOrphans ); it.current(); ++it ) {
<a name="l00709"></a>00709       <span class="keywordflow">if</span> ( it.current()-&gt;uid() == uid ) {
<a name="l00710"></a>00710         relatedToUids &lt;&lt; it.currentKey();
<a name="l00711"></a>00711       }
<a name="l00712"></a>00712     }
<a name="l00713"></a>00713 
<a name="l00714"></a>00714     <span class="comment">// now go through all uids that have one entry that point to the incidence</span>
<a name="l00715"></a>00715     <span class="keywordflow">for</span> ( QStringList::Iterator uidit = relatedToUids.begin();
<a name="l00716"></a>00716           uidit != relatedToUids.end(); ++uidit ) {
<a name="l00717"></a>00717       Incidence::List tempList;
<a name="l00718"></a>00718       <span class="comment">// Remove all to get access to the remaining entries</span>
<a name="l00719"></a>00719       <span class="keywordflow">while</span>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a>* i = mOrphans[ *uidit ] ) {
<a name="l00720"></a>00720         mOrphans.remove( *uidit );
<a name="l00721"></a>00721         <span class="keywordflow">if</span> ( i != incidence ) tempList.append( i );
<a name="l00722"></a>00722       }
<a name="l00723"></a>00723       <span class="comment">// Readd those that point to a different orphan incidence</span>
<a name="l00724"></a>00724       <span class="keywordflow">for</span> ( Incidence::List::Iterator incit = tempList.begin();
<a name="l00725"></a>00725             incit != tempList.end(); ++incit ) {
<a name="l00726"></a>00726         mOrphans.insert( *uidit, *incit );
<a name="l00727"></a>00727       }
<a name="l00728"></a>00728     }
<a name="l00729"></a>00729   }
<a name="l00730"></a>00730 }
<a name="l00731"></a>00731 
<a name="l00732"></a><a class="code" href="classKCal_1_1Calendar.html#448cfb6c7cdc83e0bc28cc469235302c">00732</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#448cfb6c7cdc83e0bc28cc469235302c" title="Register an Observer for this Calendar.">Calendar::registerObserver</a>( <a class="code" href="classKCal_1_1Calendar_1_1Observer.html" title="The Observer class.">Observer</a> *observer )
<a name="l00733"></a>00733 {
<a name="l00734"></a>00734   <span class="keywordflow">if</span>( !mObservers.contains( observer ) )
<a name="l00735"></a>00735     mObservers.append( observer );
<a name="l00736"></a>00736   mNewObserver = <span class="keyword">true</span>;
<a name="l00737"></a>00737 }
<a name="l00738"></a>00738 
<a name="l00739"></a><a class="code" href="classKCal_1_1Calendar.html#691818c82a13ff376918d75ebfb9879d">00739</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#691818c82a13ff376918d75ebfb9879d" title="Unregister an Observer for this Calendar.">Calendar::unregisterObserver</a>( <a class="code" href="classKCal_1_1Calendar_1_1Observer.html" title="The Observer class.">Observer</a> *observer )
<a name="l00740"></a>00740 {
<a name="l00741"></a>00741   mObservers.remove( observer );
<a name="l00742"></a>00742 }
<a name="l00743"></a>00743 
<a name="l00744"></a><a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50">00744</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50" title="Set if the Calendar had been modified.">Calendar::setModified</a>( <span class="keywordtype">bool</span> modified )
<a name="l00745"></a>00745 {
<a name="l00746"></a>00746   <span class="keywordflow">if</span> ( modified != mModified || mNewObserver ) {
<a name="l00747"></a>00747     mNewObserver = <span class="keyword">false</span>;
<a name="l00748"></a>00748     <a class="code" href="classKCal_1_1Calendar_1_1Observer.html" title="The Observer class.">Observer</a> *observer;
<a name="l00749"></a>00749     <span class="keywordflow">for</span> ( observer = mObservers.first(); observer;
<a name="l00750"></a>00750           observer = mObservers.next() ) {
<a name="l00751"></a>00751       observer-&gt;<a class="code" href="classKCal_1_1Calendar_1_1Observer.html#dfc6f7a9098fdf805154404b88dd2a79" title="Notify the Observer that a Calendar has been modified.">calendarModified</a>( modified, <span class="keyword">this</span> );
<a name="l00752"></a>00752     }
<a name="l00753"></a>00753     mModified = modified;
<a name="l00754"></a>00754   }
<a name="l00755"></a>00755 }
<a name="l00756"></a>00756 
<a name="l00757"></a><a class="code" href="classKCal_1_1Calendar.html#32964dad82d469f43ee7f44dc5f7d78f">00757</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#32964dad82d469f43ee7f44dc5f7d78f" title="The Observer interface.">Calendar::incidenceUpdated</a>( <a class="code" href="classKCal_1_1IncidenceBase.html" title="This class provides the base class common to all calendar components.">IncidenceBase</a> *<a class="code" href="classKCal_1_1Calendar.html#d271d711219da854049efa30723188c4" title="Returns the Incidence associated with the given unique identifier.">incidence</a> )
<a name="l00758"></a>00758 {
<a name="l00759"></a>00759   incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#e8f68e1bc6501741e690418d6c731490" title="Set synchronisation satus.">setSyncStatus</a>( Event::SYNCMOD );
<a name="l00760"></a>00760   incidence-&gt;<a class="code" href="classKCal_1_1IncidenceBase.html#a040b96c3565ddf597b795f69dea28dc" title="Sets the time the incidence was last modified.">setLastModified</a>( QDateTime::currentDateTime() );
<a name="l00761"></a>00761   <span class="comment">// we should probably update the revision number here,</span>
<a name="l00762"></a>00762   <span class="comment">// or internally in the Event itself when certain things change.</span>
<a name="l00763"></a>00763   <span class="comment">// need to verify with ical documentation.</span>
<a name="l00764"></a>00764 
<a name="l00765"></a>00765   <span class="comment">// The static_cast is ok as the CalendarLocal only observes Incidence objects</span>
<a name="l00766"></a>00766   <a class="code" href="classKCal_1_1Calendar.html#5a90d904a5fa1a4bbd29b10183e20def" title="Let Calendar subclasses notify that they modified an Incidence.">notifyIncidenceChanged</a>( static_cast&lt;Incidence *&gt;( incidence ) );
<a name="l00767"></a>00767 
<a name="l00768"></a>00768   <a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50" title="Set if the Calendar had been modified.">setModified</a>( <span class="keyword">true</span> );
<a name="l00769"></a>00769 }
<a name="l00770"></a>00770 
<a name="l00771"></a><a class="code" href="classKCal_1_1Calendar.html#b320f93d0f4b93ae1cedb76d2e27bf7d">00771</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#b320f93d0f4b93ae1cedb76d2e27bf7d" title="Let Calendar subclasses notify that they inserted an Incidence.">Calendar::notifyIncidenceAdded</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *i )
<a name="l00772"></a>00772 {
<a name="l00773"></a>00773   <span class="keywordflow">if</span> ( !mObserversEnabled )
<a name="l00774"></a>00774     <span class="keywordflow">return</span>;
<a name="l00775"></a>00775 
<a name="l00776"></a>00776   <a class="code" href="classKCal_1_1Calendar_1_1Observer.html" title="The Observer class.">Observer</a> *observer;
<a name="l00777"></a>00777   <span class="keywordflow">for</span> ( observer = mObservers.first(); observer;
<a name="l00778"></a>00778         observer = mObservers.next() ) {
<a name="l00779"></a>00779     observer-&gt;<a class="code" href="classKCal_1_1Calendar_1_1Observer.html#89869fd7d03e094ed0178c5b5daea3ed" title="Notify the Observer that an Incidence has been inserted.">calendarIncidenceAdded</a>( i );
<a name="l00780"></a>00780   }
<a name="l00781"></a>00781 }
<a name="l00782"></a>00782 
<a name="l00783"></a><a class="code" href="classKCal_1_1Calendar.html#5a90d904a5fa1a4bbd29b10183e20def">00783</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#5a90d904a5fa1a4bbd29b10183e20def" title="Let Calendar subclasses notify that they modified an Incidence.">Calendar::notifyIncidenceChanged</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *i )
<a name="l00784"></a>00784 {
<a name="l00785"></a>00785   <span class="keywordflow">if</span> ( !mObserversEnabled )
<a name="l00786"></a>00786     <span class="keywordflow">return</span>;
<a name="l00787"></a>00787 
<a name="l00788"></a>00788   <a class="code" href="classKCal_1_1Calendar_1_1Observer.html" title="The Observer class.">Observer</a> *observer;
<a name="l00789"></a>00789   <span class="keywordflow">for</span> ( observer = mObservers.first(); observer;
<a name="l00790"></a>00790         observer = mObservers.next() ) {
<a name="l00791"></a>00791     observer-&gt;<a class="code" href="classKCal_1_1Calendar_1_1Observer.html#fafff9b0c59f484f5f0651b5211f6e7b" title="Notify the Observer that an Incidence has been modified.">calendarIncidenceChanged</a>( i );
<a name="l00792"></a>00792   }
<a name="l00793"></a>00793 }
<a name="l00794"></a>00794 
<a name="l00795"></a><a class="code" href="classKCal_1_1Calendar.html#41d4be475453592dcebb7c2504f800c6">00795</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#41d4be475453592dcebb7c2504f800c6" title="Let Calendar subclasses notify that they removed an Incidence.">Calendar::notifyIncidenceDeleted</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *i )
<a name="l00796"></a>00796 {
<a name="l00797"></a>00797   <span class="keywordflow">if</span> ( !mObserversEnabled )
<a name="l00798"></a>00798     <span class="keywordflow">return</span>;
<a name="l00799"></a>00799 
<a name="l00800"></a>00800   <a class="code" href="classKCal_1_1Calendar_1_1Observer.html" title="The Observer class.">Observer</a> *observer;
<a name="l00801"></a>00801   <span class="keywordflow">for</span> ( observer = mObservers.first(); observer;
<a name="l00802"></a>00802         observer = mObservers.next() ) {
<a name="l00803"></a>00803     observer-&gt;<a class="code" href="classKCal_1_1Calendar_1_1Observer.html#d7106e5d206197ada70ac54aaaff7bf8" title="Notify the Observer that an Incidence has been removed.">calendarIncidenceDeleted</a>( i );
<a name="l00804"></a>00804   }
<a name="l00805"></a>00805 }
<a name="l00806"></a>00806 
<a name="l00807"></a><a class="code" href="classKCal_1_1Calendar.html#6823f6975f6f5238715b7f45db71526b">00807</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#6823f6975f6f5238715b7f45db71526b">Calendar::customPropertyUpdated</a>()
<a name="l00808"></a>00808 {
<a name="l00809"></a>00809   <a class="code" href="classKCal_1_1Calendar.html#6acbb24e958823e79ddf2831c0f50a50" title="Set if the Calendar had been modified.">setModified</a>( <span class="keyword">true</span> );
<a name="l00810"></a>00810 }
<a name="l00811"></a>00811 
<a name="l00812"></a><a class="code" href="classKCal_1_1Calendar.html#710b3c42343daab4ff43569d51d91b23">00812</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#710b3c42343daab4ff43569d51d91b23" title="Set the Calendar Product ID.">Calendar::setProductId</a>( <span class="keyword">const</span> QString &amp;<a class="code" href="classKCal_1_1Calendar.html#dc51d5b5dcda2c5ae54885a40ef5c291" title="Get the Calendar&amp;#39;s Product ID.">productId</a> )
<a name="l00813"></a>00813 {
<a name="l00814"></a>00814   mProductId = productId;
<a name="l00815"></a>00815 }
<a name="l00816"></a>00816 
<a name="l00817"></a><a class="code" href="classKCal_1_1Calendar.html#dc51d5b5dcda2c5ae54885a40ef5c291">00817</a> QString <a class="code" href="classKCal_1_1Calendar.html#dc51d5b5dcda2c5ae54885a40ef5c291" title="Get the Calendar&amp;#39;s Product ID.">Calendar::productId</a>()
<a name="l00818"></a>00818 {
<a name="l00819"></a>00819   <span class="keywordflow">return</span> mProductId;
<a name="l00820"></a>00820 }
<a name="l00821"></a>00821 
<a name="l00822"></a><a class="code" href="classKCal_1_1Calendar.html#36c4effeca9bdb52630a0e8762e08bb3">00822</a> Incidence::List <a class="code" href="classKCal_1_1Calendar.html#36c4effeca9bdb52630a0e8762e08bb3" title="Create a merged list of Events, Todos, and Journals.">Calendar::mergeIncidenceList</a>( <span class="keyword">const</span> Event::List &amp;<a class="code" href="classKCal_1_1Calendar.html#a910b4a8419fcc311e1ca96e588f5147" title="Return a sorted, filtered list of all Events for this Calendar.">events</a>,
<a name="l00823"></a>00823                                               <span class="keyword">const</span> Todo::List &amp;<a class="code" href="classKCal_1_1Calendar.html#ed7c816d2cede2558b5624e8a34ee745" title="Return a sorted, filtered list of all Todos for this Calendar.">todos</a>,
<a name="l00824"></a>00824                                               <span class="keyword">const</span> Journal::List &amp;<a class="code" href="classKCal_1_1Calendar.html#c6b55e4bc2dcc1557b63ffd9273bd6bc" title="Return a sorted, filtered list of all Journals for this Calendar.">journals</a> )
<a name="l00825"></a>00825 {
<a name="l00826"></a>00826   Incidence::List <a class="code" href="classKCal_1_1Calendar.html#356d431a6e1e0cf73edff7183595a364" title="Return a filtered list of all Incidences for this Calendar.">incidences</a>;
<a name="l00827"></a>00827 
<a name="l00828"></a>00828   Event::List::ConstIterator it1;
<a name="l00829"></a>00829   <span class="keywordflow">for</span> ( it1 = events.begin(); it1 != events.end(); ++it1 )
<a name="l00830"></a>00830     incidences.append( *it1 );
<a name="l00831"></a>00831 
<a name="l00832"></a>00832   Todo::List::ConstIterator it2;
<a name="l00833"></a>00833   <span class="keywordflow">for</span> ( it2 = todos.begin(); it2 != todos.end(); ++it2 )
<a name="l00834"></a>00834     incidences.append( *it2 );
<a name="l00835"></a>00835 
<a name="l00836"></a>00836   Journal::List::ConstIterator it3;
<a name="l00837"></a>00837   <span class="keywordflow">for</span> ( it3 = journals.begin(); it3 != journals.end(); ++it3 )
<a name="l00838"></a>00838     incidences.append( *it3 );
<a name="l00839"></a>00839 
<a name="l00840"></a>00840   <span class="keywordflow">return</span> incidences;
<a name="l00841"></a>00841 }
<a name="l00842"></a>00842 
<a name="l00843"></a><a class="code" href="classKCal_1_1Calendar.html#2d9343cfa7d5956749d13d764bee1623">00843</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Calendar.html#2d9343cfa7d5956749d13d764bee1623" title="Flag that a change to a Calendar Incidence is starting.">Calendar::beginChange</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> * )
<a name="l00844"></a>00844 {
<a name="l00845"></a>00845   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00846"></a>00846 }
<a name="l00847"></a>00847 
<a name="l00848"></a><a class="code" href="classKCal_1_1Calendar.html#7e89faf167259c9f92c3702fdf53b89b">00848</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Calendar.html#7e89faf167259c9f92c3702fdf53b89b" title="Flag that a change to a Calendar Incidence has completed.">Calendar::endChange</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> * )
<a name="l00849"></a>00849 {
<a name="l00850"></a>00850   <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00851"></a>00851 }
<a name="l00852"></a>00852 
<a name="l00853"></a><a class="code" href="classKCal_1_1Calendar.html#9cb2ef531883e673731fbf5f4c9e8b2e">00853</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Calendar.html#9cb2ef531883e673731fbf5f4c9e8b2e" title="Let Calendar subclasses notify that they enabled an Observer.">Calendar::setObserversEnabled</a>( <span class="keywordtype">bool</span> enabled )
<a name="l00854"></a>00854 {
<a name="l00855"></a>00855   mObserversEnabled = enabled;
<a name="l00856"></a>00856 }
<a name="l00857"></a>00857 
<a name="l00858"></a>00858 <span class="preprocessor">#include "calendar.moc"</span>
</pre></div></div>
    </div></div>


      </td>
  </tr>
  <tr>
    <td valign="top" id="leftmenu" width="25%">
      <a name="navigation"></a>
      <div class="menu_box"><h2>libkcal</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
  <option value="classKCal_1_1Alarm.html">kcal::alarm</option>,  <option value="classKCal_1_1Attachment.html">kcal::attachment</option>,  <option value="classKCal_1_1Attendee.html">kcal::attendee</option>,  <option value="classKCal_1_1Calendar.html">kcal::calendar</option>,  <option value="classKCal_1_1Calendar_1_1Observer.html">kcal::calendar::observer</option>,  <option value="classKCal_1_1CalendarLocal.html">kcal::calendarlocal</option>,  <option value="classKCal_1_1CalendarNull.html">kcal::calendarnull</option>,  <option value="classKCal_1_1CalendarResources.html">kcal::calendarresources</option>,  <option value="classKCal_1_1CalFilter.html">kcal::calfilter</option>,  <option value="classKCal_1_1CalFormat.html">kcal::calformat</option>,  <option value="classKCal_1_1CalStorage.html">kcal::calstorage</option>,  <option value="classKCal_1_1Compat.html">kcal::compat</option>,  <option value="classKCal_1_1CompatFactory.html">kcal::compatfactory</option>,  <option value="classKCal_1_1CustomProperties.html">kcal::customproperties</option>,  <option value="classKCal_1_1DndFactory.html">kcal::dndfactory</option>,  <option value="classKCal_1_1Duration.html">kcal::duration</option>,  <option value="classKCal_1_1ErrorFormat.html">kcal::errorformat</option>,  <option value="classKCal_1_1Event.html">kcal::event</option>,  <option value="classKCal_1_1Exception.html">kcal::exception</option>,  <option value="classKCal_1_1FileStorage.html">kcal::filestorage</option>,  <option value="classKCal_1_1FreeBusy.html">kcal::freebusy</option>,  <option value="classKCal_1_1HtmlExport.html">kcal::htmlexport</option>,  <option value="classKCal_1_1ICalDrag.html">kcal::icaldrag</option>,  <option value="classKCal_1_1ICalFormat.html">kcal::icalformat</option>,  <option value="classKCal_1_1Incidence.html">kcal::incidence</option>,  <option value="classKCal_1_1Incidence_1_1AddVisitor.html">kcal::incidence::addvisitor</option>,  <option value="classKCal_1_1Incidence_1_1DeleteVisitor.html">kcal::incidence::deletevisitor</option>,  <option value="classKCal_1_1IncidenceBase.html">kcal::incidencebase</option>,  <option value="classKCal_1_1IncidenceBase_1_1Visitor.html">kcal::incidencebase::visitor</option>,  <option value="classKCal_1_1IncidenceFormatter.html">kcal::incidenceformatter</option>,  <option value="classKCal_1_1Journal.html">kcal::journal</option>,  <option value="classKCal_1_1ListBase.html">kcal::listbase</option>,  <option value="classKCal_1_1Period.html">kcal::period</option>,  <option value="classKCal_1_1Person.html">kcal::person</option>,  <option value="classKCal_1_1QtopiaFormat.html">kcal::qtopiaformat</option>,  <option value="classKCal_1_1Recurrence.html">kcal::recurrence</option>,  <option value="classKCal_1_1RecurrenceRule.html">kcal::recurrencerule</option>,  <option value="classKCal_1_1RecurrenceRule_1_1WDayPos.html">kcal::recurrencerule::wdaypos</option>,  <option value="classKCal_1_1ResourceCached.html">kcal::resourcecached</option>,  <option value="classKCal_1_1ResourceCachedReloadConfig.html">kcal::resourcecachedreloadconfig</option>,  <option value="classKCal_1_1ResourceCachedSaveConfig.html">kcal::resourcecachedsaveconfig</option>,  <option value="classKCal_1_1ResourceCalendar.html">kcal::resourcecalendar</option>,  <option value="classKCal_1_1ResourceLocal.html">kcal::resourcelocal</option>,  <option value="classKCal_1_1ResourceLocalConfig.html">kcal::resourcelocalconfig</option>,  <option value="classKCal_1_1ScheduleMessage.html">kcal::schedulemessage</option>,  <option value="classKCal_1_1Scheduler.html">kcal::scheduler</option>,  <option value="classKCal_1_1Todo.html">kcal::todo</option>,  <option value="classKCal_1_1VCalDrag.html">kcal::vcaldrag</option>,  <option value="classKCal_1_1VCalFormat.html">kcal::vcalformat</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../akregator/html/index.html">akregator</a></li><li>&nbsp;&nbsp;<a href="../../akregator/src/html/index.html">src</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../certmanager/html/index.html">certmanager</a></li><li>&nbsp;&nbsp;<a href="../../certmanager/lib/html/index.html">lib</a></li><li><a href="../../kaddressbook/html/index.html">kaddressbook</a></li><li><a href="../../kalarm/html/index.html">kalarm</a></li><li>&nbsp;&nbsp;<a href="../../kalarm/lib/html/index.html">lib</a></li><li><a href="../../kandy/html/index.html">kandy</a></li><li><a href="../../karm/html/index.html">karm</a></li><li><a href="../../kdgantt/html/index.html">kdgantt</a></li><li><a href="../../kgantt/html/index.html">kgantt</a></li><li><a href="../../kioslaves/html/index.html">kioslaves</a></li><li>&nbsp;&nbsp;<a href="../../kioslaves/imap4/html/index.html">imap4</a></li><li>&nbsp;&nbsp;<a href="../../kioslaves/mbox/html/index.html">mbox</a></li><li><a href="../../kitchensync/html/index.html">kitchensync</a></li><li><a href="../../kmail/html/index.html">kmail</a></li><li><a href="../../knotes/html/index.html">knotes</a></li><li><a href="../../konsolekalendar/html/index.html">konsolekalendar</a></li><li><a href="../../kontact/html/index.html">kontact</a></li><li><a href="../../korganizer/html/index.html">korganizer</a></li><li><a href="../../kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../kpilot/kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../kpilot/lib/html/index.html">lib</a></li><li><a href="../../libemailfunctions/html/index.html">libemailfunctions</a></li><li><a href="../../libkcal/html/index.html">libkcal</a></li><li><a href="../../libkdepim/html/index.html">libkdepim</a></li><li><a href="../../libkholidays/html/index.html">libkholidays</a></li><li><a href="../../libkmime/html/index.html">libkmime</a></li><li><a href="../../libkpgp/html/index.html">libkpgp</a></li><li><a href="../../libkpimidentities/html/index.html">libkpimidentities</a></li>
</ul></div></div>


        </td>
</tr>
</table>

<span class="doNotDisplay">
  <a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
  <a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
  <a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>


<div style="height: 8px"></div>

<div id="footer">
  <div id="footer_left">
    Maintained by <a href="&#109;&#97;&#105;&#108;&#116;&#111;&#58;groo&#116;&#64;kde&#46;or&#x67;">Adriaan de Groot</a>
and
<a href="&#109;a&#105;&#108;&#116;&#111;&#58;w&#105;nter&#64;kde&#46;or&#x67">Allen Winter</a>.
<br/>
    KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
    <a href="http://www.kde.org/contact/impressum.php">Legal</a>
  </div>
  <div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>

<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->

</body>
</html>