<?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>kalarm: alarmevent.cpp Source File (kalarm)</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=".">kalarm</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>kalarm</h2>
<!-- Generated by Doxygen 1.5.5 -->
<h1>alarmevent.cpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> * alarmevent.cpp - represents calendar alarms and events</span>
<a name="l00003"></a>00003 <span class="comment"> * Program: kalarm</span>
<a name="l00004"></a>00004 <span class="comment"> * Copyright © 2001-2008 by David Jarvie <software@astrojar.org.uk></span>
<a name="l00005"></a>00005 <span class="comment"> *</span>
<a name="l00006"></a>00006 <span class="comment"> * This program is free software; you can redistribute it and/or modify</span>
<a name="l00007"></a>00007 <span class="comment"> * it under the terms of the GNU General Public License as published by</span>
<a name="l00008"></a>00008 <span class="comment"> * the Free Software Foundation; either version 2 of the License, or</span>
<a name="l00009"></a>00009 <span class="comment"> * (at your option) any later version.</span>
<a name="l00010"></a>00010 <span class="comment"> *</span>
<a name="l00011"></a>00011 <span class="comment"> * This program is distributed in the hope that it will be useful,</span>
<a name="l00012"></a>00012 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00013"></a>00013 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
<a name="l00014"></a>00014 <span class="comment"> * GNU General Public License for more details.</span>
<a name="l00015"></a>00015 <span class="comment"> *</span>
<a name="l00016"></a>00016 <span class="comment"> * You should have received a copy of the GNU General Public License along</span>
<a name="l00017"></a>00017 <span class="comment"> * with this program; if not, write to the Free Software Foundation, Inc.,</span>
<a name="l00018"></a>00018 <span class="comment"> * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</span>
<a name="l00019"></a>00019 <span class="comment"> */</span>
<a name="l00020"></a>00020
<a name="l00021"></a>00021 <span class="preprocessor">#include "kalarm.h"</span>
<a name="l00022"></a>00022
<a name="l00023"></a>00023 <span class="preprocessor">#include <stdlib.h></span>
<a name="l00024"></a>00024 <span class="preprocessor">#include <time.h></span>
<a name="l00025"></a>00025 <span class="preprocessor">#include <ctype.h></span>
<a name="l00026"></a>00026 <span class="preprocessor">#include <qcolor.h></span>
<a name="l00027"></a>00027 <span class="preprocessor">#include <qregexp.h></span>
<a name="l00028"></a>00028
<a name="l00029"></a>00029 <span class="preprocessor">#include <klocale.h></span>
<a name="l00030"></a>00030 <span class="preprocessor">#include <kdebug.h></span>
<a name="l00031"></a>00031
<a name="l00032"></a>00032 <span class="preprocessor">#include "alarmtext.h"</span>
<a name="l00033"></a>00033 <span class="preprocessor">#include "<a class="code" href="functions_8h.html" title="miscellaneous functions">functions.h</a>"</span>
<a name="l00034"></a>00034 <span class="preprocessor">#include "<a class="code" href="kalarmapp_8h.html" title="the KAlarm application object">kalarmapp.h</a>"</span>
<a name="l00035"></a>00035 <span class="preprocessor">#include "kamail.h"</span>
<a name="l00036"></a>00036 <span class="preprocessor">#include "preferences.h"</span>
<a name="l00037"></a>00037 <span class="preprocessor">#include "alarmcalendar.h"</span>
<a name="l00038"></a>00038 <span class="preprocessor">#include "<a class="code" href="alarmevent_8h.html" title="represents calendar alarms and events">alarmevent.h</a>"</span>
<a name="l00039"></a>00039 <span class="keyword">using namespace </span>KCal;
<a name="l00040"></a>00040
<a name="l00041"></a>00041
<a name="l00042"></a>00042 <span class="keyword">const</span> QCString APPNAME(<span class="stringliteral">"KALARM"</span>);
<a name="l00043"></a>00043
<a name="l00044"></a>00044 <span class="comment">// KAlarm version which first used the current calendar/event format.</span>
<a name="l00045"></a>00045 <span class="comment">// If this changes, KAEvent::convertKCalEvents() must be changed correspondingly.</span>
<a name="l00046"></a>00046 <span class="comment">// The string version is the KAlarm version string used in the calendar file.</span>
<a name="l00047"></a>00047 QString KAEvent::calVersionString() { <span class="keywordflow">return</span> QString::fromLatin1(<span class="stringliteral">"1.5.0"</span>); }
<a name="l00048"></a>00048 <span class="keywordtype">int</span> KAEvent::calVersion() { <span class="keywordflow">return</span> KAlarm::Version(1,5,0); }
<a name="l00049"></a>00049
<a name="l00050"></a>00050 <span class="comment">// Custom calendar properties.</span>
<a name="l00051"></a>00051 <span class="comment">// Note that all custom property names are prefixed with X-KDE-KALARM- in the calendar file.</span>
<a name="l00052"></a>00052 <span class="comment">// - Event properties</span>
<a name="l00053"></a>00053 <span class="keyword">static</span> <span class="keyword">const</span> QCString NEXT_RECUR_PROPERTY(<span class="stringliteral">"NEXTRECUR"</span>); <span class="comment">// X-KDE-KALARM-NEXTRECUR property</span>
<a name="l00054"></a>00054 <span class="keyword">static</span> <span class="keyword">const</span> QCString REPEAT_PROPERTY(<span class="stringliteral">"REPEAT"</span>); <span class="comment">// X-KDE-KALARM-REPEAT property</span>
<a name="l00055"></a>00055 <span class="comment">// - General alarm properties</span>
<a name="l00056"></a>00056 <span class="keyword">static</span> <span class="keyword">const</span> QCString TYPE_PROPERTY(<span class="stringliteral">"TYPE"</span>); <span class="comment">// X-KDE-KALARM-TYPE property</span>
<a name="l00057"></a>00057 <span class="keyword">static</span> <span class="keyword">const</span> QString FILE_TYPE = QString::fromLatin1(<span class="stringliteral">"FILE"</span>);
<a name="l00058"></a>00058 <span class="keyword">static</span> <span class="keyword">const</span> QString AT_LOGIN_TYPE = QString::fromLatin1(<span class="stringliteral">"LOGIN"</span>);
<a name="l00059"></a>00059 <span class="keyword">static</span> <span class="keyword">const</span> QString REMINDER_TYPE = QString::fromLatin1(<span class="stringliteral">"REMINDER"</span>);
<a name="l00060"></a>00060 <span class="keyword">static</span> <span class="keyword">const</span> QString REMINDER_ONCE_TYPE = QString::fromLatin1(<span class="stringliteral">"REMINDER_ONCE"</span>);
<a name="l00061"></a>00061 <span class="keyword">static</span> <span class="keyword">const</span> QString ARCHIVE_REMINDER_ONCE_TYPE = QString::fromLatin1(<span class="stringliteral">"ONCE"</span>);
<a name="l00062"></a>00062 <span class="keyword">static</span> <span class="keyword">const</span> QString TIME_DEFERRAL_TYPE = QString::fromLatin1(<span class="stringliteral">"DEFERRAL"</span>);
<a name="l00063"></a>00063 <span class="keyword">static</span> <span class="keyword">const</span> QString DATE_DEFERRAL_TYPE = QString::fromLatin1(<span class="stringliteral">"DATE_DEFERRAL"</span>);
<a name="l00064"></a>00064 <span class="keyword">static</span> <span class="keyword">const</span> QString DISPLAYING_TYPE = QString::fromLatin1(<span class="stringliteral">"DISPLAYING"</span>); <span class="comment">// used only in displaying calendar</span>
<a name="l00065"></a>00065 <span class="keyword">static</span> <span class="keyword">const</span> QString PRE_ACTION_TYPE = QString::fromLatin1(<span class="stringliteral">"PRE"</span>);
<a name="l00066"></a>00066 <span class="keyword">static</span> <span class="keyword">const</span> QString POST_ACTION_TYPE = QString::fromLatin1(<span class="stringliteral">"POST"</span>);
<a name="l00067"></a>00067 <span class="keyword">static</span> <span class="keyword">const</span> QCString NEXT_REPEAT_PROPERTY(<span class="stringliteral">"NEXTREPEAT"</span>); <span class="comment">// X-KDE-KALARM-NEXTREPEAT property</span>
<a name="l00068"></a>00068 <span class="comment">// - Display alarm properties</span>
<a name="l00069"></a>00069 <span class="keyword">static</span> <span class="keyword">const</span> QCString FONT_COLOUR_PROPERTY(<span class="stringliteral">"FONTCOLOR"</span>); <span class="comment">// X-KDE-KALARM-FONTCOLOR property</span>
<a name="l00070"></a>00070 <span class="comment">// - Email alarm properties</span>
<a name="l00071"></a>00071 <span class="keyword">static</span> <span class="keyword">const</span> QCString EMAIL_ID_PROPERTY(<span class="stringliteral">"EMAILID"</span>); <span class="comment">// X-KDE-KALARM-EMAILID property</span>
<a name="l00072"></a>00072 <span class="comment">// - Audio alarm properties</span>
<a name="l00073"></a>00073 <span class="keyword">static</span> <span class="keyword">const</span> QCString VOLUME_PROPERTY(<span class="stringliteral">"VOLUME"</span>); <span class="comment">// X-KDE-KALARM-VOLUME property</span>
<a name="l00074"></a>00074 <span class="keyword">static</span> <span class="keyword">const</span> QCString SPEAK_PROPERTY(<span class="stringliteral">"SPEAK"</span>); <span class="comment">// X-KDE-KALARM-SPEAK property</span>
<a name="l00075"></a>00075
<a name="l00076"></a>00076 <span class="comment">// Event categories</span>
<a name="l00077"></a>00077 <span class="keyword">static</span> <span class="keyword">const</span> QString DATE_ONLY_CATEGORY = QString::fromLatin1(<span class="stringliteral">"DATE"</span>);
<a name="l00078"></a>00078 <span class="keyword">static</span> <span class="keyword">const</span> QString EMAIL_BCC_CATEGORY = QString::fromLatin1(<span class="stringliteral">"BCC"</span>);
<a name="l00079"></a>00079 <span class="keyword">static</span> <span class="keyword">const</span> QString CONFIRM_ACK_CATEGORY = QString::fromLatin1(<span class="stringliteral">"ACKCONF"</span>);
<a name="l00080"></a>00080 <span class="keyword">static</span> <span class="keyword">const</span> QString LATE_CANCEL_CATEGORY = QString::fromLatin1(<span class="stringliteral">"LATECANCEL;"</span>);
<a name="l00081"></a>00081 <span class="keyword">static</span> <span class="keyword">const</span> QString AUTO_CLOSE_CATEGORY = QString::fromLatin1(<span class="stringliteral">"LATECLOSE;"</span>);
<a name="l00082"></a>00082 <span class="keyword">static</span> <span class="keyword">const</span> QString TEMPL_AFTER_TIME_CATEGORY = QString::fromLatin1(<span class="stringliteral">"TMPLAFTTIME;"</span>);
<a name="l00083"></a>00083 <span class="keyword">static</span> <span class="keyword">const</span> QString KMAIL_SERNUM_CATEGORY = QString::fromLatin1(<span class="stringliteral">"KMAIL:"</span>);
<a name="l00084"></a>00084 <span class="keyword">static</span> <span class="keyword">const</span> QString KORGANIZER_CATEGORY = QString::fromLatin1(<span class="stringliteral">"KORG"</span>);
<a name="l00085"></a>00085 <span class="keyword">static</span> <span class="keyword">const</span> QString DEFER_CATEGORY = QString::fromLatin1(<span class="stringliteral">"DEFER;"</span>);
<a name="l00086"></a>00086 <span class="keyword">static</span> <span class="keyword">const</span> QString ARCHIVE_CATEGORY = QString::fromLatin1(<span class="stringliteral">"SAVE"</span>);
<a name="l00087"></a>00087 <span class="keyword">static</span> <span class="keyword">const</span> QString ARCHIVE_CATEGORIES = QString::fromLatin1(<span class="stringliteral">"SAVE:"</span>);
<a name="l00088"></a>00088 <span class="keyword">static</span> <span class="keyword">const</span> QString LOG_CATEGORY = QString::fromLatin1(<span class="stringliteral">"LOG:"</span>);
<a name="l00089"></a>00089 <span class="keyword">static</span> <span class="keyword">const</span> QString xtermURL = QString::fromLatin1(<span class="stringliteral">"xterm:"</span>);
<a name="l00090"></a>00090
<a name="l00091"></a>00091 <span class="comment">// Event status strings</span>
<a name="l00092"></a>00092 <span class="keyword">static</span> <span class="keyword">const</span> QString DISABLED_STATUS = QString::fromLatin1(<span class="stringliteral">"DISABLED"</span>);
<a name="l00093"></a>00093
<a name="l00094"></a>00094 <span class="keyword">static</span> <span class="keyword">const</span> QString EXPIRED_UID = QString::fromLatin1(<span class="stringliteral">"-exp-"</span>);
<a name="l00095"></a>00095 <span class="keyword">static</span> <span class="keyword">const</span> QString DISPLAYING_UID = QString::fromLatin1(<span class="stringliteral">"-disp-"</span>);
<a name="l00096"></a>00096 <span class="keyword">static</span> <span class="keyword">const</span> QString TEMPLATE_UID = QString::fromLatin1(<span class="stringliteral">"-tmpl-"</span>);
<a name="l00097"></a>00097 <span class="keyword">static</span> <span class="keyword">const</span> QString KORGANIZER_UID = QString::fromLatin1(<span class="stringliteral">"-korg-"</span>);
<a name="l00098"></a>00098
<a name="l00099"></a>00099 <span class="keyword">struct </span>AlarmData
<a name="l00100"></a>00100 {
<a name="l00101"></a>00101 <span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm;
<a name="l00102"></a>00102 QString cleanText; <span class="comment">// text or audio file name</span>
<a name="l00103"></a>00103 uint emailFromId;
<a name="l00104"></a>00104 EmailAddressList emailAddresses;
<a name="l00105"></a>00105 QString emailSubject;
<a name="l00106"></a>00106 QStringList emailAttachments;
<a name="l00107"></a>00107 QFont font;
<a name="l00108"></a>00108 QColor bgColour, fgColour;
<a name="l00109"></a>00109 <span class="keywordtype">float</span> soundVolume;
<a name="l00110"></a>00110 <span class="keywordtype">float</span> fadeVolume;
<a name="l00111"></a>00111 <span class="keywordtype">int</span> fadeSeconds;
<a name="l00112"></a>00112 <span class="keywordtype">int</span> startOffsetSecs;
<a name="l00113"></a>00113 <span class="keywordtype">bool</span> speak;
<a name="l00114"></a>00114 KAAlarm::SubType type;
<a name="l00115"></a>00115 KAAlarmEventBase::Type action;
<a name="l00116"></a>00116 <span class="keywordtype">int</span> displayingFlags;
<a name="l00117"></a>00117 <span class="keywordtype">bool</span> defaultFont;
<a name="l00118"></a>00118 <span class="keywordtype">bool</span> reminderOnceOnly;
<a name="l00119"></a>00119 <span class="keywordtype">bool</span> isEmailText;
<a name="l00120"></a>00120 <span class="keywordtype">bool</span> commandScript;
<a name="l00121"></a>00121 <span class="keywordtype">int</span> repeatCount;
<a name="l00122"></a>00122 <span class="keywordtype">int</span> repeatInterval;
<a name="l00123"></a>00123 <span class="keywordtype">int</span> nextRepeat;
<a name="l00124"></a>00124 };
<a name="l00125"></a>00125 <span class="keyword">typedef</span> QMap<KAAlarm::SubType, AlarmData> AlarmMap;
<a name="l00126"></a>00126
<a name="l00127"></a>00127 <span class="keyword">static</span> <span class="keywordtype">void</span> setProcedureAlarm(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>*, <span class="keyword">const</span> QString& commandLine);
<a name="l00128"></a>00128
<a name="l00129"></a>00129
<a name="l00130"></a>00130 <span class="comment">/*=============================================================================</span>
<a name="l00131"></a>00131 <span class="comment">= Class KAEvent</span>
<a name="l00132"></a>00132 <span class="comment">= Corresponds to a KCal::Event instance.</span>
<a name="l00133"></a>00133 <span class="comment">=============================================================================*/</span>
<a name="l00134"></a>00134
<a name="l00135"></a>00135 <span class="keyword">inline</span> <span class="keywordtype">void</span> KAEvent::set_deferral(DeferType type)
<a name="l00136"></a>00136 {
<a name="l00137"></a>00137 <span class="keywordflow">if</span> (type)
<a name="l00138"></a>00138 {
<a name="l00139"></a>00139 <span class="keywordflow">if</span> (!mDeferral)
<a name="l00140"></a>00140 ++mAlarmCount;
<a name="l00141"></a>00141 }
<a name="l00142"></a>00142 <span class="keywordflow">else</span>
<a name="l00143"></a>00143 {
<a name="l00144"></a>00144 <span class="keywordflow">if</span> (mDeferral)
<a name="l00145"></a>00145 --mAlarmCount;
<a name="l00146"></a>00146 }
<a name="l00147"></a>00147 mDeferral = type;
<a name="l00148"></a>00148 }
<a name="l00149"></a>00149
<a name="l00150"></a>00150 <span class="keyword">inline</span> <span class="keywordtype">void</span> KAEvent::set_reminder(<span class="keywordtype">int</span> minutes)
<a name="l00151"></a>00151 {
<a name="l00152"></a>00152 <span class="keywordflow">if</span> (!mReminderMinutes)
<a name="l00153"></a>00153 ++mAlarmCount;
<a name="l00154"></a>00154 mReminderMinutes = minutes;
<a name="l00155"></a>00155 mArchiveReminderMinutes = 0;
<a name="l00156"></a>00156 }
<a name="l00157"></a>00157
<a name="l00158"></a>00158 <span class="keyword">inline</span> <span class="keywordtype">void</span> KAEvent::set_archiveReminder()
<a name="l00159"></a>00159 {
<a name="l00160"></a>00160 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l00161"></a>00161 --mAlarmCount;
<a name="l00162"></a>00162 mArchiveReminderMinutes = mReminderMinutes;
<a name="l00163"></a>00163 mReminderMinutes = 0;
<a name="l00164"></a>00164 }
<a name="l00165"></a>00165
<a name="l00166"></a>00166
<a name="l00167"></a>00167 <span class="keywordtype">void</span> KAEvent::copy(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event)
<a name="l00168"></a>00168 {
<a name="l00169"></a>00169 KAAlarmEventBase::copy(event);
<a name="l00170"></a>00170 mTemplateName = <span class="keyword">event</span>.mTemplateName;
<a name="l00171"></a>00171 mAudioFile = <span class="keyword">event</span>.mAudioFile;
<a name="l00172"></a>00172 mPreAction = <span class="keyword">event</span>.mPreAction;
<a name="l00173"></a>00173 mPostAction = <span class="keyword">event</span>.mPostAction;
<a name="l00174"></a>00174 mStartDateTime = <span class="keyword">event</span>.mStartDateTime;
<a name="l00175"></a>00175 mSaveDateTime = <span class="keyword">event</span>.mSaveDateTime;
<a name="l00176"></a>00176 mAtLoginDateTime = <span class="keyword">event</span>.mAtLoginDateTime;
<a name="l00177"></a>00177 mDeferralTime = <span class="keyword">event</span>.mDeferralTime;
<a name="l00178"></a>00178 mDisplayingTime = <span class="keyword">event</span>.mDisplayingTime;
<a name="l00179"></a>00179 mDisplayingFlags = <span class="keyword">event</span>.mDisplayingFlags;
<a name="l00180"></a>00180 mReminderMinutes = <span class="keyword">event</span>.mReminderMinutes;
<a name="l00181"></a>00181 mArchiveReminderMinutes = <span class="keyword">event</span>.mArchiveReminderMinutes;
<a name="l00182"></a>00182 mDeferDefaultMinutes = <span class="keyword">event</span>.mDeferDefaultMinutes;
<a name="l00183"></a>00183 mRevision = <span class="keyword">event</span>.mRevision;
<a name="l00184"></a>00184 mAlarmCount = <span class="keyword">event</span>.mAlarmCount;
<a name="l00185"></a>00185 mDeferral = <span class="keyword">event</span>.mDeferral;
<a name="l00186"></a>00186 mLogFile = <span class="keyword">event</span>.mLogFile;
<a name="l00187"></a>00187 mCommandXterm = <span class="keyword">event</span>.mCommandXterm;
<a name="l00188"></a>00188 mKMailSerialNumber = <span class="keyword">event</span>.mKMailSerialNumber;
<a name="l00189"></a>00189 mCopyToKOrganizer = <span class="keyword">event</span>.mCopyToKOrganizer;
<a name="l00190"></a>00190 mReminderOnceOnly = <span class="keyword">event</span>.mReminderOnceOnly;
<a name="l00191"></a>00191 mMainExpired = <span class="keyword">event</span>.mMainExpired;
<a name="l00192"></a>00192 mArchiveRepeatAtLogin = <span class="keyword">event</span>.mArchiveRepeatAtLogin;
<a name="l00193"></a>00193 mArchive = <span class="keyword">event</span>.mArchive;
<a name="l00194"></a>00194 mTemplateAfterTime = <span class="keyword">event</span>.mTemplateAfterTime;
<a name="l00195"></a>00195 mEnabled = <span class="keyword">event</span>.mEnabled;
<a name="l00196"></a>00196 mUpdated = <span class="keyword">event</span>.mUpdated;
<a name="l00197"></a>00197 <span class="keyword">delete</span> mRecurrence;
<a name="l00198"></a>00198 <span class="keywordflow">if</span> (event.<a class="code" href="classKAEvent.html#cbd05fb3e05ed2029fa5fe3b8f69af6e">mRecurrence</a>)
<a name="l00199"></a>00199 mRecurrence = <span class="keyword">new</span> KARecurrence(*event.<a class="code" href="classKAEvent.html#cbd05fb3e05ed2029fa5fe3b8f69af6e">mRecurrence</a>);
<a name="l00200"></a>00200 <span class="keywordflow">else</span>
<a name="l00201"></a>00201 mRecurrence = 0;
<a name="l00202"></a>00202 }
<a name="l00203"></a>00203
<a name="l00204"></a>00204 <span class="comment">/******************************************************************************</span>
<a name="l00205"></a>00205 <span class="comment"> * Initialise the KAEvent from a KCal::Event.</span>
<a name="l00206"></a>00206 <span class="comment"> */</span>
<a name="l00207"></a>00207 <span class="keywordtype">void</span> KAEvent::set(<span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>& event)
<a name="l00208"></a>00208 {
<a name="l00209"></a>00209 <span class="comment">// Extract status from the event</span>
<a name="l00210"></a>00210 mEventID = <span class="keyword">event</span>.uid();
<a name="l00211"></a>00211 mRevision = <span class="keyword">event</span>.revision();
<a name="l00212"></a>00212 mTemplateName = QString::null;
<a name="l00213"></a>00213 mLogFile = QString::null;
<a name="l00214"></a>00214 mTemplateAfterTime = -1;
<a name="l00215"></a>00215 mBeep = <span class="keyword">false</span>;
<a name="l00216"></a>00216 mSpeak = <span class="keyword">false</span>;
<a name="l00217"></a>00217 mEmailBcc = <span class="keyword">false</span>;
<a name="l00218"></a>00218 mCommandXterm = <span class="keyword">false</span>;
<a name="l00219"></a>00219 mCopyToKOrganizer = <span class="keyword">false</span>;
<a name="l00220"></a>00220 mConfirmAck = <span class="keyword">false</span>;
<a name="l00221"></a>00221 mArchive = <span class="keyword">false</span>;
<a name="l00222"></a>00222 mReminderOnceOnly = <span class="keyword">false</span>;
<a name="l00223"></a>00223 mAutoClose = <span class="keyword">false</span>;
<a name="l00224"></a>00224 mArchiveRepeatAtLogin = <span class="keyword">false</span>;
<a name="l00225"></a>00225 mArchiveReminderMinutes = 0;
<a name="l00226"></a>00226 mDeferDefaultMinutes = 0;
<a name="l00227"></a>00227 mLateCancel = 0;
<a name="l00228"></a>00228 mKMailSerialNumber = 0;
<a name="l00229"></a>00229 mBgColour = QColor(255, 255, 255); <span class="comment">// missing/invalid colour - return white background</span>
<a name="l00230"></a>00230 mFgColour = QColor(0, 0, 0); <span class="comment">// and black foreground</span>
<a name="l00231"></a>00231 mDefaultFont = <span class="keyword">true</span>;
<a name="l00232"></a>00232 mEnabled = <span class="keyword">true</span>;
<a name="l00233"></a>00233 clearRecur();
<a name="l00234"></a>00234 <span class="keywordtype">bool</span> ok;
<a name="l00235"></a>00235 <span class="keywordtype">bool</span> dateOnly = <span class="keyword">false</span>;
<a name="l00236"></a>00236 <span class="keyword">const</span> QStringList cats = <span class="keyword">event</span>.categories();
<a name="l00237"></a>00237 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i = 0; i < cats.count(); ++i)
<a name="l00238"></a>00238 {
<a name="l00239"></a>00239 <span class="keywordflow">if</span> (cats[i] == DATE_ONLY_CATEGORY)
<a name="l00240"></a>00240 dateOnly = <span class="keyword">true</span>;
<a name="l00241"></a>00241 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i] == CONFIRM_ACK_CATEGORY)
<a name="l00242"></a>00242 mConfirmAck = <span class="keyword">true</span>;
<a name="l00243"></a>00243 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i] == EMAIL_BCC_CATEGORY)
<a name="l00244"></a>00244 mEmailBcc = <span class="keyword">true</span>;
<a name="l00245"></a>00245 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i] == ARCHIVE_CATEGORY)
<a name="l00246"></a>00246 mArchive = <span class="keyword">true</span>;
<a name="l00247"></a>00247 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i] == KORGANIZER_CATEGORY)
<a name="l00248"></a>00248 mCopyToKOrganizer = <span class="keyword">true</span>;
<a name="l00249"></a>00249 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(KMAIL_SERNUM_CATEGORY))
<a name="l00250"></a>00250 mKMailSerialNumber = cats[i].mid(KMAIL_SERNUM_CATEGORY.length()).toULong();
<a name="l00251"></a>00251 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(LOG_CATEGORY))
<a name="l00252"></a>00252 {
<a name="l00253"></a>00253 QString logUrl = cats[i].mid(LOG_CATEGORY.length());
<a name="l00254"></a>00254 <span class="keywordflow">if</span> (logUrl == xtermURL)
<a name="l00255"></a>00255 mCommandXterm = <span class="keyword">true</span>;
<a name="l00256"></a>00256 <span class="keywordflow">else</span>
<a name="l00257"></a>00257 mLogFile = logUrl;
<a name="l00258"></a>00258 }
<a name="l00259"></a>00259 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(ARCHIVE_CATEGORIES))
<a name="l00260"></a>00260 {
<a name="l00261"></a>00261 <span class="comment">// It's the archive flag plus a reminder time and/or repeat-at-login flag</span>
<a name="l00262"></a>00262 mArchive = <span class="keyword">true</span>;
<a name="l00263"></a>00263 QStringList list = QStringList::split(<span class="charliteral">';'</span>, cats[i].mid(ARCHIVE_CATEGORIES.length()));
<a name="l00264"></a>00264 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> j = 0; j < list.count(); ++j)
<a name="l00265"></a>00265 {
<a name="l00266"></a>00266 <span class="keywordflow">if</span> (list[j] == AT_LOGIN_TYPE)
<a name="l00267"></a>00267 mArchiveRepeatAtLogin = <span class="keyword">true</span>;
<a name="l00268"></a>00268 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (list[j] == ARCHIVE_REMINDER_ONCE_TYPE)
<a name="l00269"></a>00269 mReminderOnceOnly = <span class="keyword">true</span>;
<a name="l00270"></a>00270 <span class="keywordflow">else</span>
<a name="l00271"></a>00271 {
<a name="l00272"></a>00272 <span class="keywordtype">char</span> ch;
<a name="l00273"></a>00273 <span class="keyword">const</span> <span class="keywordtype">char</span>* cat = list[j].latin1();
<a name="l00274"></a>00274 <span class="keywordflow">while</span> ((ch = *cat) != 0 && (ch < '0' || ch > <span class="charliteral">'9'</span>))
<a name="l00275"></a>00275 ++cat;
<a name="l00276"></a>00276 <span class="keywordflow">if</span> (ch)
<a name="l00277"></a>00277 {
<a name="l00278"></a>00278 mArchiveReminderMinutes = ch - <span class="charliteral">'0'</span>;
<a name="l00279"></a>00279 <span class="keywordflow">while</span> ((ch = *++cat) >= <span class="charliteral">'0'</span> && ch <= <span class="charliteral">'9'</span>)
<a name="l00280"></a>00280 mArchiveReminderMinutes = mArchiveReminderMinutes * 10 + ch - <span class="charliteral">'0'</span>;
<a name="l00281"></a>00281 <span class="keywordflow">switch</span> (ch)
<a name="l00282"></a>00282 {
<a name="l00283"></a>00283 <span class="keywordflow">case</span> <span class="charliteral">'M'</span>: <span class="keywordflow">break</span>;
<a name="l00284"></a>00284 <span class="keywordflow">case</span> <span class="charliteral">'H'</span>: mArchiveReminderMinutes *= 60; <span class="keywordflow">break</span>;
<a name="l00285"></a>00285 <span class="keywordflow">case</span> <span class="charliteral">'D'</span>: mArchiveReminderMinutes *= 1440; <span class="keywordflow">break</span>;
<a name="l00286"></a>00286 }
<a name="l00287"></a>00287 }
<a name="l00288"></a>00288 }
<a name="l00289"></a>00289 }
<a name="l00290"></a>00290 }
<a name="l00291"></a>00291 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(DEFER_CATEGORY))
<a name="l00292"></a>00292 {
<a name="l00293"></a>00293 mDeferDefaultMinutes = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(cats[i].mid(DEFER_CATEGORY.length()).toUInt(&ok));
<a name="l00294"></a>00294 <span class="keywordflow">if</span> (!ok)
<a name="l00295"></a>00295 mDeferDefaultMinutes = 0; <span class="comment">// invalid parameter</span>
<a name="l00296"></a>00296 }
<a name="l00297"></a>00297 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(TEMPL_AFTER_TIME_CATEGORY))
<a name="l00298"></a>00298 {
<a name="l00299"></a>00299 mTemplateAfterTime = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(cats[i].mid(TEMPL_AFTER_TIME_CATEGORY.length()).toUInt(&ok));
<a name="l00300"></a>00300 <span class="keywordflow">if</span> (!ok)
<a name="l00301"></a>00301 mTemplateAfterTime = -1; <span class="comment">// invalid parameter</span>
<a name="l00302"></a>00302 }
<a name="l00303"></a>00303 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(LATE_CANCEL_CATEGORY))
<a name="l00304"></a>00304 {
<a name="l00305"></a>00305 mLateCancel = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(cats[i].mid(LATE_CANCEL_CATEGORY.length()).toUInt(&ok));
<a name="l00306"></a>00306 <span class="keywordflow">if</span> (!ok || !mLateCancel)
<a name="l00307"></a>00307 mLateCancel = 1; <span class="comment">// invalid parameter defaults to 1 minute</span>
<a name="l00308"></a>00308 }
<a name="l00309"></a>00309 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cats[i].startsWith(AUTO_CLOSE_CATEGORY))
<a name="l00310"></a>00310 {
<a name="l00311"></a>00311 mLateCancel = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(cats[i].mid(AUTO_CLOSE_CATEGORY.length()).toUInt(&ok));
<a name="l00312"></a>00312 <span class="keywordflow">if</span> (!ok || !mLateCancel)
<a name="l00313"></a>00313 mLateCancel = 1; <span class="comment">// invalid parameter defaults to 1 minute</span>
<a name="l00314"></a>00314 mAutoClose = <span class="keyword">true</span>;
<a name="l00315"></a>00315 }
<a name="l00316"></a>00316 }
<a name="l00317"></a>00317 QString prop = <span class="keyword">event</span>.customProperty(APPNAME, REPEAT_PROPERTY);
<a name="l00318"></a>00318 <span class="keywordflow">if</span> (!prop.isEmpty())
<a name="l00319"></a>00319 {
<a name="l00320"></a>00320 <span class="comment">// This property is used when the main alarm has expired</span>
<a name="l00321"></a>00321 QStringList list = QStringList::split(<span class="charliteral">':'</span>, prop);
<a name="l00322"></a>00322 <span class="keywordflow">if</span> (list.count() >= 2)
<a name="l00323"></a>00323 {
<a name="l00324"></a>00324 <span class="keywordtype">int</span> interval = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(list[0].toUInt());
<a name="l00325"></a>00325 <span class="keywordtype">int</span> count = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(list[1].toUInt());
<a name="l00326"></a>00326 <span class="keywordflow">if</span> (interval && count)
<a name="l00327"></a>00327 {
<a name="l00328"></a>00328 mRepeatInterval = interval;
<a name="l00329"></a>00329 mRepeatCount = count;
<a name="l00330"></a>00330 }
<a name="l00331"></a>00331 }
<a name="l00332"></a>00332 }
<a name="l00333"></a>00333 mNextMainDateTime = readDateTime(event, dateOnly, mStartDateTime);
<a name="l00334"></a>00334 mSaveDateTime = <span class="keyword">event</span>.created();
<a name="l00335"></a>00335 <span class="keywordflow">if</span> (uidStatus() == TEMPLATE)
<a name="l00336"></a>00336 mTemplateName = <span class="keyword">event</span>.summary();
<a name="l00337"></a>00337 <span class="keywordflow">if</span> (event.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#e6a6ecb86a42f3ae56fdd4e23dd367a7">statusStr</a>() == DISABLED_STATUS)
<a name="l00338"></a>00338 mEnabled = <span class="keyword">false</span>;
<a name="l00339"></a>00339
<a name="l00340"></a>00340 <span class="comment">// Extract status from the event's alarms.</span>
<a name="l00341"></a>00341 <span class="comment">// First set up defaults.</span>
<a name="l00342"></a>00342 mActionType = T_MESSAGE;
<a name="l00343"></a>00343 mMainExpired = <span class="keyword">true</span>;
<a name="l00344"></a>00344 mRepeatAtLogin = <span class="keyword">false</span>;
<a name="l00345"></a>00345 mDisplaying = <span class="keyword">false</span>;
<a name="l00346"></a>00346 mRepeatSound = <span class="keyword">false</span>;
<a name="l00347"></a>00347 mCommandScript = <span class="keyword">false</span>;
<a name="l00348"></a>00348 mDeferral = NO_DEFERRAL;
<a name="l00349"></a>00349 mSoundVolume = -1;
<a name="l00350"></a>00350 mFadeVolume = -1;
<a name="l00351"></a>00351 mFadeSeconds = 0;
<a name="l00352"></a>00352 mReminderMinutes = 0;
<a name="l00353"></a>00353 mEmailFromIdentity = 0;
<a name="l00354"></a>00354 mText = <span class="stringliteral">""</span>;
<a name="l00355"></a>00355 mAudioFile = <span class="stringliteral">""</span>;
<a name="l00356"></a>00356 mPreAction = <span class="stringliteral">""</span>;
<a name="l00357"></a>00357 mPostAction = <span class="stringliteral">""</span>;
<a name="l00358"></a>00358 mEmailSubject = <span class="stringliteral">""</span>;
<a name="l00359"></a>00359 mEmailAddresses.clear();
<a name="l00360"></a>00360 mEmailAttachments.clear();
<a name="l00361"></a>00361
<a name="l00362"></a>00362 <span class="comment">// Extract data from all the event's alarms and index the alarms by sequence number</span>
<a name="l00363"></a>00363 AlarmMap alarmMap;
<a name="l00364"></a>00364 readAlarms(event, &alarmMap);
<a name="l00365"></a>00365
<a name="l00366"></a>00366 <span class="comment">// Incorporate the alarms' details into the overall event</span>
<a name="l00367"></a>00367 mAlarmCount = 0; <span class="comment">// initialise as invalid</span>
<a name="l00368"></a>00368 DateTime alTime;
<a name="l00369"></a>00369 <span class="keywordtype">bool</span> <span class="keyword">set</span> = <span class="keyword">false</span>;
<a name="l00370"></a>00370 <span class="keywordtype">bool</span> isEmailText = <span class="keyword">false</span>;
<a name="l00371"></a>00371 <span class="keywordtype">bool</span> setDeferralTime = <span class="keyword">false</span>;
<a name="l00372"></a>00372 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html">Duration</a> deferralOffset;
<a name="l00373"></a>00373 <span class="keywordflow">for</span> (AlarmMap::ConstIterator it = alarmMap.begin(); it != alarmMap.end(); ++it)
<a name="l00374"></a>00374 {
<a name="l00375"></a>00375 <span class="keyword">const</span> AlarmData& data = it.data();
<a name="l00376"></a>00376 DateTime dateTime = data.alarm->hasStartOffset() ? mNextMainDateTime.addSecs(data.alarm->startOffset().asSeconds()) : data.alarm->time();
<a name="l00377"></a>00377 <span class="keywordflow">switch</span> (data.type)
<a name="l00378"></a>00378 {
<a name="l00379"></a>00379 <span class="keywordflow">case</span> KAAlarm::MAIN__ALARM:
<a name="l00380"></a>00380 mMainExpired = <span class="keyword">false</span>;
<a name="l00381"></a>00381 alTime = dateTime;
<a name="l00382"></a>00382 alTime.setDateOnly(mStartDateTime.isDateOnly());
<a name="l00383"></a>00383 <span class="keywordflow">if</span> (data.repeatCount && data.repeatInterval)
<a name="l00384"></a>00384 {
<a name="l00385"></a>00385 mRepeatInterval = data.repeatInterval; <span class="comment">// values may be adjusted in setRecurrence()</span>
<a name="l00386"></a>00386 mRepeatCount = data.repeatCount;
<a name="l00387"></a>00387 mNextRepeat = data.nextRepeat;
<a name="l00388"></a>00388 }
<a name="l00389"></a>00389 <span class="keywordflow">break</span>;
<a name="l00390"></a>00390 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN__ALARM:
<a name="l00391"></a>00391 mRepeatAtLogin = <span class="keyword">true</span>;
<a name="l00392"></a>00392 mAtLoginDateTime = dateTime.rawDateTime();
<a name="l00393"></a>00393 alTime = mAtLoginDateTime;
<a name="l00394"></a>00394 <span class="keywordflow">break</span>;
<a name="l00395"></a>00395 <span class="keywordflow">case</span> KAAlarm::REMINDER__ALARM:
<a name="l00396"></a>00396 mReminderMinutes = -(data.startOffsetSecs / 60);
<a name="l00397"></a>00397 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l00398"></a>00398 mArchiveReminderMinutes = 0;
<a name="l00399"></a>00399 <span class="keywordflow">break</span>;
<a name="l00400"></a>00400 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_DATE__ALARM:
<a name="l00401"></a>00401 <span class="keywordflow">case</span> KAAlarm::DEFERRED_DATE__ALARM:
<a name="l00402"></a>00402 mDeferral = (data.type == KAAlarm::DEFERRED_REMINDER_DATE__ALARM) ? REMINDER_DEFERRAL : NORMAL_DEFERRAL;
<a name="l00403"></a>00403 mDeferralTime = dateTime;
<a name="l00404"></a>00404 mDeferralTime.setDateOnly(<span class="keyword">true</span>);
<a name="l00405"></a>00405 <span class="keywordflow">if</span> (data.alarm->hasStartOffset())
<a name="l00406"></a>00406 deferralOffset = data.alarm->startOffset();
<a name="l00407"></a>00407 <span class="keywordflow">break</span>;
<a name="l00408"></a>00408 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_TIME__ALARM:
<a name="l00409"></a>00409 <span class="keywordflow">case</span> KAAlarm::DEFERRED_TIME__ALARM:
<a name="l00410"></a>00410 mDeferral = (data.type == KAAlarm::DEFERRED_REMINDER_TIME__ALARM) ? REMINDER_DEFERRAL : NORMAL_DEFERRAL;
<a name="l00411"></a>00411 mDeferralTime = dateTime;
<a name="l00412"></a>00412 <span class="keywordflow">if</span> (data.alarm->hasStartOffset())
<a name="l00413"></a>00413 deferralOffset = data.alarm->startOffset();
<a name="l00414"></a>00414 <span class="keywordflow">break</span>;
<a name="l00415"></a>00415 <span class="keywordflow">case</span> KAAlarm::DISPLAYING__ALARM:
<a name="l00416"></a>00416 {
<a name="l00417"></a>00417 mDisplaying = <span class="keyword">true</span>;
<a name="l00418"></a>00418 mDisplayingFlags = data.displayingFlags;
<a name="l00419"></a>00419 <span class="keywordtype">bool</span> dateOnly = (mDisplayingFlags & DEFERRAL) ? !(mDisplayingFlags & TIMED_FLAG)
<a name="l00420"></a>00420 : mStartDateTime.isDateOnly();
<a name="l00421"></a>00421 mDisplayingTime = dateTime;
<a name="l00422"></a>00422 mDisplayingTime.setDateOnly(dateOnly);
<a name="l00423"></a>00423 alTime = mDisplayingTime;
<a name="l00424"></a>00424 <span class="keywordflow">break</span>;
<a name="l00425"></a>00425 }
<a name="l00426"></a>00426 <span class="keywordflow">case</span> KAAlarm::AUDIO__ALARM:
<a name="l00427"></a>00427 mAudioFile = data.cleanText;
<a name="l00428"></a>00428 mSpeak = data.speak && mAudioFile.isEmpty();
<a name="l00429"></a>00429 mBeep = !mSpeak && mAudioFile.isEmpty();
<a name="l00430"></a>00430 mSoundVolume = (!mBeep && !mSpeak) ? data.soundVolume : -1;
<a name="l00431"></a>00431 mFadeVolume = (mSoundVolume >= 0 && data.fadeSeconds > 0) ? data.fadeVolume : -1;
<a name="l00432"></a>00432 mFadeSeconds = (mFadeVolume >= 0) ? data.fadeSeconds : 0;
<a name="l00433"></a>00433 mRepeatSound = (!mBeep && !mSpeak) && (data.repeatCount < 0);
<a name="l00434"></a>00434 <span class="keywordflow">break</span>;
<a name="l00435"></a>00435 <span class="keywordflow">case</span> KAAlarm::PRE_ACTION__ALARM:
<a name="l00436"></a>00436 mPreAction = data.cleanText;
<a name="l00437"></a>00437 <span class="keywordflow">break</span>;
<a name="l00438"></a>00438 <span class="keywordflow">case</span> KAAlarm::POST_ACTION__ALARM:
<a name="l00439"></a>00439 mPostAction = data.cleanText;
<a name="l00440"></a>00440 <span class="keywordflow">break</span>;
<a name="l00441"></a>00441 <span class="keywordflow">case</span> KAAlarm::INVALID__ALARM:
<a name="l00442"></a>00442 <span class="keywordflow">default</span>:
<a name="l00443"></a>00443 <span class="keywordflow">break</span>;
<a name="l00444"></a>00444 }
<a name="l00445"></a>00445
<a name="l00446"></a>00446 <span class="keywordflow">if</span> (data.reminderOnceOnly)
<a name="l00447"></a>00447 mReminderOnceOnly = <span class="keyword">true</span>;
<a name="l00448"></a>00448 <span class="keywordtype">bool</span> noSetNextTime = <span class="keyword">false</span>;
<a name="l00449"></a>00449 <span class="keywordflow">switch</span> (data.type)
<a name="l00450"></a>00450 {
<a name="l00451"></a>00451 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_DATE__ALARM:
<a name="l00452"></a>00452 <span class="keywordflow">case</span> KAAlarm::DEFERRED_DATE__ALARM:
<a name="l00453"></a>00453 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_TIME__ALARM:
<a name="l00454"></a>00454 <span class="keywordflow">case</span> KAAlarm::DEFERRED_TIME__ALARM:
<a name="l00455"></a>00455 <span class="keywordflow">if</span> (!<span class="keyword">set</span>)
<a name="l00456"></a>00456 {
<a name="l00457"></a>00457 <span class="comment">// The recurrence has to be evaluated before we can</span>
<a name="l00458"></a>00458 <span class="comment">// calculate the time of a deferral alarm.</span>
<a name="l00459"></a>00459 setDeferralTime = <span class="keyword">true</span>;
<a name="l00460"></a>00460 noSetNextTime = <span class="keyword">true</span>;
<a name="l00461"></a>00461 }
<a name="l00462"></a>00462 <span class="comment">// fall through to AT_LOGIN__ALARM etc.</span>
<a name="l00463"></a>00463 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN__ALARM:
<a name="l00464"></a>00464 <span class="keywordflow">case</span> KAAlarm::REMINDER__ALARM:
<a name="l00465"></a>00465 <span class="keywordflow">case</span> KAAlarm::DISPLAYING__ALARM:
<a name="l00466"></a>00466 <span class="keywordflow">if</span> (!<span class="keyword">set</span> && !noSetNextTime)
<a name="l00467"></a>00467 mNextMainDateTime = alTime;
<a name="l00468"></a>00468 <span class="comment">// fall through to MAIN__ALARM</span>
<a name="l00469"></a>00469 <span class="keywordflow">case</span> KAAlarm::MAIN__ALARM:
<a name="l00470"></a>00470 <span class="comment">// Ensure that the basic fields are set up even if there is no main</span>
<a name="l00471"></a>00471 <span class="comment">// alarm in the event (if it has expired and then been deferred)</span>
<a name="l00472"></a>00472 <span class="keywordflow">if</span> (!<span class="keyword">set</span>)
<a name="l00473"></a>00473 {
<a name="l00474"></a>00474 mActionType = data.action;
<a name="l00475"></a>00475 mText = (mActionType == T_COMMAND) ? data.cleanText.stripWhiteSpace() : data.cleanText;
<a name="l00476"></a>00476 <span class="keywordflow">switch</span> (data.action)
<a name="l00477"></a>00477 {
<a name="l00478"></a>00478 <span class="keywordflow">case</span> T_MESSAGE:
<a name="l00479"></a>00479 mFont = data.font;
<a name="l00480"></a>00480 mDefaultFont = data.defaultFont;
<a name="l00481"></a>00481 <span class="keywordflow">if</span> (data.isEmailText)
<a name="l00482"></a>00482 isEmailText = <span class="keyword">true</span>;
<a name="l00483"></a>00483 <span class="comment">// fall through to T_FILE</span>
<a name="l00484"></a>00484 <span class="keywordflow">case</span> T_FILE:
<a name="l00485"></a>00485 mBgColour = data.bgColour;
<a name="l00486"></a>00486 mFgColour = data.fgColour;
<a name="l00487"></a>00487 <span class="keywordflow">break</span>;
<a name="l00488"></a>00488 <span class="keywordflow">case</span> T_COMMAND:
<a name="l00489"></a>00489 mCommandScript = data.commandScript;
<a name="l00490"></a>00490 <span class="keywordflow">break</span>;
<a name="l00491"></a>00491 <span class="keywordflow">case</span> T_EMAIL:
<a name="l00492"></a>00492 mEmailFromIdentity = data.emailFromId;
<a name="l00493"></a>00493 mEmailAddresses = data.emailAddresses;
<a name="l00494"></a>00494 mEmailSubject = data.emailSubject;
<a name="l00495"></a>00495 mEmailAttachments = data.emailAttachments;
<a name="l00496"></a>00496 <span class="keywordflow">break</span>;
<a name="l00497"></a>00497 <span class="keywordflow">default</span>:
<a name="l00498"></a>00498 <span class="keywordflow">break</span>;
<a name="l00499"></a>00499 }
<a name="l00500"></a>00500 <span class="keyword">set</span> = <span class="keyword">true</span>;
<a name="l00501"></a>00501 }
<a name="l00502"></a>00502 <span class="keywordflow">if</span> (data.action == T_FILE && mActionType == T_MESSAGE)
<a name="l00503"></a>00503 mActionType = T_FILE;
<a name="l00504"></a>00504 ++mAlarmCount;
<a name="l00505"></a>00505 <span class="keywordflow">break</span>;
<a name="l00506"></a>00506 <span class="keywordflow">case</span> KAAlarm::AUDIO__ALARM:
<a name="l00507"></a>00507 <span class="keywordflow">case</span> KAAlarm::PRE_ACTION__ALARM:
<a name="l00508"></a>00508 <span class="keywordflow">case</span> KAAlarm::POST_ACTION__ALARM:
<a name="l00509"></a>00509 <span class="keywordflow">case</span> KAAlarm::INVALID__ALARM:
<a name="l00510"></a>00510 <span class="keywordflow">default</span>:
<a name="l00511"></a>00511 <span class="keywordflow">break</span>;
<a name="l00512"></a>00512 }
<a name="l00513"></a>00513 }
<a name="l00514"></a>00514 <span class="keywordflow">if</span> (!isEmailText)
<a name="l00515"></a>00515 mKMailSerialNumber = 0;
<a name="l00516"></a>00516 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l00517"></a>00517 mArchiveRepeatAtLogin = <span class="keyword">false</span>;
<a name="l00518"></a>00518
<a name="l00519"></a>00519 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html">Recurrence</a>* recur = <span class="keyword">event</span>.recurrence();
<a name="l00520"></a>00520 <span class="keywordflow">if</span> (recur && recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#0cd99b7d609400ec9e5cf7439bec132a">doesRecur</a>())
<a name="l00521"></a>00521 {
<a name="l00522"></a>00522 <span class="keywordtype">int</span> nextRepeat = mNextRepeat; <span class="comment">// setRecurrence() clears mNextRepeat</span>
<a name="l00523"></a>00523 setRecurrence(*recur);
<a name="l00524"></a>00524 <span class="keywordflow">if</span> (nextRepeat <= mRepeatCount)
<a name="l00525"></a>00525 mNextRepeat = nextRepeat;
<a name="l00526"></a>00526 }
<a name="l00527"></a>00527 <span class="keywordflow">else</span>
<a name="l00528"></a>00528 checkRepetition();
<a name="l00529"></a>00529
<a name="l00530"></a>00530 <span class="keywordflow">if</span> (mMainExpired && deferralOffset.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#34b69f5167fc798461a45971619227f6">asSeconds</a>() && checkRecur() != KARecurrence::NO_RECUR)
<a name="l00531"></a>00531 {
<a name="l00532"></a>00532 <span class="comment">// Adjust the deferral time for an expired recurrence, since the</span>
<a name="l00533"></a>00533 <span class="comment">// offset is relative to the first actual occurrence.</span>
<a name="l00534"></a>00534 DateTime dt = mRecurrence->getNextDateTime(mStartDateTime.dateTime().addDays(-1));
<a name="l00535"></a>00535 dt.setDateOnly(mStartDateTime.isDateOnly());
<a name="l00536"></a>00536 <span class="keywordflow">if</span> (mDeferralTime.isDateOnly())
<a name="l00537"></a>00537 {
<a name="l00538"></a>00538 mDeferralTime = dt.addSecs(deferralOffset.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#34b69f5167fc798461a45971619227f6">asSeconds</a>());
<a name="l00539"></a>00539 mDeferralTime.setDateOnly(<span class="keyword">true</span>);
<a name="l00540"></a>00540 }
<a name="l00541"></a>00541 <span class="keywordflow">else</span>
<a name="l00542"></a>00542 mDeferralTime = deferralOffset.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#583d2923d2f0e6588213c3f5f8cd3808">end</a>(dt.dateTime());
<a name="l00543"></a>00543 }
<a name="l00544"></a>00544 <span class="keywordflow">if</span> (mDeferral)
<a name="l00545"></a>00545 {
<a name="l00546"></a>00546 <span class="keywordflow">if</span> (mNextMainDateTime == mDeferralTime)
<a name="l00547"></a>00547 mDeferral = CANCEL_DEFERRAL; <span class="comment">// it's a cancelled deferral</span>
<a name="l00548"></a>00548 <span class="keywordflow">if</span> (setDeferralTime)
<a name="l00549"></a>00549 mNextMainDateTime = mDeferralTime;
<a name="l00550"></a>00550 }
<a name="l00551"></a>00551
<a name="l00552"></a>00552 mUpdated = <span class="keyword">false</span>;
<a name="l00553"></a>00553 }
<a name="l00554"></a>00554
<a name="l00555"></a>00555 <span class="comment">/******************************************************************************</span>
<a name="l00556"></a>00556 <span class="comment">* Fetch the start and next date/time for a KCal::Event.</span>
<a name="l00557"></a>00557 <span class="comment">* Reply = next main date/time.</span>
<a name="l00558"></a>00558 <span class="comment">*/</span>
<a name="l00559"></a>00559 DateTime KAEvent::readDateTime(<span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>& event, <span class="keywordtype">bool</span> dateOnly, DateTime& start)
<a name="l00560"></a>00560 {
<a name="l00561"></a>00561 start.set(event.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1IncidenceBase.html#5419a946a4e5715a0c34ec2c7e04cd9b">dtStart</a>(), dateOnly);
<a name="l00562"></a>00562 DateTime next = start;
<a name="l00563"></a>00563 QString prop = <span class="keyword">event</span>.customProperty(APPNAME, NEXT_RECUR_PROPERTY);
<a name="l00564"></a>00564 <span class="keywordflow">if</span> (prop.length() >= 8)
<a name="l00565"></a>00565 {
<a name="l00566"></a>00566 <span class="comment">// The next due recurrence time is specified</span>
<a name="l00567"></a>00567 QDate d(prop.left(4).toInt(), prop.mid(4,2).toInt(), prop.mid(6,2).toInt());
<a name="l00568"></a>00568 <span class="keywordflow">if</span> (d.isValid())
<a name="l00569"></a>00569 {
<a name="l00570"></a>00570 <span class="keywordflow">if</span> (dateOnly && prop.length() == 8)
<a name="l00571"></a>00571 next = d;
<a name="l00572"></a>00572 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!dateOnly && prop.length() == 15 && prop[8] == QChar(<span class="charliteral">'T'</span>))
<a name="l00573"></a>00573 {
<a name="l00574"></a>00574 QTime t(prop.mid(9,2).toInt(), prop.mid(11,2).toInt(), prop.mid(13,2).toInt());
<a name="l00575"></a>00575 <span class="keywordflow">if</span> (t.isValid())
<a name="l00576"></a>00576 next = QDateTime(d, t);
<a name="l00577"></a>00577 }
<a name="l00578"></a>00578 }
<a name="l00579"></a>00579 }
<a name="l00580"></a>00580 <span class="keywordflow">return</span> next;
<a name="l00581"></a>00581 }
<a name="l00582"></a>00582
<a name="l00583"></a>00583 <span class="comment">/******************************************************************************</span>
<a name="l00584"></a>00584 <span class="comment"> * Parse the alarms for a KCal::Event.</span>
<a name="l00585"></a>00585 <span class="comment"> * Reply = map of alarm data, indexed by KAAlarm::Type</span>
<a name="l00586"></a>00586 <span class="comment"> */</span>
<a name="l00587"></a>00587 <span class="keywordtype">void</span> KAEvent::readAlarms(<span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>& event, <span class="keywordtype">void</span>* almap)
<a name="l00588"></a>00588 {
<a name="l00589"></a>00589 AlarmMap* alarmMap = (AlarmMap*)almap;
<a name="l00590"></a>00590 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Alarm::List</a> alarms = <span class="keyword">event</span>.alarms();
<a name="l00591"></a>00591 <span class="keywordflow">for</span> (Alarm::List::ConstIterator it = alarms.begin(); it != alarms.end(); ++it)
<a name="l00592"></a>00592 {
<a name="l00593"></a>00593 <span class="comment">// Parse the next alarm's text</span>
<a name="l00594"></a>00594 AlarmData data;
<a name="l00595"></a>00595 readAlarm(**it, data);
<a name="l00596"></a>00596 <span class="keywordflow">if</span> (data.type != KAAlarm::INVALID__ALARM)
<a name="l00597"></a>00597 alarmMap->insert(data.type, data);
<a name="l00598"></a>00598 }
<a name="l00599"></a>00599 }
<a name="l00600"></a>00600
<a name="l00601"></a>00601 <span class="comment">/******************************************************************************</span>
<a name="l00602"></a>00602 <span class="comment"> * Parse a KCal::Alarm.</span>
<a name="l00603"></a>00603 <span class="comment"> * Reply = alarm ID (sequence number)</span>
<a name="l00604"></a>00604 <span class="comment"> */</span>
<a name="l00605"></a>00605 <span class="keywordtype">void</span> KAEvent::readAlarm(<span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>& alarm, AlarmData& data)
<a name="l00606"></a>00606 {
<a name="l00607"></a>00607 <span class="comment">// Parse the next alarm's text</span>
<a name="l00608"></a>00608 data.alarm = &alarm;
<a name="l00609"></a>00609 data.startOffsetSecs = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#3fdf5078feefc485a6d86d2f9c3e8d6a">startOffset</a>().<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#34b69f5167fc798461a45971619227f6">asSeconds</a>(); <span class="comment">// can have start offset but no valid date/time (e.g. reminder in template)</span>
<a name="l00610"></a>00610 data.displayingFlags = 0;
<a name="l00611"></a>00611 data.isEmailText = <span class="keyword">false</span>;
<a name="l00612"></a>00612 data.nextRepeat = 0;
<a name="l00613"></a>00613 data.repeatInterval = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>();
<a name="l00614"></a>00614 data.repeatCount = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7">repeatCount</a>();
<a name="l00615"></a>00615 <span class="keywordflow">if</span> (data.repeatCount)
<a name="l00616"></a>00616 {
<a name="l00617"></a>00617 <span class="keywordtype">bool</span> ok;
<a name="l00618"></a>00618 QString <span class="keyword">property</span> = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, NEXT_REPEAT_PROPERTY);
<a name="l00619"></a>00619 <span class="keywordtype">int</span> n = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(<span class="keyword">property</span>.toUInt(&ok));
<a name="l00620"></a>00620 <span class="keywordflow">if</span> (ok)
<a name="l00621"></a>00621 data.nextRepeat = n;
<a name="l00622"></a>00622 }
<a name="l00623"></a>00623 <span class="keywordflow">switch</span> (alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#9cec3c8d0c2047ccb8334a54175ca7c7">type</a>())
<a name="l00624"></a>00624 {
<a name="l00625"></a>00625 <span class="keywordflow">case</span> Alarm::Procedure:
<a name="l00626"></a>00626 data.action = T_COMMAND;
<a name="l00627"></a>00627 data.cleanText = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#3bf09593c90acb290202c9cec3e439bc">programFile</a>();
<a name="l00628"></a>00628 data.commandScript = data.cleanText.isEmpty(); <span class="comment">// blank command indicates a script</span>
<a name="l00629"></a>00629 <span class="keywordflow">if</span> (!alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#e7fe383484dbef6c456b71c08e62c783">programArguments</a>().isEmpty())
<a name="l00630"></a>00630 {
<a name="l00631"></a>00631 <span class="keywordflow">if</span> (!data.commandScript)
<a name="l00632"></a>00632 data.cleanText += <span class="charliteral">' '</span>;
<a name="l00633"></a>00633 data.cleanText += alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#e7fe383484dbef6c456b71c08e62c783">programArguments</a>();
<a name="l00634"></a>00634 }
<a name="l00635"></a>00635 <span class="keywordflow">break</span>;
<a name="l00636"></a>00636 <span class="keywordflow">case</span> Alarm::Email:
<a name="l00637"></a>00637 data.action = T_EMAIL;
<a name="l00638"></a>00638 data.emailFromId = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, EMAIL_ID_PROPERTY).toUInt();
<a name="l00639"></a>00639 data.emailAddresses = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#cfe761563112e143ae1b87c31181a69f">mailAddresses</a>();
<a name="l00640"></a>00640 data.emailSubject = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#79ea9526501296c068667e89fb51a066">mailSubject</a>();
<a name="l00641"></a>00641 data.emailAttachments = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#06971aa042d50e6f4a0349b8ad566464">mailAttachments</a>();
<a name="l00642"></a>00642 data.cleanText = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#0ce0f2a11a68c9d8649eeb4bca3aec89">mailText</a>();
<a name="l00643"></a>00643 <span class="keywordflow">break</span>;
<a name="l00644"></a>00644 <span class="keywordflow">case</span> Alarm::Display:
<a name="l00645"></a>00645 {
<a name="l00646"></a>00646 data.action = T_MESSAGE;
<a name="l00647"></a>00647 data.cleanText = AlarmText::fromCalendarText(alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079">text</a>(), data.isEmailText);
<a name="l00648"></a>00648 QString <span class="keyword">property</span> = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, FONT_COLOUR_PROPERTY);
<a name="l00649"></a>00649 QStringList list = QStringList::split(QChar(<span class="charliteral">';'</span>), property, <span class="keyword">true</span>);
<a name="l00650"></a>00650 data.bgColour = QColor(255, 255, 255); <span class="comment">// white</span>
<a name="l00651"></a>00651 data.fgColour = QColor(0, 0, 0); <span class="comment">// black</span>
<a name="l00652"></a>00652 <span class="keywordtype">int</span> n = list.count();
<a name="l00653"></a>00653 <span class="keywordflow">if</span> (n > 0)
<a name="l00654"></a>00654 {
<a name="l00655"></a>00655 <span class="keywordflow">if</span> (!list[0].isEmpty())
<a name="l00656"></a>00656 {
<a name="l00657"></a>00657 QColor c(list[0]);
<a name="l00658"></a>00658 <span class="keywordflow">if</span> (c.isValid())
<a name="l00659"></a>00659 data.bgColour = c;
<a name="l00660"></a>00660 }
<a name="l00661"></a>00661 <span class="keywordflow">if</span> (n > 1 && !list[1].isEmpty())
<a name="l00662"></a>00662 {
<a name="l00663"></a>00663 QColor c(list[1]);
<a name="l00664"></a>00664 <span class="keywordflow">if</span> (c.isValid())
<a name="l00665"></a>00665 data.fgColour = c;
<a name="l00666"></a>00666 }
<a name="l00667"></a>00667 }
<a name="l00668"></a>00668 data.defaultFont = (n <= 2 || list[2].isEmpty());
<a name="l00669"></a>00669 <span class="keywordflow">if</span> (!data.defaultFont)
<a name="l00670"></a>00670 data.font.fromString(list[2]);
<a name="l00671"></a>00671 <span class="keywordflow">break</span>;
<a name="l00672"></a>00672 }
<a name="l00673"></a>00673 <span class="keywordflow">case</span> Alarm::Audio:
<a name="l00674"></a>00674 {
<a name="l00675"></a>00675 data.action = T_AUDIO;
<a name="l00676"></a>00676 data.cleanText = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a9a5cefa19499ffc3f6fbfc7a07cfcb9">audioFile</a>();
<a name="l00677"></a>00677 data.type = KAAlarm::AUDIO__ALARM;
<a name="l00678"></a>00678 data.soundVolume = -1;
<a name="l00679"></a>00679 data.fadeVolume = -1;
<a name="l00680"></a>00680 data.fadeSeconds = 0;
<a name="l00681"></a>00681 data.speak = !alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, SPEAK_PROPERTY).isNull();
<a name="l00682"></a>00682 QString <span class="keyword">property</span> = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, VOLUME_PROPERTY);
<a name="l00683"></a>00683 <span class="keywordflow">if</span> (!property.isEmpty())
<a name="l00684"></a>00684 {
<a name="l00685"></a>00685 <span class="keywordtype">bool</span> ok;
<a name="l00686"></a>00686 <span class="keywordtype">float</span> fadeVolume;
<a name="l00687"></a>00687 <span class="keywordtype">int</span> fadeSecs = 0;
<a name="l00688"></a>00688 QStringList list = QStringList::split(QChar(<span class="charliteral">';'</span>), property, <span class="keyword">true</span>);
<a name="l00689"></a>00689 data.soundVolume = list[0].toFloat(&ok);
<a name="l00690"></a>00690 <span class="keywordflow">if</span> (!ok)
<a name="l00691"></a>00691 data.soundVolume = -1;
<a name="l00692"></a>00692 <span class="keywordflow">if</span> (data.soundVolume >= 0 && list.count() >= 3)
<a name="l00693"></a>00693 {
<a name="l00694"></a>00694 fadeVolume = list[1].toFloat(&ok);
<a name="l00695"></a>00695 <span class="keywordflow">if</span> (ok)
<a name="l00696"></a>00696 fadeSecs = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(list[2].toUInt(&ok));
<a name="l00697"></a>00697 <span class="keywordflow">if</span> (ok && fadeVolume >= 0 && fadeSecs > 0)
<a name="l00698"></a>00698 {
<a name="l00699"></a>00699 data.fadeVolume = fadeVolume;
<a name="l00700"></a>00700 data.fadeSeconds = fadeSecs;
<a name="l00701"></a>00701 }
<a name="l00702"></a>00702 }
<a name="l00703"></a>00703 }
<a name="l00704"></a>00704 <span class="keywordflow">return</span>;
<a name="l00705"></a>00705 }
<a name="l00706"></a>00706 <span class="keywordflow">case</span> Alarm::Invalid:
<a name="l00707"></a>00707 data.type = KAAlarm::INVALID__ALARM;
<a name="l00708"></a>00708 <span class="keywordflow">return</span>;
<a name="l00709"></a>00709 }
<a name="l00710"></a>00710
<a name="l00711"></a>00711 <span class="keywordtype">bool</span> atLogin = <span class="keyword">false</span>;
<a name="l00712"></a>00712 <span class="keywordtype">bool</span> reminder = <span class="keyword">false</span>;
<a name="l00713"></a>00713 <span class="keywordtype">bool</span> deferral = <span class="keyword">false</span>;
<a name="l00714"></a>00714 <span class="keywordtype">bool</span> dateDeferral = <span class="keyword">false</span>;
<a name="l00715"></a>00715 data.reminderOnceOnly = <span class="keyword">false</span>;
<a name="l00716"></a>00716 data.type = KAAlarm::MAIN__ALARM;
<a name="l00717"></a>00717 QString <span class="keyword">property</span> = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, TYPE_PROPERTY);
<a name="l00718"></a>00718 QStringList types = QStringList::split(QChar(<span class="charliteral">','</span>), property);
<a name="l00719"></a>00719 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i = 0; i < types.count(); ++i)
<a name="l00720"></a>00720 {
<a name="l00721"></a>00721 QString type = types[i];
<a name="l00722"></a>00722 <span class="keywordflow">if</span> (type == AT_LOGIN_TYPE)
<a name="l00723"></a>00723 atLogin = <span class="keyword">true</span>;
<a name="l00724"></a>00724 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == FILE_TYPE && data.action == T_MESSAGE)
<a name="l00725"></a>00725 data.action = T_FILE;
<a name="l00726"></a>00726 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == REMINDER_TYPE)
<a name="l00727"></a>00727 reminder = <span class="keyword">true</span>;
<a name="l00728"></a>00728 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == REMINDER_ONCE_TYPE)
<a name="l00729"></a>00729 reminder = data.reminderOnceOnly = <span class="keyword">true</span>;
<a name="l00730"></a>00730 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == TIME_DEFERRAL_TYPE)
<a name="l00731"></a>00731 deferral = <span class="keyword">true</span>;
<a name="l00732"></a>00732 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == DATE_DEFERRAL_TYPE)
<a name="l00733"></a>00733 dateDeferral = deferral = <span class="keyword">true</span>;
<a name="l00734"></a>00734 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == DISPLAYING_TYPE)
<a name="l00735"></a>00735 data.type = KAAlarm::DISPLAYING__ALARM;
<a name="l00736"></a>00736 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == PRE_ACTION_TYPE && data.action == T_COMMAND)
<a name="l00737"></a>00737 data.type = KAAlarm::PRE_ACTION__ALARM;
<a name="l00738"></a>00738 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == POST_ACTION_TYPE && data.action == T_COMMAND)
<a name="l00739"></a>00739 data.type = KAAlarm::POST_ACTION__ALARM;
<a name="l00740"></a>00740 }
<a name="l00741"></a>00741
<a name="l00742"></a>00742 <span class="keywordflow">if</span> (reminder)
<a name="l00743"></a>00743 {
<a name="l00744"></a>00744 <span class="keywordflow">if</span> (data.type == KAAlarm::MAIN__ALARM)
<a name="l00745"></a>00745 data.type = dateDeferral ? KAAlarm::DEFERRED_REMINDER_DATE__ALARM
<a name="l00746"></a>00746 : deferral ? KAAlarm::DEFERRED_REMINDER_TIME__ALARM : KAAlarm::REMINDER__ALARM;
<a name="l00747"></a>00747 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (data.type == KAAlarm::DISPLAYING__ALARM)
<a name="l00748"></a>00748 data.displayingFlags = dateDeferral ? REMINDER | DATE_DEFERRAL
<a name="l00749"></a>00749 : deferral ? REMINDER | TIME_DEFERRAL : REMINDER;
<a name="l00750"></a>00750 }
<a name="l00751"></a>00751 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (deferral)
<a name="l00752"></a>00752 {
<a name="l00753"></a>00753 <span class="keywordflow">if</span> (data.type == KAAlarm::MAIN__ALARM)
<a name="l00754"></a>00754 data.type = dateDeferral ? KAAlarm::DEFERRED_DATE__ALARM : KAAlarm::DEFERRED_TIME__ALARM;
<a name="l00755"></a>00755 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (data.type == KAAlarm::DISPLAYING__ALARM)
<a name="l00756"></a>00756 data.displayingFlags = dateDeferral ? DATE_DEFERRAL : TIME_DEFERRAL;
<a name="l00757"></a>00757 }
<a name="l00758"></a>00758 <span class="keywordflow">if</span> (atLogin)
<a name="l00759"></a>00759 {
<a name="l00760"></a>00760 <span class="keywordflow">if</span> (data.type == KAAlarm::MAIN__ALARM)
<a name="l00761"></a>00761 data.type = KAAlarm::AT_LOGIN__ALARM;
<a name="l00762"></a>00762 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (data.type == KAAlarm::DISPLAYING__ALARM)
<a name="l00763"></a>00763 data.displayingFlags = REPEAT_AT_LOGIN;
<a name="l00764"></a>00764 }
<a name="l00765"></a>00765 <span class="comment">//kdDebug(5950)<<"ReadAlarm(): text="<<alarm.text()<<", time="<<alarm.time().toString()<<", valid time="<<alarm.time().isValid()<<endl;</span>
<a name="l00766"></a>00766 }
<a name="l00767"></a>00767
<a name="l00768"></a>00768 <span class="comment">/******************************************************************************</span>
<a name="l00769"></a>00769 <span class="comment"> * Initialise the KAEvent with the specified parameters.</span>
<a name="l00770"></a>00770 <span class="comment"> */</span>
<a name="l00771"></a>00771 <span class="keywordtype">void</span> KAEvent::set(<span class="keyword">const</span> QDateTime& dateTime, <span class="keyword">const</span> QString& text, <span class="keyword">const</span> QColor& bg, <span class="keyword">const</span> QColor& fg,
<a name="l00772"></a>00772 <span class="keyword">const</span> QFont& font, Action action, <span class="keywordtype">int</span> lateCancel, <span class="keywordtype">int</span> flags)
<a name="l00773"></a>00773 {
<a name="l00774"></a>00774 clearRecur();
<a name="l00775"></a>00775 mStartDateTime.set(dateTime, flags & ANY_TIME);
<a name="l00776"></a>00776 mNextMainDateTime = mStartDateTime;
<a name="l00777"></a>00777 <span class="keywordflow">switch</span> (action)
<a name="l00778"></a>00778 {
<a name="l00779"></a>00779 <span class="keywordflow">case</span> MESSAGE:
<a name="l00780"></a>00780 <span class="keywordflow">case</span> FILE:
<a name="l00781"></a>00781 <span class="keywordflow">case</span> COMMAND:
<a name="l00782"></a>00782 <span class="keywordflow">case</span> EMAIL:
<a name="l00783"></a>00783 mActionType = (KAAlarmEventBase::Type)action;
<a name="l00784"></a>00784 <span class="keywordflow">break</span>;
<a name="l00785"></a>00785 <span class="keywordflow">default</span>:
<a name="l00786"></a>00786 mActionType = T_MESSAGE;
<a name="l00787"></a>00787 <span class="keywordflow">break</span>;
<a name="l00788"></a>00788 }
<a name="l00789"></a>00789 mText = (mActionType == T_COMMAND) ? text.stripWhiteSpace() : text;
<a name="l00790"></a>00790 mEventID = QString::null;
<a name="l00791"></a>00791 mTemplateName = QString::null;
<a name="l00792"></a>00792 mPreAction = QString::null;
<a name="l00793"></a>00793 mPostAction = QString::null;
<a name="l00794"></a>00794 mAudioFile = <span class="stringliteral">""</span>;
<a name="l00795"></a>00795 mSoundVolume = -1;
<a name="l00796"></a>00796 mFadeVolume = -1;
<a name="l00797"></a>00797 mTemplateAfterTime = -1;
<a name="l00798"></a>00798 mFadeSeconds = 0;
<a name="l00799"></a>00799 mBgColour = bg;
<a name="l00800"></a>00800 mFgColour = fg;
<a name="l00801"></a>00801 mFont = font;
<a name="l00802"></a>00802 mAlarmCount = 1;
<a name="l00803"></a>00803 mLateCancel = lateCancel; <span class="comment">// do this before setting flags</span>
<a name="l00804"></a>00804 mDeferral = NO_DEFERRAL; <span class="comment">// do this before setting flags</span>
<a name="l00805"></a>00805
<a name="l00806"></a>00806 KAAlarmEventBase::set(flags & ~READ_ONLY_FLAGS);
<a name="l00807"></a>00807 mStartDateTime.setDateOnly(flags & ANY_TIME);
<a name="l00808"></a>00808 set_deferral((flags & DEFERRAL) ? NORMAL_DEFERRAL : NO_DEFERRAL);
<a name="l00809"></a>00809 mCommandXterm = flags & EXEC_IN_XTERM;
<a name="l00810"></a>00810 mCopyToKOrganizer = flags & COPY_KORGANIZER;
<a name="l00811"></a>00811 mEnabled = !(flags & DISABLED);
<a name="l00812"></a>00812
<a name="l00813"></a>00813 mKMailSerialNumber = 0;
<a name="l00814"></a>00814 mReminderMinutes = 0;
<a name="l00815"></a>00815 mArchiveReminderMinutes = 0;
<a name="l00816"></a>00816 mDeferDefaultMinutes = 0;
<a name="l00817"></a>00817 mArchiveRepeatAtLogin = <span class="keyword">false</span>;
<a name="l00818"></a>00818 mReminderOnceOnly = <span class="keyword">false</span>;
<a name="l00819"></a>00819 mDisplaying = <span class="keyword">false</span>;
<a name="l00820"></a>00820 mMainExpired = <span class="keyword">false</span>;
<a name="l00821"></a>00821 mArchive = <span class="keyword">false</span>;
<a name="l00822"></a>00822 mUpdated = <span class="keyword">false</span>;
<a name="l00823"></a>00823 }
<a name="l00824"></a>00824
<a name="l00825"></a>00825 <span class="comment">/******************************************************************************</span>
<a name="l00826"></a>00826 <span class="comment"> * Initialise a command KAEvent.</span>
<a name="l00827"></a>00827 <span class="comment"> */</span>
<a name="l00828"></a>00828 <span class="keywordtype">void</span> KAEvent::setCommand(<span class="keyword">const</span> QDate& d, <span class="keyword">const</span> QString& command, <span class="keywordtype">int</span> lateCancel, <span class="keywordtype">int</span> flags, <span class="keyword">const</span> QString& logfile)
<a name="l00829"></a>00829 {
<a name="l00830"></a>00830 <span class="keywordflow">if</span> (!logfile.isEmpty())
<a name="l00831"></a>00831 flags &= ~EXEC_IN_XTERM;
<a name="l00832"></a>00832 <span class="keyword">set</span>(d, command, QColor(), QColor(), QFont(), COMMAND, lateCancel, flags | ANY_TIME);
<a name="l00833"></a>00833 mLogFile = logfile;
<a name="l00834"></a>00834 }
<a name="l00835"></a>00835
<a name="l00836"></a>00836 <span class="keywordtype">void</span> KAEvent::setCommand(<span class="keyword">const</span> QDateTime& dt, <span class="keyword">const</span> QString& command, <span class="keywordtype">int</span> lateCancel, <span class="keywordtype">int</span> flags, <span class="keyword">const</span> QString& logfile)
<a name="l00837"></a>00837 {
<a name="l00838"></a>00838 <span class="keywordflow">if</span> (!logfile.isEmpty())
<a name="l00839"></a>00839 flags &= ~EXEC_IN_XTERM;
<a name="l00840"></a>00840 <span class="keyword">set</span>(dt, command, QColor(), QColor(), QFont(), COMMAND, lateCancel, flags);
<a name="l00841"></a>00841 mLogFile = logfile;
<a name="l00842"></a>00842 }
<a name="l00843"></a>00843
<a name="l00844"></a>00844 <span class="keywordtype">void</span> KAEvent::setLogFile(<span class="keyword">const</span> QString& logfile)
<a name="l00845"></a>00845 {
<a name="l00846"></a>00846 mLogFile = logfile;
<a name="l00847"></a>00847 <span class="keywordflow">if</span> (!logfile.isEmpty())
<a name="l00848"></a>00848 mCommandXterm = <span class="keyword">false</span>;
<a name="l00849"></a>00849 }
<a name="l00850"></a>00850
<a name="l00851"></a>00851 <span class="comment">/******************************************************************************</span>
<a name="l00852"></a>00852 <span class="comment"> * Initialise an email KAEvent.</span>
<a name="l00853"></a>00853 <span class="comment"> */</span>
<a name="l00854"></a>00854 <span class="keywordtype">void</span> KAEvent::setEmail(<span class="keyword">const</span> QDate& d, uint from, <span class="keyword">const</span> EmailAddressList& addresses, <span class="keyword">const</span> QString& subject,
<a name="l00855"></a>00855 <span class="keyword">const</span> QString& message, <span class="keyword">const</span> QStringList& attachments, <span class="keywordtype">int</span> lateCancel, <span class="keywordtype">int</span> flags)
<a name="l00856"></a>00856 {
<a name="l00857"></a>00857 <span class="keyword">set</span>(d, message, QColor(), QColor(), QFont(), EMAIL, lateCancel, flags | ANY_TIME);
<a name="l00858"></a>00858 mEmailFromIdentity = from;
<a name="l00859"></a>00859 mEmailAddresses = addresses;
<a name="l00860"></a>00860 mEmailSubject = subject;
<a name="l00861"></a>00861 mEmailAttachments = attachments;
<a name="l00862"></a>00862 }
<a name="l00863"></a>00863
<a name="l00864"></a>00864 <span class="keywordtype">void</span> KAEvent::setEmail(<span class="keyword">const</span> QDateTime& dt, uint from, <span class="keyword">const</span> EmailAddressList& addresses, <span class="keyword">const</span> QString& subject,
<a name="l00865"></a>00865 <span class="keyword">const</span> QString& message, <span class="keyword">const</span> QStringList& attachments, <span class="keywordtype">int</span> lateCancel, <span class="keywordtype">int</span> flags)
<a name="l00866"></a>00866 {
<a name="l00867"></a>00867 <span class="keyword">set</span>(dt, message, QColor(), QColor(), QFont(), EMAIL, lateCancel, flags);
<a name="l00868"></a>00868 mEmailFromIdentity = from;
<a name="l00869"></a>00869 mEmailAddresses = addresses;
<a name="l00870"></a>00870 mEmailSubject = subject;
<a name="l00871"></a>00871 mEmailAttachments = attachments;
<a name="l00872"></a>00872 }
<a name="l00873"></a>00873
<a name="l00874"></a>00874 <span class="keywordtype">void</span> KAEvent::setEmail(uint from, <span class="keyword">const</span> EmailAddressList& addresses, <span class="keyword">const</span> QString& subject, <span class="keyword">const</span> QStringList& attachments)
<a name="l00875"></a>00875 {
<a name="l00876"></a>00876 mEmailFromIdentity = from;
<a name="l00877"></a>00877 mEmailAddresses = addresses;
<a name="l00878"></a>00878 mEmailSubject = subject;
<a name="l00879"></a>00879 mEmailAttachments = attachments;
<a name="l00880"></a>00880 }
<a name="l00881"></a>00881
<a name="l00882"></a>00882 <span class="keywordtype">void</span> KAEvent::setAudioFile(<span class="keyword">const</span> QString& filename, <span class="keywordtype">float</span> volume, <span class="keywordtype">float</span> fadeVolume, <span class="keywordtype">int</span> fadeSeconds)
<a name="l00883"></a>00883 {
<a name="l00884"></a>00884 mAudioFile = filename;
<a name="l00885"></a>00885 mSoundVolume = filename.isEmpty() ? -1 : volume;
<a name="l00886"></a>00886 <span class="keywordflow">if</span> (mSoundVolume >= 0)
<a name="l00887"></a>00887 {
<a name="l00888"></a>00888 mFadeVolume = (fadeSeconds > 0) ? fadeVolume : -1;
<a name="l00889"></a>00889 mFadeSeconds = (mFadeVolume >= 0) ? fadeSeconds : 0;
<a name="l00890"></a>00890 }
<a name="l00891"></a>00891 <span class="keywordflow">else</span>
<a name="l00892"></a>00892 {
<a name="l00893"></a>00893 mFadeVolume = -1;
<a name="l00894"></a>00894 mFadeSeconds = 0;
<a name="l00895"></a>00895 }
<a name="l00896"></a>00896 mUpdated = <span class="keyword">true</span>;
<a name="l00897"></a>00897 }
<a name="l00898"></a>00898
<a name="l00899"></a>00899 <span class="keywordtype">void</span> KAEvent::setReminder(<span class="keywordtype">int</span> minutes, <span class="keywordtype">bool</span> onceOnly)
<a name="l00900"></a>00900 {
<a name="l00901"></a>00901 set_reminder(minutes);
<a name="l00902"></a>00902 mReminderOnceOnly = onceOnly;
<a name="l00903"></a>00903 mUpdated = <span class="keyword">true</span>;
<a name="l00904"></a>00904 }
<a name="l00905"></a>00905
<a name="l00906"></a>00906 <span class="comment">/******************************************************************************</span>
<a name="l00907"></a>00907 <span class="comment"> * Return the time of the next scheduled occurrence of the event.</span>
<a name="l00908"></a>00908 <span class="comment"> * Reminders and deferred reminders can optionally be ignored.</span>
<a name="l00909"></a>00909 <span class="comment"> */</span>
<a name="l00910"></a>00910 DateTime KAEvent::displayDateTime()<span class="keyword"> const</span>
<a name="l00911"></a>00911 <span class="keyword"></span>{
<a name="l00912"></a>00912 DateTime dt = mainDateTime(<span class="keyword">true</span>);
<a name="l00913"></a>00913 <span class="keywordflow">if</span> (mDeferral > 0 && mDeferral != REMINDER_DEFERRAL)
<a name="l00914"></a>00914 {
<a name="l00915"></a>00915 <span class="keywordflow">if</span> (mMainExpired)
<a name="l00916"></a>00916 <span class="keywordflow">return</span> mDeferralTime;
<a name="l00917"></a>00917 <span class="keywordflow">return</span> QMIN(mDeferralTime, dt);
<a name="l00918"></a>00918 }
<a name="l00919"></a>00919 <span class="keywordflow">return</span> dt;
<a name="l00920"></a>00920 }
<a name="l00921"></a>00921
<a name="l00922"></a>00922 <span class="comment">/******************************************************************************</span>
<a name="l00923"></a>00923 <span class="comment"> * Convert a unique ID to indicate that the event is in a specified calendar file.</span>
<a name="l00924"></a>00924 <span class="comment"> */</span>
<a name="l00925"></a>00925 QString KAEvent::uid(<span class="keyword">const</span> QString& <span class="keywordtype">id</span>, <a class="code" href="classKAEvent.html#6699b6a06aa2aec3f59ea0ca29f7365c" title="The category of an event, indicated by the middle part of its UID.">Status</a> status)
<a name="l00926"></a>00926 {
<a name="l00927"></a>00927 QString result = id;
<a name="l00928"></a>00928 <a class="code" href="classKAEvent.html#6699b6a06aa2aec3f59ea0ca29f7365c" title="The category of an event, indicated by the middle part of its UID.">Status</a> oldStatus;
<a name="l00929"></a>00929 <span class="keywordtype">int</span> i, len;
<a name="l00930"></a>00930 <span class="keywordflow">if</span> ((i = result.find(EXPIRED_UID)) > 0)
<a name="l00931"></a>00931 {
<a name="l00932"></a>00932 oldStatus = EXPIRED;
<a name="l00933"></a>00933 len = EXPIRED_UID.length();
<a name="l00934"></a>00934 }
<a name="l00935"></a>00935 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ((i = result.find(DISPLAYING_UID)) > 0)
<a name="l00936"></a>00936 {
<a name="l00937"></a>00937 oldStatus = DISPLAYING;
<a name="l00938"></a>00938 len = DISPLAYING_UID.length();
<a name="l00939"></a>00939 }
<a name="l00940"></a>00940 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ((i = result.find(TEMPLATE_UID)) > 0)
<a name="l00941"></a>00941 {
<a name="l00942"></a>00942 oldStatus = TEMPLATE;
<a name="l00943"></a>00943 len = TEMPLATE_UID.length();
<a name="l00944"></a>00944 }
<a name="l00945"></a>00945 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ((i = result.find(KORGANIZER_UID)) > 0)
<a name="l00946"></a>00946 {
<a name="l00947"></a>00947 oldStatus = KORGANIZER;
<a name="l00948"></a>00948 len = KORGANIZER_UID.length();
<a name="l00949"></a>00949 }
<a name="l00950"></a>00950 <span class="keywordflow">else</span>
<a name="l00951"></a>00951 {
<a name="l00952"></a>00952 oldStatus = ACTIVE;
<a name="l00953"></a>00953 i = result.findRev(<span class="charliteral">'-'</span>);
<a name="l00954"></a>00954 len = 1;
<a name="l00955"></a>00955 }
<a name="l00956"></a>00956 <span class="keywordflow">if</span> (status != oldStatus && i > 0)
<a name="l00957"></a>00957 {
<a name="l00958"></a>00958 QString part;
<a name="l00959"></a>00959 <span class="keywordflow">switch</span> (status)
<a name="l00960"></a>00960 {
<a name="l00961"></a>00961 <span class="keywordflow">case</span> ACTIVE: part = <span class="stringliteral">"-"</span>; <span class="keywordflow">break</span>;
<a name="l00962"></a>00962 <span class="keywordflow">case</span> EXPIRED: part = EXPIRED_UID; <span class="keywordflow">break</span>;
<a name="l00963"></a>00963 <span class="keywordflow">case</span> DISPLAYING: part = DISPLAYING_UID; <span class="keywordflow">break</span>;
<a name="l00964"></a>00964 <span class="keywordflow">case</span> TEMPLATE: part = TEMPLATE_UID; <span class="keywordflow">break</span>;
<a name="l00965"></a>00965 <span class="keywordflow">case</span> KORGANIZER: part = KORGANIZER_UID; <span class="keywordflow">break</span>;
<a name="l00966"></a>00966 }
<a name="l00967"></a>00967 result.replace(i, len, part);
<a name="l00968"></a>00968 }
<a name="l00969"></a>00969 <span class="keywordflow">return</span> result;
<a name="l00970"></a>00970 }
<a name="l00971"></a>00971
<a name="l00972"></a>00972 <span class="comment">/******************************************************************************</span>
<a name="l00973"></a>00973 <span class="comment"> * Get the calendar type for a unique ID.</span>
<a name="l00974"></a>00974 <span class="comment"> */</span>
<a name="l00975"></a>00975 <a class="code" href="classKAEvent.html#6699b6a06aa2aec3f59ea0ca29f7365c" title="The category of an event, indicated by the middle part of its UID.">KAEvent::Status</a> KAEvent::uidStatus(<span class="keyword">const</span> QString& uid)
<a name="l00976"></a>00976 {
<a name="l00977"></a>00977 <span class="keywordflow">if</span> (uid.find(EXPIRED_UID) > 0)
<a name="l00978"></a>00978 <span class="keywordflow">return</span> EXPIRED;
<a name="l00979"></a>00979 <span class="keywordflow">if</span> (uid.find(DISPLAYING_UID) > 0)
<a name="l00980"></a>00980 <span class="keywordflow">return</span> DISPLAYING;
<a name="l00981"></a>00981 <span class="keywordflow">if</span> (uid.find(TEMPLATE_UID) > 0)
<a name="l00982"></a>00982 <span class="keywordflow">return</span> TEMPLATE;
<a name="l00983"></a>00983 <span class="keywordflow">if</span> (uid.find(KORGANIZER_UID) > 0)
<a name="l00984"></a>00984 <span class="keywordflow">return</span> KORGANIZER;
<a name="l00985"></a>00985 <span class="keywordflow">return</span> ACTIVE;
<a name="l00986"></a>00986 }
<a name="l00987"></a>00987
<a name="l00988"></a>00988 <span class="keywordtype">int</span> KAEvent::flags()<span class="keyword"> const</span>
<a name="l00989"></a>00989 <span class="keyword"></span>{
<a name="l00990"></a>00990 <span class="keywordflow">return</span> KAAlarmEventBase::flags()
<a name="l00991"></a>00991 | (mStartDateTime.isDateOnly() ? ANY_TIME : 0)
<a name="l00992"></a>00992 | (mDeferral > 0 ? DEFERRAL : 0)
<a name="l00993"></a>00993 | (mCommandXterm ? EXEC_IN_XTERM : 0)
<a name="l00994"></a>00994 | (mCopyToKOrganizer ? COPY_KORGANIZER : 0)
<a name="l00995"></a>00995 | (mEnabled ? 0 : DISABLED);
<a name="l00996"></a>00996 }
<a name="l00997"></a>00997
<a name="l00998"></a>00998 <span class="comment">/******************************************************************************</span>
<a name="l00999"></a>00999 <span class="comment"> * Create a new Event from the KAEvent data.</span>
<a name="l01000"></a>01000 <span class="comment"> */</span>
<a name="l01001"></a>01001 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* KAEvent::event()<span class="keyword"> const</span>
<a name="l01002"></a>01002 <span class="keyword"></span>{
<a name="l01003"></a>01003 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">KCal::Event</a>* ev = <span class="keyword">new</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">KCal::Event</a>;
<a name="l01004"></a>01004 ev-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1IncidenceBase.html#cc1c34f32a0b3057be593a1ad492b48f">setUid</a>(mEventID);
<a name="l01005"></a>01005 updateKCalEvent(*ev, <span class="keyword">false</span>);
<a name="l01006"></a>01006 <span class="keywordflow">return</span> ev;
<a name="l01007"></a>01007 }
<a name="l01008"></a>01008
<a name="l01009"></a>01009 <span class="comment">/******************************************************************************</span>
<a name="l01010"></a>01010 <span class="comment"> * Update an existing KCal::Event with the KAEvent data.</span>
<a name="l01011"></a>01011 <span class="comment"> * If 'original' is true, the event start date/time is adjusted to its original</span>
<a name="l01012"></a>01012 <span class="comment"> * value instead of its next occurrence, and the expired main alarm is</span>
<a name="l01013"></a>01013 <span class="comment"> * reinstated.</span>
<a name="l01014"></a>01014 <span class="comment"> */</span>
<a name="l01015"></a>01015 <span class="keywordtype">bool</span> KAEvent::updateKCalEvent(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>& ev, <span class="keywordtype">bool</span> checkUid, <span class="keywordtype">bool</span> original, <span class="keywordtype">bool</span> cancelCancelledDefer)<span class="keyword"> const</span>
<a name="l01016"></a>01016 <span class="keyword"></span>{
<a name="l01017"></a>01017 <span class="keywordflow">if</span> (checkUid && !mEventID.isEmpty() && mEventID != ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1IncidenceBase.html#75c8bd2df73c5a62bd7cf77c2ac4d3c6">uid</a>()
<a name="l01018"></a>01018 || !mAlarmCount && (!original || !mMainExpired))
<a name="l01019"></a>01019 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01020"></a>01020
<a name="l01021"></a>01021 checkRecur(); <span class="comment">// ensure recurrence/repetition data is consistent</span>
<a name="l01022"></a>01022 <span class="keywordtype">bool</span> readOnly = ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1IncidenceBase.html#ed5d0696a6288811b20343d6e467a93a">isReadOnly</a>();
<a name="l01023"></a>01023 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#0cb14b1419d3fad1d3c19c9a3e98a57b">setReadOnly</a>(<span class="keyword">false</span>);
<a name="l01024"></a>01024 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html#4bddb1f05d556e28526886b1448f95af">setTransparency</a>(Event::Transparent);
<a name="l01025"></a>01025
<a name="l01026"></a>01026 <span class="comment">// Set up event-specific data</span>
<a name="l01027"></a>01027
<a name="l01028"></a>01028 <span class="comment">// Set up custom properties.</span>
<a name="l01029"></a>01029 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#d47e81fd7641d34b3f41809889e2d154">removeCustomProperty</a>(APPNAME, NEXT_RECUR_PROPERTY);
<a name="l01030"></a>01030 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#d47e81fd7641d34b3f41809889e2d154">removeCustomProperty</a>(APPNAME, REPEAT_PROPERTY);
<a name="l01031"></a>01031
<a name="l01032"></a>01032 QStringList cats;
<a name="l01033"></a>01033 <span class="keywordflow">if</span> (mStartDateTime.isDateOnly())
<a name="l01034"></a>01034 cats.append(DATE_ONLY_CATEGORY);
<a name="l01035"></a>01035 <span class="keywordflow">if</span> (mConfirmAck)
<a name="l01036"></a>01036 cats.append(CONFIRM_ACK_CATEGORY);
<a name="l01037"></a>01037 <span class="keywordflow">if</span> (mEmailBcc)
<a name="l01038"></a>01038 cats.append(EMAIL_BCC_CATEGORY);
<a name="l01039"></a>01039 <span class="keywordflow">if</span> (mKMailSerialNumber)
<a name="l01040"></a>01040 cats.append(QString(<span class="stringliteral">"%1%2"</span>).arg(KMAIL_SERNUM_CATEGORY).arg(mKMailSerialNumber));
<a name="l01041"></a>01041 <span class="keywordflow">if</span> (mCopyToKOrganizer)
<a name="l01042"></a>01042 cats.append(KORGANIZER_CATEGORY);
<a name="l01043"></a>01043 <span class="keywordflow">if</span> (mCommandXterm)
<a name="l01044"></a>01044 cats.append(LOG_CATEGORY + xtermURL);
<a name="l01045"></a>01045 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!mLogFile.isEmpty())
<a name="l01046"></a>01046 cats.append(LOG_CATEGORY + mLogFile);
<a name="l01047"></a>01047 <span class="keywordflow">if</span> (mLateCancel)
<a name="l01048"></a>01048 cats.append(QString(<span class="stringliteral">"%1%2"</span>).arg(mAutoClose ? AUTO_CLOSE_CATEGORY : LATE_CANCEL_CATEGORY).arg(mLateCancel));
<a name="l01049"></a>01049 <span class="keywordflow">if</span> (mDeferDefaultMinutes)
<a name="l01050"></a>01050 cats.append(QString(<span class="stringliteral">"%1%2"</span>).arg(DEFER_CATEGORY).arg(mDeferDefaultMinutes));
<a name="l01051"></a>01051 <span class="keywordflow">if</span> (!mTemplateName.isEmpty() && mTemplateAfterTime >= 0)
<a name="l01052"></a>01052 cats.append(QString(<span class="stringliteral">"%1%2"</span>).arg(TEMPL_AFTER_TIME_CATEGORY).arg(mTemplateAfterTime));
<a name="l01053"></a>01053 <span class="keywordflow">if</span> (mArchive && !original)
<a name="l01054"></a>01054 {
<a name="l01055"></a>01055 QStringList params;
<a name="l01056"></a>01056 <span class="keywordflow">if</span> (mArchiveReminderMinutes)
<a name="l01057"></a>01057 {
<a name="l01058"></a>01058 <span class="keywordflow">if</span> (mReminderOnceOnly)
<a name="l01059"></a>01059 params += ARCHIVE_REMINDER_ONCE_TYPE;
<a name="l01060"></a>01060 <span class="keywordtype">char</span> unit = <span class="charliteral">'M'</span>;
<a name="l01061"></a>01061 <span class="keywordtype">int</span> count = mArchiveReminderMinutes;
<a name="l01062"></a>01062 <span class="keywordflow">if</span> (count % 1440 == 0)
<a name="l01063"></a>01063 {
<a name="l01064"></a>01064 unit = <span class="charliteral">'D'</span>;
<a name="l01065"></a>01065 count /= 1440;
<a name="l01066"></a>01066 }
<a name="l01067"></a>01067 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (count % 60 == 0)
<a name="l01068"></a>01068 {
<a name="l01069"></a>01069 unit = <span class="charliteral">'H'</span>;
<a name="l01070"></a>01070 count /= 60;
<a name="l01071"></a>01071 }
<a name="l01072"></a>01072 params += QString(<span class="stringliteral">"%1%2"</span>).arg(count).arg(unit);
<a name="l01073"></a>01073 }
<a name="l01074"></a>01074 <span class="keywordflow">if</span> (mArchiveRepeatAtLogin)
<a name="l01075"></a>01075 params += AT_LOGIN_TYPE;
<a name="l01076"></a>01076 <span class="keywordflow">if</span> (params.count() > 0)
<a name="l01077"></a>01077 {
<a name="l01078"></a>01078 QString cat = ARCHIVE_CATEGORIES;
<a name="l01079"></a>01079 cat += params.join(QString::fromLatin1(<span class="stringliteral">";"</span>));
<a name="l01080"></a>01080 cats.append(cat);
<a name="l01081"></a>01081 }
<a name="l01082"></a>01082 <span class="keywordflow">else</span>
<a name="l01083"></a>01083 cats.append(ARCHIVE_CATEGORY);
<a name="l01084"></a>01084 }
<a name="l01085"></a>01085 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#e1c00b65d6803d1140ce5e79c5935ab6">setCategories</a>(cats);
<a name="l01086"></a>01086 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#2a8bb37db6b597048ce0db73298eab5e">setCustomStatus</a>(mEnabled ? QString::null : DISABLED_STATUS);
<a name="l01087"></a>01087 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#d9cf94ebb636d6ce56b8f2f74d5c51d3">setRevision</a>(mRevision);
<a name="l01088"></a>01088 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#309958edb7c5216871befd3c8dd82006">clearAlarms</a>();
<a name="l01089"></a>01089
<a name="l01090"></a>01090 <span class="comment">// Always set DTSTART as date/time, since alarm times can only be specified</span>
<a name="l01091"></a>01091 <span class="comment">// in local time (instead of UTC) if they are relative to a DTSTART or DTEND</span>
<a name="l01092"></a>01092 <span class="comment">// which is also specified in local time. Instead of calling setFloats() to</span>
<a name="l01093"></a>01093 <span class="comment">// indicate a date-only event, the category "DATE" is included.</span>
<a name="l01094"></a>01094 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#e3042339856d8295139b32fc40064876">setDtStart</a>(mStartDateTime.dateTime());
<a name="l01095"></a>01095 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#8a9b61c884ea9450c9ebea186e73ecc6">setFloats</a>(<span class="keyword">false</span>);
<a name="l01096"></a>01096 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html#2ed997343d0055031ec076d6bc101eee">setHasEndDate</a>(<span class="keyword">false</span>);
<a name="l01097"></a>01097
<a name="l01098"></a>01098 DateTime dtMain = original ? mStartDateTime : mNextMainDateTime;
<a name="l01099"></a>01099 <span class="keywordtype">int</span> ancillaryType = 0; <span class="comment">// 0 = invalid, 1 = time, 2 = offset</span>
<a name="l01100"></a>01100 DateTime ancillaryTime; <span class="comment">// time for ancillary alarms (audio, pre-action, etc)</span>
<a name="l01101"></a>01101 <span class="keywordtype">int</span> ancillaryOffset = 0; <span class="comment">// start offset for ancillary alarms</span>
<a name="l01102"></a>01102 <span class="keywordflow">if</span> (!mMainExpired || original)
<a name="l01103"></a>01103 {
<a name="l01104"></a>01104 <span class="comment">/* The alarm offset must always be zero for the main alarm. To determine</span>
<a name="l01105"></a>01105 <span class="comment"> * which recurrence is due, the property X-KDE-KALARM_NEXTRECUR is used.</span>
<a name="l01106"></a>01106 <span class="comment"> * If the alarm offset was non-zero, exception dates and rules would not</span>
<a name="l01107"></a>01107 <span class="comment"> * work since they apply to the event time, not the alarm time.</span>
<a name="l01108"></a>01108 <span class="comment"> */</span>
<a name="l01109"></a>01109 <span class="keywordflow">if</span> (!original && checkRecur() != KARecurrence::NO_RECUR)
<a name="l01110"></a>01110 {
<a name="l01111"></a>01111 QDateTime dt = mNextMainDateTime.dateTime();
<a name="l01112"></a>01112 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, NEXT_RECUR_PROPERTY,
<a name="l01113"></a>01113 dt.toString(mNextMainDateTime.isDateOnly() ? <span class="stringliteral">"yyyyMMdd"</span> : <span class="stringliteral">"yyyyMMddThhmmss"</span>));
<a name="l01114"></a>01114 }
<a name="l01115"></a>01115 <span class="comment">// Add the main alarm</span>
<a name="l01116"></a>01116 initKCalAlarm(ev, 0, QStringList(), KAAlarm::MAIN_ALARM);
<a name="l01117"></a>01117 ancillaryOffset = 0;
<a name="l01118"></a>01118 ancillaryType = dtMain.isValid() ? 2 : 0;
<a name="l01119"></a>01119 }
<a name="l01120"></a>01120 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mRepeatCount && mRepeatInterval)
<a name="l01121"></a>01121 {
<a name="l01122"></a>01122 <span class="comment">// Alarm repetition is normally held in the main alarm, but since</span>
<a name="l01123"></a>01123 <span class="comment">// the main alarm has expired, store in a custom property.</span>
<a name="l01124"></a>01124 QString param = QString(<span class="stringliteral">"%1:%2"</span>).arg(mRepeatInterval).arg(mRepeatCount);
<a name="l01125"></a>01125 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, REPEAT_PROPERTY, param);
<a name="l01126"></a>01126 }
<a name="l01127"></a>01127
<a name="l01128"></a>01128 <span class="comment">// Add subsidiary alarms</span>
<a name="l01129"></a>01129 <span class="keywordflow">if</span> (mRepeatAtLogin || mArchiveRepeatAtLogin && original)
<a name="l01130"></a>01130 {
<a name="l01131"></a>01131 DateTime dtl;
<a name="l01132"></a>01132 <span class="keywordflow">if</span> (mArchiveRepeatAtLogin)
<a name="l01133"></a>01133 dtl = mStartDateTime.dateTime().addDays(-1);
<a name="l01134"></a>01134 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mAtLoginDateTime.isValid())
<a name="l01135"></a>01135 dtl = mAtLoginDateTime;
<a name="l01136"></a>01136 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mStartDateTime.isDateOnly())
<a name="l01137"></a>01137 dtl = QDate::currentDate().addDays(-1);
<a name="l01138"></a>01138 <span class="keywordflow">else</span>
<a name="l01139"></a>01139 dtl = QDateTime::currentDateTime();
<a name="l01140"></a>01140 initKCalAlarm(ev, dtl, AT_LOGIN_TYPE);
<a name="l01141"></a>01141 <span class="keywordflow">if</span> (!ancillaryType && dtl.isValid())
<a name="l01142"></a>01142 {
<a name="l01143"></a>01143 ancillaryTime = dtl;
<a name="l01144"></a>01144 ancillaryType = 1;
<a name="l01145"></a>01145 }
<a name="l01146"></a>01146 }
<a name="l01147"></a>01147 <span class="keywordflow">if</span> (mReminderMinutes || mArchiveReminderMinutes && original)
<a name="l01148"></a>01148 {
<a name="l01149"></a>01149 <span class="keywordtype">int</span> minutes = mReminderMinutes ? mReminderMinutes : mArchiveReminderMinutes;
<a name="l01150"></a>01150 initKCalAlarm(ev, -minutes * 60, QStringList(mReminderOnceOnly ? REMINDER_ONCE_TYPE : REMINDER_TYPE));
<a name="l01151"></a>01151 <span class="keywordflow">if</span> (!ancillaryType)
<a name="l01152"></a>01152 {
<a name="l01153"></a>01153 ancillaryOffset = -minutes * 60;
<a name="l01154"></a>01154 ancillaryType = 2;
<a name="l01155"></a>01155 }
<a name="l01156"></a>01156 }
<a name="l01157"></a>01157 <span class="keywordflow">if</span> (mDeferral > 0 || mDeferral == CANCEL_DEFERRAL && !cancelCancelledDefer)
<a name="l01158"></a>01158 {
<a name="l01159"></a>01159 DateTime nextDateTime = mNextMainDateTime;
<a name="l01160"></a>01160 <span class="keywordflow">if</span> (mMainExpired)
<a name="l01161"></a>01161 {
<a name="l01162"></a>01162 <span class="keywordflow">if</span> (checkRecur() == KARecurrence::NO_RECUR)
<a name="l01163"></a>01163 nextDateTime = mStartDateTime;
<a name="l01164"></a>01164 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!original)
<a name="l01165"></a>01165 {
<a name="l01166"></a>01166 <span class="comment">// It's a deferral of an expired recurrence.</span>
<a name="l01167"></a>01167 <span class="comment">// Need to ensure that the alarm offset is to an occurrence</span>
<a name="l01168"></a>01168 <span class="comment">// which isn't excluded by an exception - otherwise, it will</span>
<a name="l01169"></a>01169 <span class="comment">// never be triggered. So choose the first recurrence which</span>
<a name="l01170"></a>01170 <span class="comment">// isn't an exception.</span>
<a name="l01171"></a>01171 nextDateTime = mRecurrence->getNextDateTime(mStartDateTime.dateTime().addDays(-1));
<a name="l01172"></a>01172 nextDateTime.setDateOnly(mStartDateTime.isDateOnly());
<a name="l01173"></a>01173 }
<a name="l01174"></a>01174 }
<a name="l01175"></a>01175 <span class="keywordtype">int</span> startOffset;
<a name="l01176"></a>01176 QStringList list;
<a name="l01177"></a>01177 <span class="keywordflow">if</span> (mDeferralTime.isDateOnly())
<a name="l01178"></a>01178 {
<a name="l01179"></a>01179 startOffset = nextDateTime.secsTo(mDeferralTime.dateTime());
<a name="l01180"></a>01180 list += DATE_DEFERRAL_TYPE;
<a name="l01181"></a>01181 }
<a name="l01182"></a>01182 <span class="keywordflow">else</span>
<a name="l01183"></a>01183 {
<a name="l01184"></a>01184 startOffset = nextDateTime.dateTime().secsTo(mDeferralTime.dateTime());
<a name="l01185"></a>01185 list += TIME_DEFERRAL_TYPE;
<a name="l01186"></a>01186 }
<a name="l01187"></a>01187 <span class="keywordflow">if</span> (mDeferral == REMINDER_DEFERRAL)
<a name="l01188"></a>01188 list += mReminderOnceOnly ? REMINDER_ONCE_TYPE : REMINDER_TYPE;
<a name="l01189"></a>01189 initKCalAlarm(ev, startOffset, list);
<a name="l01190"></a>01190 <span class="keywordflow">if</span> (!ancillaryType && mDeferralTime.isValid())
<a name="l01191"></a>01191 {
<a name="l01192"></a>01192 ancillaryOffset = startOffset;
<a name="l01193"></a>01193 ancillaryType = 2;
<a name="l01194"></a>01194 }
<a name="l01195"></a>01195 }
<a name="l01196"></a>01196 <span class="keywordflow">if</span> (!mTemplateName.isEmpty())
<a name="l01197"></a>01197 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#fc2fecb0924ad84c61b9210d5cc5cc9f">setSummary</a>(mTemplateName);
<a name="l01198"></a>01198 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mDisplaying)
<a name="l01199"></a>01199 {
<a name="l01200"></a>01200 QStringList list(DISPLAYING_TYPE);
<a name="l01201"></a>01201 <span class="keywordflow">if</span> (mDisplayingFlags & REPEAT_AT_LOGIN)
<a name="l01202"></a>01202 list += AT_LOGIN_TYPE;
<a name="l01203"></a>01203 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mDisplayingFlags & DEFERRAL)
<a name="l01204"></a>01204 {
<a name="l01205"></a>01205 <span class="keywordflow">if</span> (mDisplayingFlags & TIMED_FLAG)
<a name="l01206"></a>01206 list += TIME_DEFERRAL_TYPE;
<a name="l01207"></a>01207 <span class="keywordflow">else</span>
<a name="l01208"></a>01208 list += DATE_DEFERRAL_TYPE;
<a name="l01209"></a>01209 }
<a name="l01210"></a>01210 <span class="keywordflow">if</span> (mDisplayingFlags & REMINDER)
<a name="l01211"></a>01211 list += mReminderOnceOnly ? REMINDER_ONCE_TYPE : REMINDER_TYPE;
<a name="l01212"></a>01212 initKCalAlarm(ev, mDisplayingTime, list);
<a name="l01213"></a>01213 <span class="keywordflow">if</span> (!ancillaryType && mDisplayingTime.isValid())
<a name="l01214"></a>01214 {
<a name="l01215"></a>01215 ancillaryTime = mDisplayingTime;
<a name="l01216"></a>01216 ancillaryType = 1;
<a name="l01217"></a>01217 }
<a name="l01218"></a>01218 }
<a name="l01219"></a>01219 <span class="keywordflow">if</span> (mBeep || mSpeak || !mAudioFile.isEmpty())
<a name="l01220"></a>01220 {
<a name="l01221"></a>01221 <span class="comment">// A sound is specified</span>
<a name="l01222"></a>01222 <span class="keywordflow">if</span> (ancillaryType == 2)
<a name="l01223"></a>01223 initKCalAlarm(ev, ancillaryOffset, QStringList(), KAAlarm::AUDIO_ALARM);
<a name="l01224"></a>01224 <span class="keywordflow">else</span>
<a name="l01225"></a>01225 initKCalAlarm(ev, ancillaryTime, QStringList(), KAAlarm::AUDIO_ALARM);
<a name="l01226"></a>01226 }
<a name="l01227"></a>01227 <span class="keywordflow">if</span> (!mPreAction.isEmpty())
<a name="l01228"></a>01228 {
<a name="l01229"></a>01229 <span class="comment">// A pre-display action is specified</span>
<a name="l01230"></a>01230 <span class="keywordflow">if</span> (ancillaryType == 2)
<a name="l01231"></a>01231 initKCalAlarm(ev, ancillaryOffset, QStringList(PRE_ACTION_TYPE), KAAlarm::PRE_ACTION_ALARM);
<a name="l01232"></a>01232 <span class="keywordflow">else</span>
<a name="l01233"></a>01233 initKCalAlarm(ev, ancillaryTime, QStringList(PRE_ACTION_TYPE), KAAlarm::PRE_ACTION_ALARM);
<a name="l01234"></a>01234 }
<a name="l01235"></a>01235 <span class="keywordflow">if</span> (!mPostAction.isEmpty())
<a name="l01236"></a>01236 {
<a name="l01237"></a>01237 <span class="comment">// A post-display action is specified</span>
<a name="l01238"></a>01238 <span class="keywordflow">if</span> (ancillaryType == 2)
<a name="l01239"></a>01239 initKCalAlarm(ev, ancillaryOffset, QStringList(POST_ACTION_TYPE), KAAlarm::POST_ACTION_ALARM);
<a name="l01240"></a>01240 <span class="keywordflow">else</span>
<a name="l01241"></a>01241 initKCalAlarm(ev, ancillaryTime, QStringList(POST_ACTION_TYPE), KAAlarm::POST_ACTION_ALARM);
<a name="l01242"></a>01242 }
<a name="l01243"></a>01243
<a name="l01244"></a>01244 <span class="keywordflow">if</span> (mRecurrence)
<a name="l01245"></a>01245 mRecurrence->writeRecurrence(*ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#d06004593e064a37d08c96f9ae16735e">recurrence</a>());
<a name="l01246"></a>01246 <span class="keywordflow">else</span>
<a name="l01247"></a>01247 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#c92730d2276b13fe148e4e4656d8a600">clearRecurrence</a>();
<a name="l01248"></a>01248 <span class="keywordflow">if</span> (mSaveDateTime.isValid())
<a name="l01249"></a>01249 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#92caf650b529278607a04c96c1d90ee8">setCreated</a>(mSaveDateTime);
<a name="l01250"></a>01250 ev.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#0cb14b1419d3fad1d3c19c9a3e98a57b">setReadOnly</a>(readOnly);
<a name="l01251"></a>01251 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01252"></a>01252 }
<a name="l01253"></a>01253
<a name="l01254"></a>01254 <span class="comment">/******************************************************************************</span>
<a name="l01255"></a>01255 <span class="comment"> * Create a new alarm for a libkcal event, and initialise it according to the</span>
<a name="l01256"></a>01256 <span class="comment"> * alarm action. If 'types' is non-null, it is appended to the X-KDE-KALARM-TYPE</span>
<a name="l01257"></a>01257 <span class="comment"> * property value list.</span>
<a name="l01258"></a>01258 <span class="comment"> */</span>
<a name="l01259"></a>01259 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* KAEvent::initKCalAlarm(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>& event, <span class="keyword">const</span> DateTime& dt, <span class="keyword">const</span> QStringList& types, KAAlarm::Type type)<span class="keyword"> const</span>
<a name="l01260"></a>01260 <span class="keyword"></span>{
<a name="l01261"></a>01261 <span class="keywordtype">int</span> startOffset = dt.isDateOnly() ? mStartDateTime.secsTo(dt)
<a name="l01262"></a>01262 : mStartDateTime.dateTime().secsTo(dt.dateTime());
<a name="l01263"></a>01263 <span class="keywordflow">return</span> initKCalAlarm(event, startOffset, types, type);
<a name="l01264"></a>01264 }
<a name="l01265"></a>01265
<a name="l01266"></a>01266 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* KAEvent::initKCalAlarm(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>& event, <span class="keywordtype">int</span> startOffsetSecs, <span class="keyword">const</span> QStringList& types, KAAlarm::Type type)<span class="keyword"> const</span>
<a name="l01267"></a>01267 <span class="keyword"></span>{
<a name="l01268"></a>01268 QStringList alltypes;
<a name="l01269"></a>01269 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = <span class="keyword">event</span>.newAlarm();
<a name="l01270"></a>01270 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#2d8acc8bc95f7946afd32872eee96d83">setEnabled</a>(<span class="keyword">true</span>);
<a name="l01271"></a>01271 <span class="keywordflow">if</span> (type != KAAlarm::MAIN_ALARM)
<a name="l01272"></a>01272 {
<a name="l01273"></a>01273 <span class="comment">// RFC2445 specifies that absolute alarm times must be stored as UTC.</span>
<a name="l01274"></a>01274 <span class="comment">// So, in order to store local times, set the alarm time as an offset to DTSTART.</span>
<a name="l01275"></a>01275 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(startOffsetSecs);
<a name="l01276"></a>01276 }
<a name="l01277"></a>01277
<a name="l01278"></a>01278 <span class="keywordflow">switch</span> (type)
<a name="l01279"></a>01279 {
<a name="l01280"></a>01280 <span class="keywordflow">case</span> KAAlarm::AUDIO_ALARM:
<a name="l01281"></a>01281 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#6d51811cf873f4935071746d264d104f">setAudioAlarm</a>(mAudioFile); <span class="comment">// empty for a beep or for speaking</span>
<a name="l01282"></a>01282 <span class="keywordflow">if</span> (mSpeak)
<a name="l01283"></a>01283 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, SPEAK_PROPERTY, QString::fromLatin1(<span class="stringliteral">"Y"</span>));
<a name="l01284"></a>01284 <span class="keywordflow">if</span> (mRepeatSound)
<a name="l01285"></a>01285 {
<a name="l01286"></a>01286 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#25af13606c653d0009e5559bdad78ff3">setRepeatCount</a>(-1);
<a name="l01287"></a>01287 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#5b32099b4b802027e4b75767f48f73df">setSnoozeTime</a>(0);
<a name="l01288"></a>01288 }
<a name="l01289"></a>01289 <span class="keywordflow">if</span> (!mAudioFile.isEmpty() && mSoundVolume >= 0)
<a name="l01290"></a>01290 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, VOLUME_PROPERTY,
<a name="l01291"></a>01291 QString::fromLatin1(<span class="stringliteral">"%1;%2;%3"</span>).arg(QString::number(mSoundVolume, <span class="charliteral">'f'</span>, 2))
<a name="l01292"></a>01292 .arg(QString::number(mFadeVolume, <span class="charliteral">'f'</span>, 2))
<a name="l01293"></a>01293 .arg(mFadeSeconds));
<a name="l01294"></a>01294 <span class="keywordflow">break</span>;
<a name="l01295"></a>01295 <span class="keywordflow">case</span> KAAlarm::PRE_ACTION_ALARM:
<a name="l01296"></a>01296 setProcedureAlarm(alarm, mPreAction);
<a name="l01297"></a>01297 <span class="keywordflow">break</span>;
<a name="l01298"></a>01298 <span class="keywordflow">case</span> KAAlarm::POST_ACTION_ALARM:
<a name="l01299"></a>01299 setProcedureAlarm(alarm, mPostAction);
<a name="l01300"></a>01300 <span class="keywordflow">break</span>;
<a name="l01301"></a>01301 <span class="keywordflow">case</span> KAAlarm::MAIN_ALARM:
<a name="l01302"></a>01302 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#5b32099b4b802027e4b75767f48f73df">setSnoozeTime</a>(mRepeatInterval);
<a name="l01303"></a>01303 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#25af13606c653d0009e5559bdad78ff3">setRepeatCount</a>(mRepeatCount);
<a name="l01304"></a>01304 <span class="keywordflow">if</span> (mRepeatCount)
<a name="l01305"></a>01305 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, NEXT_REPEAT_PROPERTY,
<a name="l01306"></a>01306 QString::number(mNextRepeat));
<a name="l01307"></a>01307 <span class="comment">// fall through to INVALID_ALARM</span>
<a name="l01308"></a>01308 <span class="keywordflow">case</span> KAAlarm::INVALID_ALARM:
<a name="l01309"></a>01309 <span class="keywordflow">switch</span> (mActionType)
<a name="l01310"></a>01310 {
<a name="l01311"></a>01311 <span class="keywordflow">case</span> T_FILE:
<a name="l01312"></a>01312 alltypes += FILE_TYPE;
<a name="l01313"></a>01313 <span class="comment">// fall through to T_MESSAGE</span>
<a name="l01314"></a>01314 <span class="keywordflow">case</span> T_MESSAGE:
<a name="l01315"></a>01315 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#b5b69003ad8ad9450b8f4f542c234a8d">setDisplayAlarm</a>(AlarmText::toCalendarText(mText));
<a name="l01316"></a>01316 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, FONT_COLOUR_PROPERTY,
<a name="l01317"></a>01317 QString::fromLatin1(<span class="stringliteral">"%1;%2;%3"</span>).arg(mBgColour.name())
<a name="l01318"></a>01318 .arg(mFgColour.name())
<a name="l01319"></a>01319 .arg(mDefaultFont ? QString::null : mFont.toString()));
<a name="l01320"></a>01320 <span class="keywordflow">break</span>;
<a name="l01321"></a>01321 <span class="keywordflow">case</span> T_COMMAND:
<a name="l01322"></a>01322 <span class="keywordflow">if</span> (mCommandScript)
<a name="l01323"></a>01323 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#bd324dae3fec9d6a03468afab92f71ca">setProcedureAlarm</a>(<span class="stringliteral">""</span>, mText);
<a name="l01324"></a>01324 <span class="keywordflow">else</span>
<a name="l01325"></a>01325 setProcedureAlarm(alarm, mText);
<a name="l01326"></a>01326 <span class="keywordflow">break</span>;
<a name="l01327"></a>01327 <span class="keywordflow">case</span> T_EMAIL:
<a name="l01328"></a>01328 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#ba6b152a45400ca8bd76af3229dc3300">setEmailAlarm</a>(mEmailSubject, mText, mEmailAddresses, mEmailAttachments);
<a name="l01329"></a>01329 <span class="keywordflow">if</span> (mEmailFromIdentity)
<a name="l01330"></a>01330 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, EMAIL_ID_PROPERTY, QString::number(mEmailFromIdentity));
<a name="l01331"></a>01331 <span class="keywordflow">break</span>;
<a name="l01332"></a>01332 <span class="keywordflow">case</span> T_AUDIO:
<a name="l01333"></a>01333 <span class="keywordflow">break</span>;
<a name="l01334"></a>01334 }
<a name="l01335"></a>01335 <span class="keywordflow">break</span>;
<a name="l01336"></a>01336 <span class="keywordflow">case</span> KAAlarm::REMINDER_ALARM:
<a name="l01337"></a>01337 <span class="keywordflow">case</span> KAAlarm::DEFERRED_ALARM:
<a name="l01338"></a>01338 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_ALARM:
<a name="l01339"></a>01339 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN_ALARM:
<a name="l01340"></a>01340 <span class="keywordflow">case</span> KAAlarm::DISPLAYING_ALARM:
<a name="l01341"></a>01341 <span class="keywordflow">break</span>;
<a name="l01342"></a>01342 }
<a name="l01343"></a>01343 alltypes += types;
<a name="l01344"></a>01344 <span class="keywordflow">if</span> (alltypes.count() > 0)
<a name="l01345"></a>01345 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, TYPE_PROPERTY, alltypes.join(<span class="stringliteral">","</span>));
<a name="l01346"></a>01346 <span class="keywordflow">return</span> alarm;
<a name="l01347"></a>01347 }
<a name="l01348"></a>01348
<a name="l01349"></a>01349 <span class="comment">/******************************************************************************</span>
<a name="l01350"></a>01350 <span class="comment"> * Return the alarm of the specified type.</span>
<a name="l01351"></a>01351 <span class="comment"> */</span>
<a name="l01352"></a>01352 KAAlarm KAEvent::alarm(KAAlarm::Type type)<span class="keyword"> const</span>
<a name="l01353"></a>01353 <span class="keyword"></span>{
<a name="l01354"></a>01354 checkRecur(); <span class="comment">// ensure recurrence/repetition data is consistent</span>
<a name="l01355"></a>01355 KAAlarm al; <span class="comment">// this sets type to INVALID_ALARM</span>
<a name="l01356"></a>01356 <span class="keywordflow">if</span> (mAlarmCount)
<a name="l01357"></a>01357 {
<a name="l01358"></a>01358 al.mEventID = mEventID;
<a name="l01359"></a>01359 al.mActionType = mActionType;
<a name="l01360"></a>01360 al.mText = mText;
<a name="l01361"></a>01361 al.mBgColour = mBgColour;
<a name="l01362"></a>01362 al.mFgColour = mFgColour;
<a name="l01363"></a>01363 al.mFont = mFont;
<a name="l01364"></a>01364 al.mDefaultFont = mDefaultFont;
<a name="l01365"></a>01365 al.mBeep = mBeep;
<a name="l01366"></a>01366 al.mSpeak = mSpeak;
<a name="l01367"></a>01367 al.mSoundVolume = mSoundVolume;
<a name="l01368"></a>01368 al.mFadeVolume = mFadeVolume;
<a name="l01369"></a>01369 al.mFadeSeconds = mFadeSeconds;
<a name="l01370"></a>01370 al.mRepeatSound = mRepeatSound;
<a name="l01371"></a>01371 al.mConfirmAck = mConfirmAck;
<a name="l01372"></a>01372 al.mRepeatCount = 0;
<a name="l01373"></a>01373 al.mRepeatInterval = 0;
<a name="l01374"></a>01374 al.mRepeatAtLogin = <span class="keyword">false</span>;
<a name="l01375"></a>01375 al.mDeferred = <span class="keyword">false</span>;
<a name="l01376"></a>01376 al.mLateCancel = mLateCancel;
<a name="l01377"></a>01377 al.mAutoClose = mAutoClose;
<a name="l01378"></a>01378 al.mEmailBcc = mEmailBcc;
<a name="l01379"></a>01379 al.mCommandScript = mCommandScript;
<a name="l01380"></a>01380 <span class="keywordflow">if</span> (mActionType == T_EMAIL)
<a name="l01381"></a>01381 {
<a name="l01382"></a>01382 al.mEmailFromIdentity = mEmailFromIdentity;
<a name="l01383"></a>01383 al.mEmailAddresses = mEmailAddresses;
<a name="l01384"></a>01384 al.mEmailSubject = mEmailSubject;
<a name="l01385"></a>01385 al.mEmailAttachments = mEmailAttachments;
<a name="l01386"></a>01386 }
<a name="l01387"></a>01387 <span class="keywordflow">switch</span> (type)
<a name="l01388"></a>01388 {
<a name="l01389"></a>01389 <span class="keywordflow">case</span> KAAlarm::MAIN_ALARM:
<a name="l01390"></a>01390 <span class="keywordflow">if</span> (!mMainExpired)
<a name="l01391"></a>01391 {
<a name="l01392"></a>01392 al.mType = KAAlarm::MAIN__ALARM;
<a name="l01393"></a>01393 al.mNextMainDateTime = mNextMainDateTime;
<a name="l01394"></a>01394 al.mRepeatCount = mRepeatCount;
<a name="l01395"></a>01395 al.mRepeatInterval = mRepeatInterval;
<a name="l01396"></a>01396 al.mNextRepeat = mNextRepeat;
<a name="l01397"></a>01397 }
<a name="l01398"></a>01398 <span class="keywordflow">break</span>;
<a name="l01399"></a>01399 <span class="keywordflow">case</span> KAAlarm::REMINDER_ALARM:
<a name="l01400"></a>01400 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l01401"></a>01401 {
<a name="l01402"></a>01402 al.mType = KAAlarm::REMINDER__ALARM;
<a name="l01403"></a>01403 <span class="keywordflow">if</span> (mReminderOnceOnly)
<a name="l01404"></a>01404 al.mNextMainDateTime = mStartDateTime.addMins(-mReminderMinutes);
<a name="l01405"></a>01405 <span class="keywordflow">else</span>
<a name="l01406"></a>01406 al.mNextMainDateTime = mNextMainDateTime.addMins(-mReminderMinutes);
<a name="l01407"></a>01407 }
<a name="l01408"></a>01408 <span class="keywordflow">break</span>;
<a name="l01409"></a>01409 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_ALARM:
<a name="l01410"></a>01410 <span class="keywordflow">if</span> (mDeferral != REMINDER_DEFERRAL)
<a name="l01411"></a>01411 <span class="keywordflow">break</span>;
<a name="l01412"></a>01412 <span class="comment">// fall through to DEFERRED_ALARM</span>
<a name="l01413"></a>01413 <span class="keywordflow">case</span> KAAlarm::DEFERRED_ALARM:
<a name="l01414"></a>01414 <span class="keywordflow">if</span> (mDeferral > 0)
<a name="l01415"></a>01415 {
<a name="l01416"></a>01416 al.mType = <span class="keyword">static_cast<</span>KAAlarm::SubType<span class="keyword">></span>((mDeferral == REMINDER_DEFERRAL ? KAAlarm::DEFERRED_REMINDER_ALARM : KAAlarm::DEFERRED_ALARM)
<a name="l01417"></a>01417 | (mDeferralTime.isDateOnly() ? 0 : KAAlarm::TIMED_DEFERRAL_FLAG));
<a name="l01418"></a>01418 al.mNextMainDateTime = mDeferralTime;
<a name="l01419"></a>01419 al.mDeferred = <span class="keyword">true</span>;
<a name="l01420"></a>01420 }
<a name="l01421"></a>01421 <span class="keywordflow">break</span>;
<a name="l01422"></a>01422 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN_ALARM:
<a name="l01423"></a>01423 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l01424"></a>01424 {
<a name="l01425"></a>01425 al.mType = KAAlarm::AT_LOGIN__ALARM;
<a name="l01426"></a>01426 al.mNextMainDateTime = mAtLoginDateTime;
<a name="l01427"></a>01427 al.mRepeatAtLogin = <span class="keyword">true</span>;
<a name="l01428"></a>01428 al.mLateCancel = 0;
<a name="l01429"></a>01429 al.mAutoClose = <span class="keyword">false</span>;
<a name="l01430"></a>01430 }
<a name="l01431"></a>01431 <span class="keywordflow">break</span>;
<a name="l01432"></a>01432 <span class="keywordflow">case</span> KAAlarm::DISPLAYING_ALARM:
<a name="l01433"></a>01433 <span class="keywordflow">if</span> (mDisplaying)
<a name="l01434"></a>01434 {
<a name="l01435"></a>01435 al.mType = KAAlarm::DISPLAYING__ALARM;
<a name="l01436"></a>01436 al.mNextMainDateTime = mDisplayingTime;
<a name="l01437"></a>01437 al.mDisplaying = <span class="keyword">true</span>;
<a name="l01438"></a>01438 }
<a name="l01439"></a>01439 <span class="keywordflow">break</span>;
<a name="l01440"></a>01440 <span class="keywordflow">case</span> KAAlarm::AUDIO_ALARM:
<a name="l01441"></a>01441 <span class="keywordflow">case</span> KAAlarm::PRE_ACTION_ALARM:
<a name="l01442"></a>01442 <span class="keywordflow">case</span> KAAlarm::POST_ACTION_ALARM:
<a name="l01443"></a>01443 <span class="keywordflow">case</span> KAAlarm::INVALID_ALARM:
<a name="l01444"></a>01444 <span class="keywordflow">default</span>:
<a name="l01445"></a>01445 <span class="keywordflow">break</span>;
<a name="l01446"></a>01446 }
<a name="l01447"></a>01447 }
<a name="l01448"></a>01448 <span class="keywordflow">return</span> al;
<a name="l01449"></a>01449 }
<a name="l01450"></a>01450
<a name="l01451"></a>01451 <span class="comment">/******************************************************************************</span>
<a name="l01452"></a>01452 <span class="comment"> * Return the main alarm for the event.</span>
<a name="l01453"></a>01453 <span class="comment"> * If the main alarm does not exist, one of the subsidiary ones is returned if</span>
<a name="l01454"></a>01454 <span class="comment"> * possible.</span>
<a name="l01455"></a>01455 <span class="comment"> * N.B. a repeat-at-login alarm can only be returned if it has been read from/</span>
<a name="l01456"></a>01456 <span class="comment"> * written to the calendar file.</span>
<a name="l01457"></a>01457 <span class="comment"> */</span>
<a name="l01458"></a>01458 KAAlarm KAEvent::firstAlarm()<span class="keyword"> const</span>
<a name="l01459"></a>01459 <span class="keyword"></span>{
<a name="l01460"></a>01460 <span class="keywordflow">if</span> (mAlarmCount)
<a name="l01461"></a>01461 {
<a name="l01462"></a>01462 <span class="keywordflow">if</span> (!mMainExpired)
<a name="l01463"></a>01463 <span class="keywordflow">return</span> alarm(KAAlarm::MAIN_ALARM);
<a name="l01464"></a>01464 <span class="keywordflow">return</span> nextAlarm(KAAlarm::MAIN_ALARM);
<a name="l01465"></a>01465 }
<a name="l01466"></a>01466 <span class="keywordflow">return</span> KAAlarm();
<a name="l01467"></a>01467 }
<a name="l01468"></a>01468
<a name="l01469"></a>01469 <span class="comment">/******************************************************************************</span>
<a name="l01470"></a>01470 <span class="comment"> * Return the next alarm for the event, after the specified alarm.</span>
<a name="l01471"></a>01471 <span class="comment"> * N.B. a repeat-at-login alarm can only be returned if it has been read from/</span>
<a name="l01472"></a>01472 <span class="comment"> * written to the calendar file.</span>
<a name="l01473"></a>01473 <span class="comment"> */</span>
<a name="l01474"></a>01474 KAAlarm KAEvent::nextAlarm(KAAlarm::Type prevType)<span class="keyword"> const</span>
<a name="l01475"></a>01475 <span class="keyword"></span>{
<a name="l01476"></a>01476 <span class="keywordflow">switch</span> (prevType)
<a name="l01477"></a>01477 {
<a name="l01478"></a>01478 <span class="keywordflow">case</span> KAAlarm::MAIN_ALARM:
<a name="l01479"></a>01479 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l01480"></a>01480 <span class="keywordflow">return</span> alarm(KAAlarm::REMINDER_ALARM);
<a name="l01481"></a>01481 <span class="comment">// fall through to REMINDER_ALARM</span>
<a name="l01482"></a>01482 <span class="keywordflow">case</span> KAAlarm::REMINDER_ALARM:
<a name="l01483"></a>01483 <span class="comment">// There can only be one deferral alarm</span>
<a name="l01484"></a>01484 <span class="keywordflow">if</span> (mDeferral == REMINDER_DEFERRAL)
<a name="l01485"></a>01485 <span class="keywordflow">return</span> alarm(KAAlarm::DEFERRED_REMINDER_ALARM);
<a name="l01486"></a>01486 <span class="keywordflow">if</span> (mDeferral == NORMAL_DEFERRAL)
<a name="l01487"></a>01487 <span class="keywordflow">return</span> alarm(KAAlarm::DEFERRED_ALARM);
<a name="l01488"></a>01488 <span class="comment">// fall through to DEFERRED_ALARM</span>
<a name="l01489"></a>01489 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_ALARM:
<a name="l01490"></a>01490 <span class="keywordflow">case</span> KAAlarm::DEFERRED_ALARM:
<a name="l01491"></a>01491 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l01492"></a>01492 <span class="keywordflow">return</span> alarm(KAAlarm::AT_LOGIN_ALARM);
<a name="l01493"></a>01493 <span class="comment">// fall through to AT_LOGIN_ALARM</span>
<a name="l01494"></a>01494 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN_ALARM:
<a name="l01495"></a>01495 <span class="keywordflow">if</span> (mDisplaying)
<a name="l01496"></a>01496 <span class="keywordflow">return</span> alarm(KAAlarm::DISPLAYING_ALARM);
<a name="l01497"></a>01497 <span class="comment">// fall through to DISPLAYING_ALARM</span>
<a name="l01498"></a>01498 <span class="keywordflow">case</span> KAAlarm::DISPLAYING_ALARM:
<a name="l01499"></a>01499 <span class="comment">// fall through to default</span>
<a name="l01500"></a>01500 <span class="keywordflow">case</span> KAAlarm::AUDIO_ALARM:
<a name="l01501"></a>01501 <span class="keywordflow">case</span> KAAlarm::PRE_ACTION_ALARM:
<a name="l01502"></a>01502 <span class="keywordflow">case</span> KAAlarm::POST_ACTION_ALARM:
<a name="l01503"></a>01503 <span class="keywordflow">case</span> KAAlarm::INVALID_ALARM:
<a name="l01504"></a>01504 <span class="keywordflow">default</span>:
<a name="l01505"></a>01505 <span class="keywordflow">break</span>;
<a name="l01506"></a>01506 }
<a name="l01507"></a>01507 <span class="keywordflow">return</span> KAAlarm();
<a name="l01508"></a>01508 }
<a name="l01509"></a>01509
<a name="l01510"></a>01510 <span class="comment">/******************************************************************************</span>
<a name="l01511"></a>01511 <span class="comment"> * Remove the alarm of the specified type from the event.</span>
<a name="l01512"></a>01512 <span class="comment"> * This must only be called to remove an alarm which has expired, not to</span>
<a name="l01513"></a>01513 <span class="comment"> * reconfigure the event.</span>
<a name="l01514"></a>01514 <span class="comment"> */</span>
<a name="l01515"></a>01515 <span class="keywordtype">void</span> KAEvent::removeExpiredAlarm(KAAlarm::Type type)
<a name="l01516"></a>01516 {
<a name="l01517"></a>01517 <span class="keywordtype">int</span> count = mAlarmCount;
<a name="l01518"></a>01518 <span class="keywordflow">switch</span> (type)
<a name="l01519"></a>01519 {
<a name="l01520"></a>01520 <span class="keywordflow">case</span> KAAlarm::MAIN_ALARM:
<a name="l01521"></a>01521 mAlarmCount = 0; <span class="comment">// removing main alarm - also remove subsidiary alarms</span>
<a name="l01522"></a>01522 <span class="keywordflow">break</span>;
<a name="l01523"></a>01523 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN_ALARM:
<a name="l01524"></a>01524 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l01525"></a>01525 {
<a name="l01526"></a>01526 <span class="comment">// Remove the at-login alarm, but keep a note of it for archiving purposes</span>
<a name="l01527"></a>01527 mArchiveRepeatAtLogin = <span class="keyword">true</span>;
<a name="l01528"></a>01528 mRepeatAtLogin = <span class="keyword">false</span>;
<a name="l01529"></a>01529 --mAlarmCount;
<a name="l01530"></a>01530 }
<a name="l01531"></a>01531 <span class="keywordflow">break</span>;
<a name="l01532"></a>01532 <span class="keywordflow">case</span> KAAlarm::REMINDER_ALARM:
<a name="l01533"></a>01533 <span class="comment">// Remove any reminder alarm, but keep a note of it for archiving purposes</span>
<a name="l01534"></a>01534 set_archiveReminder();
<a name="l01535"></a>01535 <span class="keywordflow">break</span>;
<a name="l01536"></a>01536 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_ALARM:
<a name="l01537"></a>01537 <span class="keywordflow">case</span> KAAlarm::DEFERRED_ALARM:
<a name="l01538"></a>01538 set_deferral(NO_DEFERRAL);
<a name="l01539"></a>01539 <span class="keywordflow">break</span>;
<a name="l01540"></a>01540 <span class="keywordflow">case</span> KAAlarm::DISPLAYING_ALARM:
<a name="l01541"></a>01541 <span class="keywordflow">if</span> (mDisplaying)
<a name="l01542"></a>01542 {
<a name="l01543"></a>01543 mDisplaying = <span class="keyword">false</span>;
<a name="l01544"></a>01544 --mAlarmCount;
<a name="l01545"></a>01545 }
<a name="l01546"></a>01546 <span class="keywordflow">break</span>;
<a name="l01547"></a>01547 <span class="keywordflow">case</span> KAAlarm::AUDIO_ALARM:
<a name="l01548"></a>01548 <span class="keywordflow">case</span> KAAlarm::PRE_ACTION_ALARM:
<a name="l01549"></a>01549 <span class="keywordflow">case</span> KAAlarm::POST_ACTION_ALARM:
<a name="l01550"></a>01550 <span class="keywordflow">case</span> KAAlarm::INVALID_ALARM:
<a name="l01551"></a>01551 <span class="keywordflow">default</span>:
<a name="l01552"></a>01552 <span class="keywordflow">break</span>;
<a name="l01553"></a>01553 }
<a name="l01554"></a>01554 <span class="keywordflow">if</span> (mAlarmCount != count)
<a name="l01555"></a>01555 mUpdated = <span class="keyword">true</span>;
<a name="l01556"></a>01556 }
<a name="l01557"></a>01557
<a name="l01558"></a>01558 <span class="comment">/******************************************************************************</span>
<a name="l01559"></a>01559 <span class="comment"> * Defer the event to the specified time.</span>
<a name="l01560"></a>01560 <span class="comment"> * If the main alarm time has passed, the main alarm is marked as expired.</span>
<a name="l01561"></a>01561 <span class="comment"> * If 'adjustRecurrence' is true, ensure that the next scheduled recurrence is</span>
<a name="l01562"></a>01562 <span class="comment"> * after the current time.</span>
<a name="l01563"></a>01563 <span class="comment"> * Reply = true if a repetition has been deferred.</span>
<a name="l01564"></a>01564 <span class="comment"> */</span>
<a name="l01565"></a>01565 <span class="keywordtype">bool</span> KAEvent::defer(<span class="keyword">const</span> DateTime& dateTime, <span class="keywordtype">bool</span> reminder, <span class="keywordtype">bool</span> adjustRecurrence)
<a name="l01566"></a>01566 {
<a name="l01567"></a>01567 <span class="keywordtype">bool</span> result = <span class="keyword">false</span>;
<a name="l01568"></a>01568 <span class="keywordtype">bool</span> setNextRepetition = <span class="keyword">false</span>;
<a name="l01569"></a>01569 <span class="keywordtype">bool</span> checkRepetition = <span class="keyword">false</span>;
<a name="l01570"></a>01570 cancelCancelledDeferral();
<a name="l01571"></a>01571 <span class="keywordflow">if</span> (checkRecur() == KARecurrence::NO_RECUR)
<a name="l01572"></a>01572 {
<a name="l01573"></a>01573 <span class="keywordflow">if</span> (mReminderMinutes || mDeferral == REMINDER_DEFERRAL || mArchiveReminderMinutes)
<a name="l01574"></a>01574 {
<a name="l01575"></a>01575 <span class="keywordflow">if</span> (dateTime < mNextMainDateTime.dateTime())
<a name="l01576"></a>01576 {
<a name="l01577"></a>01577 set_deferral(REMINDER_DEFERRAL); <span class="comment">// defer reminder alarm</span>
<a name="l01578"></a>01578 mDeferralTime = dateTime;
<a name="l01579"></a>01579 }
<a name="l01580"></a>01580 <span class="keywordflow">else</span>
<a name="l01581"></a>01581 {
<a name="l01582"></a>01582 <span class="comment">// Deferring past the main alarm time, so adjust any existing deferral</span>
<a name="l01583"></a>01583 <span class="keywordflow">if</span> (mReminderMinutes || mDeferral == REMINDER_DEFERRAL)
<a name="l01584"></a>01584 set_deferral(NO_DEFERRAL);
<a name="l01585"></a>01585 }
<a name="l01586"></a>01586 <span class="comment">// Remove any reminder alarm, but keep a note of it for archiving purposes</span>
<a name="l01587"></a>01587 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l01588"></a>01588 set_archiveReminder();
<a name="l01589"></a>01589 }
<a name="l01590"></a>01590 <span class="keywordflow">if</span> (mDeferral != REMINDER_DEFERRAL)
<a name="l01591"></a>01591 {
<a name="l01592"></a>01592 <span class="comment">// We're deferring the main alarm, not a reminder</span>
<a name="l01593"></a>01593 <span class="keywordflow">if</span> (mRepeatCount && mRepeatInterval && dateTime < mainEndRepeatTime())
<a name="l01594"></a>01594 {
<a name="l01595"></a>01595 <span class="comment">// The alarm is repeated, and we're deferring to a time before the last repetition</span>
<a name="l01596"></a>01596 set_deferral(NORMAL_DEFERRAL);
<a name="l01597"></a>01597 mDeferralTime = dateTime;
<a name="l01598"></a>01598 result = <span class="keyword">true</span>;
<a name="l01599"></a>01599 setNextRepetition = <span class="keyword">true</span>;
<a name="l01600"></a>01600 }
<a name="l01601"></a>01601 <span class="keywordflow">else</span>
<a name="l01602"></a>01602 {
<a name="l01603"></a>01603 <span class="comment">// Main alarm has now expired</span>
<a name="l01604"></a>01604 mNextMainDateTime = mDeferralTime = dateTime;
<a name="l01605"></a>01605 set_deferral(NORMAL_DEFERRAL);
<a name="l01606"></a>01606 <span class="keywordflow">if</span> (!mMainExpired)
<a name="l01607"></a>01607 {
<a name="l01608"></a>01608 <span class="comment">// Mark the alarm as expired now</span>
<a name="l01609"></a>01609 mMainExpired = <span class="keyword">true</span>;
<a name="l01610"></a>01610 --mAlarmCount;
<a name="l01611"></a>01611 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l01612"></a>01612 {
<a name="l01613"></a>01613 <span class="comment">// Remove the repeat-at-login alarm, but keep a note of it for archiving purposes</span>
<a name="l01614"></a>01614 mArchiveRepeatAtLogin = <span class="keyword">true</span>;
<a name="l01615"></a>01615 mRepeatAtLogin = <span class="keyword">false</span>;
<a name="l01616"></a>01616 --mAlarmCount;
<a name="l01617"></a>01617 }
<a name="l01618"></a>01618 }
<a name="l01619"></a>01619 }
<a name="l01620"></a>01620 }
<a name="l01621"></a>01621 }
<a name="l01622"></a>01622 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (reminder)
<a name="l01623"></a>01623 {
<a name="l01624"></a>01624 <span class="comment">// Deferring a reminder for a recurring alarm</span>
<a name="l01625"></a>01625 <span class="keywordflow">if</span> (dateTime >= mNextMainDateTime.dateTime())
<a name="l01626"></a>01626 set_deferral(NO_DEFERRAL); <span class="comment">// (error)</span>
<a name="l01627"></a>01627 <span class="keywordflow">else</span>
<a name="l01628"></a>01628 {
<a name="l01629"></a>01629 set_deferral(REMINDER_DEFERRAL);
<a name="l01630"></a>01630 mDeferralTime = dateTime;
<a name="l01631"></a>01631 checkRepetition = <span class="keyword">true</span>;
<a name="l01632"></a>01632 }
<a name="l01633"></a>01633 }
<a name="l01634"></a>01634 <span class="keywordflow">else</span>
<a name="l01635"></a>01635 {
<a name="l01636"></a>01636 mDeferralTime = dateTime;
<a name="l01637"></a>01637 <span class="keywordflow">if</span> (mDeferral <= 0)
<a name="l01638"></a>01638 set_deferral(NORMAL_DEFERRAL);
<a name="l01639"></a>01639 <span class="keywordflow">if</span> (adjustRecurrence)
<a name="l01640"></a>01640 {
<a name="l01641"></a>01641 QDateTime now = QDateTime::currentDateTime();
<a name="l01642"></a>01642 <span class="keywordflow">if</span> (mainEndRepeatTime() < now)
<a name="l01643"></a>01643 {
<a name="l01644"></a>01644 <span class="comment">// The last repetition (if any) of the current recurrence has already passed.</span>
<a name="l01645"></a>01645 <span class="comment">// Adjust to the next scheduled recurrence after now.</span>
<a name="l01646"></a>01646 <span class="keywordflow">if</span> (!mMainExpired && setNextOccurrence(now) == NO_OCCURRENCE)
<a name="l01647"></a>01647 {
<a name="l01648"></a>01648 mMainExpired = <span class="keyword">true</span>;
<a name="l01649"></a>01649 --mAlarmCount;
<a name="l01650"></a>01650 }
<a name="l01651"></a>01651 }
<a name="l01652"></a>01652 <span class="keywordflow">else</span>
<a name="l01653"></a>01653 setNextRepetition = (mRepeatCount && mRepeatInterval);
<a name="l01654"></a>01654 }
<a name="l01655"></a>01655 <span class="keywordflow">else</span>
<a name="l01656"></a>01656 checkRepetition = <span class="keyword">true</span>;
<a name="l01657"></a>01657 }
<a name="l01658"></a>01658 <span class="keywordflow">if</span> (checkRepetition)
<a name="l01659"></a>01659 setNextRepetition = (mRepeatCount && mRepeatInterval && mDeferralTime < mainEndRepeatTime());
<a name="l01660"></a>01660 <span class="keywordflow">if</span> (setNextRepetition)
<a name="l01661"></a>01661 {
<a name="l01662"></a>01662 <span class="comment">// The alarm is repeated, and we're deferring to a time before the last repetition.</span>
<a name="l01663"></a>01663 <span class="comment">// Set the next scheduled repetition to the one after the deferral.</span>
<a name="l01664"></a>01664 mNextRepeat = (mNextMainDateTime < mDeferralTime)
<a name="l01665"></a>01665 ? mNextMainDateTime.secsTo(mDeferralTime) / (mRepeatInterval * 60) + 1 : 0;
<a name="l01666"></a>01666 }
<a name="l01667"></a>01667 mUpdated = <span class="keyword">true</span>;
<a name="l01668"></a>01668 <span class="keywordflow">return</span> result;
<a name="l01669"></a>01669 }
<a name="l01670"></a>01670
<a name="l01671"></a>01671 <span class="comment">/******************************************************************************</span>
<a name="l01672"></a>01672 <span class="comment"> * Cancel any deferral alarm.</span>
<a name="l01673"></a>01673 <span class="comment"> */</span>
<a name="l01674"></a>01674 <span class="keywordtype">void</span> KAEvent::cancelDefer()
<a name="l01675"></a>01675 {
<a name="l01676"></a>01676 <span class="keywordflow">if</span> (mDeferral > 0)
<a name="l01677"></a>01677 {
<a name="l01678"></a>01678 <span class="comment">// Set the deferral time to be the same as the next recurrence/repetition.</span>
<a name="l01679"></a>01679 <span class="comment">// This prevents an immediate retriggering of the alarm.</span>
<a name="l01680"></a>01680 <span class="keywordflow">if</span> (mMainExpired
<a name="l01681"></a>01681 || nextOccurrence(QDateTime::currentDateTime(), mDeferralTime, RETURN_REPETITION) == NO_OCCURRENCE)
<a name="l01682"></a>01682 {
<a name="l01683"></a>01683 <span class="comment">// The main alarm has expired, so simply delete the deferral</span>
<a name="l01684"></a>01684 mDeferralTime = DateTime();
<a name="l01685"></a>01685 set_deferral(NO_DEFERRAL);
<a name="l01686"></a>01686 }
<a name="l01687"></a>01687 <span class="keywordflow">else</span>
<a name="l01688"></a>01688 set_deferral(CANCEL_DEFERRAL);
<a name="l01689"></a>01689 mUpdated = <span class="keyword">true</span>;
<a name="l01690"></a>01690 }
<a name="l01691"></a>01691 }
<a name="l01692"></a>01692
<a name="l01693"></a>01693 <span class="comment">/******************************************************************************</span>
<a name="l01694"></a>01694 <span class="comment"> * Cancel any cancelled deferral alarm.</span>
<a name="l01695"></a>01695 <span class="comment"> */</span>
<a name="l01696"></a>01696 <span class="keywordtype">void</span> KAEvent::cancelCancelledDeferral()
<a name="l01697"></a>01697 {
<a name="l01698"></a>01698 <span class="keywordflow">if</span> (mDeferral == CANCEL_DEFERRAL)
<a name="l01699"></a>01699 {
<a name="l01700"></a>01700 mDeferralTime = DateTime();
<a name="l01701"></a>01701 set_deferral(NO_DEFERRAL);
<a name="l01702"></a>01702 }
<a name="l01703"></a>01703 }
<a name="l01704"></a>01704
<a name="l01705"></a>01705 <span class="comment">/******************************************************************************</span>
<a name="l01706"></a>01706 <span class="comment">* Find the latest time which the alarm can currently be deferred to.</span>
<a name="l01707"></a>01707 <span class="comment">*/</span>
<a name="l01708"></a>01708 DateTime KAEvent::deferralLimit(KAEvent::DeferLimitType* limitType)<span class="keyword"> const</span>
<a name="l01709"></a>01709 <span class="keyword"></span>{
<a name="l01710"></a>01710 DeferLimitType ltype;
<a name="l01711"></a>01711 DateTime endTime;
<a name="l01712"></a>01712 <span class="keywordtype">bool</span> recurs = (checkRecur() != KARecurrence::NO_RECUR);
<a name="l01713"></a>01713 <span class="keywordflow">if</span> (recurs || mRepeatCount)
<a name="l01714"></a>01714 {
<a name="l01715"></a>01715 <span class="comment">// It's a repeated alarm. Don't allow it to be deferred past its</span>
<a name="l01716"></a>01716 <span class="comment">// next occurrence or repetition.</span>
<a name="l01717"></a>01717 DateTime reminderTime;
<a name="l01718"></a>01718 QDateTime now = QDateTime::currentDateTime();
<a name="l01719"></a>01719 OccurType type = nextOccurrence(now, endTime, RETURN_REPETITION);
<a name="l01720"></a>01720 <span class="keywordflow">if</span> (type & OCCURRENCE_REPEAT)
<a name="l01721"></a>01721 ltype = LIMIT_REPETITION;
<a name="l01722"></a>01722 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == NO_OCCURRENCE)
<a name="l01723"></a>01723 ltype = LIMIT_NONE;
<a name="l01724"></a>01724 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mReminderMinutes && (now < (reminderTime = endTime.addMins(-mReminderMinutes))))
<a name="l01725"></a>01725 {
<a name="l01726"></a>01726 endTime = reminderTime;
<a name="l01727"></a>01727 ltype = LIMIT_REMINDER;
<a name="l01728"></a>01728 }
<a name="l01729"></a>01729 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == FIRST_OR_ONLY_OCCURRENCE && !recurs)
<a name="l01730"></a>01730 ltype = LIMIT_REPETITION;
<a name="l01731"></a>01731 <span class="keywordflow">else</span>
<a name="l01732"></a>01732 ltype = LIMIT_RECURRENCE;
<a name="l01733"></a>01733 }
<a name="l01734"></a>01734 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ((mReminderMinutes || mDeferral == REMINDER_DEFERRAL || mArchiveReminderMinutes)
<a name="l01735"></a>01735 && QDateTime::currentDateTime() < mNextMainDateTime.dateTime())
<a name="l01736"></a>01736 {
<a name="l01737"></a>01737 <span class="comment">// It's an reminder alarm. Don't allow it to be deferred past its main alarm time.</span>
<a name="l01738"></a>01738 endTime = mNextMainDateTime;
<a name="l01739"></a>01739 ltype = LIMIT_REMINDER;
<a name="l01740"></a>01740 }
<a name="l01741"></a>01741 <span class="keywordflow">else</span>
<a name="l01742"></a>01742 ltype = LIMIT_NONE;
<a name="l01743"></a>01743 <span class="keywordflow">if</span> (ltype != LIMIT_NONE)
<a name="l01744"></a>01744 endTime = endTime.addMins(-1);
<a name="l01745"></a>01745 <span class="keywordflow">if</span> (limitType)
<a name="l01746"></a>01746 *limitType = ltype;
<a name="l01747"></a>01747 <span class="keywordflow">return</span> endTime;
<a name="l01748"></a>01748 }
<a name="l01749"></a>01749
<a name="l01750"></a>01750 <span class="comment">/******************************************************************************</span>
<a name="l01751"></a>01751 <span class="comment"> * Set the event to be a copy of the specified event, making the specified</span>
<a name="l01752"></a>01752 <span class="comment"> * alarm the 'displaying' alarm.</span>
<a name="l01753"></a>01753 <span class="comment"> * The purpose of setting up a 'displaying' alarm is to be able to reinstate</span>
<a name="l01754"></a>01754 <span class="comment"> * the alarm message in case of a crash, or to reinstate it should the user</span>
<a name="l01755"></a>01755 <span class="comment"> * choose to defer the alarm. Note that even repeat-at-login alarms need to be</span>
<a name="l01756"></a>01756 <span class="comment"> * saved in case their end time expires before the next login.</span>
<a name="l01757"></a>01757 <span class="comment"> * Reply = true if successful, false if alarm was not copied.</span>
<a name="l01758"></a>01758 <span class="comment"> */</span>
<a name="l01759"></a>01759 <span class="keywordtype">bool</span> KAEvent::setDisplaying(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, KAAlarm::Type alarmType, <span class="keyword">const</span> QDateTime& repeatAtLoginTime)
<a name="l01760"></a>01760 {
<a name="l01761"></a>01761 <span class="keywordflow">if</span> (!mDisplaying
<a name="l01762"></a>01762 && (alarmType == KAAlarm::MAIN_ALARM
<a name="l01763"></a>01763 || alarmType == KAAlarm::REMINDER_ALARM
<a name="l01764"></a>01764 || alarmType == KAAlarm::DEFERRED_REMINDER_ALARM
<a name="l01765"></a>01765 || alarmType == KAAlarm::DEFERRED_ALARM
<a name="l01766"></a>01766 || alarmType == KAAlarm::AT_LOGIN_ALARM))
<a name="l01767"></a>01767 {
<a name="l01768"></a>01768 <span class="comment">//kdDebug(5950)<<"KAEvent::setDisplaying("<<event.id()<<", "<<(alarmType==KAAlarm::MAIN_ALARM?"MAIN":alarmType==KAAlarm::REMINDER_ALARM?"REMINDER":alarmType==KAAlarm::DEFERRED_REMINDER_ALARM?"REMINDER_DEFERRAL":alarmType==KAAlarm::DEFERRED_ALARM?"DEFERRAL":"LOGIN")<<"): time="<<repeatAtLoginTime.toString()<<endl;</span>
<a name="l01769"></a>01769 KAAlarm al = <span class="keyword">event</span>.alarm(alarmType);
<a name="l01770"></a>01770 <span class="keywordflow">if</span> (al.valid())
<a name="l01771"></a>01771 {
<a name="l01772"></a>01772 *<span class="keyword">this</span> = event;
<a name="l01773"></a>01773 setUid(DISPLAYING);
<a name="l01774"></a>01774 mDisplaying = <span class="keyword">true</span>;
<a name="l01775"></a>01775 mDisplayingTime = (alarmType == KAAlarm::AT_LOGIN_ALARM) ? repeatAtLoginTime : al.dateTime();
<a name="l01776"></a>01776 <span class="keywordflow">switch</span> (al.type())
<a name="l01777"></a>01777 {
<a name="l01778"></a>01778 <span class="keywordflow">case</span> KAAlarm::AT_LOGIN__ALARM: mDisplayingFlags = REPEAT_AT_LOGIN; <span class="keywordflow">break</span>;
<a name="l01779"></a>01779 <span class="keywordflow">case</span> KAAlarm::REMINDER__ALARM: mDisplayingFlags = REMINDER; <span class="keywordflow">break</span>;
<a name="l01780"></a>01780 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_TIME__ALARM: mDisplayingFlags = REMINDER | TIME_DEFERRAL; <span class="keywordflow">break</span>;
<a name="l01781"></a>01781 <span class="keywordflow">case</span> KAAlarm::DEFERRED_REMINDER_DATE__ALARM: mDisplayingFlags = REMINDER | DATE_DEFERRAL; <span class="keywordflow">break</span>;
<a name="l01782"></a>01782 <span class="keywordflow">case</span> KAAlarm::DEFERRED_TIME__ALARM: mDisplayingFlags = TIME_DEFERRAL; <span class="keywordflow">break</span>;
<a name="l01783"></a>01783 <span class="keywordflow">case</span> KAAlarm::DEFERRED_DATE__ALARM: mDisplayingFlags = DATE_DEFERRAL; <span class="keywordflow">break</span>;
<a name="l01784"></a>01784 <span class="keywordflow">default</span>: mDisplayingFlags = 0; <span class="keywordflow">break</span>;
<a name="l01785"></a>01785 }
<a name="l01786"></a>01786 ++mAlarmCount;
<a name="l01787"></a>01787 mUpdated = <span class="keyword">true</span>;
<a name="l01788"></a>01788 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01789"></a>01789 }
<a name="l01790"></a>01790 }
<a name="l01791"></a>01791 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01792"></a>01792 }
<a name="l01793"></a>01793
<a name="l01794"></a>01794 <span class="comment">/******************************************************************************</span>
<a name="l01795"></a>01795 <span class="comment"> * Return the original alarm which the displaying alarm refers to.</span>
<a name="l01796"></a>01796 <span class="comment"> */</span>
<a name="l01797"></a>01797 KAAlarm KAEvent::convertDisplayingAlarm()<span class="keyword"> const</span>
<a name="l01798"></a>01798 <span class="keyword"></span>{
<a name="l01799"></a>01799 KAAlarm al;
<a name="l01800"></a>01800 <span class="keywordflow">if</span> (mDisplaying)
<a name="l01801"></a>01801 {
<a name="l01802"></a>01802 al = alarm(KAAlarm::DISPLAYING_ALARM);
<a name="l01803"></a>01803 <span class="keywordflow">if</span> (mDisplayingFlags & REPEAT_AT_LOGIN)
<a name="l01804"></a>01804 {
<a name="l01805"></a>01805 al.mRepeatAtLogin = <span class="keyword">true</span>;
<a name="l01806"></a>01806 al.mType = KAAlarm::AT_LOGIN__ALARM;
<a name="l01807"></a>01807 }
<a name="l01808"></a>01808 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mDisplayingFlags & DEFERRAL)
<a name="l01809"></a>01809 {
<a name="l01810"></a>01810 al.mDeferred = <span class="keyword">true</span>;
<a name="l01811"></a>01811 al.mType = (mDisplayingFlags == (REMINDER | DATE_DEFERRAL)) ? KAAlarm::DEFERRED_REMINDER_DATE__ALARM
<a name="l01812"></a>01812 : (mDisplayingFlags == (REMINDER | TIME_DEFERRAL)) ? KAAlarm::DEFERRED_REMINDER_TIME__ALARM
<a name="l01813"></a>01813 : (mDisplayingFlags == DATE_DEFERRAL) ? KAAlarm::DEFERRED_DATE__ALARM
<a name="l01814"></a>01814 : KAAlarm::DEFERRED_TIME__ALARM;
<a name="l01815"></a>01815 }
<a name="l01816"></a>01816 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mDisplayingFlags & REMINDER)
<a name="l01817"></a>01817 al.mType = KAAlarm::REMINDER__ALARM;
<a name="l01818"></a>01818 <span class="keywordflow">else</span>
<a name="l01819"></a>01819 al.mType = KAAlarm::MAIN__ALARM;
<a name="l01820"></a>01820 }
<a name="l01821"></a>01821 <span class="keywordflow">return</span> al;
<a name="l01822"></a>01822 }
<a name="l01823"></a>01823
<a name="l01824"></a>01824 <span class="comment">/******************************************************************************</span>
<a name="l01825"></a>01825 <span class="comment"> * Reinstate the original event from the 'displaying' event.</span>
<a name="l01826"></a>01826 <span class="comment"> */</span>
<a name="l01827"></a>01827 <span class="keywordtype">void</span> KAEvent::reinstateFromDisplaying(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& dispEvent)
<a name="l01828"></a>01828 {
<a name="l01829"></a>01829 <span class="keywordflow">if</span> (dispEvent.mDisplaying)
<a name="l01830"></a>01830 {
<a name="l01831"></a>01831 *<span class="keyword">this</span> = dispEvent;
<a name="l01832"></a>01832 setUid(ACTIVE);
<a name="l01833"></a>01833 mDisplaying = <span class="keyword">false</span>;
<a name="l01834"></a>01834 --mAlarmCount;
<a name="l01835"></a>01835 mUpdated = <span class="keyword">true</span>;
<a name="l01836"></a>01836 }
<a name="l01837"></a>01837 }
<a name="l01838"></a>01838
<a name="l01839"></a>01839 <span class="comment">/******************************************************************************</span>
<a name="l01840"></a>01840 <span class="comment"> * Determine whether the event will occur after the specified date/time.</span>
<a name="l01841"></a>01841 <span class="comment"> * If 'includeRepetitions' is true and the alarm has a sub-repetition, it</span>
<a name="l01842"></a>01842 <span class="comment"> * returns true if any repetitions occur after the specified date/time.</span>
<a name="l01843"></a>01843 <span class="comment"> */</span>
<a name="l01844"></a>01844 <span class="keywordtype">bool</span> KAEvent::occursAfter(<span class="keyword">const</span> QDateTime& preDateTime, <span class="keywordtype">bool</span> includeRepetitions)<span class="keyword"> const</span>
<a name="l01845"></a>01845 <span class="keyword"></span>{
<a name="l01846"></a>01846 QDateTime dt;
<a name="l01847"></a>01847 <span class="keywordflow">if</span> (checkRecur() != KARecurrence::NO_RECUR)
<a name="l01848"></a>01848 {
<a name="l01849"></a>01849 <span class="keywordflow">if</span> (mRecurrence->duration() < 0)
<a name="l01850"></a>01850 <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// infinite recurrence</span>
<a name="l01851"></a>01851 dt = mRecurrence->endDateTime();
<a name="l01852"></a>01852 }
<a name="l01853"></a>01853 <span class="keywordflow">else</span>
<a name="l01854"></a>01854 dt = mNextMainDateTime.dateTime();
<a name="l01855"></a>01855 <span class="keywordflow">if</span> (mStartDateTime.isDateOnly())
<a name="l01856"></a>01856 {
<a name="l01857"></a>01857 QDate pre = preDateTime.date();
<a name="l01858"></a>01858 <span class="keywordflow">if</span> (preDateTime.time() < Preferences::startOfDay())
<a name="l01859"></a>01859 pre = pre.addDays(-1); <span class="comment">// today's recurrence (if today recurs) is still to come</span>
<a name="l01860"></a>01860 <span class="keywordflow">if</span> (pre < dt.date())
<a name="l01861"></a>01861 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01862"></a>01862 }
<a name="l01863"></a>01863 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (preDateTime < dt)
<a name="l01864"></a>01864 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01865"></a>01865
<a name="l01866"></a>01866 <span class="keywordflow">if</span> (includeRepetitions && mRepeatCount)
<a name="l01867"></a>01867 {
<a name="l01868"></a>01868 <span class="keywordflow">if</span> (preDateTime < dt.addSecs(mRepeatCount * mRepeatInterval * 60))
<a name="l01869"></a>01869 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01870"></a>01870 }
<a name="l01871"></a>01871 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01872"></a>01872 }
<a name="l01873"></a>01873
<a name="l01874"></a>01874 <span class="comment">/******************************************************************************</span>
<a name="l01875"></a>01875 <span class="comment"> * Get the date/time of the next occurrence of the event, after the specified</span>
<a name="l01876"></a>01876 <span class="comment"> * date/time.</span>
<a name="l01877"></a>01877 <span class="comment"> * 'result' = date/time of next occurrence, or invalid date/time if none.</span>
<a name="l01878"></a>01878 <span class="comment"> */</span>
<a name="l01879"></a>01879 KAEvent::OccurType KAEvent::nextOccurrence(<span class="keyword">const</span> QDateTime& preDateTime, DateTime& result,
<a name="l01880"></a>01880 KAEvent::OccurOption includeRepetitions)<span class="keyword"> const</span>
<a name="l01881"></a>01881 <span class="keyword"></span>{
<a name="l01882"></a>01882 <span class="keywordtype">int</span> repeatSecs = 0;
<a name="l01883"></a>01883 QDateTime pre = preDateTime;
<a name="l01884"></a>01884 <span class="keywordflow">if</span> (includeRepetitions != IGNORE_REPETITION)
<a name="l01885"></a>01885 {
<a name="l01886"></a>01886 <span class="keywordflow">if</span> (!mRepeatCount || !mRepeatInterval)
<a name="l01887"></a>01887 includeRepetitions = IGNORE_REPETITION;
<a name="l01888"></a>01888 <span class="keywordflow">else</span>
<a name="l01889"></a>01889 {
<a name="l01890"></a>01890 repeatSecs = mRepeatInterval * 60;
<a name="l01891"></a>01891 pre = preDateTime.addSecs(-mRepeatCount * repeatSecs);
<a name="l01892"></a>01892 }
<a name="l01893"></a>01893 }
<a name="l01894"></a>01894
<a name="l01895"></a>01895 OccurType type;
<a name="l01896"></a>01896 <span class="keywordtype">bool</span> recurs = (checkRecur() != KARecurrence::NO_RECUR);
<a name="l01897"></a>01897 <span class="keywordflow">if</span> (recurs)
<a name="l01898"></a>01898 type = nextRecurrence(pre, result);
<a name="l01899"></a>01899 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (pre < mNextMainDateTime.dateTime())
<a name="l01900"></a>01900 {
<a name="l01901"></a>01901 result = mNextMainDateTime;
<a name="l01902"></a>01902 type = FIRST_OR_ONLY_OCCURRENCE;
<a name="l01903"></a>01903 }
<a name="l01904"></a>01904 <span class="keywordflow">else</span>
<a name="l01905"></a>01905 {
<a name="l01906"></a>01906 result = DateTime();
<a name="l01907"></a>01907 type = NO_OCCURRENCE;
<a name="l01908"></a>01908 }
<a name="l01909"></a>01909
<a name="l01910"></a>01910 <span class="keywordflow">if</span> (type != NO_OCCURRENCE && result <= preDateTime && includeRepetitions != IGNORE_REPETITION)
<a name="l01911"></a>01911 {
<a name="l01912"></a>01912 <span class="comment">// The next occurrence is a sub-repetition</span>
<a name="l01913"></a>01913 <span class="keywordtype">int</span> repetition = result.secsTo(preDateTime) / repeatSecs + 1;
<a name="l01914"></a>01914 DateTime repeatDT = result.addSecs(repetition * repeatSecs);
<a name="l01915"></a>01915 <span class="keywordflow">if</span> (recurs)
<a name="l01916"></a>01916 {
<a name="l01917"></a>01917 <span class="comment">// We've found a recurrence before the specified date/time, which has</span>
<a name="l01918"></a>01918 <span class="comment">// a sub-repetition after the date/time.</span>
<a name="l01919"></a>01919 <span class="comment">// However, if the intervals between recurrences vary, we could possibly</span>
<a name="l01920"></a>01920 <span class="comment">// have missed a later recurrence, which fits the criterion, so check again.</span>
<a name="l01921"></a>01921 DateTime dt;
<a name="l01922"></a>01922 OccurType newType = previousOccurrence(repeatDT.dateTime(), dt, <span class="keyword">false</span>);
<a name="l01923"></a>01923 <span class="keywordflow">if</span> (dt > result)
<a name="l01924"></a>01924 {
<a name="l01925"></a>01925 type = newType;
<a name="l01926"></a>01926 result = dt;
<a name="l01927"></a>01927 <span class="keywordflow">if</span> (includeRepetitions == RETURN_REPETITION && result <= preDateTime)
<a name="l01928"></a>01928 {
<a name="l01929"></a>01929 <span class="comment">// The next occurrence is a sub-repetition</span>
<a name="l01930"></a>01930 <span class="keywordtype">int</span> repetition = result.secsTo(preDateTime) / repeatSecs + 1;
<a name="l01931"></a>01931 result = result.addSecs(repetition * repeatSecs);
<a name="l01932"></a>01932 type = <span class="keyword">static_cast<</span>OccurType<span class="keyword">></span>(type | OCCURRENCE_REPEAT);
<a name="l01933"></a>01933 }
<a name="l01934"></a>01934 <span class="keywordflow">return</span> type;
<a name="l01935"></a>01935 }
<a name="l01936"></a>01936 }
<a name="l01937"></a>01937 <span class="keywordflow">if</span> (includeRepetitions == RETURN_REPETITION)
<a name="l01938"></a>01938 {
<a name="l01939"></a>01939 <span class="comment">// The next occurrence is a sub-repetition</span>
<a name="l01940"></a>01940 result = repeatDT;
<a name="l01941"></a>01941 type = <span class="keyword">static_cast<</span>OccurType<span class="keyword">></span>(type | OCCURRENCE_REPEAT);
<a name="l01942"></a>01942 }
<a name="l01943"></a>01943 }
<a name="l01944"></a>01944 <span class="keywordflow">return</span> type;
<a name="l01945"></a>01945 }
<a name="l01946"></a>01946
<a name="l01947"></a>01947 <span class="comment">/******************************************************************************</span>
<a name="l01948"></a>01948 <span class="comment"> * Get the date/time of the last previous occurrence of the event, before the</span>
<a name="l01949"></a>01949 <span class="comment"> * specified date/time.</span>
<a name="l01950"></a>01950 <span class="comment"> * If 'includeRepetitions' is true and the alarm has a sub-repetition, the</span>
<a name="l01951"></a>01951 <span class="comment"> * last previous repetition is returned if appropriate.</span>
<a name="l01952"></a>01952 <span class="comment"> * 'result' = date/time of previous occurrence, or invalid date/time if none.</span>
<a name="l01953"></a>01953 <span class="comment"> */</span>
<a name="l01954"></a>01954 KAEvent::OccurType KAEvent::previousOccurrence(<span class="keyword">const</span> QDateTime& afterDateTime, DateTime& result, <span class="keywordtype">bool</span> includeRepetitions)<span class="keyword"> const</span>
<a name="l01955"></a>01955 <span class="keyword"></span>{
<a name="l01956"></a>01956 <span class="keywordflow">if</span> (mStartDateTime >= afterDateTime)
<a name="l01957"></a>01957 {
<a name="l01958"></a>01958 result = QDateTime();
<a name="l01959"></a>01959 <span class="keywordflow">return</span> NO_OCCURRENCE; <span class="comment">// the event starts after the specified date/time</span>
<a name="l01960"></a>01960 }
<a name="l01961"></a>01961
<a name="l01962"></a>01962 <span class="comment">// Find the latest recurrence of the event</span>
<a name="l01963"></a>01963 OccurType type;
<a name="l01964"></a>01964 <span class="keywordflow">if</span> (checkRecur() == KARecurrence::NO_RECUR)
<a name="l01965"></a>01965 {
<a name="l01966"></a>01966 result = mStartDateTime;
<a name="l01967"></a>01967 type = FIRST_OR_ONLY_OCCURRENCE;
<a name="l01968"></a>01968 }
<a name="l01969"></a>01969 <span class="keywordflow">else</span>
<a name="l01970"></a>01970 {
<a name="l01971"></a>01971 QDateTime recurStart = mRecurrence->startDateTime();
<a name="l01972"></a>01972 QDateTime after = afterDateTime;
<a name="l01973"></a>01973 <span class="keywordflow">if</span> (mStartDateTime.isDateOnly() && afterDateTime.time() > Preferences::startOfDay())
<a name="l01974"></a>01974 after = after.addDays(1); <span class="comment">// today's recurrence (if today recurs) has passed</span>
<a name="l01975"></a>01975 QDateTime dt = mRecurrence->getPreviousDateTime(after);
<a name="l01976"></a>01976 result.set(dt, mStartDateTime.isDateOnly());
<a name="l01977"></a>01977 <span class="keywordflow">if</span> (!dt.isValid())
<a name="l01978"></a>01978 <span class="keywordflow">return</span> NO_OCCURRENCE;
<a name="l01979"></a>01979 <span class="keywordflow">if</span> (dt == recurStart)
<a name="l01980"></a>01980 type = FIRST_OR_ONLY_OCCURRENCE;
<a name="l01981"></a>01981 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mRecurrence->getNextDateTime(dt).isValid())
<a name="l01982"></a>01982 type = result.isDateOnly() ? RECURRENCE_DATE : RECURRENCE_DATE_TIME;
<a name="l01983"></a>01983 <span class="keywordflow">else</span>
<a name="l01984"></a>01984 type = LAST_RECURRENCE;
<a name="l01985"></a>01985 }
<a name="l01986"></a>01986
<a name="l01987"></a>01987 <span class="keywordflow">if</span> (includeRepetitions && mRepeatCount)
<a name="l01988"></a>01988 {
<a name="l01989"></a>01989 <span class="comment">// Find the latest repetition which is before the specified time.</span>
<a name="l01990"></a>01990 <span class="comment">// N.B. This is coded to avoid 32-bit integer overflow which occurs</span>
<a name="l01991"></a>01991 <span class="comment">// in QDateTime::secsTo() for large enough time differences.</span>
<a name="l01992"></a>01992 <span class="keywordtype">int</span> repeatSecs = mRepeatInterval * 60;
<a name="l01993"></a>01993 DateTime lastRepetition = result.addSecs(mRepeatCount * repeatSecs);
<a name="l01994"></a>01994 <span class="keywordflow">if</span> (lastRepetition < afterDateTime)
<a name="l01995"></a>01995 {
<a name="l01996"></a>01996 result = lastRepetition;
<a name="l01997"></a>01997 <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>OccurType<span class="keyword">></span>(type | OCCURRENCE_REPEAT);
<a name="l01998"></a>01998 }
<a name="l01999"></a>01999 <span class="keywordtype">int</span> repetition = (result.dateTime().secsTo(afterDateTime) - 1) / repeatSecs;
<a name="l02000"></a>02000 <span class="keywordflow">if</span> (repetition > 0)
<a name="l02001"></a>02001 {
<a name="l02002"></a>02002 result = result.addSecs(repetition * repeatSecs);
<a name="l02003"></a>02003 <span class="keywordflow">return</span> <span class="keyword">static_cast<</span>OccurType<span class="keyword">></span>(type | OCCURRENCE_REPEAT);
<a name="l02004"></a>02004 }
<a name="l02005"></a>02005 }
<a name="l02006"></a>02006 <span class="keywordflow">return</span> type;
<a name="l02007"></a>02007 }
<a name="l02008"></a>02008
<a name="l02009"></a>02009 <span class="comment">/******************************************************************************</span>
<a name="l02010"></a>02010 <span class="comment"> * Set the date/time of the event to the next scheduled occurrence after the</span>
<a name="l02011"></a>02011 <span class="comment"> * specified date/time, provided that this is later than its current date/time.</span>
<a name="l02012"></a>02012 <span class="comment"> * Any reminder alarm is adjusted accordingly.</span>
<a name="l02013"></a>02013 <span class="comment"> * If the alarm has a sub-repetition, and a repetition of a previous</span>
<a name="l02014"></a>02014 <span class="comment"> * recurrence occurs after the specified date/time, that repetition is set as</span>
<a name="l02015"></a>02015 <span class="comment"> * the next occurrence.</span>
<a name="l02016"></a>02016 <span class="comment"> */</span>
<a name="l02017"></a>02017 KAEvent::OccurType KAEvent::setNextOccurrence(<span class="keyword">const</span> QDateTime& preDateTime)
<a name="l02018"></a>02018 {
<a name="l02019"></a>02019 <span class="keywordflow">if</span> (preDateTime < mNextMainDateTime.dateTime())
<a name="l02020"></a>02020 <span class="keywordflow">return</span> FIRST_OR_ONLY_OCCURRENCE; <span class="comment">// it might not be the first recurrence - tant pis</span>
<a name="l02021"></a>02021 QDateTime pre = preDateTime;
<a name="l02022"></a>02022 <span class="comment">// If there are repetitions, adjust the comparison date/time so that</span>
<a name="l02023"></a>02023 <span class="comment">// we find the earliest recurrence which has a repetition falling after</span>
<a name="l02024"></a>02024 <span class="comment">// the specified preDateTime.</span>
<a name="l02025"></a>02025 <span class="keywordflow">if</span> (mRepeatCount && mRepeatInterval)
<a name="l02026"></a>02026 pre = preDateTime.addSecs(-mRepeatCount * mRepeatInterval * 60);
<a name="l02027"></a>02027
<a name="l02028"></a>02028 DateTime dt;
<a name="l02029"></a>02029 OccurType type;
<a name="l02030"></a>02030 <span class="keywordflow">if</span> (pre < mNextMainDateTime.dateTime())
<a name="l02031"></a>02031 {
<a name="l02032"></a>02032 dt = mNextMainDateTime;
<a name="l02033"></a>02033 type = FIRST_OR_ONLY_OCCURRENCE; <span class="comment">// may not actually be the first occurrence</span>
<a name="l02034"></a>02034 }
<a name="l02035"></a>02035 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (checkRecur() != KARecurrence::NO_RECUR)
<a name="l02036"></a>02036 {
<a name="l02037"></a>02037 type = nextRecurrence(pre, dt);
<a name="l02038"></a>02038 <span class="keywordflow">if</span> (type == NO_OCCURRENCE)
<a name="l02039"></a>02039 <span class="keywordflow">return</span> NO_OCCURRENCE;
<a name="l02040"></a>02040 <span class="keywordflow">if</span> (type != FIRST_OR_ONLY_OCCURRENCE && dt != mNextMainDateTime)
<a name="l02041"></a>02041 {
<a name="l02042"></a>02042 <span class="comment">// Need to reschedule the next trigger date/time</span>
<a name="l02043"></a>02043 mNextMainDateTime = dt;
<a name="l02044"></a>02044 <span class="comment">// Reinstate the reminder (if any) for the rescheduled recurrence</span>
<a name="l02045"></a>02045 <span class="keywordflow">if</span> (mDeferral == REMINDER_DEFERRAL || mArchiveReminderMinutes)
<a name="l02046"></a>02046 {
<a name="l02047"></a>02047 <span class="keywordflow">if</span> (mReminderOnceOnly)
<a name="l02048"></a>02048 {
<a name="l02049"></a>02049 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l02050"></a>02050 set_archiveReminder();
<a name="l02051"></a>02051 }
<a name="l02052"></a>02052 <span class="keywordflow">else</span>
<a name="l02053"></a>02053 set_reminder(mArchiveReminderMinutes);
<a name="l02054"></a>02054 }
<a name="l02055"></a>02055 <span class="keywordflow">if</span> (mDeferral == REMINDER_DEFERRAL)
<a name="l02056"></a>02056 set_deferral(NO_DEFERRAL);
<a name="l02057"></a>02057 mUpdated = <span class="keyword">true</span>;
<a name="l02058"></a>02058 }
<a name="l02059"></a>02059 }
<a name="l02060"></a>02060 <span class="keywordflow">else</span>
<a name="l02061"></a>02061 <span class="keywordflow">return</span> NO_OCCURRENCE;
<a name="l02062"></a>02062
<a name="l02063"></a>02063 <span class="keywordflow">if</span> (mRepeatCount && mRepeatInterval)
<a name="l02064"></a>02064 {
<a name="l02065"></a>02065 <span class="keywordtype">int</span> secs = dt.dateTime().secsTo(preDateTime);
<a name="l02066"></a>02066 <span class="keywordflow">if</span> (secs >= 0)
<a name="l02067"></a>02067 {
<a name="l02068"></a>02068 <span class="comment">// The next occurrence is a sub-repetition.</span>
<a name="l02069"></a>02069 type = <span class="keyword">static_cast<</span>OccurType<span class="keyword">></span>(type | OCCURRENCE_REPEAT);
<a name="l02070"></a>02070 mNextRepeat = (secs / (60 * mRepeatInterval)) + 1;
<a name="l02071"></a>02071 <span class="comment">// Repetitions can't have a reminder, so remove any.</span>
<a name="l02072"></a>02072 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l02073"></a>02073 set_archiveReminder();
<a name="l02074"></a>02074 <span class="keywordflow">if</span> (mDeferral == REMINDER_DEFERRAL)
<a name="l02075"></a>02075 set_deferral(NO_DEFERRAL);
<a name="l02076"></a>02076 mUpdated = <span class="keyword">true</span>;
<a name="l02077"></a>02077 }
<a name="l02078"></a>02078 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mNextRepeat)
<a name="l02079"></a>02079 {
<a name="l02080"></a>02080 <span class="comment">// The next occurrence is the main occurrence, not a repetition</span>
<a name="l02081"></a>02081 mNextRepeat = 0;
<a name="l02082"></a>02082 mUpdated = <span class="keyword">true</span>;
<a name="l02083"></a>02083 }
<a name="l02084"></a>02084 }
<a name="l02085"></a>02085 <span class="keywordflow">return</span> type;
<a name="l02086"></a>02086 }
<a name="l02087"></a>02087
<a name="l02088"></a>02088 <span class="comment">/******************************************************************************</span>
<a name="l02089"></a>02089 <span class="comment"> * Get the date/time of the next recurrence of the event, after the specified</span>
<a name="l02090"></a>02090 <span class="comment"> * date/time.</span>
<a name="l02091"></a>02091 <span class="comment"> * 'result' = date/time of next occurrence, or invalid date/time if none.</span>
<a name="l02092"></a>02092 <span class="comment"> */</span>
<a name="l02093"></a>02093 KAEvent::OccurType KAEvent::nextRecurrence(<span class="keyword">const</span> QDateTime& preDateTime, DateTime& result)<span class="keyword"> const</span>
<a name="l02094"></a>02094 <span class="keyword"></span>{
<a name="l02095"></a>02095 QDateTime recurStart = mRecurrence->startDateTime();
<a name="l02096"></a>02096 QDateTime pre = preDateTime;
<a name="l02097"></a>02097 <span class="keywordflow">if</span> (mStartDateTime.isDateOnly() && preDateTime.time() < Preferences::startOfDay())
<a name="l02098"></a>02098 {
<a name="l02099"></a>02099 pre = pre.addDays(-1); <span class="comment">// today's recurrence (if today recurs) is still to come</span>
<a name="l02100"></a>02100 pre.setTime(Preferences::startOfDay());
<a name="l02101"></a>02101 }
<a name="l02102"></a>02102 QDateTime dt = mRecurrence->getNextDateTime(pre);
<a name="l02103"></a>02103 result.set(dt, mStartDateTime.isDateOnly());
<a name="l02104"></a>02104 <span class="keywordflow">if</span> (!dt.isValid())
<a name="l02105"></a>02105 <span class="keywordflow">return</span> NO_OCCURRENCE;
<a name="l02106"></a>02106 <span class="keywordflow">if</span> (dt == recurStart)
<a name="l02107"></a>02107 <span class="keywordflow">return</span> FIRST_OR_ONLY_OCCURRENCE;
<a name="l02108"></a>02108 <span class="keywordflow">if</span> (mRecurrence->duration() >= 0 && dt == mRecurrence->endDateTime())
<a name="l02109"></a>02109 <span class="keywordflow">return</span> LAST_RECURRENCE;
<a name="l02110"></a>02110 <span class="keywordflow">return</span> result.isDateOnly() ? RECURRENCE_DATE : RECURRENCE_DATE_TIME;
<a name="l02111"></a>02111 }
<a name="l02112"></a>02112
<a name="l02113"></a>02113 <span class="comment">/******************************************************************************</span>
<a name="l02114"></a>02114 <span class="comment"> * Return the recurrence interval as text suitable for display.</span>
<a name="l02115"></a>02115 <span class="comment"> */</span>
<a name="l02116"></a>02116 QString KAEvent::recurrenceText(<span class="keywordtype">bool</span> brief)<span class="keyword"> const</span>
<a name="l02117"></a>02117 <span class="keyword"></span>{
<a name="l02118"></a>02118 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l02119"></a>02119 <span class="keywordflow">return</span> brief ? i18n(<span class="stringliteral">"Brief form of 'At Login'"</span>, <span class="stringliteral">"Login"</span>) : i18n(<span class="stringliteral">"At login"</span>);
<a name="l02120"></a>02120 <span class="keywordflow">if</span> (mRecurrence)
<a name="l02121"></a>02121 {
<a name="l02122"></a>02122 <span class="keywordtype">int</span> frequency = mRecurrence->frequency();
<a name="l02123"></a>02123 <span class="keywordflow">switch</span> (mRecurrence->defaultRRuleConst()->recurrenceType())
<a name="l02124"></a>02124 {
<a name="l02125"></a>02125 <span class="keywordflow">case</span> RecurrenceRule::rMinutely:
<a name="l02126"></a>02126 <span class="keywordflow">if</span> (frequency < 60)
<a name="l02127"></a>02127 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Minute"</span>, <span class="stringliteral">"%n Minutes"</span>, frequency);
<a name="l02128"></a>02128 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (frequency % 60 == 0)
<a name="l02129"></a>02129 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Hour"</span>, <span class="stringliteral">"%n Hours"</span>, frequency/60);
<a name="l02130"></a>02130 <span class="keywordflow">else</span>
<a name="l02131"></a>02131 {
<a name="l02132"></a>02132 QString mins;
<a name="l02133"></a>02133 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"Hours and Minutes"</span>, <span class="stringliteral">"%1H %2M"</span>).arg(QString::number(frequency/60)).arg(mins.sprintf(<span class="stringliteral">"%02d"</span>, frequency%60));
<a name="l02134"></a>02134 }
<a name="l02135"></a>02135 <span class="keywordflow">case</span> RecurrenceRule::rDaily:
<a name="l02136"></a>02136 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Day"</span>, <span class="stringliteral">"%n Days"</span>, frequency);
<a name="l02137"></a>02137 <span class="keywordflow">case</span> RecurrenceRule::rWeekly:
<a name="l02138"></a>02138 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Week"</span>, <span class="stringliteral">"%n Weeks"</span>, frequency);
<a name="l02139"></a>02139 <span class="keywordflow">case</span> RecurrenceRule::rMonthly:
<a name="l02140"></a>02140 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Month"</span>, <span class="stringliteral">"%n Months"</span>, frequency);
<a name="l02141"></a>02141 <span class="keywordflow">case</span> RecurrenceRule::rYearly:
<a name="l02142"></a>02142 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Year"</span>, <span class="stringliteral">"%n Years"</span>, frequency);
<a name="l02143"></a>02143 <span class="keywordflow">case</span> RecurrenceRule::rNone:
<a name="l02144"></a>02144 <span class="keywordflow">default</span>:
<a name="l02145"></a>02145 <span class="keywordflow">break</span>;
<a name="l02146"></a>02146 }
<a name="l02147"></a>02147 }
<a name="l02148"></a>02148 <span class="keywordflow">return</span> brief ? QString::null : i18n(<span class="stringliteral">"None"</span>);
<a name="l02149"></a>02149 }
<a name="l02150"></a>02150
<a name="l02151"></a>02151 <span class="comment">/******************************************************************************</span>
<a name="l02152"></a>02152 <span class="comment"> * Return the repetition interval as text suitable for display.</span>
<a name="l02153"></a>02153 <span class="comment"> */</span>
<a name="l02154"></a>02154 QString KAEvent::repetitionText(<span class="keywordtype">bool</span> brief)<span class="keyword"> const</span>
<a name="l02155"></a>02155 <span class="keyword"></span>{
<a name="l02156"></a>02156 <span class="keywordflow">if</span> (mRepeatCount)
<a name="l02157"></a>02157 {
<a name="l02158"></a>02158 <span class="keywordflow">if</span> (mRepeatInterval % 1440)
<a name="l02159"></a>02159 {
<a name="l02160"></a>02160 <span class="keywordflow">if</span> (mRepeatInterval < 60)
<a name="l02161"></a>02161 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Minute"</span>, <span class="stringliteral">"%n Minutes"</span>, mRepeatInterval);
<a name="l02162"></a>02162 <span class="keywordflow">if</span> (mRepeatInterval % 60 == 0)
<a name="l02163"></a>02163 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Hour"</span>, <span class="stringliteral">"%n Hours"</span>, mRepeatInterval/60);
<a name="l02164"></a>02164 QString mins;
<a name="l02165"></a>02165 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"Hours and Minutes"</span>, <span class="stringliteral">"%1H %2M"</span>).arg(QString::number(mRepeatInterval/60)).arg(mins.sprintf(<span class="stringliteral">"%02d"</span>, mRepeatInterval%60));
<a name="l02166"></a>02166 }
<a name="l02167"></a>02167 <span class="keywordflow">if</span> (mRepeatInterval % (7*1440))
<a name="l02168"></a>02168 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Day"</span>, <span class="stringliteral">"%n Days"</span>, mRepeatInterval/1440);
<a name="l02169"></a>02169 <span class="keywordflow">return</span> i18n(<span class="stringliteral">"1 Week"</span>, <span class="stringliteral">"%n Weeks"</span>, mRepeatInterval/(7*1440));
<a name="l02170"></a>02170 }
<a name="l02171"></a>02171 <span class="keywordflow">return</span> brief ? QString::null : i18n(<span class="stringliteral">"None"</span>);
<a name="l02172"></a>02172 }
<a name="l02173"></a>02173
<a name="l02174"></a>02174 <span class="comment">/******************************************************************************</span>
<a name="l02175"></a>02175 <span class="comment"> * Adjust the event date/time to the first recurrence of the event, on or after</span>
<a name="l02176"></a>02176 <span class="comment"> * start date/time. The event start date may not be a recurrence date, in which</span>
<a name="l02177"></a>02177 <span class="comment"> * case a later date will be set.</span>
<a name="l02178"></a>02178 <span class="comment"> */</span>
<a name="l02179"></a>02179 <span class="keywordtype">void</span> KAEvent::setFirstRecurrence()
<a name="l02180"></a>02180 {
<a name="l02181"></a>02181 <span class="keywordflow">switch</span> (checkRecur())
<a name="l02182"></a>02182 {
<a name="l02183"></a>02183 <span class="keywordflow">case</span> KARecurrence::NO_RECUR:
<a name="l02184"></a>02184 <span class="keywordflow">case</span> KARecurrence::MINUTELY:
<a name="l02185"></a>02185 <span class="keywordflow">return</span>;
<a name="l02186"></a>02186 <span class="keywordflow">case</span> KARecurrence::ANNUAL_DATE:
<a name="l02187"></a>02187 <span class="keywordflow">case</span> KARecurrence::ANNUAL_POS:
<a name="l02188"></a>02188 <span class="keywordflow">if</span> (mRecurrence->yearMonths().isEmpty())
<a name="l02189"></a>02189 <span class="keywordflow">return</span>; <span class="comment">// (presumably it's a template)</span>
<a name="l02190"></a>02190 <span class="keywordflow">break</span>;
<a name="l02191"></a>02191 <span class="keywordflow">case</span> KARecurrence::DAILY:
<a name="l02192"></a>02192 <span class="keywordflow">case</span> KARecurrence::WEEKLY:
<a name="l02193"></a>02193 <span class="keywordflow">case</span> KARecurrence::MONTHLY_POS:
<a name="l02194"></a>02194 <span class="keywordflow">case</span> KARecurrence::MONTHLY_DAY:
<a name="l02195"></a>02195 <span class="keywordflow">break</span>;
<a name="l02196"></a>02196 }
<a name="l02197"></a>02197 QDateTime recurStart = mRecurrence->startDateTime();
<a name="l02198"></a>02198 <span class="keywordflow">if</span> (mRecurrence->recursOn(recurStart.date()))
<a name="l02199"></a>02199 <span class="keywordflow">return</span>; <span class="comment">// it already recurs on the start date</span>
<a name="l02200"></a>02200
<a name="l02201"></a>02201 <span class="comment">// Set the frequency to 1 to find the first possible occurrence</span>
<a name="l02202"></a>02202 <span class="keywordtype">int</span> frequency = mRecurrence->frequency();
<a name="l02203"></a>02203 mRecurrence->setFrequency(1);
<a name="l02204"></a>02204 DateTime next;
<a name="l02205"></a>02205 nextRecurrence(mNextMainDateTime.dateTime(), next);
<a name="l02206"></a>02206 <span class="keywordflow">if</span> (!next.isValid())
<a name="l02207"></a>02207 mRecurrence->setStartDateTime(recurStart); <span class="comment">// reinstate the old value</span>
<a name="l02208"></a>02208 <span class="keywordflow">else</span>
<a name="l02209"></a>02209 {
<a name="l02210"></a>02210 mRecurrence->setStartDateTime(next.dateTime());
<a name="l02211"></a>02211 mStartDateTime = mNextMainDateTime = next;
<a name="l02212"></a>02212 mUpdated = <span class="keyword">true</span>;
<a name="l02213"></a>02213 }
<a name="l02214"></a>02214 mRecurrence->setFrequency(frequency); <span class="comment">// restore the frequency</span>
<a name="l02215"></a>02215 }
<a name="l02216"></a>02216
<a name="l02217"></a>02217 <span class="comment">/******************************************************************************</span>
<a name="l02218"></a>02218 <span class="comment">* Initialise the event's recurrence from a KCal::Recurrence.</span>
<a name="l02219"></a>02219 <span class="comment">* The event's start date/time is not changed.</span>
<a name="l02220"></a>02220 <span class="comment">*/</span>
<a name="l02221"></a>02221 <span class="keywordtype">void</span> KAEvent::setRecurrence(<span class="keyword">const</span> KARecurrence& recurrence)
<a name="l02222"></a>02222 {
<a name="l02223"></a>02223 mUpdated = <span class="keyword">true</span>;
<a name="l02224"></a>02224 <span class="keyword">delete</span> mRecurrence;
<a name="l02225"></a>02225 <span class="keywordflow">if</span> (recurrence.doesRecur())
<a name="l02226"></a>02226 {
<a name="l02227"></a>02227 mRecurrence = <span class="keyword">new</span> KARecurrence(recurrence);
<a name="l02228"></a>02228 mRecurrence->setStartDateTime(mStartDateTime.dateTime());
<a name="l02229"></a>02229 mRecurrence->setFloats(mStartDateTime.isDateOnly());
<a name="l02230"></a>02230 }
<a name="l02231"></a>02231 <span class="keywordflow">else</span>
<a name="l02232"></a>02232 mRecurrence = 0;
<a name="l02233"></a>02233
<a name="l02234"></a>02234 <span class="comment">// Adjust sub-repetition values to fit the recurrence</span>
<a name="l02235"></a>02235 setRepetition(mRepeatInterval, mRepeatCount);
<a name="l02236"></a>02236 }
<a name="l02237"></a>02237
<a name="l02238"></a>02238 <span class="comment">/******************************************************************************</span>
<a name="l02239"></a>02239 <span class="comment">* Initialise the event's sub-repetition.</span>
<a name="l02240"></a>02240 <span class="comment">* The repetition length is adjusted if necessary to fit any recurrence interval.</span>
<a name="l02241"></a>02241 <span class="comment">* Reply = false if a non-daily interval was specified for a date-only recurrence.</span>
<a name="l02242"></a>02242 <span class="comment">*/</span>
<a name="l02243"></a>02243 <span class="keywordtype">bool</span> KAEvent::setRepetition(<span class="keywordtype">int</span> interval, <span class="keywordtype">int</span> count)
<a name="l02244"></a>02244 {
<a name="l02245"></a>02245 mUpdated = <span class="keyword">true</span>;
<a name="l02246"></a>02246 mRepeatInterval = 0;
<a name="l02247"></a>02247 mRepeatCount = 0;
<a name="l02248"></a>02248 mNextRepeat = 0;
<a name="l02249"></a>02249 <span class="keywordflow">if</span> (interval > 0 && count > 0 && !mRepeatAtLogin)
<a name="l02250"></a>02250 {
<a name="l02251"></a>02251 Q_ASSERT(checkRecur() != KARecurrence::NO_RECUR);
<a name="l02252"></a>02252 <span class="keywordflow">if</span> (interval % 1440 && mStartDateTime.isDateOnly())
<a name="l02253"></a>02253 <span class="keywordflow">return</span> <span class="keyword">false</span>; <span class="comment">// interval must be in units of days for date-only alarms</span>
<a name="l02254"></a>02254 <span class="keywordflow">if</span> (checkRecur() != KARecurrence::NO_RECUR)
<a name="l02255"></a>02255 {
<a name="l02256"></a>02256 <span class="keywordtype">int</span> longestInterval = mRecurrence->longestInterval() - 1;
<a name="l02257"></a>02257 <span class="keywordflow">if</span> (interval * count > longestInterval)
<a name="l02258"></a>02258 count = longestInterval / interval;
<a name="l02259"></a>02259 }
<a name="l02260"></a>02260 mRepeatInterval = interval;
<a name="l02261"></a>02261 mRepeatCount = count;
<a name="l02262"></a>02262 }
<a name="l02263"></a>02263 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02264"></a>02264 }
<a name="l02265"></a>02265
<a name="l02266"></a>02266 <span class="comment">/******************************************************************************</span>
<a name="l02267"></a>02267 <span class="comment"> * Set the recurrence to recur at a minutes interval.</span>
<a name="l02268"></a>02268 <span class="comment"> * Parameters:</span>
<a name="l02269"></a>02269 <span class="comment"> * freq = how many minutes between recurrences.</span>
<a name="l02270"></a>02270 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02271"></a>02271 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02272"></a>02272 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02273"></a>02273 <span class="comment"> * end = end date/time (invalid to use 'count' instead).</span>
<a name="l02274"></a>02274 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02275"></a>02275 <span class="comment"> */</span>
<a name="l02276"></a>02276 <span class="keywordtype">bool</span> KAEvent::setRecurMinutely(<span class="keywordtype">int</span> freq, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDateTime& end)
<a name="l02277"></a>02277 {
<a name="l02278"></a>02278 <span class="keywordflow">return</span> setRecur(RecurrenceRule::rMinutely, freq, count, end);
<a name="l02279"></a>02279 }
<a name="l02280"></a>02280
<a name="l02281"></a>02281 <span class="comment">/******************************************************************************</span>
<a name="l02282"></a>02282 <span class="comment"> * Set the recurrence to recur daily.</span>
<a name="l02283"></a>02283 <span class="comment"> * Parameters:</span>
<a name="l02284"></a>02284 <span class="comment"> * freq = how many days between recurrences.</span>
<a name="l02285"></a>02285 <span class="comment"> * days = which days of the week alarms are allowed to occur on.</span>
<a name="l02286"></a>02286 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02287"></a>02287 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02288"></a>02288 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02289"></a>02289 <span class="comment"> * end = end date (invalid to use 'count' instead).</span>
<a name="l02290"></a>02290 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02291"></a>02291 <span class="comment"> */</span>
<a name="l02292"></a>02292 <span class="keywordtype">bool</span> KAEvent::setRecurDaily(<span class="keywordtype">int</span> freq, <span class="keyword">const</span> QBitArray& days, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDate& end)
<a name="l02293"></a>02293 {
<a name="l02294"></a>02294 <span class="keywordflow">if</span> (!setRecur(RecurrenceRule::rDaily, freq, count, end))
<a name="l02295"></a>02295 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02296"></a>02296 <span class="keywordtype">int</span> n = 0;
<a name="l02297"></a>02297 <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i < 7; ++i)
<a name="l02298"></a>02298 {
<a name="l02299"></a>02299 <span class="keywordflow">if</span> (days.testBit(i))
<a name="l02300"></a>02300 ++n;
<a name="l02301"></a>02301 }
<a name="l02302"></a>02302 <span class="keywordflow">if</span> (n < 7)
<a name="l02303"></a>02303 mRecurrence->addWeeklyDays(days);
<a name="l02304"></a>02304 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02305"></a>02305 }
<a name="l02306"></a>02306
<a name="l02307"></a>02307 <span class="comment">/******************************************************************************</span>
<a name="l02308"></a>02308 <span class="comment"> * Set the recurrence to recur weekly, on the specified weekdays.</span>
<a name="l02309"></a>02309 <span class="comment"> * Parameters:</span>
<a name="l02310"></a>02310 <span class="comment"> * freq = how many weeks between recurrences.</span>
<a name="l02311"></a>02311 <span class="comment"> * days = which days of the week alarms should occur on.</span>
<a name="l02312"></a>02312 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02313"></a>02313 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02314"></a>02314 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02315"></a>02315 <span class="comment"> * end = end date (invalid to use 'count' instead).</span>
<a name="l02316"></a>02316 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02317"></a>02317 <span class="comment"> */</span>
<a name="l02318"></a>02318 <span class="keywordtype">bool</span> KAEvent::setRecurWeekly(<span class="keywordtype">int</span> freq, <span class="keyword">const</span> QBitArray& days, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDate& end)
<a name="l02319"></a>02319 {
<a name="l02320"></a>02320 <span class="keywordflow">if</span> (!setRecur(RecurrenceRule::rWeekly, freq, count, end))
<a name="l02321"></a>02321 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02322"></a>02322 mRecurrence->addWeeklyDays(days);
<a name="l02323"></a>02323 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02324"></a>02324 }
<a name="l02325"></a>02325
<a name="l02326"></a>02326 <span class="comment">/******************************************************************************</span>
<a name="l02327"></a>02327 <span class="comment"> * Set the recurrence to recur monthly, on the specified days within the month.</span>
<a name="l02328"></a>02328 <span class="comment"> * Parameters:</span>
<a name="l02329"></a>02329 <span class="comment"> * freq = how many months between recurrences.</span>
<a name="l02330"></a>02330 <span class="comment"> * days = which days of the month alarms should occur on.</span>
<a name="l02331"></a>02331 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02332"></a>02332 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02333"></a>02333 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02334"></a>02334 <span class="comment"> * end = end date (invalid to use 'count' instead).</span>
<a name="l02335"></a>02335 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02336"></a>02336 <span class="comment"> */</span>
<a name="l02337"></a>02337 <span class="keywordtype">bool</span> KAEvent::setRecurMonthlyByDate(<span class="keywordtype">int</span> freq, <span class="keyword">const</span> QValueList<int>& days, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDate& end)
<a name="l02338"></a>02338 {
<a name="l02339"></a>02339 <span class="keywordflow">if</span> (!setRecur(RecurrenceRule::rMonthly, freq, count, end))
<a name="l02340"></a>02340 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02341"></a>02341 <span class="keywordflow">for</span> (QValueListConstIterator<int> it = days.begin(); it != days.end(); ++it)
<a name="l02342"></a>02342 mRecurrence->addMonthlyDate(*it);
<a name="l02343"></a>02343 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02344"></a>02344 }
<a name="l02345"></a>02345
<a name="l02346"></a>02346 <span class="comment">/******************************************************************************</span>
<a name="l02347"></a>02347 <span class="comment"> * Set the recurrence to recur monthly, on the specified weekdays in the</span>
<a name="l02348"></a>02348 <span class="comment"> * specified weeks of the month.</span>
<a name="l02349"></a>02349 <span class="comment"> * Parameters:</span>
<a name="l02350"></a>02350 <span class="comment"> * freq = how many months between recurrences.</span>
<a name="l02351"></a>02351 <span class="comment"> * posns = which days of the week/weeks of the month alarms should occur on.</span>
<a name="l02352"></a>02352 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02353"></a>02353 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02354"></a>02354 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02355"></a>02355 <span class="comment"> * end = end date (invalid to use 'count' instead).</span>
<a name="l02356"></a>02356 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02357"></a>02357 <span class="comment"> */</span>
<a name="l02358"></a>02358 <span class="keywordtype">bool</span> KAEvent::setRecurMonthlyByPos(<span class="keywordtype">int</span> freq, <span class="keyword">const</span> QValueList<MonthPos>& posns, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDate& end)
<a name="l02359"></a>02359 {
<a name="l02360"></a>02360 <span class="keywordflow">if</span> (!setRecur(RecurrenceRule::rMonthly, freq, count, end))
<a name="l02361"></a>02361 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02362"></a>02362 <span class="keywordflow">for</span> (QValueListConstIterator<MonthPos> it = posns.begin(); it != posns.end(); ++it)
<a name="l02363"></a>02363 mRecurrence->addMonthlyPos((*it).weeknum, (*it).days);
<a name="l02364"></a>02364 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02365"></a>02365 }
<a name="l02366"></a>02366
<a name="l02367"></a>02367 <span class="comment">/******************************************************************************</span>
<a name="l02368"></a>02368 <span class="comment"> * Set the recurrence to recur annually, on the specified start date in each</span>
<a name="l02369"></a>02369 <span class="comment"> * of the specified months.</span>
<a name="l02370"></a>02370 <span class="comment"> * Parameters:</span>
<a name="l02371"></a>02371 <span class="comment"> * freq = how many years between recurrences.</span>
<a name="l02372"></a>02372 <span class="comment"> * months = which months of the year alarms should occur on.</span>
<a name="l02373"></a>02373 <span class="comment"> * day = day of month, or 0 to use start date</span>
<a name="l02374"></a>02374 <span class="comment"> * feb29 = when February 29th should recur in non-leap years.</span>
<a name="l02375"></a>02375 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02376"></a>02376 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02377"></a>02377 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02378"></a>02378 <span class="comment"> * end = end date (invalid to use 'count' instead).</span>
<a name="l02379"></a>02379 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02380"></a>02380 <span class="comment"> */</span>
<a name="l02381"></a>02381 <span class="keywordtype">bool</span> KAEvent::setRecurAnnualByDate(<span class="keywordtype">int</span> freq, <span class="keyword">const</span> QValueList<int>& months, <span class="keywordtype">int</span> day, KARecurrence::Feb29Type feb29, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDate& end)
<a name="l02382"></a>02382 {
<a name="l02383"></a>02383 <span class="keywordflow">if</span> (!setRecur(RecurrenceRule::rYearly, freq, count, end, feb29))
<a name="l02384"></a>02384 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02385"></a>02385 <span class="keywordflow">for</span> (QValueListConstIterator<int> it = months.begin(); it != months.end(); ++it)
<a name="l02386"></a>02386 mRecurrence->addYearlyMonth(*it);
<a name="l02387"></a>02387 <span class="keywordflow">if</span> (day)
<a name="l02388"></a>02388 mRecurrence->addMonthlyDate(day);
<a name="l02389"></a>02389 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02390"></a>02390 }
<a name="l02391"></a>02391
<a name="l02392"></a>02392 <span class="comment">/******************************************************************************</span>
<a name="l02393"></a>02393 <span class="comment"> * Set the recurrence to recur annually, on the specified weekdays in the</span>
<a name="l02394"></a>02394 <span class="comment"> * specified weeks of the specified months.</span>
<a name="l02395"></a>02395 <span class="comment"> * Parameters:</span>
<a name="l02396"></a>02396 <span class="comment"> * freq = how many years between recurrences.</span>
<a name="l02397"></a>02397 <span class="comment"> * posns = which days of the week/weeks of the month alarms should occur on.</span>
<a name="l02398"></a>02398 <span class="comment"> * months = which months of the year alarms should occur on.</span>
<a name="l02399"></a>02399 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02400"></a>02400 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02401"></a>02401 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02402"></a>02402 <span class="comment"> * end = end date (invalid to use 'count' instead).</span>
<a name="l02403"></a>02403 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02404"></a>02404 <span class="comment"> */</span>
<a name="l02405"></a>02405 <span class="keywordtype">bool</span> KAEvent::setRecurAnnualByPos(<span class="keywordtype">int</span> freq, <span class="keyword">const</span> QValueList<MonthPos>& posns, <span class="keyword">const</span> QValueList<int>& months, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDate& end)
<a name="l02406"></a>02406 {
<a name="l02407"></a>02407 <span class="keywordflow">if</span> (!setRecur(RecurrenceRule::rYearly, freq, count, end))
<a name="l02408"></a>02408 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02409"></a>02409 <span class="keywordflow">for</span> (QValueListConstIterator<int> it = months.begin(); it != months.end(); ++it)
<a name="l02410"></a>02410 mRecurrence->addYearlyMonth(*it);
<a name="l02411"></a>02411 <span class="keywordflow">for</span> (QValueListConstIterator<MonthPos> it = posns.begin(); it != posns.end(); ++it)
<a name="l02412"></a>02412 mRecurrence->addYearlyPos((*it).weeknum, (*it).days);
<a name="l02413"></a>02413 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02414"></a>02414 }
<a name="l02415"></a>02415
<a name="l02416"></a>02416 <span class="comment">/******************************************************************************</span>
<a name="l02417"></a>02417 <span class="comment"> * Initialise the event's recurrence data.</span>
<a name="l02418"></a>02418 <span class="comment"> * Parameters:</span>
<a name="l02419"></a>02419 <span class="comment"> * freq = how many intervals between recurrences.</span>
<a name="l02420"></a>02420 <span class="comment"> * count = number of occurrences, including first and last.</span>
<a name="l02421"></a>02421 <span class="comment"> * = -1 to recur indefinitely.</span>
<a name="l02422"></a>02422 <span class="comment"> * = 0 to use 'end' instead.</span>
<a name="l02423"></a>02423 <span class="comment"> * end = end date/time (invalid to use 'count' instead).</span>
<a name="l02424"></a>02424 <span class="comment"> * Reply = false if no recurrence was set up.</span>
<a name="l02425"></a>02425 <span class="comment"> */</span>
<a name="l02426"></a>02426 <span class="keywordtype">bool</span> KAEvent::setRecur(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1RecurrenceRule.html#d67adb9f784863d1ecdba2392a2f6bbf">RecurrenceRule::PeriodType</a> recurType, <span class="keywordtype">int</span> freq, <span class="keywordtype">int</span> count, <span class="keyword">const</span> QDateTime& end, KARecurrence::Feb29Type feb29)
<a name="l02427"></a>02427 {
<a name="l02428"></a>02428 <span class="keywordflow">if</span> (count >= -1 && (count || end.date().isValid()))
<a name="l02429"></a>02429 {
<a name="l02430"></a>02430 <span class="keywordflow">if</span> (!mRecurrence)
<a name="l02431"></a>02431 mRecurrence = <span class="keyword">new</span> KARecurrence;
<a name="l02432"></a>02432 <span class="keywordflow">if</span> (mRecurrence->init(recurType, freq, count, mNextMainDateTime, end, feb29))
<a name="l02433"></a>02433 {
<a name="l02434"></a>02434 mUpdated = <span class="keyword">true</span>;
<a name="l02435"></a>02435 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02436"></a>02436 }
<a name="l02437"></a>02437 }
<a name="l02438"></a>02438 clearRecur();
<a name="l02439"></a>02439 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02440"></a>02440 }
<a name="l02441"></a>02441
<a name="l02442"></a>02442 <span class="comment">/******************************************************************************</span>
<a name="l02443"></a>02443 <span class="comment"> * Clear the event's recurrence and alarm repetition data.</span>
<a name="l02444"></a>02444 <span class="comment"> */</span>
<a name="l02445"></a>02445 <span class="keywordtype">void</span> KAEvent::clearRecur()
<a name="l02446"></a>02446 {
<a name="l02447"></a>02447 <span class="keyword">delete</span> mRecurrence;
<a name="l02448"></a>02448 mRecurrence = 0;
<a name="l02449"></a>02449 mRepeatInterval = 0;
<a name="l02450"></a>02450 mRepeatCount = 0;
<a name="l02451"></a>02451 mNextRepeat = 0;
<a name="l02452"></a>02452 mUpdated = <span class="keyword">true</span>;
<a name="l02453"></a>02453 }
<a name="l02454"></a>02454
<a name="l02455"></a>02455 <span class="comment">/******************************************************************************</span>
<a name="l02456"></a>02456 <span class="comment">* Validate the event's recurrence data, correcting any inconsistencies (which</span>
<a name="l02457"></a>02457 <span class="comment">* should never occur!).</span>
<a name="l02458"></a>02458 <span class="comment">* Reply = true if a recurrence (as opposed to a login repetition) exists.</span>
<a name="l02459"></a>02459 <span class="comment">*/</span>
<a name="l02460"></a>02460 KARecurrence::Type KAEvent::checkRecur()<span class="keyword"> const</span>
<a name="l02461"></a>02461 <span class="keyword"></span>{
<a name="l02462"></a>02462 <span class="keywordflow">if</span> (mRecurrence)
<a name="l02463"></a>02463 {
<a name="l02464"></a>02464 KARecurrence::Type type = mRecurrence->type();
<a name="l02465"></a>02465 <span class="keywordflow">switch</span> (type)
<a name="l02466"></a>02466 {
<a name="l02467"></a>02467 <span class="keywordflow">case</span> KARecurrence::MINUTELY: <span class="comment">// hourly </span>
<a name="l02468"></a>02468 <span class="keywordflow">case</span> KARecurrence::DAILY: <span class="comment">// daily</span>
<a name="l02469"></a>02469 <span class="keywordflow">case</span> KARecurrence::WEEKLY: <span class="comment">// weekly on multiple days of week</span>
<a name="l02470"></a>02470 <span class="keywordflow">case</span> KARecurrence::MONTHLY_DAY: <span class="comment">// monthly on multiple dates in month</span>
<a name="l02471"></a>02471 <span class="keywordflow">case</span> KARecurrence::MONTHLY_POS: <span class="comment">// monthly on multiple nth day of week</span>
<a name="l02472"></a>02472 <span class="keywordflow">case</span> KARecurrence::ANNUAL_DATE: <span class="comment">// annually on multiple months (day of month = start date)</span>
<a name="l02473"></a>02473 <span class="keywordflow">case</span> KARecurrence::ANNUAL_POS: <span class="comment">// annually on multiple nth day of week in multiple months</span>
<a name="l02474"></a>02474 <span class="keywordflow">return</span> type;
<a name="l02475"></a>02475 <span class="keywordflow">default</span>:
<a name="l02476"></a>02476 <span class="keywordflow">if</span> (mRecurrence)
<a name="l02477"></a>02477 <span class="keyword">const_cast<</span><a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>*<span class="keyword">></span>(<span class="keyword">this</span>)->clearRecur(); <span class="comment">// recurrence shouldn't exist!!</span>
<a name="l02478"></a>02478 <span class="keywordflow">break</span>;
<a name="l02479"></a>02479 }
<a name="l02480"></a>02480 }
<a name="l02481"></a>02481 <span class="keywordflow">return</span> KARecurrence::NO_RECUR;
<a name="l02482"></a>02482 }
<a name="l02483"></a>02483
<a name="l02484"></a>02484
<a name="l02485"></a>02485 <span class="comment">/******************************************************************************</span>
<a name="l02486"></a>02486 <span class="comment"> * Return the recurrence interval in units of the recurrence period type.</span>
<a name="l02487"></a>02487 <span class="comment"> */</span>
<a name="l02488"></a>02488 <span class="keywordtype">int</span> KAEvent::recurInterval()<span class="keyword"> const</span>
<a name="l02489"></a>02489 <span class="keyword"></span>{
<a name="l02490"></a>02490 <span class="keywordflow">if</span> (mRecurrence)
<a name="l02491"></a>02491 {
<a name="l02492"></a>02492 <span class="keywordflow">switch</span> (mRecurrence->type())
<a name="l02493"></a>02493 {
<a name="l02494"></a>02494 <span class="keywordflow">case</span> KARecurrence::MINUTELY:
<a name="l02495"></a>02495 <span class="keywordflow">case</span> KARecurrence::DAILY:
<a name="l02496"></a>02496 <span class="keywordflow">case</span> KARecurrence::WEEKLY:
<a name="l02497"></a>02497 <span class="keywordflow">case</span> KARecurrence::MONTHLY_DAY:
<a name="l02498"></a>02498 <span class="keywordflow">case</span> KARecurrence::MONTHLY_POS:
<a name="l02499"></a>02499 <span class="keywordflow">case</span> KARecurrence::ANNUAL_DATE:
<a name="l02500"></a>02500 <span class="keywordflow">case</span> KARecurrence::ANNUAL_POS:
<a name="l02501"></a>02501 <span class="keywordflow">return</span> mRecurrence->frequency();
<a name="l02502"></a>02502 <span class="keywordflow">default</span>:
<a name="l02503"></a>02503 <span class="keywordflow">break</span>;
<a name="l02504"></a>02504 }
<a name="l02505"></a>02505 }
<a name="l02506"></a>02506 <span class="keywordflow">return</span> 0;
<a name="l02507"></a>02507 }
<a name="l02508"></a>02508
<a name="l02509"></a>02509 <span class="comment">/******************************************************************************</span>
<a name="l02510"></a>02510 <span class="comment">* Validate the event's alarm sub-repetition data, correcting any</span>
<a name="l02511"></a>02511 <span class="comment">* inconsistencies (which should never occur!).</span>
<a name="l02512"></a>02512 <span class="comment">*/</span>
<a name="l02513"></a>02513 <span class="keywordtype">void</span> KAEvent::checkRepetition()<span class="keyword"> const</span>
<a name="l02514"></a>02514 <span class="keyword"></span>{
<a name="l02515"></a>02515 <span class="keywordflow">if</span> (mRepeatCount && !mRepeatInterval)
<a name="l02516"></a>02516 <span class="keyword">const_cast<</span><a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>*<span class="keyword">></span>(<span class="keyword">this</span>)->mRepeatCount = 0;
<a name="l02517"></a>02517 <span class="keywordflow">if</span> (!mRepeatCount && mRepeatInterval)
<a name="l02518"></a>02518 <span class="keyword">const_cast<</span><a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>*<span class="keyword">></span>(<span class="keyword">this</span>)->mRepeatInterval = 0;
<a name="l02519"></a>02519 }
<a name="l02520"></a>02520
<a name="l02521"></a>02521 <span class="preprocessor">#if 0</span>
<a name="l02522"></a>02522 <span class="preprocessor"></span><span class="comment">/******************************************************************************</span>
<a name="l02523"></a>02523 <span class="comment"> * Convert a QValueList<WDayPos> to QValueList<MonthPos>.</span>
<a name="l02524"></a>02524 <span class="comment"> */</span>
<a name="l02525"></a>02525 QValueList<KAEvent::MonthPos> KAEvent::convRecurPos(<span class="keyword">const</span> QValueList<KCal::RecurrenceRule::WDayPos>& wdaypos)
<a name="l02526"></a>02526 {
<a name="l02527"></a>02527 QValueList<MonthPos> mposns;
<a name="l02528"></a>02528 <span class="keywordflow">for</span> (QValueList<KCal::RecurrenceRule::WDayPos>::ConstIterator it = wdaypos.begin(); it != wdaypos.end(); ++it)
<a name="l02529"></a>02529 {
<a name="l02530"></a>02530 <span class="keywordtype">int</span> daybit = (*it).day() - 1;
<a name="l02531"></a>02531 <span class="keywordtype">int</span> weeknum = (*it).pos();
<a name="l02532"></a>02532 <span class="keywordtype">bool</span> found = <span class="keyword">false</span>;
<a name="l02533"></a>02533 <span class="keywordflow">for</span> (QValueList<MonthPos>::Iterator mit = mposns.begin(); mit != mposns.end(); ++mit)
<a name="l02534"></a>02534 {
<a name="l02535"></a>02535 <span class="keywordflow">if</span> ((*mit).weeknum == weeknum)
<a name="l02536"></a>02536 {
<a name="l02537"></a>02537 (*mit).days.setBit(daybit);
<a name="l02538"></a>02538 found = <span class="keyword">true</span>;
<a name="l02539"></a>02539 <span class="keywordflow">break</span>;
<a name="l02540"></a>02540 }
<a name="l02541"></a>02541 }
<a name="l02542"></a>02542 <span class="keywordflow">if</span> (!found)
<a name="l02543"></a>02543 {
<a name="l02544"></a>02544 MonthPos mpos;
<a name="l02545"></a>02545 mpos.days.fill(<span class="keyword">false</span>);
<a name="l02546"></a>02546 mpos.days.setBit(daybit);
<a name="l02547"></a>02547 mpos.weeknum = weeknum;
<a name="l02548"></a>02548 mposns.append(mpos);
<a name="l02549"></a>02549 }
<a name="l02550"></a>02550 }
<a name="l02551"></a>02551 <span class="keywordflow">return</span> mposns;
<a name="l02552"></a>02552 }
<a name="l02553"></a>02553 <span class="preprocessor">#endif</span>
<a name="l02554"></a>02554 <span class="preprocessor"></span>
<a name="l02555"></a>02555 <span class="comment">/******************************************************************************</span>
<a name="l02556"></a>02556 <span class="comment"> * Find the alarm template with the specified name.</span>
<a name="l02557"></a>02557 <span class="comment"> * Reply = invalid event if not found.</span>
<a name="l02558"></a>02558 <span class="comment"> */</span>
<a name="l02559"></a>02559 <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> KAEvent::findTemplateName(<a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>& calendar, <span class="keyword">const</span> QString& name)
<a name="l02560"></a>02560 {
<a name="l02561"></a>02561 <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event;
<a name="l02562"></a>02562 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Event::List</a> events = calendar.<a class="code" href="classAlarmCalendar.html#37b71fc12e2394339156aabbb802946c">events</a>();
<a name="l02563"></a>02563 <span class="keywordflow">for</span> (Event::List::ConstIterator evit = events.begin(); evit != events.end(); ++evit)
<a name="l02564"></a>02564 {
<a name="l02565"></a>02565 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* ev = *evit;
<a name="l02566"></a>02566 <span class="keywordflow">if</span> (ev-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Incidence.html#5f6e41afa4e1b167c4b49e603506b34c">summary</a>() == name)
<a name="l02567"></a>02567 {
<a name="l02568"></a>02568 <span class="keyword">event</span>.set(*ev);
<a name="l02569"></a>02569 <span class="keywordflow">if</span> (!event.<a class="code" href="classKAEvent.html#42ead0c9c3fa7e7c6858ac0c40b08a2e">isTemplate</a>())
<a name="l02570"></a>02570 <span class="keywordflow">return</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>(); <span class="comment">// this shouldn't ever happen</span>
<a name="l02571"></a>02571 <span class="keywordflow">break</span>;
<a name="l02572"></a>02572 }
<a name="l02573"></a>02573 }
<a name="l02574"></a>02574 <span class="keywordflow">return</span> event;
<a name="l02575"></a>02575 }
<a name="l02576"></a>02576
<a name="l02577"></a>02577 <span class="comment">/******************************************************************************</span>
<a name="l02578"></a>02578 <span class="comment"> * Adjust the time at which date-only events will occur for each of the events</span>
<a name="l02579"></a>02579 <span class="comment"> * in a list. Events for which both date and time are specified are left</span>
<a name="l02580"></a>02580 <span class="comment"> * unchanged.</span>
<a name="l02581"></a>02581 <span class="comment"> * Reply = true if any events have been updated.</span>
<a name="l02582"></a>02582 <span class="comment"> */</span>
<a name="l02583"></a>02583 <span class="keywordtype">bool</span> KAEvent::adjustStartOfDay(<span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Event::List</a>& events)
<a name="l02584"></a>02584 {
<a name="l02585"></a>02585 <span class="keywordtype">bool</span> changed = <span class="keyword">false</span>;
<a name="l02586"></a>02586 QTime startOfDay = Preferences::startOfDay();
<a name="l02587"></a>02587 <span class="keywordflow">for</span> (Event::List::ConstIterator evit = events.begin(); evit != events.end(); ++evit)
<a name="l02588"></a>02588 {
<a name="l02589"></a>02589 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* <span class="keyword">event</span> = *evit;
<a name="l02590"></a>02590 <span class="keyword">const</span> QStringList cats = <span class="keyword">event</span>->categories();
<a name="l02591"></a>02591 <span class="keywordflow">if</span> (cats.find(DATE_ONLY_CATEGORY) != cats.end())
<a name="l02592"></a>02592 {
<a name="l02593"></a>02593 <span class="comment">// It's an untimed event, so fix it</span>
<a name="l02594"></a>02594 QTime oldTime = <span class="keyword">event</span>->dtStart().time();
<a name="l02595"></a>02595 <span class="keywordtype">int</span> adjustment = oldTime.secsTo(startOfDay);
<a name="l02596"></a>02596 <span class="keywordflow">if</span> (adjustment)
<a name="l02597"></a>02597 {
<a name="l02598"></a>02598 <span class="keyword">event</span>->setDtStart(QDateTime(event->dtStart().date(), startOfDay));
<a name="l02599"></a>02599 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Alarm::List</a> alarms = <span class="keyword">event</span>->alarms();
<a name="l02600"></a>02600 <span class="keywordtype">int</span> deferralOffset = 0;
<a name="l02601"></a>02601 <span class="keywordflow">for</span> (Alarm::List::ConstIterator alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l02602"></a>02602 {
<a name="l02603"></a>02603 <span class="comment">// Parse the next alarm's text</span>
<a name="l02604"></a>02604 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>& alarm = **alit;
<a name="l02605"></a>02605 AlarmData data;
<a name="l02606"></a>02606 readAlarm(alarm, data);
<a name="l02607"></a>02607 <span class="keywordflow">if</span> (data.type & KAAlarm::TIMED_DEFERRAL_FLAG)
<a name="l02608"></a>02608 {
<a name="l02609"></a>02609 <span class="comment">// Timed deferral alarm, so adjust the offset</span>
<a name="l02610"></a>02610 deferralOffset = alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#3fdf5078feefc485a6d86d2f9c3e8d6a">startOffset</a>().<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#34b69f5167fc798461a45971619227f6">asSeconds</a>();
<a name="l02611"></a>02611 alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(deferralOffset - adjustment);
<a name="l02612"></a>02612 }
<a name="l02613"></a>02613 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (data.type == KAAlarm::AUDIO__ALARM
<a name="l02614"></a>02614 && alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#3fdf5078feefc485a6d86d2f9c3e8d6a">startOffset</a>().<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#34b69f5167fc798461a45971619227f6">asSeconds</a>() == deferralOffset)
<a name="l02615"></a>02615 {
<a name="l02616"></a>02616 <span class="comment">// Audio alarm is set for the same time as the deferral alarm</span>
<a name="l02617"></a>02617 alarm.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(deferralOffset - adjustment);
<a name="l02618"></a>02618 }
<a name="l02619"></a>02619 }
<a name="l02620"></a>02620 changed = <span class="keyword">true</span>;
<a name="l02621"></a>02621 }
<a name="l02622"></a>02622 }
<a name="l02623"></a>02623 <span class="keywordflow">else</span>
<a name="l02624"></a>02624 {
<a name="l02625"></a>02625 <span class="comment">// It's a timed event. Fix any untimed alarms.</span>
<a name="l02626"></a>02626 <span class="keywordtype">int</span> deferralOffset = 0;
<a name="l02627"></a>02627 <span class="keywordtype">int</span> newDeferralOffset = 0;
<a name="l02628"></a>02628 DateTime start;
<a name="l02629"></a>02629 QDateTime nextMainDateTime = readDateTime(*event, <span class="keyword">false</span>, start).rawDateTime();
<a name="l02630"></a>02630 AlarmMap alarmMap;
<a name="l02631"></a>02631 readAlarms(*event, &alarmMap);
<a name="l02632"></a>02632 <span class="keywordflow">for</span> (AlarmMap::Iterator it = alarmMap.begin(); it != alarmMap.end(); ++it)
<a name="l02633"></a>02633 {
<a name="l02634"></a>02634 <span class="keyword">const</span> AlarmData& data = it.data();
<a name="l02635"></a>02635 <span class="keywordflow">if</span> (!data.alarm->hasStartOffset())
<a name="l02636"></a>02636 <span class="keywordflow">continue</span>;
<a name="l02637"></a>02637 <span class="keywordflow">if</span> ((data.type & KAAlarm::DEFERRED_ALARM)
<a name="l02638"></a>02638 && !(data.type & KAAlarm::TIMED_DEFERRAL_FLAG))
<a name="l02639"></a>02639 {
<a name="l02640"></a>02640 <span class="comment">// Date-only deferral alarm, so adjust its time</span>
<a name="l02641"></a>02641 QDateTime altime = nextMainDateTime.addSecs(data.alarm->startOffset().asSeconds());
<a name="l02642"></a>02642 altime.setTime(startOfDay);
<a name="l02643"></a>02643 deferralOffset = data.alarm->startOffset().asSeconds();
<a name="l02644"></a>02644 newDeferralOffset = <span class="keyword">event</span>->dtStart().secsTo(altime);
<a name="l02645"></a>02645 <span class="keyword">const_cast<</span><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>*<span class="keyword">></span>(data.alarm)->setStartOffset(newDeferralOffset);
<a name="l02646"></a>02646 changed = <span class="keyword">true</span>;
<a name="l02647"></a>02647 }
<a name="l02648"></a>02648 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (data.type == KAAlarm::AUDIO__ALARM
<a name="l02649"></a>02649 && data.alarm->startOffset().asSeconds() == deferralOffset)
<a name="l02650"></a>02650 {
<a name="l02651"></a>02651 <span class="comment">// Audio alarm is set for the same time as the deferral alarm</span>
<a name="l02652"></a>02652 <span class="keyword">const_cast<</span><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>*<span class="keyword">></span>(data.alarm)->setStartOffset(newDeferralOffset);
<a name="l02653"></a>02653 changed = <span class="keyword">true</span>;
<a name="l02654"></a>02654 }
<a name="l02655"></a>02655 }
<a name="l02656"></a>02656 }
<a name="l02657"></a>02657 }
<a name="l02658"></a>02658 <span class="keywordflow">return</span> changed;
<a name="l02659"></a>02659 }
<a name="l02660"></a>02660
<a name="l02661"></a>02661 <span class="comment">/******************************************************************************</span>
<a name="l02662"></a>02662 <span class="comment"> * If the calendar was written by a previous version of KAlarm, do any</span>
<a name="l02663"></a>02663 <span class="comment"> * necessary format conversions on the events to ensure that when the calendar</span>
<a name="l02664"></a>02664 <span class="comment"> * is saved, no information is lost or corrupted.</span>
<a name="l02665"></a>02665 <span class="comment"> */</span>
<a name="l02666"></a>02666 <span class="keywordtype">void</span> KAEvent::convertKCalEvents(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Calendar.html">KCal::Calendar</a>& calendar, <span class="keywordtype">int</span> version, <span class="keywordtype">bool</span> adjustSummerTime)
<a name="l02667"></a>02667 {
<a name="l02668"></a>02668 <span class="comment">// KAlarm pre-0.9 codes held in the alarm's DESCRIPTION property</span>
<a name="l02669"></a>02669 <span class="keyword">static</span> <span class="keyword">const</span> QChar SEPARATOR = <span class="charliteral">';'</span>;
<a name="l02670"></a>02670 <span class="keyword">static</span> <span class="keyword">const</span> QChar LATE_CANCEL_CODE = <span class="charliteral">'C'</span>;
<a name="l02671"></a>02671 <span class="keyword">static</span> <span class="keyword">const</span> QChar AT_LOGIN_CODE = <span class="charliteral">'L'</span>; <span class="comment">// subsidiary alarm at every login</span>
<a name="l02672"></a>02672 <span class="keyword">static</span> <span class="keyword">const</span> QChar DEFERRAL_CODE = <span class="charliteral">'D'</span>; <span class="comment">// extra deferred alarm</span>
<a name="l02673"></a>02673 <span class="keyword">static</span> <span class="keyword">const</span> QString TEXT_PREFIX = QString::fromLatin1(<span class="stringliteral">"TEXT:"</span>);
<a name="l02674"></a>02674 <span class="keyword">static</span> <span class="keyword">const</span> QString FILE_PREFIX = QString::fromLatin1(<span class="stringliteral">"FILE:"</span>);
<a name="l02675"></a>02675 <span class="keyword">static</span> <span class="keyword">const</span> QString COMMAND_PREFIX = QString::fromLatin1(<span class="stringliteral">"CMD:"</span>);
<a name="l02676"></a>02676
<a name="l02677"></a>02677 <span class="comment">// KAlarm pre-0.9.2 codes held in the event's CATEGORY property</span>
<a name="l02678"></a>02678 <span class="keyword">static</span> <span class="keyword">const</span> QString BEEP_CATEGORY = QString::fromLatin1(<span class="stringliteral">"BEEP"</span>);
<a name="l02679"></a>02679
<a name="l02680"></a>02680 <span class="comment">// KAlarm pre-1.1.1 LATECANCEL category with no parameter</span>
<a name="l02681"></a>02681 <span class="keyword">static</span> <span class="keyword">const</span> QString LATE_CANCEL_CAT = QString::fromLatin1(<span class="stringliteral">"LATECANCEL"</span>);
<a name="l02682"></a>02682
<a name="l02683"></a>02683 <span class="comment">// KAlarm pre-1.3.0 TMPLDEFTIME category with no parameter</span>
<a name="l02684"></a>02684 <span class="keyword">static</span> <span class="keyword">const</span> QString TEMPL_DEF_TIME_CAT = QString::fromLatin1(<span class="stringliteral">"TMPLDEFTIME"</span>);
<a name="l02685"></a>02685
<a name="l02686"></a>02686 <span class="comment">// KAlarm pre-1.3.1 XTERM category</span>
<a name="l02687"></a>02687 <span class="keyword">static</span> <span class="keyword">const</span> QString EXEC_IN_XTERM_CAT = QString::fromLatin1(<span class="stringliteral">"XTERM"</span>);
<a name="l02688"></a>02688
<a name="l02689"></a>02689 <span class="comment">// KAlarm pre-1.4.22 properties</span>
<a name="l02690"></a>02690 <span class="keyword">static</span> <span class="keyword">const</span> QCString KMAIL_ID_PROPERTY(<span class="stringliteral">"KMAILID"</span>); <span class="comment">// X-KDE-KALARM-KMAILID property</span>
<a name="l02691"></a>02691
<a name="l02692"></a>02692 <span class="keywordflow">if</span> (version >= calVersion())
<a name="l02693"></a>02693 <span class="keywordflow">return</span>;
<a name="l02694"></a>02694
<a name="l02695"></a>02695 kdDebug(5950) << <span class="stringliteral">"KAEvent::convertKCalEvents(): adjusting version "</span> << version << endl;
<a name="l02696"></a>02696 <span class="keywordtype">bool</span> pre_0_7 = (version < KAlarm::Version(0,7,0));
<a name="l02697"></a>02697 <span class="keywordtype">bool</span> pre_0_9 = (version < KAlarm::Version(0,9,0));
<a name="l02698"></a>02698 <span class="keywordtype">bool</span> pre_0_9_2 = (version < KAlarm::Version(0,9,2));
<a name="l02699"></a>02699 <span class="keywordtype">bool</span> pre_1_1_1 = (version < KAlarm::Version(1,1,1));
<a name="l02700"></a>02700 <span class="keywordtype">bool</span> pre_1_2_1 = (version < KAlarm::Version(1,2,1));
<a name="l02701"></a>02701 <span class="keywordtype">bool</span> pre_1_3_0 = (version < KAlarm::Version(1,3,0));
<a name="l02702"></a>02702 <span class="keywordtype">bool</span> pre_1_3_1 = (version < KAlarm::Version(1,3,1));
<a name="l02703"></a>02703 <span class="keywordtype">bool</span> pre_1_4_14 = (version < KAlarm::Version(1,4,14));
<a name="l02704"></a>02704 <span class="keywordtype">bool</span> pre_1_5_0 = (version < KAlarm::Version(1,5,0));
<a name="l02705"></a>02705 Q_ASSERT(calVersion() == KAlarm::Version(1,5,0));
<a name="l02706"></a>02706
<a name="l02707"></a>02707 QDateTime dt0(QDate(1970,1,1), QTime(0,0,0));
<a name="l02708"></a>02708 QTime startOfDay = Preferences::startOfDay();
<a name="l02709"></a>02709
<a name="l02710"></a>02710 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Event::List</a> events = calendar.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Calendar.html#a03685d1878387b4b39769a7b967a232">rawEvents</a>();
<a name="l02711"></a>02711 <span class="keywordflow">for</span> (Event::List::ConstIterator evit = events.begin(); evit != events.end(); ++evit)
<a name="l02712"></a>02712 {
<a name="l02713"></a>02713 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* <span class="keyword">event</span> = *evit;
<a name="l02714"></a>02714 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Alarm::List</a> alarms = <span class="keyword">event</span>->alarms();
<a name="l02715"></a>02715 <span class="keywordflow">if</span> (alarms.isEmpty())
<a name="l02716"></a>02716 <span class="keywordflow">continue</span>; <span class="comment">// KAlarm isn't interested in events without alarms</span>
<a name="l02717"></a>02717 QStringList cats = <span class="keyword">event</span>->categories();
<a name="l02718"></a>02718 <span class="keywordtype">bool</span> addLateCancel = <span class="keyword">false</span>;
<a name="l02719"></a>02719
<a name="l02720"></a>02720 <span class="keywordflow">if</span> (pre_0_7 && event->doesFloat())
<a name="l02721"></a>02721 {
<a name="l02722"></a>02722 <span class="comment">// It's a KAlarm pre-0.7 calendar file.</span>
<a name="l02723"></a>02723 <span class="comment">// Ensure that when the calendar is saved, the alarm time isn't lost.</span>
<a name="l02724"></a>02724 <span class="keyword">event</span>->setFloats(<span class="keyword">false</span>);
<a name="l02725"></a>02725 }
<a name="l02726"></a>02726
<a name="l02727"></a>02727 <span class="keywordflow">if</span> (pre_0_9)
<a name="l02728"></a>02728 {
<a name="l02729"></a>02729 <span class="comment">/*</span>
<a name="l02730"></a>02730 <span class="comment"> * It's a KAlarm pre-0.9 calendar file.</span>
<a name="l02731"></a>02731 <span class="comment"> * All alarms were of type DISPLAY. Instead of the X-KDE-KALARM-TYPE</span>
<a name="l02732"></a>02732 <span class="comment"> * alarm property, characteristics were stored as a prefix to the</span>
<a name="l02733"></a>02733 <span class="comment"> * alarm DESCRIPTION property, as follows:</span>
<a name="l02734"></a>02734 <span class="comment"> * SEQNO;[FLAGS];TYPE:TEXT</span>
<a name="l02735"></a>02735 <span class="comment"> * where</span>
<a name="l02736"></a>02736 <span class="comment"> * SEQNO = sequence number of alarm within the event</span>
<a name="l02737"></a>02737 <span class="comment"> * FLAGS = C for late-cancel, L for repeat-at-login, D for deferral</span>
<a name="l02738"></a>02738 <span class="comment"> * TYPE = TEXT or FILE or CMD</span>
<a name="l02739"></a>02739 <span class="comment"> * TEXT = message text, file name/URL or command</span>
<a name="l02740"></a>02740 <span class="comment"> */</span>
<a name="l02741"></a>02741 <span class="keywordflow">for</span> (Alarm::List::ConstIterator alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l02742"></a>02742 {
<a name="l02743"></a>02743 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l02744"></a>02744 <span class="keywordtype">bool</span> atLogin = <span class="keyword">false</span>;
<a name="l02745"></a>02745 <span class="keywordtype">bool</span> deferral = <span class="keyword">false</span>;
<a name="l02746"></a>02746 <span class="keywordtype">bool</span> lateCancel = <span class="keyword">false</span>;
<a name="l02747"></a>02747 KAAlarmEventBase::Type action = T_MESSAGE;
<a name="l02748"></a>02748 QString txt = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079">text</a>();
<a name="l02749"></a>02749 <span class="keywordtype">int</span> length = txt.length();
<a name="l02750"></a>02750 <span class="keywordtype">int</span> i = 0;
<a name="l02751"></a>02751 <span class="keywordflow">if</span> (txt[0].isDigit())
<a name="l02752"></a>02752 {
<a name="l02753"></a>02753 <span class="keywordflow">while</span> (++i < length && txt[i].isDigit()) ;
<a name="l02754"></a>02754 <span class="keywordflow">if</span> (i < length && txt[i++] == SEPARATOR)
<a name="l02755"></a>02755 {
<a name="l02756"></a>02756 <span class="keywordflow">while</span> (i < length)
<a name="l02757"></a>02757 {
<a name="l02758"></a>02758 QChar ch = txt[i++];
<a name="l02759"></a>02759 <span class="keywordflow">if</span> (ch == SEPARATOR)
<a name="l02760"></a>02760 <span class="keywordflow">break</span>;
<a name="l02761"></a>02761 <span class="keywordflow">if</span> (ch == LATE_CANCEL_CODE)
<a name="l02762"></a>02762 lateCancel = <span class="keyword">true</span>;
<a name="l02763"></a>02763 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (ch == AT_LOGIN_CODE)
<a name="l02764"></a>02764 atLogin = <span class="keyword">true</span>;
<a name="l02765"></a>02765 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (ch == DEFERRAL_CODE)
<a name="l02766"></a>02766 deferral = <span class="keyword">true</span>;
<a name="l02767"></a>02767 }
<a name="l02768"></a>02768 }
<a name="l02769"></a>02769 <span class="keywordflow">else</span>
<a name="l02770"></a>02770 i = 0; <span class="comment">// invalid prefix</span>
<a name="l02771"></a>02771 }
<a name="l02772"></a>02772 <span class="keywordflow">if</span> (txt.find(TEXT_PREFIX, i) == i)
<a name="l02773"></a>02773 i += TEXT_PREFIX.length();
<a name="l02774"></a>02774 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (txt.find(FILE_PREFIX, i) == i)
<a name="l02775"></a>02775 {
<a name="l02776"></a>02776 action = T_FILE;
<a name="l02777"></a>02777 i += FILE_PREFIX.length();
<a name="l02778"></a>02778 }
<a name="l02779"></a>02779 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (txt.find(COMMAND_PREFIX, i) == i)
<a name="l02780"></a>02780 {
<a name="l02781"></a>02781 action = T_COMMAND;
<a name="l02782"></a>02782 i += COMMAND_PREFIX.length();
<a name="l02783"></a>02783 }
<a name="l02784"></a>02784 <span class="keywordflow">else</span>
<a name="l02785"></a>02785 i = 0;
<a name="l02786"></a>02786 txt = txt.mid(i);
<a name="l02787"></a>02787
<a name="l02788"></a>02788 QStringList types;
<a name="l02789"></a>02789 <span class="keywordflow">switch</span> (action)
<a name="l02790"></a>02790 {
<a name="l02791"></a>02791 <span class="keywordflow">case</span> T_FILE:
<a name="l02792"></a>02792 types += FILE_TYPE;
<a name="l02793"></a>02793 <span class="comment">// fall through to T_MESSAGE</span>
<a name="l02794"></a>02794 <span class="keywordflow">case</span> T_MESSAGE:
<a name="l02795"></a>02795 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#b5b69003ad8ad9450b8f4f542c234a8d">setDisplayAlarm</a>(txt);
<a name="l02796"></a>02796 <span class="keywordflow">break</span>;
<a name="l02797"></a>02797 <span class="keywordflow">case</span> T_COMMAND:
<a name="l02798"></a>02798 setProcedureAlarm(alarm, txt);
<a name="l02799"></a>02799 <span class="keywordflow">break</span>;
<a name="l02800"></a>02800 <span class="keywordflow">case</span> T_EMAIL: <span class="comment">// email alarms were introduced in KAlarm 0.9</span>
<a name="l02801"></a>02801 <span class="keywordflow">case</span> T_AUDIO: <span class="comment">// never occurs in this context</span>
<a name="l02802"></a>02802 <span class="keywordflow">break</span>;
<a name="l02803"></a>02803 }
<a name="l02804"></a>02804 <span class="keywordflow">if</span> (atLogin)
<a name="l02805"></a>02805 {
<a name="l02806"></a>02806 types += AT_LOGIN_TYPE;
<a name="l02807"></a>02807 lateCancel = <span class="keyword">false</span>;
<a name="l02808"></a>02808 }
<a name="l02809"></a>02809 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (deferral)
<a name="l02810"></a>02810 types += TIME_DEFERRAL_TYPE;
<a name="l02811"></a>02811 <span class="keywordflow">if</span> (lateCancel)
<a name="l02812"></a>02812 addLateCancel = <span class="keyword">true</span>;
<a name="l02813"></a>02813 <span class="keywordflow">if</span> (types.count() > 0)
<a name="l02814"></a>02814 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, TYPE_PROPERTY, types.join(<span class="stringliteral">","</span>));
<a name="l02815"></a>02815
<a name="l02816"></a>02816 <span class="keywordflow">if</span> (pre_0_7 && alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7">repeatCount</a>() > 0 && alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>() > 0)
<a name="l02817"></a>02817 {
<a name="l02818"></a>02818 <span class="comment">// It's a KAlarm pre-0.7 calendar file.</span>
<a name="l02819"></a>02819 <span class="comment">// Minutely recurrences were stored differently.</span>
<a name="l02820"></a>02820 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html">Recurrence</a>* recur = <span class="keyword">event</span>->recurrence();
<a name="l02821"></a>02821 <span class="keywordflow">if</span> (recur && recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#0cd99b7d609400ec9e5cf7439bec132a">doesRecur</a>())
<a name="l02822"></a>02822 {
<a name="l02823"></a>02823 recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#42e99f4c3fc3238d8b7a0efcce588a4c">setMinutely</a>(alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>());
<a name="l02824"></a>02824 recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#f2d673a2430023d57e8f940cbbcd186a">setDuration</a>(alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7">repeatCount</a>() + 1);
<a name="l02825"></a>02825 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#25af13606c653d0009e5559bdad78ff3">setRepeatCount</a>(0);
<a name="l02826"></a>02826 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#5b32099b4b802027e4b75767f48f73df">setSnoozeTime</a>(0);
<a name="l02827"></a>02827 }
<a name="l02828"></a>02828 }
<a name="l02829"></a>02829
<a name="l02830"></a>02830 <span class="keywordflow">if</span> (adjustSummerTime)
<a name="l02831"></a>02831 {
<a name="l02832"></a>02832 <span class="comment">// The calendar file was written by the KDE 3.0.0 version of KAlarm 0.5.7.</span>
<a name="l02833"></a>02833 <span class="comment">// Summer time was ignored when converting to UTC.</span>
<a name="l02834"></a>02834 QDateTime dt = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb">time</a>();
<a name="l02835"></a>02835 time_t t = dt0.secsTo(dt);
<a name="l02836"></a>02836 <span class="keyword">struct </span>tm* dtm = localtime(&t);
<a name="l02837"></a>02837 <span class="keywordflow">if</span> (dtm->tm_isdst)
<a name="l02838"></a>02838 {
<a name="l02839"></a>02839 dt = dt.addSecs(-3600);
<a name="l02840"></a>02840 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#148abaa601477be008ce0ac348336084">setTime</a>(dt);
<a name="l02841"></a>02841 }
<a name="l02842"></a>02842 }
<a name="l02843"></a>02843 }
<a name="l02844"></a>02844 }
<a name="l02845"></a>02845
<a name="l02846"></a>02846 <span class="keywordflow">if</span> (pre_0_9_2)
<a name="l02847"></a>02847 {
<a name="l02848"></a>02848 <span class="comment">/*</span>
<a name="l02849"></a>02849 <span class="comment"> * It's a KAlarm pre-0.9.2 calendar file.</span>
<a name="l02850"></a>02850 <span class="comment"> * For the expired calendar, set the CREATED time to the DTEND value.</span>
<a name="l02851"></a>02851 <span class="comment"> * Convert date-only DTSTART to date/time, and add category "DATE".</span>
<a name="l02852"></a>02852 <span class="comment"> * Set the DTEND time to the DTSTART time.</span>
<a name="l02853"></a>02853 <span class="comment"> * Convert all alarm times to DTSTART offsets.</span>
<a name="l02854"></a>02854 <span class="comment"> * For display alarms, convert the first unlabelled category to an</span>
<a name="l02855"></a>02855 <span class="comment"> * X-KDE-KALARM-FONTCOLOUR property.</span>
<a name="l02856"></a>02856 <span class="comment"> * Convert BEEP category into an audio alarm with no audio file.</span>
<a name="l02857"></a>02857 <span class="comment"> */</span>
<a name="l02858"></a>02858 <span class="keywordflow">if</span> (uidStatus(event-><a class="code" href="classKAEvent.html#eb547b493c7a98b8ede380fe6c7a7824">uid</a>()) == EXPIRED)
<a name="l02859"></a>02859 <span class="keyword">event</span>->setCreated(event->dtEnd());
<a name="l02860"></a>02860 QDateTime start = <span class="keyword">event</span>->dtStart();
<a name="l02861"></a>02861 <span class="keywordflow">if</span> (event->doesFloat())
<a name="l02862"></a>02862 {
<a name="l02863"></a>02863 <span class="keyword">event</span>->setFloats(<span class="keyword">false</span>);
<a name="l02864"></a>02864 start.setTime(startOfDay);
<a name="l02865"></a>02865 cats.append(DATE_ONLY_CATEGORY);
<a name="l02866"></a>02866 }
<a name="l02867"></a>02867 <span class="keyword">event</span>->setHasEndDate(<span class="keyword">false</span>);
<a name="l02868"></a>02868
<a name="l02869"></a>02869 Alarm::List::ConstIterator alit;
<a name="l02870"></a>02870 <span class="keywordflow">for</span> (alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l02871"></a>02871 {
<a name="l02872"></a>02872 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l02873"></a>02873 QDateTime dt = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb">time</a>();
<a name="l02874"></a>02874 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(start.secsTo(dt));
<a name="l02875"></a>02875 }
<a name="l02876"></a>02876
<a name="l02877"></a>02877 <span class="keywordflow">if</span> (cats.count() > 0)
<a name="l02878"></a>02878 {
<a name="l02879"></a>02879 <span class="keywordflow">for</span> (alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l02880"></a>02880 {
<a name="l02881"></a>02881 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l02882"></a>02882 <span class="keywordflow">if</span> (alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#9cec3c8d0c2047ccb8334a54175ca7c7">type</a>() == Alarm::Display)
<a name="l02883"></a>02883 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, FONT_COLOUR_PROPERTY,
<a name="l02884"></a>02884 QString::fromLatin1(<span class="stringliteral">"%1;;"</span>).arg(cats[0]));
<a name="l02885"></a>02885 }
<a name="l02886"></a>02886 cats.remove(cats.begin());
<a name="l02887"></a>02887 }
<a name="l02888"></a>02888
<a name="l02889"></a>02889 <span class="keywordflow">for</span> (QStringList::Iterator it = cats.begin(); it != cats.end(); ++it)
<a name="l02890"></a>02890 {
<a name="l02891"></a>02891 <span class="keywordflow">if</span> (*it == BEEP_CATEGORY)
<a name="l02892"></a>02892 {
<a name="l02893"></a>02893 cats.remove(it);
<a name="l02894"></a>02894
<a name="l02895"></a>02895 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = <span class="keyword">event</span>->newAlarm();
<a name="l02896"></a>02896 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#2d8acc8bc95f7946afd32872eee96d83">setEnabled</a>(<span class="keyword">true</span>);
<a name="l02897"></a>02897 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#6d51811cf873f4935071746d264d104f">setAudioAlarm</a>();
<a name="l02898"></a>02898 QDateTime dt = <span class="keyword">event</span>->dtStart(); <span class="comment">// default</span>
<a name="l02899"></a>02899
<a name="l02900"></a>02900 <span class="comment">// Parse and order the alarms to know which one's date/time to use</span>
<a name="l02901"></a>02901 AlarmMap alarmMap;
<a name="l02902"></a>02902 readAlarms(*event, &alarmMap);
<a name="l02903"></a>02903 AlarmMap::ConstIterator it = alarmMap.begin();
<a name="l02904"></a>02904 <span class="keywordflow">if</span> (it != alarmMap.end())
<a name="l02905"></a>02905 {
<a name="l02906"></a>02906 dt = it.data().alarm->time();
<a name="l02907"></a>02907 <span class="keywordflow">break</span>;
<a name="l02908"></a>02908 }
<a name="l02909"></a>02909 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(start.secsTo(dt));
<a name="l02910"></a>02910 <span class="keywordflow">break</span>;
<a name="l02911"></a>02911 }
<a name="l02912"></a>02912 }
<a name="l02913"></a>02913 }
<a name="l02914"></a>02914
<a name="l02915"></a>02915 <span class="keywordflow">if</span> (pre_1_1_1)
<a name="l02916"></a>02916 {
<a name="l02917"></a>02917 <span class="comment">/*</span>
<a name="l02918"></a>02918 <span class="comment"> * It's a KAlarm pre-1.1.1 calendar file.</span>
<a name="l02919"></a>02919 <span class="comment"> * Convert simple LATECANCEL category to LATECANCEL:n where n = minutes late.</span>
<a name="l02920"></a>02920 <span class="comment"> */</span>
<a name="l02921"></a>02921 QStringList::Iterator it;
<a name="l02922"></a>02922 <span class="keywordflow">while</span> ((it = cats.find(LATE_CANCEL_CAT)) != cats.end())
<a name="l02923"></a>02923 {
<a name="l02924"></a>02924 cats.remove(it);
<a name="l02925"></a>02925 addLateCancel = <span class="keyword">true</span>;
<a name="l02926"></a>02926 }
<a name="l02927"></a>02927 }
<a name="l02928"></a>02928
<a name="l02929"></a>02929 <span class="keywordflow">if</span> (pre_1_2_1)
<a name="l02930"></a>02930 {
<a name="l02931"></a>02931 <span class="comment">/*</span>
<a name="l02932"></a>02932 <span class="comment"> * It's a KAlarm pre-1.2.1 calendar file.</span>
<a name="l02933"></a>02933 <span class="comment"> * Convert email display alarms from translated to untranslated header prefixes.</span>
<a name="l02934"></a>02934 <span class="comment"> */</span>
<a name="l02935"></a>02935 <span class="keywordflow">for</span> (Alarm::List::ConstIterator alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l02936"></a>02936 {
<a name="l02937"></a>02937 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l02938"></a>02938 <span class="keywordflow">if</span> (alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#9cec3c8d0c2047ccb8334a54175ca7c7">type</a>() == Alarm::Display)
<a name="l02939"></a>02939 {
<a name="l02940"></a>02940 QString oldtext = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079">text</a>();
<a name="l02941"></a>02941 QString newtext = AlarmText::toCalendarText(oldtext);
<a name="l02942"></a>02942 <span class="keywordflow">if</span> (oldtext != newtext)
<a name="l02943"></a>02943 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#b5b69003ad8ad9450b8f4f542c234a8d">setDisplayAlarm</a>(newtext);
<a name="l02944"></a>02944 }
<a name="l02945"></a>02945 }
<a name="l02946"></a>02946 }
<a name="l02947"></a>02947
<a name="l02948"></a>02948 <span class="keywordflow">if</span> (pre_1_3_0)
<a name="l02949"></a>02949 {
<a name="l02950"></a>02950 <span class="comment">/*</span>
<a name="l02951"></a>02951 <span class="comment"> * It's a KAlarm pre-1.3.0 calendar file.</span>
<a name="l02952"></a>02952 <span class="comment"> * Convert simple TMPLDEFTIME category to TMPLAFTTIME:n where n = minutes after.</span>
<a name="l02953"></a>02953 <span class="comment"> */</span>
<a name="l02954"></a>02954 QStringList::Iterator it;
<a name="l02955"></a>02955 <span class="keywordflow">while</span> ((it = cats.find(TEMPL_DEF_TIME_CAT)) != cats.end())
<a name="l02956"></a>02956 {
<a name="l02957"></a>02957 cats.remove(it);
<a name="l02958"></a>02958 cats.append(QString(<span class="stringliteral">"%1%2"</span>).arg(TEMPL_AFTER_TIME_CATEGORY).arg(0));
<a name="l02959"></a>02959 }
<a name="l02960"></a>02960 }
<a name="l02961"></a>02961
<a name="l02962"></a>02962 <span class="keywordflow">if</span> (pre_1_3_1)
<a name="l02963"></a>02963 {
<a name="l02964"></a>02964 <span class="comment">/*</span>
<a name="l02965"></a>02965 <span class="comment"> * It's a KAlarm pre-1.3.1 calendar file.</span>
<a name="l02966"></a>02966 <span class="comment"> * Convert simple XTERM category to LOG:xterm:</span>
<a name="l02967"></a>02967 <span class="comment"> */</span>
<a name="l02968"></a>02968 QStringList::Iterator it;
<a name="l02969"></a>02969 <span class="keywordflow">while</span> ((it = cats.find(EXEC_IN_XTERM_CAT)) != cats.end())
<a name="l02970"></a>02970 {
<a name="l02971"></a>02971 cats.remove(it);
<a name="l02972"></a>02972 cats.append(LOG_CATEGORY + xtermURL);
<a name="l02973"></a>02973 }
<a name="l02974"></a>02974 }
<a name="l02975"></a>02975
<a name="l02976"></a>02976 <span class="keywordflow">if</span> (addLateCancel)
<a name="l02977"></a>02977 cats.append(QString(<span class="stringliteral">"%1%2"</span>).arg(LATE_CANCEL_CATEGORY).arg(1));
<a name="l02978"></a>02978
<a name="l02979"></a>02979 <span class="keyword">event</span>->setCategories(cats);
<a name="l02980"></a>02980
<a name="l02981"></a>02981
<a name="l02982"></a>02982 <span class="keywordflow">if</span> (pre_1_4_14
<a name="l02983"></a>02983 && event-><a class="code" href="classKAEvent.html#34dcb443a90dc0efbe85aa4552212ee0">recurrence</a>() && <span class="keyword">event</span>->recurrence()->doesRecur())
<a name="l02984"></a>02984 {
<a name="l02985"></a>02985 <span class="comment">/*</span>
<a name="l02986"></a>02986 <span class="comment"> * It's a KAlarm pre-1.4.14 calendar file.</span>
<a name="l02987"></a>02987 <span class="comment"> * For recurring events, convert the main alarm offset to an absolute</span>
<a name="l02988"></a>02988 <span class="comment"> * time in the X-KDE-KALARM-NEXTRECUR property, and convert main</span>
<a name="l02989"></a>02989 <span class="comment"> * alarm offsets to zero and deferral alarm offsets to be relative to</span>
<a name="l02990"></a>02990 <span class="comment"> * the next recurrence.</span>
<a name="l02991"></a>02991 <span class="comment"> */</span>
<a name="l02992"></a>02992 <span class="keywordtype">bool</span> dateOnly = (cats.find(DATE_ONLY_CATEGORY) != cats.end());
<a name="l02993"></a>02993 DateTime startDateTime(event->dtStart(), dateOnly);
<a name="l02994"></a>02994 <span class="comment">// Convert the main alarm and get the next main trigger time from it</span>
<a name="l02995"></a>02995 DateTime nextMainDateTime;
<a name="l02996"></a>02996 <span class="keywordtype">bool</span> mainExpired = <span class="keyword">true</span>;
<a name="l02997"></a>02997 Alarm::List::ConstIterator alit;
<a name="l02998"></a>02998 <span class="keywordflow">for</span> (alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l02999"></a>02999 {
<a name="l03000"></a>03000 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l03001"></a>03001 <span class="keywordflow">if</span> (!alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#82ffea42c98bbe563cf9b7c03262cffc">hasStartOffset</a>())
<a name="l03002"></a>03002 <span class="keywordflow">continue</span>;
<a name="l03003"></a>03003 <span class="keywordtype">bool</span> mainAlarm = <span class="keyword">true</span>;
<a name="l03004"></a>03004 QString <span class="keyword">property</span> = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, TYPE_PROPERTY);
<a name="l03005"></a>03005 QStringList types = QStringList::split(QChar(<span class="charliteral">','</span>), property);
<a name="l03006"></a>03006 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i = 0; i < types.count(); ++i)
<a name="l03007"></a>03007 {
<a name="l03008"></a>03008 QString type = types[i];
<a name="l03009"></a>03009 <span class="keywordflow">if</span> (type == AT_LOGIN_TYPE
<a name="l03010"></a>03010 || type == TIME_DEFERRAL_TYPE
<a name="l03011"></a>03011 || type == DATE_DEFERRAL_TYPE
<a name="l03012"></a>03012 || type == REMINDER_TYPE
<a name="l03013"></a>03013 || type == REMINDER_ONCE_TYPE
<a name="l03014"></a>03014 || type == DISPLAYING_TYPE
<a name="l03015"></a>03015 || type == PRE_ACTION_TYPE
<a name="l03016"></a>03016 || type == POST_ACTION_TYPE)
<a name="l03017"></a>03017 mainAlarm = <span class="keyword">false</span>;
<a name="l03018"></a>03018 }
<a name="l03019"></a>03019 <span class="keywordflow">if</span> (mainAlarm)
<a name="l03020"></a>03020 {
<a name="l03021"></a>03021 mainExpired = <span class="keyword">false</span>;
<a name="l03022"></a>03022 nextMainDateTime = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb">time</a>();
<a name="l03023"></a>03023 nextMainDateTime.setDateOnly(dateOnly);
<a name="l03024"></a>03024 <span class="keywordflow">if</span> (nextMainDateTime != startDateTime)
<a name="l03025"></a>03025 {
<a name="l03026"></a>03026 QDateTime dt = nextMainDateTime.dateTime();
<a name="l03027"></a>03027 <span class="keyword">event</span>->setCustomProperty(APPNAME, NEXT_RECUR_PROPERTY,
<a name="l03028"></a>03028 dt.toString(dateOnly ? <span class="stringliteral">"yyyyMMdd"</span> : <span class="stringliteral">"yyyyMMddThhmmss"</span>));
<a name="l03029"></a>03029 }
<a name="l03030"></a>03030 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(0);
<a name="l03031"></a>03031 }
<a name="l03032"></a>03032 }
<a name="l03033"></a>03033 <span class="keywordtype">int</span> adjustment;
<a name="l03034"></a>03034 <span class="keywordflow">if</span> (mainExpired)
<a name="l03035"></a>03035 {
<a name="l03036"></a>03036 <span class="comment">// It's an expired recurrence.</span>
<a name="l03037"></a>03037 <span class="comment">// Set the alarm offset relative to the first actual occurrence</span>
<a name="l03038"></a>03038 <span class="comment">// (taking account of possible exceptions).</span>
<a name="l03039"></a>03039 DateTime dt = <span class="keyword">event</span>->recurrence()->getNextDateTime(startDateTime.dateTime().addDays(-1));
<a name="l03040"></a>03040 dt.setDateOnly(dateOnly);
<a name="l03041"></a>03041 adjustment = startDateTime.secsTo(dt);
<a name="l03042"></a>03042 }
<a name="l03043"></a>03043 <span class="keywordflow">else</span>
<a name="l03044"></a>03044 adjustment = startDateTime.secsTo(nextMainDateTime);
<a name="l03045"></a>03045 <span class="keywordflow">if</span> (adjustment)
<a name="l03046"></a>03046 {
<a name="l03047"></a>03047 <span class="comment">// Convert deferred alarms</span>
<a name="l03048"></a>03048 <span class="keywordflow">for</span> (alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l03049"></a>03049 {
<a name="l03050"></a>03050 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l03051"></a>03051 <span class="keywordflow">if</span> (!alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#82ffea42c98bbe563cf9b7c03262cffc">hasStartOffset</a>())
<a name="l03052"></a>03052 <span class="keywordflow">continue</span>;
<a name="l03053"></a>03053 QString <span class="keyword">property</span> = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, TYPE_PROPERTY);
<a name="l03054"></a>03054 QStringList types = QStringList::split(QChar(<span class="charliteral">','</span>), property);
<a name="l03055"></a>03055 <span class="keywordflow">for</span> (<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> i = 0; i < types.count(); ++i)
<a name="l03056"></a>03056 {
<a name="l03057"></a>03057 QString type = types[i];
<a name="l03058"></a>03058 <span class="keywordflow">if</span> (type == TIME_DEFERRAL_TYPE
<a name="l03059"></a>03059 || type == DATE_DEFERRAL_TYPE)
<a name="l03060"></a>03060 {
<a name="l03061"></a>03061 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">setStartOffset</a>(alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#3fdf5078feefc485a6d86d2f9c3e8d6a">startOffset</a>().<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Duration.html#34b69f5167fc798461a45971619227f6">asSeconds</a>() - adjustment);
<a name="l03062"></a>03062 <span class="keywordflow">break</span>;
<a name="l03063"></a>03063 }
<a name="l03064"></a>03064 }
<a name="l03065"></a>03065 }
<a name="l03066"></a>03066 }
<a name="l03067"></a>03067 }
<a name="l03068"></a>03068
<a name="l03069"></a>03069 <span class="keywordflow">if</span> (pre_1_5_0)
<a name="l03070"></a>03070 {
<a name="l03071"></a>03071 <span class="comment">/*</span>
<a name="l03072"></a>03072 <span class="comment"> * It's a KAlarm pre-1.5.0 calendar file.</span>
<a name="l03073"></a>03073 <span class="comment"> * Convert email identity names to uoids.</span>
<a name="l03074"></a>03074 <span class="comment"> * Convert simple repetitions without a recurrence, to a recurrence.</span>
<a name="l03075"></a>03075 <span class="comment"> */</span>
<a name="l03076"></a>03076 <span class="keywordflow">for</span> (Alarm::List::ConstIterator alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l03077"></a>03077 {
<a name="l03078"></a>03078 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l03079"></a>03079 QString name = alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#4809ed307d0a7e8bae90485a34e342fb">customProperty</a>(APPNAME, KMAIL_ID_PROPERTY);
<a name="l03080"></a>03080 <span class="keywordflow">if</span> (name.isEmpty())
<a name="l03081"></a>03081 <span class="keywordflow">continue</span>;
<a name="l03082"></a>03082 uint <span class="keywordtype">id</span> = KAMail::identityUoid(name);
<a name="l03083"></a>03083 <span class="keywordflow">if</span> (<span class="keywordtype">id</span>)
<a name="l03084"></a>03084 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#afa6f5501560226cf729bd11771d9d2a">setCustomProperty</a>(APPNAME, EMAIL_ID_PROPERTY, QString::number(<span class="keywordtype">id</span>));
<a name="l03085"></a>03085 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CustomProperties.html#d47e81fd7641d34b3f41809889e2d154">removeCustomProperty</a>(APPNAME, KMAIL_ID_PROPERTY);
<a name="l03086"></a>03086 }
<a name="l03087"></a>03087 convertRepetition(event);
<a name="l03088"></a>03088 }
<a name="l03089"></a>03089 }
<a name="l03090"></a>03090 }
<a name="l03091"></a>03091
<a name="l03092"></a>03092 <span class="comment">/******************************************************************************</span>
<a name="l03093"></a>03093 <span class="comment">* If the calendar was written by a pre-1.4.22 version of KAlarm, or another</span>
<a name="l03094"></a>03094 <span class="comment">* program, convert simple repetitions in events without a recurrence, to a</span>
<a name="l03095"></a>03095 <span class="comment">* recurrence.</span>
<a name="l03096"></a>03096 <span class="comment">* Reply = true if any conversions were done.</span>
<a name="l03097"></a>03097 <span class="comment">*/</span>
<a name="l03098"></a>03098 <span class="keywordtype">void</span> KAEvent::convertRepetitions(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CalendarLocal.html">KCal::CalendarLocal</a>& calendar)
<a name="l03099"></a>03099 {
<a name="l03100"></a>03100
<a name="l03101"></a>03101 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Event::List</a> events = calendar.<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CalendarLocal.html#405e9a43400c5aca3bac5d00a3638244">rawEvents</a>();
<a name="l03102"></a>03102 <span class="keywordflow">for</span> (Event::List::ConstIterator ev = events.begin(); ev != events.end(); ++ev)
<a name="l03103"></a>03103 convertRepetition(*ev);
<a name="l03104"></a>03104 }
<a name="l03105"></a>03105
<a name="l03106"></a>03106 <span class="comment">/******************************************************************************</span>
<a name="l03107"></a>03107 <span class="comment">* Convert simple repetitions in an event without a recurrence, to a</span>
<a name="l03108"></a>03108 <span class="comment">* recurrence. Repetitions which are an exact multiple of 24 hours are converted</span>
<a name="l03109"></a>03109 <span class="comment">* to daily recurrences; else they are converted to minutely recurrences. Note</span>
<a name="l03110"></a>03110 <span class="comment">* that daily and minutely recurrences produce different results when they span</span>
<a name="l03111"></a>03111 <span class="comment">* a daylight saving time change.</span>
<a name="l03112"></a>03112 <span class="comment">* Reply = true if any conversions were done.</span>
<a name="l03113"></a>03113 <span class="comment">*/</span>
<a name="l03114"></a>03114 <span class="keywordtype">bool</span> KAEvent::convertRepetition(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">KCal::Event</a>* event)
<a name="l03115"></a>03115 {
<a name="l03116"></a>03116 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">Alarm::List</a> alarms = <span class="keyword">event</span>->alarms();
<a name="l03117"></a>03117 <span class="keywordflow">if</span> (alarms.isEmpty())
<a name="l03118"></a>03118 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l03119"></a>03119 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html">Recurrence</a>* recur = <span class="keyword">event</span>->recurrence(); <span class="comment">// guaranteed to return non-null</span>
<a name="l03120"></a>03120 <span class="keywordflow">if</span> (!recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#0cd99b7d609400ec9e5cf7439bec132a">doesRecur</a>())
<a name="l03121"></a>03121 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l03122"></a>03122 <span class="keywordtype">bool</span> converted = <span class="keyword">false</span>;
<a name="l03123"></a>03123 <span class="keywordtype">bool</span> readOnly = <span class="keyword">event</span>->isReadOnly();
<a name="l03124"></a>03124 <span class="keywordflow">for</span> (Alarm::List::ConstIterator alit = alarms.begin(); alit != alarms.end(); ++alit)
<a name="l03125"></a>03125 {
<a name="l03126"></a>03126 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm = *alit;
<a name="l03127"></a>03127 <span class="keywordflow">if</span> (alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7">repeatCount</a>() > 0 && alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>() > 0)
<a name="l03128"></a>03128 {
<a name="l03129"></a>03129 <span class="keywordflow">if</span> (!converted)
<a name="l03130"></a>03130 {
<a name="l03131"></a>03131 <span class="keywordflow">if</span> (readOnly)
<a name="l03132"></a>03132 <span class="keyword">event</span>->setReadOnly(<span class="keyword">false</span>);
<a name="l03133"></a>03133 <span class="keywordflow">if</span> (alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>() % (24*3600))
<a name="l03134"></a>03134 recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#42e99f4c3fc3238d8b7a0efcce588a4c">setMinutely</a>(alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>());
<a name="l03135"></a>03135 <span class="keywordflow">else</span>
<a name="l03136"></a>03136 recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#a63c169d253749c9d35b2bb6e8191d1e">setDaily</a>(alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">snoozeTime</a>() / (24*3600));
<a name="l03137"></a>03137 recur-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Recurrence.html#f2d673a2430023d57e8f940cbbcd186a">setDuration</a>(alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7">repeatCount</a>() + 1);
<a name="l03138"></a>03138 converted = <span class="keyword">true</span>;
<a name="l03139"></a>03139 }
<a name="l03140"></a>03140 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#25af13606c653d0009e5559bdad78ff3">setRepeatCount</a>(0);
<a name="l03141"></a>03141 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#5b32099b4b802027e4b75767f48f73df">setSnoozeTime</a>(0);
<a name="l03142"></a>03142 }
<a name="l03143"></a>03143 }
<a name="l03144"></a>03144 <span class="keywordflow">if</span> (converted)
<a name="l03145"></a>03145 {
<a name="l03146"></a>03146 <span class="keywordflow">if</span> (readOnly)
<a name="l03147"></a>03147 <span class="keyword">event</span>->setReadOnly(<span class="keyword">true</span>);
<a name="l03148"></a>03148 }
<a name="l03149"></a>03149 <span class="keywordflow">return</span> converted;
<a name="l03150"></a>03150 }
<a name="l03151"></a>03151
<a name="l03152"></a>03152 <span class="preprocessor">#ifndef NDEBUG</span>
<a name="l03153"></a>03153 <span class="preprocessor"></span><span class="keywordtype">void</span> KAEvent::dumpDebug()<span class="keyword"> const</span>
<a name="l03154"></a>03154 <span class="keyword"></span>{
<a name="l03155"></a>03155 kdDebug(5950) << <span class="stringliteral">"KAEvent dump:\n"</span>;
<a name="l03156"></a>03156 KAAlarmEventBase::dumpDebug();
<a name="l03157"></a>03157 <span class="keywordflow">if</span> (!mTemplateName.isEmpty())
<a name="l03158"></a>03158 {
<a name="l03159"></a>03159 kdDebug(5950) << <span class="stringliteral">"-- mTemplateName:"</span> << mTemplateName << <span class="stringliteral">":\n"</span>;
<a name="l03160"></a>03160 kdDebug(5950) << <span class="stringliteral">"-- mTemplateAfterTime:"</span> << mTemplateAfterTime << <span class="stringliteral">":\n"</span>;
<a name="l03161"></a>03161 }
<a name="l03162"></a>03162 <span class="keywordflow">if</span> (mActionType == T_MESSAGE || mActionType == T_FILE)
<a name="l03163"></a>03163 {
<a name="l03164"></a>03164 kdDebug(5950) << <span class="stringliteral">"-- mAudioFile:"</span> << mAudioFile << <span class="stringliteral">":\n"</span>;
<a name="l03165"></a>03165 kdDebug(5950) << <span class="stringliteral">"-- mPreAction:"</span> << mPreAction << <span class="stringliteral">":\n"</span>;
<a name="l03166"></a>03166 kdDebug(5950) << <span class="stringliteral">"-- mPostAction:"</span> << mPostAction << <span class="stringliteral">":\n"</span>;
<a name="l03167"></a>03167 }
<a name="l03168"></a>03168 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mActionType == T_COMMAND)
<a name="l03169"></a>03169 {
<a name="l03170"></a>03170 kdDebug(5950) << <span class="stringliteral">"-- mCommandXterm:"</span> << (mCommandXterm ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03171"></a>03171 kdDebug(5950) << <span class="stringliteral">"-- mLogFile:"</span> << mLogFile << <span class="stringliteral">":\n"</span>;
<a name="l03172"></a>03172 }
<a name="l03173"></a>03173 kdDebug(5950) << <span class="stringliteral">"-- mKMailSerialNumber:"</span> << mKMailSerialNumber << <span class="stringliteral">":\n"</span>;
<a name="l03174"></a>03174 kdDebug(5950) << <span class="stringliteral">"-- mCopyToKOrganizer:"</span> << (mCopyToKOrganizer ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03175"></a>03175 kdDebug(5950) << <span class="stringliteral">"-- mStartDateTime:"</span> << mStartDateTime.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03176"></a>03176 kdDebug(5950) << <span class="stringliteral">"-- mSaveDateTime:"</span> << mSaveDateTime.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03177"></a>03177 <span class="keywordflow">if</span> (mRepeatAtLogin)
<a name="l03178"></a>03178 kdDebug(5950) << <span class="stringliteral">"-- mAtLoginDateTime:"</span> << mAtLoginDateTime.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03179"></a>03179 kdDebug(5950) << <span class="stringliteral">"-- mArchiveRepeatAtLogin:"</span> << (mArchiveRepeatAtLogin ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03180"></a>03180 kdDebug(5950) << <span class="stringliteral">"-- mEnabled:"</span> << (mEnabled ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03181"></a>03181 <span class="keywordflow">if</span> (mReminderMinutes)
<a name="l03182"></a>03182 kdDebug(5950) << <span class="stringliteral">"-- mReminderMinutes:"</span> << mReminderMinutes << <span class="stringliteral">":\n"</span>;
<a name="l03183"></a>03183 <span class="keywordflow">if</span> (mArchiveReminderMinutes)
<a name="l03184"></a>03184 kdDebug(5950) << <span class="stringliteral">"-- mArchiveReminderMinutes:"</span> << mArchiveReminderMinutes << <span class="stringliteral">":\n"</span>;
<a name="l03185"></a>03185 <span class="keywordflow">if</span> (mReminderMinutes || mArchiveReminderMinutes)
<a name="l03186"></a>03186 kdDebug(5950) << <span class="stringliteral">"-- mReminderOnceOnly:"</span> << mReminderOnceOnly << <span class="stringliteral">":\n"</span>;
<a name="l03187"></a>03187 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mDeferral > 0)
<a name="l03188"></a>03188 {
<a name="l03189"></a>03189 kdDebug(5950) << <span class="stringliteral">"-- mDeferral:"</span> << (mDeferral == NORMAL_DEFERRAL ? <span class="stringliteral">"normal"</span> : <span class="stringliteral">"reminder"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03190"></a>03190 kdDebug(5950) << <span class="stringliteral">"-- mDeferralTime:"</span> << mDeferralTime.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03191"></a>03191 }
<a name="l03192"></a>03192 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mDeferral == CANCEL_DEFERRAL)
<a name="l03193"></a>03193 kdDebug(5950) << <span class="stringliteral">"-- mDeferral:cancel:\n"</span>;
<a name="l03194"></a>03194 kdDebug(5950) << <span class="stringliteral">"-- mDeferDefaultMinutes:"</span> << mDeferDefaultMinutes << <span class="stringliteral">":\n"</span>;
<a name="l03195"></a>03195 <span class="keywordflow">if</span> (mDisplaying)
<a name="l03196"></a>03196 {
<a name="l03197"></a>03197 kdDebug(5950) << <span class="stringliteral">"-- mDisplayingTime:"</span> << mDisplayingTime.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03198"></a>03198 kdDebug(5950) << <span class="stringliteral">"-- mDisplayingFlags:"</span> << mDisplayingFlags << <span class="stringliteral">":\n"</span>;
<a name="l03199"></a>03199 }
<a name="l03200"></a>03200 kdDebug(5950) << <span class="stringliteral">"-- mRevision:"</span> << mRevision << <span class="stringliteral">":\n"</span>;
<a name="l03201"></a>03201 kdDebug(5950) << <span class="stringliteral">"-- mRecurrence:"</span> << (mRecurrence ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03202"></a>03202 kdDebug(5950) << <span class="stringliteral">"-- mAlarmCount:"</span> << mAlarmCount << <span class="stringliteral">":\n"</span>;
<a name="l03203"></a>03203 kdDebug(5950) << <span class="stringliteral">"-- mMainExpired:"</span> << (mMainExpired ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03204"></a>03204 kdDebug(5950) << <span class="stringliteral">"KAEvent dump end\n"</span>;
<a name="l03205"></a>03205 }
<a name="l03206"></a>03206 <span class="preprocessor">#endif</span>
<a name="l03207"></a>03207 <span class="preprocessor"></span>
<a name="l03208"></a>03208
<a name="l03209"></a>03209 <span class="comment">/*=============================================================================</span>
<a name="l03210"></a>03210 <span class="comment">= Class KAAlarm</span>
<a name="l03211"></a>03211 <span class="comment">= Corresponds to a single KCal::Alarm instance.</span>
<a name="l03212"></a>03212 <span class="comment">=============================================================================*/</span>
<a name="l03213"></a>03213
<a name="l03214"></a>03214 KAAlarm::KAAlarm(<span class="keyword">const</span> KAAlarm& alarm)
<a name="l03215"></a>03215 : KAAlarmEventBase(alarm),
<a name="l03216"></a>03216 mType(alarm.mType),
<a name="l03217"></a>03217 mRecurs(alarm.mRecurs),
<a name="l03218"></a>03218 mDeferred(alarm.mDeferred)
<a name="l03219"></a>03219 { }
<a name="l03220"></a>03220
<a name="l03221"></a>03221
<a name="l03222"></a>03222 <span class="keywordtype">int</span> KAAlarm::flags()<span class="keyword"> const</span>
<a name="l03223"></a>03223 <span class="keyword"></span>{
<a name="l03224"></a>03224 <span class="keywordflow">return</span> KAAlarmEventBase::flags()
<a name="l03225"></a>03225 | (mDeferred ? KAEvent::DEFERRAL : 0);
<a name="l03226"></a>03226
<a name="l03227"></a>03227 }
<a name="l03228"></a>03228
<a name="l03229"></a>03229 <span class="preprocessor">#ifndef NDEBUG</span>
<a name="l03230"></a>03230 <span class="preprocessor"></span><span class="keywordtype">void</span> KAAlarm::dumpDebug()<span class="keyword"> const</span>
<a name="l03231"></a>03231 <span class="keyword"></span>{
<a name="l03232"></a>03232 kdDebug(5950) << <span class="stringliteral">"KAAlarm dump:\n"</span>;
<a name="l03233"></a>03233 KAAlarmEventBase::dumpDebug();
<a name="l03234"></a>03234 <span class="keyword">const</span> <span class="keywordtype">char</span>* altype = 0;
<a name="l03235"></a>03235 <span class="keywordflow">switch</span> (mType)
<a name="l03236"></a>03236 {
<a name="l03237"></a>03237 <span class="keywordflow">case</span> MAIN__ALARM: altype = <span class="stringliteral">"MAIN"</span>; <span class="keywordflow">break</span>;
<a name="l03238"></a>03238 <span class="keywordflow">case</span> REMINDER__ALARM: altype = <span class="stringliteral">"REMINDER"</span>; <span class="keywordflow">break</span>;
<a name="l03239"></a>03239 <span class="keywordflow">case</span> DEFERRED_DATE__ALARM: altype = <span class="stringliteral">"DEFERRED(DATE)"</span>; <span class="keywordflow">break</span>;
<a name="l03240"></a>03240 <span class="keywordflow">case</span> DEFERRED_TIME__ALARM: altype = <span class="stringliteral">"DEFERRED(TIME)"</span>; <span class="keywordflow">break</span>;
<a name="l03241"></a>03241 <span class="keywordflow">case</span> DEFERRED_REMINDER_DATE__ALARM: altype = <span class="stringliteral">"DEFERRED_REMINDER(DATE)"</span>; <span class="keywordflow">break</span>;
<a name="l03242"></a>03242 <span class="keywordflow">case</span> DEFERRED_REMINDER_TIME__ALARM: altype = <span class="stringliteral">"DEFERRED_REMINDER(TIME)"</span>; <span class="keywordflow">break</span>;
<a name="l03243"></a>03243 <span class="keywordflow">case</span> AT_LOGIN__ALARM: altype = <span class="stringliteral">"LOGIN"</span>; <span class="keywordflow">break</span>;
<a name="l03244"></a>03244 <span class="keywordflow">case</span> DISPLAYING__ALARM: altype = <span class="stringliteral">"DISPLAYING"</span>; <span class="keywordflow">break</span>;
<a name="l03245"></a>03245 <span class="keywordflow">case</span> AUDIO__ALARM: altype = <span class="stringliteral">"AUDIO"</span>; <span class="keywordflow">break</span>;
<a name="l03246"></a>03246 <span class="keywordflow">case</span> PRE_ACTION__ALARM: altype = <span class="stringliteral">"PRE_ACTION"</span>; <span class="keywordflow">break</span>;
<a name="l03247"></a>03247 <span class="keywordflow">case</span> POST_ACTION__ALARM: altype = <span class="stringliteral">"POST_ACTION"</span>; <span class="keywordflow">break</span>;
<a name="l03248"></a>03248 <span class="keywordflow">default</span>: altype = <span class="stringliteral">"INVALID"</span>; <span class="keywordflow">break</span>;
<a name="l03249"></a>03249 }
<a name="l03250"></a>03250 kdDebug(5950) << <span class="stringliteral">"-- mType:"</span> << altype << <span class="stringliteral">":\n"</span>;
<a name="l03251"></a>03251 kdDebug(5950) << <span class="stringliteral">"-- mRecurs:"</span> << (mRecurs ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03252"></a>03252 kdDebug(5950) << <span class="stringliteral">"-- mDeferred:"</span> << (mDeferred ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03253"></a>03253 kdDebug(5950) << <span class="stringliteral">"KAAlarm dump end\n"</span>;
<a name="l03254"></a>03254 }
<a name="l03255"></a>03255
<a name="l03256"></a>03256 <span class="keyword">const</span> <span class="keywordtype">char</span>* KAAlarm::debugType(Type type)
<a name="l03257"></a>03257 {
<a name="l03258"></a>03258 <span class="keywordflow">switch</span> (type)
<a name="l03259"></a>03259 {
<a name="l03260"></a>03260 <span class="keywordflow">case</span> MAIN_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"MAIN"</span>;
<a name="l03261"></a>03261 <span class="keywordflow">case</span> REMINDER_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"REMINDER"</span>;
<a name="l03262"></a>03262 <span class="keywordflow">case</span> DEFERRED_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"DEFERRED"</span>;
<a name="l03263"></a>03263 <span class="keywordflow">case</span> DEFERRED_REMINDER_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"DEFERRED_REMINDER"</span>;
<a name="l03264"></a>03264 <span class="keywordflow">case</span> AT_LOGIN_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"LOGIN"</span>;
<a name="l03265"></a>03265 <span class="keywordflow">case</span> DISPLAYING_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"DISPLAYING"</span>;
<a name="l03266"></a>03266 <span class="keywordflow">case</span> AUDIO_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"AUDIO"</span>;
<a name="l03267"></a>03267 <span class="keywordflow">case</span> PRE_ACTION_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"PRE_ACTION"</span>;
<a name="l03268"></a>03268 <span class="keywordflow">case</span> POST_ACTION_ALARM: <span class="keywordflow">return</span> <span class="stringliteral">"POST_ACTION"</span>;
<a name="l03269"></a>03269 <span class="keywordflow">default</span>: <span class="keywordflow">return</span> <span class="stringliteral">"INVALID"</span>;
<a name="l03270"></a>03270 }
<a name="l03271"></a>03271 }
<a name="l03272"></a>03272 <span class="preprocessor">#endif</span>
<a name="l03273"></a>03273 <span class="preprocessor"></span>
<a name="l03274"></a>03274
<a name="l03275"></a>03275 <span class="comment">/*=============================================================================</span>
<a name="l03276"></a>03276 <span class="comment">= Class KAAlarmEventBase</span>
<a name="l03277"></a>03277 <span class="comment">=============================================================================*/</span>
<a name="l03278"></a>03278
<a name="l03279"></a>03279 <span class="keywordtype">void</span> KAAlarmEventBase::copy(<span class="keyword">const</span> KAAlarmEventBase& rhs)
<a name="l03280"></a>03280 {
<a name="l03281"></a>03281 mEventID = rhs.mEventID;
<a name="l03282"></a>03282 mText = rhs.mText;
<a name="l03283"></a>03283 mNextMainDateTime = rhs.mNextMainDateTime;
<a name="l03284"></a>03284 mBgColour = rhs.mBgColour;
<a name="l03285"></a>03285 mFgColour = rhs.mFgColour;
<a name="l03286"></a>03286 mFont = rhs.mFont;
<a name="l03287"></a>03287 mEmailFromIdentity = rhs.mEmailFromIdentity;
<a name="l03288"></a>03288 mEmailAddresses = rhs.mEmailAddresses;
<a name="l03289"></a>03289 mEmailSubject = rhs.mEmailSubject;
<a name="l03290"></a>03290 mEmailAttachments = rhs.mEmailAttachments;
<a name="l03291"></a>03291 mSoundVolume = rhs.mSoundVolume;
<a name="l03292"></a>03292 mFadeVolume = rhs.mFadeVolume;
<a name="l03293"></a>03293 mFadeSeconds = rhs.mFadeSeconds;
<a name="l03294"></a>03294 mActionType = rhs.mActionType;
<a name="l03295"></a>03295 mCommandScript = rhs.mCommandScript;
<a name="l03296"></a>03296 mRepeatCount = rhs.mRepeatCount;
<a name="l03297"></a>03297 mRepeatInterval = rhs.mRepeatInterval;
<a name="l03298"></a>03298 mNextRepeat = rhs.mNextRepeat;
<a name="l03299"></a>03299 mBeep = rhs.mBeep;
<a name="l03300"></a>03300 mSpeak = rhs.mSpeak;
<a name="l03301"></a>03301 mRepeatSound = rhs.mRepeatSound;
<a name="l03302"></a>03302 mRepeatAtLogin = rhs.mRepeatAtLogin;
<a name="l03303"></a>03303 mDisplaying = rhs.mDisplaying;
<a name="l03304"></a>03304 mLateCancel = rhs.mLateCancel;
<a name="l03305"></a>03305 mAutoClose = rhs.mAutoClose;
<a name="l03306"></a>03306 mEmailBcc = rhs.mEmailBcc;
<a name="l03307"></a>03307 mConfirmAck = rhs.mConfirmAck;
<a name="l03308"></a>03308 mDefaultFont = rhs.mDefaultFont;
<a name="l03309"></a>03309 }
<a name="l03310"></a>03310
<a name="l03311"></a>03311 <span class="keywordtype">void</span> KAAlarmEventBase::set(<span class="keywordtype">int</span> flags)
<a name="l03312"></a>03312 {
<a name="l03313"></a>03313 mSpeak = flags & KAEvent::SPEAK;
<a name="l03314"></a>03314 mBeep = (flags & KAEvent::BEEP) && !mSpeak;
<a name="l03315"></a>03315 mRepeatSound = flags & KAEvent::REPEAT_SOUND;
<a name="l03316"></a>03316 mRepeatAtLogin = flags & KAEvent::REPEAT_AT_LOGIN;
<a name="l03317"></a>03317 mAutoClose = (flags & KAEvent::AUTO_CLOSE) && mLateCancel;
<a name="l03318"></a>03318 mEmailBcc = flags & KAEvent::EMAIL_BCC;
<a name="l03319"></a>03319 mConfirmAck = flags & KAEvent::CONFIRM_ACK;
<a name="l03320"></a>03320 mDisplaying = flags & KAEvent::DISPLAYING_;
<a name="l03321"></a>03321 mDefaultFont = flags & KAEvent::DEFAULT_FONT;
<a name="l03322"></a>03322 mCommandScript = flags & KAEvent::SCRIPT;
<a name="l03323"></a>03323 }
<a name="l03324"></a>03324
<a name="l03325"></a>03325 <span class="keywordtype">int</span> KAAlarmEventBase::flags()<span class="keyword"> const</span>
<a name="l03326"></a>03326 <span class="keyword"></span>{
<a name="l03327"></a>03327 <span class="keywordflow">return</span> (mBeep && !mSpeak ? KAEvent::BEEP : 0)
<a name="l03328"></a>03328 | (mSpeak ? KAEvent::SPEAK : 0)
<a name="l03329"></a>03329 | (mRepeatSound ? KAEvent::REPEAT_SOUND : 0)
<a name="l03330"></a>03330 | (mRepeatAtLogin ? KAEvent::REPEAT_AT_LOGIN : 0)
<a name="l03331"></a>03331 | (mAutoClose ? KAEvent::AUTO_CLOSE : 0)
<a name="l03332"></a>03332 | (mEmailBcc ? KAEvent::EMAIL_BCC : 0)
<a name="l03333"></a>03333 | (mConfirmAck ? KAEvent::CONFIRM_ACK : 0)
<a name="l03334"></a>03334 | (mDisplaying ? KAEvent::DISPLAYING_ : 0)
<a name="l03335"></a>03335 | (mDefaultFont ? KAEvent::DEFAULT_FONT : 0)
<a name="l03336"></a>03336 | (mCommandScript ? KAEvent::SCRIPT : 0);
<a name="l03337"></a>03337 }
<a name="l03338"></a>03338
<a name="l03339"></a>03339 <span class="keyword">const</span> QFont& KAAlarmEventBase::font()<span class="keyword"> const</span>
<a name="l03340"></a>03340 <span class="keyword"></span>{
<a name="l03341"></a>03341 <span class="keywordflow">return</span> mDefaultFont ? Preferences::messageFont() : mFont;
<a name="l03342"></a>03342 }
<a name="l03343"></a>03343
<a name="l03344"></a>03344 <span class="preprocessor">#ifndef NDEBUG</span>
<a name="l03345"></a>03345 <span class="preprocessor"></span><span class="keywordtype">void</span> KAAlarmEventBase::dumpDebug()<span class="keyword"> const</span>
<a name="l03346"></a>03346 <span class="keyword"></span>{
<a name="l03347"></a>03347 kdDebug(5950) << <span class="stringliteral">"-- mEventID:"</span> << mEventID << <span class="stringliteral">":\n"</span>;
<a name="l03348"></a>03348 kdDebug(5950) << <span class="stringliteral">"-- mActionType:"</span> << (mActionType == T_MESSAGE ? <span class="stringliteral">"MESSAGE"</span> : mActionType == T_FILE ? <span class="stringliteral">"FILE"</span> : mActionType == T_COMMAND ? <span class="stringliteral">"COMMAND"</span> : mActionType == T_EMAIL ? <span class="stringliteral">"EMAIL"</span> : mActionType == T_AUDIO ? <span class="stringliteral">"AUDIO"</span> : <span class="stringliteral">"??"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03349"></a>03349 kdDebug(5950) << <span class="stringliteral">"-- mText:"</span> << mText << <span class="stringliteral">":\n"</span>;
<a name="l03350"></a>03350 <span class="keywordflow">if</span> (mActionType == T_COMMAND)
<a name="l03351"></a>03351 kdDebug(5950) << <span class="stringliteral">"-- mCommandScript:"</span> << (mCommandScript ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03352"></a>03352 kdDebug(5950) << <span class="stringliteral">"-- mNextMainDateTime:"</span> << mNextMainDateTime.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03353"></a>03353 <span class="keywordflow">if</span> (mActionType == T_EMAIL)
<a name="l03354"></a>03354 {
<a name="l03355"></a>03355 kdDebug(5950) << <span class="stringliteral">"-- mEmail: FromKMail:"</span> << mEmailFromIdentity << <span class="stringliteral">":\n"</span>;
<a name="l03356"></a>03356 kdDebug(5950) << <span class="stringliteral">"-- Addresses:"</span> << mEmailAddresses.join(<span class="stringliteral">", "</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03357"></a>03357 kdDebug(5950) << <span class="stringliteral">"-- Subject:"</span> << mEmailSubject << <span class="stringliteral">":\n"</span>;
<a name="l03358"></a>03358 kdDebug(5950) << <span class="stringliteral">"-- Attachments:"</span> << mEmailAttachments.join(<span class="stringliteral">", "</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03359"></a>03359 kdDebug(5950) << <span class="stringliteral">"-- Bcc:"</span> << (mEmailBcc ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03360"></a>03360 }
<a name="l03361"></a>03361 kdDebug(5950) << <span class="stringliteral">"-- mBgColour:"</span> << mBgColour.name() << <span class="stringliteral">":\n"</span>;
<a name="l03362"></a>03362 kdDebug(5950) << <span class="stringliteral">"-- mFgColour:"</span> << mFgColour.name() << <span class="stringliteral">":\n"</span>;
<a name="l03363"></a>03363 kdDebug(5950) << <span class="stringliteral">"-- mDefaultFont:"</span> << (mDefaultFont ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03364"></a>03364 <span class="keywordflow">if</span> (!mDefaultFont)
<a name="l03365"></a>03365 kdDebug(5950) << <span class="stringliteral">"-- mFont:"</span> << mFont.toString() << <span class="stringliteral">":\n"</span>;
<a name="l03366"></a>03366 kdDebug(5950) << <span class="stringliteral">"-- mBeep:"</span> << (mBeep ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03367"></a>03367 kdDebug(5950) << <span class="stringliteral">"-- mSpeak:"</span> << (mSpeak ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03368"></a>03368 <span class="keywordflow">if</span> (mActionType == T_AUDIO)
<a name="l03369"></a>03369 {
<a name="l03370"></a>03370 <span class="keywordflow">if</span> (mSoundVolume >= 0)
<a name="l03371"></a>03371 {
<a name="l03372"></a>03372 kdDebug(5950) << <span class="stringliteral">"-- mSoundVolume:"</span> << mSoundVolume << <span class="stringliteral">":\n"</span>;
<a name="l03373"></a>03373 <span class="keywordflow">if</span> (mFadeVolume >= 0)
<a name="l03374"></a>03374 {
<a name="l03375"></a>03375 kdDebug(5950) << <span class="stringliteral">"-- mFadeVolume:"</span> << mFadeVolume << <span class="stringliteral">":\n"</span>;
<a name="l03376"></a>03376 kdDebug(5950) << <span class="stringliteral">"-- mFadeSeconds:"</span> << mFadeSeconds << <span class="stringliteral">":\n"</span>;
<a name="l03377"></a>03377 }
<a name="l03378"></a>03378 <span class="keywordflow">else</span>
<a name="l03379"></a>03379 kdDebug(5950) << <span class="stringliteral">"-- mFadeVolume:-:\n"</span>;
<a name="l03380"></a>03380 }
<a name="l03381"></a>03381 <span class="keywordflow">else</span>
<a name="l03382"></a>03382 kdDebug(5950) << <span class="stringliteral">"-- mSoundVolume:-:\n"</span>;
<a name="l03383"></a>03383 kdDebug(5950) << <span class="stringliteral">"-- mRepeatSound:"</span> << (mRepeatSound ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03384"></a>03384 }
<a name="l03385"></a>03385 kdDebug(5950) << <span class="stringliteral">"-- mConfirmAck:"</span> << (mConfirmAck ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03386"></a>03386 kdDebug(5950) << <span class="stringliteral">"-- mRepeatAtLogin:"</span> << (mRepeatAtLogin ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03387"></a>03387 kdDebug(5950) << <span class="stringliteral">"-- mRepeatCount:"</span> << mRepeatCount << <span class="stringliteral">":\n"</span>;
<a name="l03388"></a>03388 kdDebug(5950) << <span class="stringliteral">"-- mRepeatInterval:"</span> << mRepeatInterval << <span class="stringliteral">":\n"</span>;
<a name="l03389"></a>03389 kdDebug(5950) << <span class="stringliteral">"-- mNextRepeat:"</span> << mNextRepeat << <span class="stringliteral">":\n"</span>;
<a name="l03390"></a>03390 kdDebug(5950) << <span class="stringliteral">"-- mDisplaying:"</span> << (mDisplaying ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03391"></a>03391 kdDebug(5950) << <span class="stringliteral">"-- mLateCancel:"</span> << mLateCancel << <span class="stringliteral">":\n"</span>;
<a name="l03392"></a>03392 kdDebug(5950) << <span class="stringliteral">"-- mAutoClose:"</span> << (mAutoClose ? <span class="stringliteral">"true"</span> : <span class="stringliteral">"false"</span>) << <span class="stringliteral">":\n"</span>;
<a name="l03393"></a>03393 }
<a name="l03394"></a>03394 <span class="preprocessor">#endif</span>
<a name="l03395"></a>03395 <span class="preprocessor"></span>
<a name="l03396"></a>03396
<a name="l03397"></a>03397 <span class="comment">/*=============================================================================</span>
<a name="l03398"></a>03398 <span class="comment">= Class EmailAddressList</span>
<a name="l03399"></a>03399 <span class="comment">=============================================================================*/</span>
<a name="l03400"></a>03400
<a name="l03401"></a>03401 <span class="comment">/******************************************************************************</span>
<a name="l03402"></a>03402 <span class="comment"> * Sets the list of email addresses, removing any empty addresses.</span>
<a name="l03403"></a>03403 <span class="comment"> * Reply = false if empty addresses were found.</span>
<a name="l03404"></a>03404 <span class="comment"> */</span>
<a name="l03405"></a>03405 EmailAddressList& EmailAddressList::operator=(<span class="keyword">const</span> QValueList<Person>& addresses)
<a name="l03406"></a>03406 {
<a name="l03407"></a>03407 clear();
<a name="l03408"></a>03408 <span class="keywordflow">for</span> (QValueList<Person>::ConstIterator it = addresses.begin(); it != addresses.end(); ++it)
<a name="l03409"></a>03409 {
<a name="l03410"></a>03410 <span class="keywordflow">if</span> (!(*it).email().isEmpty())
<a name="l03411"></a>03411 append(*it);
<a name="l03412"></a>03412 }
<a name="l03413"></a>03413 <span class="keywordflow">return</span> *<span class="keyword">this</span>;
<a name="l03414"></a>03414 }
<a name="l03415"></a>03415
<a name="l03416"></a>03416 <span class="comment">/******************************************************************************</span>
<a name="l03417"></a>03417 <span class="comment"> * Return the email address list as a string, each address being delimited by</span>
<a name="l03418"></a>03418 <span class="comment"> * the specified separator string.</span>
<a name="l03419"></a>03419 <span class="comment"> */</span>
<a name="l03420"></a>03420 QString EmailAddressList::join(<span class="keyword">const</span> QString& separator)<span class="keyword"> const</span>
<a name="l03421"></a>03421 <span class="keyword"></span>{
<a name="l03422"></a>03422 QString result;
<a name="l03423"></a>03423 <span class="keywordtype">bool</span> first = <span class="keyword">true</span>;
<a name="l03424"></a>03424 <span class="keywordflow">for</span> (QValueList<Person>::ConstIterator it = begin(); it != end(); ++it)
<a name="l03425"></a>03425 {
<a name="l03426"></a>03426 <span class="keywordflow">if</span> (first)
<a name="l03427"></a>03427 first = <span class="keyword">false</span>;
<a name="l03428"></a>03428 <span class="keywordflow">else</span>
<a name="l03429"></a>03429 result += separator;
<a name="l03430"></a>03430
<a name="l03431"></a>03431 <span class="keywordtype">bool</span> quote = <span class="keyword">false</span>;
<a name="l03432"></a>03432 QString name = (*it).name();
<a name="l03433"></a>03433 <span class="keywordflow">if</span> (!name.isEmpty())
<a name="l03434"></a>03434 {
<a name="l03435"></a>03435 <span class="comment">// Need to enclose the name in quotes if it has any special characters</span>
<a name="l03436"></a>03436 <span class="keywordtype">int</span> len = name.length();
<a name="l03437"></a>03437 <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i < len; ++i)
<a name="l03438"></a>03438 {
<a name="l03439"></a>03439 QChar ch = name[i];
<a name="l03440"></a>03440 <span class="keywordflow">if</span> (!ch.isLetterOrNumber())
<a name="l03441"></a>03441 {
<a name="l03442"></a>03442 quote = <span class="keyword">true</span>;
<a name="l03443"></a>03443 result += <span class="charliteral">'\"'</span>;
<a name="l03444"></a>03444 <span class="keywordflow">break</span>;
<a name="l03445"></a>03445 }
<a name="l03446"></a>03446 }
<a name="l03447"></a>03447 result += (*it).name();
<a name="l03448"></a>03448 result += (quote ? <span class="stringliteral">"\" <"</span> : <span class="stringliteral">" <"</span>);
<a name="l03449"></a>03449 quote = <span class="keyword">true</span>; <span class="comment">// need angle brackets round email address</span>
<a name="l03450"></a>03450 }
<a name="l03451"></a>03451
<a name="l03452"></a>03452 result += (*it).email();
<a name="l03453"></a>03453 <span class="keywordflow">if</span> (quote)
<a name="l03454"></a>03454 result += <span class="charliteral">'>'</span>;
<a name="l03455"></a>03455 }
<a name="l03456"></a>03456 <span class="keywordflow">return</span> result;
<a name="l03457"></a>03457 }
<a name="l03458"></a>03458
<a name="l03459"></a>03459
<a name="l03460"></a>03460 <span class="comment">/*=============================================================================</span>
<a name="l03461"></a>03461 <span class="comment">= Static functions</span>
<a name="l03462"></a>03462 <span class="comment">=============================================================================*/</span>
<a name="l03463"></a>03463
<a name="l03464"></a>03464 <span class="comment">/******************************************************************************</span>
<a name="l03465"></a>03465 <span class="comment"> * Set the specified alarm to be a procedure alarm with the given command line.</span>
<a name="l03466"></a>03466 <span class="comment"> * The command line is first split into its program file and arguments before</span>
<a name="l03467"></a>03467 <span class="comment"> * initialising the alarm.</span>
<a name="l03468"></a>03468 <span class="comment"> */</span>
<a name="l03469"></a>03469 <span class="keyword">static</span> <span class="keywordtype">void</span> setProcedureAlarm(<a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html">Alarm</a>* alarm, <span class="keyword">const</span> QString& commandLine)
<a name="l03470"></a>03470 {
<a name="l03471"></a>03471 QString command = QString::null;
<a name="l03472"></a>03472 QString arguments = QString::null;
<a name="l03473"></a>03473 QChar quoteChar;
<a name="l03474"></a>03474 <span class="keywordtype">bool</span> quoted = <span class="keyword">false</span>;
<a name="l03475"></a>03475 uint posMax = commandLine.length();
<a name="l03476"></a>03476 uint pos;
<a name="l03477"></a>03477 <span class="keywordflow">for</span> (pos = 0; pos < posMax; ++pos)
<a name="l03478"></a>03478 {
<a name="l03479"></a>03479 QChar ch = commandLine[pos];
<a name="l03480"></a>03480 <span class="keywordflow">if</span> (quoted)
<a name="l03481"></a>03481 {
<a name="l03482"></a>03482 <span class="keywordflow">if</span> (ch == quoteChar)
<a name="l03483"></a>03483 {
<a name="l03484"></a>03484 ++pos; <span class="comment">// omit the quote character</span>
<a name="l03485"></a>03485 <span class="keywordflow">break</span>;
<a name="l03486"></a>03486 }
<a name="l03487"></a>03487 command += ch;
<a name="l03488"></a>03488 }
<a name="l03489"></a>03489 <span class="keywordflow">else</span>
<a name="l03490"></a>03490 {
<a name="l03491"></a>03491 <span class="keywordtype">bool</span> done = <span class="keyword">false</span>;
<a name="l03492"></a>03492 <span class="keywordflow">switch</span> (ch)
<a name="l03493"></a>03493 {
<a name="l03494"></a>03494 <span class="keywordflow">case</span> <span class="charliteral">' '</span>:
<a name="l03495"></a>03495 <span class="keywordflow">case</span> <span class="charliteral">';'</span>:
<a name="l03496"></a>03496 <span class="keywordflow">case</span> <span class="charliteral">'|'</span>:
<a name="l03497"></a>03497 <span class="keywordflow">case</span> <span class="charliteral">'<'</span>:
<a name="l03498"></a>03498 <span class="keywordflow">case</span> <span class="charliteral">'>'</span>:
<a name="l03499"></a>03499 done = !command.isEmpty();
<a name="l03500"></a>03500 <span class="keywordflow">break</span>;
<a name="l03501"></a>03501 <span class="keywordflow">case</span> <span class="charliteral">'\''</span>:
<a name="l03502"></a>03502 <span class="keywordflow">case</span> <span class="charliteral">'"'</span>:
<a name="l03503"></a>03503 <span class="keywordflow">if</span> (command.isEmpty())
<a name="l03504"></a>03504 {
<a name="l03505"></a>03505 <span class="comment">// Start of a quoted string. Omit the quote character.</span>
<a name="l03506"></a>03506 quoted = <span class="keyword">true</span>;
<a name="l03507"></a>03507 quoteChar = ch;
<a name="l03508"></a>03508 <span class="keywordflow">break</span>;
<a name="l03509"></a>03509 }
<a name="l03510"></a>03510 <span class="comment">// fall through to default</span>
<a name="l03511"></a>03511 <span class="keywordflow">default</span>:
<a name="l03512"></a>03512 command += ch;
<a name="l03513"></a>03513 <span class="keywordflow">break</span>;
<a name="l03514"></a>03514 }
<a name="l03515"></a>03515 <span class="keywordflow">if</span> (done)
<a name="l03516"></a>03516 <span class="keywordflow">break</span>;
<a name="l03517"></a>03517 }
<a name="l03518"></a>03518 }
<a name="l03519"></a>03519
<a name="l03520"></a>03520 <span class="comment">// Skip any spaces after the command</span>
<a name="l03521"></a>03521 <span class="keywordflow">for</span> ( ; pos < posMax && commandLine[pos] == <span class="charliteral">' '</span>; ++pos) ;
<a name="l03522"></a>03522 arguments = commandLine.mid(pos);
<a name="l03523"></a>03523
<a name="l03524"></a>03524 alarm-><a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Alarm.html#bd324dae3fec9d6a03468afab92f71ca">setProcedureAlarm</a>(command, arguments);
<a name="l03525"></a>03525 }
</pre></div></div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kalarm</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</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="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="classAlarmCalendar.html">alarmcalendar</option>, <option value="classKAEvent.html">kaevent</option>, <option value="classKAlarmIface.html">kalarmiface</option>, <option value="classMainWindowBase.html">mainwindowbase</option>, <option value="classMessageWin.html">messagewin</option>, <option value="classPickFileRadio.html">pickfileradio</option>, <option value="classStartOfDayTimer.html">startofdaytimer</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> <a href="../../akregator/src/html/index.html">src</a></li><li> <a href="../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../certmanager/html/index.html">certmanager</a></li><li> <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> <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> <a href="../../kioslaves/imap4/html/index.html">imap4</a></li><li> <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> <a href="../../kpilot/kpilot/html/index.html">kpilot</a></li><li> <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="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">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>
