summaryrefslogtreecommitdiffstats
path: root/kalarm/functions.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 (patch)
tree67208f7c145782a7e90b123b982ca78d88cc2c87 /kalarm/functions.h
downloadtdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.tar.gz
tdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kalarm/functions.h')
-rw-r--r--kalarm/functions.h130
1 files changed, 130 insertions, 0 deletions
diff --git a/kalarm/functions.h b/kalarm/functions.h
new file mode 100644
index 000000000..c5337cc48
--- /dev/null
+++ b/kalarm/functions.h
@@ -0,0 +1,130 @@
+/*
+ * functions.h - miscellaneous functions
+ * Program: kalarm
+ * Copyright © 2004-2006,2009 by David Jarvie <djarvie@kde.org>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ */
+
+#ifndef FUNCTIONS_H
+#define FUNCTIONS_H
+
+/** @file functions.h - miscellaneous functions */
+
+#include <qsize.h>
+#include <qstring.h>
+
+#include "alarmevent.h"
+
+class QObject;
+class QWidget;
+class QString;
+class KAction;
+class KActionCollection;
+namespace KCal { class Event; }
+class KAEvent;
+class MainWindow;
+class AlarmListView;
+class TemplateListView;
+class TemplateMenuAction;
+
+namespace KAlarm
+{
+
+/** Return codes from fileType() */
+enum FileType { Unknown, TextPlain, TextFormatted, TextApplication, Image };
+/** Return codes from calendar update functions.
+ * The codes are ordered by severity.
+ */
+enum UpdateStatus {
+ UPDATE_OK, // update succeeded
+ UPDATE_KORG_ERR, // update succeeded, but KOrganizer update failed
+ UPDATE_ERROR, // update failed partially
+ UPDATE_FAILED, // update failed completely
+ SAVE_FAILED // calendar was updated in memory, but save failed
+};
+/** Error codes supplied as parameter to displayUpdateError() */
+enum UpdateError { ERR_ADD, ERR_DELETE, ERR_REACTIVATE, ERR_TEMPLATE };
+/** Error codes supplied as parameter to displayKOrgUpdateError() */
+enum KOrgUpdateError { KORG_ERR_ADD, KORG_ERR_MODIFY, KORG_ERR_DELETE };
+
+
+/** Display a main window with the specified event selected */
+MainWindow* displayMainWindowSelected(const QString& eventID = QString::null);
+bool readConfigWindowSize(const char* window, QSize&);
+void writeConfigWindowSize(const char* window, const QSize&);
+/** Check from its mime type whether a file appears to be a text or image file.
+ * If a text file, its type is distinguished.
+ */
+FileType fileType(const QString& mimetype);
+/** Return current KAlarm version number */
+int Version();
+inline int Version(int major, int minor, int rev) { return major*10000 + minor*100 + rev; }
+int getVersionNumber(const QString& version, QString* subVersion = 0);
+/** Return which version of KAlarm was the first to use the current calendar/event format */
+inline int currentCalendarVersion() { return KAEvent::calVersion(); }
+inline QString currentCalendarVersionString() { return KAEvent::calVersionString(); }
+QString browseFile(const QString& caption, QString& defaultDir, const QString& initialFile = QString::null,
+ const QString& filter = QString::null, int mode = 0, QWidget* parent = 0, const char* name = 0);
+bool edit(const QString& eventID);
+bool editNew(const QString& templateName = QString::null);
+/** Create a "New Alarm" KAction */
+KAction* createNewAlarmAction(const QString& label, QObject* receiver, const char* slot, KActionCollection*, const char* name);
+/** Create a "New From Template" KAction */
+TemplateMenuAction* createNewFromTemplateAction(const QString& label, QObject* receiver, const char* slot, KActionCollection*, const char* name);
+/** Returns a list of all alarm templates.
+ * If shell commands are disabled, command alarm templates are omitted.
+ */
+QValueList<KAEvent> templateList();
+void outputAlarmWarnings(QWidget* parent, const KAEvent* = 0);
+void resetDaemon();
+void resetDaemonIfQueued(); // must only be called from KAlarmApp::processQueue()
+QString runKMail(bool minimise);
+bool runProgram(const QCString& program, const QCString& windowName, QCString& dcopName, QString& errorMessage);
+
+UpdateStatus addEvent(KAEvent&, AlarmListView* selectionView, QWidget* errmsgParent = 0, bool useEventID = false, bool allowKOrgUpdate = true);
+bool addExpiredEvent(KAEvent&);
+UpdateStatus addTemplate(KAEvent&, TemplateListView* selectionView, QWidget* errmsgParent = 0);
+UpdateStatus modifyEvent(KAEvent& oldEvent, const KAEvent& newEvent, AlarmListView* selectionView, QWidget* errmsgParent = 0);
+UpdateStatus updateEvent(KAEvent&, AlarmListView* selectionView, QWidget* errmsgParent = 0, bool archiveOnDelete = true, bool incRevision = true);
+UpdateStatus updateTemplate(const KAEvent&, TemplateListView* selectionView, QWidget* errmsgParent = 0);
+UpdateStatus deleteEvent(KAEvent&, bool archive = true, QWidget* errmsgParent = 0);
+UpdateStatus deleteTemplate(const KAEvent&);
+void deleteDisplayEvent(const QString& eventID);
+UpdateStatus reactivateEvent(KAEvent&, AlarmListView* selectionView, bool useEventID = false);
+UpdateStatus enableEvent(KAEvent&, AlarmListView* selectionView, bool enable);
+void displayUpdateError(QWidget* parent, UpdateStatus, UpdateError, int nAlarms);
+void displayKOrgUpdateError(QWidget* parent, KOrgUpdateError, int nAlarms);
+
+void cancelScreenSaver();
+QString stripAccel(const QString&);
+
+int localeFirstDayOfWeek();
+
+/* Given a standard KDE day number, return the day number in the week for the user's locale.
+ * Standard day number = 1 (Mon) .. 7 (Sun)
+ * Locale day number in week = 0 .. 6
+ */
+inline int weekDay_to_localeDayInWeek(int weekDay) { return (weekDay + 7 - localeFirstDayOfWeek()) % 7; }
+
+/* Given a day number in the week for the user's locale, return the standard KDE day number.
+ * 'index' = 0 .. 6
+ * Standard day number = 1 (Mon) .. 7 (Sun)
+ */
+inline int localeDayInWeek_to_weekDay(int index) { return (index + localeFirstDayOfWeek() - 1) % 7 + 1; }
+
+} // namespace KAlarm
+
+#endif // FUNCTIONS_H