# Das Handbuch zu &kalarm;

David Jarvie

    software@astrojar.org.uk

Frank Schütte

    f.schuette@t-online.de

Deutsche Übersetzung
2001 2002 2003 David Jarvie
&FDLNotice;
2003-01-13
0.09.01

KDE kdepim kalarm Alarm Erinnerung

## Einleitung

Alarme können auch über eine Befehlszeile oder von anderen Programmen via &DCOP; eingegeben werden.

Wenn eine Alarmzeit erreicht ist, wird die Alarmnachricht auf jeder &kde;-Arbeitsfläche angezeigt, damit sie nicht beim Umschalten zwischen den Arbeitsflächen übersehen werden kann. Die festgelegt Alarmzeit wird mit angezeigt. Das ist nützlich, falls die Nachricht zu spät angezeigt wird oder man selbst einige Zeit nicht am Rechner gewesen ist. Standardmäßig hat die Nachricht eine Option zum Verschieben der Anzeige auf einen späteren Zeitpunkt. Im Folgenden wird ein Beispiel einer Nachricht gezeigt:

Bilschirmphoto eines &kalarm; Nachrichtenfensters
Alarm-Nachricht

&kalarm; kann in zwei verschiedenen Modi betrieben werden: ständig (der Standardwert) in der &kde;-Kontrollleiste oder auf Anforderung von Fall zu Fall gestartet (mit der Option, ein unabhängiges Symbol in der Kontrollleiste anzuzeigen).

Dieses Handbuch bezieht sich mehrfach auf den Alarmdämon. Dieses Programm ist im Hintergrund aktiv, überwacht festgelegt Alarmzeiten und veranlasst &kalarm;, zum entsprechenden Zeitpunkt Nachrichten anzuzeigen.

## Verwendung von &kalarm;

### Graphischer Modus

Falls beim Start von &kalarm; im graphischen Modus der Alarmdämon nicht aktiv ist, wird er durch &kalarm; gestartet.

####

Bilschirmphoto des &kalarm; Hauptfensters
Hauptfenster

Die Liste der Alarme kann durch Klicken auf die entsprechende Titelleiste nach der gewünschten Spalte geordnet werden. Um die Sortierung umzukehren, klickt man ein zweites Mal auf der Spaltentitel.

#### Einen neuen Alarm hinzufügen

Um eine neue Alarmnachricht hinzuzufügen, wählt man Aktionen Neu aus dem Menü. Dadurch wird das Bearbeitungsfenster angezeigt:

#### Einen Alarm ändern

- Man klickt doppelt auf den Eintrag in der Alarmliste.

- Man wählt den Alarm durch Klicken in die Alarmliste aus. Dann wählt man Aktionen Ändern....

- Man klickt mit der rechten Maustaste auf den gewünschten Eintrag und wählt im Kontextmenü Ändern.

Es wird das Nachrichtenbearbeitungsfenster geöffnet.

Bildschirmphoto des Alarmbearbeitungsdialogs
Alarmbearbeitungsdialog

- - Das Ankreuzfeld Bei Bestätigungen nachfragen steuert, ob man beim Schließen einer Alarmnachricht um Bestätigung gebeten wird. Das dient als Sicherung gegen versehentlich geschlossene Alarmnachrichten.

  - Wählt man das Ankreuzfeld Klänge, so wird ein akustisches Signal zusammen mit der Alarmnachricht ertönen. Standardmäßig handelt es sich um einen Piepton, es kann aber auch eine Audiodatei zur Wiedergabe ausgewählt werden. Um zu einem Piepton zurückzukehren, muss man erneut auf den Knopf klicken. Um die aktuellen Klangeinstellungen zu sehen, muss man lediglich den Mauszeiger auf den Knopf bewegen, bis ein Kurzinfo erscheint.

  - Hier kann man die Hintergrundfarbe des Nachrichtenfensters einstellen.

Falls es sich beim Alarm um einen wiederkehrenden Alarm handelt, der bei seinem letzten Auftreten verschoben wurde, zeigt das Listenfeld Verschobene Termin-Erinnerungen die verschobene Alarmzeit an. Mit Hilfe von Ändern... kann man die verschobene Zeit ändern oder die Verschiebung aufheben.

Im Listenfeld Zeit kann man Verschiedenes auswählen:

- Zeitpunkt, um Datum und Zeit einzutragen, zu der der Alarm ausgelöst werden soll. Falls man lediglich ein Datum festlegen will, sollte man noch das Ankreuzfeld Keine Zeit festgelegt markieren. Der Alarm wird dann bei der ersten Gelegenheit nach dem eingestellten Tagesbeginn ausgelöst. (Die Einrichtung des Tagesbeginns wird beschrieben unter Einrichtung der Standardoptionen.)

- Zeit ab jetzt, um einzutragen nach welchem Zeitintervall vom Augenblick (in Stunden und Minuten) der Alarm ausgelöst werden soll.

Ob und wie der Alarm wiederholgt werden soll, wird im Abschnitt Wiederholung festgelegt.

- Um den Alarm nur einmal auszulösen, wählt man Keine Wiederholung.

- Man wählt Wiederholung beim Anmelden, um den Alarm bei jeder Anmeldung bis zum festgelegten Zeitpunkt zu wiederholen. (Ein solcher Alarm wird auch jedesmal dann ausgelöst, wenn man Alarme aktivert oder den Alarmdämon neustartet.)

- Man wählt Wiederholen, um den Alarm in regelmäßigen Intervallen zu wiederholen. Man muss die Wiederholungsparameter auf der Karteikarte Wiederholen festlegen.

  Im Abschnitt Wiederholungsregeln kann man die Wiederholungszeit festlegen, indem man eine der Zeitintervalltypen auswählt und in dem Feld Wiederholung alle: angibt, wie viele der gewählten Zeitperioden zwischen dem Auftreten des Alarms verstreichen sollen. Um zum Beispiel einen Alarm alle 14 Tage zu haben, kann man entweder Täglich auswählen und 14 eintragen oder Wöchentlich auswählen und 2 eintragen. Abhängig von der gewählten Zeitperiode gibt es weitere Optionen:

  - Bei einer wöchentlichen Wiederholung kann man einstellen, an welchen Tagen der Woche der Alarm auftreten soll.

  - Bei einer monatlichen Wiederholung kann man entweder ein festes Datum oder eine Position (&zb; der zweite Dienstag) angeben.

  - Bei einer jährlichen Wiederholung kann man entweder ein festes Datum im Jahr oder eine feste Position in einem Monat (&zb; der letzte Samstag im Mai) angeben.

  Im Abschnitt Ende der Wiederholung wird die gesamte Zeitspanne, über die eine Wiederholung erfolgen soll, angegeben:

  - Man wählt Kein Ende für nicht endende Wiederholungen.

  - Man wählt Ende nach:, um die Gesamtanzahl von Alarmen anzugeben.

  - Man wählt Ende durch:, um einen festen Zeitpunkt anzugeben, zu dem die Wiederholung enden soll.

Im Ankreuzfeld Bei Verspätung abbrechen kann man festlegen, was mit einer Alarmnachricht passiert, die nicht zum festgesetzten Zeitpunkt angezeigt werden kann. Markiert man dieses Feld, so wird die Alarmnachricht verworfen, falls sie nicht spätestens 1 Minute nach dem festgesetzten Zeitpunkt angezeigt werden kann. Um die Nachricht bei erster Gelegenheit nach dem festgesetzten Zeitpunkt anzeigen zu lassen, muss man dieses Ankreuzfeld deaktivieren. Bei Alarmen, für die nur ein Datum festgelegt wurde, also bei gewählter Option Keine festgelegte Zeit, wird der Alarm nur verworfen, falls er nicht innerhalb von 24 Stunden nach Tagesbeginn angezeigt werden kann.

Eine Alarmnachricht kann nur dann angezeigt werden, wenn man angemeldet ist und sowohl X als auch der Alarmdämon aktiv sind.

Durch Klicken auf OK wird der Alarm zur Liste der festgelegten Alarme hinzugefügt.

####

Einen Alarm kann man auf folgende Arten entfernen:

- Man klickt auf den gewünschten Eintrag in der Alarmliste. Dann wählt man im Menü Aktionen Löschen.

- Man klickt mit der rechten Maustaste auf den gewünschten Listeneintrag und wählt im Kontextmenü Löschen.

####

#### Eine Alarm bestätigen

Zur Bestätigung von Alarmen siehe unter Alarmnachrichtendialog.

####

#### &kalarm; in der Kontrollleiste anzeigen

Um &kalarm; in der Kontrollleiste anzeigen zu lassen, muss die &kde;-Arbeitsoberfläche aktiv sein. Falls &kalarm; ständig läuft, wird das Symbol in der Kontrollleiste immer angezeigt. Die folgenden Instruktionen gelten nur für den Bei Bedarf-Modus. (Siehe auch Standardeinstellungen für eine Beschreibung der Modi.)

Um &kalarm; in der &kde;-Kontrollleiste anzeigen zu lassen, wählt man im Menü Ansicht Im Systemtablett anzeigen.

&kalarm; kann auf folgende Arten wieder aus der Kontrollleiste entfernt werden:

- Man wählt im Menü Ansicht Aus dem Systemtablett entfernen.

- Man klickt mit der rechten Maustaste auf das Symbol in der Kontrollleiste und wählt aus dem Kontextmenü Beenden.

Die Verwendung des Symbols in der Kontrollleiste wird weiter unten beschrieben.

#### Erinnerungsfunktion aktivieren/deaktivieren

##### Aktivieren der Erinnerungsfunktion

Falls &kalarm; sich im ständigen Modus befindet und man Alarme nur bei laufendem Programm aktiv im Einrichtungsdialog ausgewählt hat, muss man sicherstellen, dass &kalarm; läuft, damit die Erinnerungsfunktion aktiv ist.

Wenn die Erinnerungsfunktion deaktiviert ist, kann man folgendes zur Aktivierung tun:

- Man wählt im Menü Aktionen Erinnerungsfunktion aktiviert.

- Man klickt mit der rechten Maustaste auf das Symbol in der Kontrollleiste und wählt im Kontextmenü Erinnerungsfunktion aktiviert.

Dadurch wird der Alarmdämon gestartet und von nun an wird die Liste der festgelegten Alarme überwacht.

Der Start des Alarmdämon hat einen Einfluss auf alle anderen Programme, die den Alarmdämon verwenden.

##### Erinnerungsfunktion deaktivieren

Die Überwachung von Alarmen kann auf verschiedene Arten deaktiviert werden. Dadurch wird &kalarm; bis zur Reaktivierung daran gehindert, weitere Alarmnachrichten anzuzeigen, oder - falls der Alarmdämon beim Anmelden gestartet wird - bis zur nächsten Anmeldung.

Um Alarme zu deaktiviern, ohne den Alarmdämon zu stoppen (das Stoppen des Alarmdämon hat einen Einfluss auf alle anderen Programme, die den Alarmdämon verwenden), kann man eine der folgenden Möglichkeiten nutzen:

- Man wählt im Menü Aktionen Erinnerungsfunktion aktiviert.

- Man klickt mit der rechten Maustaste auf das Symbol in der Kontrollleiste und wählt im Kontextmenü Erinnerungsfunktion aktiviert.

- Falls &kalarm;s Modus ständig ist und man Alarme nur bei laufendem Programm aktiv gewählt hat, kann man einfach &kalarm; beenden.

Deaktivierung von Alarmen durch Stoppen des Alarmdämons:

- Man wählt Einstellungen Alarmdämon einrichten... Es wird der Dialog Service-Verwaltung angezeigt, der die Möglichkeit zum Starten und Stoppen des Alarmdämons bietet.

Dadurch werden alle anderen Programme beeinflusst, die den Alarmdämon verwenden.

#### Erinnerungsdaten zurücksetzen

Falls das Ereignis eintritt, dass der Alarm nicht ausgelöst wurde, obwohl der Zeitpunkt da ist, kann man die Alarmliste erneuern und alle fehlenden Alarme auslösen, indem manAktionen Erinnerungsdaten zurücksetzen auswählt.

Beim zurücksetzen des Alarmdämons löst &kalarm; alle fehlenden Alarme neu aus. Das wird im Abschnitt Alarmdämon genauer erklärt.

#### Den Alarmdämon steuern

Um den Alarmdämon einzurichten, wählt man im Menü Einstellungen Alarmdämon kontrollieren.... Die Service-Verwaltung, die es ermöglicht, den Alarmdämon zu starten und zu stoppen, wird angezeigt. Außerdem kann hier festgelegt werden, ob er automatisch beim Anmelden gestartet wird. Siehe auch Steuerung des Alarmdämons mit der Service-Verwaltung.

#### Beenden des Programms

Man beendet &kalarm;, in dem man alle Fenster und das Kontrollleistensymbol schließt. Falls das Programm im ständigen Modus ausgeführt wird, dagegen indem man alle Nachrichtenfenster schließt und im Kontextmenü des Kontrollleistensymbols Beenden auswählt.

Der Menüeintrag Datei Beenden schließt nur das aktuelle Fenster. Die Auswirkung des Kontextmenüeintrags Beenden beim Kontrollleistensymbol hängt vom Programm-Modus ab: im Modus Bei Bedarf wird das Kontrollleistensymbol versteckt, im Modus ständig wird das Programm beendet.

### Alarm-Nachricht

Bei einem wiederholten Alarm, falls also ein Bestätigungsfenster von einem früheren Auftreten noch geöffnet ist, wird das existierende Fenster lediglich nach vorn geschoben, wenn der Alarm wiederholt wird. Damit wird verhindert, dass man mehrere Fenster zur gleichen Alarmnachricht schließen muss.

Wenn eine Alarmnachricht angezeigt wird, hat man folgende Möglichkeiten:

- Man bestätigt durch Klicken auf den Knopf Schließen. Damit wird das Fenster geschlossen (nach einer Nachfrage, falls man das unter Bei Bestätigung nachfragen so eingestellt hat).

- Man klickt auf Verschieben..., um die Optionen zur Verschiebung anzeigen zu lassen. Dann wählt man Verschieben auf Zeitpunkt, um Datum und Uhrzeit des neuen Zeitpunktes eingeben zu können, oder man wählt Verschieben um Zeitintervall:, um das Zeitintervall vom jetzigen Zeitpunkt (in Stunden und Minuten) einzugeben, um das der Alarm verschoeben werden soll. Dann klickt man auf Verschieben, um die Verschiebung durchführen zu lassen.

  Der Knopf Verschieben... ist nicht verfügbar für Alarmnachrichten, die wegen der Option Wiederholung beim Anmelden bei der Anmeldung angezeigt werden.

Der Knopf mit dem Symbol &kalarm; ist zur bequemen Aktivierung von &kalarm; vorhanden. Klicken hat keinen Effekt auf das Alarmnachrichtenfenster.

### Kontrollleistensymbol

&kalarm; kann als Symbol in der &kde;-Kontrollleiste ausgeführt werden. Dieses Symbol erlaubt die Aktivierung von &kalarm; mit einem Mausklick und bietet sowohl eine Kontrolle als auch eine Statusanzeige für die Erinnerungsfunktion. Das normale &kalarm;-Symbol zeigt an, dass die Erinnerungsfunktion aktiv ist, während ein rot durchgekreuztes Symbol die Deaktivierung der Erinnerungsfunktion anzeigt.

Man klickt mit der linken Maustaste auf das Kontrollleistensymbol, um das &kalarm;-Hauptfenster ein- und auszublenden.

Man klickt mit der rechten Maustaste auf das Kontrollleitsensymbol, um das Kontextmenü aufzurufen.

Alarme aktivieren

  Die Überwachung von Alarmen aktivieren.

  Siehe auch Deaktivieren/Aktivieren der Alarm-Überwachung.

Alarme aktiviert

  Deaktiviert die Überwachung von Alarmen.

  Siehe auch Deaktivieren/Aktivieren der Alarm-Überwachung.

&kalarm; einrichten...

  Zeigt den Einrichtungsdialog von &kalarm; an.

  Der Einrichtungsdialog wird unter Standardeinstellungen ändern beschrieben. Er enthält auch Einstellmöglichkeiten für das &kalarm;-Kontrollleistensymbol.

Kontrolle der Erinnerungsfunktion...

  Zeigt den Dialog Service-Verwaltung an, der die Steuerung des Alarmdämons ermöglicht.

  Siehe auch Den Alarmdämon über die Service-Verwaltung steuern.

Wiederherstellen / Minimieren

  Stellt das Hauptfenster von &kalarm; wieder her bzw. minimiert es.

  Diese Einstellung ist nur im Modus 'ständig' verfügbar. (Eine Erläuterung der Programm-Modi findet man unter Standardeinstellungen verändern.)

Beenden

  Schließt das &kalarm;-Kontrollleistensymbol.

### Standardeinstellungen

Um die Standardeinstellungen für &kalarm; festzulegen, wählt man im Menü Einstellungen &kalarm; einrichten.... Auf der Karteikarte Allgemein des angezeigten Einrichtungsdialogs kann man das Verhalten von &kalarm; einrichten:

- Man legt den Standardzeichensatz und die Hintergrundfarbe für die Anzeige von Alarmnachrichten fest.

- Den Piepton als Standardoption für Klänge festlegen.

- Die Standardzeitperiode für wiederkehrende Alarme festlegen.

### Befehlszeilenoptionen

Wenn Befehlszeilenoptionen angegeben wurden, zeigt &kalarm; nicht die unter Graphischer Modus beschriebene Liste der festgesetzten Alarme an. Für folgende Aktionen von &kalarm; gibt es Befehlszeilenoptionen:

- Eine neue Alarmnachricht festlegen

- Den Alarmdämon steuern

- &kalarm;s Anzeigemodus steuern

- Hilfe anfordern

Weitere Befehlszeilenoptionen dienen in erster Linie der Zusammenarbeit von anderen Programmen mit &kalarm;. Sie werden im Kapitel Entwicklungshandbuch zu &kalarm; beschrieben.

Die Befehlszeile darf nur Optionen für eine &kalarm;-Aktion enthalten. Falls man mehrere Aktionen durchführen will, muss man &kalarm; mehrfach mit jeweils einer Aktion aufrufen.

#### Eine neue Alarmnachricht festlegen

Die folgenden Optionen werden zur Festlegung einer neuen Alarmnachricht verwendet:

Option | Beschreibung
--- | ---
`-a`, `--ack-confirm` | Nachfragen, falls die Alarmnachricht bestätigt wird.
`-b`, `--beep` | Einen hörbaren Piepton ausgeben, wenn die Nachricht angezeigt wird. Dazu muss die Option `--sound` nicht ausgewählt werden.
`` |
`-c`, `--color`, `--colour Farbe` | Setzt die Hintergrundfarbe mit einem in &Qt; festgelegten Farbnamen oder durch die hexadezimale Kennnummer der Form 0xRRGGBB.
`-e`, `--exec Befehlzeile` |
`-f`, `--file URL` |
`-i`, `--interval Periode` | Legt das Intervall zwischen Wiederholungen des Alarms fest. Stunden/Minuten müssen im angegebenen Format nHnM sein, wobei n jeweils für eine Zahl, &zb; 3H30M, steht. Andere Zeitperioden können im Format nX, wobei n für eine Zahl steht und X einer der Buchstaben Y (Jahre), M (Monate), W (Wochen), D (Tage) ist. Das ist zwingend, falls die Option `--repeat` oder `--until` angegeben sind.
`-l`, `--late-cancel` | Die Nachricht wird verworfen, falls sie nicht rechtzeitig angezeigt werden kann.
`-L`, `--login` | Der Alarm wird bei jedem Anmelden ausgelöst. Die Optionen `--interval`, `--repeat` und `--until` können hiermit nicht verwendet werden.
`-r`, `--repeat Anzahl` |
`-s`, `--sound URL` | Legt den Namen oder die &URL; einer Textdatei fest, deren Inhalt in der Alarmnachricht angezeigt wird. `--beep` darf nicht zusammen mit dieser Option verwendet werden.
`-t`, `--time Datum/Zeit` | Löst den Alarm am angegebenen Datum oder zum angegebenen Zeitpunkt aus. Man gibt entweder ein Datum ohne Zeit im Format jjjj-mm-dd an oder gibt Datum und Zeit im Format [[[jjjj-]mm-]dd-]hh:mm an (fehlende Angaben werden auf den heutigen Tag gesetzt).
`-u`, `--until Datum/Zeit` | Wiederholt den Alarm bis zum angegebenen Zeitpunkt. Man kann entweder ein Datum ohne Zeit oder einen kompletten Zeitpunkt wie unter `--time` beschrieben angeben. `--interval` muss vorhanden sein, `--repeat` darf nicht vorhanden sein.
Nachricht |

Es muss entweder ein Nachrichtentext oder die Option `--file` oder `--exec` angegeben werden. Alle anderen Optionen sind nicht zwingend notwendig.

Es werden zwei Beispiele für die Anzeige einer mehrzeiligen Nachricht mit rotem Hintergrund um 22:00 am 27. des aktuellen Monats angegeben:

    % kalarm -c red -t 27-22:00 "Denke daran,\nanzhalten"
    % kalarm -c 0xFF0000 -t 27-22:00 "Denke daran,\nanzuhalten"

#### Andere Optionen

Die folgenden Optionen werden verwendet, um den Alarmdämon anzuhalten oder zu starten, oder die Anzeige von &kalarm; zu steuern.

Im Abschnitt Alarmdämon werden die Auswirkungen eines Alarmdämon-Neustarts beschrieben.

Option | Beschreibung
--- | ---
`--reset` | Startet den Alarmdämon neu.
`--stop` | Hält den Alarmdämon an.
`--tray` | Zeigt &kalarm; als Symbol in der &kde;-Kontrollleiste an.

Ein Beispiel zum Neustart des Alarmdämons:

    % kalarm --reset

#### Hilfeoptionen

Die folgenden Optionen sind allen &kde;-Programmen gemeinsam:

Option | Beschreibung
--- | ---
`--help` | Zeigt einen kurzen Hilfetext zu den Optionen.
`--help-qt` | Zeit verschiedene &Qt;-spezifische Optionen an.
`--help-kde` | Zeigt verschiedene &kde;-spezifische Optionen an.
`--help-all` | Zeigt alle Optionen an.
`--author` | Zeigt Namen und Adressen der Autoren von &kalarm;.
`-v`, `--version` | Zeigt die Versionen der &Qt;-Bibliothek, von &kde; und von &kalarm;.
`--license` | Zeigt Lizenzbestimmungen an.

### Alarmdämon

Der Alarmdämon, &kalarmd;, überwacht die Kalenderdatei von &kalarm;. Wenn eine festgesetzte Alarmzeit erreicht ist, veranlasst er &kalarm;, eine Alarmnachricht anzuzeigen oder die Nachricht zu verwerfen, falls die Alarmzeit abgelaufen und die Option zur Anzeige der abgelaufenen Nachricht nicht ausgewählt wurde.

Unter &kde; 3 kann der Alarmdämon auch von anderen Programmen, z.B. KOrganizer, verwendet werden.

Dadurch wird der Alarmdämon im Hintergrund ohne Benutzeroberfläche gestartet. Er wird wie weiter unten beschrieben gesteuert.

#### Starten, neustarten und stoppen des Alarmdämons

Der Alarmdämon wird üblicherweise bei der Anmeldung an &kde; gestartet (falls man nicht den Autostart im Dialog Service-Verwaltung abgeschaltet hat) und läuft ständig bis zur Abmeldung. Falls aus irgend einem Grund der Dämon nicht aktiv ist, werden die festgelegten Alarme nicht überwacht und &kalarm; zeigt keine Alarmnachrichten an.

##### Den Alarmdämon starten

Um den Alarmdämon zu starten kann man entweder &kalarm; im graphischen Modus starten (also ohne irgendwelche Befehlszeilenoptionen), Alarme mit Hilfe von &kalarm;s Kontrollleistensymbolmenü aktivieren, den Dämon nach der weiter unten gegebenen Beschreibung neu starten, man kann den Alarmdämon im Dialog Service-Verwaltung starten (siehe auch Steuerung des Alarmdämons über die Service-Verwaltung), oder man kann den Alarmdämon direkt von der Befehlszeile starten.

    % kalarmd

##### Neustarten des Alarmdämons

Es ist möglich, den Alarmdämon neu zu starten, ohne ihn vorher anzuhalten. Der Neustart veranlasst den Alarmdämon, die Liste der festgesetzten Alarme aus der Kalenderdatei neu einzulesen und die Daten von &kalarm; neu zu initialisieren.

Warum sollte man den Alarmdämon neu starten? Es ist nicht wahrscheinlich, aber es kann passieren, das &kalarm; zum Zeitpunkt, als eine Nachricht angezeigt werden sollte, nicht gestartet werden konnte. Dadurch wird diese Nachricht nicht angezeigt, solange der Alarmdämon nicht neu gestartet wird. Der Neustart des Alarmdämons ist besser als das Anhalten und anschließende neustarten, da den Alarmdämon verwendende Programme davon nicht betroffen sind.

Neustarten startet den Alarmdämon, falls er bisher nocht nicht lief.

Um den Alarmdämon neu zu starten, kann man entweder den Menübefehl Aktionen Dämon neustarten verwenden oder den folgenden Befehl eingeben:

    % kalarm --reset

##### Den Alarmdämon stoppen

Das Stoppen des Alarmdämons beendet jede Überwachung der Liste mit den festgelegten Alarmen bis der Dämon wieder gestartet wird.

Das Stoppen beeinträchtigt alle Programme, die den Alarmdämon verwenden. Stattdessen sollte man den Dämon neustarten.

Um den Alarmdämon neu zu starten, kann man entweder den Dialog Service-Verwaltung (siehe Steuerung des Alarmdämons über die Service-Verwaltung) verwenden oder den folgenden Befehl eingeben:

    % kalarm --stop

#### den Alarmdämon über die Service-Verwaltung steuern

Der Dialog Service-verwaltung erlaubt eine Einrichtung und Steuerung des Alarmdämons. Man kann:

- Festlegen, ober er automatisch beim Anmelden gestartet wird.

  Falls aus irgend einem Grund der Alarmdämon nicht aktiv ist, werden die festgelegten Alarme nicht überwacht und &kalarm; zeigt keine Alarmnachrichten an.

- Hält den Alarmdämon an.

  Das Starten oder Stoppen des Alarmdämon hat einen Einfluss auf alle anderen Programme, die den Alarmdämon verwenden.

Die Service-Verwaltung wird entweder über das Menü Einstellungen Kontrolle des Alarmdämons... oder über das Kontrollzentrum von &kde; aufgerufen.

## Entwicklerhandbuch zu &kalarm;(in englisch)

&kalarm; provides an interface to allow other applications to request the following functions:

- Eine neue Alarmnachricht festlegen

- auslösen oder abbrechen eines festgelegten Alarmes

- abbrechen eines bereits festgelegten Alarmes

- auslösen eines bereits festgelegten Alarmes

Each of the above functions is implemented both by a &DCOP; call and by the command line. &DCOP; calls should be used in preference if &kalarm; is already running.

### &DCOP; interface

cancelEvent
cancelEvent cancel an already scheduled alarm.

    void cancelEvent(const QString& calendarFile, const QString& eventID)

###### Parameters

calendarFile

  Specifies the &URL; of the calendar file containing the event to be cancelled.

eventID

  Specifies the unique ID of the event to be cancelled, as stored in calendarFile.

##### Beschreibung

`cancelEvent()` is a &DCOP; call to cancel the specified alarm. &kalarm; deletes the alarm from the calendar file without displaying or executing it.

The calendarFile parameter is only used for integrity checking: if the &URL; does not specify &kalarm;'s current default calendar file, the request will be ignored.

The old name for this function, `cancelMessage`, has been retained for compatibility, but all new applications should use `cancelEvent`.

triggerEvent
triggerEvent trigger an already scheduled alarm.

    void triggerEvent(const QString& calendarFile, const QString& eventID)

###### Parameters

calendarFile

  Specifies the &URL; of the calendar file containing the event to be triggered.

eventID

  Specifies the unique ID of the event to be triggered, as stored in calendarFile.

##### Beschreibung

`triggerEvent()` is a &DCOP; call to trigger the immediate display or execution of the specified alarm (regardless of what time it is scheduled for). &kalarm; retrieves the alarm from the calendar file and then displays or executes it.

If the alarm is already due, &kalarm; then deletes all scheduled occurrences of the alarm up to the current time, and if no repetitions of the alarm still remain, the alarm is deleted from the calendar file. If the alarm is not due yet, its scheduled occurrences are left unchanged.

The calendarFile parameter is only used for integrity checking: if the &URL; does not specify &kalarm;'s current default calendar file, the request will be ignored.

The old name for this function, `displayMessage`, has been retained for compatibility, but all new applications should use `triggerEvent`.

handleEvent
handleEvent trigger or cancel an already scheduled alarm.

    void handleEvent(const QString& calendarFile, const QString& eventID)

###### Parameters

calendarFile

  Specifies the &URL; of the calendar file containing the event to be displayed/executed or cancelled.

eventID

  Specifies the unique ID of the event to be displayed/executed or cancelled, as stored in calendarFile.

##### Beschreibung

`handleEvent()` is a &DCOP; call to display/execute or cancel the specified alarm. &kalarm; retrieves the alarm from the calendar file and then determines what action to take depending on when the alarm is due.

- If the alarm is not yet due, nothing happens.

The calendarFile parameter is only used for integrity checking: if the &URL; does not specify &kalarm;'s current default calendar file, the request will be ignored.

scheduleMessage
scheduleMessage schedule a new alarm message.

###### Parameters

Nachricht

  Specifies the text of the message to be scheduled.

dateTime

  Specifies the scheduled date and time at which the message should be displayed.

bg

  Specifies the background colour for displaying the message.

flags

  Specifies the logical OR of the desired alarm message flags. The flag bits are those defined in class KAlarmEvent in `msgevent.h`

audioURL

  Specifies the name or &URL; of an audio file which is to be played when the message is displayed.

Erinnerung

simpleRepeatType

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in `msgevent.h`.

interval

  Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm message.

repeatCount

  Specifies the number of times that the alarm message should be displayed. Specify -1 to repeat the alarm indefinitely.

##### Beschreibung

`scheduleMessage()` is a &DCOP; call to schedule the specified alarm message for display at the specified date and time. It has three forms: one for a non-repeating alarm, one for a repeating alarm with a repetition count, and one for a repeating alarm with an end time.

If the scheduled time (including any repetitions) has already passed, &kalarm; immediately displays the message or, if the LATE_CANCEL flag bit is set, ignores the request. If the scheduled time (or a repetition) is in the future, &kalarm; adds the alarm message to the calendar file for later display.

Use a code sequence similar to the following to set up the parameter data for the &DCOP; call to `scheduleMessage()` for a non-repeating alarm:

Use a code sequence similar to the following to set up the parameter data for the &DCOP; call to `scheduleMessage()` for a repeating alarm:

scheduleFile
scheduleFile schedule a new alarm which displays the contents of a text file.

###### Parameters

URL

  Specifies the name or &URL; of a text file whose contents are to be displayed in the message to be scheduled.

dateTime

  Specifies the scheduled date and time at which the file should be displayed.

bg

  Specifies the background colour for displaying the file.

flags

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAlarmEvent in `msgevent.h`

audioURL

  Specifies the name or &URL; of an audio file which is to be played when the message is displayed.

Erinnerung

simpleRepeatType

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in `msgevent.h`.

interval

  Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.

repeatCount

  Specifies the number of times that the file should be displayed. Specify -1 to repeat the alarm indefinitely.

##### Beschreibung

`scheduleFile()` is a &DCOP; call to schedule the specified text file for display at the specified date and time. Apart from specifying a file name or &URL;, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleCommand
scheduleCommand schedule a new alarm which executes a shell command.

    bool scheduleCommand(const QString& commandLine, const QDateTime& dateTime, int flags)

    bool scheduleCommand(const QString& commandLine, const QDateTime& dateTime, int flags, int simpleRepeatType, int interval, int repeatCount)

    bool scheduleCommand(const QString& commandLine, const QDateTime& dateTime, int flags, int simpleRepeatType, int interval, const QDateTime& endTime)

###### Parameters

commandLine

  Specifies the shell command line whose execution is to be scheduled.

dateTime

  Specifies the scheduled date and time at which the command should be executed.

flags

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAlarmEvent in `msgevent.h` except that the BEEP flag bit is ignored.

simpleRepeatType

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in `msgevent.h`.

interval

  Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.

repeatCount

  Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

##### Beschreibung

`scheduleCommand()` is a &DCOP; call to schedule the specified shell command line for execution at the specified date and time. Apart from specifying a command line and omitting the message colour and audio file parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleEmail
scheduleEmail schedule a new alarm which sends an email.

###### Parameters

Nachricht

dateTime

flags

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class KAlarmEvent in `msgevent.h`

simpleRepeatType

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. These are defined in class KAlarmEvent in `msgevent.h`.

interval

  Specifies the number of periods (minutes/days/weeks/months/years) between repetitions of the alarm.

repeatCount

##### Beschreibung

### Command line interface

Command line options are provided to enable other programs (such as the alarm daemon) to start up &kalarm; if it is not already running, in order to trigger or cancel scheduled alarms, or schedule new alarms. The reason for using command line options for this purpose is that if &kalarm; were started without any command line parameters and then sent &DCOP; requests, it would start in its default graphical mode, which is clearly undesirable for an inter-program request.

Programs should first check whether &kalarm; is already running; if it is, they should instead use &DCOP; calls to request these operations.

The command line options for scheduling a new alarm are as described in the chapter Using &kalarm;. The options for triggering and cancelling scheduled alarms are as follows:

Normal users may also if they wish use these command line options (assuming that they can supply the necessary parameter information).

Option | Beschreibung
--- | ---
`--calendarURL url` | Use the calendar file with the specified &URL;. This option is only used for integrity checking: if the &URL; doesn't specify &kalarm;'s current default calendar file, the request will be ignored.
`--cancelEvent eventID` | Cancel the event with the specified event ID.
`--triggerEvent eventID` | Trigger the event with the specified event ID. The action taken is the same as for the triggerEvent() &DCOP; call.
`--handleEvent eventID` | Trigger or cancel the event with the specified event ID. &kalarm; determines which action to take in the same way as for the handleEvent() &DCOP; call.

`--cancelEvent`, `--triggerEvent` and `--handleEvent` are mutually exclusive. `--calendarURL` is optional, but can only be used with one of the other three options.

Examples are:

    % kalarm --triggerEvent &kalarm;-387486299.702 --calendarURL file:/home/zaphod/hydra.ics
    % kalarm --cancelEvent &kalarm;-388886299.793

## Fragen und Antworten

&reporting.bugs; &updating.documentation;

Wie heißen die Konfigurationsdateien von &kalarm;?

The file `$KDEHOME/share/config/kalarmrc` holds your &kalarm; preferences.

Wie heißen die Konfigurationsdateien des Alarmdämons?

Die Einstellungen des Alarmdämons befinden sich in `$KDEHOME/share/config/kalarmdrc`.

In der Datei `$KDEHOME/share/apps/kalarmd/clients` befinden sich Angaben über Programme und deren Kalenderdateien, die sich beim Alarmdämon registriert haben.

Wie sind die Programmnamen von &kalarm; und dem Alarmdämon?

Der Programmname von &kalarm; lautet kalarm und der Alarmdämon heisst kalarmd. In &kde;-Versionen vor 3.1 gibt es zusätzlich ein kleines Programm namens kalarmautostart, welches bei der Anmeldung das Kontrollleistensymbol von &kalarm; startet.

## Mitwirkende und Lizenz

&kalarm;

Autoren des Alarmdämons:

- Preston Brown pbrown@kde.org

- David Jarvie software@astrojar.org.uk

- Cornelius Schumacher schumacher@kde.org

Übersetzung: Frank Schütte F.Schuette@t-online.de

Vielen Dank an den Autor des &kde;1-Alarmprogramms, Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, der den Namen &kalarm; für dieses &kde;2-/&kde;3-Programm freigegeben hat.

&underFDL; &underGPL;

## Installation

### Wie bekommt man &kalarm;?

&install.intro.documentation;

### Voraussetzungen

&kalarm; benötigt etwa 12 MB und der Alarmdämon noch einmal 2,5 MB Arbeitsspeicher. Diese Anforderungen können abhängig von der Plattform und Konfiguration allerdings variieren.

Eine Liste der Änderungen findet man in der Datei `ChangeLog` oder unter http://www.astrojar.org.uk/linux/kalarm.html.

### Kompilierung und Installation

Falls man kein geeignetes vorkompiliertes binäres Paket findet, muss man &kalarm; selbst aus den Quelldateien kompilieren. Dazu benötigt man die Dateien `kdepim-x.x.tar.bz2` oder `kalarm-x.x.tar.bz2` (oder ähnlich), abhängig davon, ob man das gesamte &package; oder nur &kalarm; installieren möchte. Die Datei muss in einem neuen Unterverzeichnis entpackt werden. Das kann durch ``tar` `xvfj Paket.tar.bz2`` erfolgen. Dann wechselt man in das erzeugte Unterverzeichnis.

&install.compile.documentation;

Falls man mehrere Versionen von &kde; installiert hat (z.B. &kde;2 und &kde;3), könnte &kalarm; irrtümlich im falschen &kde;-Verzeichnis installiert werden. Falls nötig, kann man das richtige &kde;-Verzeichnis als Parameter für den Befehl ``./configure`` angeben. Für das &kde;-Verzeichnis `/opt/kde2` lautet der Befehl zum Beispiel:

``./configure` --prefix=/opt/kde2`

### Konfiguration

Für den Start von &kalarm; müssen keine besonderen Konfigurationen der &kde;-Arbeitsfläche vorgenommen werden. Nachdem man &kalarm; das erste Mal gestartet hat, wird der Alarmdämon bei jeder Anmeldung gestartet, um die festgelegten Alarme zu überwachen.

Um &kalarm; bei einer Nicht-&kde;-Arbeitsfläche zu verwenden, muss man selbst sicherstellen, dass der Alarmdämon bei jeder Anmeldung automatisch gestartet wird. Genauere Hinweise kann man der Datei `INSTALL` aus der &kalarm;-Distribution entnehmen.

&documentation.index;