<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US"> <head> <title>libkcal: alarm.cpp Source File (libkcal)</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' /> <meta name="trademark" content="KDE e.V." /> <meta name="description" content="K Desktop Environment Homepage, KDE.org" /> <meta name="MSSmartTagsPreventParsing" content="true" /> <meta name="robots" content="all" /> <link rel="shortcut icon" href="../../favicon.ico" /> <link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" /> <style type="text/css"> <!-- hr { display: none; } #content h2 { margin-left: 0px; } table.mdTable { background-color: #f8f8f8; border: .2em solid #d7d7d7; } td.mdRow { padding: 8px 20px; } td.md { font-weight: bold; } td.mdname1 { font-weight: bold; color: #602020; } td.mdname { font-weight: bold; color: #602020; } --> </style> </head> <body> <div id="nav_header_top" align="right"> <a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a> <a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a> <span class="doNotDisplay">::</span> <img id="nav_header_logo_right" alt="" align="right" src="../../pimlogo.png" border="0" /> <div id="nav_header_title" align="left">KDE PIM API Reference</div> </div> <div id="nav_header_bottom" align="right"> <span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span> <div id="nav_header_bottom_left" style="text-align: left;"> / <a href="../../">API Reference</a> / <a href=".">libkcal</a> </div> </div> <table id="main" border="0" cellpadding="0" cellspacing="0" width="100%"> <tr> <td valign="top" class="menuheader" height="0"></td> <td id="contentcolumn" valign="top" rowspan="2" > <div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;"> <h2><a name="content"></a>libkcal</h2> <!-- Generated by Doxygen 1.5.5 --> <h1>alarm.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"> This file is part of libkcal.</span> <a name="l00003"></a>00003 <span class="comment"></span> <a name="l00004"></a>00004 <span class="comment"> Copyright (c) 1998 Preston Brown <pbrown@kde.org></span> <a name="l00005"></a>00005 <span class="comment"> Copyright (c) 2001 Cornelius Schumacher <schumacher@kde.org></span> <a name="l00006"></a>00006 <span class="comment"></span> <a name="l00007"></a>00007 <span class="comment"> This library is free software; you can redistribute it and/or</span> <a name="l00008"></a>00008 <span class="comment"> modify it under the terms of the GNU Library General Public</span> <a name="l00009"></a>00009 <span class="comment"> License as published by the Free Software Foundation; either</span> <a name="l00010"></a>00010 <span class="comment"> version 2 of the License, or (at your option) any later version.</span> <a name="l00011"></a>00011 <span class="comment"></span> <a name="l00012"></a>00012 <span class="comment"> This library is distributed in the hope that it will be useful,</span> <a name="l00013"></a>00013 <span class="comment"> but WITHOUT ANY WARRANTY; without even the implied warranty of</span> <a name="l00014"></a>00014 <span class="comment"> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span> <a name="l00015"></a>00015 <span class="comment"> Library General Public License for more details.</span> <a name="l00016"></a>00016 <span class="comment"></span> <a name="l00017"></a>00017 <span class="comment"> You should have received a copy of the GNU Library General Public License</span> <a name="l00018"></a>00018 <span class="comment"> along with this library; see the file COPYING.LIB. If not, write to</span> <a name="l00019"></a>00019 <span class="comment"> the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,</span> <a name="l00020"></a>00020 <span class="comment"> Boston, MA 02110-1301, USA.</span> <a name="l00021"></a>00021 <span class="comment">*/</span> <a name="l00022"></a>00022 <a name="l00023"></a>00023 <span class="preprocessor">#include <kdebug.h></span> <a name="l00024"></a>00024 <a name="l00025"></a>00025 <span class="preprocessor">#include "incidence.h"</span> <a name="l00026"></a>00026 <span class="preprocessor">#include "todo.h"</span> <a name="l00027"></a>00027 <a name="l00028"></a>00028 <span class="preprocessor">#include "alarm.h"</span> <a name="l00029"></a>00029 <a name="l00030"></a>00030 <span class="keyword">using namespace </span>KCal; <a name="l00031"></a>00031 <a name="l00032"></a><a class="code" href="classKCal_1_1Alarm.html#8a4f3b2d7117c2f0e8d1bd32702b24aa">00032</a> Alarm::Alarm(<a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *parent) <a name="l00033"></a>00033 : mParent(parent), <a name="l00034"></a>00034 mType(Invalid), <a name="l00035"></a>00035 mDescription(<span class="stringliteral">""</span>), <span class="comment">// to make operator==() not fail</span> <a name="l00036"></a>00036 mFile(<span class="stringliteral">""</span>), <span class="comment">// to make operator==() not fail</span> <a name="l00037"></a>00037 mMailSubject(<span class="stringliteral">""</span>), <span class="comment">// to make operator==() not fail</span> <a name="l00038"></a>00038 mAlarmSnoozeTime(5), <a name="l00039"></a>00039 mAlarmRepeatCount(0), <a name="l00040"></a>00040 mEndOffset(false), <a name="l00041"></a>00041 mHasTime(false), <a name="l00042"></a>00042 mAlarmEnabled(false) <a name="l00043"></a>00043 { <a name="l00044"></a>00044 } <a name="l00045"></a>00045 <a name="l00046"></a><a class="code" href="classKCal_1_1Alarm.html#db5fc73041badc6a082b78874559c002">00046</a> <a class="code" href="classKCal_1_1Alarm.html#db5fc73041badc6a082b78874559c002" title="Destruct Alarm object.">Alarm::~Alarm</a>() <a name="l00047"></a>00047 { <a name="l00048"></a>00048 } <a name="l00049"></a>00049 <a name="l00050"></a><a class="code" href="classKCal_1_1Alarm.html#f67f6aeca14983fbc8f0c85d07df3fea">00050</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Alarm.html#f67f6aeca14983fbc8f0c85d07df3fea" title="Compare this alarm with another one.">Alarm::operator==</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1Alarm.html" title="This class represents an alarm notification.">Alarm</a>& rhs )<span class="keyword"> const</span> <a name="l00051"></a>00051 <span class="keyword"></span>{ <a name="l00052"></a>00052 <span class="keywordflow">if</span> ( mType != rhs.<a class="code" href="classKCal_1_1Alarm.html#88f4e7d91eefd4190a6fd689146213d6">mType</a> || <a name="l00053"></a>00053 mAlarmSnoozeTime != rhs.<a class="code" href="classKCal_1_1Alarm.html#b4fa73ab00583072c9b89140a78d7a94">mAlarmSnoozeTime</a> || <a name="l00054"></a>00054 mAlarmRepeatCount != rhs.<a class="code" href="classKCal_1_1Alarm.html#3317e8b7f459fe9221695932bc5f7b69">mAlarmRepeatCount</a> || <a name="l00055"></a>00055 mAlarmEnabled != rhs.<a class="code" href="classKCal_1_1Alarm.html#7e30da30d122f673d91e46161acfbab8">mAlarmEnabled</a> || <a name="l00056"></a>00056 mHasTime != rhs.<a class="code" href="classKCal_1_1Alarm.html#4e167443b60f8e529e7b0decd841abfc">mHasTime</a>) <a name="l00057"></a>00057 <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00058"></a>00058 <a name="l00059"></a>00059 <span class="keywordflow">if</span> (mHasTime) { <a name="l00060"></a>00060 <span class="keywordflow">if</span> (mAlarmTime != rhs.<a class="code" href="classKCal_1_1Alarm.html#f1ed8d1d0e9e13e5dc2e3ac901682bf3">mAlarmTime</a>) <a name="l00061"></a>00061 <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00062"></a>00062 } <span class="keywordflow">else</span> { <a name="l00063"></a>00063 <span class="keywordflow">if</span> (mOffset != rhs.<a class="code" href="classKCal_1_1Alarm.html#a727af2c2881258923b84b02e4f73124">mOffset</a> || <a name="l00064"></a>00064 mEndOffset != rhs.<a class="code" href="classKCal_1_1Alarm.html#992d82a097384264d69333ba377f4f5a">mEndOffset</a>) <a name="l00065"></a>00065 <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00066"></a>00066 } <a name="l00067"></a>00067 <a name="l00068"></a>00068 <span class="keywordflow">switch</span> (mType) { <a name="l00069"></a>00069 <span class="keywordflow">case</span> Display: <a name="l00070"></a>00070 <span class="keywordflow">return</span> mDescription == rhs.<a class="code" href="classKCal_1_1Alarm.html#27f22657ffe104795e2e78082cf7f795">mDescription</a>; <a name="l00071"></a>00071 <a name="l00072"></a>00072 <span class="keywordflow">case</span> Email: <a name="l00073"></a>00073 <span class="keywordflow">return</span> mDescription == rhs.<a class="code" href="classKCal_1_1Alarm.html#27f22657ffe104795e2e78082cf7f795">mDescription</a> && <a name="l00074"></a>00074 mMailAttachFiles == rhs.<a class="code" href="classKCal_1_1Alarm.html#a6f2070f82da14b7d4837b0fcdf4be0b">mMailAttachFiles</a> && <a name="l00075"></a>00075 mMailAddresses == rhs.<a class="code" href="classKCal_1_1Alarm.html#991ded2d40dec04cda038e37759cac06">mMailAddresses</a> && <a name="l00076"></a>00076 mMailSubject == rhs.<a class="code" href="classKCal_1_1Alarm.html#0cac3a16b5c989ff134e6eff1a7b3b3f">mMailSubject</a>; <a name="l00077"></a>00077 <a name="l00078"></a>00078 <span class="keywordflow">case</span> Procedure: <a name="l00079"></a>00079 <span class="keywordflow">return</span> mFile == rhs.<a class="code" href="classKCal_1_1Alarm.html#3a9e30f5b8b5e88d7f68946efe27ec15">mFile</a> && <a name="l00080"></a>00080 mDescription == rhs.<a class="code" href="classKCal_1_1Alarm.html#27f22657ffe104795e2e78082cf7f795">mDescription</a>; <a name="l00081"></a>00081 <a name="l00082"></a>00082 <span class="keywordflow">case</span> Audio: <a name="l00083"></a>00083 <span class="keywordflow">return</span> mFile == rhs.<a class="code" href="classKCal_1_1Alarm.html#3a9e30f5b8b5e88d7f68946efe27ec15">mFile</a>; <a name="l00084"></a>00084 <a name="l00085"></a>00085 <span class="keywordflow">case</span> Invalid: <a name="l00086"></a>00086 <span class="keywordflow">break</span>; <a name="l00087"></a>00087 } <a name="l00088"></a>00088 <span class="keywordflow">return</span> <span class="keyword">false</span>; <a name="l00089"></a>00089 } <a name="l00090"></a>00090 <a name="l00091"></a><a class="code" href="classKCal_1_1Alarm.html#d0c36260969d2f6b87d5dd726a6aad70">00091</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#d0c36260969d2f6b87d5dd726a6aad70" title="Set the type of the alarm.">Alarm::setType</a>(Alarm::Type <a class="code" href="classKCal_1_1Alarm.html#9cec3c8d0c2047ccb8334a54175ca7c7" title="Return the type of the alarm.">type</a>) <a name="l00092"></a>00092 { <a name="l00093"></a>00093 <span class="keywordflow">if</span> (type == mType) <a name="l00094"></a>00094 <span class="keywordflow">return</span>; <a name="l00095"></a>00095 <a name="l00096"></a>00096 <span class="keywordflow">switch</span> (type) { <a name="l00097"></a>00097 <span class="keywordflow">case</span> Display: <a name="l00098"></a>00098 mDescription = <span class="stringliteral">""</span>; <a name="l00099"></a>00099 <span class="keywordflow">break</span>; <a name="l00100"></a>00100 <span class="keywordflow">case</span> Procedure: <a name="l00101"></a>00101 mFile = mDescription = <span class="stringliteral">""</span>; <a name="l00102"></a>00102 <span class="keywordflow">break</span>; <a name="l00103"></a>00103 <span class="keywordflow">case</span> Audio: <a name="l00104"></a>00104 mFile = <span class="stringliteral">""</span>; <a name="l00105"></a>00105 <span class="keywordflow">break</span>; <a name="l00106"></a>00106 <span class="keywordflow">case</span> Email: <a name="l00107"></a>00107 mMailSubject = mDescription = <span class="stringliteral">""</span>; <a name="l00108"></a>00108 mMailAddresses.clear(); <a name="l00109"></a>00109 mMailAttachFiles.clear(); <a name="l00110"></a>00110 <span class="keywordflow">break</span>; <a name="l00111"></a>00111 <span class="keywordflow">case</span> Invalid: <a name="l00112"></a>00112 <span class="keywordflow">break</span>; <a name="l00113"></a>00113 <span class="keywordflow">default</span>: <a name="l00114"></a>00114 <span class="keywordflow">return</span>; <a name="l00115"></a>00115 } <a name="l00116"></a>00116 mType = type; <a name="l00117"></a>00117 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00118"></a>00118 } <a name="l00119"></a>00119 <a name="l00120"></a><a class="code" href="classKCal_1_1Alarm.html#9cec3c8d0c2047ccb8334a54175ca7c7">00120</a> Alarm::Type <a class="code" href="classKCal_1_1Alarm.html#9cec3c8d0c2047ccb8334a54175ca7c7" title="Return the type of the alarm.">Alarm::type</a>()<span class="keyword"> const</span> <a name="l00121"></a>00121 <span class="keyword"></span>{ <a name="l00122"></a>00122 <span class="keywordflow">return</span> mType; <a name="l00123"></a>00123 } <a name="l00124"></a>00124 <a name="l00125"></a><a class="code" href="classKCal_1_1Alarm.html#6d51811cf873f4935071746d264d104f">00125</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#6d51811cf873f4935071746d264d104f" title="Set the alarm to be an audio alarm.">Alarm::setAudioAlarm</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#a9a5cefa19499ffc3f6fbfc7a07cfcb9" title="Return the name of the audio file for the alarm.">audioFile</a>) <a name="l00126"></a>00126 { <a name="l00127"></a>00127 mType = Audio; <a name="l00128"></a>00128 mFile = audioFile; <a name="l00129"></a>00129 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00130"></a>00130 } <a name="l00131"></a>00131 <a name="l00132"></a><a class="code" href="classKCal_1_1Alarm.html#71416b5d4a5596a5d10e40ea0c3db21e">00132</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#71416b5d4a5596a5d10e40ea0c3db21e" title="Set the file to play when the audio alarm is triggered.">Alarm::setAudioFile</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#a9a5cefa19499ffc3f6fbfc7a07cfcb9" title="Return the name of the audio file for the alarm.">audioFile</a>) <a name="l00133"></a>00133 { <a name="l00134"></a>00134 <span class="keywordflow">if</span> (mType == Audio) { <a name="l00135"></a>00135 mFile = audioFile; <a name="l00136"></a>00136 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00137"></a>00137 } <a name="l00138"></a>00138 } <a name="l00139"></a>00139 <a name="l00140"></a><a class="code" href="classKCal_1_1Alarm.html#a9a5cefa19499ffc3f6fbfc7a07cfcb9">00140</a> QString <a class="code" href="classKCal_1_1Alarm.html#a9a5cefa19499ffc3f6fbfc7a07cfcb9" title="Return the name of the audio file for the alarm.">Alarm::audioFile</a>()<span class="keyword"> const</span> <a name="l00141"></a>00141 <span class="keyword"></span>{ <a name="l00142"></a>00142 <span class="keywordflow">return</span> (mType == Audio) ? mFile : QString::null; <a name="l00143"></a>00143 } <a name="l00144"></a>00144 <a name="l00145"></a><a class="code" href="classKCal_1_1Alarm.html#bd324dae3fec9d6a03468afab92f71ca">00145</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#bd324dae3fec9d6a03468afab92f71ca" title="Set the alarm to be a procedure alarm.">Alarm::setProcedureAlarm</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#3bf09593c90acb290202c9cec3e439bc" title="Return the name of the program file to execute when the alarm is triggered.">programFile</a>, <span class="keyword">const</span> QString &arguments) <a name="l00146"></a>00146 { <a name="l00147"></a>00147 mType = Procedure; <a name="l00148"></a>00148 mFile = programFile; <a name="l00149"></a>00149 mDescription = arguments; <a name="l00150"></a>00150 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00151"></a>00151 } <a name="l00152"></a>00152 <a name="l00153"></a><a class="code" href="classKCal_1_1Alarm.html#5d62f1442ed562f9d35563211b150b92">00153</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#5d62f1442ed562f9d35563211b150b92" title="Set the program file to execute when the alarm is triggered.">Alarm::setProgramFile</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#3bf09593c90acb290202c9cec3e439bc" title="Return the name of the program file to execute when the alarm is triggered.">programFile</a>) <a name="l00154"></a>00154 { <a name="l00155"></a>00155 <span class="keywordflow">if</span> (mType == Procedure) { <a name="l00156"></a>00156 mFile = programFile; <a name="l00157"></a>00157 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00158"></a>00158 } <a name="l00159"></a>00159 } <a name="l00160"></a>00160 <a name="l00161"></a><a class="code" href="classKCal_1_1Alarm.html#3bf09593c90acb290202c9cec3e439bc">00161</a> QString <a class="code" href="classKCal_1_1Alarm.html#3bf09593c90acb290202c9cec3e439bc" title="Return the name of the program file to execute when the alarm is triggered.">Alarm::programFile</a>()<span class="keyword"> const</span> <a name="l00162"></a>00162 <span class="keyword"></span>{ <a name="l00163"></a>00163 <span class="keywordflow">return</span> (mType == Procedure) ? mFile : QString::null; <a name="l00164"></a>00164 } <a name="l00165"></a>00165 <a name="l00166"></a><a class="code" href="classKCal_1_1Alarm.html#8a3cbb2e45e00c5ba4a8cda32a4d645b">00166</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#8a3cbb2e45e00c5ba4a8cda32a4d645b" title="Set the arguments to the program to execute when the alarm is triggered.">Alarm::setProgramArguments</a>(<span class="keyword">const</span> QString &arguments) <a name="l00167"></a>00167 { <a name="l00168"></a>00168 <span class="keywordflow">if</span> (mType == Procedure) { <a name="l00169"></a>00169 mDescription = arguments; <a name="l00170"></a>00170 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00171"></a>00171 } <a name="l00172"></a>00172 } <a name="l00173"></a>00173 <a name="l00174"></a><a class="code" href="classKCal_1_1Alarm.html#e7fe383484dbef6c456b71c08e62c783">00174</a> QString <a class="code" href="classKCal_1_1Alarm.html#e7fe383484dbef6c456b71c08e62c783" title="Return the arguments to the program to run when the alarm is triggered.">Alarm::programArguments</a>()<span class="keyword"> const</span> <a name="l00175"></a>00175 <span class="keyword"></span>{ <a name="l00176"></a>00176 <span class="keywordflow">return</span> (mType == Procedure) ? mDescription : QString::null; <a name="l00177"></a>00177 } <a name="l00178"></a>00178 <a name="l00179"></a><a class="code" href="classKCal_1_1Alarm.html#ba6b152a45400ca8bd76af3229dc3300">00179</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#ba6b152a45400ca8bd76af3229dc3300" title="Set the alarm to be an email alarm.">Alarm::setEmailAlarm</a>(<span class="keyword">const</span> QString &subject, <span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079" title="Return the text string that displays when the alarm is triggered.">text</a>, <a name="l00180"></a>00180 <span class="keyword">const</span> QValueList<Person> &addressees, <span class="keyword">const</span> QStringList &attachments) <a name="l00181"></a>00181 { <a name="l00182"></a>00182 mType = Email; <a name="l00183"></a>00183 mMailSubject = subject; <a name="l00184"></a>00184 mDescription = text; <a name="l00185"></a>00185 mMailAddresses = addressees; <a name="l00186"></a>00186 mMailAttachFiles = attachments; <a name="l00187"></a>00187 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00188"></a>00188 } <a name="l00189"></a>00189 <a name="l00190"></a><a class="code" href="classKCal_1_1Alarm.html#1a01c6097dc44b489c3dd8dfec8a316c">00190</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#1a01c6097dc44b489c3dd8dfec8a316c" title="Send mail to this address when the alarm is triggered.">Alarm::setMailAddress</a>(<span class="keyword">const</span> <a class="code" href="classKCal_1_1Person.html" title="This class represents a person.">Person</a> &mailAddress) <a name="l00191"></a>00191 { <a name="l00192"></a>00192 <span class="keywordflow">if</span> (mType == Email) { <a name="l00193"></a>00193 mMailAddresses.clear(); <a name="l00194"></a>00194 mMailAddresses += mailAddress; <a name="l00195"></a>00195 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00196"></a>00196 } <a name="l00197"></a>00197 } <a name="l00198"></a>00198 <a name="l00199"></a><a class="code" href="classKCal_1_1Alarm.html#d656f51f8285a398994009b9d1ad81ed">00199</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#d656f51f8285a398994009b9d1ad81ed" title="Send mail to these addresses when the alarm is triggered.">Alarm::setMailAddresses</a>(<span class="keyword">const</span> QValueList<Person> &<a class="code" href="classKCal_1_1Alarm.html#cfe761563112e143ae1b87c31181a69f" title="Return the addresses to send mail to when an alarm goes off.">mailAddresses</a>) <a name="l00200"></a>00200 { <a name="l00201"></a>00201 <span class="keywordflow">if</span> (mType == Email) { <a name="l00202"></a>00202 mMailAddresses = mailAddresses; <a name="l00203"></a>00203 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00204"></a>00204 } <a name="l00205"></a>00205 } <a name="l00206"></a>00206 <a name="l00207"></a><a class="code" href="classKCal_1_1Alarm.html#3dcb22df069befff3b09d81eced0cda8">00207</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#3dcb22df069befff3b09d81eced0cda8" title="Add this address to the list of addresses to send mail to when the alarm is triggered...">Alarm::addMailAddress</a>(<span class="keyword">const</span> <a class="code" href="classKCal_1_1Person.html" title="This class represents a person.">Person</a> &mailAddress) <a name="l00208"></a>00208 { <a name="l00209"></a>00209 <span class="keywordflow">if</span> (mType == Email) { <a name="l00210"></a>00210 mMailAddresses += mailAddress; <a name="l00211"></a>00211 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00212"></a>00212 } <a name="l00213"></a>00213 } <a name="l00214"></a>00214 <a name="l00215"></a><a class="code" href="classKCal_1_1Alarm.html#cfe761563112e143ae1b87c31181a69f">00215</a> QValueList<Person> <a class="code" href="classKCal_1_1Alarm.html#cfe761563112e143ae1b87c31181a69f" title="Return the addresses to send mail to when an alarm goes off.">Alarm::mailAddresses</a>()<span class="keyword"> const</span> <a name="l00216"></a>00216 <span class="keyword"></span>{ <a name="l00217"></a>00217 <span class="keywordflow">return</span> (mType == Email) ? mMailAddresses : QValueList<Person>(); <a name="l00218"></a>00218 } <a name="l00219"></a>00219 <a name="l00220"></a><a class="code" href="classKCal_1_1Alarm.html#70870e440f6fba53d8edd2f280b3111d">00220</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#70870e440f6fba53d8edd2f280b3111d" title="Set the subject line of the mail.">Alarm::setMailSubject</a>(<span class="keyword">const</span> QString &mailAlarmSubject) <a name="l00221"></a>00221 { <a name="l00222"></a>00222 <span class="keywordflow">if</span> (mType == Email) { <a name="l00223"></a>00223 mMailSubject = mailAlarmSubject; <a name="l00224"></a>00224 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00225"></a>00225 } <a name="l00226"></a>00226 } <a name="l00227"></a>00227 <a name="l00228"></a><a class="code" href="classKCal_1_1Alarm.html#79ea9526501296c068667e89fb51a066">00228</a> QString <a class="code" href="classKCal_1_1Alarm.html#79ea9526501296c068667e89fb51a066" title="Return the subject line of the mail.">Alarm::mailSubject</a>()<span class="keyword"> const</span> <a name="l00229"></a>00229 <span class="keyword"></span>{ <a name="l00230"></a>00230 <span class="keywordflow">return</span> (mType == Email) ? mMailSubject : QString::null; <a name="l00231"></a>00231 } <a name="l00232"></a>00232 <a name="l00233"></a><a class="code" href="classKCal_1_1Alarm.html#41ad6582a988817ddd73b2f454a89579">00233</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#41ad6582a988817ddd73b2f454a89579" title="Attach this filename to the email.">Alarm::setMailAttachment</a>(<span class="keyword">const</span> QString &mailAttachFile) <a name="l00234"></a>00234 { <a name="l00235"></a>00235 <span class="keywordflow">if</span> (mType == Email) { <a name="l00236"></a>00236 mMailAttachFiles.clear(); <a name="l00237"></a>00237 mMailAttachFiles += mailAttachFile; <a name="l00238"></a>00238 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00239"></a>00239 } <a name="l00240"></a>00240 } <a name="l00241"></a>00241 <a name="l00242"></a><a class="code" href="classKCal_1_1Alarm.html#d01dadb4ea094d6e3091dfed52c36fec">00242</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#d01dadb4ea094d6e3091dfed52c36fec" title="Attach these filenames to the email.">Alarm::setMailAttachments</a>(<span class="keyword">const</span> QStringList &mailAttachFiles) <a name="l00243"></a>00243 { <a name="l00244"></a>00244 <span class="keywordflow">if</span> (mType == Email) { <a name="l00245"></a>00245 mMailAttachFiles = mailAttachFiles; <a name="l00246"></a>00246 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00247"></a>00247 } <a name="l00248"></a>00248 } <a name="l00249"></a>00249 <a name="l00250"></a><a class="code" href="classKCal_1_1Alarm.html#a7d6006ce3c56dc6969e3a7c043c1d63">00250</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#a7d6006ce3c56dc6969e3a7c043c1d63" title="Add this filename to the list of files to attach to the email.">Alarm::addMailAttachment</a>(<span class="keyword">const</span> QString &mailAttachFile) <a name="l00251"></a>00251 { <a name="l00252"></a>00252 <span class="keywordflow">if</span> (mType == Email) { <a name="l00253"></a>00253 mMailAttachFiles += mailAttachFile; <a name="l00254"></a>00254 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00255"></a>00255 } <a name="l00256"></a>00256 } <a name="l00257"></a>00257 <a name="l00258"></a><a class="code" href="classKCal_1_1Alarm.html#06971aa042d50e6f4a0349b8ad566464">00258</a> QStringList <a class="code" href="classKCal_1_1Alarm.html#06971aa042d50e6f4a0349b8ad566464" title="Return the filenames to attach to the email.">Alarm::mailAttachments</a>()<span class="keyword"> const</span> <a name="l00259"></a>00259 <span class="keyword"></span>{ <a name="l00260"></a>00260 <span class="keywordflow">return</span> (mType == Email) ? mMailAttachFiles : QStringList(); <a name="l00261"></a>00261 } <a name="l00262"></a>00262 <a name="l00263"></a><a class="code" href="classKCal_1_1Alarm.html#fa55f36170722669c8a324dec20350bf">00263</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#fa55f36170722669c8a324dec20350bf" title="Set the email body text.">Alarm::setMailText</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079" title="Return the text string that displays when the alarm is triggered.">text</a>) <a name="l00264"></a>00264 { <a name="l00265"></a>00265 <span class="keywordflow">if</span> (mType == Email) { <a name="l00266"></a>00266 mDescription = text; <a name="l00267"></a>00267 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00268"></a>00268 } <a name="l00269"></a>00269 } <a name="l00270"></a>00270 <a name="l00271"></a><a class="code" href="classKCal_1_1Alarm.html#0ce0f2a11a68c9d8649eeb4bca3aec89">00271</a> QString <a class="code" href="classKCal_1_1Alarm.html#0ce0f2a11a68c9d8649eeb4bca3aec89" title="Return the email body text.">Alarm::mailText</a>()<span class="keyword"> const</span> <a name="l00272"></a>00272 <span class="keyword"></span>{ <a name="l00273"></a>00273 <span class="keywordflow">return</span> (mType == Email) ? mDescription : QString::null; <a name="l00274"></a>00274 } <a name="l00275"></a>00275 <a name="l00276"></a><a class="code" href="classKCal_1_1Alarm.html#b5b69003ad8ad9450b8f4f542c234a8d">00276</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#b5b69003ad8ad9450b8f4f542c234a8d" title="Set the alarm to be a display alarm.">Alarm::setDisplayAlarm</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079" title="Return the text string that displays when the alarm is triggered.">text</a>) <a name="l00277"></a>00277 { <a name="l00278"></a>00278 mType = Display; <a name="l00279"></a>00279 <span class="keywordflow">if</span> ( !text.isNull() ) <a name="l00280"></a>00280 mDescription = text; <a name="l00281"></a>00281 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00282"></a>00282 } <a name="l00283"></a>00283 <a name="l00284"></a><a class="code" href="classKCal_1_1Alarm.html#56d43a82b12b6f8839c9f190ab9b096d">00284</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#56d43a82b12b6f8839c9f190ab9b096d" title="Set the text to be displayed when the alarm is triggered.">Alarm::setText</a>(<span class="keyword">const</span> QString &<a class="code" href="classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079" title="Return the text string that displays when the alarm is triggered.">text</a>) <a name="l00285"></a>00285 { <a name="l00286"></a>00286 <span class="keywordflow">if</span> (mType == Display) { <a name="l00287"></a>00287 mDescription = text; <a name="l00288"></a>00288 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00289"></a>00289 } <a name="l00290"></a>00290 } <a name="l00291"></a>00291 <a name="l00292"></a><a class="code" href="classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079">00292</a> QString <a class="code" href="classKCal_1_1Alarm.html#f8bd9d4bbe262bec35f6a8b6c5edf079" title="Return the text string that displays when the alarm is triggered.">Alarm::text</a>()<span class="keyword"> const</span> <a name="l00293"></a>00293 <span class="keyword"></span>{ <a name="l00294"></a>00294 <span class="keywordflow">return</span> (mType == Display) ? mDescription : QString::null; <a name="l00295"></a>00295 } <a name="l00296"></a>00296 <a name="l00297"></a><a class="code" href="classKCal_1_1Alarm.html#148abaa601477be008ce0ac348336084">00297</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#148abaa601477be008ce0ac348336084" title="Set the time to trigger an alarm.">Alarm::setTime</a>(<span class="keyword">const</span> QDateTime &alarmTime) <a name="l00298"></a>00298 { <a name="l00299"></a>00299 mAlarmTime = alarmTime; <a name="l00300"></a>00300 mHasTime = <span class="keyword">true</span>; <a name="l00301"></a>00301 <a name="l00302"></a>00302 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00303"></a>00303 } <a name="l00304"></a>00304 <a name="l00305"></a><a class="code" href="classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb">00305</a> QDateTime <a class="code" href="classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb" title="Return the date/time when an alarm goes off.">Alarm::time</a>()<span class="keyword"> const</span> <a name="l00306"></a>00306 <span class="keyword"></span>{ <a name="l00307"></a>00307 <span class="keywordflow">if</span> ( <a class="code" href="classKCal_1_1Alarm.html#096ea538fb51db902c86c9ea3ba9d23d" title="Return true, if the alarm has an explicit date/time.">hasTime</a>() ) <a name="l00308"></a>00308 <span class="keywordflow">return</span> mAlarmTime; <a name="l00309"></a>00309 <span class="keywordflow">else</span> <span class="keywordflow">if</span> ( mParent ) <a name="l00310"></a>00310 { <a name="l00311"></a>00311 <span class="keywordflow">if</span> (mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#7981c13389e270b9e3e06a79d8564d5b">type</a>()==<span class="stringliteral">"Todo"</span>) { <a name="l00312"></a>00312 <a class="code" href="classKCal_1_1Todo.html" title="This class provides a Todo in the sense of RFC2445.">Todo</a> *t = <span class="keyword">static_cast<</span><a class="code" href="classKCal_1_1Todo.html" title="This class provides a Todo in the sense of RFC2445.">Todo</a>*<span class="keyword">></span>(mParent); <a name="l00313"></a>00313 <span class="keywordflow">return</span> mOffset.<a class="code" href="classKCal_1_1Duration.html#583d2923d2f0e6588213c3f5f8cd3808">end</a>( t-><a class="code" href="classKCal_1_1Todo.html#09d6933ae42390339b27053faee3afec" title="Returns due date and time.">dtDue</a>() ); <a name="l00314"></a>00314 } <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mEndOffset) { <a name="l00315"></a>00315 <span class="keywordflow">return</span> mOffset.<a class="code" href="classKCal_1_1Duration.html#583d2923d2f0e6588213c3f5f8cd3808">end</a>( mParent-><a class="code" href="classKCal_1_1Incidence.html#de746f2e79686208c0d1238977d6a797" title="Return the incidence&#39;s ending date/time as a QDateTime.">dtEnd</a>() ); <a name="l00316"></a>00316 } <span class="keywordflow">else</span> { <a name="l00317"></a>00317 <span class="keywordflow">return</span> mOffset.<a class="code" href="classKCal_1_1Duration.html#583d2923d2f0e6588213c3f5f8cd3808">end</a>( mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#5419a946a4e5715a0c34ec2c7e04cd9b" title="returns an event&#39;s starting date/time as a QDateTime.">dtStart</a>() ); <a name="l00318"></a>00318 } <a name="l00319"></a>00319 } <span class="keywordflow">else</span> <span class="keywordflow">return</span> QDateTime(); <a name="l00320"></a>00320 } <a name="l00321"></a>00321 <a name="l00322"></a><a class="code" href="classKCal_1_1Alarm.html#096ea538fb51db902c86c9ea3ba9d23d">00322</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Alarm.html#096ea538fb51db902c86c9ea3ba9d23d" title="Return true, if the alarm has an explicit date/time.">Alarm::hasTime</a>()<span class="keyword"> const</span> <a name="l00323"></a>00323 <span class="keyword"></span>{ <a name="l00324"></a>00324 <span class="keywordflow">return</span> mHasTime; <a name="l00325"></a>00325 } <a name="l00326"></a>00326 <a name="l00327"></a><a class="code" href="classKCal_1_1Alarm.html#5b32099b4b802027e4b75767f48f73df">00327</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#5b32099b4b802027e4b75767f48f73df" title="Set the interval between snoozes for the alarm.">Alarm::setSnoozeTime</a>(<span class="keywordtype">int</span> alarmSnoozeTime) <a name="l00328"></a>00328 { <a name="l00329"></a>00329 <span class="keywordflow">if</span> (alarmSnoozeTime > 0) { <a name="l00330"></a>00330 mAlarmSnoozeTime = alarmSnoozeTime; <a name="l00331"></a>00331 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00332"></a>00332 } <a name="l00333"></a>00333 } <a name="l00334"></a>00334 <a name="l00335"></a><a class="code" href="classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c">00335</a> <span class="keywordtype">int</span> <a class="code" href="classKCal_1_1Alarm.html#716673277cd34a2c8c1a75e28989bf8c" title="Get how long the alarm snooze interval is.">Alarm::snoozeTime</a>()<span class="keyword"> const</span> <a name="l00336"></a>00336 <span class="keyword"></span>{ <a name="l00337"></a>00337 <span class="keywordflow">return</span> mAlarmSnoozeTime; <a name="l00338"></a>00338 } <a name="l00339"></a>00339 <a name="l00340"></a><a class="code" href="classKCal_1_1Alarm.html#25af13606c653d0009e5559bdad78ff3">00340</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#25af13606c653d0009e5559bdad78ff3" title="Set how many times an alarm is to repeat itself after its initial occurrence (w/snoozes)...">Alarm::setRepeatCount</a>(<span class="keywordtype">int</span> alarmRepeatCount) <a name="l00341"></a>00341 { <a name="l00342"></a>00342 mAlarmRepeatCount = alarmRepeatCount; <a name="l00343"></a>00343 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00344"></a>00344 } <a name="l00345"></a>00345 <a name="l00346"></a><a class="code" href="classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7">00346</a> <span class="keywordtype">int</span> <a class="code" href="classKCal_1_1Alarm.html#dec5b6aa7f9e0077f781b57edf7dc7c7" title="Get how many times an alarm repeats, after its initial occurrence.">Alarm::repeatCount</a>()<span class="keyword"> const</span> <a name="l00347"></a>00347 <span class="keyword"></span>{ <a name="l00348"></a>00348 <span class="keywordflow">return</span> mAlarmRepeatCount; <a name="l00349"></a>00349 } <a name="l00350"></a>00350 <a name="l00351"></a><a class="code" href="classKCal_1_1Alarm.html#5678a5addab945afeee2c09f4103eb0e">00351</a> <span class="keywordtype">int</span> <a class="code" href="classKCal_1_1Alarm.html#5678a5addab945afeee2c09f4103eb0e" title="Get how long between the alarm&#39;s initial occurrence and its final repetition...">Alarm::duration</a>()<span class="keyword"> const</span> <a name="l00352"></a>00352 <span class="keyword"></span>{ <a name="l00353"></a>00353 <span class="keywordflow">return</span> mAlarmRepeatCount * mAlarmSnoozeTime * 60; <a name="l00354"></a>00354 } <a name="l00355"></a>00355 <a name="l00356"></a><a class="code" href="classKCal_1_1Alarm.html#c27cdde359ab997b2aecfebf46804b64">00356</a> QDateTime <a class="code" href="classKCal_1_1Alarm.html#c27cdde359ab997b2aecfebf46804b64" title="Get the time of the alarm&#39;s initial occurrence or its next repetition, after...">Alarm::nextRepetition</a>(<span class="keyword">const</span> QDateTime& preTime)<span class="keyword"> const</span> <a name="l00357"></a>00357 <span class="keyword"></span>{ <a name="l00358"></a>00358 <span class="comment">// This method is coded to avoid 32-bit integer overflow using</span> <a name="l00359"></a>00359 <span class="comment">// QDateTime::secsTo(), which occurs with time spans > 68 years.</span> <a name="l00360"></a>00360 QDateTime at = <a class="code" href="classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb" title="Return the date/time when an alarm goes off.">time</a>(); <a name="l00361"></a>00361 <span class="keywordflow">if</span> (at > preTime) <a name="l00362"></a>00362 <span class="keywordflow">return</span> at; <a name="l00363"></a>00363 <span class="keywordflow">if</span> (!mAlarmRepeatCount) <a name="l00364"></a>00364 <span class="keywordflow">return</span> QDateTime(); <span class="comment">// there isn't an occurrence after the specified time</span> <a name="l00365"></a>00365 <span class="keywordtype">int</span> snoozeSecs = mAlarmSnoozeTime * 60; <a name="l00366"></a>00366 QDateTime lastRepetition = at.addSecs(mAlarmRepeatCount * snoozeSecs); <a name="l00367"></a>00367 <span class="keywordflow">if</span> (lastRepetition <= preTime) <a name="l00368"></a>00368 <span class="keywordflow">return</span> QDateTime(); <span class="comment">// all repetitions have finished before the specified time</span> <a name="l00369"></a>00369 <span class="keywordtype">int</span> repetition = (at.secsTo(preTime) + snoozeSecs) / snoozeSecs; <a name="l00370"></a>00370 <span class="keywordflow">return</span> at.addSecs(repetition * snoozeSecs); <a name="l00371"></a>00371 } <a name="l00372"></a>00372 <a name="l00373"></a><a class="code" href="classKCal_1_1Alarm.html#19b495cdeee823db123bf5297d67af4c">00373</a> QDateTime <a class="code" href="classKCal_1_1Alarm.html#19b495cdeee823db123bf5297d67af4c" title="Get the time of the alarm&#39;s latest repetition, or its initial occurrence if none...">Alarm::previousRepetition</a>(<span class="keyword">const</span> QDateTime& afterTime)<span class="keyword"> const</span> <a name="l00374"></a>00374 <span class="keyword"></span>{ <a name="l00375"></a>00375 <span class="comment">// This method is coded to avoid 32-bit integer overflow using</span> <a name="l00376"></a>00376 <span class="comment">// QDateTime::secsTo(), which occurs with time spans > 68 years.</span> <a name="l00377"></a>00377 QDateTime at = <a class="code" href="classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb" title="Return the date/time when an alarm goes off.">time</a>(); <a name="l00378"></a>00378 <span class="keywordflow">if</span> (at >= afterTime) <a name="l00379"></a>00379 <span class="keywordflow">return</span> QDateTime(); <span class="comment">// alarm's first/only time is at/after the specified time</span> <a name="l00380"></a>00380 <span class="keywordflow">if</span> (!mAlarmRepeatCount) <a name="l00381"></a>00381 <span class="keywordflow">return</span> at; <a name="l00382"></a>00382 <span class="keywordtype">int</span> snoozeSecs = mAlarmSnoozeTime * 60; <a name="l00383"></a>00383 QDateTime lastRepetition = at.addSecs(mAlarmRepeatCount * snoozeSecs); <a name="l00384"></a>00384 <span class="keywordflow">if</span> (lastRepetition < afterTime) <a name="l00385"></a>00385 <span class="keywordflow">return</span> lastRepetition; <span class="comment">// all repetitions have finished before the specified time</span> <a name="l00386"></a>00386 <span class="keywordtype">int</span> repetition = (at.secsTo(afterTime) - 1) / snoozeSecs; <a name="l00387"></a>00387 <span class="keywordflow">return</span> at.addSecs(repetition * snoozeSecs); <a name="l00388"></a>00388 } <a name="l00389"></a>00389 <a name="l00390"></a><a class="code" href="classKCal_1_1Alarm.html#256395172458b55dd60a828a72fe0da7">00390</a> QDateTime <a class="code" href="classKCal_1_1Alarm.html#256395172458b55dd60a828a72fe0da7" title="Return the date/time when the last repetition of the alarm goes off.">Alarm::endTime</a>()<span class="keyword"> const</span> <a name="l00391"></a>00391 <span class="keyword"></span>{ <a name="l00392"></a>00392 <span class="keywordflow">if</span> (mAlarmRepeatCount) <a name="l00393"></a>00393 <span class="keywordflow">return</span> <a class="code" href="classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb" title="Return the date/time when an alarm goes off.">time</a>().addSecs(mAlarmRepeatCount * mAlarmSnoozeTime * 60); <a name="l00394"></a>00394 <span class="keywordflow">else</span> <a name="l00395"></a>00395 <span class="keywordflow">return</span> <a class="code" href="classKCal_1_1Alarm.html#48d2224969fdefd53ab180e4db8b38fb" title="Return the date/time when an alarm goes off.">time</a>(); <a name="l00396"></a>00396 } <a name="l00397"></a>00397 <a name="l00398"></a><a class="code" href="classKCal_1_1Alarm.html#b85dc82e3fe4ecff6a61dd02cfbb0ef0">00398</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#b85dc82e3fe4ecff6a61dd02cfbb0ef0" title="Toggles the value of alarm to be either on or off.">Alarm::toggleAlarm</a>() <a name="l00399"></a>00399 { <a name="l00400"></a>00400 mAlarmEnabled = !mAlarmEnabled; <a name="l00401"></a>00401 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00402"></a>00402 } <a name="l00403"></a>00403 <a name="l00404"></a><a class="code" href="classKCal_1_1Alarm.html#2d8acc8bc95f7946afd32872eee96d83">00404</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#2d8acc8bc95f7946afd32872eee96d83" title="Set the alarm enabled status.">Alarm::setEnabled</a>(<span class="keywordtype">bool</span> enable) <a name="l00405"></a>00405 { <a name="l00406"></a>00406 mAlarmEnabled = enable; <a name="l00407"></a>00407 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00408"></a>00408 } <a name="l00409"></a>00409 <a name="l00410"></a><a class="code" href="classKCal_1_1Alarm.html#dcc94edf832e47bcc7825b6520dfe206">00410</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Alarm.html#dcc94edf832e47bcc7825b6520dfe206" title="Get the alarm enabled status.">Alarm::enabled</a>()<span class="keyword"> const</span> <a name="l00411"></a>00411 <span class="keyword"></span>{ <a name="l00412"></a>00412 <span class="keywordflow">return</span> mAlarmEnabled; <a name="l00413"></a>00413 } <a name="l00414"></a>00414 <a name="l00415"></a><a class="code" href="classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17">00415</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#a8a1584d8039829258846a3c7dfb9e17" title="Set offset of alarm in time relative to the start of the event.">Alarm::setStartOffset</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1Duration.html" title="This class represents a duration.">Duration</a> &offset ) <a name="l00416"></a>00416 { <a name="l00417"></a>00417 mOffset = offset; <a name="l00418"></a>00418 mEndOffset = <span class="keyword">false</span>; <a name="l00419"></a>00419 mHasTime = <span class="keyword">false</span>; <a name="l00420"></a>00420 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00421"></a>00421 } <a name="l00422"></a>00422 <a name="l00423"></a><a class="code" href="classKCal_1_1Alarm.html#3fdf5078feefc485a6d86d2f9c3e8d6a">00423</a> <a class="code" href="classKCal_1_1Duration.html" title="This class represents a duration.">Duration</a> <a class="code" href="classKCal_1_1Alarm.html#3fdf5078feefc485a6d86d2f9c3e8d6a" title="Return offset of alarm in time relative to the start of the event.">Alarm::startOffset</a>()<span class="keyword"> const</span> <a name="l00424"></a>00424 <span class="keyword"></span>{ <a name="l00425"></a>00425 <span class="keywordflow">return</span> (mHasTime || mEndOffset) ? 0 : mOffset; <a name="l00426"></a>00426 } <a name="l00427"></a>00427 <a name="l00428"></a><a class="code" href="classKCal_1_1Alarm.html#82ffea42c98bbe563cf9b7c03262cffc">00428</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Alarm.html#82ffea42c98bbe563cf9b7c03262cffc" title="Return whether the alarm is defined in terms of an offset relative to the start of...">Alarm::hasStartOffset</a>()<span class="keyword"> const</span> <a name="l00429"></a>00429 <span class="keyword"></span>{ <a name="l00430"></a>00430 <span class="keywordflow">return</span> !mHasTime && !mEndOffset; <a name="l00431"></a>00431 } <a name="l00432"></a>00432 <a name="l00433"></a><a class="code" href="classKCal_1_1Alarm.html#094d1237630cb22fc1d1b5c17cdbd589">00433</a> <span class="keywordtype">bool</span> <a class="code" href="classKCal_1_1Alarm.html#094d1237630cb22fc1d1b5c17cdbd589" title="Return whether the alarm is defined in terms of an offset relative to the end of...">Alarm::hasEndOffset</a>()<span class="keyword"> const</span> <a name="l00434"></a>00434 <span class="keyword"></span>{ <a name="l00435"></a>00435 <span class="keywordflow">return</span> !mHasTime && mEndOffset; <a name="l00436"></a>00436 } <a name="l00437"></a>00437 <a name="l00438"></a><a class="code" href="classKCal_1_1Alarm.html#64954a958753560ea154d47cb1a9f439">00438</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#64954a958753560ea154d47cb1a9f439" title="Set offset of alarm in time relative to the end of the event.">Alarm::setEndOffset</a>( <span class="keyword">const</span> <a class="code" href="classKCal_1_1Duration.html" title="This class represents a duration.">Duration</a> &offset ) <a name="l00439"></a>00439 { <a name="l00440"></a>00440 mOffset = offset; <a name="l00441"></a>00441 mEndOffset = <span class="keyword">true</span>; <a name="l00442"></a>00442 mHasTime = <span class="keyword">false</span>; <a name="l00443"></a>00443 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00444"></a>00444 } <a name="l00445"></a>00445 <a name="l00446"></a><a class="code" href="classKCal_1_1Alarm.html#8e7e0d368d84e9a1cb3479cd4ff29e72">00446</a> <a class="code" href="classKCal_1_1Duration.html" title="This class represents a duration.">Duration</a> <a class="code" href="classKCal_1_1Alarm.html#8e7e0d368d84e9a1cb3479cd4ff29e72" title="Return offset of alarm in time relative to the end of the event.">Alarm::endOffset</a>()<span class="keyword"> const</span> <a name="l00447"></a>00447 <span class="keyword"></span>{ <a name="l00448"></a>00448 <span class="keywordflow">return</span> (mHasTime || !mEndOffset) ? 0 : mOffset; <a name="l00449"></a>00449 } <a name="l00450"></a>00450 <a name="l00451"></a><a class="code" href="classKCal_1_1Alarm.html#deecff9c19ec6b33f388600ceb5b132e">00451</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#deecff9c19ec6b33f388600ceb5b132e" title="Set the alarm&#39;s parent incidence.">Alarm::setParent</a>( <a class="code" href="classKCal_1_1Incidence.html" title="This class provides the base class common to all calendar components.">Incidence</a> *<a class="code" href="classKCal_1_1Alarm.html#ab232ba6bafd6818cd61f671a2a1be3a" title="Get the alarm&#39;s parent incidence.">parent</a> ) <a name="l00452"></a>00452 { <a name="l00453"></a>00453 mParent = parent; <a name="l00454"></a>00454 } <a name="l00455"></a>00455 <a name="l00456"></a><a class="code" href="classKCal_1_1Alarm.html#f15f0175f3279dd5ed0595c93fda3ad7">00456</a> <span class="keywordtype">void</span> <a class="code" href="classKCal_1_1Alarm.html#f15f0175f3279dd5ed0595c93fda3ad7">Alarm::customPropertyUpdated</a>() <a name="l00457"></a>00457 { <a name="l00458"></a>00458 <span class="keywordflow">if</span> ( mParent ) mParent-><a class="code" href="classKCal_1_1IncidenceBase.html#13d965bce05bc47317a54dd81d6b2f51" title="Call this to notify the observers after the IncidenceBas object has changed.">updated</a>(); <a name="l00459"></a>00459 } </pre></div></div> </div></div> </td> </tr> <tr> <td valign="top" id="leftmenu" width="25%"> <a name="navigation"></a> <div class="menu_box"><h2>libkcal</h2> <div class="nav_list"> <ul><li><a href="index.html">Main Page</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li></ul> <!-- <h2>Class Picker</h2> <div style="text-align: center;"> <form name="guideform"> <select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value"> <option value="annotated.html">-- Choose --</option> <option value="classKCal_1_1Alarm.html">kcal::alarm</option>, <option value="classKCal_1_1Attachment.html">kcal::attachment</option>, <option value="classKCal_1_1Attendee.html">kcal::attendee</option>, <option value="classKCal_1_1Calendar.html">kcal::calendar</option>, <option value="classKCal_1_1Calendar_1_1Observer.html">kcal::calendar::observer</option>, <option value="classKCal_1_1CalendarLocal.html">kcal::calendarlocal</option>, <option value="classKCal_1_1CalendarNull.html">kcal::calendarnull</option>, <option value="classKCal_1_1CalendarResources.html">kcal::calendarresources</option>, <option value="classKCal_1_1CalFilter.html">kcal::calfilter</option>, <option value="classKCal_1_1CalFormat.html">kcal::calformat</option>, <option value="classKCal_1_1CalStorage.html">kcal::calstorage</option>, <option value="classKCal_1_1Compat.html">kcal::compat</option>, <option value="classKCal_1_1CompatFactory.html">kcal::compatfactory</option>, <option value="classKCal_1_1CustomProperties.html">kcal::customproperties</option>, <option value="classKCal_1_1DndFactory.html">kcal::dndfactory</option>, <option value="classKCal_1_1Duration.html">kcal::duration</option>, <option value="classKCal_1_1ErrorFormat.html">kcal::errorformat</option>, <option value="classKCal_1_1Event.html">kcal::event</option>, <option value="classKCal_1_1Exception.html">kcal::exception</option>, <option value="classKCal_1_1FileStorage.html">kcal::filestorage</option>, <option value="classKCal_1_1FreeBusy.html">kcal::freebusy</option>, <option value="classKCal_1_1HtmlExport.html">kcal::htmlexport</option>, <option value="classKCal_1_1ICalDrag.html">kcal::icaldrag</option>, <option value="classKCal_1_1ICalFormat.html">kcal::icalformat</option>, <option value="classKCal_1_1Incidence.html">kcal::incidence</option>, <option value="classKCal_1_1Incidence_1_1AddVisitor.html">kcal::incidence::addvisitor</option>, <option value="classKCal_1_1Incidence_1_1DeleteVisitor.html">kcal::incidence::deletevisitor</option>, <option value="classKCal_1_1IncidenceBase.html">kcal::incidencebase</option>, <option value="classKCal_1_1IncidenceBase_1_1Visitor.html">kcal::incidencebase::visitor</option>, <option value="classKCal_1_1IncidenceFormatter.html">kcal::incidenceformatter</option>, <option value="classKCal_1_1Journal.html">kcal::journal</option>, <option value="classKCal_1_1ListBase.html">kcal::listbase</option>, <option value="classKCal_1_1Period.html">kcal::period</option>, <option value="classKCal_1_1Person.html">kcal::person</option>, <option value="classKCal_1_1QtopiaFormat.html">kcal::qtopiaformat</option>, <option value="classKCal_1_1Recurrence.html">kcal::recurrence</option>, <option value="classKCal_1_1RecurrenceRule.html">kcal::recurrencerule</option>, <option value="classKCal_1_1RecurrenceRule_1_1WDayPos.html">kcal::recurrencerule::wdaypos</option>, <option value="classKCal_1_1ResourceCached.html">kcal::resourcecached</option>, <option value="classKCal_1_1ResourceCachedReloadConfig.html">kcal::resourcecachedreloadconfig</option>, <option value="classKCal_1_1ResourceCachedSaveConfig.html">kcal::resourcecachedsaveconfig</option>, <option value="classKCal_1_1ResourceCalendar.html">kcal::resourcecalendar</option>, <option value="classKCal_1_1ResourceLocal.html">kcal::resourcelocal</option>, <option value="classKCal_1_1ResourceLocalConfig.html">kcal::resourcelocalconfig</option>, <option value="classKCal_1_1ScheduleMessage.html">kcal::schedulemessage</option>, <option value="classKCal_1_1Scheduler.html">kcal::scheduler</option>, <option value="classKCal_1_1Todo.html">kcal::todo</option>, <option value="classKCal_1_1VCalDrag.html">kcal::vcaldrag</option>, <option value="classKCal_1_1VCalFormat.html">kcal::vcalformat</option>, </select> </form> </div> --> </div></div> <div class="menu_box"><h2>API Dox</h2> <div class="nav_list"> <ul> <li><a href="../../akregator/html/index.html">akregator</a></li><li> <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>