<?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: kalarmapp.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>kalarmapp.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"> * kalarmapp.cpp - the KAlarm application object</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 <djarvie@kde.org></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 <ctype.h></span>
<a name="l00025"></a>00025 <span class="preprocessor">#include <iostream></span>
<a name="l00026"></a>00026
<a name="l00027"></a>00027 <span class="preprocessor">#include <qobjectlist.h></span>
<a name="l00028"></a>00028 <span class="preprocessor">#include <qtimer.h></span>
<a name="l00029"></a>00029 <span class="preprocessor">#include <qregexp.h></span>
<a name="l00030"></a>00030 <span class="preprocessor">#include <qfile.h></span>
<a name="l00031"></a>00031
<a name="l00032"></a>00032 <span class="preprocessor">#include <kcmdlineargs.h></span>
<a name="l00033"></a>00033 <span class="preprocessor">#include <klocale.h></span>
<a name="l00034"></a>00034 <span class="preprocessor">#include <kstandarddirs.h></span>
<a name="l00035"></a>00035 <span class="preprocessor">#include <kconfig.h></span>
<a name="l00036"></a>00036 <span class="preprocessor">#include <kaboutdata.h></span>
<a name="l00037"></a>00037 <span class="preprocessor">#include <dcopclient.h></span>
<a name="l00038"></a>00038 <span class="preprocessor">#include <kprocess.h></span>
<a name="l00039"></a>00039 <span class="preprocessor">#include <ktempfile.h></span>
<a name="l00040"></a>00040 <span class="preprocessor">#include <kfileitem.h></span>
<a name="l00041"></a>00041 <span class="preprocessor">#include <kstdguiitem.h></span>
<a name="l00042"></a>00042 <span class="preprocessor">#include <ktrader.h></span>
<a name="l00043"></a>00043 <span class="preprocessor">#include <kstaticdeleter.h></span>
<a name="l00044"></a>00044 <span class="preprocessor">#include <kdebug.h></span>
<a name="l00045"></a>00045
<a name="l00046"></a>00046 <span class="preprocessor">#include <libkcal/calformat.h></span>
<a name="l00047"></a>00047
<a name="l00048"></a>00048 <span class="preprocessor">#include <kalarmd/clientinfo.h></span>
<a name="l00049"></a>00049
<a name="l00050"></a>00050 <span class="preprocessor">#include "alarmcalendar.h"</span>
<a name="l00051"></a>00051 <span class="preprocessor">#include "alarmlistview.h"</span>
<a name="l00052"></a>00052 <span class="preprocessor">#include "editdlg.h"</span>
<a name="l00053"></a>00053 <span class="preprocessor">#include "daemon.h"</span>
<a name="l00054"></a>00054 <span class="preprocessor">#include "dcophandler.h"</span>
<a name="l00055"></a>00055 <span class="preprocessor">#include "<a class="code" href="functions_8h.html" title="miscellaneous functions">functions.h</a>"</span>
<a name="l00056"></a>00056 <span class="preprocessor">#include "kamail.h"</span>
<a name="l00057"></a>00057 <span class="preprocessor">#include "karecurrence.h"</span>
<a name="l00058"></a>00058 <span class="preprocessor">#include "<a class="code" href="mainwindow_8h.html" title="main application window">mainwindow.h</a>"</span>
<a name="l00059"></a>00059 <span class="preprocessor">#include "messagebox.h"</span>
<a name="l00060"></a>00060 <span class="preprocessor">#include "<a class="code" href="messagewin_8h.html" title="displays an alarm message">messagewin.h</a>"</span>
<a name="l00061"></a>00061 <span class="preprocessor">#include "preferences.h"</span>
<a name="l00062"></a>00062 <span class="preprocessor">#include "prefdlg.h"</span>
<a name="l00063"></a>00063 <span class="preprocessor">#include "shellprocess.h"</span>
<a name="l00064"></a>00064 <span class="preprocessor">#include "traywindow.h"</span>
<a name="l00065"></a>00065 <span class="preprocessor">#include "kalarmapp.moc"</span>
<a name="l00066"></a>00066
<a name="l00067"></a>00067 <span class="preprocessor">#include <netwm.h></span>
<a name="l00068"></a>00068
<a name="l00069"></a>00069
<a name="l00070"></a>00070 <span class="keyword">static</span> <span class="keywordtype">bool</span> convWakeTime(<span class="keyword">const</span> QCString& timeParam, QDateTime&, <span class="keywordtype">bool</span>& noTime);
<a name="l00071"></a>00071 <span class="keyword">static</span> <span class="keywordtype">bool</span> convInterval(<span class="keyword">const</span> QCString& timeParam, KARecurrence::Type&, <span class="keywordtype">int</span>& timeInterval, <span class="keywordtype">bool</span> allowMonthYear = <span class="keyword">false</span>);
<a name="l00072"></a>00072
<a name="l00073"></a>00073 <span class="comment">/******************************************************************************</span>
<a name="l00074"></a>00074 <span class="comment">* Find the maximum number of seconds late which a late-cancel alarm is allowed</span>
<a name="l00075"></a>00075 <span class="comment">* to be. This is calculated as the alarm daemon's check interval, plus a few</span>
<a name="l00076"></a>00076 <span class="comment">* seconds leeway to cater for any timing irregularities.</span>
<a name="l00077"></a>00077 <span class="comment">*/</span>
<a name="l00078"></a>00078 <span class="keyword">static</span> <span class="keyword">inline</span> <span class="keywordtype">int</span> maxLateness(<span class="keywordtype">int</span> lateCancel)
<a name="l00079"></a>00079 {
<a name="l00080"></a>00080 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> LATENESS_LEEWAY = 5;
<a name="l00081"></a>00081 <span class="keywordtype">int</span> lc = (lateCancel >= 1) ? (lateCancel - 1)*60 : 0;
<a name="l00082"></a>00082 <span class="keywordflow">return</span> Daemon::maxTimeSinceCheck() + LATENESS_LEEWAY + lc;
<a name="l00083"></a>00083 }
<a name="l00084"></a>00084
<a name="l00085"></a>00085
<a name="l00086"></a>00086 KAlarmApp* KAlarmApp::theInstance = 0;
<a name="l00087"></a>00087 <span class="keywordtype">int</span> KAlarmApp::mActiveCount = 0;
<a name="l00088"></a>00088 <span class="keywordtype">int</span> KAlarmApp::mFatalError = 0;
<a name="l00089"></a>00089 QString KAlarmApp::mFatalMessage;
<a name="l00090"></a>00090
<a name="l00091"></a>00091
<a name="l00092"></a>00092 <span class="comment">/******************************************************************************</span>
<a name="l00093"></a>00093 <span class="comment">* Construct the application.</span>
<a name="l00094"></a>00094 <span class="comment">*/</span>
<a name="l00095"></a>00095 KAlarmApp::KAlarmApp()
<a name="l00096"></a>00096 : KUniqueApplication(),
<a name="l00097"></a>00097 mInitialised(false),
<a name="l00098"></a>00098 mDcopHandler(new DcopHandler()),
<a name="l00099"></a>00099 #ifdef OLD_DCOP
<a name="l00100"></a>00100 mDcopHandlerOld(new DcopHandlerOld()),
<a name="l00101"></a>00101 #endif
<a name="l00102"></a>00102 mTrayWindow(0),
<a name="l00103"></a>00103 mPendingQuit(false),
<a name="l00104"></a>00104 mProcessingQueue(false),
<a name="l00105"></a>00105 mCheckingSystemTray(false),
<a name="l00106"></a>00106 mSessionClosingDown(false),
<a name="l00107"></a>00107 mRefreshExpiredAlarms(false),
<a name="l00108"></a>00108 mSpeechEnabled(false)
<a name="l00109"></a>00109 {
<a name="l00110"></a>00110 Preferences::initialise();
<a name="l00111"></a>00111 Preferences::connect(SIGNAL(preferencesChanged()), <span class="keyword">this</span>, SLOT(slotPreferencesChanged()));
<a name="l00112"></a>00112 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1CalFormat.html#02aec9050e64484ed59706048ba72c35">KCal::CalFormat::setApplication</a>(aboutData()->programName(), AlarmCalendar::icalProductId());
<a name="l00113"></a>00113 KARecurrence::setDefaultFeb29Type(Preferences::defaultFeb29Type());
<a name="l00114"></a>00114
<a name="l00115"></a>00115 <span class="comment">// Check if the system tray is supported by this window manager</span>
<a name="l00116"></a>00116 mHaveSystemTray = <span class="keyword">true</span>; <span class="comment">// assume yes in lieu of a test which works</span>
<a name="l00117"></a>00117
<a name="l00118"></a>00118 <span class="keywordflow">if</span> (AlarmCalendar::initialiseCalendars())
<a name="l00119"></a>00119 {
<a name="l00120"></a>00120 connect(AlarmCalendar::expiredCalendar(), SIGNAL(purged()), SLOT(slotExpiredPurged()));
<a name="l00121"></a>00121
<a name="l00122"></a>00122 KConfig* config = kapp->config();
<a name="l00123"></a>00123 config->setGroup(QString::fromLatin1(<span class="stringliteral">"General"</span>));
<a name="l00124"></a>00124 mNoSystemTray = config->readBoolEntry(QString::fromLatin1(<span class="stringliteral">"NoSystemTray"</span>), <span class="keyword">false</span>);
<a name="l00125"></a>00125 mSavedNoSystemTray = mNoSystemTray;
<a name="l00126"></a>00126 mOldRunInSystemTray = wantRunInSystemTray();
<a name="l00127"></a>00127 mDisableAlarmsIfStopped = mOldRunInSystemTray && !mNoSystemTray && Preferences::disableAlarmsIfStopped();
<a name="l00128"></a>00128 mStartOfDay = Preferences::startOfDay();
<a name="l00129"></a>00129 <span class="keywordflow">if</span> (Preferences::hasStartOfDayChanged())
<a name="l00130"></a>00130 mStartOfDay.setHMS(100,0,0); <span class="comment">// start of day time has changed: flag it as invalid</span>
<a name="l00131"></a>00131 DateTime::setStartOfDay(mStartOfDay);
<a name="l00132"></a>00132 mPrefsExpiredColour = Preferences::expiredColour();
<a name="l00133"></a>00133 mPrefsExpiredKeepDays = Preferences::expiredKeepDays();
<a name="l00134"></a>00134 }
<a name="l00135"></a>00135
<a name="l00136"></a>00136 <span class="comment">// Check if the speech synthesis daemon is installed</span>
<a name="l00137"></a>00137 mSpeechEnabled = (KTrader::self()->query(<span class="stringliteral">"DCOP/Text-to-Speech"</span>, <span class="stringliteral">"Name == 'KTTSD'"</span>).count() > 0);
<a name="l00138"></a>00138 <span class="keywordflow">if</span> (!mSpeechEnabled)
<a name="l00139"></a>00139 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::KAlarmApp(): speech synthesis disabled (KTTSD not found)"</span> << endl;
<a name="l00140"></a>00140 <span class="comment">// Check if KOrganizer is installed</span>
<a name="l00141"></a>00141 QString korg = QString::fromLatin1(<span class="stringliteral">"korganizer"</span>);
<a name="l00142"></a>00142 mKOrganizerEnabled = !locate(<span class="stringliteral">"exe"</span>, korg).isNull() || !KStandardDirs::findExe(korg).isNull();
<a name="l00143"></a>00143 <span class="keywordflow">if</span> (!mKOrganizerEnabled)
<a name="l00144"></a>00144 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::KAlarmApp(): KOrganizer options disabled (KOrganizer not found)"</span> << endl;
<a name="l00145"></a>00145 }
<a name="l00146"></a>00146
<a name="l00147"></a>00147 <span class="comment">/******************************************************************************</span>
<a name="l00148"></a>00148 <span class="comment">*/</span>
<a name="l00149"></a>00149 KAlarmApp::~KAlarmApp()
<a name="l00150"></a>00150 {
<a name="l00151"></a>00151 <span class="keywordflow">while</span> (!mCommandProcesses.isEmpty())
<a name="l00152"></a>00152 {
<a name="l00153"></a>00153 ProcData* pd = mCommandProcesses.first();
<a name="l00154"></a>00154 mCommandProcesses.pop_front();
<a name="l00155"></a>00155 <span class="keyword">delete</span> pd;
<a name="l00156"></a>00156 }
<a name="l00157"></a>00157 AlarmCalendar::terminateCalendars();
<a name="l00158"></a>00158 }
<a name="l00159"></a>00159
<a name="l00160"></a>00160 <span class="comment">/******************************************************************************</span>
<a name="l00161"></a>00161 <span class="comment">* Return the one and only KAlarmApp instance.</span>
<a name="l00162"></a>00162 <span class="comment">* If it doesn't already exist, it is created first.</span>
<a name="l00163"></a>00163 <span class="comment">*/</span>
<a name="l00164"></a>00164 KAlarmApp* KAlarmApp::getInstance()
<a name="l00165"></a>00165 {
<a name="l00166"></a>00166 <span class="keywordflow">if</span> (!theInstance)
<a name="l00167"></a>00167 {
<a name="l00168"></a>00168 theInstance = <span class="keyword">new</span> KAlarmApp;
<a name="l00169"></a>00169
<a name="l00170"></a>00170 <span class="keywordflow">if</span> (mFatalError)
<a name="l00171"></a>00171 theInstance->quitFatal();
<a name="l00172"></a>00172 <span class="keywordflow">else</span>
<a name="l00173"></a>00173 {
<a name="l00174"></a>00174 <span class="comment">// This is here instead of in the constructor to avoid recursion</span>
<a name="l00175"></a>00175 Daemon::initialise(); <span class="comment">// calendars must be initialised before calling this</span>
<a name="l00176"></a>00176 }
<a name="l00177"></a>00177 }
<a name="l00178"></a>00178 <span class="keywordflow">return</span> theInstance;
<a name="l00179"></a>00179 }
<a name="l00180"></a>00180
<a name="l00181"></a>00181 <span class="comment">/******************************************************************************</span>
<a name="l00182"></a>00182 <span class="comment">* Restore the saved session if required.</span>
<a name="l00183"></a>00183 <span class="comment">*/</span>
<a name="l00184"></a>00184 <span class="keywordtype">bool</span> KAlarmApp::restoreSession()
<a name="l00185"></a>00185 {
<a name="l00186"></a>00186 <span class="keywordflow">if</span> (!isRestored())
<a name="l00187"></a>00187 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00188"></a>00188 <span class="keywordflow">if</span> (mFatalError)
<a name="l00189"></a>00189 {
<a name="l00190"></a>00190 quitFatal();
<a name="l00191"></a>00191 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00192"></a>00192 }
<a name="l00193"></a>00193
<a name="l00194"></a>00194 <span class="comment">// Process is being restored by session management.</span>
<a name="l00195"></a>00195 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::restoreSession(): Restoring\n"</span>;
<a name="l00196"></a>00196 ++mActiveCount;
<a name="l00197"></a>00197 <span class="keywordflow">if</span> (!initCheck(<span class="keyword">true</span>)) <span class="comment">// open the calendar file (needed for main windows)</span>
<a name="l00198"></a>00198 {
<a name="l00199"></a>00199 --mActiveCount;
<a name="l00200"></a>00200 quitIf(1, <span class="keyword">true</span>); <span class="comment">// error opening the main calendar - quit</span>
<a name="l00201"></a>00201 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00202"></a>00202 }
<a name="l00203"></a>00203 MainWindow* trayParent = 0;
<a name="l00204"></a>00204 <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 1; KMainWindow::canBeRestored(i); ++i)
<a name="l00205"></a>00205 {
<a name="l00206"></a>00206 QString type = KMainWindow::classNameOfToplevel(i);
<a name="l00207"></a>00207 <span class="keywordflow">if</span> (type == QString::fromLatin1(<span class="stringliteral">"MainWindow"</span>))
<a name="l00208"></a>00208 {
<a name="l00209"></a>00209 MainWindow* win = MainWindow::create(<span class="keyword">true</span>);
<a name="l00210"></a>00210 win->restore(i, <span class="keyword">false</span>);
<a name="l00211"></a>00211 <span class="keywordflow">if</span> (win->isHiddenTrayParent())
<a name="l00212"></a>00212 trayParent = win;
<a name="l00213"></a>00213 <span class="keywordflow">else</span>
<a name="l00214"></a>00214 win->show();
<a name="l00215"></a>00215 }
<a name="l00216"></a>00216 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (type == QString::fromLatin1(<span class="stringliteral">"MessageWin"</span>))
<a name="l00217"></a>00217 {
<a name="l00218"></a>00218 <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>* win = <span class="keyword">new</span> <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>;
<a name="l00219"></a>00219 win->restore(i, <span class="keyword">false</span>);
<a name="l00220"></a>00220 <span class="keywordflow">if</span> (win-><a class="code" href="classMessageWin.html#1518f452d0a166f49f5f67e35e395c6b">isValid</a>())
<a name="l00221"></a>00221 win-><a class="code" href="classMessageWin.html#12069e9a5323d35bcfe8b2c2fef9a224">show</a>();
<a name="l00222"></a>00222 <span class="keywordflow">else</span>
<a name="l00223"></a>00223 <span class="keyword">delete</span> win;
<a name="l00224"></a>00224 }
<a name="l00225"></a>00225 }
<a name="l00226"></a>00226 initCheck(); <span class="comment">// register with the alarm daemon</span>
<a name="l00227"></a>00227
<a name="l00228"></a>00228 <span class="comment">// Try to display the system tray icon if it is configured to be autostarted,</span>
<a name="l00229"></a>00229 <span class="comment">// or if we're in run-in-system-tray mode.</span>
<a name="l00230"></a>00230 <span class="keywordflow">if</span> (Preferences::autostartTrayIcon()
<a name="l00231"></a>00231 || MainWindow::count() && wantRunInSystemTray())
<a name="l00232"></a>00232 {
<a name="l00233"></a>00233 displayTrayIcon(<span class="keyword">true</span>, trayParent);
<a name="l00234"></a>00234 <span class="comment">// Occasionally for no obvious reason, the main main window is</span>
<a name="l00235"></a>00235 <span class="comment">// shown when it should be hidden, so hide it just to be sure.</span>
<a name="l00236"></a>00236 <span class="keywordflow">if</span> (trayParent)
<a name="l00237"></a>00237 trayParent->hide();
<a name="l00238"></a>00238 }
<a name="l00239"></a>00239
<a name="l00240"></a>00240 --mActiveCount;
<a name="l00241"></a>00241 quitIf(0); <span class="comment">// quit if no windows are open</span>
<a name="l00242"></a>00242 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00243"></a>00243 }
<a name="l00244"></a>00244
<a name="l00245"></a>00245 <span class="comment">/******************************************************************************</span>
<a name="l00246"></a>00246 <span class="comment">* Called for a KUniqueApplication when a new instance of the application is</span>
<a name="l00247"></a>00247 <span class="comment">* started.</span>
<a name="l00248"></a>00248 <span class="comment">*/</span>
<a name="l00249"></a>00249 <span class="keywordtype">int</span> KAlarmApp::newInstance()
<a name="l00250"></a>00250 {
<a name="l00251"></a>00251 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance()\n"</span>;
<a name="l00252"></a>00252 <span class="keywordflow">if</span> (mFatalError)
<a name="l00253"></a>00253 {
<a name="l00254"></a>00254 quitFatal();
<a name="l00255"></a>00255 <span class="keywordflow">return</span> 1;
<a name="l00256"></a>00256 }
<a name="l00257"></a>00257 ++mActiveCount;
<a name="l00258"></a>00258 <span class="keywordtype">int</span> exitCode = 0; <span class="comment">// default = success</span>
<a name="l00259"></a>00259 <span class="keyword">static</span> <span class="keywordtype">bool</span> firstInstance = <span class="keyword">true</span>;
<a name="l00260"></a>00260 <span class="keywordtype">bool</span> dontRedisplay = <span class="keyword">false</span>;
<a name="l00261"></a>00261 <span class="keywordflow">if</span> (!firstInstance || !isRestored())
<a name="l00262"></a>00262 {
<a name="l00263"></a>00263 QString usage;
<a name="l00264"></a>00264 KCmdLineArgs* args = KCmdLineArgs::parsedArgs();
<a name="l00265"></a>00265
<a name="l00266"></a>00266 <span class="comment">// Use a 'do' loop which is executed only once to allow easy error exits.</span>
<a name="l00267"></a>00267 <span class="comment">// Errors use 'break' to skip to the end of the function.</span>
<a name="l00268"></a>00268
<a name="l00269"></a>00269 <span class="comment">// Note that DCOP handling is only set up once the command line parameters</span>
<a name="l00270"></a>00270 <span class="comment">// have been checked, since we mustn't register with the alarm daemon only</span>
<a name="l00271"></a>00271 <span class="comment">// to quit immediately afterwards.</span>
<a name="l00272"></a>00272 <span class="keywordflow">do</span>
<a name="l00273"></a>00273 {
<a name="l00274"></a>00274 <span class="preprocessor"> #define USAGE(message) { usage = message; break; }</span>
<a name="l00275"></a>00275 <span class="preprocessor"></span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"stop"</span>))
<a name="l00276"></a>00276 {
<a name="l00277"></a>00277 <span class="comment">// Stop the alarm daemon</span>
<a name="l00278"></a>00278 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): stop\n"</span>;
<a name="l00279"></a>00279 args->clear(); <span class="comment">// free up memory</span>
<a name="l00280"></a>00280 <span class="keywordflow">if</span> (!Daemon::stop())
<a name="l00281"></a>00281 {
<a name="l00282"></a>00282 exitCode = 1;
<a name="l00283"></a>00283 <span class="keywordflow">break</span>;
<a name="l00284"></a>00284 }
<a name="l00285"></a>00285 dontRedisplay = <span class="keyword">true</span>; <span class="comment">// exit program if no other instances running</span>
<a name="l00286"></a>00286 }
<a name="l00287"></a>00287 <span class="keywordflow">else</span>
<a name="l00288"></a>00288 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"reset"</span>))
<a name="l00289"></a>00289 {
<a name="l00290"></a>00290 <span class="comment">// Reset the alarm daemon, if it's running.</span>
<a name="l00291"></a>00291 <span class="comment">// (If it's not running, it will reset automatically when it eventually starts.)</span>
<a name="l00292"></a>00292 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): reset\n"</span>;
<a name="l00293"></a>00293 args->clear(); <span class="comment">// free up memory</span>
<a name="l00294"></a>00294 Daemon::reset();
<a name="l00295"></a>00295 dontRedisplay = <span class="keyword">true</span>; <span class="comment">// exit program if no other instances running</span>
<a name="l00296"></a>00296 }
<a name="l00297"></a>00297 <span class="keywordflow">else</span>
<a name="l00298"></a>00298 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"tray"</span>))
<a name="l00299"></a>00299 {
<a name="l00300"></a>00300 <span class="comment">// Display only the system tray icon</span>
<a name="l00301"></a>00301 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): tray\n"</span>;
<a name="l00302"></a>00302 args->clear(); <span class="comment">// free up memory</span>
<a name="l00303"></a>00303 <span class="keywordflow">if</span> (!mHaveSystemTray)
<a name="l00304"></a>00304 {
<a name="l00305"></a>00305 exitCode = 1;
<a name="l00306"></a>00306 <span class="keywordflow">break</span>;
<a name="l00307"></a>00307 }
<a name="l00308"></a>00308 <span class="keywordflow">if</span> (!initCheck()) <span class="comment">// open the calendar, register with daemon</span>
<a name="l00309"></a>00309 {
<a name="l00310"></a>00310 exitCode = 1;
<a name="l00311"></a>00311 <span class="keywordflow">break</span>;
<a name="l00312"></a>00312 }
<a name="l00313"></a>00313 <span class="keywordflow">if</span> (!displayTrayIcon(<span class="keyword">true</span>))
<a name="l00314"></a>00314 {
<a name="l00315"></a>00315 exitCode = 1;
<a name="l00316"></a>00316 <span class="keywordflow">break</span>;
<a name="l00317"></a>00317 }
<a name="l00318"></a>00318 }
<a name="l00319"></a>00319 <span class="keywordflow">else</span>
<a name="l00320"></a>00320 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"handleEvent"</span>) || args->isSet(<span class="stringliteral">"triggerEvent"</span>) || args->isSet(<span class="stringliteral">"cancelEvent"</span>) || args->isSet(<span class="stringliteral">"calendarURL"</span>))
<a name="l00321"></a>00321 {
<a name="l00322"></a>00322 <span class="comment">// Display or delete the event with the specified event ID</span>
<a name="l00323"></a>00323 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): handle event\n"</span>;
<a name="l00324"></a>00324 EventFunc function = EVENT_HANDLE;
<a name="l00325"></a>00325 <span class="keywordtype">int</span> count = 0;
<a name="l00326"></a>00326 <span class="keyword">const</span> <span class="keywordtype">char</span>* option = 0;
<a name="l00327"></a>00327 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"handleEvent"</span>)) { function = EVENT_HANDLE; option = <span class="stringliteral">"handleEvent"</span>; ++count; }
<a name="l00328"></a>00328 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"triggerEvent"</span>)) { function = EVENT_TRIGGER; option = <span class="stringliteral">"triggerEvent"</span>; ++count; }
<a name="l00329"></a>00329 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"cancelEvent"</span>)) { function = EVENT_CANCEL; option = <span class="stringliteral">"cancelEvent"</span>; ++count; }
<a name="l00330"></a>00330 <span class="keywordflow">if</span> (!count)
<a name="l00331"></a>00331 USAGE(i18n(<span class="stringliteral">"%1 requires %2, %3 or %4"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--calendarURL"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--handleEvent"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--triggerEvent"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--cancelEvent"</span>)))
<a name="l00332"></a>00332 if (count > 1)
<a name="l00333"></a>00333 USAGE(i18n("%1, %2, %3 mutually exclusive").arg(QString::fromLatin1("--handleEvent")).arg(QString::fromLatin1("--triggerEvent")).arg(QString::fromLatin1("--cancelEvent")));
<a name="l00334"></a>00334 if (!initCheck(true)) <span class="comment">// open the calendar, don't register with daemon yet</span>
<a name="l00335"></a>00335 {
<a name="l00336"></a>00336 exitCode = 1;
<a name="l00337"></a>00337 <span class="keywordflow">break</span>;
<a name="l00338"></a>00338 }
<a name="l00339"></a>00339 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"calendarURL"</span>))
<a name="l00340"></a>00340 {
<a name="l00341"></a>00341 QString calendarUrl = args->getOption(<span class="stringliteral">"calendarURL"</span>);
<a name="l00342"></a>00342 <span class="keywordflow">if</span> (KURL(calendarUrl).url() != AlarmCalendar::activeCalendar()->urlString())
<a name="l00343"></a>00343 USAGE(i18n(<span class="stringliteral">"%1: wrong calendar file"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--calendarURL"</span>)))
<a name="l00344"></a>00344 }
<a name="l00345"></a>00345 QString eventID = args->getOption(option);
<a name="l00346"></a>00346 args->clear(); <span class="comment">// free up memory</span>
<a name="l00347"></a>00347 <span class="keywordflow">if</span> (eventID.startsWith(QString::fromLatin1(<span class="stringliteral">"ad:"</span>)))
<a name="l00348"></a>00348 {
<a name="l00349"></a>00349 <span class="comment">// It's a notification from the alarm deamon</span>
<a name="l00350"></a>00350 eventID = eventID.mid(3);
<a name="l00351"></a>00351 Daemon::queueEvent(eventID);
<a name="l00352"></a>00352 }
<a name="l00353"></a>00353 setUpDcop(); <span class="comment">// start processing DCOP calls</span>
<a name="l00354"></a>00354 <span class="keywordflow">if</span> (!handleEvent(eventID, function))
<a name="l00355"></a>00355 {
<a name="l00356"></a>00356 exitCode = 1;
<a name="l00357"></a>00357 <span class="keywordflow">break</span>;
<a name="l00358"></a>00358 }
<a name="l00359"></a>00359 }
<a name="l00360"></a>00360 <span class="keywordflow">else</span>
<a name="l00361"></a>00361 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"edit"</span>))
<a name="l00362"></a>00362 {
<a name="l00363"></a>00363 QString eventID = args->getOption(<span class="stringliteral">"edit"</span>);
<a name="l00364"></a>00364 <span class="keywordflow">if</span> (!initCheck())
<a name="l00365"></a>00365 {
<a name="l00366"></a>00366 exitCode = 1;
<a name="l00367"></a>00367 <span class="keywordflow">break</span>;
<a name="l00368"></a>00368 }
<a name="l00369"></a>00369 <span class="keywordflow">if</span> (!KAlarm::edit(eventID))
<a name="l00370"></a>00370 {
<a name="l00371"></a>00371 USAGE(i18n(<span class="stringliteral">"%1: Event %2 not found, or not editable"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--edit"</span>)).arg(eventID))
<a name="l00372"></a>00372 exitCode = 1;
<a name="l00373"></a>00373 break;
<a name="l00374"></a>00374 }
<a name="l00375"></a>00375 }
<a name="l00376"></a>00376 else
<a name="l00377"></a>00377 if (args->isSet("edit-new") || args->isSet("edit-new-preset"))
<a name="l00378"></a>00378 {
<a name="l00379"></a>00379 QString templ;
<a name="l00380"></a>00380 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"edit-new-preset"</span>))
<a name="l00381"></a>00381 templ = args->getOption(<span class="stringliteral">"edit-new-preset"</span>);
<a name="l00382"></a>00382 <span class="keywordflow">if</span> (!initCheck())
<a name="l00383"></a>00383 {
<a name="l00384"></a>00384 exitCode = 1;
<a name="l00385"></a>00385 <span class="keywordflow">break</span>;
<a name="l00386"></a>00386 }
<a name="l00387"></a>00387 KAlarm::editNew(templ);
<a name="l00388"></a>00388 }
<a name="l00389"></a>00389 <span class="keywordflow">else</span>
<a name="l00390"></a>00390 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"file"</span>) || args->isSet(<span class="stringliteral">"exec"</span>) || args->isSet(<span class="stringliteral">"mail"</span>) || args->count())
<a name="l00391"></a>00391 {
<a name="l00392"></a>00392 <span class="comment">// Display a message or file, execute a command, or send an email</span>
<a name="l00393"></a>00393 KAEvent::Action action = KAEvent::MESSAGE;
<a name="l00394"></a>00394 QCString alMessage;
<a name="l00395"></a>00395 uint alFromID = 0;
<a name="l00396"></a>00396 EmailAddressList alAddresses;
<a name="l00397"></a>00397 QStringList alAttachments;
<a name="l00398"></a>00398 QCString alSubject;
<a name="l00399"></a>00399 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"file"</span>))
<a name="l00400"></a>00400 {
<a name="l00401"></a>00401 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): file\n"</span>;
<a name="l00402"></a>00402 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"exec"</span>))
<a name="l00403"></a>00403 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--exec"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--file"</span>)))
<a name="l00404"></a>00404 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"mail"</span>))
<a name="l00405"></a>00405 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--file"</span>)))
<a name="l00406"></a>00406 <span class="keywordflow">if</span> (args->count())
<a name="l00407"></a>00407 USAGE(i18n(<span class="stringliteral">"message incompatible with %1"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--file"</span>)))
<a name="l00408"></a>00408 alMessage = args->getOption(<span class="stringliteral">"file"</span>);
<a name="l00409"></a>00409 action = KAEvent::FILE;
<a name="l00410"></a>00410 }
<a name="l00411"></a>00411 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"exec"</span>))
<a name="l00412"></a>00412 {
<a name="l00413"></a>00413 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): exec\n"</span>;
<a name="l00414"></a>00414 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"mail"</span>))
<a name="l00415"></a>00415 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--exec"</span>)))
<a name="l00416"></a>00416 alMessage = args->getOption(<span class="stringliteral">"exec"</span>);
<a name="l00417"></a>00417 <span class="keywordtype">int</span> n = args->count();
<a name="l00418"></a>00418 <span class="keywordflow">for</span> (<span class="keywordtype">int</span> i = 0; i < n; ++i)
<a name="l00419"></a>00419 {
<a name="l00420"></a>00420 alMessage += <span class="charliteral">' '</span>;
<a name="l00421"></a>00421 alMessage += args->arg(i);
<a name="l00422"></a>00422 }
<a name="l00423"></a>00423 action = KAEvent::COMMAND;
<a name="l00424"></a>00424 }
<a name="l00425"></a>00425 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"mail"</span>))
<a name="l00426"></a>00426 {
<a name="l00427"></a>00427 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): mail\n"</span>;
<a name="l00428"></a>00428 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"subject"</span>))
<a name="l00429"></a>00429 alSubject = args->getOption(<span class="stringliteral">"subject"</span>);
<a name="l00430"></a>00430 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"from-id"</span>))
<a name="l00431"></a>00431 alFromID = KAMail::identityUoid(args->getOption(<span class="stringliteral">"from-id"</span>));
<a name="l00432"></a>00432 QCStringList params = args->getOptionList(<span class="stringliteral">"mail"</span>);
<a name="l00433"></a>00433 <span class="keywordflow">for</span> (QCStringList::Iterator i = params.begin(); i != params.end(); ++i)
<a name="l00434"></a>00434 {
<a name="l00435"></a>00435 QString addr = QString::fromLocal8Bit(*i);
<a name="l00436"></a>00436 <span class="keywordflow">if</span> (!KAMail::checkAddress(addr))
<a name="l00437"></a>00437 USAGE(i18n(<span class="stringliteral">"%1: invalid email address"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)))
<a name="l00438"></a>00438 alAddresses += KCal::Person(QString::null, addr);
<a name="l00439"></a>00439 }
<a name="l00440"></a>00440 params = args->getOptionList("attach");
<a name="l00441"></a>00441 for (QCStringList::Iterator i = params.begin(); i != params.end(); ++i)
<a name="l00442"></a>00442 alAttachments += QString::fromLocal8Bit(*i);
<a name="l00443"></a>00443 alMessage = args->arg(0);
<a name="l00444"></a>00444 action = <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>::EMAIL;
<a name="l00445"></a>00445 }
<a name="l00446"></a>00446 else
<a name="l00447"></a>00447 {
<a name="l00448"></a>00448 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): message\n"</span>;
<a name="l00449"></a>00449 alMessage = args->arg(0);
<a name="l00450"></a>00450 }
<a name="l00451"></a>00451
<a name="l00452"></a>00452 <span class="keywordflow">if</span> (action != KAEvent::EMAIL)
<a name="l00453"></a>00453 {
<a name="l00454"></a>00454 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"subject"</span>))
<a name="l00455"></a>00455 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--subject"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)))
<a name="l00456"></a>00456 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"from-id"</span>))
<a name="l00457"></a>00457 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--from-id"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)))
<a name="l00458"></a>00458 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"attach"</span>))
<a name="l00459"></a>00459 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--attach"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)))
<a name="l00460"></a>00460 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"bcc"</span>))
<a name="l00461"></a>00461 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--bcc"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)))
<a name="l00462"></a>00462 }
<a name="l00463"></a>00463
<a name="l00464"></a>00464 <span class="keywordtype">bool</span> alarmNoTime = <span class="keyword">false</span>;
<a name="l00465"></a>00465 QDateTime alarmTime, endTime;
<a name="l00466"></a>00466 QColor bgColour = Preferences::defaultBgColour();
<a name="l00467"></a>00467 QColor fgColour = Preferences::defaultFgColour();
<a name="l00468"></a>00468 KARecurrence recurrence;
<a name="l00469"></a>00469 <span class="keywordtype">int</span> repeatCount = 0;
<a name="l00470"></a>00470 <span class="keywordtype">int</span> repeatInterval = 0;
<a name="l00471"></a>00471 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"color"</span>))
<a name="l00472"></a>00472 {
<a name="l00473"></a>00473 <span class="comment">// Background colour is specified</span>
<a name="l00474"></a>00474 QCString colourText = args->getOption(<span class="stringliteral">"color"</span>);
<a name="l00475"></a>00475 <span class="keywordflow">if</span> (static_cast<const char*>(colourText)[0] == <span class="charliteral">'0'</span>
<a name="l00476"></a>00476 && tolower(static_cast<const char*>(colourText)[1]) == <span class="charliteral">'x'</span>)
<a name="l00477"></a>00477 colourText.replace(0, 2, <span class="stringliteral">"#"</span>);
<a name="l00478"></a>00478 bgColour.setNamedColor(colourText);
<a name="l00479"></a>00479 <span class="keywordflow">if</span> (!bgColour.isValid())
<a name="l00480"></a>00480 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--color"</span>)))
<a name="l00481"></a>00481 }
<a name="l00482"></a>00482 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"colorfg"</span>))
<a name="l00483"></a>00483 {
<a name="l00484"></a>00484 <span class="comment">// Foreground colour is specified</span>
<a name="l00485"></a>00485 QCString colourText = args->getOption(<span class="stringliteral">"colorfg"</span>);
<a name="l00486"></a>00486 <span class="keywordflow">if</span> (static_cast<const char*>(colourText)[0] == <span class="charliteral">'0'</span>
<a name="l00487"></a>00487 && tolower(static_cast<const char*>(colourText)[1]) == <span class="charliteral">'x'</span>)
<a name="l00488"></a>00488 colourText.replace(0, 2, <span class="stringliteral">"#"</span>);
<a name="l00489"></a>00489 fgColour.setNamedColor(colourText);
<a name="l00490"></a>00490 <span class="keywordflow">if</span> (!fgColour.isValid())
<a name="l00491"></a>00491 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--colorfg"</span>)))
<a name="l00492"></a>00492 }
<a name="l00493"></a>00493
<a name="l00494"></a>00494 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"time"</span>))
<a name="l00495"></a>00495 {
<a name="l00496"></a>00496 QCString dateTime = args->getOption(<span class="stringliteral">"time"</span>);
<a name="l00497"></a>00497 <span class="keywordflow">if</span> (!convWakeTime(dateTime, alarmTime, alarmNoTime))
<a name="l00498"></a>00498 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--time"</span>)))
<a name="l00499"></a>00499 }
<a name="l00500"></a>00500 <span class="keywordflow">else</span>
<a name="l00501"></a>00501 alarmTime = QDateTime::currentDateTime();
<a name="l00502"></a>00502
<a name="l00503"></a>00503 <span class="keywordtype">bool</span> haveRecurrence = args->isSet(<span class="stringliteral">"recurrence"</span>);
<a name="l00504"></a>00504 <span class="keywordflow">if</span> (haveRecurrence)
<a name="l00505"></a>00505 {
<a name="l00506"></a>00506 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"login"</span>))
<a name="l00507"></a>00507 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--login"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--recurrence"</span>)))
<a name="l00508"></a>00508 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"until"</span>))
<a name="l00509"></a>00509 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--until"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--recurrence"</span>)))
<a name="l00510"></a>00510 QCString rule = args->getOption(<span class="stringliteral">"recurrence"</span>);
<a name="l00511"></a>00511 recurrence.set(QString::fromLocal8Bit(static_cast<const char*>(rule)));
<a name="l00512"></a>00512 }
<a name="l00513"></a>00513 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"interval"</span>))
<a name="l00514"></a>00514 {
<a name="l00515"></a>00515 <span class="comment">// Repeat count is specified</span>
<a name="l00516"></a>00516 <span class="keywordtype">int</span> count;
<a name="l00517"></a>00517 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"login"</span>))
<a name="l00518"></a>00518 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--login"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--interval"</span>)))
<a name="l00519"></a>00519 <span class="keywordtype">bool</span> ok;
<a name="l00520"></a>00520 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"repeat"</span>))
<a name="l00521"></a>00521 {
<a name="l00522"></a>00522 count = args->getOption(<span class="stringliteral">"repeat"</span>).toInt(&ok);
<a name="l00523"></a>00523 <span class="keywordflow">if</span> (!ok || !count || count < -1 || (count < 0 && haveRecurrence))
<a name="l00524"></a>00524 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--repeat"</span>)))
<a name="l00525"></a>00525 }
<a name="l00526"></a>00526 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (haveRecurrence)
<a name="l00527"></a>00527 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--interval"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--repeat"</span>)))
<a name="l00528"></a>00528 else if (args->isSet("until"))
<a name="l00529"></a>00529 {
<a name="l00530"></a>00530 count = 0;
<a name="l00531"></a>00531 QCString dateTime = args->getOption(<span class="stringliteral">"until"</span>);
<a name="l00532"></a>00532 <span class="keywordflow">if</span> (!convWakeTime(dateTime, endTime, alarmNoTime))
<a name="l00533"></a>00533 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--until"</span>)))
<a name="l00534"></a>00534 if (endTime < alarmTime)
<a name="l00535"></a>00535 USAGE(i18n("%1 earlier than %2").arg(QString::fromLatin1("--until")).arg(QString::fromLatin1("--time")))
<a name="l00536"></a>00536 }
<a name="l00537"></a>00537 else
<a name="l00538"></a>00538 count = -1;
<a name="l00539"></a>00539
<a name="l00540"></a>00540 <span class="comment">// Get the recurrence interval</span>
<a name="l00541"></a>00541 <span class="keywordtype">int</span> interval;
<a name="l00542"></a>00542 KARecurrence::Type recurType;
<a name="l00543"></a>00543 if (!convInterval(args->getOption("interval"), recurType, interval, !haveRecurrence)
<a name="l00544"></a>00544 || interval < 0)
<a name="l00545"></a>00545 USAGE(i18n("Invalid %1 parameter").arg(QString::fromLatin1("--interval")))
<a name="l00546"></a>00546 if (alarmNoTime && recurType == KARecurrence::MINUTELY)
<a name="l00547"></a>00547 USAGE(i18n("Invalid %1 parameter for date-only alarm").arg(QString::fromLatin1("--interval")))
<a name="l00548"></a>00548
<a name="l00549"></a>00549 if (haveRecurrence)
<a name="l00550"></a>00550 {
<a name="l00551"></a>00551 <span class="comment">// There is a also a recurrence specified, so set up a sub-repetition</span>
<a name="l00552"></a>00552 <span class="keywordtype">int</span> longestInterval = recurrence.longestInterval();
<a name="l00553"></a>00553 <span class="keywordflow">if</span> (count * interval > longestInterval)
<a name="l00554"></a>00554 USAGE(i18n(<span class="stringliteral">"Invalid %1 and %2 parameters: repetition is longer than %3 interval"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--interval"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--repeat"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--recurrence"</span>)));
<a name="l00555"></a>00555 repeatCount = count;
<a name="l00556"></a>00556 repeatInterval = interval;
<a name="l00557"></a>00557 }
<a name="l00558"></a>00558 <span class="keywordflow">else</span>
<a name="l00559"></a>00559 {
<a name="l00560"></a>00560 <span class="comment">// There is no other recurrence specified, so convert the repetition</span>
<a name="l00561"></a>00561 <span class="comment">// parameters into a KCal::Recurrence</span>
<a name="l00562"></a>00562 recurrence.set(recurType, interval, count, DateTime(alarmTime, alarmNoTime), endTime);
<a name="l00563"></a>00563 }
<a name="l00564"></a>00564 }
<a name="l00565"></a>00565 <span class="keywordflow">else</span>
<a name="l00566"></a>00566 {
<a name="l00567"></a>00567 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"repeat"</span>))
<a name="l00568"></a>00568 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--repeat"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--interval"</span>)))
<a name="l00569"></a>00569 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"until"</span>))
<a name="l00570"></a>00570 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--until"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--interval"</span>)))
<a name="l00571"></a>00571 }
<a name="l00572"></a>00572
<a name="l00573"></a>00573 QCString audioFile;
<a name="l00574"></a>00574 <span class="keywordtype">float</span> audioVolume = -1;
<a name="l00575"></a>00575 <span class="preprocessor">#ifdef WITHOUT_ARTS</span>
<a name="l00576"></a>00576 <span class="preprocessor"></span> <span class="keywordtype">bool</span> audioRepeat = <span class="keyword">false</span>;
<a name="l00577"></a>00577 <span class="preprocessor">#else</span>
<a name="l00578"></a>00578 <span class="preprocessor"></span> <span class="keywordtype">bool</span> audioRepeat = args->isSet(<span class="stringliteral">"play-repeat"</span>);
<a name="l00579"></a>00579 <span class="preprocessor">#endif</span>
<a name="l00580"></a>00580 <span class="preprocessor"></span> <span class="keywordflow">if</span> (audioRepeat || args->isSet(<span class="stringliteral">"play"</span>))
<a name="l00581"></a>00581 {
<a name="l00582"></a>00582 <span class="comment">// Play a sound with the alarm</span>
<a name="l00583"></a>00583 <span class="keywordflow">if</span> (audioRepeat && args->isSet(<span class="stringliteral">"play"</span>))
<a name="l00584"></a>00584 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--play"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--play-repeat"</span>)))
<a name="l00585"></a>00585 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"beep"</span>))
<a name="l00586"></a>00586 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--beep"</span>)).arg(QString::fromLatin1(audioRepeat ? <span class="stringliteral">"--play-repeat"</span> : <span class="stringliteral">"--play"</span>)))
<a name="l00587"></a>00587 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"speak"</span>))
<a name="l00588"></a>00588 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--speak"</span>)).arg(QString::fromLatin1(audioRepeat ? <span class="stringliteral">"--play-repeat"</span> : <span class="stringliteral">"--play"</span>)))
<a name="l00589"></a>00589 audioFile = args->getOption(audioRepeat ? <span class="stringliteral">"play-repeat"</span> : <span class="stringliteral">"play"</span>);
<a name="l00590"></a>00590 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00591"></a>00591 <span class="preprocessor"></span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"volume"</span>))
<a name="l00592"></a>00592 {
<a name="l00593"></a>00593 <span class="keywordtype">bool</span> ok;
<a name="l00594"></a>00594 <span class="keywordtype">int</span> volumepc = args->getOption(<span class="stringliteral">"volume"</span>).toInt(&ok);
<a name="l00595"></a>00595 <span class="keywordflow">if</span> (!ok || volumepc < 0 || volumepc > 100)
<a name="l00596"></a>00596 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--volume"</span>)))
<a name="l00597"></a>00597 audioVolume = static_cast<<span class="keywordtype">float</span>>(volumepc) / 100;
<a name="l00598"></a>00598 }
<a name="l00599"></a>00599 <span class="preprocessor">#endif</span>
<a name="l00600"></a>00600 <span class="preprocessor"></span> }
<a name="l00601"></a>00601 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00602"></a>00602 <span class="preprocessor"></span> <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"volume"</span>))
<a name="l00603"></a>00603 USAGE(i18n(<span class="stringliteral">"%1 requires %2 or %3"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--volume"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--play"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--play-repeat"</span>)))
<a name="l00604"></a>00604 #endif
<a name="l00605"></a>00605 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"speak"</span>))
<a name="l00606"></a>00606 {
<a name="l00607"></a>00607 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"beep"</span>))
<a name="l00608"></a>00608 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--beep"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--speak"</span>)))
<a name="l00609"></a>00609 <span class="keywordflow">if</span> (!mSpeechEnabled)
<a name="l00610"></a>00610 USAGE(i18n(<span class="stringliteral">"%1 requires speech synthesis to be configured using KTTSD"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--speak"</span>)))
<a name="l00611"></a>00611 }
<a name="l00612"></a>00612 <span class="keywordtype">int</span> reminderMinutes = 0;
<a name="l00613"></a>00613 <span class="keywordtype">bool</span> onceOnly = args->isSet(<span class="stringliteral">"reminder-once"</span>);
<a name="l00614"></a>00614 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"reminder"</span>) || onceOnly)
<a name="l00615"></a>00615 {
<a name="l00616"></a>00616 <span class="comment">// Issue a reminder alarm in advance of the main alarm</span>
<a name="l00617"></a>00617 <span class="keywordflow">if</span> (onceOnly && args->isSet(<span class="stringliteral">"reminder"</span>))
<a name="l00618"></a>00618 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--reminder"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--reminder-once"</span>)))
<a name="l00619"></a>00619 QString opt = onceOnly ? QString::fromLatin1(<span class="stringliteral">"--reminder-once"</span>) : QString::fromLatin1(<span class="stringliteral">"--reminder"</span>);
<a name="l00620"></a>00620 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"exec"</span>))
<a name="l00621"></a>00621 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(opt).arg(QString::fromLatin1(<span class="stringliteral">"--exec"</span>)))
<a name="l00622"></a>00622 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"mail"</span>))
<a name="l00623"></a>00623 USAGE(i18n(<span class="stringliteral">"%1 incompatible with %2"</span>).arg(opt).arg(QString::fromLatin1(<span class="stringliteral">"--mail"</span>)))
<a name="l00624"></a>00624 KARecurrence::Type recurType;
<a name="l00625"></a>00625 QString optval = args->getOption(onceOnly ? <span class="stringliteral">"reminder-once"</span> : <span class="stringliteral">"reminder"</span>);
<a name="l00626"></a>00626 <span class="keywordflow">if</span> (!convInterval(args->getOption(onceOnly ? <span class="stringliteral">"reminder-once"</span> : <span class="stringliteral">"reminder"</span>), recurType, reminderMinutes))
<a name="l00627"></a>00627 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(opt))
<a name="l00628"></a>00628 if (recurType == KARecurrence::MINUTELY && alarmNoTime)
<a name="l00629"></a>00629 USAGE(i18n("Invalid %1 parameter for date-only alarm").arg(opt))
<a name="l00630"></a>00630 }
<a name="l00631"></a>00631
<a name="l00632"></a>00632 <span class="keywordtype">int</span> lateCancel = 0;
<a name="l00633"></a>00633 if (args->isSet("late-cancel"))
<a name="l00634"></a>00634 {
<a name="l00635"></a>00635 KARecurrence::Type recurType;
<a name="l00636"></a>00636 <span class="keywordtype">bool</span> ok = convInterval(args->getOption(<span class="stringliteral">"late-cancel"</span>), recurType, lateCancel);
<a name="l00637"></a>00637 <span class="keywordflow">if</span> (!ok || lateCancel <= 0)
<a name="l00638"></a>00638 USAGE(i18n(<span class="stringliteral">"Invalid %1 parameter"</span>).arg(QString::fromLatin1(<span class="stringliteral">"late-cancel"</span>)))
<a name="l00639"></a>00639 }
<a name="l00640"></a>00640 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"auto-close"</span>))
<a name="l00641"></a>00641 USAGE(i18n(<span class="stringliteral">"%1 requires %2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--auto-close"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--late-cancel"</span>)))
<a name="l00642"></a>00642
<a name="l00643"></a>00643 <span class="keywordtype">int</span> flags = KAEvent::DEFAULT_FONT;
<a name="l00644"></a>00644 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"ack-confirm"</span>))
<a name="l00645"></a>00645 flags |= KAEvent::CONFIRM_ACK;
<a name="l00646"></a>00646 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"auto-close"</span>))
<a name="l00647"></a>00647 flags |= KAEvent::AUTO_CLOSE;
<a name="l00648"></a>00648 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"beep"</span>))
<a name="l00649"></a>00649 flags |= KAEvent::BEEP;
<a name="l00650"></a>00650 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"speak"</span>))
<a name="l00651"></a>00651 flags |= KAEvent::SPEAK;
<a name="l00652"></a>00652 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"korganizer"</span>))
<a name="l00653"></a>00653 flags |= KAEvent::COPY_KORGANIZER;
<a name="l00654"></a>00654 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"disable"</span>))
<a name="l00655"></a>00655 flags |= KAEvent::DISABLED;
<a name="l00656"></a>00656 <span class="keywordflow">if</span> (audioRepeat)
<a name="l00657"></a>00657 flags |= KAEvent::REPEAT_SOUND;
<a name="l00658"></a>00658 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"login"</span>))
<a name="l00659"></a>00659 flags |= KAEvent::REPEAT_AT_LOGIN;
<a name="l00660"></a>00660 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"bcc"</span>))
<a name="l00661"></a>00661 flags |= KAEvent::EMAIL_BCC;
<a name="l00662"></a>00662 <span class="keywordflow">if</span> (alarmNoTime)
<a name="l00663"></a>00663 flags |= KAEvent::ANY_TIME;
<a name="l00664"></a>00664 args->clear(); <span class="comment">// free up memory</span>
<a name="l00665"></a>00665
<a name="l00666"></a>00666 <span class="comment">// Display or schedule the event</span>
<a name="l00667"></a>00667 <span class="keywordflow">if</span> (!initCheck())
<a name="l00668"></a>00668 {
<a name="l00669"></a>00669 exitCode = 1;
<a name="l00670"></a>00670 <span class="keywordflow">break</span>;
<a name="l00671"></a>00671 }
<a name="l00672"></a>00672 <span class="keywordflow">if</span> (!scheduleEvent(action, alMessage, alarmTime, lateCancel, flags, bgColour, fgColour, QFont(), audioFile,
<a name="l00673"></a>00673 audioVolume, reminderMinutes, recurrence, repeatInterval, repeatCount,
<a name="l00674"></a>00674 alFromID, alAddresses, alSubject, alAttachments))
<a name="l00675"></a>00675 {
<a name="l00676"></a>00676 exitCode = 1;
<a name="l00677"></a>00677 <span class="keywordflow">break</span>;
<a name="l00678"></a>00678 }
<a name="l00679"></a>00679 }
<a name="l00680"></a>00680 <span class="keywordflow">else</span>
<a name="l00681"></a>00681 {
<a name="l00682"></a>00682 <span class="comment">// No arguments - run interactively & display the main window</span>
<a name="l00683"></a>00683 kdDebug(5950)<<<span class="stringliteral">"KAlarmApp::newInstance(): interactive\n"</span>;
<a name="l00684"></a>00684 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"ack-confirm"</span>))
<a name="l00685"></a>00685 usage += QString::fromLatin1(<span class="stringliteral">"--ack-confirm "</span>);
<a name="l00686"></a>00686 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"attach"</span>))
<a name="l00687"></a>00687 usage += QString::fromLatin1(<span class="stringliteral">"--attach "</span>);
<a name="l00688"></a>00688 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"auto-close"</span>))
<a name="l00689"></a>00689 usage += QString::fromLatin1(<span class="stringliteral">"--auto-close "</span>);
<a name="l00690"></a>00690 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"bcc"</span>))
<a name="l00691"></a>00691 usage += QString::fromLatin1(<span class="stringliteral">"--bcc "</span>);
<a name="l00692"></a>00692 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"beep"</span>))
<a name="l00693"></a>00693 usage += QString::fromLatin1(<span class="stringliteral">"--beep "</span>);
<a name="l00694"></a>00694 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"color"</span>))
<a name="l00695"></a>00695 usage += QString::fromLatin1(<span class="stringliteral">"--color "</span>);
<a name="l00696"></a>00696 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"colorfg"</span>))
<a name="l00697"></a>00697 usage += QString::fromLatin1(<span class="stringliteral">"--colorfg "</span>);
<a name="l00698"></a>00698 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"disable"</span>))
<a name="l00699"></a>00699 usage += QString::fromLatin1(<span class="stringliteral">"--disable "</span>);
<a name="l00700"></a>00700 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"from-id"</span>))
<a name="l00701"></a>00701 usage += QString::fromLatin1(<span class="stringliteral">"--from-id "</span>);
<a name="l00702"></a>00702 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"korganizer"</span>))
<a name="l00703"></a>00703 usage += QString::fromLatin1(<span class="stringliteral">"--korganizer "</span>);
<a name="l00704"></a>00704 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"late-cancel"</span>))
<a name="l00705"></a>00705 usage += QString::fromLatin1(<span class="stringliteral">"--late-cancel "</span>);
<a name="l00706"></a>00706 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"login"</span>))
<a name="l00707"></a>00707 usage += QString::fromLatin1(<span class="stringliteral">"--login "</span>);
<a name="l00708"></a>00708 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"play"</span>))
<a name="l00709"></a>00709 usage += QString::fromLatin1(<span class="stringliteral">"--play "</span>);
<a name="l00710"></a>00710 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00711"></a>00711 <span class="preprocessor"></span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"play-repeat"</span>))
<a name="l00712"></a>00712 usage += QString::fromLatin1(<span class="stringliteral">"--play-repeat "</span>);
<a name="l00713"></a>00713 <span class="preprocessor">#endif</span>
<a name="l00714"></a>00714 <span class="preprocessor"></span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"reminder"</span>))
<a name="l00715"></a>00715 usage += QString::fromLatin1(<span class="stringliteral">"--reminder "</span>);
<a name="l00716"></a>00716 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"reminder-once"</span>))
<a name="l00717"></a>00717 usage += QString::fromLatin1(<span class="stringliteral">"--reminder-once "</span>);
<a name="l00718"></a>00718 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"speak"</span>))
<a name="l00719"></a>00719 usage += QString::fromLatin1(<span class="stringliteral">"--speak "</span>);
<a name="l00720"></a>00720 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"subject"</span>))
<a name="l00721"></a>00721 usage += QString::fromLatin1(<span class="stringliteral">"--subject "</span>);
<a name="l00722"></a>00722 <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"time"</span>))
<a name="l00723"></a>00723 usage += QString::fromLatin1(<span class="stringliteral">"--time "</span>);
<a name="l00724"></a>00724 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00725"></a>00725 <span class="preprocessor"></span> <span class="keywordflow">if</span> (args->isSet(<span class="stringliteral">"volume"</span>))
<a name="l00726"></a>00726 usage += QString::fromLatin1(<span class="stringliteral">"--volume "</span>);
<a name="l00727"></a>00727 <span class="preprocessor">#endif</span>
<a name="l00728"></a>00728 <span class="preprocessor"></span> <span class="keywordflow">if</span> (!usage.isEmpty())
<a name="l00729"></a>00729 {
<a name="l00730"></a>00730 usage += i18n(<span class="stringliteral">": option(s) only valid with a message/%1/%2"</span>).arg(QString::fromLatin1(<span class="stringliteral">"--file"</span>)).arg(QString::fromLatin1(<span class="stringliteral">"--exec"</span>));
<a name="l00731"></a>00731 <span class="keywordflow">break</span>;
<a name="l00732"></a>00732 }
<a name="l00733"></a>00733
<a name="l00734"></a>00734 args->clear(); <span class="comment">// free up memory</span>
<a name="l00735"></a>00735 <span class="comment">/* Instead of calling initCheck (), call initCheck (true) to check the calendar only.</span>
<a name="l00736"></a>00736 <span class="comment"> * This works because it doesn't change the return value:</span>
<a name="l00737"></a>00737 <span class="comment"> * If the return value is false, it doesn't matter because we exit.</span>
<a name="l00738"></a>00738 <span class="comment"> * If the return value is true, the first thing MainWindow() does, is to call initCheck(), so we do the same tests. </span>
<a name="l00739"></a>00739 <span class="comment"> * Jonas Wustrack - jwustrack@mandriva.com */</span>
<a name="l00740"></a>00740 <span class="keywordflow">if</span> (!initCheck(<span class="keyword">true</span>))
<a name="l00741"></a>00741 {
<a name="l00742"></a>00742 exitCode = 1;
<a name="l00743"></a>00743 <span class="keywordflow">break</span>;
<a name="l00744"></a>00744 }
<a name="l00745"></a>00745
<a name="l00746"></a>00746 (MainWindow::create())->show();
<a name="l00747"></a>00747 }
<a name="l00748"></a>00748 } <span class="keywordflow">while</span> (0); <span class="comment">// only execute once</span>
<a name="l00749"></a>00749
<a name="l00750"></a>00750 <span class="keywordflow">if</span> (!usage.isEmpty())
<a name="l00751"></a>00751 {
<a name="l00752"></a>00752 <span class="comment">// Note: we can't use args->usage() since that also quits any other</span>
<a name="l00753"></a>00753 <span class="comment">// running 'instances' of the program.</span>
<a name="l00754"></a>00754 std::cerr << usage.local8Bit().data()
<a name="l00755"></a>00755 << i18n(<span class="stringliteral">"\nUse --help to get a list of available command line options.\n"</span>).local8Bit().data();
<a name="l00756"></a>00756 exitCode = 1;
<a name="l00757"></a>00757 }
<a name="l00758"></a>00758 }
<a name="l00759"></a>00759 <span class="keywordflow">if</span> (firstInstance && !dontRedisplay && !exitCode)
<a name="l00760"></a>00760 redisplayAlarms();
<a name="l00761"></a>00761
<a name="l00762"></a>00762 --mActiveCount;
<a name="l00763"></a>00763 firstInstance = <span class="keyword">false</span>;
<a name="l00764"></a>00764
<a name="l00765"></a>00765 <span class="comment">// Quit the application if this was the last/only running "instance" of the program.</span>
<a name="l00766"></a>00766 <span class="comment">// Executing 'return' doesn't work very well since the program continues to</span>
<a name="l00767"></a>00767 <span class="comment">// run if no windows were created.</span>
<a name="l00768"></a>00768 quitIf(exitCode);
<a name="l00769"></a>00769 <span class="keywordflow">return</span> exitCode;
<a name="l00770"></a>00770 }
<a name="l00771"></a>00771
<a name="l00772"></a>00772 <span class="comment">/******************************************************************************</span>
<a name="l00773"></a>00773 <span class="comment">* Quit the program, optionally only if there are no more "instances" running.</span>
<a name="l00774"></a>00774 <span class="comment">*/</span>
<a name="l00775"></a>00775 <span class="keywordtype">void</span> KAlarmApp::quitIf(<span class="keywordtype">int</span> exitCode, <span class="keywordtype">bool</span> force)
<a name="l00776"></a>00776 {
<a name="l00777"></a>00777 <span class="keywordflow">if</span> (force)
<a name="l00778"></a>00778 {
<a name="l00779"></a>00779 <span class="comment">// Quit regardless, except for message windows</span>
<a name="l00780"></a>00780 MainWindow::closeAll();
<a name="l00781"></a>00781 displayTrayIcon(<span class="keyword">false</span>);
<a name="l00782"></a>00782 <span class="keywordflow">if</span> (MessageWin::instanceCount())
<a name="l00783"></a>00783 <span class="keywordflow">return</span>;
<a name="l00784"></a>00784 }
<a name="l00785"></a>00785 <span class="keywordflow">else</span>
<a name="l00786"></a>00786 {
<a name="l00787"></a>00787 <span class="comment">// Quit only if there are no more "instances" running</span>
<a name="l00788"></a>00788 mPendingQuit = <span class="keyword">false</span>;
<a name="l00789"></a>00789 <span class="keywordflow">if</span> (mActiveCount > 0 || MessageWin::instanceCount())
<a name="l00790"></a>00790 <span class="keywordflow">return</span>;
<a name="l00791"></a>00791 <span class="keywordtype">int</span> mwcount = MainWindow::count();
<a name="l00792"></a>00792 MainWindow* mw = mwcount ? MainWindow::firstWindow() : 0;
<a name="l00793"></a>00793 <span class="keywordflow">if</span> (mwcount > 1 || mwcount && (!mw->isHidden() || !mw->isTrayParent()))
<a name="l00794"></a>00794 <span class="keywordflow">return</span>;
<a name="l00795"></a>00795 <span class="comment">// There are no windows left except perhaps a main window which is a hidden tray icon parent</span>
<a name="l00796"></a>00796 <span class="keywordflow">if</span> (mTrayWindow)
<a name="l00797"></a>00797 {
<a name="l00798"></a>00798 <span class="comment">// There is a system tray icon.</span>
<a name="l00799"></a>00799 <span class="comment">// Don't exit unless the system tray doesn't seem to exist.</span>
<a name="l00800"></a>00800 <span class="keywordflow">if</span> (checkSystemTray())
<a name="l00801"></a>00801 <span class="keywordflow">return</span>;
<a name="l00802"></a>00802 }
<a name="l00803"></a>00803 <span class="keywordflow">if</span> (!mDcopQueue.isEmpty() || !mCommandProcesses.isEmpty())
<a name="l00804"></a>00804 {
<a name="l00805"></a>00805 <span class="comment">// Don't quit yet if there are outstanding actions on the DCOP queue</span>
<a name="l00806"></a>00806 mPendingQuit = <span class="keyword">true</span>;
<a name="l00807"></a>00807 mPendingQuitCode = exitCode;
<a name="l00808"></a>00808 <span class="keywordflow">return</span>;
<a name="l00809"></a>00809 }
<a name="l00810"></a>00810 }
<a name="l00811"></a>00811
<a name="l00812"></a>00812 <span class="comment">// This was the last/only running "instance" of the program, so exit completely.</span>
<a name="l00813"></a>00813 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::quitIf("</span> << exitCode << <span class="stringliteral">"): quitting"</span> << endl;
<a name="l00814"></a>00814 exit(exitCode);
<a name="l00815"></a>00815 }
<a name="l00816"></a>00816
<a name="l00817"></a>00817 <span class="comment">/******************************************************************************</span>
<a name="l00818"></a>00818 <span class="comment">* Called when the Quit menu item is selected.</span>
<a name="l00819"></a>00819 <span class="comment">* Closes the system tray window and all main windows, but does not exit the</span>
<a name="l00820"></a>00820 <span class="comment">* program if other windows are still open.</span>
<a name="l00821"></a>00821 <span class="comment">*/</span>
<a name="l00822"></a>00822 <span class="keywordtype">void</span> KAlarmApp::doQuit(QWidget* parent)
<a name="l00823"></a>00823 {
<a name="l00824"></a>00824 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::doQuit()\n"</span>;
<a name="l00825"></a>00825 <span class="keywordflow">if</span> (mDisableAlarmsIfStopped
<a name="l00826"></a>00826 && MessageBox::warningContinueCancel(parent, KMessageBox::Cancel,
<a name="l00827"></a>00827 i18n(<span class="stringliteral">"Quitting will disable alarms\n(once any alarm message windows are closed)."</span>),
<a name="l00828"></a>00828 QString::null, KStdGuiItem::quit(), Preferences::QUIT_WARN
<a name="l00829"></a>00829 ) != KMessageBox::Yes)
<a name="l00830"></a>00830 <span class="keywordflow">return</span>;
<a name="l00831"></a>00831 quitIf(0, <span class="keyword">true</span>);
<a name="l00832"></a>00832 }
<a name="l00833"></a>00833
<a name="l00834"></a>00834 <span class="comment">/******************************************************************************</span>
<a name="l00835"></a>00835 <span class="comment">* Called when the session manager is about to close down the application.</span>
<a name="l00836"></a>00836 <span class="comment">*/</span>
<a name="l00837"></a>00837 <span class="keywordtype">void</span> KAlarmApp::commitData(QSessionManager& sm)
<a name="l00838"></a>00838 {
<a name="l00839"></a>00839 mSessionClosingDown = <span class="keyword">true</span>;
<a name="l00840"></a>00840 KUniqueApplication::commitData(sm);
<a name="l00841"></a>00841 mSessionClosingDown = <span class="keyword">false</span>; <span class="comment">// reset in case shutdown is cancelled</span>
<a name="l00842"></a>00842 }
<a name="l00843"></a>00843
<a name="l00844"></a>00844 <span class="comment">/******************************************************************************</span>
<a name="l00845"></a>00845 <span class="comment">* Display an error message for a fatal error. Prevent further actions since</span>
<a name="l00846"></a>00846 <span class="comment">* the program state is unsafe.</span>
<a name="l00847"></a>00847 <span class="comment">*/</span>
<a name="l00848"></a>00848 <span class="keywordtype">void</span> KAlarmApp::displayFatalError(<span class="keyword">const</span> QString& message)
<a name="l00849"></a>00849 {
<a name="l00850"></a>00850 <span class="keywordflow">if</span> (!mFatalError)
<a name="l00851"></a>00851 {
<a name="l00852"></a>00852 mFatalError = 1;
<a name="l00853"></a>00853 mFatalMessage = message;
<a name="l00854"></a>00854 <span class="keywordflow">if</span> (theInstance)
<a name="l00855"></a>00855 QTimer::singleShot(0, theInstance, SLOT(quitFatal()));
<a name="l00856"></a>00856 }
<a name="l00857"></a>00857 }
<a name="l00858"></a>00858
<a name="l00859"></a>00859 <span class="comment">/******************************************************************************</span>
<a name="l00860"></a>00860 <span class="comment">* Quit the program, once the fatal error message has been acknowledged.</span>
<a name="l00861"></a>00861 <span class="comment">*/</span>
<a name="l00862"></a>00862 <span class="keywordtype">void</span> KAlarmApp::quitFatal()
<a name="l00863"></a>00863 {
<a name="l00864"></a>00864 <span class="keywordflow">switch</span> (mFatalError)
<a name="l00865"></a>00865 {
<a name="l00866"></a>00866 <span class="keywordflow">case</span> 0:
<a name="l00867"></a>00867 <span class="keywordflow">case</span> 2:
<a name="l00868"></a>00868 <span class="keywordflow">return</span>;
<a name="l00869"></a>00869 <span class="keywordflow">case</span> 1:
<a name="l00870"></a>00870 mFatalError = 2;
<a name="l00871"></a>00871 KMessageBox::error(0, mFatalMessage);
<a name="l00872"></a>00872 mFatalError = 3;
<a name="l00873"></a>00873 <span class="comment">// fall through to '3'</span>
<a name="l00874"></a>00874 <span class="keywordflow">case</span> 3:
<a name="l00875"></a>00875 <span class="keywordflow">if</span> (theInstance)
<a name="l00876"></a>00876 theInstance->quitIf(1, <span class="keyword">true</span>);
<a name="l00877"></a>00877 <span class="keywordflow">break</span>;
<a name="l00878"></a>00878 }
<a name="l00879"></a>00879 QTimer::singleShot(1000, <span class="keyword">this</span>, SLOT(quitFatal()));
<a name="l00880"></a>00880 }
<a name="l00881"></a>00881
<a name="l00882"></a>00882 <span class="comment">/******************************************************************************</span>
<a name="l00883"></a>00883 <span class="comment">* The main processing loop for KAlarm.</span>
<a name="l00884"></a>00884 <span class="comment">* All KAlarm operations involving opening or updating calendar files are called</span>
<a name="l00885"></a>00885 <span class="comment">* from this loop to ensure that only one operation is active at any one time.</span>
<a name="l00886"></a>00886 <span class="comment">* This precaution is necessary because KAlarm's activities are mostly</span>
<a name="l00887"></a>00887 <span class="comment">* asynchronous, being in response to DCOP calls from the alarm daemon (or other</span>
<a name="l00888"></a>00888 <span class="comment">* programs) or timer events, any of which can be received in the middle of</span>
<a name="l00889"></a>00889 <span class="comment">* performing another operation. If a calendar file is opened or updated while</span>
<a name="l00890"></a>00890 <span class="comment">* another calendar operation is in progress, the program has been observed to</span>
<a name="l00891"></a>00891 <span class="comment">* hang, or the first calendar call has failed with data loss - clearly</span>
<a name="l00892"></a>00892 <span class="comment">* unacceptable!!</span>
<a name="l00893"></a>00893 <span class="comment">*/</span>
<a name="l00894"></a>00894 <span class="keywordtype">void</span> KAlarmApp::processQueue()
<a name="l00895"></a>00895 {
<a name="l00896"></a>00896 <span class="keywordflow">if</span> (mInitialised && !mProcessingQueue)
<a name="l00897"></a>00897 {
<a name="l00898"></a>00898 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::processQueue()\n"</span>;
<a name="l00899"></a>00899 mProcessingQueue = <span class="keyword">true</span>;
<a name="l00900"></a>00900
<a name="l00901"></a>00901 <span class="comment">// Reset the alarm daemon if it's been queued</span>
<a name="l00902"></a>00902 KAlarm::resetDaemonIfQueued();
<a name="l00903"></a>00903
<a name="l00904"></a>00904 <span class="comment">// Process DCOP calls</span>
<a name="l00905"></a>00905 <span class="keywordflow">while</span> (!mDcopQueue.isEmpty())
<a name="l00906"></a>00906 {
<a name="l00907"></a>00907 DcopQEntry& entry = mDcopQueue.first();
<a name="l00908"></a>00908 <span class="keywordflow">if</span> (entry.eventId.isEmpty())
<a name="l00909"></a>00909 {
<a name="l00910"></a>00910 <span class="comment">// It's a new alarm</span>
<a name="l00911"></a>00911 <span class="keywordflow">switch</span> (entry.function)
<a name="l00912"></a>00912 {
<a name="l00913"></a>00913 <span class="keywordflow">case</span> EVENT_TRIGGER:
<a name="l00914"></a>00914 execAlarm(entry.event, entry.event.firstAlarm(), <span class="keyword">false</span>);
<a name="l00915"></a>00915 <span class="keywordflow">break</span>;
<a name="l00916"></a>00916 <span class="keywordflow">case</span> EVENT_HANDLE:
<a name="l00917"></a>00917 KAlarm::addEvent(entry.event, 0);
<a name="l00918"></a>00918 <span class="keywordflow">break</span>;
<a name="l00919"></a>00919 <span class="keywordflow">case</span> EVENT_CANCEL:
<a name="l00920"></a>00920 <span class="keywordflow">break</span>;
<a name="l00921"></a>00921 }
<a name="l00922"></a>00922 }
<a name="l00923"></a>00923 <span class="keywordflow">else</span>
<a name="l00924"></a>00924 handleEvent(entry.eventId, entry.function);
<a name="l00925"></a>00925 mDcopQueue.pop_front();
<a name="l00926"></a>00926 }
<a name="l00927"></a>00927
<a name="l00928"></a>00928 <span class="comment">// Purge the expired alarms calendar if it's time to do so</span>
<a name="l00929"></a>00929 AlarmCalendar::expiredCalendar()-><a class="code" href="classAlarmCalendar.html#c4b1048735efd17b5fd262b5cff55cd5">purgeIfQueued</a>();
<a name="l00930"></a>00930
<a name="l00931"></a>00931 <span class="comment">// Now that the queue has been processed, quit if a quit was queued</span>
<a name="l00932"></a>00932 <span class="keywordflow">if</span> (mPendingQuit)
<a name="l00933"></a>00933 quitIf(mPendingQuitCode);
<a name="l00934"></a>00934
<a name="l00935"></a>00935 mProcessingQueue = <span class="keyword">false</span>;
<a name="l00936"></a>00936 }
<a name="l00937"></a>00937 }
<a name="l00938"></a>00938
<a name="l00939"></a>00939 <span class="comment">/******************************************************************************</span>
<a name="l00940"></a>00940 <span class="comment">* Redisplay alarms which were being shown when the program last exited.</span>
<a name="l00941"></a>00941 <span class="comment">* Normally, these alarms will have been displayed by session restoration, but</span>
<a name="l00942"></a>00942 <span class="comment">* if the program crashed or was killed, we can redisplay them here so that</span>
<a name="l00943"></a>00943 <span class="comment">* they won't be lost.</span>
<a name="l00944"></a>00944 <span class="comment">*/</span>
<a name="l00945"></a>00945 <span class="keywordtype">void</span> KAlarmApp::redisplayAlarms()
<a name="l00946"></a>00946 {
<a name="l00947"></a>00947 <a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>* cal = AlarmCalendar::displayCalendar();
<a name="l00948"></a>00948 <span class="keywordflow">if</span> (cal-><a class="code" href="classAlarmCalendar.html#021bd79d94b5f0f5d26af2ab15a11776">isOpen</a>())
<a name="l00949"></a>00949 {
<a name="l00950"></a>00950 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1ListBase.html">KCal::Event::List</a> events = cal-><a class="code" href="classAlarmCalendar.html#37b71fc12e2394339156aabbb802946c">events</a>();
<a name="l00951"></a>00951 <span class="keywordflow">for</span> (KCal::Event::List::ConstIterator it = events.begin(); it != events.end(); ++it)
<a name="l00952"></a>00952 {
<a name="l00953"></a>00953 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">KCal::Event</a>* kcalEvent = *it;
<a name="l00954"></a>00954 <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event(*kcalEvent);
<a name="l00955"></a>00955 <span class="keyword">event</span>.setUid(KAEvent::ACTIVE);
<a name="l00956"></a>00956 <span class="keywordflow">if</span> (!MessageWin::findEvent(event.id()))
<a name="l00957"></a>00957 {
<a name="l00958"></a>00958 <span class="comment">// This event should be displayed, but currently isn't being</span>
<a name="l00959"></a>00959 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::redisplayAlarms(): "</span> << <span class="keyword">event</span>.id() << endl;
<a name="l00960"></a>00960 KAAlarm alarm = <span class="keyword">event</span>.convertDisplayingAlarm();
<a name="l00961"></a>00961 (<span class="keyword">new</span> <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>(event, alarm, <span class="keyword">false</span>, !alarm.repeatAtLogin()))->show();
<a name="l00962"></a>00962 }
<a name="l00963"></a>00963 }
<a name="l00964"></a>00964 }
<a name="l00965"></a>00965 }
<a name="l00966"></a>00966
<a name="l00967"></a>00967 <span class="comment">/******************************************************************************</span>
<a name="l00968"></a>00968 <span class="comment">* Called when the system tray main window is closed.</span>
<a name="l00969"></a>00969 <span class="comment">*/</span>
<a name="l00970"></a>00970 <span class="keywordtype">void</span> KAlarmApp::removeWindow(TrayWindow*)
<a name="l00971"></a>00971 {
<a name="l00972"></a>00972 mTrayWindow = 0;
<a name="l00973"></a>00973 quitIf();
<a name="l00974"></a>00974 }
<a name="l00975"></a>00975
<a name="l00976"></a>00976 <span class="comment">/******************************************************************************</span>
<a name="l00977"></a>00977 <span class="comment">* Display or close the system tray icon.</span>
<a name="l00978"></a>00978 <span class="comment">*/</span>
<a name="l00979"></a>00979 <span class="keywordtype">bool</span> KAlarmApp::displayTrayIcon(<span class="keywordtype">bool</span> show, MainWindow* parent)
<a name="l00980"></a>00980 {
<a name="l00981"></a>00981 <span class="keyword">static</span> <span class="keywordtype">bool</span> creating = <span class="keyword">false</span>;
<a name="l00982"></a>00982 <span class="keywordflow">if</span> (show)
<a name="l00983"></a>00983 {
<a name="l00984"></a>00984 <span class="keywordflow">if</span> (!mTrayWindow && !creating)
<a name="l00985"></a>00985 {
<a name="l00986"></a>00986 <span class="keywordflow">if</span> (!mHaveSystemTray)
<a name="l00987"></a>00987 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00988"></a>00988 <span class="keywordflow">if</span> (!MainWindow::count() && wantRunInSystemTray())
<a name="l00989"></a>00989 {
<a name="l00990"></a>00990 creating = <span class="keyword">true</span>; <span class="comment">// prevent main window constructor from creating an additional tray icon</span>
<a name="l00991"></a>00991 parent = MainWindow::create();
<a name="l00992"></a>00992 creating = <span class="keyword">false</span>;
<a name="l00993"></a>00993 }
<a name="l00994"></a>00994 mTrayWindow = <span class="keyword">new</span> TrayWindow(parent ? parent : MainWindow::firstWindow());
<a name="l00995"></a>00995 connect(mTrayWindow, SIGNAL(deleted()), SIGNAL(trayIconToggled()));
<a name="l00996"></a>00996 mTrayWindow->show();
<a name="l00997"></a>00997 emit trayIconToggled();
<a name="l00998"></a>00998
<a name="l00999"></a>00999 <span class="comment">// Set up a timer so that we can check after all events in the window system's</span>
<a name="l01000"></a>01000 <span class="comment">// event queue have been processed, whether the system tray actually exists</span>
<a name="l01001"></a>01001 mCheckingSystemTray = <span class="keyword">true</span>;
<a name="l01002"></a>01002 mSavedNoSystemTray = mNoSystemTray;
<a name="l01003"></a>01003 mNoSystemTray = <span class="keyword">false</span>;
<a name="l01004"></a>01004 QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotSystemTrayTimer()));
<a name="l01005"></a>01005 }
<a name="l01006"></a>01006 }
<a name="l01007"></a>01007 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mTrayWindow)
<a name="l01008"></a>01008 {
<a name="l01009"></a>01009 <span class="keyword">delete</span> mTrayWindow;
<a name="l01010"></a>01010 mTrayWindow = 0;
<a name="l01011"></a>01011 }
<a name="l01012"></a>01012 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01013"></a>01013 }
<a name="l01014"></a>01014
<a name="l01015"></a>01015 <span class="comment">/******************************************************************************</span>
<a name="l01016"></a>01016 <span class="comment">* Called by a timer to check whether the system tray icon has been housed in</span>
<a name="l01017"></a>01017 <span class="comment">* the system tray. Because there is a delay between the system tray icon show</span>
<a name="l01018"></a>01018 <span class="comment">* event and the icon being reparented by the system tray, we have to use a</span>
<a name="l01019"></a>01019 <span class="comment">* timer to check whether the system tray has actually grabbed it, or whether</span>
<a name="l01020"></a>01020 <span class="comment">* the system tray probably doesn't exist.</span>
<a name="l01021"></a>01021 <span class="comment">*/</span>
<a name="l01022"></a>01022 <span class="keywordtype">void</span> KAlarmApp::slotSystemTrayTimer()
<a name="l01023"></a>01023 {
<a name="l01024"></a>01024 mCheckingSystemTray = <span class="keyword">false</span>;
<a name="l01025"></a>01025 <span class="keywordflow">if</span> (!checkSystemTray())
<a name="l01026"></a>01026 quitIf(0); <span class="comment">// exit the application if there are no open windows</span>
<a name="l01027"></a>01027 }
<a name="l01028"></a>01028
<a name="l01029"></a>01029 <span class="comment">/******************************************************************************</span>
<a name="l01030"></a>01030 <span class="comment">* Check whether the system tray icon has been housed in the system tray.</span>
<a name="l01031"></a>01031 <span class="comment">* If the system tray doesn't seem to exist, tell the alarm daemon to notify us</span>
<a name="l01032"></a>01032 <span class="comment">* of alarms regardless of whether we're running.</span>
<a name="l01033"></a>01033 <span class="comment">*/</span>
<a name="l01034"></a>01034 <span class="keywordtype">bool</span> KAlarmApp::checkSystemTray()
<a name="l01035"></a>01035 {
<a name="l01036"></a>01036 <span class="keywordflow">if</span> (mCheckingSystemTray || !mTrayWindow)
<a name="l01037"></a>01037 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01038"></a>01038 <span class="keywordflow">if</span> (mTrayWindow->inSystemTray() != !mSavedNoSystemTray)
<a name="l01039"></a>01039 {
<a name="l01040"></a>01040 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::checkSystemTray(): changed -> "</span> << mSavedNoSystemTray << endl;
<a name="l01041"></a>01041 mNoSystemTray = mSavedNoSystemTray = !mSavedNoSystemTray;
<a name="l01042"></a>01042
<a name="l01043"></a>01043 <span class="comment">// Store the new setting in the config file, so that if KAlarm exits and is then</span>
<a name="l01044"></a>01044 <span class="comment">// next activated by the daemon to display a message, it will register with the</span>
<a name="l01045"></a>01045 <span class="comment">// daemon with the correct NOTIFY type. If that happened when there was no system</span>
<a name="l01046"></a>01046 <span class="comment">// tray and alarms are disabled when KAlarm is not running, registering with</span>
<a name="l01047"></a>01047 <span class="comment">// NO_START_NOTIFY could result in alarms never being seen.</span>
<a name="l01048"></a>01048 KConfig* config = kapp->config();
<a name="l01049"></a>01049 config->setGroup(QString::fromLatin1(<span class="stringliteral">"General"</span>));
<a name="l01050"></a>01050 config->writeEntry(QString::fromLatin1(<span class="stringliteral">"NoSystemTray"</span>), mNoSystemTray);
<a name="l01051"></a>01051 config->sync();
<a name="l01052"></a>01052
<a name="l01053"></a>01053 <span class="comment">// Update other settings and reregister with the alarm daemon</span>
<a name="l01054"></a>01054 slotPreferencesChanged();
<a name="l01055"></a>01055 }
<a name="l01056"></a>01056 <span class="keywordflow">else</span>
<a name="l01057"></a>01057 {
<a name="l01058"></a>01058 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::checkSystemTray(): no change = "</span> << !mSavedNoSystemTray << endl;
<a name="l01059"></a>01059 mNoSystemTray = mSavedNoSystemTray;
<a name="l01060"></a>01060 }
<a name="l01061"></a>01061 <span class="keywordflow">return</span> !mNoSystemTray;
<a name="l01062"></a>01062 }
<a name="l01063"></a>01063
<a name="l01064"></a>01064 <span class="comment">/******************************************************************************</span>
<a name="l01065"></a>01065 <span class="comment">* Return the main window associated with the system tray icon.</span>
<a name="l01066"></a>01066 <span class="comment">*/</span>
<a name="l01067"></a>01067 MainWindow* KAlarmApp::trayMainWindow()<span class="keyword"> const</span>
<a name="l01068"></a>01068 <span class="keyword"></span>{
<a name="l01069"></a>01069 <span class="keywordflow">return</span> mTrayWindow ? mTrayWindow->assocMainWindow() : 0;
<a name="l01070"></a>01070 }
<a name="l01071"></a>01071
<a name="l01072"></a>01072 <span class="comment">/******************************************************************************</span>
<a name="l01073"></a>01073 <span class="comment">* Called when KAlarm preferences have changed.</span>
<a name="l01074"></a>01074 <span class="comment">*/</span>
<a name="l01075"></a>01075 <span class="keywordtype">void</span> KAlarmApp::slotPreferencesChanged()
<a name="l01076"></a>01076 {
<a name="l01077"></a>01077 <span class="keywordtype">bool</span> newRunInSysTray = wantRunInSystemTray();
<a name="l01078"></a>01078 <span class="keywordflow">if</span> (newRunInSysTray != mOldRunInSystemTray)
<a name="l01079"></a>01079 {
<a name="l01080"></a>01080 <span class="comment">// The system tray run mode has changed</span>
<a name="l01081"></a>01081 ++mActiveCount; <span class="comment">// prevent the application from quitting</span>
<a name="l01082"></a>01082 MainWindow* win = mTrayWindow ? mTrayWindow->assocMainWindow() : 0;
<a name="l01083"></a>01083 <span class="keyword">delete</span> mTrayWindow; <span class="comment">// remove the system tray icon if it is currently shown</span>
<a name="l01084"></a>01084 mTrayWindow = 0;
<a name="l01085"></a>01085 mOldRunInSystemTray = newRunInSysTray;
<a name="l01086"></a>01086 <span class="keywordflow">if</span> (!newRunInSysTray)
<a name="l01087"></a>01087 {
<a name="l01088"></a>01088 <span class="keywordflow">if</span> (win && win->isHidden())
<a name="l01089"></a>01089 <span class="keyword">delete</span> win;
<a name="l01090"></a>01090 }
<a name="l01091"></a>01091 displayTrayIcon(<span class="keyword">true</span>);
<a name="l01092"></a>01092 --mActiveCount;
<a name="l01093"></a>01093 }
<a name="l01094"></a>01094
<a name="l01095"></a>01095 <span class="keywordtype">bool</span> newDisableIfStopped = wantRunInSystemTray() && !mNoSystemTray && Preferences::disableAlarmsIfStopped();
<a name="l01096"></a>01096 <span class="keywordflow">if</span> (newDisableIfStopped != mDisableAlarmsIfStopped)
<a name="l01097"></a>01097 {
<a name="l01098"></a>01098 mDisableAlarmsIfStopped = newDisableIfStopped; <span class="comment">// N.B. this setting is used by Daemon::reregister()</span>
<a name="l01099"></a>01099 Preferences::setQuitWarn(<span class="keyword">true</span>); <span class="comment">// since mode has changed, re-allow warning messages on Quit</span>
<a name="l01100"></a>01100 Daemon::reregister(); <span class="comment">// re-register with the alarm daemon</span>
<a name="l01101"></a>01101 }
<a name="l01102"></a>01102
<a name="l01103"></a>01103 <span class="comment">// Change alarm times for date-only alarms if the start of day time has changed</span>
<a name="l01104"></a>01104 <span class="keywordflow">if</span> (Preferences::startOfDay() != mStartOfDay)
<a name="l01105"></a>01105 changeStartOfDay();
<a name="l01106"></a>01106
<a name="l01107"></a>01107 <span class="comment">// In case the date for February 29th recurrences has changed</span>
<a name="l01108"></a>01108 KARecurrence::setDefaultFeb29Type(Preferences::defaultFeb29Type());
<a name="l01109"></a>01109
<a name="l01110"></a>01110 <span class="keywordflow">if</span> (Preferences::expiredColour() != mPrefsExpiredColour)
<a name="l01111"></a>01111 {
<a name="l01112"></a>01112 <span class="comment">// The expired alarms text colour has changed</span>
<a name="l01113"></a>01113 mRefreshExpiredAlarms = <span class="keyword">true</span>;
<a name="l01114"></a>01114 mPrefsExpiredColour = Preferences::expiredColour();
<a name="l01115"></a>01115 }
<a name="l01116"></a>01116
<a name="l01117"></a>01117 <span class="keywordflow">if</span> (Preferences::expiredKeepDays() != mPrefsExpiredKeepDays)
<a name="l01118"></a>01118 {
<a name="l01119"></a>01119 <span class="comment">// How long expired alarms are being kept has changed.</span>
<a name="l01120"></a>01120 <span class="comment">// N.B. This also adjusts for any change in start-of-day time.</span>
<a name="l01121"></a>01121 mPrefsExpiredKeepDays = Preferences::expiredKeepDays();
<a name="l01122"></a>01122 AlarmCalendar::expiredCalendar()-><a class="code" href="classAlarmCalendar.html#be59ff6d3248a94eb3130ce8f8ce5f5b">setPurgeDays</a>(mPrefsExpiredKeepDays);
<a name="l01123"></a>01123 }
<a name="l01124"></a>01124
<a name="l01125"></a>01125 <span class="keywordflow">if</span> (mRefreshExpiredAlarms)
<a name="l01126"></a>01126 {
<a name="l01127"></a>01127 mRefreshExpiredAlarms = <span class="keyword">false</span>;
<a name="l01128"></a>01128 MainWindow::updateExpired();
<a name="l01129"></a>01129 }
<a name="l01130"></a>01130 }
<a name="l01131"></a>01131
<a name="l01132"></a>01132 <span class="comment">/******************************************************************************</span>
<a name="l01133"></a>01133 <span class="comment">* Change alarm times for date-only alarms after the start of day time has changed.</span>
<a name="l01134"></a>01134 <span class="comment">*/</span>
<a name="l01135"></a>01135 <span class="keywordtype">void</span> KAlarmApp::changeStartOfDay()
<a name="l01136"></a>01136 {
<a name="l01137"></a>01137 Daemon::notifyTimeChanged(); <span class="comment">// tell the alarm daemon the new time</span>
<a name="l01138"></a>01138 QTime sod = Preferences::startOfDay();
<a name="l01139"></a>01139 DateTime::setStartOfDay(sod);
<a name="l01140"></a>01140 <a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>* cal = AlarmCalendar::activeCalendar();
<a name="l01141"></a>01141 <span class="keywordflow">if</span> (KAEvent::adjustStartOfDay(cal-><a class="code" href="classAlarmCalendar.html#37b71fc12e2394339156aabbb802946c">events</a>()))
<a name="l01142"></a>01142 cal-><a class="code" href="classAlarmCalendar.html#9bf82a952565e01aebd4f2b22e4c8449">save</a>();
<a name="l01143"></a>01143 Preferences::updateStartOfDayCheck(); <span class="comment">// now that calendar is updated, set OK flag in config file</span>
<a name="l01144"></a>01144 mStartOfDay = sod;
<a name="l01145"></a>01145 }
<a name="l01146"></a>01146
<a name="l01147"></a>01147 <span class="comment">/******************************************************************************</span>
<a name="l01148"></a>01148 <span class="comment">* Called when the expired alarms calendar has been purged.</span>
<a name="l01149"></a>01149 <span class="comment">* Updates the alarm list in all main windows.</span>
<a name="l01150"></a>01150 <span class="comment">*/</span>
<a name="l01151"></a>01151 <span class="keywordtype">void</span> KAlarmApp::slotExpiredPurged()
<a name="l01152"></a>01152 {
<a name="l01153"></a>01153 mRefreshExpiredAlarms = <span class="keyword">false</span>;
<a name="l01154"></a>01154 MainWindow::updateExpired();
<a name="l01155"></a>01155 }
<a name="l01156"></a>01156
<a name="l01157"></a>01157 <span class="comment">/******************************************************************************</span>
<a name="l01158"></a>01158 <span class="comment">* Return whether the program is configured to be running in the system tray.</span>
<a name="l01159"></a>01159 <span class="comment">*/</span>
<a name="l01160"></a>01160 <span class="keywordtype">bool</span> KAlarmApp::wantRunInSystemTray()<span class="keyword"> const</span>
<a name="l01161"></a>01161 <span class="keyword"></span>{
<a name="l01162"></a>01162 <span class="keywordflow">return</span> Preferences::runInSystemTray() && mHaveSystemTray;
<a name="l01163"></a>01163 }
<a name="l01164"></a>01164
<a name="l01165"></a>01165 <span class="comment">/******************************************************************************</span>
<a name="l01166"></a>01166 <span class="comment">* Called to schedule a new alarm, either in response to a DCOP notification or</span>
<a name="l01167"></a>01167 <span class="comment">* to command line options.</span>
<a name="l01168"></a>01168 <span class="comment">* Reply = true unless there was a parameter error or an error opening calendar file.</span>
<a name="l01169"></a>01169 <span class="comment">*/</span>
<a name="l01170"></a>01170 <span class="keywordtype">bool</span> KAlarmApp::scheduleEvent(KAEvent::Action action, <span class="keyword">const</span> QString& text, <span class="keyword">const</span> QDateTime& dateTime,
<a name="l01171"></a>01171 <span class="keywordtype">int</span> lateCancel, <span class="keywordtype">int</span> flags, <span class="keyword">const</span> QColor& bg, <span class="keyword">const</span> QColor& fg, <span class="keyword">const</span> QFont& font,
<a name="l01172"></a>01172 <span class="keyword">const</span> QString& audioFile, <span class="keywordtype">float</span> audioVolume, <span class="keywordtype">int</span> reminderMinutes,
<a name="l01173"></a>01173 <span class="keyword">const</span> KARecurrence& recurrence, <span class="keywordtype">int</span> repeatInterval, <span class="keywordtype">int</span> repeatCount,
<a name="l01174"></a>01174 uint mailFromID, <span class="keyword">const</span> EmailAddressList& mailAddresses,
<a name="l01175"></a>01175 <span class="keyword">const</span> QString& mailSubject, <span class="keyword">const</span> QStringList& mailAttachments)
<a name="l01176"></a>01176 {
<a name="l01177"></a>01177 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::scheduleEvent(): "</span> << text << endl;
<a name="l01178"></a>01178 <span class="keywordflow">if</span> (!dateTime.isValid())
<a name="l01179"></a>01179 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01180"></a>01180 QDateTime now = QDateTime::currentDateTime();
<a name="l01181"></a>01181 <span class="keywordflow">if</span> (lateCancel && dateTime < now.addSecs(-maxLateness(lateCancel)))
<a name="l01182"></a>01182 <span class="keywordflow">return</span> <span class="keyword">true</span>; <span class="comment">// alarm time was already expired too long ago</span>
<a name="l01183"></a>01183 QDateTime alarmTime = dateTime;
<a name="l01184"></a>01184 <span class="comment">// Round down to the nearest minute to avoid scheduling being messed up</span>
<a name="l01185"></a>01185 alarmTime.setTime(QTime(alarmTime.time().hour(), alarmTime.time().minute(), 0));
<a name="l01186"></a>01186
<a name="l01187"></a>01187 <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event(alarmTime, text, bg, fg, font, action, lateCancel, flags);
<a name="l01188"></a>01188 <span class="keywordflow">if</span> (reminderMinutes)
<a name="l01189"></a>01189 {
<a name="l01190"></a>01190 <span class="keywordtype">bool</span> onceOnly = (reminderMinutes < 0);
<a name="l01191"></a>01191 <span class="keyword">event</span>.setReminder((onceOnly ? -reminderMinutes : reminderMinutes), onceOnly);
<a name="l01192"></a>01192 }
<a name="l01193"></a>01193 <span class="keywordflow">if</span> (!audioFile.isEmpty())
<a name="l01194"></a>01194 event.setAudioFile(audioFile, audioVolume, -1, 0);
<a name="l01195"></a>01195 <span class="keywordflow">if</span> (!mailAddresses.isEmpty())
<a name="l01196"></a>01196 event.setEmail(mailFromID, mailAddresses, mailSubject, mailAttachments);
<a name="l01197"></a>01197 <span class="keyword">event</span>.setRecurrence(recurrence);
<a name="l01198"></a>01198 <span class="keyword">event</span>.setFirstRecurrence();
<a name="l01199"></a>01199 <span class="keyword">event</span>.setRepetition(repeatInterval, repeatCount - 1);
<a name="l01200"></a>01200 <span class="keywordflow">if</span> (alarmTime <= now)
<a name="l01201"></a>01201 {
<a name="l01202"></a>01202 <span class="comment">// Alarm is due for display already.</span>
<a name="l01203"></a>01203 <span class="comment">// First execute it once without adding it to the calendar file.</span>
<a name="l01204"></a>01204 <span class="keywordflow">if</span> (!mInitialised)
<a name="l01205"></a>01205 mDcopQueue.append(DcopQEntry(event, EVENT_TRIGGER));
<a name="l01206"></a>01206 <span class="keywordflow">else</span>
<a name="l01207"></a>01207 execAlarm(event, event.firstAlarm(), <span class="keyword">false</span>);
<a name="l01208"></a>01208 <span class="comment">// If it's a recurring alarm, reschedule it for its next occurrence</span>
<a name="l01209"></a>01209 <span class="keywordflow">if</span> (!event.recurs()
<a name="l01210"></a>01210 || <span class="keyword">event</span>.setNextOccurrence(now) == KAEvent::NO_OCCURRENCE)
<a name="l01211"></a>01211 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01212"></a>01212 <span class="comment">// It has recurrences in the future</span>
<a name="l01213"></a>01213 }
<a name="l01214"></a>01214
<a name="l01215"></a>01215 <span class="comment">// Queue the alarm for insertion into the calendar file</span>
<a name="l01216"></a>01216 mDcopQueue.append(DcopQEntry(event));
<a name="l01217"></a>01217 <span class="keywordflow">if</span> (mInitialised)
<a name="l01218"></a>01218 QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(processQueue()));
<a name="l01219"></a>01219 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01220"></a>01220 }
<a name="l01221"></a>01221
<a name="l01222"></a>01222 <span class="comment">/******************************************************************************</span>
<a name="l01223"></a>01223 <span class="comment">* Called in response to a DCOP notification by the alarm daemon that an event</span>
<a name="l01224"></a>01224 <span class="comment">* should be handled, i.e. displayed or cancelled.</span>
<a name="l01225"></a>01225 <span class="comment">* Optionally display the event. Delete the event from the calendar file and</span>
<a name="l01226"></a>01226 <span class="comment">* from every main window instance.</span>
<a name="l01227"></a>01227 <span class="comment">*/</span>
<a name="l01228"></a>01228 <span class="keywordtype">bool</span> KAlarmApp::handleEvent(<span class="keyword">const</span> QString& urlString, <span class="keyword">const</span> QString& eventID, EventFunc function)
<a name="l01229"></a>01229 {
<a name="l01230"></a>01230 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(DCOP): "</span> << eventID << endl;
<a name="l01231"></a>01231 <a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>* cal = AlarmCalendar::activeCalendar(); <span class="comment">// this can be called before calendars have been initialised</span>
<a name="l01232"></a>01232 <span class="keywordflow">if</span> (cal && KURL(urlString).url() != cal-><a class="code" href="classAlarmCalendar.html#50c3c9745a4850ebd08f822125cc3f75">urlString</a>())
<a name="l01233"></a>01233 {
<a name="l01234"></a>01234 kdError(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(DCOP): wrong calendar file "</span> << urlString << endl;
<a name="l01235"></a>01235 Daemon::eventHandled(eventID, <span class="keyword">false</span>);
<a name="l01236"></a>01236 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01237"></a>01237 }
<a name="l01238"></a>01238 mDcopQueue.append(DcopQEntry(function, eventID));
<a name="l01239"></a>01239 <span class="keywordflow">if</span> (mInitialised)
<a name="l01240"></a>01240 QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(processQueue()));
<a name="l01241"></a>01241 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01242"></a>01242 }
<a name="l01243"></a>01243
<a name="l01244"></a>01244 <span class="comment">/******************************************************************************</span>
<a name="l01245"></a>01245 <span class="comment">* Either:</span>
<a name="l01246"></a>01246 <span class="comment">* a) Display the event and then delete it if it has no outstanding repetitions.</span>
<a name="l01247"></a>01247 <span class="comment">* b) Delete the event.</span>
<a name="l01248"></a>01248 <span class="comment">* c) Reschedule the event for its next repetition. If none remain, delete it.</span>
<a name="l01249"></a>01249 <span class="comment">* If the event is deleted, it is removed from the calendar file and from every</span>
<a name="l01250"></a>01250 <span class="comment">* main window instance.</span>
<a name="l01251"></a>01251 <span class="comment">*/</span>
<a name="l01252"></a>01252 <span class="keywordtype">bool</span> KAlarmApp::handleEvent(<span class="keyword">const</span> QString& eventID, EventFunc function)
<a name="l01253"></a>01253 {
<a name="l01254"></a>01254 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): "</span> << eventID << <span class="stringliteral">", "</span> << (function==EVENT_TRIGGER?<span class="stringliteral">"TRIGGER"</span>:function==EVENT_CANCEL?<span class="stringliteral">"CANCEL"</span>:function==EVENT_HANDLE?<span class="stringliteral">"HANDLE"</span>:<span class="stringliteral">"?"</span>) << endl;
<a name="l01255"></a>01255 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">KCal::Event</a>* kcalEvent = AlarmCalendar::activeCalendar()-><a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(eventID);
<a name="l01256"></a>01256 <span class="keywordflow">if</span> (!kcalEvent)
<a name="l01257"></a>01257 {
<a name="l01258"></a>01258 kdError(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): event ID not found: "</span> << eventID << endl;
<a name="l01259"></a>01259 Daemon::eventHandled(eventID, <span class="keyword">false</span>);
<a name="l01260"></a>01260 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01261"></a>01261 }
<a name="l01262"></a>01262 <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event(*kcalEvent);
<a name="l01263"></a>01263 <span class="keywordflow">switch</span> (function)
<a name="l01264"></a>01264 {
<a name="l01265"></a>01265 <span class="keywordflow">case</span> EVENT_CANCEL:
<a name="l01266"></a>01266 KAlarm::deleteEvent(event, <span class="keyword">true</span>);
<a name="l01267"></a>01267 <span class="keywordflow">break</span>;
<a name="l01268"></a>01268
<a name="l01269"></a>01269 <span class="keywordflow">case</span> EVENT_TRIGGER: <span class="comment">// handle it if it's due, else execute it regardless</span>
<a name="l01270"></a>01270 <span class="keywordflow">case</span> EVENT_HANDLE: <span class="comment">// handle it if it's due</span>
<a name="l01271"></a>01271 {
<a name="l01272"></a>01272 QDateTime now = QDateTime::currentDateTime();
<a name="l01273"></a>01273 <span class="keywordtype">bool</span> updateCalAndDisplay = <span class="keyword">false</span>;
<a name="l01274"></a>01274 <span class="keywordtype">bool</span> alarmToExecuteValid = <span class="keyword">false</span>;
<a name="l01275"></a>01275 KAAlarm alarmToExecute;
<a name="l01276"></a>01276 <span class="comment">// Check all the alarms in turn.</span>
<a name="l01277"></a>01277 <span class="comment">// Note that the main alarm is fetched before any other alarms.</span>
<a name="l01278"></a>01278 <span class="keywordflow">for</span> (KAAlarm alarm = event.firstAlarm(); alarm.valid(); alarm = <span class="keyword">event</span>.nextAlarm(alarm))
<a name="l01279"></a>01279 {
<a name="l01280"></a>01280 <span class="comment">// Check if the alarm is due yet.</span>
<a name="l01281"></a>01281 <span class="keywordtype">int</span> secs = alarm.dateTime(<span class="keyword">true</span>).dateTime().secsTo(now);
<a name="l01282"></a>01282 <span class="keywordflow">if</span> (secs < 0)
<a name="l01283"></a>01283 {
<a name="l01284"></a>01284 <span class="comment">// This alarm is definitely not due yet</span>
<a name="l01285"></a>01285 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): alarm "</span> << alarm.type() << <span class="stringliteral">": not due\n"</span>;
<a name="l01286"></a>01286 <span class="keywordflow">continue</span>;
<a name="l01287"></a>01287 }
<a name="l01288"></a>01288 <span class="keywordflow">if</span> (alarm.repeatAtLogin())
<a name="l01289"></a>01289 {
<a name="l01290"></a>01290 <span class="comment">// Alarm is to be displayed at every login.</span>
<a name="l01291"></a>01291 <span class="comment">// Check if the alarm has only just been set up.</span>
<a name="l01292"></a>01292 <span class="comment">// (The alarm daemon will immediately notify that it is due</span>
<a name="l01293"></a>01293 <span class="comment">// since it is set up with a time in the past.)</span>
<a name="l01294"></a>01294 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): REPEAT_AT_LOGIN\n"</span>;
<a name="l01295"></a>01295 <span class="keywordflow">if</span> (secs < maxLateness(1))
<a name="l01296"></a>01296 <span class="keywordflow">continue</span>;
<a name="l01297"></a>01297
<a name="l01298"></a>01298 <span class="comment">// Check if the main alarm is already being displayed.</span>
<a name="l01299"></a>01299 <span class="comment">// (We don't want to display both at the same time.)</span>
<a name="l01300"></a>01300 <span class="keywordflow">if</span> (alarmToExecute.valid())
<a name="l01301"></a>01301 <span class="keywordflow">continue</span>;
<a name="l01302"></a>01302
<a name="l01303"></a>01303 <span class="comment">// Set the time to display if it's a display alarm</span>
<a name="l01304"></a>01304 alarm.setTime(now);
<a name="l01305"></a>01305 }
<a name="l01306"></a>01306 <span class="keywordflow">if</span> (alarm.lateCancel())
<a name="l01307"></a>01307 {
<a name="l01308"></a>01308 <span class="comment">// Alarm is due, and it is to be cancelled if too late.</span>
<a name="l01309"></a>01309 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): LATE_CANCEL\n"</span>;
<a name="l01310"></a>01310 <span class="keywordtype">bool</span> late = <span class="keyword">false</span>;
<a name="l01311"></a>01311 <span class="keywordtype">bool</span> cancel = <span class="keyword">false</span>;
<a name="l01312"></a>01312 <span class="keywordflow">if</span> (alarm.dateTime().isDateOnly())
<a name="l01313"></a>01313 {
<a name="l01314"></a>01314 <span class="comment">// The alarm has no time, so cancel it if its date is too far past</span>
<a name="l01315"></a>01315 <span class="keywordtype">int</span> maxlate = alarm.lateCancel() / 1440; <span class="comment">// maximum lateness in days</span>
<a name="l01316"></a>01316 QDateTime limit(alarm.date().addDays(maxlate + 1), Preferences::startOfDay());
<a name="l01317"></a>01317 <span class="keywordflow">if</span> (now >= limit)
<a name="l01318"></a>01318 {
<a name="l01319"></a>01319 <span class="comment">// It's too late to display the scheduled occurrence.</span>
<a name="l01320"></a>01320 <span class="comment">// Find the last previous occurrence of the alarm.</span>
<a name="l01321"></a>01321 DateTime next;
<a name="l01322"></a>01322 KAEvent::OccurType type = <span class="keyword">event</span>.previousOccurrence(now, next, <span class="keyword">true</span>);
<a name="l01323"></a>01323 <span class="keywordflow">switch</span> (type & ~KAEvent::OCCURRENCE_REPEAT)
<a name="l01324"></a>01324 {
<a name="l01325"></a>01325 <span class="keywordflow">case</span> KAEvent::FIRST_OR_ONLY_OCCURRENCE:
<a name="l01326"></a>01326 <span class="keywordflow">case</span> KAEvent::RECURRENCE_DATE:
<a name="l01327"></a>01327 <span class="keywordflow">case</span> KAEvent::RECURRENCE_DATE_TIME:
<a name="l01328"></a>01328 <span class="keywordflow">case</span> KAEvent::LAST_RECURRENCE:
<a name="l01329"></a>01329 limit.setDate(next.date().addDays(maxlate + 1));
<a name="l01330"></a>01330 limit.setTime(Preferences::startOfDay());
<a name="l01331"></a>01331 <span class="keywordflow">if</span> (now >= limit)
<a name="l01332"></a>01332 {
<a name="l01333"></a>01333 <span class="keywordflow">if</span> (type == KAEvent::LAST_RECURRENCE
<a name="l01334"></a>01334 || type == KAEvent::FIRST_OR_ONLY_OCCURRENCE && !event.recurs())
<a name="l01335"></a>01335 cancel = <span class="keyword">true</span>; <span class="comment">// last occurrence (and there are no repetitions)</span>
<a name="l01336"></a>01336 <span class="keywordflow">else</span>
<a name="l01337"></a>01337 late = <span class="keyword">true</span>;
<a name="l01338"></a>01338 }
<a name="l01339"></a>01339 <span class="keywordflow">break</span>;
<a name="l01340"></a>01340 <span class="keywordflow">case</span> KAEvent::NO_OCCURRENCE:
<a name="l01341"></a>01341 <span class="keywordflow">default</span>:
<a name="l01342"></a>01342 late = <span class="keyword">true</span>;
<a name="l01343"></a>01343 <span class="keywordflow">break</span>;
<a name="l01344"></a>01344 }
<a name="l01345"></a>01345 }
<a name="l01346"></a>01346 }
<a name="l01347"></a>01347 <span class="keywordflow">else</span>
<a name="l01348"></a>01348 {
<a name="l01349"></a>01349 <span class="comment">// The alarm is timed. Allow it to be the permitted amount late before cancelling it.</span>
<a name="l01350"></a>01350 <span class="keywordtype">int</span> maxlate = maxLateness(alarm.lateCancel());
<a name="l01351"></a>01351 <span class="keywordflow">if</span> (secs > maxlate)
<a name="l01352"></a>01352 {
<a name="l01353"></a>01353 <span class="comment">// It's over the maximum interval late.</span>
<a name="l01354"></a>01354 <span class="comment">// Find the most recent occurrence of the alarm.</span>
<a name="l01355"></a>01355 DateTime next;
<a name="l01356"></a>01356 KAEvent::OccurType type = <span class="keyword">event</span>.previousOccurrence(now, next, <span class="keyword">true</span>);
<a name="l01357"></a>01357 <span class="keywordflow">switch</span> (type & ~KAEvent::OCCURRENCE_REPEAT)
<a name="l01358"></a>01358 {
<a name="l01359"></a>01359 <span class="keywordflow">case</span> KAEvent::FIRST_OR_ONLY_OCCURRENCE:
<a name="l01360"></a>01360 <span class="keywordflow">case</span> KAEvent::RECURRENCE_DATE:
<a name="l01361"></a>01361 <span class="keywordflow">case</span> KAEvent::RECURRENCE_DATE_TIME:
<a name="l01362"></a>01362 <span class="keywordflow">case</span> KAEvent::LAST_RECURRENCE:
<a name="l01363"></a>01363 <span class="keywordflow">if</span> (next.dateTime().secsTo(now) > maxlate)
<a name="l01364"></a>01364 {
<a name="l01365"></a>01365 <span class="keywordflow">if</span> (type == KAEvent::LAST_RECURRENCE
<a name="l01366"></a>01366 || type == KAEvent::FIRST_OR_ONLY_OCCURRENCE && !event.recurs())
<a name="l01367"></a>01367 cancel = <span class="keyword">true</span>; <span class="comment">// last occurrence (and there are no repetitions)</span>
<a name="l01368"></a>01368 <span class="keywordflow">else</span>
<a name="l01369"></a>01369 late = <span class="keyword">true</span>;
<a name="l01370"></a>01370 }
<a name="l01371"></a>01371 <span class="keywordflow">break</span>;
<a name="l01372"></a>01372 <span class="keywordflow">case</span> KAEvent::NO_OCCURRENCE:
<a name="l01373"></a>01373 <span class="keywordflow">default</span>:
<a name="l01374"></a>01374 late = <span class="keyword">true</span>;
<a name="l01375"></a>01375 <span class="keywordflow">break</span>;
<a name="l01376"></a>01376 }
<a name="l01377"></a>01377 }
<a name="l01378"></a>01378 }
<a name="l01379"></a>01379
<a name="l01380"></a>01380 <span class="keywordflow">if</span> (cancel)
<a name="l01381"></a>01381 {
<a name="l01382"></a>01382 <span class="comment">// All recurrences are finished, so cancel the event</span>
<a name="l01383"></a>01383 <span class="keyword">event</span>.setArchive();
<a name="l01384"></a>01384 cancelAlarm(event, alarm.type(), <span class="keyword">false</span>);
<a name="l01385"></a>01385 updateCalAndDisplay = <span class="keyword">true</span>;
<a name="l01386"></a>01386 <span class="keywordflow">continue</span>;
<a name="l01387"></a>01387 }
<a name="l01388"></a>01388 <span class="keywordflow">if</span> (late)
<a name="l01389"></a>01389 {
<a name="l01390"></a>01390 <span class="comment">// The latest repetition was too long ago, so schedule the next one</span>
<a name="l01391"></a>01391 rescheduleAlarm(event, alarm, <span class="keyword">false</span>);
<a name="l01392"></a>01392 updateCalAndDisplay = <span class="keyword">true</span>;
<a name="l01393"></a>01393 <span class="keywordflow">continue</span>;
<a name="l01394"></a>01394 }
<a name="l01395"></a>01395 }
<a name="l01396"></a>01396 <span class="keywordflow">if</span> (!alarmToExecuteValid)
<a name="l01397"></a>01397 {
<a name="l01398"></a>01398 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): alarm "</span> << alarm.type() << <span class="stringliteral">": execute\n"</span>;
<a name="l01399"></a>01399 alarmToExecute = alarm; <span class="comment">// note the alarm to be executed</span>
<a name="l01400"></a>01400 alarmToExecuteValid = <span class="keyword">true</span>; <span class="comment">// only trigger one alarm for the event</span>
<a name="l01401"></a>01401 }
<a name="l01402"></a>01402 <span class="keywordflow">else</span>
<a name="l01403"></a>01403 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): alarm "</span> << alarm.type() << <span class="stringliteral">": skip\n"</span>;
<a name="l01404"></a>01404 }
<a name="l01405"></a>01405
<a name="l01406"></a>01406 <span class="comment">// If there is an alarm to execute, do this last after rescheduling/cancelling</span>
<a name="l01407"></a>01407 <span class="comment">// any others. This ensures that the updated event is only saved once to the calendar.</span>
<a name="l01408"></a>01408 <span class="keywordflow">if</span> (alarmToExecute.valid())
<a name="l01409"></a>01409 execAlarm(event, alarmToExecute, <span class="keyword">true</span>, !alarmToExecute.repeatAtLogin());
<a name="l01410"></a>01410 <span class="keywordflow">else</span>
<a name="l01411"></a>01411 {
<a name="l01412"></a>01412 <span class="keywordflow">if</span> (function == EVENT_TRIGGER)
<a name="l01413"></a>01413 {
<a name="l01414"></a>01414 <span class="comment">// The alarm is to be executed regardless of whether it's due.</span>
<a name="l01415"></a>01415 <span class="comment">// Only trigger one alarm from the event - we don't want multiple</span>
<a name="l01416"></a>01416 <span class="comment">// identical messages, for example.</span>
<a name="l01417"></a>01417 KAAlarm alarm = <span class="keyword">event</span>.firstAlarm();
<a name="l01418"></a>01418 <span class="keywordflow">if</span> (alarm.valid())
<a name="l01419"></a>01419 execAlarm(event, alarm, <span class="keyword">false</span>);
<a name="l01420"></a>01420 }
<a name="l01421"></a>01421 <span class="keywordflow">if</span> (updateCalAndDisplay)
<a name="l01422"></a>01422 KAlarm::updateEvent(event, 0); <span class="comment">// update the window lists and calendar file</span>
<a name="l01423"></a>01423 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (function != EVENT_TRIGGER)
<a name="l01424"></a>01424 {
<a name="l01425"></a>01425 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::handleEvent(): no action\n"</span>;
<a name="l01426"></a>01426 Daemon::eventHandled(eventID, <span class="keyword">false</span>);
<a name="l01427"></a>01427 }
<a name="l01428"></a>01428 }
<a name="l01429"></a>01429 <span class="keywordflow">break</span>;
<a name="l01430"></a>01430 }
<a name="l01431"></a>01431 }
<a name="l01432"></a>01432 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01433"></a>01433 }
<a name="l01434"></a>01434
<a name="l01435"></a>01435 <span class="comment">/******************************************************************************</span>
<a name="l01436"></a>01436 <span class="comment">* Called when an alarm is currently being displayed, to store a copy of the</span>
<a name="l01437"></a>01437 <span class="comment">* alarm in the displaying calendar, and to reschedule it for its next repetition.</span>
<a name="l01438"></a>01438 <span class="comment">* If no repetitions remain, cancel it.</span>
<a name="l01439"></a>01439 <span class="comment">*/</span>
<a name="l01440"></a>01440 <span class="keywordtype">void</span> KAlarmApp::alarmShowing(<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> DateTime& alarmTime)
<a name="l01441"></a>01441 {
<a name="l01442"></a>01442 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::alarmShowing("</span> << <span class="keyword">event</span>.id() << <span class="stringliteral">", "</span> << KAAlarm::debugType(alarmType) << <span class="stringliteral">")\n"</span>;
<a name="l01443"></a>01443 <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">KCal::Event</a>* kcalEvent = AlarmCalendar::activeCalendar()-><a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(event.<a class="code" href="classKAEvent.html#431312bf54e8c5d9ea25438b9a6bece2">id</a>());
<a name="l01444"></a>01444 <span class="keywordflow">if</span> (!kcalEvent)
<a name="l01445"></a>01445 kdError(5950) << <span class="stringliteral">"KAlarmApp::alarmShowing(): event ID not found: "</span> << <span class="keyword">event</span>.id() << endl;
<a name="l01446"></a>01446 <span class="keywordflow">else</span>
<a name="l01447"></a>01447 {
<a name="l01448"></a>01448 KAAlarm alarm = <span class="keyword">event</span>.alarm(alarmType);
<a name="l01449"></a>01449 <span class="keywordflow">if</span> (!alarm.valid())
<a name="l01450"></a>01450 kdError(5950) << <span class="stringliteral">"KAlarmApp::alarmShowing(): alarm type not found: "</span> << <span class="keyword">event</span>.id() << <span class="stringliteral">":"</span> << alarmType << endl;
<a name="l01451"></a>01451 <span class="keywordflow">else</span>
<a name="l01452"></a>01452 {
<a name="l01453"></a>01453 <span class="comment">// Copy the alarm to the displaying calendar in case of a crash, etc.</span>
<a name="l01454"></a>01454 <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> dispEvent;
<a name="l01455"></a>01455 dispEvent.<a class="code" href="classKAEvent.html#d06f262248d9b25967d942b4783dc893">setDisplaying</a>(event, alarmType, alarmTime.dateTime());
<a name="l01456"></a>01456 <a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>* cal = AlarmCalendar::displayCalendarOpen();
<a name="l01457"></a>01457 <span class="keywordflow">if</span> (cal)
<a name="l01458"></a>01458 {
<a name="l01459"></a>01459 cal-><a class="code" href="classAlarmCalendar.html#2a582d20e09389db15c6a5f23a0e1549">deleteEvent</a>(dispEvent.<a class="code" href="classKAEvent.html#431312bf54e8c5d9ea25438b9a6bece2">id</a>()); <span class="comment">// in case it already exists</span>
<a name="l01460"></a>01460 cal-><a class="code" href="classAlarmCalendar.html#c7c9d1afb14e4718e02dbe8a1462da54">addEvent</a>(dispEvent);
<a name="l01461"></a>01461 cal-><a class="code" href="classAlarmCalendar.html#9bf82a952565e01aebd4f2b22e4c8449">save</a>();
<a name="l01462"></a>01462 }
<a name="l01463"></a>01463
<a name="l01464"></a>01464 rescheduleAlarm(event, alarm, <span class="keyword">true</span>);
<a name="l01465"></a>01465 <span class="keywordflow">return</span>;
<a name="l01466"></a>01466 }
<a name="l01467"></a>01467 }
<a name="l01468"></a>01468 Daemon::eventHandled(event.<a class="code" href="classKAEvent.html#431312bf54e8c5d9ea25438b9a6bece2">id</a>(), <span class="keyword">false</span>);
<a name="l01469"></a>01469 }
<a name="l01470"></a>01470
<a name="l01471"></a>01471 <span class="comment">/******************************************************************************</span>
<a name="l01472"></a>01472 <span class="comment">* Called when an alarm action has completed, to perform any post-alarm actions.</span>
<a name="l01473"></a>01473 <span class="comment">*/</span>
<a name="l01474"></a>01474 <span class="keywordtype">void</span> KAlarmApp::alarmCompleted(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event)
<a name="l01475"></a>01475 {
<a name="l01476"></a>01476 <span class="keywordflow">if</span> (!event.<a class="code" href="classKAEvent.html#f0193dab34ca0afe70735198b162e290">postAction</a>().isEmpty() && ShellProcess::authorised())
<a name="l01477"></a>01477 {
<a name="l01478"></a>01478 QString command = <span class="keyword">event</span>.postAction();
<a name="l01479"></a>01479 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::alarmCompleted("</span> << <span class="keyword">event</span>.id() << <span class="stringliteral">"): "</span> << command << endl;
<a name="l01480"></a>01480 doShellCommand(command, event, 0, ProcData::POST_ACTION);
<a name="l01481"></a>01481 }
<a name="l01482"></a>01482 }
<a name="l01483"></a>01483
<a name="l01484"></a>01484 <span class="comment">/******************************************************************************</span>
<a name="l01485"></a>01485 <span class="comment">* Reschedule the alarm for its next recurrence. If none remain, delete it.</span>
<a name="l01486"></a>01486 <span class="comment">* If the alarm is deleted and it is the last alarm for its event, the event is</span>
<a name="l01487"></a>01487 <span class="comment">* removed from the calendar file and from every main window instance.</span>
<a name="l01488"></a>01488 <span class="comment">*/</span>
<a name="l01489"></a>01489 <span class="keywordtype">void</span> KAlarmApp::rescheduleAlarm(<a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, <span class="keyword">const</span> KAAlarm& alarm, <span class="keywordtype">bool</span> updateCalAndDisplay)
<a name="l01490"></a>01490 {
<a name="l01491"></a>01491 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::rescheduleAlarm()"</span> << endl;
<a name="l01492"></a>01492 <span class="keywordtype">bool</span> update = <span class="keyword">false</span>;
<a name="l01493"></a>01493 <span class="keywordflow">if</span> (alarm.reminder() || alarm.deferred())
<a name="l01494"></a>01494 {
<a name="l01495"></a>01495 <span class="comment">// It's an advance warning alarm or an extra deferred alarm, so delete it</span>
<a name="l01496"></a>01496 <span class="keyword">event</span>.removeExpiredAlarm(alarm.type());
<a name="l01497"></a>01497 update = <span class="keyword">true</span>;
<a name="l01498"></a>01498 }
<a name="l01499"></a>01499 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (alarm.repeatAtLogin())
<a name="l01500"></a>01500 {
<a name="l01501"></a>01501 <span class="comment">// Leave an alarm which repeats at every login until its main alarm is deleted</span>
<a name="l01502"></a>01502 <span class="keywordflow">if</span> (updateCalAndDisplay && event.<a class="code" href="classKAEvent.html#194b9b70766aa3bf9e9364aa02fb9967">updated</a>())
<a name="l01503"></a>01503 update = <span class="keyword">true</span>;
<a name="l01504"></a>01504 }
<a name="l01505"></a>01505 <span class="keywordflow">else</span>
<a name="l01506"></a>01506 {
<a name="l01507"></a>01507 <span class="comment">// Reschedule the alarm for its next recurrence.</span>
<a name="l01508"></a>01508 KAEvent::OccurType type = <span class="keyword">event</span>.setNextOccurrence(QDateTime::currentDateTime());
<a name="l01509"></a>01509 <span class="keywordflow">switch</span> (type)
<a name="l01510"></a>01510 {
<a name="l01511"></a>01511 <span class="keywordflow">case</span> KAEvent::NO_OCCURRENCE:
<a name="l01512"></a>01512 <span class="comment">// All repetitions are finished, so cancel the event</span>
<a name="l01513"></a>01513 cancelAlarm(event, alarm.type(), updateCalAndDisplay);
<a name="l01514"></a>01514 <span class="keywordflow">break</span>;
<a name="l01515"></a>01515 <span class="keywordflow">default</span>:
<a name="l01516"></a>01516 <span class="keywordflow">if</span> (!(type & KAEvent::OCCURRENCE_REPEAT))
<a name="l01517"></a>01517 <span class="keywordflow">break</span>;
<a name="l01518"></a>01518 <span class="comment">// Next occurrence is a repeat, so fall through to recurrence handling</span>
<a name="l01519"></a>01519 <span class="keywordflow">case</span> KAEvent::RECURRENCE_DATE:
<a name="l01520"></a>01520 <span class="keywordflow">case</span> KAEvent::RECURRENCE_DATE_TIME:
<a name="l01521"></a>01521 <span class="keywordflow">case</span> KAEvent::LAST_RECURRENCE:
<a name="l01522"></a>01522 <span class="comment">// The event is due by now and repetitions still remain, so rewrite the event</span>
<a name="l01523"></a>01523 <span class="keywordflow">if</span> (updateCalAndDisplay)
<a name="l01524"></a>01524 update = <span class="keyword">true</span>;
<a name="l01525"></a>01525 <span class="keywordflow">else</span>
<a name="l01526"></a>01526 {
<a name="l01527"></a>01527 <span class="keyword">event</span>.cancelCancelledDeferral();
<a name="l01528"></a>01528 <span class="keyword">event</span>.setUpdated(); <span class="comment">// note that the calendar file needs to be updated</span>
<a name="l01529"></a>01529 }
<a name="l01530"></a>01530 <span class="keywordflow">break</span>;
<a name="l01531"></a>01531 <span class="keywordflow">case</span> KAEvent::FIRST_OR_ONLY_OCCURRENCE:
<a name="l01532"></a>01532 <span class="comment">// The first occurrence is still due?!?, so don't do anything</span>
<a name="l01533"></a>01533 <span class="keywordflow">break</span>;
<a name="l01534"></a>01534 }
<a name="l01535"></a>01535 <span class="keywordflow">if</span> (event.<a class="code" href="classKAEvent.html#f115c56e32273686f3ec496dff1690c0">deferred</a>())
<a name="l01536"></a>01536 {
<a name="l01537"></a>01537 <span class="comment">// Just in case there's also a deferred alarm, ensure it's removed</span>
<a name="l01538"></a>01538 <span class="keyword">event</span>.removeExpiredAlarm(KAAlarm::DEFERRED_ALARM);
<a name="l01539"></a>01539 update = <span class="keyword">true</span>;
<a name="l01540"></a>01540 }
<a name="l01541"></a>01541 }
<a name="l01542"></a>01542 <span class="keywordflow">if</span> (update)
<a name="l01543"></a>01543 {
<a name="l01544"></a>01544 <span class="keyword">event</span>.cancelCancelledDeferral();
<a name="l01545"></a>01545 KAlarm::updateEvent(event, 0); <span class="comment">// update the window lists and calendar file</span>
<a name="l01546"></a>01546 }
<a name="l01547"></a>01547 }
<a name="l01548"></a>01548
<a name="l01549"></a>01549 <span class="comment">/******************************************************************************</span>
<a name="l01550"></a>01550 <span class="comment">* Delete the alarm. If it is the last alarm for its event, the event is removed</span>
<a name="l01551"></a>01551 <span class="comment">* from the calendar file and from every main window instance.</span>
<a name="l01552"></a>01552 <span class="comment">*/</span>
<a name="l01553"></a>01553 <span class="keywordtype">void</span> KAlarmApp::cancelAlarm(<a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, KAAlarm::Type alarmType, <span class="keywordtype">bool</span> updateCalAndDisplay)
<a name="l01554"></a>01554 {
<a name="l01555"></a>01555 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::cancelAlarm()"</span> << endl;
<a name="l01556"></a>01556 <span class="keyword">event</span>.cancelCancelledDeferral();
<a name="l01557"></a>01557 <span class="keywordflow">if</span> (alarmType == KAAlarm::MAIN_ALARM && !event.displaying() && <span class="keyword">event</span>.<a class="code" href="classKAEvent.html#2ee48199cc9f4651530a091fe5b70b7d">toBeArchived</a>())
<a name="l01558"></a>01558 {
<a name="l01559"></a>01559 <span class="comment">// The event is being deleted. Save it in the expired calendar file first.</span>
<a name="l01560"></a>01560 QString <span class="keywordtype">id</span> = <span class="keyword">event</span>.id(); <span class="comment">// save event ID since KAlarm::addExpiredEvent() changes it</span>
<a name="l01561"></a>01561 KAlarm::addExpiredEvent(event);
<a name="l01562"></a>01562 <span class="keyword">event</span>.setEventID(<span class="keywordtype">id</span>); <span class="comment">// restore event ID</span>
<a name="l01563"></a>01563 }
<a name="l01564"></a>01564 <span class="keyword">event</span>.removeExpiredAlarm(alarmType);
<a name="l01565"></a>01565 <span class="keywordflow">if</span> (!event.<a class="code" href="classKAEvent.html#3e7b48890fe89d59302ae124ebd2e9c0">alarmCount</a>())
<a name="l01566"></a>01566 KAlarm::deleteEvent(event, <span class="keyword">false</span>);
<a name="l01567"></a>01567 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (updateCalAndDisplay)
<a name="l01568"></a>01568 KAlarm::updateEvent(event, 0); <span class="comment">// update the window lists and calendar file</span>
<a name="l01569"></a>01569 }
<a name="l01570"></a>01570
<a name="l01571"></a>01571 <span class="comment">/******************************************************************************</span>
<a name="l01572"></a>01572 <span class="comment">* Execute an alarm by displaying its message or file, or executing its command.</span>
<a name="l01573"></a>01573 <span class="comment">* Reply = ShellProcess instance if a command alarm</span>
<a name="l01574"></a>01574 <span class="comment">* != 0 if successful</span>
<a name="l01575"></a>01575 <span class="comment">* = 0 if the alarm is disabled, or if an error message was output.</span>
<a name="l01576"></a>01576 <span class="comment">*/</span>
<a name="l01577"></a>01577 <span class="keywordtype">void</span>* KAlarmApp::execAlarm(<a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, <span class="keyword">const</span> KAAlarm& alarm, <span class="keywordtype">bool</span> reschedule, <span class="keywordtype">bool</span> allowDefer, <span class="keywordtype">bool</span> noPreAction)
<a name="l01578"></a>01578 {
<a name="l01579"></a>01579 <span class="keywordflow">if</span> (!event.<a class="code" href="classKAEvent.html#616d29c62c650e9e8c7dc63e1811f26b">enabled</a>())
<a name="l01580"></a>01580 {
<a name="l01581"></a>01581 <span class="comment">// The event is disabled.</span>
<a name="l01582"></a>01582 <span class="keywordflow">if</span> (reschedule)
<a name="l01583"></a>01583 rescheduleAlarm(event, alarm, <span class="keyword">true</span>);
<a name="l01584"></a>01584 <span class="keywordflow">return</span> 0;
<a name="l01585"></a>01585 }
<a name="l01586"></a>01586
<a name="l01587"></a>01587 <span class="keywordtype">void</span>* result = (<span class="keywordtype">void</span>*)1;
<a name="l01588"></a>01588 <span class="keyword">event</span>.setArchive();
<a name="l01589"></a>01589 <span class="keywordflow">switch</span> (alarm.action())
<a name="l01590"></a>01590 {
<a name="l01591"></a>01591 <span class="keywordflow">case</span> KAAlarm::MESSAGE:
<a name="l01592"></a>01592 <span class="keywordflow">case</span> KAAlarm::FILE:
<a name="l01593"></a>01593 {
<a name="l01594"></a>01594 <span class="comment">// Display a message or file, provided that the same event isn't already being displayed</span>
<a name="l01595"></a>01595 <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>* win = MessageWin::findEvent(event.<a class="code" href="classKAEvent.html#431312bf54e8c5d9ea25438b9a6bece2">id</a>());
<a name="l01596"></a>01596 <span class="comment">// Find if we're changing a reminder message to the real message</span>
<a name="l01597"></a>01597 <span class="keywordtype">bool</span> reminder = (alarm.type() & KAAlarm::REMINDER_ALARM);
<a name="l01598"></a>01598 <span class="keywordtype">bool</span> replaceReminder = !reminder && win && (win-><a class="code" href="classMessageWin.html#8d1be4a0218eed7600c37570ff5debba">alarmType</a>() & KAAlarm::REMINDER_ALARM);
<a name="l01599"></a>01599 <span class="keywordflow">if</span> (!reminder && !event.<a class="code" href="classKAEvent.html#f115c56e32273686f3ec496dff1690c0">deferred</a>()
<a name="l01600"></a>01600 && (replaceReminder || !win) && !noPreAction
<a name="l01601"></a>01601 && !event.<a class="code" href="classKAEvent.html#34f88ffaf9e11584a0113cc54945b317">preAction</a>().isEmpty() && ShellProcess::authorised())
<a name="l01602"></a>01602 {
<a name="l01603"></a>01603 <span class="comment">// It's not a reminder or a deferred alarm, and there is no message window</span>
<a name="l01604"></a>01604 <span class="comment">// (other than a reminder window) currently displayed for this alarm,</span>
<a name="l01605"></a>01605 <span class="comment">// and we need to execute a command before displaying the new window.</span>
<a name="l01606"></a>01606 <span class="comment">// Check whether the command is already being executed for this alarm.</span>
<a name="l01607"></a>01607 <span class="keywordflow">for</span> (QValueList<ProcData*>::Iterator it = mCommandProcesses.begin(); it != mCommandProcesses.end(); ++it)
<a name="l01608"></a>01608 {
<a name="l01609"></a>01609 ProcData* pd = *it;
<a name="l01610"></a>01610 <span class="keywordflow">if</span> (pd->event->id() == <span class="keyword">event</span>.id() && (pd->flags & ProcData::PRE_ACTION))
<a name="l01611"></a>01611 {
<a name="l01612"></a>01612 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): already executing pre-DISPLAY command"</span> << endl;
<a name="l01613"></a>01613 <span class="keywordflow">return</span> pd->process; <span class="comment">// already executing - don't duplicate the action</span>
<a name="l01614"></a>01614 }
<a name="l01615"></a>01615 }
<a name="l01616"></a>01616
<a name="l01617"></a>01617 QString command = <span class="keyword">event</span>.preAction();
<a name="l01618"></a>01618 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): pre-DISPLAY command: "</span> << command << endl;
<a name="l01619"></a>01619 <span class="keywordtype">int</span> flags = (reschedule ? ProcData::RESCHEDULE : 0) | (allowDefer ? ProcData::ALLOW_DEFER : 0);
<a name="l01620"></a>01620 <span class="keywordflow">if</span> (doShellCommand(command, event, &alarm, (flags | ProcData::PRE_ACTION)))
<a name="l01621"></a>01621 <span class="keywordflow">return</span> result; <span class="comment">// display the message after the command completes</span>
<a name="l01622"></a>01622 <span class="comment">// Error executing command - display the message even though it failed</span>
<a name="l01623"></a>01623 }
<a name="l01624"></a>01624 <span class="keywordflow">if</span> (!event.<a class="code" href="classKAEvent.html#616d29c62c650e9e8c7dc63e1811f26b">enabled</a>())
<a name="l01625"></a>01625 <span class="keyword">delete</span> win; <span class="comment">// event is disabled - close its window</span>
<a name="l01626"></a>01626 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (!win
<a name="l01627"></a>01627 || !win-><a class="code" href="classMessageWin.html#ae021a55d4effcbbc2821b09ef6c8716">hasDefer</a>() && !alarm.repeatAtLogin()
<a name="l01628"></a>01628 || replaceReminder)
<a name="l01629"></a>01629 {
<a name="l01630"></a>01630 <span class="comment">// Either there isn't already a message for this event,</span>
<a name="l01631"></a>01631 <span class="comment">// or there is a repeat-at-login message with no Defer</span>
<a name="l01632"></a>01632 <span class="comment">// button, which needs to be replaced with a new message,</span>
<a name="l01633"></a>01633 <span class="comment">// or the caption needs to be changed from "Reminder" to "Message".</span>
<a name="l01634"></a>01634 <span class="keywordflow">if</span> (win)
<a name="l01635"></a>01635 win-><a class="code" href="classMessageWin.html#d3a277f40799062266fb2fbdcc374a26">setRecreating</a>(); <span class="comment">// prevent post-alarm actions</span>
<a name="l01636"></a>01636 <span class="keyword">delete</span> win;
<a name="l01637"></a>01637 (<span class="keyword">new</span> <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>(event, alarm, reschedule, allowDefer))->show();
<a name="l01638"></a>01638 }
<a name="l01639"></a>01639 <span class="keywordflow">else</span>
<a name="l01640"></a>01640 {
<a name="l01641"></a>01641 <span class="comment">// Raise the existing message window and replay any sound</span>
<a name="l01642"></a>01642 win-><a class="code" href="classMessageWin.html#873efbf50eeee4badfe1d4f6291c5436">repeat</a>(alarm); <span class="comment">// N.B. this reschedules the alarm</span>
<a name="l01643"></a>01643 }
<a name="l01644"></a>01644 <span class="keywordflow">break</span>;
<a name="l01645"></a>01645 }
<a name="l01646"></a>01646 <span class="keywordflow">case</span> KAAlarm::COMMAND:
<a name="l01647"></a>01647 {
<a name="l01648"></a>01648 <span class="keywordtype">int</span> flags = <span class="keyword">event</span>.commandXterm() ? ProcData::EXEC_IN_XTERM : 0;
<a name="l01649"></a>01649 QString command = <span class="keyword">event</span>.cleanText();
<a name="l01650"></a>01650 <span class="keywordflow">if</span> (event.commandScript())
<a name="l01651"></a>01651 {
<a name="l01652"></a>01652 <span class="comment">// Store the command script in a temporary file for execution</span>
<a name="l01653"></a>01653 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): COMMAND: (script)"</span> << endl;
<a name="l01654"></a>01654 QString tmpfile = createTempScriptFile(command, <span class="keyword">false</span>, event, alarm);
<a name="l01655"></a>01655 <span class="keywordflow">if</span> (tmpfile.isEmpty())
<a name="l01656"></a>01656 result = 0;
<a name="l01657"></a>01657 <span class="keywordflow">else</span>
<a name="l01658"></a>01658 result = doShellCommand(tmpfile, event, &alarm, (flags | ProcData::TEMP_FILE));
<a name="l01659"></a>01659 }
<a name="l01660"></a>01660 <span class="keywordflow">else</span>
<a name="l01661"></a>01661 {
<a name="l01662"></a>01662 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): COMMAND: "</span> << command << endl;
<a name="l01663"></a>01663 result = doShellCommand(command, event, &alarm, flags);
<a name="l01664"></a>01664 }
<a name="l01665"></a>01665 <span class="keywordflow">if</span> (reschedule)
<a name="l01666"></a>01666 rescheduleAlarm(event, alarm, <span class="keyword">true</span>);
<a name="l01667"></a>01667 <span class="keywordflow">break</span>;
<a name="l01668"></a>01668 }
<a name="l01669"></a>01669 <span class="keywordflow">case</span> KAAlarm::EMAIL:
<a name="l01670"></a>01670 {
<a name="l01671"></a>01671 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): EMAIL to: "</span> << <span class="keyword">event</span>.emailAddresses(<span class="stringliteral">", "</span>) << endl;
<a name="l01672"></a>01672 QStringList errmsgs;
<a name="l01673"></a>01673 <span class="keywordflow">if</span> (!KAMail::send(event, errmsgs, (reschedule || allowDefer)))
<a name="l01674"></a>01674 result = 0;
<a name="l01675"></a>01675 <span class="keywordflow">if</span> (!errmsgs.isEmpty())
<a name="l01676"></a>01676 {
<a name="l01677"></a>01677 <span class="comment">// Some error occurred, although the email may have been sent successfully</span>
<a name="l01678"></a>01678 <span class="keywordflow">if</span> (result)
<a name="l01679"></a>01679 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): copy error: "</span> << errmsgs[1] << endl;
<a name="l01680"></a>01680 <span class="keywordflow">else</span>
<a name="l01681"></a>01681 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::execAlarm(): failed: "</span> << errmsgs[1] << endl;
<a name="l01682"></a>01682 (<span class="keyword">new</span> <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>(event, alarm.dateTime(), errmsgs))->show();
<a name="l01683"></a>01683 }
<a name="l01684"></a>01684 <span class="keywordflow">if</span> (reschedule)
<a name="l01685"></a>01685 rescheduleAlarm(event, alarm, <span class="keyword">true</span>);
<a name="l01686"></a>01686 <span class="keywordflow">break</span>;
<a name="l01687"></a>01687 }
<a name="l01688"></a>01688 <span class="keywordflow">default</span>:
<a name="l01689"></a>01689 <span class="keywordflow">return</span> 0;
<a name="l01690"></a>01690 }
<a name="l01691"></a>01691 <span class="keywordflow">return</span> result;
<a name="l01692"></a>01692 }
<a name="l01693"></a>01693
<a name="l01694"></a>01694 <span class="comment">/******************************************************************************</span>
<a name="l01695"></a>01695 <span class="comment">* Execute a shell command line specified by an alarm.</span>
<a name="l01696"></a>01696 <span class="comment">* If the PRE_ACTION bit of 'flags' is set, the alarm will be executed via</span>
<a name="l01697"></a>01697 <span class="comment">* execAlarm() once the command completes, the execAlarm() parameters being</span>
<a name="l01698"></a>01698 <span class="comment">* derived from the remaining bits in 'flags'.</span>
<a name="l01699"></a>01699 <span class="comment">*/</span>
<a name="l01700"></a>01700 ShellProcess* KAlarmApp::doShellCommand(<span class="keyword">const</span> QString& command, <span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, <span class="keyword">const</span> KAAlarm* alarm, <span class="keywordtype">int</span> flags)
<a name="l01701"></a>01701 {
<a name="l01702"></a>01702 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::doShellCommand("</span> << command << <span class="stringliteral">", "</span> << <span class="keyword">event</span>.id() << <span class="stringliteral">")"</span> << endl;
<a name="l01703"></a>01703 KProcess::Communication comms = KProcess::NoCommunication;
<a name="l01704"></a>01704 QString cmd;
<a name="l01705"></a>01705 QString tmpXtermFile;
<a name="l01706"></a>01706 <span class="keywordflow">if</span> (flags & ProcData::EXEC_IN_XTERM)
<a name="l01707"></a>01707 {
<a name="l01708"></a>01708 <span class="comment">// Execute the command in a terminal window.</span>
<a name="l01709"></a>01709 cmd = Preferences::cmdXTermCommand();
<a name="l01710"></a>01710 cmd.replace(<span class="stringliteral">"%t"</span>, aboutData()->programName()); <span class="comment">// set the terminal window title</span>
<a name="l01711"></a>01711 <span class="keywordflow">if</span> (cmd.find(<span class="stringliteral">"%C"</span>) >= 0)
<a name="l01712"></a>01712 {
<a name="l01713"></a>01713 <span class="comment">// Execute the command from a temporary script file</span>
<a name="l01714"></a>01714 <span class="keywordflow">if</span> (flags & ProcData::TEMP_FILE)
<a name="l01715"></a>01715 cmd.replace(<span class="stringliteral">"%C"</span>, command); <span class="comment">// the command is already calling a temporary file</span>
<a name="l01716"></a>01716 <span class="keywordflow">else</span>
<a name="l01717"></a>01717 {
<a name="l01718"></a>01718 tmpXtermFile = createTempScriptFile(command, <span class="keyword">true</span>, event, *alarm);
<a name="l01719"></a>01719 <span class="keywordflow">if</span> (tmpXtermFile.isEmpty())
<a name="l01720"></a>01720 <span class="keywordflow">return</span> 0;
<a name="l01721"></a>01721 cmd.replace(<span class="stringliteral">"%C"</span>, tmpXtermFile); <span class="comment">// %C indicates where to insert the command</span>
<a name="l01722"></a>01722 }
<a name="l01723"></a>01723 }
<a name="l01724"></a>01724 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cmd.find(<span class="stringliteral">"%W"</span>) >= 0)
<a name="l01725"></a>01725 {
<a name="l01726"></a>01726 <span class="comment">// Execute the command from a temporary script file,</span>
<a name="l01727"></a>01727 <span class="comment">// with a sleep after the command is executed</span>
<a name="l01728"></a>01728 tmpXtermFile = createTempScriptFile(command + QString::fromLatin1(<span class="stringliteral">"\nsleep 86400\n"</span>), <span class="keyword">true</span>, event, *alarm);
<a name="l01729"></a>01729 <span class="keywordflow">if</span> (tmpXtermFile.isEmpty())
<a name="l01730"></a>01730 <span class="keywordflow">return</span> 0;
<a name="l01731"></a>01731 cmd.replace(<span class="stringliteral">"%W"</span>, tmpXtermFile); <span class="comment">// %w indicates where to insert the command</span>
<a name="l01732"></a>01732 }
<a name="l01733"></a>01733 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (cmd.find(<span class="stringliteral">"%w"</span>) >= 0)
<a name="l01734"></a>01734 {
<a name="l01735"></a>01735 <span class="comment">// Append a sleep to the command.</span>
<a name="l01736"></a>01736 <span class="comment">// Quote the command in case it contains characters such as [>|;].</span>
<a name="l01737"></a>01737 QString exec = KShellProcess::quote(command + QString::fromLatin1(<span class="stringliteral">"; sleep 86400"</span>));
<a name="l01738"></a>01738 cmd.replace(<span class="stringliteral">"%w"</span>, exec); <span class="comment">// %w indicates where to insert the command string</span>
<a name="l01739"></a>01739 }
<a name="l01740"></a>01740 <span class="keywordflow">else</span>
<a name="l01741"></a>01741 {
<a name="l01742"></a>01742 <span class="comment">// Set the command to execute.</span>
<a name="l01743"></a>01743 <span class="comment">// Put it in quotes in case it contains characters such as [>|;].</span>
<a name="l01744"></a>01744 QString exec = KShellProcess::quote(command);
<a name="l01745"></a>01745 <span class="keywordflow">if</span> (cmd.find(<span class="stringliteral">"%c"</span>) >= 0)
<a name="l01746"></a>01746 cmd.replace(<span class="stringliteral">"%c"</span>, exec); <span class="comment">// %c indicates where to insert the command string</span>
<a name="l01747"></a>01747 <span class="keywordflow">else</span>
<a name="l01748"></a>01748 cmd.append(exec); <span class="comment">// otherwise, simply append the command string</span>
<a name="l01749"></a>01749 }
<a name="l01750"></a>01750 }
<a name="l01751"></a>01751 <span class="keywordflow">else</span>
<a name="l01752"></a>01752 {
<a name="l01753"></a>01753 cmd = command;
<a name="l01754"></a>01754 comms = KProcess::AllOutput;
<a name="l01755"></a>01755 }
<a name="l01756"></a>01756 ShellProcess* proc = <span class="keyword">new</span> ShellProcess(cmd);
<a name="l01757"></a>01757 connect(proc, SIGNAL(shellExited(ShellProcess*)), SLOT(slotCommandExited(ShellProcess*)));
<a name="l01758"></a>01758 QGuardedPtr<ShellProcess> logproc = 0;
<a name="l01759"></a>01759 <span class="keywordflow">if</span> (comms == KProcess::AllOutput && !event.<a class="code" href="classKAEvent.html#b744d21ac6dabaa19fcbee985c3beec8">logFile</a>().isEmpty())
<a name="l01760"></a>01760 {
<a name="l01761"></a>01761 <span class="comment">// Output is to be appended to a log file.</span>
<a name="l01762"></a>01762 <span class="comment">// Set up a logging process to write the command's output to.</span>
<a name="l01763"></a>01763 connect(proc, SIGNAL(receivedStdout(KProcess*,<span class="keywordtype">char</span>*,<span class="keywordtype">int</span>)), SLOT(slotCommandOutput(KProcess*,<span class="keywordtype">char</span>*,<span class="keywordtype">int</span>)));
<a name="l01764"></a>01764 connect(proc, SIGNAL(receivedStderr(KProcess*,<span class="keywordtype">char</span>*,<span class="keywordtype">int</span>)), SLOT(slotCommandOutput(KProcess*,<span class="keywordtype">char</span>*,<span class="keywordtype">int</span>)));
<a name="l01765"></a>01765 logproc = <span class="keyword">new</span> ShellProcess(QString::fromLatin1(<span class="stringliteral">"cat >>%1"</span>).arg(event.<a class="code" href="classKAEvent.html#b744d21ac6dabaa19fcbee985c3beec8">logFile</a>()));
<a name="l01766"></a>01766 connect(logproc, SIGNAL(shellExited(ShellProcess*)), SLOT(slotLogProcExited(ShellProcess*)));
<a name="l01767"></a>01767 logproc->start(KProcess::Stdin);
<a name="l01768"></a>01768 QCString heading;
<a name="l01769"></a>01769 <span class="keywordflow">if</span> (alarm && alarm->dateTime().isValid())
<a name="l01770"></a>01770 {
<a name="l01771"></a>01771 QString dateTime = alarm->dateTime().isDateOnly()
<a name="l01772"></a>01772 ? KGlobal::locale()->formatDate(alarm->dateTime().date(), <span class="keyword">true</span>)
<a name="l01773"></a>01773 : KGlobal::locale()->formatDateTime(alarm->dateTime().dateTime());
<a name="l01774"></a>01774 heading.sprintf(<span class="stringliteral">"\n******* KAlarm %s *******\n"</span>, dateTime.latin1());
<a name="l01775"></a>01775 }
<a name="l01776"></a>01776 <span class="keywordflow">else</span>
<a name="l01777"></a>01777 heading = <span class="stringliteral">"\n******* KAlarm *******\n"</span>;
<a name="l01778"></a>01778 logproc->writeStdin(heading, heading.length()+1);
<a name="l01779"></a>01779 }
<a name="l01780"></a>01780 ProcData* pd = <span class="keyword">new</span> ProcData(proc, logproc, <span class="keyword">new</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>(event), (alarm ? <span class="keyword">new</span> KAAlarm(*alarm) : 0), flags);
<a name="l01781"></a>01781 <span class="keywordflow">if</span> (flags & ProcData::TEMP_FILE)
<a name="l01782"></a>01782 pd->tempFiles += command;
<a name="l01783"></a>01783 <span class="keywordflow">if</span> (!tmpXtermFile.isEmpty())
<a name="l01784"></a>01784 pd->tempFiles += tmpXtermFile;
<a name="l01785"></a>01785 mCommandProcesses.append(pd);
<a name="l01786"></a>01786 <span class="keywordflow">if</span> (proc->start(comms))
<a name="l01787"></a>01787 <span class="keywordflow">return</span> proc;
<a name="l01788"></a>01788
<a name="l01789"></a>01789 <span class="comment">// Error executing command - report it</span>
<a name="l01790"></a>01790 kdError(5950) << <span class="stringliteral">"KAlarmApp::doShellCommand(): command failed to start\n"</span>;
<a name="l01791"></a>01791 commandErrorMsg(proc, event, alarm, flags);
<a name="l01792"></a>01792 mCommandProcesses.remove(pd);
<a name="l01793"></a>01793 <span class="keyword">delete</span> pd;
<a name="l01794"></a>01794 <span class="keywordflow">return</span> 0;
<a name="l01795"></a>01795 }
<a name="l01796"></a>01796
<a name="l01797"></a>01797 <span class="comment">/******************************************************************************</span>
<a name="l01798"></a>01798 <span class="comment">* Create a temporary script file containing the specified command string.</span>
<a name="l01799"></a>01799 <span class="comment">* Reply = path of temporary file, or null string if error.</span>
<a name="l01800"></a>01800 <span class="comment">*/</span>
<a name="l01801"></a>01801 QString KAlarmApp::createTempScriptFile(<span class="keyword">const</span> QString& command, <span class="keywordtype">bool</span> insertShell, <span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, <span class="keyword">const</span> KAAlarm& alarm)
<a name="l01802"></a>01802 {
<a name="l01803"></a>01803 KTempFile tmpFile(QString::null, QString::null, 0700);
<a name="l01804"></a>01804 tmpFile.setAutoDelete(<span class="keyword">false</span>); <span class="comment">// don't delete file when it is destructed</span>
<a name="l01805"></a>01805 QTextStream* stream = tmpFile.textStream();
<a name="l01806"></a>01806 <span class="keywordflow">if</span> (!stream)
<a name="l01807"></a>01807 kdError(5950) << <span class="stringliteral">"KAlarmApp::createTempScript(): Unable to create a temporary script file"</span> << endl;
<a name="l01808"></a>01808 <span class="keywordflow">else</span>
<a name="l01809"></a>01809 {
<a name="l01810"></a>01810 <span class="keywordflow">if</span> (insertShell)
<a name="l01811"></a>01811 *stream << <span class="stringliteral">"#!"</span> << ShellProcess::shellPath() << <span class="stringliteral">"\n"</span>;
<a name="l01812"></a>01812 *stream << command;
<a name="l01813"></a>01813 tmpFile.close();
<a name="l01814"></a>01814 <span class="keywordflow">if</span> (tmpFile.status())
<a name="l01815"></a>01815 kdError(5950) << <span class="stringliteral">"KAlarmApp::createTempScript(): Error "</span> << tmpFile.status() << <span class="stringliteral">" writing to temporary script file"</span> << endl;
<a name="l01816"></a>01816 <span class="keywordflow">else</span>
<a name="l01817"></a>01817 <span class="keywordflow">return</span> tmpFile.name();
<a name="l01818"></a>01818 }
<a name="l01819"></a>01819
<a name="l01820"></a>01820 QStringList errmsgs(i18n(<span class="stringliteral">"Error creating temporary script file"</span>));
<a name="l01821"></a>01821 (<span class="keyword">new</span> <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>(event, alarm.dateTime(), errmsgs))->show();
<a name="l01822"></a>01822 <span class="keywordflow">return</span> QString::null;
<a name="l01823"></a>01823 }
<a name="l01824"></a>01824
<a name="l01825"></a>01825 <span class="comment">/******************************************************************************</span>
<a name="l01826"></a>01826 <span class="comment">* Called when an executing command alarm sends output to stdout or stderr.</span>
<a name="l01827"></a>01827 <span class="comment">*/</span>
<a name="l01828"></a>01828 <span class="keywordtype">void</span> KAlarmApp::slotCommandOutput(KProcess* proc, <span class="keywordtype">char</span>* buffer, <span class="keywordtype">int</span> bufflen)
<a name="l01829"></a>01829 {
<a name="l01830"></a>01830 <span class="comment">//kdDebug(5950) << "KAlarmApp::slotCommandOutput(): '" << QCString(buffer, bufflen+1) << "'\n";</span>
<a name="l01831"></a>01831 <span class="comment">// Find this command in the command list</span>
<a name="l01832"></a>01832 <span class="keywordflow">for</span> (QValueList<ProcData*>::Iterator it = mCommandProcesses.begin(); it != mCommandProcesses.end(); ++it)
<a name="l01833"></a>01833 {
<a name="l01834"></a>01834 ProcData* pd = *it;
<a name="l01835"></a>01835 <span class="keywordflow">if</span> (pd->process == proc && pd->logProcess)
<a name="l01836"></a>01836 {
<a name="l01837"></a>01837 pd->logProcess->writeStdin(buffer, bufflen);
<a name="l01838"></a>01838 <span class="keywordflow">break</span>;
<a name="l01839"></a>01839 }
<a name="l01840"></a>01840 }
<a name="l01841"></a>01841 }
<a name="l01842"></a>01842
<a name="l01843"></a>01843 <span class="comment">/******************************************************************************</span>
<a name="l01844"></a>01844 <span class="comment">* Called when a logging process completes.</span>
<a name="l01845"></a>01845 <span class="comment">*/</span>
<a name="l01846"></a>01846 <span class="keywordtype">void</span> KAlarmApp::slotLogProcExited(ShellProcess* proc)
<a name="l01847"></a>01847 {
<a name="l01848"></a>01848 <span class="comment">// Because it's held as a guarded pointer in the ProcData structure,</span>
<a name="l01849"></a>01849 <span class="comment">// we don't need to set any pointers to zero.</span>
<a name="l01850"></a>01850 <span class="keyword">delete</span> proc;
<a name="l01851"></a>01851 }
<a name="l01852"></a>01852
<a name="l01853"></a>01853 <span class="comment">/******************************************************************************</span>
<a name="l01854"></a>01854 <span class="comment">* Called when a command alarm's execution completes.</span>
<a name="l01855"></a>01855 <span class="comment">*/</span>
<a name="l01856"></a>01856 <span class="keywordtype">void</span> KAlarmApp::slotCommandExited(ShellProcess* proc)
<a name="l01857"></a>01857 {
<a name="l01858"></a>01858 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::slotCommandExited()\n"</span>;
<a name="l01859"></a>01859 <span class="comment">// Find this command in the command list</span>
<a name="l01860"></a>01860 <span class="keywordflow">for</span> (QValueList<ProcData*>::Iterator it = mCommandProcesses.begin(); it != mCommandProcesses.end(); ++it)
<a name="l01861"></a>01861 {
<a name="l01862"></a>01862 ProcData* pd = *it;
<a name="l01863"></a>01863 <span class="keywordflow">if</span> (pd->process == proc)
<a name="l01864"></a>01864 {
<a name="l01865"></a>01865 <span class="comment">// Found the command</span>
<a name="l01866"></a>01866 <span class="keywordflow">if</span> (pd->logProcess)
<a name="l01867"></a>01867 pd->logProcess->stdinExit(); <span class="comment">// terminate the logging process</span>
<a name="l01868"></a>01868
<a name="l01869"></a>01869 <span class="comment">// Check its exit status</span>
<a name="l01870"></a>01870 <span class="keywordflow">if</span> (!proc->normalExit())
<a name="l01871"></a>01871 {
<a name="l01872"></a>01872 QString errmsg = proc->errorMessage();
<a name="l01873"></a>01873 kdWarning(5950) << <span class="stringliteral">"KAlarmApp::slotCommandExited("</span> << pd->event->cleanText() << <span class="stringliteral">"): "</span> << errmsg << endl;
<a name="l01874"></a>01874 <span class="keywordflow">if</span> (pd->messageBoxParent)
<a name="l01875"></a>01875 {
<a name="l01876"></a>01876 <span class="comment">// Close the existing informational KMessageBox for this process</span>
<a name="l01877"></a>01877 QObjectList* dialogs = pd->messageBoxParent->queryList(<span class="stringliteral">"KDialogBase"</span>, 0, <span class="keyword">false</span>, <span class="keyword">true</span>);
<a name="l01878"></a>01878 KDialogBase* dialog = (KDialogBase*)dialogs->getFirst();
<a name="l01879"></a>01879 <span class="keyword">delete</span> dialog;
<a name="l01880"></a>01880 <span class="keyword">delete</span> dialogs;
<a name="l01881"></a>01881 <span class="keywordflow">if</span> (!pd->tempFile())
<a name="l01882"></a>01882 {
<a name="l01883"></a>01883 errmsg += <span class="charliteral">'\n'</span>;
<a name="l01884"></a>01884 errmsg += proc->command();
<a name="l01885"></a>01885 }
<a name="l01886"></a>01886 KMessageBox::error(pd->messageBoxParent, errmsg);
<a name="l01887"></a>01887 }
<a name="l01888"></a>01888 <span class="keywordflow">else</span>
<a name="l01889"></a>01889 commandErrorMsg(proc, *pd->event, pd->alarm, pd->flags);
<a name="l01890"></a>01890 }
<a name="l01891"></a>01891 <span class="keywordflow">if</span> (pd->preAction())
<a name="l01892"></a>01892 execAlarm(*pd->event, *pd->alarm, pd->reschedule(), pd->allowDefer(), <span class="keyword">true</span>);
<a name="l01893"></a>01893 mCommandProcesses.remove(it);
<a name="l01894"></a>01894 <span class="keyword">delete</span> pd;
<a name="l01895"></a>01895 <span class="keywordflow">break</span>;
<a name="l01896"></a>01896 }
<a name="l01897"></a>01897 }
<a name="l01898"></a>01898
<a name="l01899"></a>01899 <span class="comment">// If there are now no executing shell commands, quit if a quit was queued</span>
<a name="l01900"></a>01900 <span class="keywordflow">if</span> (mPendingQuit && mCommandProcesses.isEmpty())
<a name="l01901"></a>01901 quitIf(mPendingQuitCode);
<a name="l01902"></a>01902 }
<a name="l01903"></a>01903
<a name="l01904"></a>01904 <span class="comment">/******************************************************************************</span>
<a name="l01905"></a>01905 <span class="comment">* Output an error message for a shell command.</span>
<a name="l01906"></a>01906 <span class="comment">*/</span>
<a name="l01907"></a>01907 <span class="keywordtype">void</span> KAlarmApp::commandErrorMsg(<span class="keyword">const</span> ShellProcess* proc, <span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>& event, <span class="keyword">const</span> KAAlarm* alarm, <span class="keywordtype">int</span> flags)
<a name="l01908"></a>01908 {
<a name="l01909"></a>01909 QStringList errmsgs;
<a name="l01910"></a>01910 <span class="keywordflow">if</span> (flags & ProcData::PRE_ACTION)
<a name="l01911"></a>01911 errmsgs += i18n(<span class="stringliteral">"Pre-alarm action:"</span>);
<a name="l01912"></a>01912 <span class="keywordflow">else</span> <span class="keywordflow">if</span> (flags & ProcData::POST_ACTION)
<a name="l01913"></a>01913 errmsgs += i18n(<span class="stringliteral">"Post-alarm action:"</span>);
<a name="l01914"></a>01914 errmsgs += proc->errorMessage();
<a name="l01915"></a>01915 <span class="keywordflow">if</span> (!(flags & ProcData::TEMP_FILE))
<a name="l01916"></a>01916 errmsgs += proc->command();
<a name="l01917"></a>01917 (<span class="keyword">new</span> <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>(event, (alarm ? alarm->dateTime() : DateTime()), errmsgs))->show();
<a name="l01918"></a>01918 }
<a name="l01919"></a>01919
<a name="l01920"></a>01920 <span class="comment">/******************************************************************************</span>
<a name="l01921"></a>01921 <span class="comment">* Notes that an informational KMessageBox is displayed for this process.</span>
<a name="l01922"></a>01922 <span class="comment">*/</span>
<a name="l01923"></a>01923 <span class="keywordtype">void</span> KAlarmApp::commandMessage(ShellProcess* proc, QWidget* parent)
<a name="l01924"></a>01924 {
<a name="l01925"></a>01925 <span class="comment">// Find this command in the command list</span>
<a name="l01926"></a>01926 <span class="keywordflow">for</span> (QValueList<ProcData*>::Iterator it = mCommandProcesses.begin(); it != mCommandProcesses.end(); ++it)
<a name="l01927"></a>01927 {
<a name="l01928"></a>01928 ProcData* pd = *it;
<a name="l01929"></a>01929 <span class="keywordflow">if</span> (pd->process == proc)
<a name="l01930"></a>01930 {
<a name="l01931"></a>01931 pd->messageBoxParent = parent;
<a name="l01932"></a>01932 <span class="keywordflow">break</span>;
<a name="l01933"></a>01933 }
<a name="l01934"></a>01934 }
<a name="l01935"></a>01935 }
<a name="l01936"></a>01936
<a name="l01937"></a>01937 <span class="comment">/******************************************************************************</span>
<a name="l01938"></a>01938 <span class="comment">* Set up remaining DCOP handlers and start processing DCOP calls.</span>
<a name="l01939"></a>01939 <span class="comment">*/</span>
<a name="l01940"></a>01940 <span class="keywordtype">void</span> KAlarmApp::setUpDcop()
<a name="l01941"></a>01941 {
<a name="l01942"></a>01942 <span class="keywordflow">if</span> (!mInitialised)
<a name="l01943"></a>01943 {
<a name="l01944"></a>01944 mInitialised = <span class="keyword">true</span>; <span class="comment">// we're now ready to handle DCOP calls</span>
<a name="l01945"></a>01945 Daemon::createDcopHandler();
<a name="l01946"></a>01946 QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(processQueue())); <span class="comment">// process anything already queued</span>
<a name="l01947"></a>01947 }
<a name="l01948"></a>01948 }
<a name="l01949"></a>01949
<a name="l01950"></a>01950 <span class="comment">/******************************************************************************</span>
<a name="l01951"></a>01951 <span class="comment">* If this is the first time through, open the calendar file, optionally start</span>
<a name="l01952"></a>01952 <span class="comment">* the alarm daemon and register with it, and set up the DCOP handler.</span>
<a name="l01953"></a>01953 <span class="comment">*/</span>
<a name="l01954"></a>01954 <span class="keywordtype">bool</span> KAlarmApp::initCheck(<span class="keywordtype">bool</span> calendarOnly)
<a name="l01955"></a>01955 {
<a name="l01956"></a>01956 <span class="keywordtype">bool</span> startdaemon;
<a name="l01957"></a>01957 <a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>* cal = AlarmCalendar::activeCalendar();
<a name="l01958"></a>01958 <span class="keywordflow">if</span> (!cal-><a class="code" href="classAlarmCalendar.html#021bd79d94b5f0f5d26af2ab15a11776">isOpen</a>())
<a name="l01959"></a>01959 {
<a name="l01960"></a>01960 kdDebug(5950) << <span class="stringliteral">"KAlarmApp::initCheck(): opening active calendar\n"</span>;
<a name="l01961"></a>01961
<a name="l01962"></a>01962 <span class="comment">// First time through. Open the calendar file.</span>
<a name="l01963"></a>01963 <span class="keywordflow">if</span> (!cal-><a class="code" href="classAlarmCalendar.html#bd21208209bcdc5f80feaecedf894695">open</a>())
<a name="l01964"></a>01964 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l01965"></a>01965
<a name="l01966"></a>01966 <span class="keywordflow">if</span> (!mStartOfDay.isValid())
<a name="l01967"></a>01967 changeStartOfDay(); <span class="comment">// start of day time has changed, so adjust date-only alarms</span>
<a name="l01968"></a>01968
<a name="l01969"></a>01969 <span class="comment">/* Need to open the display calendar now, since otherwise if the daemon</span>
<a name="l01970"></a>01970 <span class="comment"> * immediately notifies display alarms, they will often be processed while</span>
<a name="l01971"></a>01971 <span class="comment"> * redisplayAlarms() is executing open() (but before open() completes),</span>
<a name="l01972"></a>01972 <span class="comment"> * which causes problems!!</span>
<a name="l01973"></a>01973 <span class="comment"> */</span>
<a name="l01974"></a>01974 AlarmCalendar::displayCalendar()-><a class="code" href="classAlarmCalendar.html#bd21208209bcdc5f80feaecedf894695">open</a>();
<a name="l01975"></a>01975
<a name="l01976"></a>01976 <span class="comment">/* Need to open the expired alarm calendar now, since otherwise if the daemon</span>
<a name="l01977"></a>01977 <span class="comment"> * immediately notifies multiple alarms, the second alarm is likely to be</span>
<a name="l01978"></a>01978 <span class="comment"> * processed while the calendar is executing open() (but before open() completes),</span>
<a name="l01979"></a>01979 <span class="comment"> * which causes a hang!!</span>
<a name="l01980"></a>01980 <span class="comment"> */</span>
<a name="l01981"></a>01981 AlarmCalendar::expiredCalendar()-><a class="code" href="classAlarmCalendar.html#bd21208209bcdc5f80feaecedf894695">open</a>();
<a name="l01982"></a>01982 AlarmCalendar::expiredCalendar()-><a class="code" href="classAlarmCalendar.html#be59ff6d3248a94eb3130ce8f8ce5f5b">setPurgeDays</a>(theInstance->mPrefsExpiredKeepDays);
<a name="l01983"></a>01983
<a name="l01984"></a>01984 startdaemon = <span class="keyword">true</span>;
<a name="l01985"></a>01985 }
<a name="l01986"></a>01986 <span class="keywordflow">else</span>
<a name="l01987"></a>01987 startdaemon = !Daemon::isRegistered();
<a name="l01988"></a>01988
<a name="l01989"></a>01989 <span class="keywordflow">if</span> (!calendarOnly)
<a name="l01990"></a>01990 {
<a name="l01991"></a>01991 setUpDcop(); <span class="comment">// start processing DCOP calls</span>
<a name="l01992"></a>01992 <span class="keywordflow">if</span> (startdaemon)
<a name="l01993"></a>01993 Daemon::start(); <span class="comment">// make sure the alarm daemon is running</span>
<a name="l01994"></a>01994 }
<a name="l01995"></a>01995 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l01996"></a>01996 }
<a name="l01997"></a>01997
<a name="l01998"></a>01998 <span class="comment">/******************************************************************************</span>
<a name="l01999"></a>01999 <span class="comment">* Convert the --time parameter string into a date/time or date value.</span>
<a name="l02000"></a>02000 <span class="comment">* The parameter is in the form [[[yyyy-]mm-]dd-]hh:mm or yyyy-mm-dd.</span>
<a name="l02001"></a>02001 <span class="comment">* Reply = true if successful.</span>
<a name="l02002"></a>02002 <span class="comment">*/</span>
<a name="l02003"></a>02003 <span class="keyword">static</span> <span class="keywordtype">bool</span> convWakeTime(<span class="keyword">const</span> QCString& timeParam, QDateTime& dateTime, <span class="keywordtype">bool</span>& noTime)
<a name="l02004"></a>02004 {
<a name="l02005"></a>02005 <span class="keywordflow">if</span> (timeParam.length() > 19)
<a name="l02006"></a>02006 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02007"></a>02007 <span class="keywordtype">char</span> timeStr[20];
<a name="l02008"></a>02008 strcpy(timeStr, timeParam);
<a name="l02009"></a>02009 <span class="keywordtype">int</span> dt[5] = { -1, -1, -1, -1, -1 };
<a name="l02010"></a>02010 <span class="keywordtype">char</span>* s;
<a name="l02011"></a>02011 <span class="keywordtype">char</span>* end;
<a name="l02012"></a>02012 <span class="comment">// Get the minute value</span>
<a name="l02013"></a>02013 <span class="keywordflow">if</span> ((s = strchr(timeStr, <span class="charliteral">':'</span>)) == 0)
<a name="l02014"></a>02014 noTime = <span class="keyword">true</span>;
<a name="l02015"></a>02015 <span class="keywordflow">else</span>
<a name="l02016"></a>02016 {
<a name="l02017"></a>02017 noTime = <span class="keyword">false</span>;
<a name="l02018"></a>02018 *s++ = 0;
<a name="l02019"></a>02019 dt[4] = strtoul(s, &end, 10);
<a name="l02020"></a>02020 <span class="keywordflow">if</span> (end == s || *end || dt[4] >= 60)
<a name="l02021"></a>02021 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02022"></a>02022 <span class="comment">// Get the hour value</span>
<a name="l02023"></a>02023 <span class="keywordflow">if</span> ((s = strrchr(timeStr, <span class="charliteral">'-'</span>)) == 0)
<a name="l02024"></a>02024 s = timeStr;
<a name="l02025"></a>02025 <span class="keywordflow">else</span>
<a name="l02026"></a>02026 *s++ = 0;
<a name="l02027"></a>02027 dt[3] = strtoul(s, &end, 10);
<a name="l02028"></a>02028 <span class="keywordflow">if</span> (end == s || *end || dt[3] >= 24)
<a name="l02029"></a>02029 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02030"></a>02030 }
<a name="l02031"></a>02031 <span class="keywordtype">bool</span> dateSet = <span class="keyword">false</span>;
<a name="l02032"></a>02032 <span class="keywordflow">if</span> (s != timeStr)
<a name="l02033"></a>02033 {
<a name="l02034"></a>02034 dateSet = <span class="keyword">true</span>;
<a name="l02035"></a>02035 <span class="comment">// Get the day value</span>
<a name="l02036"></a>02036 <span class="keywordflow">if</span> ((s = strrchr(timeStr, <span class="charliteral">'-'</span>)) == 0)
<a name="l02037"></a>02037 s = timeStr;
<a name="l02038"></a>02038 <span class="keywordflow">else</span>
<a name="l02039"></a>02039 *s++ = 0;
<a name="l02040"></a>02040 dt[2] = strtoul(s, &end, 10);
<a name="l02041"></a>02041 <span class="keywordflow">if</span> (end == s || *end || dt[2] == 0 || dt[2] > 31)
<a name="l02042"></a>02042 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02043"></a>02043 <span class="keywordflow">if</span> (s != timeStr)
<a name="l02044"></a>02044 {
<a name="l02045"></a>02045 <span class="comment">// Get the month value</span>
<a name="l02046"></a>02046 <span class="keywordflow">if</span> ((s = strrchr(timeStr, <span class="charliteral">'-'</span>)) == 0)
<a name="l02047"></a>02047 s = timeStr;
<a name="l02048"></a>02048 <span class="keywordflow">else</span>
<a name="l02049"></a>02049 *s++ = 0;
<a name="l02050"></a>02050 dt[1] = strtoul(s, &end, 10);
<a name="l02051"></a>02051 <span class="keywordflow">if</span> (end == s || *end || dt[1] == 0 || dt[1] > 12)
<a name="l02052"></a>02052 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02053"></a>02053 <span class="keywordflow">if</span> (s != timeStr)
<a name="l02054"></a>02054 {
<a name="l02055"></a>02055 <span class="comment">// Get the year value</span>
<a name="l02056"></a>02056 dt[0] = strtoul(timeStr, &end, 10);
<a name="l02057"></a>02057 <span class="keywordflow">if</span> (end == timeStr || *end)
<a name="l02058"></a>02058 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02059"></a>02059 }
<a name="l02060"></a>02060 }
<a name="l02061"></a>02061 }
<a name="l02062"></a>02062
<a name="l02063"></a>02063 QDate date(dt[0], dt[1], dt[2]);
<a name="l02064"></a>02064 QTime time(0, 0, 0);
<a name="l02065"></a>02065 <span class="keywordflow">if</span> (noTime)
<a name="l02066"></a>02066 {
<a name="l02067"></a>02067 <span class="comment">// No time was specified, so the full date must have been specified</span>
<a name="l02068"></a>02068 <span class="keywordflow">if</span> (dt[0] < 0)
<a name="l02069"></a>02069 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02070"></a>02070 }
<a name="l02071"></a>02071 <span class="keywordflow">else</span>
<a name="l02072"></a>02072 {
<a name="l02073"></a>02073 <span class="comment">// Compile the values into a date/time structure</span>
<a name="l02074"></a>02074 QDateTime now = QDateTime::currentDateTime();
<a name="l02075"></a>02075 <span class="keywordflow">if</span> (dt[0] < 0)
<a name="l02076"></a>02076 date.setYMD(now.date().year(),
<a name="l02077"></a>02077 (dt[1] < 0 ? now.date().month() : dt[1]),
<a name="l02078"></a>02078 (dt[2] < 0 ? now.date().day() : dt[2]));
<a name="l02079"></a>02079 time.setHMS(dt[3], dt[4], 0);
<a name="l02080"></a>02080 <span class="keywordflow">if</span> (!dateSet && time < now.time())
<a name="l02081"></a>02081 date = date.addDays(1);
<a name="l02082"></a>02082 }
<a name="l02083"></a>02083 <span class="keywordflow">if</span> (!date.isValid())
<a name="l02084"></a>02084 <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l02085"></a>02085 dateTime.setDate(date);
<a name="l02086"></a>02086 dateTime.setTime(time);
<a name="l02087"></a>02087 <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l02088"></a>02088 }
<a name="l02089"></a>02089
<a name="l02090"></a>02090 <span class="comment">/******************************************************************************</span>
<a name="l02091"></a>02091 <span class="comment">* Convert a time interval command line parameter.</span>
<a name="l02092"></a>02092 <span class="comment">* 'timeInterval' receives the count for the recurType. If 'allowMonthYear' is</span>
<a name="l02093"></a>02093 <span class="comment">* false, 'timeInterval' is converted to minutes.</span>
<a name="l02094"></a>02094 <span class="comment">* Reply = true if successful.</span>
<a name="l02095"></a>02095 <span class="comment">*/</span>
<a name="l02096"></a>02096 <span class="keyword">static</span> <span class="keywordtype">bool</span> convInterval(<span class="keyword">const</span> QCString& timeParam, KARecurrence::Type& recurType, <span class="keywordtype">int</span>& timeInterval, <span class="keywordtype">bool</span> allowMonthYear)
<a name="l02097"></a>02097 {
<a name="l02098"></a>02098 QCString timeString = timeParam;
<a name="l02099"></a>02099 <span class="comment">// Get the recurrence interval</span>
<a name="l02100"></a>02100 <span class="keywordtype">bool</span> ok = <span class="keyword">true</span>;
<a name="l02101"></a>02101 uint interval = 0;
<a name="l02102"></a>02102 <span class="keywordtype">bool</span> negative = (timeString[0] == <span class="charliteral">'-'</span>);
<a name="l02103"></a>02103 <span class="keywordflow">if</span> (negative)
<a name="l02104"></a>02104 timeString = timeString.right(1);
<a name="l02105"></a>02105 uint length = timeString.length();
<a name="l02106"></a>02106 <span class="keywordflow">switch</span> (timeString[length - 1])
<a name="l02107"></a>02107 {
<a name="l02108"></a>02108 <span class="keywordflow">case</span> <span class="charliteral">'Y'</span>:
<a name="l02109"></a>02109 <span class="keywordflow">if</span> (!allowMonthYear)
<a name="l02110"></a>02110 ok = <span class="keyword">false</span>;
<a name="l02111"></a>02111 recurType = KARecurrence::ANNUAL_DATE;
<a name="l02112"></a>02112 timeString = timeString.left(length - 1);
<a name="l02113"></a>02113 <span class="keywordflow">break</span>;
<a name="l02114"></a>02114 <span class="keywordflow">case</span> <span class="charliteral">'W'</span>:
<a name="l02115"></a>02115 recurType = KARecurrence::WEEKLY;
<a name="l02116"></a>02116 timeString = timeString.left(length - 1);
<a name="l02117"></a>02117 <span class="keywordflow">break</span>;
<a name="l02118"></a>02118 <span class="keywordflow">case</span> <span class="charliteral">'D'</span>:
<a name="l02119"></a>02119 recurType = KARecurrence::DAILY;
<a name="l02120"></a>02120 timeString = timeString.left(length - 1);
<a name="l02121"></a>02121 <span class="keywordflow">break</span>;
<a name="l02122"></a>02122 <span class="keywordflow">case</span> <span class="charliteral">'M'</span>:
<a name="l02123"></a>02123 {
<a name="l02124"></a>02124 <span class="keywordtype">int</span> i = timeString.find(<span class="charliteral">'H'</span>);
<a name="l02125"></a>02125 <span class="keywordflow">if</span> (i < 0)
<a name="l02126"></a>02126 {
<a name="l02127"></a>02127 <span class="keywordflow">if</span> (!allowMonthYear)
<a name="l02128"></a>02128 ok = <span class="keyword">false</span>;
<a name="l02129"></a>02129 recurType = KARecurrence::MONTHLY_DAY;
<a name="l02130"></a>02130 timeString = timeString.left(length - 1);
<a name="l02131"></a>02131 }
<a name="l02132"></a>02132 <span class="keywordflow">else</span>
<a name="l02133"></a>02133 {
<a name="l02134"></a>02134 recurType = KARecurrence::MINUTELY;
<a name="l02135"></a>02135 interval = timeString.left(i).toUInt(&ok) * 60;
<a name="l02136"></a>02136 timeString = timeString.mid(i + 1, length - i - 2);
<a name="l02137"></a>02137 }
<a name="l02138"></a>02138 <span class="keywordflow">break</span>;
<a name="l02139"></a>02139 }
<a name="l02140"></a>02140 <span class="keywordflow">default</span>: <span class="comment">// should be a digit</span>
<a name="l02141"></a>02141 recurType = KARecurrence::MINUTELY;
<a name="l02142"></a>02142 <span class="keywordflow">break</span>;
<a name="l02143"></a>02143 }
<a name="l02144"></a>02144 <span class="keywordflow">if</span> (ok)
<a name="l02145"></a>02145 interval += timeString.toUInt(&ok);
<a name="l02146"></a>02146 <span class="keywordflow">if</span> (!allowMonthYear)
<a name="l02147"></a>02147 {
<a name="l02148"></a>02148 <span class="comment">// Convert time interval to minutes</span>
<a name="l02149"></a>02149 <span class="keywordflow">switch</span> (recurType)
<a name="l02150"></a>02150 {
<a name="l02151"></a>02151 <span class="keywordflow">case</span> KARecurrence::WEEKLY:
<a name="l02152"></a>02152 interval *= 7;
<a name="l02153"></a>02153 <span class="comment">// fall through to DAILY</span>
<a name="l02154"></a>02154 <span class="keywordflow">case</span> KARecurrence::DAILY:
<a name="l02155"></a>02155 interval *= 24*60;
<a name="l02156"></a>02156 <span class="keywordflow">break</span>;
<a name="l02157"></a>02157 <span class="keywordflow">default</span>:
<a name="l02158"></a>02158 <span class="keywordflow">break</span>;
<a name="l02159"></a>02159 }
<a name="l02160"></a>02160 }
<a name="l02161"></a>02161 timeInterval = <span class="keyword">static_cast<</span><span class="keywordtype">int</span><span class="keyword">></span>(interval);
<a name="l02162"></a>02162 <span class="keywordflow">if</span> (negative)
<a name="l02163"></a>02163 timeInterval = -timeInterval;
<a name="l02164"></a>02164 <span class="keywordflow">return</span> ok;
<a name="l02165"></a>02165 }
<a name="l02166"></a>02166
<a name="l02167"></a>02167 KAlarmApp::ProcData::ProcData(ShellProcess* p, ShellProcess* logp, <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>* e, KAAlarm* a, <span class="keywordtype">int</span> f)
<a name="l02168"></a>02168 : process(p),
<a name="l02169"></a>02169 logProcess(logp),
<a name="l02170"></a>02170 event(e),
<a name="l02171"></a>02171 alarm(a),
<a name="l02172"></a>02172 messageBoxParent(0),
<a name="l02173"></a>02173 flags(f)
<a name="l02174"></a>02174 { }
<a name="l02175"></a>02175
<a name="l02176"></a>02176 KAlarmApp::ProcData::~ProcData()
<a name="l02177"></a>02177 {
<a name="l02178"></a>02178 <span class="keywordflow">while</span> (!tempFiles.isEmpty())
<a name="l02179"></a>02179 {
<a name="l02180"></a>02180 <span class="comment">// Delete the temporary file called by the XTerm command</span>
<a name="l02181"></a>02181 QFile f(tempFiles.first());
<a name="l02182"></a>02182 f.remove();
<a name="l02183"></a>02183 tempFiles.remove(tempFiles.begin());
<a name="l02184"></a>02184 }
<a name="l02185"></a>02185 <span class="keyword">delete</span> process;
<a name="l02186"></a>02186 <span class="keyword">delete</span> event;
<a name="l02187"></a>02187 <span class="keyword">delete</span> alarm;
<a name="l02188"></a>02188 }
</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>
