Sophie

Sophie

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

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

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

<head>
  <title>kalarm: messagewin.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>messagewin.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"> *  messagewin.cpp  -  displays an alarm message</span>
<a name="l00003"></a>00003 <span class="comment"> *  Program:  kalarm</span>
<a name="l00004"></a>00004 <span class="comment"> *  Copyright © 2001-2007 by David Jarvie &lt;software@astrojar.org.uk&gt;</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 &lt;stdlib.h&gt;</span>
<a name="l00024"></a>00024 <span class="preprocessor">#include &lt;string.h&gt;</span>
<a name="l00025"></a>00025 
<a name="l00026"></a>00026 <span class="preprocessor">#include &lt;qfile.h&gt;</span>
<a name="l00027"></a>00027 <span class="preprocessor">#include &lt;qfileinfo.h&gt;</span>
<a name="l00028"></a>00028 <span class="preprocessor">#include &lt;qlayout.h&gt;</span>
<a name="l00029"></a>00029 <span class="preprocessor">#include &lt;qpushbutton.h&gt;</span>
<a name="l00030"></a>00030 <span class="preprocessor">#include &lt;qlabel.h&gt;</span>
<a name="l00031"></a>00031 <span class="preprocessor">#include &lt;qwhatsthis.h&gt;</span>
<a name="l00032"></a>00032 <span class="preprocessor">#include &lt;qtooltip.h&gt;</span>
<a name="l00033"></a>00033 <span class="preprocessor">#include &lt;qdragobject.h&gt;</span>
<a name="l00034"></a>00034 <span class="preprocessor">#include &lt;qtextedit.h&gt;</span>
<a name="l00035"></a>00035 <span class="preprocessor">#include &lt;qtimer.h&gt;</span>
<a name="l00036"></a>00036 
<a name="l00037"></a>00037 <span class="preprocessor">#include &lt;kstandarddirs.h&gt;</span>
<a name="l00038"></a>00038 <span class="preprocessor">#include &lt;kaction.h&gt;</span>
<a name="l00039"></a>00039 <span class="preprocessor">#include &lt;kstdguiitem.h&gt;</span>
<a name="l00040"></a>00040 <span class="preprocessor">#include &lt;kaboutdata.h&gt;</span>
<a name="l00041"></a>00041 <span class="preprocessor">#include &lt;klocale.h&gt;</span>
<a name="l00042"></a>00042 <span class="preprocessor">#include &lt;kconfig.h&gt;</span>
<a name="l00043"></a>00043 <span class="preprocessor">#include &lt;kiconloader.h&gt;</span>
<a name="l00044"></a>00044 <span class="preprocessor">#include &lt;kdialog.h&gt;</span>
<a name="l00045"></a>00045 <span class="preprocessor">#include &lt;ktextbrowser.h&gt;</span>
<a name="l00046"></a>00046 <span class="preprocessor">#include &lt;kglobalsettings.h&gt;</span>
<a name="l00047"></a>00047 <span class="preprocessor">#include &lt;kmimetype.h&gt;</span>
<a name="l00048"></a>00048 <span class="preprocessor">#include &lt;kmessagebox.h&gt;</span>
<a name="l00049"></a>00049 <span class="preprocessor">#include &lt;kwin.h&gt;</span>
<a name="l00050"></a>00050 <span class="preprocessor">#include &lt;kwinmodule.h&gt;</span>
<a name="l00051"></a>00051 <span class="preprocessor">#include &lt;kprocess.h&gt;</span>
<a name="l00052"></a>00052 <span class="preprocessor">#include &lt;kio/netaccess.h&gt;</span>
<a name="l00053"></a>00053 <span class="preprocessor">#include &lt;knotifyclient.h&gt;</span>
<a name="l00054"></a>00054 <span class="preprocessor">#include &lt;kpushbutton.h&gt;</span>
<a name="l00055"></a>00055 <span class="preprocessor">#ifdef WITHOUT_ARTS</span>
<a name="l00056"></a>00056 <span class="preprocessor"></span><span class="preprocessor">#include &lt;kaudioplayer.h&gt;</span>
<a name="l00057"></a>00057 <span class="preprocessor">#else</span>
<a name="l00058"></a>00058 <span class="preprocessor"></span><span class="preprocessor">#include &lt;arts/kartsdispatcher.h&gt;</span>
<a name="l00059"></a>00059 <span class="preprocessor">#include &lt;arts/kartsserver.h&gt;</span>
<a name="l00060"></a>00060 <span class="preprocessor">#include &lt;arts/kplayobjectfactory.h&gt;</span>
<a name="l00061"></a>00061 <span class="preprocessor">#include &lt;arts/kplayobject.h&gt;</span>
<a name="l00062"></a>00062 <span class="preprocessor">#endif</span>
<a name="l00063"></a>00063 <span class="preprocessor"></span><span class="preprocessor">#include &lt;dcopclient.h&gt;</span>
<a name="l00064"></a>00064 <span class="preprocessor">#include &lt;kdebug.h&gt;</span>
<a name="l00065"></a>00065 
<a name="l00066"></a>00066 <span class="preprocessor">#include "alarmcalendar.h"</span>
<a name="l00067"></a>00067 <span class="preprocessor">#include "deferdlg.h"</span>
<a name="l00068"></a>00068 <span class="preprocessor">#include "editdlg.h"</span>
<a name="l00069"></a>00069 <span class="preprocessor">#include "<a class="code" href="functions_8h.html" title="miscellaneous functions">functions.h</a>"</span>
<a name="l00070"></a>00070 <span class="preprocessor">#include "<a class="code" href="kalarmapp_8h.html" title="the KAlarm application object">kalarmapp.h</a>"</span>
<a name="l00071"></a>00071 <span class="preprocessor">#include "<a class="code" href="mainwindow_8h.html" title="main application window">mainwindow.h</a>"</span>
<a name="l00072"></a>00072 <span class="preprocessor">#include "preferences.h"</span>
<a name="l00073"></a>00073 <span class="preprocessor">#include "synchtimer.h"</span>
<a name="l00074"></a>00074 <span class="preprocessor">#include "messagewin.moc"</span>
<a name="l00075"></a>00075 
<a name="l00076"></a>00076 <span class="keyword">using namespace </span>KCal;
<a name="l00077"></a>00077 
<a name="l00078"></a>00078 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00079"></a>00079 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* KMIX_APP_NAME    = <span class="stringliteral">"kmix"</span>;
<a name="l00080"></a>00080 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* KMIX_DCOP_OBJECT = <span class="stringliteral">"Mixer0"</span>;
<a name="l00081"></a>00081 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* KMIX_DCOP_WINDOW = <span class="stringliteral">"kmix-mainwindow#1"</span>;
<a name="l00082"></a>00082 <span class="preprocessor">#endif</span>
<a name="l00083"></a>00083 <span class="preprocessor"></span><span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* KMAIL_DCOP_OBJECT = <span class="stringliteral">"KMailIface"</span>;
<a name="l00084"></a>00084 
<a name="l00085"></a>00085 <span class="comment">// The delay for enabling message window buttons if a zero delay is</span>
<a name="l00086"></a>00086 <span class="comment">// configured, i.e. the windows are placed far from the cursor.</span>
<a name="l00087"></a>00087 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> proximityButtonDelay = 1000;    <span class="comment">// (milliseconds)</span>
<a name="l00088"></a>00088 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">int</span> proximityMultiple = 10;         <span class="comment">// multiple of button height distance from cursor for proximity</span>
<a name="l00089"></a>00089 
<a name="l00090"></a>00090 <span class="comment">// A text label widget which can be scrolled and copied with the mouse</span>
<a name="l00091"></a>00091 <span class="keyword">class </span>MessageText : <span class="keyword">public</span> QTextEdit
<a name="l00092"></a>00092 {
<a name="l00093"></a>00093     <span class="keyword">public</span>:
<a name="l00094"></a>00094         MessageText(<span class="keyword">const</span> QString&amp; text, <span class="keyword">const</span> QString&amp; context = QString::null, QWidget* parent = 0, <span class="keyword">const</span> <span class="keywordtype">char</span>* name = 0)
<a name="l00095"></a>00095         : QTextEdit(text, context, parent, name)
<a name="l00096"></a>00096         {
<a name="l00097"></a>00097             setReadOnly(<span class="keyword">true</span>);
<a name="l00098"></a>00098             setWordWrap(QTextEdit::NoWrap);
<a name="l00099"></a>00099         }
<a name="l00100"></a>00100         <span class="keywordtype">int</span> scrollBarHeight()<span class="keyword"> const     </span>{ <span class="keywordflow">return</span> horizontalScrollBar()-&gt;height(); }
<a name="l00101"></a>00101         <span class="keywordtype">int</span> scrollBarWidth()<span class="keyword"> const      </span>{ <span class="keywordflow">return</span> verticalScrollBar()-&gt;width(); }
<a name="l00102"></a>00102         <span class="keyword">virtual</span> QSize sizeHint()<span class="keyword"> const  </span>{ <span class="keywordflow">return</span> QSize(contentsWidth() + scrollBarWidth(), contentsHeight() + scrollBarHeight()); }
<a name="l00103"></a>00103 };
<a name="l00104"></a>00104 
<a name="l00105"></a>00105 
<a name="l00106"></a>00106 <span class="keyword">class </span>MWMimeSourceFactory : <span class="keyword">public</span> QMimeSourceFactory
<a name="l00107"></a>00107 {
<a name="l00108"></a>00108     <span class="keyword">public</span>:
<a name="l00109"></a>00109         MWMimeSourceFactory(<span class="keyword">const</span> QString&amp; absPath, KTextBrowser*);
<a name="l00110"></a>00110         <span class="keyword">virtual</span> ~MWMimeSourceFactory();
<a name="l00111"></a>00111         <span class="keyword">virtual</span> <span class="keyword">const</span> QMimeSource* data(<span class="keyword">const</span> QString&amp; abs_name) <span class="keyword">const</span>;
<a name="l00112"></a>00112     <span class="keyword">private</span>:
<a name="l00113"></a>00113         <span class="comment">// Prohibit the following methods</span>
<a name="l00114"></a>00114         <span class="keyword">virtual</span> <span class="keywordtype">void</span> setData(<span class="keyword">const</span> QString&amp;, QMimeSource*) {}
<a name="l00115"></a>00115         <span class="keyword">virtual</span> <span class="keywordtype">void</span> setExtensionType(<span class="keyword">const</span> QString&amp;, <span class="keyword">const</span> <span class="keywordtype">char</span>*) {}
<a name="l00116"></a>00116 
<a name="l00117"></a>00117         QString   mTextFile;
<a name="l00118"></a>00118         QCString  mMimeType;
<a name="l00119"></a>00119         <span class="keyword">mutable</span> <span class="keyword">const</span> QMimeSource* mLast;
<a name="l00120"></a>00120 };
<a name="l00121"></a>00121 
<a name="l00122"></a>00122 
<a name="l00123"></a>00123 <span class="comment">// Basic flags for the window</span>
<a name="l00124"></a>00124 <span class="keyword">static</span> <span class="keyword">const</span> Qt::WFlags WFLAGS = Qt::WStyle_StaysOnTop | Qt::WDestructiveClose;
<a name="l00125"></a>00125 
<a name="l00126"></a>00126 <span class="comment">// Error message bit masks</span>
<a name="l00127"></a>00127 <span class="keyword">enum</span> {
<a name="l00128"></a>00128     ErrMsg_Speak     = 0x01,
<a name="l00129"></a>00129     ErrMsg_AudioFile = 0x02,
<a name="l00130"></a>00130     ErrMsg_Volume    = 0x04
<a name="l00131"></a>00131 };
<a name="l00132"></a>00132 
<a name="l00133"></a>00133 
<a name="l00134"></a>00134 QValueList&lt;MessageWin*&gt; MessageWin::mWindowList;
<a name="l00135"></a>00135 QMap&lt;QString, unsigned&gt; MessageWin::mErrorMessages;
<a name="l00136"></a>00136 
<a name="l00137"></a>00137 
<a name="l00138"></a>00138 <span class="comment">/******************************************************************************</span>
<a name="l00139"></a>00139 <span class="comment">*  Construct the message window for the specified alarm.</span>
<a name="l00140"></a>00140 <span class="comment">*  Other alarms in the supplied event may have been updated by the caller, so</span>
<a name="l00141"></a>00141 <span class="comment">*  the whole event needs to be stored for updating the calendar file when it is</span>
<a name="l00142"></a>00142 <span class="comment">*  displayed.</span>
<a name="l00143"></a>00143 <span class="comment">*/</span>
<a name="l00144"></a>00144 MessageWin::MessageWin(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>&amp; event, <span class="keyword">const</span> KAAlarm&amp; alarm, <span class="keywordtype">bool</span> reschedule_event, <span class="keywordtype">bool</span> allowDefer)
<a name="l00145"></a>00145     : <a class="code" href="classMainWindowBase.html" title="The MainWindowBase class is a base class for KAlarm&amp;#39;s main window and message...">MainWindowBase</a>(0, <span class="stringliteral">"MessageWin"</span>, WFLAGS | Qt::WGroupLeader | Qt::WStyle_ContextHelp
<a name="l00146"></a>00146                                              | (Preferences::modalMessages() ? 0 : Qt::WX11BypassWM)),
<a name="l00147"></a>00147       mMessage(event.cleanText()),
<a name="l00148"></a>00148       mFont(event.font()),
<a name="l00149"></a>00149       mBgColour(event.bgColour()),
<a name="l00150"></a>00150       mFgColour(event.fgColour()),
<a name="l00151"></a>00151       mDateTime((alarm.type() &amp; KAAlarm::REMINDER_ALARM) ? event.mainDateTime(true) : alarm.dateTime(true)),
<a name="l00152"></a>00152       mEventID(event.id()),
<a name="l00153"></a>00153       mAudioFile(event.audioFile()),
<a name="l00154"></a>00154       mVolume(event.soundVolume()),
<a name="l00155"></a>00155       mFadeVolume(event.fadeVolume()),
<a name="l00156"></a>00156       mFadeSeconds(QMIN(event.fadeSeconds(), 86400)),
<a name="l00157"></a>00157       mDefaultDeferMinutes(event.deferDefaultMinutes()),
<a name="l00158"></a>00158       mAlarmType(alarm.type()),
<a name="l00159"></a>00159       mAction(event.action()),
<a name="l00160"></a>00160       mKMailSerialNumber(event.kmailSerialNumber()),
<a name="l00161"></a>00161       mRestoreHeight(0),
<a name="l00162"></a>00162       mAudioRepeat(event.repeatSound()),
<a name="l00163"></a>00163       mConfirmAck(event.confirmAck()),
<a name="l00164"></a>00164       mShowEdit(!mEventID.isEmpty()),
<a name="l00165"></a>00165       mNoDefer(!allowDefer || alarm.repeatAtLogin()),
<a name="l00166"></a>00166       mInvalid(false),
<a name="l00167"></a>00167       mArtsDispatcher(0),
<a name="l00168"></a>00168       mPlayObject(0),
<a name="l00169"></a>00169       mOldVolume(-1),
<a name="l00170"></a>00170       mEvent(event),
<a name="l00171"></a>00171       mEditButton(0),
<a name="l00172"></a>00172       mDeferButton(0),
<a name="l00173"></a>00173       mSilenceButton(0),
<a name="l00174"></a>00174       mDeferDlg(0),
<a name="l00175"></a>00175       mWinModule(0),
<a name="l00176"></a>00176       mFlags(event.flags()),
<a name="l00177"></a>00177       mLateCancel(event.lateCancel()),
<a name="l00178"></a>00178       mErrorWindow(false),
<a name="l00179"></a>00179       mNoPostAction(alarm.type() &amp; KAAlarm::REMINDER_ALARM),
<a name="l00180"></a>00180       mRecreating(false),
<a name="l00181"></a>00181       mBeep(event.beep()),
<a name="l00182"></a>00182       mSpeak(event.speak()),
<a name="l00183"></a>00183       mRescheduleEvent(reschedule_event),
<a name="l00184"></a>00184       mShown(false),
<a name="l00185"></a>00185       mPositioning(false),
<a name="l00186"></a>00186       mNoCloseConfirm(false),
<a name="l00187"></a>00187       mDisableDeferral(false)
<a name="l00188"></a>00188 {
<a name="l00189"></a>00189     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::MessageWin(event)"</span> &lt;&lt; endl;
<a name="l00190"></a>00190     <span class="comment">// Set to save settings automatically, but don't save window size.</span>
<a name="l00191"></a>00191     <span class="comment">// File alarm window size is saved elsewhere.</span>
<a name="l00192"></a>00192     setAutoSaveSettings(QString::fromLatin1(<span class="stringliteral">"MessageWin"</span>), <span class="keyword">false</span>);
<a name="l00193"></a>00193     initView();
<a name="l00194"></a>00194     mWindowList.append(<span class="keyword">this</span>);
<a name="l00195"></a>00195     <span class="keywordflow">if</span> (event.autoClose())
<a name="l00196"></a>00196         mCloseTime = alarm.dateTime().dateTime().addSecs(event.lateCancel() * 60);
<a name="l00197"></a>00197 }
<a name="l00198"></a>00198 
<a name="l00199"></a>00199 <span class="comment">/******************************************************************************</span>
<a name="l00200"></a>00200 <span class="comment">*  Construct the message window for a specified error message.</span>
<a name="l00201"></a>00201 <span class="comment">*/</span>
<a name="l00202"></a>00202 MessageWin::MessageWin(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>&amp; event, <span class="keyword">const</span> DateTime&amp; alarmDateTime, <span class="keyword">const</span> QStringList&amp; errmsgs)
<a name="l00203"></a>00203     : <a class="code" href="classMainWindowBase.html" title="The MainWindowBase class is a base class for KAlarm&amp;#39;s main window and message...">MainWindowBase</a>(0, <span class="stringliteral">"MessageWin"</span>, WFLAGS | Qt::WGroupLeader | Qt::WStyle_ContextHelp),
<a name="l00204"></a>00204       mMessage(event.cleanText()),
<a name="l00205"></a>00205       mDateTime(alarmDateTime),
<a name="l00206"></a>00206       mEventID(event.id()),
<a name="l00207"></a>00207       mAlarmType(KAAlarm::MAIN_ALARM),
<a name="l00208"></a>00208       mAction(event.action()),
<a name="l00209"></a>00209       mKMailSerialNumber(0),
<a name="l00210"></a>00210       mErrorMsgs(errmsgs),
<a name="l00211"></a>00211       mRestoreHeight(0),
<a name="l00212"></a>00212       mConfirmAck(false),
<a name="l00213"></a>00213       mShowEdit(false),
<a name="l00214"></a>00214       mNoDefer(true),
<a name="l00215"></a>00215       mInvalid(false),
<a name="l00216"></a>00216       mArtsDispatcher(0),
<a name="l00217"></a>00217       mPlayObject(0),
<a name="l00218"></a>00218       mEvent(event),
<a name="l00219"></a>00219       mEditButton(0),
<a name="l00220"></a>00220       mDeferButton(0),
<a name="l00221"></a>00221       mSilenceButton(0),
<a name="l00222"></a>00222       mDeferDlg(0),
<a name="l00223"></a>00223       mWinModule(0),
<a name="l00224"></a>00224       mErrorWindow(true),
<a name="l00225"></a>00225       mNoPostAction(true),
<a name="l00226"></a>00226       mRecreating(false),
<a name="l00227"></a>00227       mRescheduleEvent(false),
<a name="l00228"></a>00228       mShown(false),
<a name="l00229"></a>00229       mPositioning(false),
<a name="l00230"></a>00230       mNoCloseConfirm(false),
<a name="l00231"></a>00231       mDisableDeferral(false)
<a name="l00232"></a>00232 {
<a name="l00233"></a>00233     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::MessageWin(errmsg)"</span> &lt;&lt; endl;
<a name="l00234"></a>00234     initView();
<a name="l00235"></a>00235     mWindowList.append(<span class="keyword">this</span>);
<a name="l00236"></a>00236 }
<a name="l00237"></a>00237 
<a name="l00238"></a>00238 <span class="comment">/******************************************************************************</span>
<a name="l00239"></a>00239 <span class="comment">*  Construct the message window for restoration by session management.</span>
<a name="l00240"></a>00240 <span class="comment">*  The window is initialised by readProperties().</span>
<a name="l00241"></a>00241 <span class="comment">*/</span>
<a name="l00242"></a>00242 MessageWin::MessageWin()
<a name="l00243"></a>00243     : <a class="code" href="classMainWindowBase.html" title="The MainWindowBase class is a base class for KAlarm&amp;#39;s main window and message...">MainWindowBase</a>(0, <span class="stringliteral">"MessageWin"</span>, WFLAGS),
<a name="l00244"></a>00244       mArtsDispatcher(0),
<a name="l00245"></a>00245       mPlayObject(0),
<a name="l00246"></a>00246       mEditButton(0),
<a name="l00247"></a>00247       mDeferButton(0),
<a name="l00248"></a>00248       mSilenceButton(0),
<a name="l00249"></a>00249       mDeferDlg(0),
<a name="l00250"></a>00250       mWinModule(0),
<a name="l00251"></a>00251       mErrorWindow(false),
<a name="l00252"></a>00252       mRecreating(false),
<a name="l00253"></a>00253       mRescheduleEvent(false),
<a name="l00254"></a>00254       mShown(false),
<a name="l00255"></a>00255       mPositioning(false),
<a name="l00256"></a>00256       mNoCloseConfirm(false),
<a name="l00257"></a>00257       mDisableDeferral(false)
<a name="l00258"></a>00258 {
<a name="l00259"></a>00259     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::MessageWin(restore)\n"</span>;
<a name="l00260"></a>00260     mWindowList.append(<span class="keyword">this</span>);
<a name="l00261"></a>00261 }
<a name="l00262"></a>00262 
<a name="l00263"></a>00263 <span class="comment">/******************************************************************************</span>
<a name="l00264"></a>00264 <span class="comment">* Destructor. Perform any post-alarm actions before tidying up.</span>
<a name="l00265"></a>00265 <span class="comment">*/</span>
<a name="l00266"></a>00266 MessageWin::~MessageWin()
<a name="l00267"></a>00267 {
<a name="l00268"></a>00268     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::~MessageWin("</span> &lt;&lt; mEventID &lt;&lt; <span class="stringliteral">")"</span> &lt;&lt; endl;
<a name="l00269"></a>00269     stopPlay();
<a name="l00270"></a>00270     <span class="keyword">delete</span> mWinModule;
<a name="l00271"></a>00271     mWinModule = 0;
<a name="l00272"></a>00272     mErrorMessages.remove(mEventID);
<a name="l00273"></a>00273     mWindowList.remove(<span class="keyword">this</span>);
<a name="l00274"></a>00274     <span class="keywordflow">if</span> (!mRecreating)
<a name="l00275"></a>00275     {
<a name="l00276"></a>00276         <span class="keywordflow">if</span> (!mNoPostAction  &amp;&amp;  !mEvent.<a class="code" href="classKAEvent.html#f0193dab34ca0afe70735198b162e290">postAction</a>().isEmpty())
<a name="l00277"></a>00277             theApp()-&gt;alarmCompleted(mEvent);
<a name="l00278"></a>00278         <span class="keywordflow">if</span> (!mWindowList.count())
<a name="l00279"></a>00279             theApp()-&gt;quitIf();
<a name="l00280"></a>00280     }
<a name="l00281"></a>00281 }
<a name="l00282"></a>00282 
<a name="l00283"></a>00283 <span class="comment">/******************************************************************************</span>
<a name="l00284"></a>00284 <span class="comment">*  Construct the message window.</span>
<a name="l00285"></a>00285 <span class="comment">*/</span>
<a name="l00286"></a>00286 <span class="keywordtype">void</span> MessageWin::initView()
<a name="l00287"></a>00287 {
<a name="l00288"></a>00288     <span class="keywordtype">bool</span> reminder = (!mErrorWindow  &amp;&amp;  (mAlarmType &amp; KAAlarm::REMINDER_ALARM));
<a name="l00289"></a>00289     <span class="keywordtype">int</span> leading = fontMetrics().leading();
<a name="l00290"></a>00290     setCaption((mAlarmType &amp; KAAlarm::REMINDER_ALARM) ? i18n(<span class="stringliteral">"Reminder"</span>) : i18n(<span class="stringliteral">"Message"</span>));
<a name="l00291"></a>00291     QWidget* topWidget = <span class="keyword">new</span> QWidget(<span class="keyword">this</span>, <span class="stringliteral">"messageWinTop"</span>);
<a name="l00292"></a>00292     setCentralWidget(topWidget);
<a name="l00293"></a>00293     QVBoxLayout* topLayout = <span class="keyword">new</span> QVBoxLayout(topWidget, KDialog::marginHint(), KDialog::spacingHint());
<a name="l00294"></a>00294 
<a name="l00295"></a>00295     <span class="keywordflow">if</span> (mDateTime.isValid())
<a name="l00296"></a>00296     {
<a name="l00297"></a>00297         <span class="comment">// Show the alarm date/time, together with an "Advance reminder" text where appropriate</span>
<a name="l00298"></a>00298         QFrame* frame = 0;
<a name="l00299"></a>00299         QVBoxLayout* layout = topLayout;
<a name="l00300"></a>00300         <span class="keywordflow">if</span> (reminder)
<a name="l00301"></a>00301         {
<a name="l00302"></a>00302             frame = <span class="keyword">new</span> QFrame(topWidget);
<a name="l00303"></a>00303             frame-&gt;setFrameStyle(QFrame::Box | QFrame::Raised);
<a name="l00304"></a>00304             topLayout-&gt;addWidget(frame, 0, Qt::AlignHCenter);
<a name="l00305"></a>00305             layout = <span class="keyword">new</span> QVBoxLayout(frame, leading + frame-&gt;frameWidth(), leading);
<a name="l00306"></a>00306         }
<a name="l00307"></a>00307 
<a name="l00308"></a>00308         <span class="comment">// Alarm date/time</span>
<a name="l00309"></a>00309         QLabel* label = <span class="keyword">new</span> QLabel(frame ? frame : topWidget);
<a name="l00310"></a>00310         label-&gt;setText(mDateTime.isDateOnly()
<a name="l00311"></a>00311                        ? KGlobal::locale()-&gt;formatDate(mDateTime.date(), <span class="keyword">true</span>)
<a name="l00312"></a>00312                        : KGlobal::locale()-&gt;formatDateTime(mDateTime.dateTime()));
<a name="l00313"></a>00313         <span class="keywordflow">if</span> (!frame)
<a name="l00314"></a>00314             label-&gt;setFrameStyle(QFrame::Box | QFrame::Raised);
<a name="l00315"></a>00315         label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00316"></a>00316         layout-&gt;addWidget(label, 0, Qt::AlignHCenter);
<a name="l00317"></a>00317         QWhatsThis::add(label,
<a name="l00318"></a>00318               i18n(<span class="stringliteral">"The scheduled date/time for the message (as opposed to the actual time of display)."</span>));
<a name="l00319"></a>00319 
<a name="l00320"></a>00320         <span class="keywordflow">if</span> (frame)
<a name="l00321"></a>00321         {
<a name="l00322"></a>00322             label = <span class="keyword">new</span> QLabel(frame);
<a name="l00323"></a>00323             label-&gt;setText(i18n(<span class="stringliteral">"Reminder"</span>));
<a name="l00324"></a>00324             label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00325"></a>00325             layout-&gt;addWidget(label, 0, Qt::AlignHCenter);
<a name="l00326"></a>00326             frame-&gt;setFixedSize(frame-&gt;sizeHint());
<a name="l00327"></a>00327         }
<a name="l00328"></a>00328     }
<a name="l00329"></a>00329 
<a name="l00330"></a>00330     <span class="keywordflow">if</span> (!mErrorWindow)
<a name="l00331"></a>00331     {
<a name="l00332"></a>00332         <span class="comment">// It's a normal alarm message window</span>
<a name="l00333"></a>00333         <span class="keywordflow">switch</span> (mAction)
<a name="l00334"></a>00334         {
<a name="l00335"></a>00335             <span class="keywordflow">case</span> KAEvent::FILE:
<a name="l00336"></a>00336             {
<a name="l00337"></a>00337                 <span class="comment">// Display the file name</span>
<a name="l00338"></a>00338                 QLabel* label = <span class="keyword">new</span> QLabel(mMessage, topWidget);
<a name="l00339"></a>00339                 label-&gt;setFrameStyle(QFrame::Box | QFrame::Raised);
<a name="l00340"></a>00340                 label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00341"></a>00341                 QWhatsThis::add(label, i18n(<span class="stringliteral">"The file whose contents are displayed below"</span>));
<a name="l00342"></a>00342                 topLayout-&gt;addWidget(label, 0, Qt::AlignHCenter);
<a name="l00343"></a>00343 
<a name="l00344"></a>00344                 <span class="comment">// Display contents of file</span>
<a name="l00345"></a>00345                 <span class="keywordtype">bool</span> opened = <span class="keyword">false</span>;
<a name="l00346"></a>00346                 <span class="keywordtype">bool</span> dir = <span class="keyword">false</span>;
<a name="l00347"></a>00347                 QString tmpFile;
<a name="l00348"></a>00348                 KURL url(mMessage);
<a name="l00349"></a>00349                 <span class="keywordflow">if</span> (KIO::NetAccess::download(url, tmpFile, MainWindow::mainMainWindow()))
<a name="l00350"></a>00350                 {
<a name="l00351"></a>00351                     QFile qfile(tmpFile);
<a name="l00352"></a>00352                     QFileInfo info(qfile);
<a name="l00353"></a>00353                     <span class="keywordflow">if</span> (!(dir = info.isDir()))
<a name="l00354"></a>00354                     {
<a name="l00355"></a>00355                         opened = <span class="keyword">true</span>;
<a name="l00356"></a>00356                         KTextBrowser* view = <span class="keyword">new</span> KTextBrowser(topWidget, <span class="stringliteral">"fileContents"</span>);
<a name="l00357"></a>00357                         MWMimeSourceFactory msf(tmpFile, view);
<a name="l00358"></a>00358                         view-&gt;setMinimumSize(view-&gt;sizeHint());
<a name="l00359"></a>00359                         topLayout-&gt;addWidget(view);
<a name="l00360"></a>00360 
<a name="l00361"></a>00361                         <span class="comment">// Set the default size to 20 lines square.</span>
<a name="l00362"></a>00362                         <span class="comment">// Note that after the first file has been displayed, this size</span>
<a name="l00363"></a>00363                         <span class="comment">// is overridden by the user-set default stored in the config file.</span>
<a name="l00364"></a>00364                         <span class="comment">// So there is no need to calculate an accurate size.</span>
<a name="l00365"></a>00365                         <span class="keywordtype">int</span> h = 20*view-&gt;fontMetrics().lineSpacing() + 2*view-&gt;frameWidth();
<a name="l00366"></a>00366                         view-&gt;resize(QSize(h, h).expandedTo(view-&gt;sizeHint()));
<a name="l00367"></a>00367                         QWhatsThis::add(view, i18n(<span class="stringliteral">"The contents of the file to be displayed"</span>));
<a name="l00368"></a>00368                     }
<a name="l00369"></a>00369                     KIO::NetAccess::removeTempFile(tmpFile);
<a name="l00370"></a>00370                 }
<a name="l00371"></a>00371                 <span class="keywordflow">if</span> (!opened)
<a name="l00372"></a>00372                 {
<a name="l00373"></a>00373                     <span class="comment">// File couldn't be opened</span>
<a name="l00374"></a>00374                     <span class="keywordtype">bool</span> exists = KIO::NetAccess::exists(url, <span class="keyword">true</span>, MainWindow::mainMainWindow());
<a name="l00375"></a>00375                     mErrorMsgs += dir ? i18n(<span class="stringliteral">"File is a folder"</span>) : exists ? i18n(<span class="stringliteral">"Failed to open file"</span>) : i18n(<span class="stringliteral">"File not found"</span>);
<a name="l00376"></a>00376                 }
<a name="l00377"></a>00377                 <span class="keywordflow">break</span>;
<a name="l00378"></a>00378             }
<a name="l00379"></a>00379             <span class="keywordflow">case</span> KAEvent::MESSAGE:
<a name="l00380"></a>00380             {
<a name="l00381"></a>00381                 <span class="comment">// Message label</span>
<a name="l00382"></a>00382                 <span class="comment">// Using MessageText instead of QLabel allows scrolling and mouse copying</span>
<a name="l00383"></a>00383                 MessageText* text = <span class="keyword">new</span> MessageText(mMessage, QString::null, topWidget);
<a name="l00384"></a>00384                 text-&gt;setFrameStyle(QFrame::NoFrame);
<a name="l00385"></a>00385                 text-&gt;setPaper(mBgColour);
<a name="l00386"></a>00386                 text-&gt;setPaletteForegroundColor(mFgColour);
<a name="l00387"></a>00387                 text-&gt;setFont(mFont);
<a name="l00388"></a>00388                 <span class="keywordtype">int</span> lineSpacing = text-&gt;fontMetrics().lineSpacing();
<a name="l00389"></a>00389                 QSize s = text-&gt;sizeHint();
<a name="l00390"></a>00390                 <span class="keywordtype">int</span> h = s.height();
<a name="l00391"></a>00391                 text-&gt;setMaximumHeight(h + text-&gt;scrollBarHeight());
<a name="l00392"></a>00392                 text-&gt;setMinimumHeight(QMIN(h, lineSpacing*4));
<a name="l00393"></a>00393                 text-&gt;setMaximumWidth(s.width() + text-&gt;scrollBarWidth());
<a name="l00394"></a>00394                 QWhatsThis::add(text, i18n(<span class="stringliteral">"The alarm message"</span>));
<a name="l00395"></a>00395                 <span class="keywordtype">int</span> vspace = lineSpacing/2;
<a name="l00396"></a>00396                 <span class="keywordtype">int</span> hspace = lineSpacing - KDialog::marginHint();
<a name="l00397"></a>00397                 topLayout-&gt;addSpacing(vspace);
<a name="l00398"></a>00398                 topLayout-&gt;addStretch();
<a name="l00399"></a>00399                 <span class="comment">// Don't include any horizontal margins if message is 2/3 screen width</span>
<a name="l00400"></a>00400                 <span class="keywordflow">if</span> (!mWinModule)
<a name="l00401"></a>00401                     mWinModule = <span class="keyword">new</span> KWinModule(0, KWinModule::INFO_DESKTOP);
<a name="l00402"></a>00402                 <span class="keywordflow">if</span> (text-&gt;sizeHint().width() &gt;= mWinModule-&gt;workArea().width()*2/3)
<a name="l00403"></a>00403                     topLayout-&gt;addWidget(text, 1, Qt::AlignHCenter);
<a name="l00404"></a>00404                 <span class="keywordflow">else</span>
<a name="l00405"></a>00405                 {
<a name="l00406"></a>00406                     QBoxLayout* layout = <span class="keyword">new</span> QHBoxLayout(topLayout);
<a name="l00407"></a>00407                     layout-&gt;addSpacing(hspace);
<a name="l00408"></a>00408                     layout-&gt;addWidget(text, 1, Qt::AlignHCenter);
<a name="l00409"></a>00409                     layout-&gt;addSpacing(hspace);
<a name="l00410"></a>00410                 }
<a name="l00411"></a>00411                 <span class="keywordflow">if</span> (!reminder)
<a name="l00412"></a>00412                     topLayout-&gt;addStretch();
<a name="l00413"></a>00413                 <span class="keywordflow">break</span>;
<a name="l00414"></a>00414             }
<a name="l00415"></a>00415             <span class="keywordflow">case</span> KAEvent::COMMAND:
<a name="l00416"></a>00416             <span class="keywordflow">case</span> KAEvent::EMAIL:
<a name="l00417"></a>00417             <span class="keywordflow">default</span>:
<a name="l00418"></a>00418                 <span class="keywordflow">break</span>;
<a name="l00419"></a>00419         }
<a name="l00420"></a>00420 
<a name="l00421"></a>00421         <span class="keywordflow">if</span> (reminder)
<a name="l00422"></a>00422         {
<a name="l00423"></a>00423             <span class="comment">// Reminder: show remaining time until the actual alarm</span>
<a name="l00424"></a>00424             mRemainingText = <span class="keyword">new</span> QLabel(topWidget);
<a name="l00425"></a>00425             mRemainingText-&gt;setFrameStyle(QFrame::Box | QFrame::Raised);
<a name="l00426"></a>00426             mRemainingText-&gt;setMargin(leading);
<a name="l00427"></a>00427             <span class="keywordflow">if</span> (mDateTime.isDateOnly()  ||  QDate::currentDate().daysTo(mDateTime.date()) &gt; 0)
<a name="l00428"></a>00428             {
<a name="l00429"></a>00429                 setRemainingTextDay();
<a name="l00430"></a>00430                 MidnightTimer::connect(<span class="keyword">this</span>, SLOT(setRemainingTextDay()));    <span class="comment">// update every day</span>
<a name="l00431"></a>00431             }
<a name="l00432"></a>00432             <span class="keywordflow">else</span>
<a name="l00433"></a>00433             {
<a name="l00434"></a>00434                 setRemainingTextMinute();
<a name="l00435"></a>00435                 MinuteTimer::connect(<span class="keyword">this</span>, SLOT(setRemainingTextMinute()));   <span class="comment">// update every minute</span>
<a name="l00436"></a>00436             }
<a name="l00437"></a>00437             topLayout-&gt;addWidget(mRemainingText, 0, Qt::AlignHCenter);
<a name="l00438"></a>00438             topLayout-&gt;addSpacing(KDialog::spacingHint());
<a name="l00439"></a>00439             topLayout-&gt;addStretch();
<a name="l00440"></a>00440         }
<a name="l00441"></a>00441     }
<a name="l00442"></a>00442     <span class="keywordflow">else</span>
<a name="l00443"></a>00443     {
<a name="l00444"></a>00444         <span class="comment">// It's an error message</span>
<a name="l00445"></a>00445         <span class="keywordflow">switch</span> (mAction)
<a name="l00446"></a>00446         {
<a name="l00447"></a>00447             <span class="keywordflow">case</span> KAEvent::EMAIL:
<a name="l00448"></a>00448             {
<a name="l00449"></a>00449                 <span class="comment">// Display the email addresses and subject.</span>
<a name="l00450"></a>00450                 QFrame* frame = <span class="keyword">new</span> QFrame(topWidget);
<a name="l00451"></a>00451                 frame-&gt;setFrameStyle(QFrame::Box | QFrame::Raised);
<a name="l00452"></a>00452                 QWhatsThis::add(frame, i18n(<span class="stringliteral">"The email to send"</span>));
<a name="l00453"></a>00453                 topLayout-&gt;addWidget(frame, 0, Qt::AlignHCenter);
<a name="l00454"></a>00454                 QGridLayout* grid = <span class="keyword">new</span> QGridLayout(frame, 2, 2, KDialog::marginHint(), KDialog::spacingHint());
<a name="l00455"></a>00455 
<a name="l00456"></a>00456                 QLabel* label = <span class="keyword">new</span> QLabel(i18n(<span class="stringliteral">"Email addressee"</span>, <span class="stringliteral">"To:"</span>), frame);
<a name="l00457"></a>00457                 label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00458"></a>00458                 grid-&gt;addWidget(label, 0, 0, Qt::AlignLeft);
<a name="l00459"></a>00459                 label = <span class="keyword">new</span> QLabel(mEvent.emailAddresses(<span class="stringliteral">"\n"</span>), frame);
<a name="l00460"></a>00460                 label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00461"></a>00461                 grid-&gt;addWidget(label, 0, 1, Qt::AlignLeft);
<a name="l00462"></a>00462 
<a name="l00463"></a>00463                 label = <span class="keyword">new</span> QLabel(i18n(<span class="stringliteral">"Email subject"</span>, <span class="stringliteral">"Subject:"</span>), frame);
<a name="l00464"></a>00464                 label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00465"></a>00465                 grid-&gt;addWidget(label, 1, 0, Qt::AlignLeft);
<a name="l00466"></a>00466                 label = <span class="keyword">new</span> QLabel(mEvent.emailSubject(), frame);
<a name="l00467"></a>00467                 label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00468"></a>00468                 grid-&gt;addWidget(label, 1, 1, Qt::AlignLeft);
<a name="l00469"></a>00469                 <span class="keywordflow">break</span>;
<a name="l00470"></a>00470             }
<a name="l00471"></a>00471             <span class="keywordflow">case</span> KAEvent::COMMAND:
<a name="l00472"></a>00472             <span class="keywordflow">case</span> KAEvent::FILE:
<a name="l00473"></a>00473             <span class="keywordflow">case</span> KAEvent::MESSAGE:
<a name="l00474"></a>00474             <span class="keywordflow">default</span>:
<a name="l00475"></a>00475                 <span class="comment">// Just display the error message strings</span>
<a name="l00476"></a>00476                 <span class="keywordflow">break</span>;
<a name="l00477"></a>00477         }
<a name="l00478"></a>00478     }
<a name="l00479"></a>00479 
<a name="l00480"></a>00480     <span class="keywordflow">if</span> (!mErrorMsgs.count())
<a name="l00481"></a>00481         topWidget-&gt;setBackgroundColor(mBgColour);
<a name="l00482"></a>00482     <span class="keywordflow">else</span>
<a name="l00483"></a>00483     {
<a name="l00484"></a>00484         setCaption(i18n(<span class="stringliteral">"Error"</span>));
<a name="l00485"></a>00485         QBoxLayout* layout = <span class="keyword">new</span> QHBoxLayout(topLayout);
<a name="l00486"></a>00486         layout-&gt;setMargin(2*KDialog::marginHint());
<a name="l00487"></a>00487         layout-&gt;addStretch();
<a name="l00488"></a>00488         QLabel* label = <span class="keyword">new</span> QLabel(topWidget);
<a name="l00489"></a>00489         label-&gt;setPixmap(DesktopIcon(<span class="stringliteral">"error"</span>));
<a name="l00490"></a>00490         label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00491"></a>00491         layout-&gt;addWidget(label, 0, Qt::AlignRight);
<a name="l00492"></a>00492         QBoxLayout* vlayout = <span class="keyword">new</span> QVBoxLayout(layout);
<a name="l00493"></a>00493         <span class="keywordflow">for</span> (QStringList::Iterator it = mErrorMsgs.begin();  it != mErrorMsgs.end();  ++it)
<a name="l00494"></a>00494         {
<a name="l00495"></a>00495             label = <span class="keyword">new</span> QLabel(*it, topWidget);
<a name="l00496"></a>00496             label-&gt;setFixedSize(label-&gt;sizeHint());
<a name="l00497"></a>00497             vlayout-&gt;addWidget(label, 0, Qt::AlignLeft);
<a name="l00498"></a>00498         }
<a name="l00499"></a>00499         layout-&gt;addStretch();
<a name="l00500"></a>00500     }
<a name="l00501"></a>00501 
<a name="l00502"></a>00502     QGridLayout* grid = <span class="keyword">new</span> QGridLayout(1, 4);
<a name="l00503"></a>00503     topLayout-&gt;addLayout(grid);
<a name="l00504"></a>00504     grid-&gt;setColStretch(0, 1);     <span class="comment">// keep the buttons right-adjusted in the window</span>
<a name="l00505"></a>00505     <span class="keywordtype">int</span> gridIndex = 1;
<a name="l00506"></a>00506 
<a name="l00507"></a>00507     <span class="comment">// Close button</span>
<a name="l00508"></a>00508     mOkButton = <span class="keyword">new</span> KPushButton(KStdGuiItem::close(), topWidget);
<a name="l00509"></a>00509     <span class="comment">// Prevent accidental acknowledgement of the message if the user is typing when the window appears</span>
<a name="l00510"></a>00510     mOkButton-&gt;clearFocus();
<a name="l00511"></a>00511     mOkButton-&gt;setFocusPolicy(QWidget::ClickFocus);    <span class="comment">// don't allow keyboard selection</span>
<a name="l00512"></a>00512     mOkButton-&gt;setFixedSize(mOkButton-&gt;sizeHint());
<a name="l00513"></a>00513     connect(mOkButton, SIGNAL(clicked()), SLOT(close()));
<a name="l00514"></a>00514     grid-&gt;addWidget(mOkButton, 0, gridIndex++, AlignHCenter);
<a name="l00515"></a>00515     QWhatsThis::add(mOkButton, i18n(<span class="stringliteral">"Acknowledge the alarm"</span>));
<a name="l00516"></a>00516 
<a name="l00517"></a>00517     <span class="keywordflow">if</span> (mShowEdit)
<a name="l00518"></a>00518     {
<a name="l00519"></a>00519         <span class="comment">// Edit button</span>
<a name="l00520"></a>00520         mEditButton = <span class="keyword">new</span> QPushButton(i18n(<span class="stringliteral">"&amp;Edit..."</span>), topWidget);
<a name="l00521"></a>00521         mEditButton-&gt;setFocusPolicy(QWidget::ClickFocus);    <span class="comment">// don't allow keyboard selection</span>
<a name="l00522"></a>00522         mEditButton-&gt;setFixedSize(mEditButton-&gt;sizeHint());
<a name="l00523"></a>00523         connect(mEditButton, SIGNAL(clicked()), SLOT(slotEdit()));
<a name="l00524"></a>00524         grid-&gt;addWidget(mEditButton, 0, gridIndex++, AlignHCenter);
<a name="l00525"></a>00525         QWhatsThis::add(mEditButton, i18n(<span class="stringliteral">"Edit the alarm."</span>));
<a name="l00526"></a>00526     }
<a name="l00527"></a>00527 
<a name="l00528"></a>00528     <span class="keywordflow">if</span> (!mNoDefer)
<a name="l00529"></a>00529     {
<a name="l00530"></a>00530         <span class="comment">// Defer button</span>
<a name="l00531"></a>00531         mDeferButton = <span class="keyword">new</span> QPushButton(i18n(<span class="stringliteral">"&amp;Defer..."</span>), topWidget);
<a name="l00532"></a>00532         mDeferButton-&gt;setFocusPolicy(QWidget::ClickFocus);    <span class="comment">// don't allow keyboard selection</span>
<a name="l00533"></a>00533         mDeferButton-&gt;setFixedSize(mDeferButton-&gt;sizeHint());
<a name="l00534"></a>00534         connect(mDeferButton, SIGNAL(clicked()), SLOT(slotDefer()));
<a name="l00535"></a>00535         grid-&gt;addWidget(mDeferButton, 0, gridIndex++, AlignHCenter);
<a name="l00536"></a>00536         QWhatsThis::add(mDeferButton,
<a name="l00537"></a>00537               i18n(<span class="stringliteral">"Defer the alarm until later.\n"</span>
<a name="l00538"></a>00538                    <span class="stringliteral">"You will be prompted to specify when the alarm should be redisplayed."</span>));
<a name="l00539"></a>00539 
<a name="l00540"></a>00540         setDeferralLimit(mEvent);    <span class="comment">// ensure that button is disabled when alarm can't be deferred any more</span>
<a name="l00541"></a>00541     }
<a name="l00542"></a>00542 
<a name="l00543"></a>00543 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00544"></a>00544 <span class="preprocessor"></span>    <span class="keywordflow">if</span> (!mAudioFile.isEmpty()  &amp;&amp;  (mVolume || mFadeVolume &gt; 0))
<a name="l00545"></a>00545     {
<a name="l00546"></a>00546         <span class="comment">// Silence button to stop sound repetition</span>
<a name="l00547"></a>00547         QPixmap pixmap = MainBarIcon(<span class="stringliteral">"player_stop"</span>);
<a name="l00548"></a>00548         mSilenceButton = <span class="keyword">new</span> QPushButton(topWidget);
<a name="l00549"></a>00549         mSilenceButton-&gt;setPixmap(pixmap);
<a name="l00550"></a>00550         mSilenceButton-&gt;setFixedSize(mSilenceButton-&gt;sizeHint());
<a name="l00551"></a>00551         connect(mSilenceButton, SIGNAL(clicked()), SLOT(stopPlay()));
<a name="l00552"></a>00552         grid-&gt;addWidget(mSilenceButton, 0, gridIndex++, AlignHCenter);
<a name="l00553"></a>00553         QToolTip::add(mSilenceButton, i18n(<span class="stringliteral">"Stop sound"</span>));
<a name="l00554"></a>00554         QWhatsThis::add(mSilenceButton, i18n(<span class="stringliteral">"Stop playing the sound"</span>));
<a name="l00555"></a>00555         <span class="comment">// To avoid getting in a mess, disable the button until sound playing has been set up</span>
<a name="l00556"></a>00556         mSilenceButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l00557"></a>00557     }
<a name="l00558"></a>00558 <span class="preprocessor">#endif</span>
<a name="l00559"></a>00559 <span class="preprocessor"></span>
<a name="l00560"></a>00560     KIconLoader iconLoader;
<a name="l00561"></a>00561     <span class="keywordflow">if</span> (mKMailSerialNumber)
<a name="l00562"></a>00562     {
<a name="l00563"></a>00563         <span class="comment">// KMail button</span>
<a name="l00564"></a>00564         QPixmap pixmap = iconLoader.loadIcon(QString::fromLatin1(<span class="stringliteral">"kmail"</span>), KIcon::MainToolbar);
<a name="l00565"></a>00565         mKMailButton = <span class="keyword">new</span> QPushButton(topWidget);
<a name="l00566"></a>00566         mKMailButton-&gt;setPixmap(pixmap);
<a name="l00567"></a>00567         mKMailButton-&gt;setFixedSize(mKMailButton-&gt;sizeHint());
<a name="l00568"></a>00568         connect(mKMailButton, SIGNAL(clicked()), SLOT(slotShowKMailMessage()));
<a name="l00569"></a>00569         grid-&gt;addWidget(mKMailButton, 0, gridIndex++, AlignHCenter);
<a name="l00570"></a>00570         QToolTip::add(mKMailButton, i18n(<span class="stringliteral">"Locate this email in KMail"</span>, <span class="stringliteral">"Locate in KMail"</span>));
<a name="l00571"></a>00571         QWhatsThis::add(mKMailButton, i18n(<span class="stringliteral">"Locate and highlight this email in KMail"</span>));
<a name="l00572"></a>00572     }
<a name="l00573"></a>00573     <span class="keywordflow">else</span>
<a name="l00574"></a>00574         mKMailButton = 0;
<a name="l00575"></a>00575 
<a name="l00576"></a>00576     <span class="comment">// KAlarm button</span>
<a name="l00577"></a>00577     QPixmap pixmap = iconLoader.loadIcon(QString::fromLatin1(kapp-&gt;aboutData()-&gt;appName()), KIcon::MainToolbar);
<a name="l00578"></a>00578     mKAlarmButton = <span class="keyword">new</span> QPushButton(topWidget);
<a name="l00579"></a>00579     mKAlarmButton-&gt;setPixmap(pixmap);
<a name="l00580"></a>00580     mKAlarmButton-&gt;setFixedSize(mKAlarmButton-&gt;sizeHint());
<a name="l00581"></a>00581     connect(mKAlarmButton, SIGNAL(clicked()), SLOT(displayMainWindow()));
<a name="l00582"></a>00582     grid-&gt;addWidget(mKAlarmButton, 0, gridIndex++, AlignHCenter);
<a name="l00583"></a>00583     QString actKAlarm = i18n(<span class="stringliteral">"Activate KAlarm"</span>);
<a name="l00584"></a>00584     QToolTip::add(mKAlarmButton, actKAlarm);
<a name="l00585"></a>00585     QWhatsThis::add(mKAlarmButton, actKAlarm);
<a name="l00586"></a>00586 
<a name="l00587"></a>00587     <span class="comment">// Disable all buttons initially, to prevent accidental clicking on if they happen to be</span>
<a name="l00588"></a>00588     <span class="comment">// under the mouse just as the window appears.</span>
<a name="l00589"></a>00589     mOkButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l00590"></a>00590     <span class="keywordflow">if</span> (mDeferButton)
<a name="l00591"></a>00591         mDeferButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l00592"></a>00592     <span class="keywordflow">if</span> (mEditButton)
<a name="l00593"></a>00593         mEditButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l00594"></a>00594     <span class="keywordflow">if</span> (mKMailButton)
<a name="l00595"></a>00595         mKMailButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l00596"></a>00596     mKAlarmButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l00597"></a>00597 
<a name="l00598"></a>00598     topLayout-&gt;activate();
<a name="l00599"></a>00599     setMinimumSize(QSize(grid-&gt;sizeHint().width() + 2*KDialog::marginHint(), sizeHint().height()));
<a name="l00600"></a>00600 
<a name="l00601"></a>00601     WId winid = winId();
<a name="l00602"></a>00602     <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> wstate = (Preferences::modalMessages() ? NET::Modal : 0) | NET::Sticky | NET::StaysOnTop;
<a name="l00603"></a>00603     KWin::setState(winid, wstate);
<a name="l00604"></a>00604     KWin::setOnAllDesktops(winid, <span class="keyword">true</span>);
<a name="l00605"></a>00605 }
<a name="l00606"></a>00606 
<a name="l00607"></a>00607 <span class="comment">/******************************************************************************</span>
<a name="l00608"></a>00608 <span class="comment">* Set the remaining time text in a reminder window.</span>
<a name="l00609"></a>00609 <span class="comment">* Called at the start of every day (at the user-defined start-of-day time).</span>
<a name="l00610"></a>00610 <span class="comment">*/</span>
<a name="l00611"></a>00611 <span class="keywordtype">void</span> MessageWin::setRemainingTextDay()
<a name="l00612"></a>00612 {
<a name="l00613"></a>00613     QString text;
<a name="l00614"></a>00614     <span class="keywordtype">int</span> days = QDate::currentDate().daysTo(mDateTime.date());
<a name="l00615"></a>00615     <span class="keywordflow">if</span> (days &lt;= 0  &amp;&amp;  !mDateTime.isDateOnly())
<a name="l00616"></a>00616     {
<a name="l00617"></a>00617         <span class="comment">// The alarm is due today, so start refreshing every minute</span>
<a name="l00618"></a>00618         MidnightTimer::disconnect(<span class="keyword">this</span>, SLOT(setRemainingTextDay()));
<a name="l00619"></a>00619         setRemainingTextMinute();
<a name="l00620"></a>00620         MinuteTimer::connect(<span class="keyword">this</span>, SLOT(setRemainingTextMinute()));   <span class="comment">// update every minute</span>
<a name="l00621"></a>00621     }
<a name="l00622"></a>00622     <span class="keywordflow">else</span>
<a name="l00623"></a>00623     {
<a name="l00624"></a>00624         <span class="keywordflow">if</span> (days &lt;= 0)
<a name="l00625"></a>00625             text = i18n(<span class="stringliteral">"Today"</span>);
<a name="l00626"></a>00626         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (days % 7)
<a name="l00627"></a>00627             text = i18n(<span class="stringliteral">"Tomorrow"</span>, <span class="stringliteral">"in %n days' time"</span>, days);
<a name="l00628"></a>00628         <span class="keywordflow">else</span>
<a name="l00629"></a>00629             text = i18n(<span class="stringliteral">"in 1 week's time"</span>, <span class="stringliteral">"in %n weeks' time"</span>, days/7);
<a name="l00630"></a>00630     }
<a name="l00631"></a>00631     mRemainingText-&gt;setText(text);
<a name="l00632"></a>00632 }
<a name="l00633"></a>00633 
<a name="l00634"></a>00634 <span class="comment">/******************************************************************************</span>
<a name="l00635"></a>00635 <span class="comment">* Set the remaining time text in a reminder window.</span>
<a name="l00636"></a>00636 <span class="comment">* Called on every minute boundary.</span>
<a name="l00637"></a>00637 <span class="comment">*/</span>
<a name="l00638"></a>00638 <span class="keywordtype">void</span> MessageWin::setRemainingTextMinute()
<a name="l00639"></a>00639 {
<a name="l00640"></a>00640     QString text;
<a name="l00641"></a>00641     <span class="keywordtype">int</span> mins = (QDateTime::currentDateTime().secsTo(mDateTime.dateTime()) + 59) / 60;
<a name="l00642"></a>00642     <span class="keywordflow">if</span> (mins &lt; 60)
<a name="l00643"></a>00643         text = i18n(<span class="stringliteral">"in 1 minute's time"</span>, <span class="stringliteral">"in %n minutes' time"</span>, (mins &gt; 0 ? mins : 0));
<a name="l00644"></a>00644     <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mins % 60 == 0)
<a name="l00645"></a>00645         text = i18n(<span class="stringliteral">"in 1 hour's time"</span>, <span class="stringliteral">"in %n hours' time"</span>, mins/60);
<a name="l00646"></a>00646     <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mins % 60 == 1)
<a name="l00647"></a>00647         text = i18n(<span class="stringliteral">"in 1 hour 1 minute's time"</span>, <span class="stringliteral">"in %n hours 1 minute's time"</span>, mins/60);
<a name="l00648"></a>00648     <span class="keywordflow">else</span>
<a name="l00649"></a>00649         text = i18n(<span class="stringliteral">"in 1 hour %1 minutes' time"</span>, <span class="stringliteral">"in %n hours %1 minutes' time"</span>, mins/60).arg(mins%60);
<a name="l00650"></a>00650     mRemainingText-&gt;setText(text);
<a name="l00651"></a>00651 }
<a name="l00652"></a>00652 
<a name="l00653"></a>00653 <span class="comment">/******************************************************************************</span>
<a name="l00654"></a>00654 <span class="comment">* Save settings to the session managed config file, for restoration</span>
<a name="l00655"></a>00655 <span class="comment">* when the program is restored.</span>
<a name="l00656"></a>00656 <span class="comment">*/</span>
<a name="l00657"></a>00657 <span class="keywordtype">void</span> MessageWin::saveProperties(KConfig* config)
<a name="l00658"></a>00658 {
<a name="l00659"></a>00659     <span class="keywordflow">if</span> (mShown  &amp;&amp;  !mErrorWindow)
<a name="l00660"></a>00660     {
<a name="l00661"></a>00661         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"EventID"</span>), mEventID);
<a name="l00662"></a>00662         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"AlarmType"</span>), mAlarmType);
<a name="l00663"></a>00663         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Message"</span>), mMessage);
<a name="l00664"></a>00664         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Type"</span>), mAction);
<a name="l00665"></a>00665         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Font"</span>), mFont);
<a name="l00666"></a>00666         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"BgColour"</span>), mBgColour);
<a name="l00667"></a>00667         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"FgColour"</span>), mFgColour);
<a name="l00668"></a>00668         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"ConfirmAck"</span>), mConfirmAck);
<a name="l00669"></a>00669         <span class="keywordflow">if</span> (mDateTime.isValid())
<a name="l00670"></a>00670         {
<a name="l00671"></a>00671             config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Time"</span>), mDateTime.dateTime());
<a name="l00672"></a>00672             config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"DateOnly"</span>), mDateTime.isDateOnly());
<a name="l00673"></a>00673         }
<a name="l00674"></a>00674         <span class="keywordflow">if</span> (mCloseTime.isValid())
<a name="l00675"></a>00675             config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Expiry"</span>), mCloseTime);
<a name="l00676"></a>00676 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00677"></a>00677 <span class="preprocessor"></span>        <span class="keywordflow">if</span> (mAudioRepeat  &amp;&amp;  mSilenceButton  &amp;&amp;  mSilenceButton-&gt;isEnabled())
<a name="l00678"></a>00678         {
<a name="l00679"></a>00679             <span class="comment">// Only need to restart sound file playing if it's being repeated</span>
<a name="l00680"></a>00680             config-&gt;writePathEntry(QString::fromLatin1(<span class="stringliteral">"AudioFile"</span>), mAudioFile);
<a name="l00681"></a>00681             config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Volume"</span>), static_cast&lt;int&gt;(mVolume * 100));
<a name="l00682"></a>00682         }
<a name="l00683"></a>00683 <span class="preprocessor">#endif</span>
<a name="l00684"></a>00684 <span class="preprocessor"></span>        config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Speak"</span>), mSpeak);
<a name="l00685"></a>00685         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Height"</span>), height());
<a name="l00686"></a>00686         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"DeferMins"</span>), mDefaultDeferMinutes);
<a name="l00687"></a>00687         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"NoDefer"</span>), mNoDefer);
<a name="l00688"></a>00688         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"NoPostAction"</span>), mNoPostAction);
<a name="l00689"></a>00689         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"KMailSerial"</span>), mKMailSerialNumber);
<a name="l00690"></a>00690     }
<a name="l00691"></a>00691     <span class="keywordflow">else</span>
<a name="l00692"></a>00692         config-&gt;writeEntry(QString::fromLatin1(<span class="stringliteral">"Invalid"</span>), <span class="keyword">true</span>);
<a name="l00693"></a>00693 }
<a name="l00694"></a>00694 
<a name="l00695"></a>00695 <span class="comment">/******************************************************************************</span>
<a name="l00696"></a>00696 <span class="comment">* Read settings from the session managed config file.</span>
<a name="l00697"></a>00697 <span class="comment">* This function is automatically called whenever the app is being restored.</span>
<a name="l00698"></a>00698 <span class="comment">* Read in whatever was saved in saveProperties().</span>
<a name="l00699"></a>00699 <span class="comment">*/</span>
<a name="l00700"></a>00700 <span class="keywordtype">void</span> MessageWin::readProperties(KConfig* config)
<a name="l00701"></a>00701 {
<a name="l00702"></a>00702     mInvalid             = config-&gt;readBoolEntry(QString::fromLatin1(<span class="stringliteral">"Invalid"</span>), <span class="keyword">false</span>);
<a name="l00703"></a>00703     mEventID             = config-&gt;readEntry(QString::fromLatin1(<span class="stringliteral">"EventID"</span>));
<a name="l00704"></a>00704     mAlarmType           = KAAlarm::Type(config-&gt;readNumEntry(QString::fromLatin1(<span class="stringliteral">"AlarmType"</span>)));
<a name="l00705"></a>00705     mMessage             = config-&gt;readEntry(QString::fromLatin1(<span class="stringliteral">"Message"</span>));
<a name="l00706"></a>00706     mAction              = KAEvent::Action(config-&gt;readNumEntry(QString::fromLatin1(<span class="stringliteral">"Type"</span>)));
<a name="l00707"></a>00707     mFont                = config-&gt;readFontEntry(QString::fromLatin1(<span class="stringliteral">"Font"</span>));
<a name="l00708"></a>00708     mBgColour            = config-&gt;readColorEntry(QString::fromLatin1(<span class="stringliteral">"BgColour"</span>));
<a name="l00709"></a>00709     mFgColour            = config-&gt;readColorEntry(QString::fromLatin1(<span class="stringliteral">"FgColour"</span>));
<a name="l00710"></a>00710     mConfirmAck          = config-&gt;readBoolEntry(QString::fromLatin1(<span class="stringliteral">"ConfirmAck"</span>));
<a name="l00711"></a>00711     QDateTime invalidDateTime;
<a name="l00712"></a>00712     QDateTime dt         = config-&gt;readDateTimeEntry(QString::fromLatin1(<span class="stringliteral">"Time"</span>), &amp;invalidDateTime);
<a name="l00713"></a>00713     <span class="keywordtype">bool</span> dateOnly        = config-&gt;readBoolEntry(QString::fromLatin1(<span class="stringliteral">"DateOnly"</span>));
<a name="l00714"></a>00714     mDateTime.set(dt, dateOnly);
<a name="l00715"></a>00715     mCloseTime           = config-&gt;readDateTimeEntry(QString::fromLatin1(<span class="stringliteral">"Expiry"</span>), &amp;invalidDateTime);
<a name="l00716"></a>00716 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00717"></a>00717 <span class="preprocessor"></span>    mAudioFile           = config-&gt;readPathEntry(QString::fromLatin1(<span class="stringliteral">"AudioFile"</span>));
<a name="l00718"></a>00718     mVolume              = <span class="keyword">static_cast&lt;</span><span class="keywordtype">float</span><span class="keyword">&gt;</span>(config-&gt;readNumEntry(QString::fromLatin1(<span class="stringliteral">"Volume"</span>))) / 100;
<a name="l00719"></a>00719     mFadeVolume          = -1;
<a name="l00720"></a>00720     mFadeSeconds         = 0;
<a name="l00721"></a>00721     <span class="keywordflow">if</span> (!mAudioFile.isEmpty())
<a name="l00722"></a>00722         mAudioRepeat = <span class="keyword">true</span>;
<a name="l00723"></a>00723 <span class="preprocessor">#endif</span>
<a name="l00724"></a>00724 <span class="preprocessor"></span>    mSpeak               = config-&gt;readBoolEntry(QString::fromLatin1(<span class="stringliteral">"Speak"</span>));
<a name="l00725"></a>00725     mRestoreHeight       = config-&gt;readNumEntry(QString::fromLatin1(<span class="stringliteral">"Height"</span>));
<a name="l00726"></a>00726     mDefaultDeferMinutes = config-&gt;readNumEntry(QString::fromLatin1(<span class="stringliteral">"DeferMins"</span>));
<a name="l00727"></a>00727     mNoDefer             = config-&gt;readBoolEntry(QString::fromLatin1(<span class="stringliteral">"NoDefer"</span>));
<a name="l00728"></a>00728     mNoPostAction        = config-&gt;readBoolEntry(QString::fromLatin1(<span class="stringliteral">"NoPostAction"</span>));
<a name="l00729"></a>00729     mKMailSerialNumber   = config-&gt;readUnsignedLongNumEntry(QString::fromLatin1(<span class="stringliteral">"KMailSerial"</span>));
<a name="l00730"></a>00730     mShowEdit            = <span class="keyword">false</span>;
<a name="l00731"></a>00731     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::readProperties("</span> &lt;&lt; mEventID &lt;&lt; <span class="stringliteral">")"</span> &lt;&lt; endl;
<a name="l00732"></a>00732     <span class="keywordflow">if</span> (mAlarmType != KAAlarm::INVALID_ALARM)
<a name="l00733"></a>00733     {
<a name="l00734"></a>00734         <span class="comment">// Recreate the event from the calendar file (if possible)</span>
<a name="l00735"></a>00735         <span class="keywordflow">if</span> (!mEventID.isEmpty())
<a name="l00736"></a>00736         {
<a name="l00737"></a>00737             <span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* kcalEvent = AlarmCalendar::activeCalendar()-&gt;<a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(mEventID);
<a name="l00738"></a>00738             <span class="keywordflow">if</span> (!kcalEvent)
<a name="l00739"></a>00739             {
<a name="l00740"></a>00740                 <span class="comment">// It's not in the active calendar, so try the displaying calendar</span>
<a name="l00741"></a>00741                 <a class="code" href="classAlarmCalendar.html" title="Provides read and write access to calendar files.">AlarmCalendar</a>* cal = AlarmCalendar::displayCalendar();
<a name="l00742"></a>00742                 <span class="keywordflow">if</span> (cal-&gt;<a class="code" href="classAlarmCalendar.html#021bd79d94b5f0f5d26af2ab15a11776">isOpen</a>())
<a name="l00743"></a>00743                     kcalEvent = cal-&gt;<a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(KAEvent::uid(mEventID, KAEvent::DISPLAYING));
<a name="l00744"></a>00744             }
<a name="l00745"></a>00745             <span class="keywordflow">if</span> (kcalEvent)
<a name="l00746"></a>00746             {
<a name="l00747"></a>00747                 mEvent.<a class="code" href="classKAEvent.html#4c15fa1902de9f954d965aba07acf7f2">set</a>(*kcalEvent);
<a name="l00748"></a>00748                 mEvent.<a class="code" href="classKAEvent.html#c2cbfef7acbbc23217f35dd61b0c1cf8">setUid</a>(KAEvent::ACTIVE);    <span class="comment">// in case it came from the display calendar</span>
<a name="l00749"></a>00749                 mShowEdit = <span class="keyword">true</span>;
<a name="l00750"></a>00750             }
<a name="l00751"></a>00751         }
<a name="l00752"></a>00752         initView();
<a name="l00753"></a>00753     }
<a name="l00754"></a>00754 }
<a name="l00755"></a>00755 
<a name="l00756"></a>00756 <span class="comment">/******************************************************************************</span>
<a name="l00757"></a>00757 <span class="comment">*  Returns the existing message window (if any) which is displaying the event</span>
<a name="l00758"></a>00758 <span class="comment">*  with the specified ID.</span>
<a name="l00759"></a>00759 <span class="comment">*/</span>
<a name="l00760"></a>00760 <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>* MessageWin::findEvent(<span class="keyword">const</span> QString&amp; eventID)
<a name="l00761"></a>00761 {
<a name="l00762"></a>00762     <span class="keywordflow">for</span> (QValueList&lt;MessageWin*&gt;::Iterator it = mWindowList.begin();  it != mWindowList.end();  ++it)
<a name="l00763"></a>00763     {
<a name="l00764"></a>00764         <a class="code" href="classMessageWin.html" title="MessageWin: A window to display an alarm message.">MessageWin</a>* w = *it;
<a name="l00765"></a>00765         <span class="keywordflow">if</span> (w-&gt;<a class="code" href="classMessageWin.html#b3448473e052d84490985939bf218ac3">mEventID</a> == eventID  &amp;&amp;  !w-&gt;<a class="code" href="classMessageWin.html#177fcd3c6f181b5e997954ab2b838dec">mErrorWindow</a>)
<a name="l00766"></a>00766             <span class="keywordflow">return</span> w;
<a name="l00767"></a>00767     }
<a name="l00768"></a>00768     <span class="keywordflow">return</span> 0;
<a name="l00769"></a>00769 }
<a name="l00770"></a>00770 
<a name="l00771"></a>00771 <span class="comment">/******************************************************************************</span>
<a name="l00772"></a>00772 <span class="comment">*  Beep and play the audio file, as appropriate.</span>
<a name="l00773"></a>00773 <span class="comment">*/</span>
<a name="l00774"></a>00774 <span class="keywordtype">void</span> MessageWin::playAudio()
<a name="l00775"></a>00775 {
<a name="l00776"></a>00776     <span class="keywordflow">if</span> (mBeep)
<a name="l00777"></a>00777     {
<a name="l00778"></a>00778         <span class="comment">// Beep using two methods, in case the sound card/speakers are switched off or not working</span>
<a name="l00779"></a>00779         KNotifyClient::beep();     <span class="comment">// beep through the sound card &amp; speakers</span>
<a name="l00780"></a>00780         QApplication::beep();      <span class="comment">// beep through the internal speaker</span>
<a name="l00781"></a>00781     }
<a name="l00782"></a>00782     <span class="keywordflow">if</span> (!mAudioFile.isEmpty())
<a name="l00783"></a>00783     {
<a name="l00784"></a>00784         <span class="keywordflow">if</span> (!mVolume  &amp;&amp;  mFadeVolume &lt;= 0)
<a name="l00785"></a>00785             <span class="keywordflow">return</span>;    <span class="comment">// ensure zero volume doesn't play anything</span>
<a name="l00786"></a>00786 <span class="preprocessor">#ifdef WITHOUT_ARTS</span>
<a name="l00787"></a>00787 <span class="preprocessor"></span>        QString play = mAudioFile;
<a name="l00788"></a>00788         QString file = QString::fromLatin1(<span class="stringliteral">"file:"</span>);
<a name="l00789"></a>00789         <span class="keywordflow">if</span> (mAudioFile.startsWith(file))
<a name="l00790"></a>00790             play = mAudioFile.mid(file.length());
<a name="l00791"></a>00791         KAudioPlayer::play(QFile::encodeName(play));
<a name="l00792"></a>00792 <span class="preprocessor">#else</span>
<a name="l00793"></a>00793 <span class="preprocessor"></span>        <span class="comment">// An audio file is specified. Because loading it may take some time,</span>
<a name="l00794"></a>00794         <span class="comment">// call it on a timer to allow the window to display first.</span>
<a name="l00795"></a>00795         QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotPlayAudio()));
<a name="l00796"></a>00796 <span class="preprocessor">#endif</span>
<a name="l00797"></a>00797 <span class="preprocessor"></span>    }
<a name="l00798"></a>00798     <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mSpeak)
<a name="l00799"></a>00799     {
<a name="l00800"></a>00800         <span class="comment">// The message is to be spoken. In case of error messges,</span>
<a name="l00801"></a>00801         <span class="comment">// call it on a timer to allow the window to display first.</span>
<a name="l00802"></a>00802         QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(slotSpeak()));
<a name="l00803"></a>00803     }
<a name="l00804"></a>00804 }
<a name="l00805"></a>00805 
<a name="l00806"></a>00806 <span class="comment">/******************************************************************************</span>
<a name="l00807"></a>00807 <span class="comment">*  Speak the message.</span>
<a name="l00808"></a>00808 <span class="comment">*  Called asynchronously to avoid delaying the display of the message.</span>
<a name="l00809"></a>00809 <span class="comment">*/</span>
<a name="l00810"></a>00810 <span class="keywordtype">void</span> MessageWin::slotSpeak()
<a name="l00811"></a>00811 {
<a name="l00812"></a>00812     DCOPClient* client = kapp-&gt;dcopClient();
<a name="l00813"></a>00813     <span class="keywordflow">if</span> (!client-&gt;isApplicationRegistered(<span class="stringliteral">"kttsd"</span>))
<a name="l00814"></a>00814     {
<a name="l00815"></a>00815         <span class="comment">// kttsd is not running, so start it</span>
<a name="l00816"></a>00816         QString error;
<a name="l00817"></a>00817         <span class="keywordflow">if</span> (kapp-&gt;startServiceByDesktopName(<span class="stringliteral">"kttsd"</span>, QStringList(), &amp;error))
<a name="l00818"></a>00818         {
<a name="l00819"></a>00819             kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotSpeak(): failed to start kttsd: "</span> &lt;&lt; error &lt;&lt; endl;
<a name="l00820"></a>00820             <span class="keywordflow">if</span> (!haveErrorMessage(ErrMsg_Speak))
<a name="l00821"></a>00821             {
<a name="l00822"></a>00822                 KMessageBox::detailedError(0, i18n(<span class="stringliteral">"Unable to speak message"</span>), error);
<a name="l00823"></a>00823                 clearErrorMessage(ErrMsg_Speak);
<a name="l00824"></a>00824             }
<a name="l00825"></a>00825             <span class="keywordflow">return</span>;
<a name="l00826"></a>00826         }
<a name="l00827"></a>00827     }
<a name="l00828"></a>00828     QByteArray  data;
<a name="l00829"></a>00829     QDataStream arg(data, IO_WriteOnly);
<a name="l00830"></a>00830     arg &lt;&lt; mMessage &lt;&lt; <span class="stringliteral">""</span>;
<a name="l00831"></a>00831     <span class="keywordflow">if</span> (!client-&gt;send(<span class="stringliteral">"kttsd"</span>, <span class="stringliteral">"KSpeech"</span>, <span class="stringliteral">"sayMessage(QString,QString)"</span>, data))
<a name="l00832"></a>00832     {
<a name="l00833"></a>00833         kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotSpeak(): sayMessage() DCOP error"</span> &lt;&lt; endl;
<a name="l00834"></a>00834         <span class="keywordflow">if</span> (!haveErrorMessage(ErrMsg_Speak))
<a name="l00835"></a>00835         {
<a name="l00836"></a>00836             KMessageBox::detailedError(0, i18n(<span class="stringliteral">"Unable to speak message"</span>), i18n(<span class="stringliteral">"DCOP Call sayMessage failed"</span>));
<a name="l00837"></a>00837             clearErrorMessage(ErrMsg_Speak);
<a name="l00838"></a>00838         }
<a name="l00839"></a>00839     }
<a name="l00840"></a>00840 }
<a name="l00841"></a>00841 
<a name="l00842"></a>00842 <span class="comment">/******************************************************************************</span>
<a name="l00843"></a>00843 <span class="comment">*  Play the audio file.</span>
<a name="l00844"></a>00844 <span class="comment">*  Called asynchronously to avoid delaying the display of the message.</span>
<a name="l00845"></a>00845 <span class="comment">*/</span>
<a name="l00846"></a>00846 <span class="keywordtype">void</span> MessageWin::slotPlayAudio()
<a name="l00847"></a>00847 {
<a name="l00848"></a>00848 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00849"></a>00849 <span class="preprocessor"></span>    <span class="comment">// First check that it exists, to avoid possible crashes if the filename is badly specified</span>
<a name="l00850"></a>00850     MainWindow* mmw = MainWindow::mainMainWindow();
<a name="l00851"></a>00851     KURL url(mAudioFile);
<a name="l00852"></a>00852     <span class="keywordflow">if</span> (!url.isValid()  ||  !KIO::NetAccess::exists(url, <span class="keyword">true</span>, mmw)
<a name="l00853"></a>00853     ||  !KIO::NetAccess::download(url, mLocalAudioFile, mmw))
<a name="l00854"></a>00854     {
<a name="l00855"></a>00855         kdError(5950) &lt;&lt; <span class="stringliteral">"MessageWin::playAudio(): Open failure: "</span> &lt;&lt; mAudioFile &lt;&lt; endl;
<a name="l00856"></a>00856         <span class="keywordflow">if</span> (!haveErrorMessage(ErrMsg_AudioFile))
<a name="l00857"></a>00857         {
<a name="l00858"></a>00858             KMessageBox::error(<span class="keyword">this</span>, i18n(<span class="stringliteral">"Cannot open audio file:\n%1"</span>).arg(mAudioFile));
<a name="l00859"></a>00859             clearErrorMessage(ErrMsg_AudioFile);
<a name="l00860"></a>00860         }
<a name="l00861"></a>00861         <span class="keywordflow">return</span>;
<a name="l00862"></a>00862     }
<a name="l00863"></a>00863     <span class="keywordflow">if</span> (!mArtsDispatcher)
<a name="l00864"></a>00864     {
<a name="l00865"></a>00865         mFadeTimer = 0;
<a name="l00866"></a>00866         mPlayTimer = <span class="keyword">new</span> QTimer(<span class="keyword">this</span>);
<a name="l00867"></a>00867         connect(mPlayTimer, SIGNAL(timeout()), SLOT(checkAudioPlay()));
<a name="l00868"></a>00868         mArtsDispatcher = <span class="keyword">new</span> KArtsDispatcher;
<a name="l00869"></a>00869         mPlayedOnce = <span class="keyword">false</span>;
<a name="l00870"></a>00870         mAudioFileStart = QTime::currentTime();
<a name="l00871"></a>00871         initAudio(<span class="keyword">true</span>);
<a name="l00872"></a>00872         <span class="keywordflow">if</span> (!mPlayObject-&gt;object().isNull())
<a name="l00873"></a>00873             checkAudioPlay();
<a name="l00874"></a>00874 <span class="preprocessor">#if KDE_VERSION &gt;= 308</span>
<a name="l00875"></a>00875 <span class="preprocessor"></span>        <span class="keywordflow">if</span> (!mUsingKMix  &amp;&amp;  mVolume &gt;= 0)
<a name="l00876"></a>00876         {
<a name="l00877"></a>00877             <span class="comment">// Output error message now that everything else has been done.</span>
<a name="l00878"></a>00878             <span class="comment">// (Outputting it earlier would delay things until it is acknowledged.)</span>
<a name="l00879"></a>00879             kdWarning(5950) &lt;&lt; <span class="stringliteral">"Unable to set master volume (KMix: "</span> &lt;&lt; mKMixError &lt;&lt; <span class="stringliteral">")\n"</span>;
<a name="l00880"></a>00880             <span class="keywordflow">if</span> (!haveErrorMessage(ErrMsg_Volume))
<a name="l00881"></a>00881             {
<a name="l00882"></a>00882                 KMessageBox::information(<span class="keyword">this</span>, i18n(<span class="stringliteral">"Unable to set master volume\n(Error accessing KMix:\n%1)"</span>).arg(mKMixError),
<a name="l00883"></a>00883                                          QString::null, QString::fromLatin1(<span class="stringliteral">"KMixError"</span>));
<a name="l00884"></a>00884                 clearErrorMessage(ErrMsg_Volume);
<a name="l00885"></a>00885             }
<a name="l00886"></a>00886         }
<a name="l00887"></a>00887 <span class="preprocessor">#endif</span>
<a name="l00888"></a>00888 <span class="preprocessor"></span>    }
<a name="l00889"></a>00889 <span class="preprocessor">#endif</span>
<a name="l00890"></a>00890 <span class="preprocessor"></span>}
<a name="l00891"></a>00891 
<a name="l00892"></a>00892 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00893"></a>00893 <span class="preprocessor"></span><span class="comment">/******************************************************************************</span>
<a name="l00894"></a>00894 <span class="comment">*  Set up the audio file for playing.</span>
<a name="l00895"></a>00895 <span class="comment">*/</span>
<a name="l00896"></a>00896 <span class="keywordtype">void</span> MessageWin::initAudio(<span class="keywordtype">bool</span> firstTime)
<a name="l00897"></a>00897 {
<a name="l00898"></a>00898     KArtsServer aserver;
<a name="l00899"></a>00899     Arts::SoundServerV2 sserver = aserver.server();
<a name="l00900"></a>00900     KDE::PlayObjectFactory factory(sserver);
<a name="l00901"></a>00901     mPlayObject = factory.createPlayObject(mLocalAudioFile, <span class="keyword">true</span>);
<a name="l00902"></a>00902     <span class="keywordflow">if</span> (firstTime)
<a name="l00903"></a>00903     {
<a name="l00904"></a>00904         <span class="comment">// Save the existing sound volume setting for restoration afterwards,</span>
<a name="l00905"></a>00905         <span class="comment">// and set the desired volume for the alarm.</span>
<a name="l00906"></a>00906         mUsingKMix = <span class="keyword">false</span>;
<a name="l00907"></a>00907         <span class="keywordtype">float</span> volume = mVolume;    <span class="comment">// initial volume</span>
<a name="l00908"></a>00908         <span class="keywordflow">if</span> (volume &gt;= 0)
<a name="l00909"></a>00909         {
<a name="l00910"></a>00910             <span class="comment">// The volume has been specified</span>
<a name="l00911"></a>00911             <span class="keywordflow">if</span> (mFadeVolume &gt;= 0)
<a name="l00912"></a>00912                 volume = mFadeVolume;    <span class="comment">// fading, so adjust the initial volume</span>
<a name="l00913"></a>00913 
<a name="l00914"></a>00914             <span class="comment">// Get the current master volume from KMix</span>
<a name="l00915"></a>00915             <span class="keywordtype">int</span> vol = getKMixVolume();
<a name="l00916"></a>00916             <span class="keywordflow">if</span> (vol &gt;= 0)
<a name="l00917"></a>00917             {
<a name="l00918"></a>00918                 mOldVolume = vol;    <span class="comment">// success</span>
<a name="l00919"></a>00919                 mUsingKMix = <span class="keyword">true</span>;
<a name="l00920"></a>00920                 setKMixVolume(static_cast&lt;int&gt;(volume * 100));
<a name="l00921"></a>00921             }
<a name="l00922"></a>00922         }
<a name="l00923"></a>00923         <span class="keywordflow">if</span> (!mUsingKMix)
<a name="l00924"></a>00924         {
<a name="l00925"></a>00925             <span class="comment">/* Adjust within the current master volume, because either</span>
<a name="l00926"></a>00926 <span class="comment">             * a) the volume is not specified, in which case we want to play</span>
<a name="l00927"></a>00927 <span class="comment">             *    at 100% of the current master volume setting, or</span>
<a name="l00928"></a>00928 <span class="comment">             * b) KMix is not available to set the master volume.</span>
<a name="l00929"></a>00929 <span class="comment">             */</span>
<a name="l00930"></a>00930             mOldVolume = sserver.outVolume().scaleFactor();    <span class="comment">// save volume for restoration afterwards</span>
<a name="l00931"></a>00931             sserver.outVolume().scaleFactor(volume &gt;= 0 ? volume : 1);
<a name="l00932"></a>00932         }
<a name="l00933"></a>00933     }
<a name="l00934"></a>00934     mSilenceButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l00935"></a>00935     mPlayed = <span class="keyword">false</span>;
<a name="l00936"></a>00936     connect(mPlayObject, SIGNAL(playObjectCreated()), SLOT(checkAudioPlay()));
<a name="l00937"></a>00937     <span class="keywordflow">if</span> (!mPlayObject-&gt;object().isNull())
<a name="l00938"></a>00938         checkAudioPlay();
<a name="l00939"></a>00939 }
<a name="l00940"></a>00940 <span class="preprocessor">#endif</span>
<a name="l00941"></a>00941 <span class="preprocessor"></span>
<a name="l00942"></a>00942 <span class="comment">/******************************************************************************</span>
<a name="l00943"></a>00943 <span class="comment">*  Called when the audio file has loaded and is ready to play, or on a timer</span>
<a name="l00944"></a>00944 <span class="comment">*  when play is expected to have completed.</span>
<a name="l00945"></a>00945 <span class="comment">*  If it is ready to play, start playing it (for the first time or repeated).</span>
<a name="l00946"></a>00946 <span class="comment">*  If play has not yet completed, wait a bit longer.</span>
<a name="l00947"></a>00947 <span class="comment">*/</span>
<a name="l00948"></a>00948 <span class="keywordtype">void</span> MessageWin::checkAudioPlay()
<a name="l00949"></a>00949 {
<a name="l00950"></a>00950 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l00951"></a>00951 <span class="preprocessor"></span>    <span class="keywordflow">if</span> (!mPlayObject)
<a name="l00952"></a>00952         <span class="keywordflow">return</span>;
<a name="l00953"></a>00953     <span class="keywordflow">if</span> (mPlayObject-&gt;state() == Arts::posIdle)
<a name="l00954"></a>00954     {
<a name="l00955"></a>00955         <span class="comment">// The file has loaded and is ready to play, or play has completed</span>
<a name="l00956"></a>00956         <span class="keywordflow">if</span> (mPlayedOnce  &amp;&amp;  !mAudioRepeat)
<a name="l00957"></a>00957         {
<a name="l00958"></a>00958             <span class="comment">// Play has completed</span>
<a name="l00959"></a>00959             stopPlay();
<a name="l00960"></a>00960             <span class="keywordflow">return</span>;
<a name="l00961"></a>00961         }
<a name="l00962"></a>00962 
<a name="l00963"></a>00963         <span class="comment">// Start playing the file, either for the first time or again</span>
<a name="l00964"></a>00964         kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::checkAudioPlay(): start\n"</span>;
<a name="l00965"></a>00965         <span class="keywordflow">if</span> (!mPlayedOnce)
<a name="l00966"></a>00966         {
<a name="l00967"></a>00967             <span class="comment">// Start playing the file for the first time</span>
<a name="l00968"></a>00968             QTime now = QTime::currentTime();
<a name="l00969"></a>00969             mAudioFileLoadSecs = mAudioFileStart.secsTo(now);
<a name="l00970"></a>00970             <span class="keywordflow">if</span> (mAudioFileLoadSecs &lt; 0)
<a name="l00971"></a>00971                 mAudioFileLoadSecs += 86400;
<a name="l00972"></a>00972             <span class="keywordflow">if</span> (mVolume &gt;= 0  &amp;&amp;  mFadeVolume &gt;= 0  &amp;&amp;  mFadeSeconds &gt; 0)
<a name="l00973"></a>00973             {
<a name="l00974"></a>00974                 <span class="comment">// Set up volume fade</span>
<a name="l00975"></a>00975                 mAudioFileStart = now;
<a name="l00976"></a>00976                 mFadeTimer = <span class="keyword">new</span> QTimer(<span class="keyword">this</span>);
<a name="l00977"></a>00977                 connect(mFadeTimer, SIGNAL(timeout()), SLOT(slotFade()));
<a name="l00978"></a>00978                 mFadeTimer-&gt;start(1000);     <span class="comment">// adjust volume every second</span>
<a name="l00979"></a>00979             }
<a name="l00980"></a>00980             mPlayedOnce = <span class="keyword">true</span>;
<a name="l00981"></a>00981         }
<a name="l00982"></a>00982         <span class="keywordflow">if</span> (mAudioFileLoadSecs &lt; 3)
<a name="l00983"></a>00983         {
<a name="l00984"></a>00984             <span class="comment">/* The aRts library takes several attempts before a PlayObject can</span>
<a name="l00985"></a>00985 <span class="comment">             * be replayed, leaving a gap of perhaps 5 seconds between plays.</span>
<a name="l00986"></a>00986 <span class="comment">             * So if loading the file takes a short time, it's better to reload</span>
<a name="l00987"></a>00987 <span class="comment">             * the PlayObject rather than try to replay the same PlayObject.</span>
<a name="l00988"></a>00988 <span class="comment">             */</span>
<a name="l00989"></a>00989             <span class="keywordflow">if</span> (mPlayed)
<a name="l00990"></a>00990             {
<a name="l00991"></a>00991                 <span class="comment">// Playing has completed. Start playing again.</span>
<a name="l00992"></a>00992                 <span class="keyword">delete</span> mPlayObject;
<a name="l00993"></a>00993                 initAudio(<span class="keyword">false</span>);
<a name="l00994"></a>00994                 <span class="keywordflow">if</span> (mPlayObject-&gt;object().isNull())
<a name="l00995"></a>00995                     <span class="keywordflow">return</span>;
<a name="l00996"></a>00996             }
<a name="l00997"></a>00997             mPlayed = <span class="keyword">true</span>;
<a name="l00998"></a>00998             mPlayObject-&gt;play();
<a name="l00999"></a>00999         }
<a name="l01000"></a>01000         <span class="keywordflow">else</span>
<a name="l01001"></a>01001         {
<a name="l01002"></a>01002             <span class="comment">// The file is slow to load, so attempt to replay the PlayObject</span>
<a name="l01003"></a>01003             <span class="keyword">static</span> Arts::poTime t0((<span class="keywordtype">long</span>)0, (<span class="keywordtype">long</span>)0, 0, std::string());
<a name="l01004"></a>01004             Arts::poTime current = mPlayObject-&gt;currentTime();
<a name="l01005"></a>01005             <span class="keywordflow">if</span> (current.seconds || current.ms)
<a name="l01006"></a>01006                 mPlayObject-&gt;seek(t0);
<a name="l01007"></a>01007             <span class="keywordflow">else</span>
<a name="l01008"></a>01008                 mPlayObject-&gt;play();
<a name="l01009"></a>01009         }
<a name="l01010"></a>01010     }
<a name="l01011"></a>01011 
<a name="l01012"></a>01012     <span class="comment">// The sound file is still playing</span>
<a name="l01013"></a>01013     Arts::poTime overall = mPlayObject-&gt;overallTime();
<a name="l01014"></a>01014     Arts::poTime current = mPlayObject-&gt;currentTime();
<a name="l01015"></a>01015     <span class="keywordtype">int</span> time = 1000*(overall.seconds - current.seconds) + overall.ms - current.ms;
<a name="l01016"></a>01016     if (time &lt; 0)
<a name="l01017"></a>01017         time = 0;
<a name="l01018"></a>01018     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::checkAudioPlay(): wait for "</span> &lt;&lt; (time+100) &lt;&lt; <span class="stringliteral">"ms\n"</span>;
<a name="l01019"></a>01019     mPlayTimer-&gt;start(time + 100, <span class="keyword">true</span>);
<a name="l01020"></a>01020 <span class="preprocessor">#endif</span>
<a name="l01021"></a>01021 <span class="preprocessor"></span>}
<a name="l01022"></a>01022 
<a name="l01023"></a>01023 <span class="comment">/******************************************************************************</span>
<a name="l01024"></a>01024 <span class="comment">*  Called when play completes, the Silence button is clicked, or the window is</span>
<a name="l01025"></a>01025 <span class="comment">*  closed, to reset the sound volume and terminate audio access.</span>
<a name="l01026"></a>01026 <span class="comment">*/</span>
<a name="l01027"></a>01027 <span class="keywordtype">void</span> MessageWin::stopPlay()
<a name="l01028"></a>01028 {
<a name="l01029"></a>01029 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l01030"></a>01030 <span class="preprocessor"></span>    <span class="keywordflow">if</span> (mArtsDispatcher)
<a name="l01031"></a>01031     {
<a name="l01032"></a>01032         <span class="comment">// Restore the sound volume to what it was before the sound file</span>
<a name="l01033"></a>01033         <span class="comment">// was played, provided that nothing else has modified it since.</span>
<a name="l01034"></a>01034         <span class="keywordflow">if</span> (!mUsingKMix)
<a name="l01035"></a>01035         {
<a name="l01036"></a>01036             KArtsServer aserver;
<a name="l01037"></a>01037             Arts::StereoVolumeControl svc = aserver.server().outVolume();
<a name="l01038"></a>01038             <span class="keywordtype">float</span> currentVolume = svc.scaleFactor();
<a name="l01039"></a>01039             <span class="keywordtype">float</span> eventVolume = mVolume;
<a name="l01040"></a>01040             <span class="keywordflow">if</span> (eventVolume &lt; 0)
<a name="l01041"></a>01041                 eventVolume = 1;
<a name="l01042"></a>01042             <span class="keywordflow">if</span> (currentVolume == eventVolume)
<a name="l01043"></a>01043                 svc.scaleFactor(mOldVolume);
<a name="l01044"></a>01044         }
<a name="l01045"></a>01045         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mVolume &gt;= 0)
<a name="l01046"></a>01046         {
<a name="l01047"></a>01047             <span class="keywordtype">int</span> eventVolume = <span class="keyword">static_cast&lt;</span><span class="keywordtype">int</span><span class="keyword">&gt;</span>(mVolume * 100);
<a name="l01048"></a>01048             <span class="keywordtype">int</span> currentVolume = getKMixVolume();
<a name="l01049"></a>01049             <span class="comment">// Volume returned isn't always exactly equal to volume set</span>
<a name="l01050"></a>01050             <span class="keywordflow">if</span> (currentVolume &lt; 0  ||  abs(currentVolume - eventVolume) &lt; 5)
<a name="l01051"></a>01051                 setKMixVolume(static_cast&lt;int&gt;(mOldVolume));
<a name="l01052"></a>01052         }
<a name="l01053"></a>01053     }
<a name="l01054"></a>01054     <span class="keyword">delete</span> mPlayObject;      mPlayObject = 0;
<a name="l01055"></a>01055     <span class="keyword">delete</span> mArtsDispatcher;  mArtsDispatcher = 0;
<a name="l01056"></a>01056     <span class="keywordflow">if</span> (!mLocalAudioFile.isEmpty())
<a name="l01057"></a>01057     {
<a name="l01058"></a>01058         KIO::NetAccess::removeTempFile(mLocalAudioFile);   <span class="comment">// removes it only if it IS a temporary file</span>
<a name="l01059"></a>01059         mLocalAudioFile = QString::null;
<a name="l01060"></a>01060     }
<a name="l01061"></a>01061     <span class="keywordflow">if</span> (mSilenceButton)
<a name="l01062"></a>01062         mSilenceButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l01063"></a>01063 <span class="preprocessor">#endif</span>
<a name="l01064"></a>01064 <span class="preprocessor"></span>}
<a name="l01065"></a>01065 
<a name="l01066"></a>01066 <span class="comment">/******************************************************************************</span>
<a name="l01067"></a>01067 <span class="comment">*  Called every second to fade the volume when the audio file starts playing.</span>
<a name="l01068"></a>01068 <span class="comment">*/</span>
<a name="l01069"></a>01069 <span class="keywordtype">void</span> MessageWin::slotFade()
<a name="l01070"></a>01070 {
<a name="l01071"></a>01071 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l01072"></a>01072 <span class="preprocessor"></span>    QTime now = QTime::currentTime();
<a name="l01073"></a>01073     <span class="keywordtype">int</span> elapsed = mAudioFileStart.secsTo(now);
<a name="l01074"></a>01074     <span class="keywordflow">if</span> (elapsed &lt; 0)
<a name="l01075"></a>01075         elapsed += 86400;    <span class="comment">// it's the next day</span>
<a name="l01076"></a>01076     <span class="keywordtype">float</span> volume;
<a name="l01077"></a>01077     <span class="keywordflow">if</span> (elapsed &gt;= mFadeSeconds)
<a name="l01078"></a>01078     {
<a name="l01079"></a>01079         <span class="comment">// The fade has finished. Set to normal volume.</span>
<a name="l01080"></a>01080         volume = mVolume;
<a name="l01081"></a>01081         <span class="keyword">delete</span> mFadeTimer;
<a name="l01082"></a>01082         mFadeTimer = 0;
<a name="l01083"></a>01083         <span class="keywordflow">if</span> (!mVolume)
<a name="l01084"></a>01084         {
<a name="l01085"></a>01085             kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotFade(0)\n"</span>;
<a name="l01086"></a>01086             stopPlay();
<a name="l01087"></a>01087             <span class="keywordflow">return</span>;
<a name="l01088"></a>01088         }
<a name="l01089"></a>01089     }
<a name="l01090"></a>01090     <span class="keywordflow">else</span>
<a name="l01091"></a>01091         volume = mFadeVolume  +  ((mVolume - mFadeVolume) * elapsed) / mFadeSeconds;
<a name="l01092"></a>01092     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotFade("</span> &lt;&lt; volume &lt;&lt; <span class="stringliteral">")\n"</span>;
<a name="l01093"></a>01093     <span class="keywordflow">if</span> (mArtsDispatcher)
<a name="l01094"></a>01094     {
<a name="l01095"></a>01095         <span class="keywordflow">if</span> (mUsingKMix)
<a name="l01096"></a>01096             setKMixVolume(static_cast&lt;int&gt;(volume * 100));
<a name="l01097"></a>01097         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (mArtsDispatcher)
<a name="l01098"></a>01098         {
<a name="l01099"></a>01099             KArtsServer aserver;
<a name="l01100"></a>01100             aserver.server().outVolume().scaleFactor(volume);
<a name="l01101"></a>01101         }
<a name="l01102"></a>01102     }
<a name="l01103"></a>01103 <span class="preprocessor">#endif</span>
<a name="l01104"></a>01104 <span class="preprocessor"></span>}
<a name="l01105"></a>01105 
<a name="l01106"></a>01106 <span class="preprocessor">#ifndef WITHOUT_ARTS</span>
<a name="l01107"></a>01107 <span class="preprocessor"></span><span class="comment">/******************************************************************************</span>
<a name="l01108"></a>01108 <span class="comment">*  Get the master volume from KMix.</span>
<a name="l01109"></a>01109 <span class="comment">*  Reply &lt; 0 if failure.</span>
<a name="l01110"></a>01110 <span class="comment">*/</span>
<a name="l01111"></a>01111 <span class="keywordtype">int</span> MessageWin::getKMixVolume()
<a name="l01112"></a>01112 {
<a name="l01113"></a>01113     <span class="keywordflow">if</span> (!KAlarm::runProgram(KMIX_APP_NAME, KMIX_DCOP_WINDOW, mKMixName, mKMixError))   <span class="comment">// start KMix if it isn't already running</span>
<a name="l01114"></a>01114         <span class="keywordflow">return</span> -1;
<a name="l01115"></a>01115     QByteArray  data, replyData;
<a name="l01116"></a>01116     QCString    replyType;
<a name="l01117"></a>01117     QDataStream arg(data, IO_WriteOnly);
<a name="l01118"></a>01118     <span class="keywordflow">if</span> (!kapp-&gt;dcopClient()-&gt;call(mKMixName, KMIX_DCOP_OBJECT, <span class="stringliteral">"masterVolume()"</span>, data, replyType, replyData)
<a name="l01119"></a>01119     ||  replyType != <span class="stringliteral">"int"</span>)
<a name="l01120"></a>01120         <span class="keywordflow">return</span> -1;
<a name="l01121"></a>01121     <span class="keywordtype">int</span> result;
<a name="l01122"></a>01122     QDataStream reply(replyData, IO_ReadOnly);
<a name="l01123"></a>01123     reply &gt;&gt; result;
<a name="l01124"></a>01124     <span class="keywordflow">return</span> (result &gt;= 0) ? result : 0;
<a name="l01125"></a>01125 }
<a name="l01126"></a>01126 
<a name="l01127"></a>01127 <span class="comment">/******************************************************************************</span>
<a name="l01128"></a>01128 <span class="comment">*  Set the master volume using KMix.</span>
<a name="l01129"></a>01129 <span class="comment">*/</span>
<a name="l01130"></a>01130 <span class="keywordtype">void</span> MessageWin::setKMixVolume(<span class="keywordtype">int</span> percent)
<a name="l01131"></a>01131 {
<a name="l01132"></a>01132     <span class="keywordflow">if</span> (!mUsingKMix)
<a name="l01133"></a>01133         <span class="keywordflow">return</span>;
<a name="l01134"></a>01134     <span class="keywordflow">if</span> (!KAlarm::runProgram(KMIX_APP_NAME, KMIX_DCOP_WINDOW, mKMixName, mKMixError))   <span class="comment">// start KMix if it isn't already running</span>
<a name="l01135"></a>01135         <span class="keywordflow">return</span>;
<a name="l01136"></a>01136     QByteArray  data;
<a name="l01137"></a>01137     QDataStream arg(data, IO_WriteOnly);
<a name="l01138"></a>01138     arg &lt;&lt; percent;
<a name="l01139"></a>01139     <span class="keywordflow">if</span> (!kapp-&gt;dcopClient()-&gt;send(mKMixName, KMIX_DCOP_OBJECT, <span class="stringliteral">"setMasterVolume(int)"</span>, data))
<a name="l01140"></a>01140         kdError(5950) &lt;&lt; <span class="stringliteral">"MessageWin::setKMixVolume(): kmix dcop call failed\n"</span>;
<a name="l01141"></a>01141 }
<a name="l01142"></a>01142 <span class="preprocessor">#endif</span>
<a name="l01143"></a>01143 <span class="preprocessor"></span>
<a name="l01144"></a>01144 <span class="comment">/******************************************************************************</span>
<a name="l01145"></a>01145 <span class="comment">*  Raise the alarm window, re-output any required audio notification, and</span>
<a name="l01146"></a>01146 <span class="comment">*  reschedule the alarm in the calendar file.</span>
<a name="l01147"></a>01147 <span class="comment">*/</span>
<a name="l01148"></a>01148 <span class="keywordtype">void</span> MessageWin::repeat(<span class="keyword">const</span> KAAlarm&amp; alarm)
<a name="l01149"></a>01149 {
<a name="l01150"></a>01150     <span class="keywordflow">if</span> (mDeferDlg)
<a name="l01151"></a>01151     {
<a name="l01152"></a>01152         <span class="comment">// Cancel any deferral dialogue so that the user notices something's going on,</span>
<a name="l01153"></a>01153         <span class="comment">// and also because the deferral time limit will have changed.</span>
<a name="l01154"></a>01154         <span class="keyword">delete</span> mDeferDlg;
<a name="l01155"></a>01155         mDeferDlg = 0;
<a name="l01156"></a>01156     }
<a name="l01157"></a>01157     <span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* kcalEvent = mEventID.isNull() ? 0 : AlarmCalendar::activeCalendar()-&gt;<a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(mEventID);
<a name="l01158"></a>01158     <span class="keywordflow">if</span> (kcalEvent)
<a name="l01159"></a>01159     {
<a name="l01160"></a>01160         mAlarmType = alarm.type();    <span class="comment">// store new alarm type for use if it is later deferred</span>
<a name="l01161"></a>01161         <span class="keywordflow">if</span> (!mDeferDlg  ||  Preferences::modalMessages())
<a name="l01162"></a>01162         {
<a name="l01163"></a>01163             <span class="keyword">raise</span>();
<a name="l01164"></a>01164             playAudio();
<a name="l01165"></a>01165         }
<a name="l01166"></a>01166         <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event(*kcalEvent);
<a name="l01167"></a>01167         mDeferButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l01168"></a>01168         setDeferralLimit(event);    <span class="comment">// ensure that button is disabled when alarm can't be deferred any more</span>
<a name="l01169"></a>01169         theApp()-&gt;alarmShowing(event, mAlarmType, mDateTime);
<a name="l01170"></a>01170     }
<a name="l01171"></a>01171 }
<a name="l01172"></a>01172 
<a name="l01173"></a>01173 <span class="comment">/******************************************************************************</span>
<a name="l01174"></a>01174 <span class="comment">*  Display the window.</span>
<a name="l01175"></a>01175 <span class="comment">*  If windows are being positioned away from the mouse cursor, it is initially</span>
<a name="l01176"></a>01176 <span class="comment">*  positioned at the top left to slightly reduce the number of times the</span>
<a name="l01177"></a>01177 <span class="comment">*  windows need to be moved in showEvent().</span>
<a name="l01178"></a>01178 <span class="comment">*/</span>
<a name="l01179"></a>01179 <span class="keywordtype">void</span> MessageWin::show()
<a name="l01180"></a>01180 {
<a name="l01181"></a>01181     <span class="keywordflow">if</span> (mCloseTime.isValid())
<a name="l01182"></a>01182     {
<a name="l01183"></a>01183         <span class="comment">// Set a timer to auto-close the window</span>
<a name="l01184"></a>01184         <span class="keywordtype">int</span> delay = QDateTime::currentDateTime().secsTo(mCloseTime);
<a name="l01185"></a>01185         <span class="keywordflow">if</span> (delay &lt; 0)
<a name="l01186"></a>01186             delay = 0;
<a name="l01187"></a>01187         QTimer::singleShot(delay * 1000, <span class="keyword">this</span>, SLOT(close()));
<a name="l01188"></a>01188         <span class="keywordflow">if</span> (!delay)
<a name="l01189"></a>01189             <span class="keywordflow">return</span>;    <span class="comment">// don't show the window if auto-closing is already due</span>
<a name="l01190"></a>01190     }
<a name="l01191"></a>01191     <span class="keywordflow">if</span> (Preferences::messageButtonDelay() == 0)
<a name="l01192"></a>01192         move(0, 0);
<a name="l01193"></a>01193     MainWindowBase::show();
<a name="l01194"></a>01194 }
<a name="l01195"></a>01195 
<a name="l01196"></a>01196 <span class="comment">/******************************************************************************</span>
<a name="l01197"></a>01197 <span class="comment">*  Returns the window's recommended size exclusive of its frame.</span>
<a name="l01198"></a>01198 <span class="comment">*  For message windows, the size if limited to fit inside the working area of</span>
<a name="l01199"></a>01199 <span class="comment">*  the desktop.</span>
<a name="l01200"></a>01200 <span class="comment">*/</span>
<a name="l01201"></a>01201 QSize MessageWin::sizeHint()<span class="keyword"> const</span>
<a name="l01202"></a>01202 <span class="keyword"></span>{
<a name="l01203"></a>01203     <span class="keywordflow">if</span> (mAction != KAEvent::MESSAGE)
<a name="l01204"></a>01204         <span class="keywordflow">return</span> MainWindowBase::sizeHint();
<a name="l01205"></a>01205     <span class="keywordflow">if</span> (!mWinModule)
<a name="l01206"></a>01206         mWinModule = <span class="keyword">new</span> KWinModule(0, KWinModule::INFO_DESKTOP);
<a name="l01207"></a>01207     QSize frame = frameGeometry().size();
<a name="l01208"></a>01208     QSize contents = geometry().size();
<a name="l01209"></a>01209     QSize desktop  = mWinModule-&gt;workArea().size();
<a name="l01210"></a>01210     QSize maxSize(desktop.width() - (frame.width() - contents.width()),
<a name="l01211"></a>01211                   desktop.height() - (frame.height() - contents.height()));
<a name="l01212"></a>01212     <span class="keywordflow">return</span> MainWindowBase::sizeHint().boundedTo(maxSize);
<a name="l01213"></a>01213 }
<a name="l01214"></a>01214 
<a name="l01215"></a>01215 <span class="comment">/******************************************************************************</span>
<a name="l01216"></a>01216 <span class="comment">*  Called when the window is shown.</span>
<a name="l01217"></a>01217 <span class="comment">*  The first time, output any required audio notification, and reschedule or</span>
<a name="l01218"></a>01218 <span class="comment">*  delete the event from the calendar file.</span>
<a name="l01219"></a>01219 <span class="comment">*/</span>
<a name="l01220"></a>01220 <span class="keywordtype">void</span> MessageWin::showEvent(QShowEvent* se)
<a name="l01221"></a>01221 {
<a name="l01222"></a>01222     MainWindowBase::showEvent(se);
<a name="l01223"></a>01223     <span class="keywordflow">if</span> (!mShown)
<a name="l01224"></a>01224     {
<a name="l01225"></a>01225         <span class="keywordflow">if</span> (mErrorWindow)
<a name="l01226"></a>01226             enableButtons();    <span class="comment">// don't bother repositioning error messages</span>
<a name="l01227"></a>01227         <span class="keywordflow">else</span>
<a name="l01228"></a>01228         {
<a name="l01229"></a>01229             <span class="comment">/* Set the window size.</span>
<a name="l01230"></a>01230 <span class="comment">             * Note that the frame thickness is not yet known when this</span>
<a name="l01231"></a>01231 <span class="comment">             * method is called, so for large windows the size needs to be</span>
<a name="l01232"></a>01232 <span class="comment">             * set again later.</span>
<a name="l01233"></a>01233 <span class="comment">             */</span>
<a name="l01234"></a>01234             QSize s = sizeHint();     <span class="comment">// fit the window round the message</span>
<a name="l01235"></a>01235             <span class="keywordflow">if</span> (mAction == KAEvent::FILE  &amp;&amp;  !mErrorMsgs.count())
<a name="l01236"></a>01236                 KAlarm::readConfigWindowSize(<span class="stringliteral">"FileMessage"</span>, s);
<a name="l01237"></a>01237             resize(s);
<a name="l01238"></a>01238 
<a name="l01239"></a>01239             mButtonDelay = Preferences::messageButtonDelay() * 1000;
<a name="l01240"></a>01240             <span class="keywordflow">if</span> (!mButtonDelay)
<a name="l01241"></a>01241             {
<a name="l01242"></a>01242                 <span class="comment">/* Try to ensure that the window can't accidentally be acknowledged</span>
<a name="l01243"></a>01243 <span class="comment">                 * by the user clicking the mouse just as it appears.</span>
<a name="l01244"></a>01244 <span class="comment">                 * To achieve this, move the window so that the OK button is as far away</span>
<a name="l01245"></a>01245 <span class="comment">                 * from the cursor as possible. If the buttons are still too close to the</span>
<a name="l01246"></a>01246 <span class="comment">                 * cursor, disable the buttons for a short time.</span>
<a name="l01247"></a>01247 <span class="comment">                 * N.B. This can't be done in show(), since the geometry of the window</span>
<a name="l01248"></a>01248 <span class="comment">                 *      is not known until it is displayed. Unfortunately by moving the</span>
<a name="l01249"></a>01249 <span class="comment">                 *      window in showEvent(), a flicker is unavoidable.</span>
<a name="l01250"></a>01250 <span class="comment">                 *      See the Qt documentation on window geometry for more details.</span>
<a name="l01251"></a>01251 <span class="comment">                 */</span>
<a name="l01252"></a>01252                 <span class="comment">// PROBLEM: The frame size is not known yet!</span>
<a name="l01253"></a>01253 
<a name="l01254"></a>01254                 <span class="comment">/* Find the usable area of the desktop or, if the desktop comprises</span>
<a name="l01255"></a>01255 <span class="comment">                 * multiple screens, the usable area of the current screen. (If the</span>
<a name="l01256"></a>01256 <span class="comment">                 * message is displayed on a screen other than that currently being</span>
<a name="l01257"></a>01257 <span class="comment">                 * worked with, it might not be noticed.)</span>
<a name="l01258"></a>01258 <span class="comment">                 */</span>
<a name="l01259"></a>01259                 QPoint cursor = QCursor::pos();
<a name="l01260"></a>01260                 <span class="keywordflow">if</span> (!mWinModule)
<a name="l01261"></a>01261                     mWinModule = <span class="keyword">new</span> KWinModule(0, KWinModule::INFO_DESKTOP);
<a name="l01262"></a>01262                 QRect desk = mWinModule-&gt;workArea();
<a name="l01263"></a>01263                 QDesktopWidget* dw = QApplication::desktop();
<a name="l01264"></a>01264                 <span class="keywordflow">if</span> (dw-&gt;numScreens() &gt; 1)
<a name="l01265"></a>01265                     desk &amp;= dw-&gt;screenGeometry(dw-&gt;screenNumber(cursor));
<a name="l01266"></a>01266 
<a name="l01267"></a>01267                 QRect frame = frameGeometry();
<a name="l01268"></a>01268                 QRect rect  = geometry();
<a name="l01269"></a>01269                 <span class="comment">// Find the offsets from the outside of the frame to the edges of the OK button</span>
<a name="l01270"></a>01270                 QRect button(mOkButton-&gt;mapToParent(QPoint(0, 0)), mOkButton-&gt;mapToParent(mOkButton-&gt;rect().bottomRight()));
<a name="l01271"></a>01271                 <span class="keywordtype">int</span> buttonLeft   = button.left() + rect.left() - frame.left();
<a name="l01272"></a>01272                 <span class="keywordtype">int</span> buttonRight  = width() - button.right() + frame.right() - rect.right();
<a name="l01273"></a>01273                 <span class="keywordtype">int</span> buttonTop    = button.top() + rect.top() - frame.top();
<a name="l01274"></a>01274                 <span class="keywordtype">int</span> buttonBottom = height() - button.bottom() + frame.bottom() - rect.bottom();
<a name="l01275"></a>01275 
<a name="l01276"></a>01276                 <span class="keywordtype">int</span> centrex = (desk.width() + buttonLeft - buttonRight) / 2;
<a name="l01277"></a>01277                 <span class="keywordtype">int</span> centrey = (desk.height() + buttonTop - buttonBottom) / 2;
<a name="l01278"></a>01278                 <span class="keywordtype">int</span> x = (cursor.x() &lt; centrex) ? desk.right() - frame.width() : desk.left();
<a name="l01279"></a>01279                 <span class="keywordtype">int</span> y = (cursor.y() &lt; centrey) ? desk.bottom() - frame.height() : desk.top();
<a name="l01280"></a>01280 
<a name="l01281"></a>01281                 <span class="comment">// Find the enclosing rectangle for the new button positions</span>
<a name="l01282"></a>01282                 <span class="comment">// and check if the cursor is too near</span>
<a name="l01283"></a>01283                 QRect buttons = mOkButton-&gt;geometry().unite(mKAlarmButton-&gt;geometry());
<a name="l01284"></a>01284                 buttons.moveBy(rect.left() + x - frame.left(), rect.top() + y - frame.top());
<a name="l01285"></a>01285                 <span class="keywordtype">int</span> minDistance = proximityMultiple * mOkButton-&gt;height();
<a name="l01286"></a>01286                 <span class="keywordflow">if</span> ((abs(cursor.x() - buttons.left()) &lt; minDistance
<a name="l01287"></a>01287                   || abs(cursor.x() - buttons.right()) &lt; minDistance)
<a name="l01288"></a>01288                 &amp;&amp;  (abs(cursor.y() - buttons.top()) &lt; minDistance
<a name="l01289"></a>01289                   || abs(cursor.y() - buttons.bottom()) &lt; minDistance))
<a name="l01290"></a>01290                     mButtonDelay = proximityButtonDelay;    <span class="comment">// too near - disable buttons initially</span>
<a name="l01291"></a>01291 
<a name="l01292"></a>01292                 <span class="keywordflow">if</span> (x != frame.left()  ||  y != frame.top())
<a name="l01293"></a>01293                 {
<a name="l01294"></a>01294                     mPositioning = <span class="keyword">true</span>;
<a name="l01295"></a>01295                     move(x, y);
<a name="l01296"></a>01296                 }
<a name="l01297"></a>01297             }
<a name="l01298"></a>01298             <span class="keywordflow">if</span> (!mPositioning)
<a name="l01299"></a>01299                 displayComplete();    <span class="comment">// play audio, etc.</span>
<a name="l01300"></a>01300             <span class="keywordflow">if</span> (mAction == KAEvent::MESSAGE)
<a name="l01301"></a>01301             {
<a name="l01302"></a>01302                 <span class="comment">// Set the window size once the frame size is known</span>
<a name="l01303"></a>01303                 QTimer::singleShot(0, <span class="keyword">this</span>, SLOT(setMaxSize()));
<a name="l01304"></a>01304             }
<a name="l01305"></a>01305         }
<a name="l01306"></a>01306         mShown = <span class="keyword">true</span>;
<a name="l01307"></a>01307     }
<a name="l01308"></a>01308 }
<a name="l01309"></a>01309 
<a name="l01310"></a>01310 <span class="comment">/******************************************************************************</span>
<a name="l01311"></a>01311 <span class="comment">*  Called when the window has been moved.</span>
<a name="l01312"></a>01312 <span class="comment">*/</span>
<a name="l01313"></a>01313 <span class="keywordtype">void</span> MessageWin::moveEvent(QMoveEvent* e)
<a name="l01314"></a>01314 {
<a name="l01315"></a>01315     MainWindowBase::moveEvent(e);
<a name="l01316"></a>01316     <span class="keywordflow">if</span> (mPositioning)
<a name="l01317"></a>01317     {
<a name="l01318"></a>01318         <span class="comment">// The window has just been initially positioned</span>
<a name="l01319"></a>01319         mPositioning = <span class="keyword">false</span>;
<a name="l01320"></a>01320         displayComplete();    <span class="comment">// play audio, etc.</span>
<a name="l01321"></a>01321     }
<a name="l01322"></a>01322 }
<a name="l01323"></a>01323 
<a name="l01324"></a>01324 <span class="comment">/******************************************************************************</span>
<a name="l01325"></a>01325 <span class="comment">*  Reset the iniital window size if it exceeds the working area of the desktop.</span>
<a name="l01326"></a>01326 <span class="comment">*/</span>
<a name="l01327"></a>01327 <span class="keywordtype">void</span> MessageWin::setMaxSize()
<a name="l01328"></a>01328 {
<a name="l01329"></a>01329     QSize s = sizeHint();
<a name="l01330"></a>01330     <span class="keywordflow">if</span> (width() &gt; s.width()  ||  height() &gt; s.height())
<a name="l01331"></a>01331         resize(s);
<a name="l01332"></a>01332 }
<a name="l01333"></a>01333 
<a name="l01334"></a>01334 <span class="comment">/******************************************************************************</span>
<a name="l01335"></a>01335 <span class="comment">*  Called when the window has been displayed properly (in its correct position),</span>
<a name="l01336"></a>01336 <span class="comment">*  to play sounds and reschedule the event.</span>
<a name="l01337"></a>01337 <span class="comment">*/</span>
<a name="l01338"></a>01338 <span class="keywordtype">void</span> MessageWin::displayComplete()
<a name="l01339"></a>01339 {
<a name="l01340"></a>01340     playAudio();
<a name="l01341"></a>01341     <span class="keywordflow">if</span> (mRescheduleEvent)
<a name="l01342"></a>01342         theApp()-&gt;alarmShowing(mEvent, mAlarmType, mDateTime);
<a name="l01343"></a>01343 
<a name="l01344"></a>01344     <span class="comment">// Enable the window's buttons either now or after the configured delay</span>
<a name="l01345"></a>01345     <span class="keywordflow">if</span> (mButtonDelay &gt; 0)
<a name="l01346"></a>01346         QTimer::singleShot(mButtonDelay, <span class="keyword">this</span>, SLOT(enableButtons()));
<a name="l01347"></a>01347     <span class="keywordflow">else</span>
<a name="l01348"></a>01348         enableButtons();
<a name="l01349"></a>01349 }
<a name="l01350"></a>01350 
<a name="l01351"></a>01351 <span class="comment">/******************************************************************************</span>
<a name="l01352"></a>01352 <span class="comment">*  Enable the window's buttons.</span>
<a name="l01353"></a>01353 <span class="comment">*/</span>
<a name="l01354"></a>01354 <span class="keywordtype">void</span> MessageWin::enableButtons()
<a name="l01355"></a>01355 {
<a name="l01356"></a>01356     mOkButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l01357"></a>01357     mKAlarmButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l01358"></a>01358     <span class="keywordflow">if</span> (mDeferButton  &amp;&amp;  !mDisableDeferral)
<a name="l01359"></a>01359         mDeferButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l01360"></a>01360     <span class="keywordflow">if</span> (mEditButton)
<a name="l01361"></a>01361         mEditButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l01362"></a>01362     <span class="keywordflow">if</span> (mKMailButton)
<a name="l01363"></a>01363         mKMailButton-&gt;setEnabled(<span class="keyword">true</span>);
<a name="l01364"></a>01364 }
<a name="l01365"></a>01365 
<a name="l01366"></a>01366 <span class="comment">/******************************************************************************</span>
<a name="l01367"></a>01367 <span class="comment">*  Called when the window's size has changed (before it is painted).</span>
<a name="l01368"></a>01368 <span class="comment">*/</span>
<a name="l01369"></a>01369 <span class="keywordtype">void</span> MessageWin::resizeEvent(QResizeEvent* re)
<a name="l01370"></a>01370 {
<a name="l01371"></a>01371     <span class="keywordflow">if</span> (mRestoreHeight)
<a name="l01372"></a>01372     {
<a name="l01373"></a>01373         <span class="comment">// Restore the window height on session restoration</span>
<a name="l01374"></a>01374         <span class="keywordflow">if</span> (mRestoreHeight != re-&gt;size().height())
<a name="l01375"></a>01375         {
<a name="l01376"></a>01376             QSize size = re-&gt;size();
<a name="l01377"></a>01377             size.setHeight(mRestoreHeight);
<a name="l01378"></a>01378             resize(size);
<a name="l01379"></a>01379         }
<a name="l01380"></a>01380         <span class="keywordflow">else</span> <span class="keywordflow">if</span> (isVisible())
<a name="l01381"></a>01381             mRestoreHeight = 0;
<a name="l01382"></a>01382     }
<a name="l01383"></a>01383     <span class="keywordflow">else</span>
<a name="l01384"></a>01384     {
<a name="l01385"></a>01385         <span class="keywordflow">if</span> (mShown  &amp;&amp;  mAction == KAEvent::FILE  &amp;&amp;  !mErrorMsgs.count())
<a name="l01386"></a>01386             KAlarm::writeConfigWindowSize(<span class="stringliteral">"FileMessage"</span>, re-&gt;size());
<a name="l01387"></a>01387         MainWindowBase::resizeEvent(re);
<a name="l01388"></a>01388     }
<a name="l01389"></a>01389 }
<a name="l01390"></a>01390 
<a name="l01391"></a>01391 <span class="comment">/******************************************************************************</span>
<a name="l01392"></a>01392 <span class="comment">*  Called when a close event is received.</span>
<a name="l01393"></a>01393 <span class="comment">*  Only quits the application if there is no system tray icon displayed.</span>
<a name="l01394"></a>01394 <span class="comment">*/</span>
<a name="l01395"></a>01395 <span class="keywordtype">void</span> MessageWin::closeEvent(QCloseEvent* ce)
<a name="l01396"></a>01396 {
<a name="l01397"></a>01397     <span class="comment">// Don't prompt or delete the alarm from the display calendar if the session is closing</span>
<a name="l01398"></a>01398     <span class="keywordflow">if</span> (!theApp()-&gt;sessionClosingDown())
<a name="l01399"></a>01399     {
<a name="l01400"></a>01400         <span class="keywordflow">if</span> (mConfirmAck  &amp;&amp;  !mNoCloseConfirm)
<a name="l01401"></a>01401         {
<a name="l01402"></a>01402             <span class="comment">// Ask for confirmation of acknowledgement. Use warningYesNo() because its default is No.</span>
<a name="l01403"></a>01403             <span class="keywordflow">if</span> (KMessageBox::warningYesNo(<span class="keyword">this</span>, i18n(<span class="stringliteral">"Do you really want to acknowledge this alarm?"</span>),
<a name="l01404"></a>01404                                                 i18n(<span class="stringliteral">"Acknowledge Alarm"</span>), i18n(<span class="stringliteral">"&amp;Acknowledge"</span>), KStdGuiItem::cancel())
<a name="l01405"></a>01405                 != KMessageBox::Yes)
<a name="l01406"></a>01406             {
<a name="l01407"></a>01407                 ce-&gt;ignore();
<a name="l01408"></a>01408                 <span class="keywordflow">return</span>;
<a name="l01409"></a>01409             }
<a name="l01410"></a>01410         }
<a name="l01411"></a>01411         <span class="keywordflow">if</span> (!mEventID.isNull())
<a name="l01412"></a>01412         {
<a name="l01413"></a>01413             <span class="comment">// Delete from the display calendar</span>
<a name="l01414"></a>01414             KAlarm::deleteDisplayEvent(KAEvent::uid(mEventID, KAEvent::DISPLAYING));
<a name="l01415"></a>01415         }
<a name="l01416"></a>01416     }
<a name="l01417"></a>01417     MainWindowBase::closeEvent(ce);
<a name="l01418"></a>01418 }
<a name="l01419"></a>01419 
<a name="l01420"></a>01420 <span class="comment">/******************************************************************************</span>
<a name="l01421"></a>01421 <span class="comment">*  Called when the KMail button is clicked.</span>
<a name="l01422"></a>01422 <span class="comment">*  Tells KMail to display the email message displayed in this message window.</span>
<a name="l01423"></a>01423 <span class="comment">*/</span>
<a name="l01424"></a>01424 <span class="keywordtype">void</span> MessageWin::slotShowKMailMessage()
<a name="l01425"></a>01425 {
<a name="l01426"></a>01426     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotShowKMailMessage()\n"</span>;
<a name="l01427"></a>01427     <span class="keywordflow">if</span> (!mKMailSerialNumber)
<a name="l01428"></a>01428         <span class="keywordflow">return</span>;
<a name="l01429"></a>01429     QString err = KAlarm::runKMail(<span class="keyword">false</span>);
<a name="l01430"></a>01430     <span class="keywordflow">if</span> (!err.isNull())
<a name="l01431"></a>01431     {
<a name="l01432"></a>01432         KMessageBox::sorry(<span class="keyword">this</span>, err);
<a name="l01433"></a>01433         <span class="keywordflow">return</span>;
<a name="l01434"></a>01434     }
<a name="l01435"></a>01435     QCString    replyType;
<a name="l01436"></a>01436     QByteArray  data, replyData;
<a name="l01437"></a>01437     QDataStream arg(data, IO_WriteOnly);
<a name="l01438"></a>01438     arg &lt;&lt; (Q_UINT32)mKMailSerialNumber &lt;&lt; QString::null;
<a name="l01439"></a>01439     <span class="keywordflow">if</span> (kapp-&gt;dcopClient()-&gt;call(<span class="stringliteral">"kmail"</span>, KMAIL_DCOP_OBJECT, <span class="stringliteral">"showMail(Q_UINT32,QString)"</span>, data, replyType, replyData)
<a name="l01440"></a>01440     &amp;&amp;  replyType == <span class="stringliteral">"bool"</span>)
<a name="l01441"></a>01441     {
<a name="l01442"></a>01442         <span class="keywordtype">bool</span> result;
<a name="l01443"></a>01443         QDataStream replyStream(replyData, IO_ReadOnly);
<a name="l01444"></a>01444         replyStream &gt;&gt; result;
<a name="l01445"></a>01445         <span class="keywordflow">if</span> (result)
<a name="l01446"></a>01446             <span class="keywordflow">return</span>;    <span class="comment">// success</span>
<a name="l01447"></a>01447     }
<a name="l01448"></a>01448     kdError(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotShowKMailMessage(): kmail dcop call failed\n"</span>;
<a name="l01449"></a>01449     KMessageBox::sorry(<span class="keyword">this</span>, i18n(<span class="stringliteral">"Unable to locate this email in KMail"</span>));
<a name="l01450"></a>01450 }
<a name="l01451"></a>01451 
<a name="l01452"></a>01452 <span class="comment">/******************************************************************************</span>
<a name="l01453"></a>01453 <span class="comment">*  Called when the Edit... button is clicked.</span>
<a name="l01454"></a>01454 <span class="comment">*  Displays the alarm edit dialog.</span>
<a name="l01455"></a>01455 <span class="comment">*/</span>
<a name="l01456"></a>01456 <span class="keywordtype">void</span> MessageWin::slotEdit()
<a name="l01457"></a>01457 {
<a name="l01458"></a>01458     kdDebug(5950) &lt;&lt; <span class="stringliteral">"MessageWin::slotEdit()"</span> &lt;&lt; endl;
<a name="l01459"></a>01459     EditAlarmDlg editDlg(<span class="keyword">false</span>, i18n(<span class="stringliteral">"Edit Alarm"</span>), <span class="keyword">this</span>, <span class="stringliteral">"editDlg"</span>, &amp;mEvent);
<a name="l01460"></a>01460     <span class="keywordflow">if</span> (editDlg.exec() == QDialog::Accepted)
<a name="l01461"></a>01461     {
<a name="l01462"></a>01462         <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event;
<a name="l01463"></a>01463         editDlg.getEvent(event);
<a name="l01464"></a>01464 
<a name="l01465"></a>01465         <span class="comment">// Update the displayed lists and the calendar file</span>
<a name="l01466"></a>01466         KAlarm::UpdateStatus status;
<a name="l01467"></a>01467         <span class="keywordflow">if</span> (AlarmCalendar::activeCalendar()-&gt;event(mEventID))
<a name="l01468"></a>01468         {
<a name="l01469"></a>01469             <span class="comment">// The old alarm hasn't expired yet, so replace it</span>
<a name="l01470"></a>01470             status = KAlarm::modifyEvent(mEvent, event, 0, &amp;editDlg);
<a name="l01471"></a>01471             Undo::saveEdit(mEvent, event);
<a name="l01472"></a>01472         }
<a name="l01473"></a>01473         <span class="keywordflow">else</span>
<a name="l01474"></a>01474         {
<a name="l01475"></a>01475             <span class="comment">// The old event has expired, so simply create a new one</span>
<a name="l01476"></a>01476             status = KAlarm::addEvent(event, 0, &amp;editDlg);
<a name="l01477"></a>01477             Undo::saveAdd(event);
<a name="l01478"></a>01478         }
<a name="l01479"></a>01479 
<a name="l01480"></a>01480         <span class="keywordflow">if</span> (status == KAlarm::UPDATE_KORG_ERR)
<a name="l01481"></a>01481             KAlarm::displayKOrgUpdateError(&amp;editDlg, KAlarm::KORG_ERR_MODIFY, 1);
<a name="l01482"></a>01482         KAlarm::outputAlarmWarnings(&amp;editDlg, &amp;event);
<a name="l01483"></a>01483 
<a name="l01484"></a>01484         <span class="comment">// Close the alarm window</span>
<a name="l01485"></a>01485         mNoCloseConfirm = <span class="keyword">true</span>;   <span class="comment">// allow window to close without confirmation prompt</span>
<a name="l01486"></a>01486         close();
<a name="l01487"></a>01487     }
<a name="l01488"></a>01488 }
<a name="l01489"></a>01489 
<a name="l01490"></a>01490 <span class="comment">/******************************************************************************</span>
<a name="l01491"></a>01491 <span class="comment">* Set up to disable the defer button when the deferral limit is reached.</span>
<a name="l01492"></a>01492 <span class="comment">*/</span>
<a name="l01493"></a>01493 <span class="keywordtype">void</span> MessageWin::setDeferralLimit(<span class="keyword">const</span> <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>&amp; event)
<a name="l01494"></a>01494 {
<a name="l01495"></a>01495     <span class="keywordflow">if</span> (mDeferButton)
<a name="l01496"></a>01496     {
<a name="l01497"></a>01497         mDeferLimit = <span class="keyword">event</span>.deferralLimit().dateTime();
<a name="l01498"></a>01498         MidnightTimer::connect(<span class="keyword">this</span>, SLOT(checkDeferralLimit()));   <span class="comment">// check every day</span>
<a name="l01499"></a>01499         mDisableDeferral = <span class="keyword">false</span>;
<a name="l01500"></a>01500         checkDeferralLimit();
<a name="l01501"></a>01501     }
<a name="l01502"></a>01502 }
<a name="l01503"></a>01503 
<a name="l01504"></a>01504 <span class="comment">/******************************************************************************</span>
<a name="l01505"></a>01505 <span class="comment">* Check whether the deferral limit has been reached.</span>
<a name="l01506"></a>01506 <span class="comment">* If so, disable the Defer button.</span>
<a name="l01507"></a>01507 <span class="comment">* N.B. Ideally, just a single QTimer::singleShot() call would be made to disable</span>
<a name="l01508"></a>01508 <span class="comment">*      the defer button at the corret time. But for a 32-bit integer, the</span>
<a name="l01509"></a>01509 <span class="comment">*      milliseconds parameter overflows in about 25 days, so instead a daily</span>
<a name="l01510"></a>01510 <span class="comment">*      check is done until the day when the deferral limit is reached, followed</span>
<a name="l01511"></a>01511 <span class="comment">*      by a non-overflowing QTimer::singleShot() call.</span>
<a name="l01512"></a>01512 <span class="comment">*/</span>
<a name="l01513"></a>01513 <span class="keywordtype">void</span> MessageWin::checkDeferralLimit()
<a name="l01514"></a>01514 {
<a name="l01515"></a>01515     <span class="keywordflow">if</span> (!mDeferButton  ||  !mDeferLimit.isValid())
<a name="l01516"></a>01516         <span class="keywordflow">return</span>;
<a name="l01517"></a>01517     <span class="keywordtype">int</span> n = QDate::currentDate().daysTo(mDeferLimit.date());
<a name="l01518"></a>01518     <span class="keywordflow">if</span> (n &gt; 0)
<a name="l01519"></a>01519         <span class="keywordflow">return</span>;
<a name="l01520"></a>01520     MidnightTimer::disconnect(<span class="keyword">this</span>, SLOT(checkDeferralLimit()));
<a name="l01521"></a>01521     <span class="keywordflow">if</span> (n == 0)
<a name="l01522"></a>01522     {
<a name="l01523"></a>01523         <span class="comment">// The deferral limit will be reached today</span>
<a name="l01524"></a>01524         n = QTime::currentTime().secsTo(mDeferLimit.time());
<a name="l01525"></a>01525         <span class="keywordflow">if</span> (n &gt; 0)
<a name="l01526"></a>01526         {
<a name="l01527"></a>01527             QTimer::singleShot(n * 1000, <span class="keyword">this</span>, SLOT(checkDeferralLimit()));
<a name="l01528"></a>01528             <span class="keywordflow">return</span>;
<a name="l01529"></a>01529         }
<a name="l01530"></a>01530     }
<a name="l01531"></a>01531     mDeferButton-&gt;setEnabled(<span class="keyword">false</span>);
<a name="l01532"></a>01532     mDisableDeferral = <span class="keyword">true</span>;
<a name="l01533"></a>01533 }
<a name="l01534"></a>01534 
<a name="l01535"></a>01535 <span class="comment">/******************************************************************************</span>
<a name="l01536"></a>01536 <span class="comment">*  Called when the Defer... button is clicked.</span>
<a name="l01537"></a>01537 <span class="comment">*  Displays the defer message dialog.</span>
<a name="l01538"></a>01538 <span class="comment">*/</span>
<a name="l01539"></a>01539 <span class="keywordtype">void</span> MessageWin::slotDefer()
<a name="l01540"></a>01540 {
<a name="l01541"></a>01541     mDeferDlg = <span class="keyword">new</span> DeferAlarmDlg(i18n(<span class="stringliteral">"Defer Alarm"</span>), QDateTime::currentDateTime().addSecs(60),
<a name="l01542"></a>01542                                   <span class="keyword">false</span>, <span class="keyword">this</span>, <span class="stringliteral">"deferDlg"</span>);
<a name="l01543"></a>01543     <span class="keywordflow">if</span> (mDefaultDeferMinutes &gt; 0)
<a name="l01544"></a>01544         mDeferDlg-&gt;setDeferMinutes(mDefaultDeferMinutes);
<a name="l01545"></a>01545     mDeferDlg-&gt;setLimit(mEventID);
<a name="l01546"></a>01546     <span class="keywordflow">if</span> (!Preferences::modalMessages())
<a name="l01547"></a>01547         lower();
<a name="l01548"></a>01548     <span class="keywordflow">if</span> (mDeferDlg-&gt;exec() == QDialog::Accepted)
<a name="l01549"></a>01549     {
<a name="l01550"></a>01550         DateTime dateTime  = mDeferDlg-&gt;getDateTime();
<a name="l01551"></a>01551         <span class="keywordtype">int</span>      delayMins = mDeferDlg-&gt;deferMinutes();
<a name="l01552"></a>01552         <span class="keyword">const</span> <a class="codeRef" doxygen="libkcal.tag:../../libkcal/html/" href="../../libkcal/html/classKCal_1_1Event.html">Event</a>* kcalEvent = mEventID.isNull() ? 0 : AlarmCalendar::activeCalendar()-&gt;<a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(mEventID);
<a name="l01553"></a>01553         <span class="keywordflow">if</span> (kcalEvent)
<a name="l01554"></a>01554         {
<a name="l01555"></a>01555             <span class="comment">// The event still exists in the calendar file.</span>
<a name="l01556"></a>01556             <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event(*kcalEvent);
<a name="l01557"></a>01557             <span class="keywordtype">bool</span> repeat = <span class="keyword">event</span>.defer(dateTime, (mAlarmType &amp; KAAlarm::REMINDER_ALARM), <span class="keyword">true</span>);
<a name="l01558"></a>01558             <span class="keyword">event</span>.setDeferDefaultMinutes(delayMins);
<a name="l01559"></a>01559             KAlarm::updateEvent(event, 0, mDeferDlg, <span class="keyword">true</span>, !repeat);
<a name="l01560"></a>01560             <span class="keywordflow">if</span> (event.<a class="code" href="classKAEvent.html#f115c56e32273686f3ec496dff1690c0">deferred</a>())
<a name="l01561"></a>01561                 mNoPostAction = <span class="keyword">true</span>;
<a name="l01562"></a>01562         }
<a name="l01563"></a>01563         <span class="keywordflow">else</span>
<a name="l01564"></a>01564         {
<a name="l01565"></a>01565             <a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a> event;
<a name="l01566"></a>01566             kcalEvent = AlarmCalendar::displayCalendar()-&gt;<a class="code" href="classAlarmCalendar.html#37f9ca69267daea90e3bc68b44e117e7">event</a>(KAEvent::uid(mEventID, KAEvent::DISPLAYING));
<a name="l01567"></a>01567             <span class="keywordflow">if</span> (kcalEvent)
<a name="l01568"></a>01568             {
<a name="l01569"></a>01569                 <span class="keyword">event</span>.reinstateFromDisplaying(<a class="code" href="classKAEvent.html" title="KAEvent corresponds to a KCal::Event instance.">KAEvent</a>(*kcalEvent));
<a name="l01570"></a>01570                 <span class="keyword">event</span>.defer(dateTime, (mAlarmType &amp; KAAlarm::REMINDER_ALARM), <span class="keyword">true</span>);
<a name="l01571"></a>01571             }
<a name="l01572"></a>01572             <span class="keywordflow">else</span>
<a name="l01573"></a>01573             {
<a name="l01574"></a>01574                 <span class="comment">// The event doesn't exist any more !?!, so create a new one</span>
<a name="l01575"></a>01575                 <span class="keyword">event</span>.set(dateTime.dateTime(), mMessage, mBgColour, mFgColour, mFont, mAction, mLateCancel, mFlags);
<a name="l01576"></a>01576                 <span class="keyword">event</span>.setAudioFile(mAudioFile, mVolume, mFadeVolume, mFadeSeconds);
<a name="l01577"></a>01577                 <span class="keyword">event</span>.setArchive();
<a name="l01578"></a>01578                 <span class="keyword">event</span>.setEventID(mEventID);
<a name="l01579"></a>01579             }
<a name="l01580"></a>01580             <span class="keyword">event</span>.setDeferDefaultMinutes(delayMins);
<a name="l01581"></a>01581             <span class="comment">// Add the event back into the calendar file, retaining its ID</span>
<a name="l01582"></a>01582             <span class="comment">// and not updating KOrganizer</span>
<a name="l01583"></a>01583             KAlarm::addEvent(event, 0, mDeferDlg, <span class="keyword">true</span>, <span class="keyword">false</span>);
<a name="l01584"></a>01584             <span class="keywordflow">if</span> (event.<a class="code" href="classKAEvent.html#f115c56e32273686f3ec496dff1690c0">deferred</a>())
<a name="l01585"></a>01585                 mNoPostAction = <span class="keyword">true</span>;
<a name="l01586"></a>01586             <span class="keywordflow">if</span> (kcalEvent)
<a name="l01587"></a>01587             {
<a name="l01588"></a>01588                 <span class="keyword">event</span>.setUid(KAEvent::EXPIRED);
<a name="l01589"></a>01589                 KAlarm::deleteEvent(event, <span class="keyword">false</span>);
<a name="l01590"></a>01590             }
<a name="l01591"></a>01591         }
<a name="l01592"></a>01592         <span class="keywordflow">if</span> (theApp()-&gt;wantRunInSystemTray())
<a name="l01593"></a>01593         {
<a name="l01594"></a>01594             <span class="comment">// Alarms are to be displayed only if the system tray icon is running,</span>
<a name="l01595"></a>01595             <span class="comment">// so start it if necessary so that the deferred alarm will be shown.</span>
<a name="l01596"></a>01596             theApp()-&gt;displayTrayIcon(<span class="keyword">true</span>);
<a name="l01597"></a>01597         }
<a name="l01598"></a>01598         mNoCloseConfirm = <span class="keyword">true</span>;   <span class="comment">// allow window to close without confirmation prompt</span>
<a name="l01599"></a>01599         close();
<a name="l01600"></a>01600     }
<a name="l01601"></a>01601     <span class="keywordflow">else</span>
<a name="l01602"></a>01602         <span class="keyword">raise</span>();
<a name="l01603"></a>01603     <span class="keyword">delete</span> mDeferDlg;
<a name="l01604"></a>01604     mDeferDlg = 0;
<a name="l01605"></a>01605 }
<a name="l01606"></a>01606 
<a name="l01607"></a>01607 <span class="comment">/******************************************************************************</span>
<a name="l01608"></a>01608 <span class="comment">*  Called when the KAlarm icon button in the message window is clicked.</span>
<a name="l01609"></a>01609 <span class="comment">*  Displays the main window, with the appropriate alarm selected.</span>
<a name="l01610"></a>01610 <span class="comment">*/</span>
<a name="l01611"></a>01611 <span class="keywordtype">void</span> MessageWin::displayMainWindow()
<a name="l01612"></a>01612 {
<a name="l01613"></a>01613     KAlarm::displayMainWindowSelected(mEventID);
<a name="l01614"></a>01614 }
<a name="l01615"></a>01615 
<a name="l01616"></a>01616 <span class="comment">/******************************************************************************</span>
<a name="l01617"></a>01617 <span class="comment">* Check whether the specified error message is already displayed for this</span>
<a name="l01618"></a>01618 <span class="comment">* alarm, and note that it will now be displayed.</span>
<a name="l01619"></a>01619 <span class="comment">* Reply = true if message is already displayed.</span>
<a name="l01620"></a>01620 <span class="comment">*/</span>
<a name="l01621"></a>01621 <span class="keywordtype">bool</span> MessageWin::haveErrorMessage(<span class="keywordtype">unsigned</span> msg)<span class="keyword"> const</span>
<a name="l01622"></a>01622 <span class="keyword"></span>{
<a name="l01623"></a>01623     <span class="keywordflow">if</span> (!mErrorMessages.contains(mEventID))
<a name="l01624"></a>01624         mErrorMessages.insert(mEventID, 0);
<a name="l01625"></a>01625     <span class="keywordtype">bool</span> result = (mErrorMessages[mEventID] &amp; msg);
<a name="l01626"></a>01626     mErrorMessages[mEventID] |= msg;
<a name="l01627"></a>01627     <span class="keywordflow">return</span> result;
<a name="l01628"></a>01628 }
<a name="l01629"></a>01629 
<a name="l01630"></a>01630 <span class="keywordtype">void</span> MessageWin::clearErrorMessage(<span class="keywordtype">unsigned</span> msg)<span class="keyword"> const</span>
<a name="l01631"></a>01631 <span class="keyword"></span>{
<a name="l01632"></a>01632     <span class="keywordflow">if</span> (mErrorMessages.contains(mEventID))
<a name="l01633"></a>01633     {
<a name="l01634"></a>01634         <span class="keywordflow">if</span> (mErrorMessages[mEventID] == msg)
<a name="l01635"></a>01635             mErrorMessages.remove(mEventID);
<a name="l01636"></a>01636         <span class="keywordflow">else</span>
<a name="l01637"></a>01637             mErrorMessages[mEventID] &amp;= ~msg;
<a name="l01638"></a>01638     }
<a name="l01639"></a>01639 }
<a name="l01640"></a>01640 
<a name="l01641"></a>01641 
<a name="l01642"></a>01642 <span class="comment">/*=============================================================================</span>
<a name="l01643"></a>01643 <span class="comment">= Class MWMimeSourceFactory</span>
<a name="l01644"></a>01644 <span class="comment">* Gets the mime type of a text file from not only its extension (as per</span>
<a name="l01645"></a>01645 <span class="comment">* QMimeSourceFactory), but also from its contents. This allows the detection</span>
<a name="l01646"></a>01646 <span class="comment">* of plain text files without file name extensions.</span>
<a name="l01647"></a>01647 <span class="comment">=============================================================================*/</span>
<a name="l01648"></a>01648 MWMimeSourceFactory::MWMimeSourceFactory(<span class="keyword">const</span> QString&amp; absPath, KTextBrowser* view)
<a name="l01649"></a>01649     : QMimeSourceFactory(),
<a name="l01650"></a>01650       mMimeType(<span class="stringliteral">"text/plain"</span>),
<a name="l01651"></a>01651       mLast(0)
<a name="l01652"></a>01652 {
<a name="l01653"></a>01653     view-&gt;setMimeSourceFactory(<span class="keyword">this</span>);
<a name="l01654"></a>01654     QString type = KMimeType::findByPath(absPath)-&gt;name();
<a name="l01655"></a>01655     <span class="keywordflow">switch</span> (KAlarm::fileType(type))
<a name="l01656"></a>01656     {
<a name="l01657"></a>01657         <span class="keywordflow">case</span> KAlarm::TextPlain:
<a name="l01658"></a>01658         <span class="keywordflow">case</span> KAlarm::TextFormatted:
<a name="l01659"></a>01659             mMimeType = type.latin1();
<a name="l01660"></a>01660             <span class="comment">// fall through to 'TextApplication'</span>
<a name="l01661"></a>01661         <span class="keywordflow">case</span> KAlarm::TextApplication:
<a name="l01662"></a>01662         <span class="keywordflow">default</span>:
<a name="l01663"></a>01663             <span class="comment">// It's assumed to be a text file</span>
<a name="l01664"></a>01664             mTextFile = absPath;
<a name="l01665"></a>01665             view-&gt;QTextBrowser::setSource(absPath);
<a name="l01666"></a>01666             <span class="keywordflow">break</span>;
<a name="l01667"></a>01667 
<a name="l01668"></a>01668         <span class="keywordflow">case</span> KAlarm::Image:
<a name="l01669"></a>01669             <span class="comment">// It's an image file</span>
<a name="l01670"></a>01670             QString text = <span class="stringliteral">"&lt;img source=\""</span>;
<a name="l01671"></a>01671             text += absPath;
<a name="l01672"></a>01672             text += <span class="stringliteral">"\"&gt;"</span>;
<a name="l01673"></a>01673             view-&gt;setText(text);
<a name="l01674"></a>01674             <span class="keywordflow">break</span>;
<a name="l01675"></a>01675     }
<a name="l01676"></a>01676     setFilePath(QFileInfo(absPath).dirPath(<span class="keyword">true</span>));
<a name="l01677"></a>01677 }
<a name="l01678"></a>01678 
<a name="l01679"></a>01679 MWMimeSourceFactory::~MWMimeSourceFactory()
<a name="l01680"></a>01680 {
<a name="l01681"></a>01681     <span class="keyword">delete</span> mLast;
<a name="l01682"></a>01682 }
<a name="l01683"></a>01683 
<a name="l01684"></a>01684 <span class="keyword">const</span> QMimeSource* MWMimeSourceFactory::data(<span class="keyword">const</span> QString&amp; abs_name)<span class="keyword"> const</span>
<a name="l01685"></a>01685 <span class="keyword"></span>{
<a name="l01686"></a>01686     <span class="keywordflow">if</span> (abs_name == mTextFile)
<a name="l01687"></a>01687     {
<a name="l01688"></a>01688         QFileInfo fi(abs_name);
<a name="l01689"></a>01689         <span class="keywordflow">if</span> (fi.isReadable())
<a name="l01690"></a>01690         {
<a name="l01691"></a>01691             QFile f(abs_name);
<a name="l01692"></a>01692             <span class="keywordflow">if</span> (f.open(IO_ReadOnly)  &amp;&amp;  f.size())
<a name="l01693"></a>01693             {
<a name="l01694"></a>01694                 QByteArray ba(f.size());
<a name="l01695"></a>01695                 f.readBlock(ba.data(), ba.size());
<a name="l01696"></a>01696                 QStoredDrag* sr = <span class="keyword">new</span> QStoredDrag(mMimeType);
<a name="l01697"></a>01697                 sr-&gt;setEncodedData(ba);
<a name="l01698"></a>01698                 <span class="keyword">delete</span> mLast;
<a name="l01699"></a>01699                 mLast = sr;
<a name="l01700"></a>01700                 <span class="keywordflow">return</span> sr;
<a name="l01701"></a>01701             }
<a name="l01702"></a>01702         }
<a name="l01703"></a>01703     }
<a name="l01704"></a>01704     <span class="keywordflow">return</span> QMimeSourceFactory::data(abs_name);
<a name="l01705"></a>01705 }
</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>&nbsp;&nbsp;<a href="../../akregator/src/html/index.html">src</a></li><li>&nbsp;&nbsp;&nbsp;&nbsp;<a href="../../akregator/src/librss/html/index.html">librss</a></li><li><a href="../../certmanager/html/index.html">certmanager</a></li><li>&nbsp;&nbsp;<a href="../../certmanager/lib/html/index.html">lib</a></li><li><a href="../../kaddressbook/html/index.html">kaddressbook</a></li><li><a href="../../kalarm/html/index.html">kalarm</a></li><li>&nbsp;&nbsp;<a href="../../kalarm/lib/html/index.html">lib</a></li><li><a href="../../kandy/html/index.html">kandy</a></li><li><a href="../../karm/html/index.html">karm</a></li><li><a href="../../kdgantt/html/index.html">kdgantt</a></li><li><a href="../../kgantt/html/index.html">kgantt</a></li><li><a href="../../kioslaves/html/index.html">kioslaves</a></li><li>&nbsp;&nbsp;<a href="../../kioslaves/imap4/html/index.html">imap4</a></li><li>&nbsp;&nbsp;<a href="../../kioslaves/mbox/html/index.html">mbox</a></li><li><a href="../../kitchensync/html/index.html">kitchensync</a></li><li><a href="../../kmail/html/index.html">kmail</a></li><li><a href="../../knotes/html/index.html">knotes</a></li><li><a href="../../konsolekalendar/html/index.html">konsolekalendar</a></li><li><a href="../../kontact/html/index.html">kontact</a></li><li><a href="../../korganizer/html/index.html">korganizer</a></li><li><a href="../../kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../kpilot/kpilot/html/index.html">kpilot</a></li><li>&nbsp;&nbsp;<a href="../../kpilot/lib/html/index.html">lib</a></li><li><a href="../../libemailfunctions/html/index.html">libemailfunctions</a></li><li><a href="../../libkcal/html/index.html">libkcal</a></li><li><a href="../../libkdepim/html/index.html">libkdepim</a></li><li><a href="../../libkholidays/html/index.html">libkholidays</a></li><li><a href="../../libkmime/html/index.html">libkmime</a></li><li><a href="../../libkpgp/html/index.html">libkpgp</a></li><li><a href="../../libkpimidentities/html/index.html">libkpimidentities</a></li>
</ul></div></div>


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

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


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

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

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

</body>
</html>