# Das Handbuch zu &kalarm;

David
Jarvie

    software@astrojar.org.uk

David
Jarvie

    software@astrojar.org.uk

Entwickler
Frank
Schütte

    f.schuette@t-online.de

Übersetzung
Stephan
Johach

    hunsum@gmx.de

Übersetzung
Thomas
Reitelbach

    tr@erdfunkstelle.de

Übersetzung
2001
2002
2003
2004
2005
2006
David Jarvie
&FDLNotice;
2007-04-16
1.04.11

&kalarm; ist ein Planer für Erinnerungsnachrichten sowie für termingesteuerten E-Mail-Versand und Befehlsausführungen für &kde;.

KDE
kdepim
kalarm
Alarm
reminder

## Einleitung

Mit &kalarm; lassen sich Erinnerungsmeldungen, das Abspielen von Klängen, Ausführen von Kommandos und das Senden von E-Mails planen.

In der Standardansicht zeigt &kalarm; eine Liste mit den Zeiten und Nachrichtentexten der ausstehenden Erinnerungen an. Sie können hier neue Erinnerungen eintragen oder bestehende bearbeiten oder löschen. Optional können hier auch abgelaufene Erinnerungen angezeigt werden.

Wenn Sie eine Erinnerung anlegen oder bearbeiten, können Sie entweder den Text der Meldung oder eine anzuzeigende Text- oder Bilddatei angeben. Desweiteren ist die Angabe eines Befehls oder die Eingabe einer zu versendenden E-Mail möglich. Sie können hier auch die Farbe der Erinnerungsmeldung, ein Wiederholungsintervall und einen Klang oder die Sprachwiedergabe festlegen und einstellen, ob die Erinnerung gelöscht werden soll, wenn sie nicht zur vorgesehenen Zeit ausgeführt werden kann.

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

Wenn eine Erinnerung fällig ist, wird die Nachricht auf jeder &kde;-Arbeitsfläche angezeigt, damit sie nicht beim Umschalten zwischen den Arbeitsflächen übersehen werden kann. Die festgelegte Alarmzeit wird mit angezeigt. Das ist nützlich, falls die Nachricht zu spät angezeigt wird oder Sie selbst einige Zeit nicht am Rechner gewesen sind. 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 Nachrichtenfensters von &kalarm;
Erinnerung

Wenn die Erinnerung einen bestimmten Befehl ausführen oder eine E-Mail versenden soll, zeigt &kalarm; nichts an.

&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 verweist an einigen Stellen auf den Systemdienst Erinnerungsfunktion. Dieses Programm ist im Hintergrund aktiv, überwacht festgelegte Erinnerungszeiten und veranlasst &kalarm;, die entsprechenden Nachrichten bei Fälligkeit anzuzeigen.

## Arbeiten mit &kalarm;

Wird &kalarm; ohne Kommandozeilenparameter aufgerufen, startet es in der Graphischen Ansicht, in der alle ausstehenden Termine angezeigt werden.

Ist beim Start von &kalarm; in der Graphischen Ansicht der Systemdienst Erinnerungsfunktion nicht aktiv, wird er automatisch von &kalarm; gestartet.

Alle Drehfelder in &kalarm; sind mit einer Beschleunigungsfunktion versehen. Um den Wert in größeren Schritten zu erhöhen, halten Sie beim Klicken der Pfeiltasten die Umschalttaste gedrückt.

### Erinnerungsliste

Das Hauptfenster von &kalarm; zeigt die Liste der ausstehenden Erinnerungen mit der Fälligkeitszeit, dem Wiederholungsintervall, der eingestellten Farbe sowie, abhängig von den Einstellungen der Erinnerung, den Text der Nachricht, die anzuzeigende Datei, den auszuführenden Befehl oder den der E-Mail. Bei Erinnerungen, die wiederholt werden, wird die nächste Fälligkeit angezeigt. Ein Symbol links neben dem Text der Erinnerung zeigt den Typ der Erinnerung an.

Bilschirmphoto des Hauptfensters von &kalarm;
Das Hauptfenster

Bei Erinnerungen, die sich wiederholen, wird die nächste Fälligkeit und das zugrundeliegende Wiederholungsintervall angezeigt. Beispielsweise 1 Tag für tägliche Wiederholung, 3 Wochen bei einer Erinnerung, die alle drei Wochen jeweils Montags und Mittwochs fällig wird und Anmeldung bei einer Erinnerung, die bei jeder Anmeldung fällig wird.

Die Erinnerungen können nach Zeit/Datum, Wiederholung, Farbe, Art oder Nachrichtentext sortiert werden, indem Sie auf den entsprechenden Spaltenkopf klicken. Klicken Sie den Spaltenkopf erneut an, wird die Sortierrichtung umgedreht.

Wahlweise können Sie die verbleibende Zeit bis zur Fälligkeit zusätzlich oder anstelle der Fälligkeitszeit anzeigen lassen. Um die Spalte mit der Fälligkeit der Erinnerung auszublenden oder anzuzeigen, wählen Sie im Menü Ansicht Erinnerungszeiten anzeigen, für die Spalte mit der verbleibenden Zeit wählen Sie Ansicht Zeiten bis zur nächsten Erinnerung anzeigen. Es wird in jedem Fall eine der Spalten angezeigt. Sie können den Einrichtungsdialog verwenden, um die voreingestellten Spalten einzustellen.

#### Abgelaufene Erinnerungen

In der Voreinstellung werden Erinnerungen von &kalarm; noch für eine bestimmte Zeit aufbewahrt, nachdem sie abgelaufen sind oder gelöscht wurden. (Beachten Sie: Gelöschte Erinnerungen werden nur aufbewahrt, wenn sie mindestens einmal ausgelöst wurden). Sie können dieses Verhalten im Einrichtungsdialog einstellen.

Abgelaufene Erinnerungen können in der Alarmliste angezeigt werden, indem Sie Ansicht Abgelaufene Erinnerungen anzeigen auswählen. Um sie wieder auszublenden, wiederholen Sie diesen Schritt. Über den Einrichtungsdialog können Sie die entsprechende Voreinstellung ändern.

#### Durchsuchen der Erinnerungsliste

Um eine Erinnerung mit einem bestimmten Text leichter aufzufinden, ist die Erinnerungsliste durchsuchbar. Die Suchfunktion wird über Bearbeiten Suchen ... gestartet. Wählen Sie im erscheinenden Dialog den zu suchenden Erinnerungstyp. Um die nächste passende Erinnerung zu finden, wählen Sie Bearbeiten Weitersuchen oder Bearbeiten Frühere suchen.

So wird eine Suche durchgeführt:

- Text-Erinnerungen: Es wird nach dem Text der Erinnerung gesucht.

- Datei-Erinnerungen: Es wird nach dem Dateipfad/-Ordner gesucht.

- Befehl-Erinnerungen: Es wird nach der Befehlszeile oder dem Befehlsskript gesucht.

- E-Mail-Erinnerungen: Zusätzlich zum Betreff und dem Text der E-Mail wird auch nach den Empfängern und Adressen von Anhängen gesucht.

Nur die in der Erinnerungsliste angezeigten Erinnerungen können durchsucht werden. Falls Sie also nach abgelaufenen Erinnerungen suchen möchten, so müssen Sie diese zuerst wie oben beschrieben anzeigen lassen.

### Erstellen und Bearbeiten einer Erinnerung

#### Das Erstellen einer neuen Erinnerung

Um eine neue Erinnerung anzulegen, können Sie wie folgt vorgehen. In jedem Fall wird der Dialog Neue Erinnerung angezeigt, mit dessen Hilfe Sie die Einstellungen für die neue Erinnerung vornehmen.

- Wählen Sie im Menü Aktionen Neu ...

- Klicken Sie mit der &RMBn; auf das Symbol im Systembereich der Kontrollleiste und wählen Sie im Kontextmenü Neue Erinnerung ...

- Klicken Sie mit der &MMBn; auf das Symbol im Systemabschnitt der Kontrollleiste.

- Klicken Sie mit der &RMBn; in die Erinnerungsliste und wählen Sie Neu ... aus dem Kontextmenü.

- Führen Sie einen Doppelklick auf den leeren Bereich unterhalb des letzten Eintrags in der Liste der Erinnerungen aus.

Alternativ können Sie neue vorkonfigurierte Erinnerungen aus folgenden Quellen anlegen:

- Falls Sie für neue Erinnerungen eine Vorlage verwenden möchten, folgen Sie am besten den Hinweisen im Abschnitt Erinnerungsvorlagen.

- Soll eine Erinnerung auf einer bereits existierenden basieren, markieren Sie die betreffende Erinnerung in der Liste und wählen Sie Aktionen Kopieren. Hierdurch öffnet sich der Dialog Neue Erinnerung mit den Einstellungen der markierten Erinnerung.

- Um eine neue Erinnerung anzulegen, die eine vorhandene E-Mail anzeigen soll, ziehen Sie die E-Mail aus &kmail; in das Hauptfenster von &kalarm; oder auf das Symbol im Systembereich der Kontrollleiste. Hierbei wird der Dialog Neue Erinnerung mit der kompletten E-Mail (einschließlich Absender, Empfänger &etc;) als Erinnerungstext geöffnet.

- Um eine neue Erinnerung anzulegen, die eine Kopie einer vorhandenen E-Mail versenden soll, ziehen Sie die E-Mail aus &kmail; in das Hauptfenster von &kalarm; oder auf das Symbol im Systembereich der Kontrollleiste. Damit öffnen Sie den Dialog Neue Erinnerung und wählen die Einstellung E-Mail. Die gesamte E-Mail (ausgenommen der Absender) ist bereits als Erinnerungstext eingetragen.

- Wenn Sie einen beliebigen Text auf das Hauptfenster von &kalarm; oder das Symbol im Systembereich der Kontrollleiste ziehen, öffnet sich der Dialog Neue Erinnerung mit diesem Text.

- Um eine Datei als Erinnerung anzeigen zu lassen, ziehen Sie eine Dateiadresse/URL auf das Hauptfenster von &kalarm; oder das Symbol im Systembereich der Kontrollleiste. Im Dialog Neue Erinnerung wird dann der betreffende Dateiname voreinstellt.

- Sie können für Personen, die sich in &kaddressbook; eingetragen sind, automatisch Geburtstagstermine eintragen lassen. Eine Beschreibung hierzu finden Sie unter Importieren von Geburtstagen aus &kaddressbook;.

#### Das Bearbeiten einer Erinnerung

Um eine bestehende (aber noch nicht abgelaufene) Erinnerung zu bearbeiten, können Sie wie folgt vorgehen:

- Führen Sie einen Doppelklick auf den Eintrag in der Liste aus.

- Wählen Sie den Eintrag in der Liste aus und rufen Sie den Menüpunkt Aktionen Bearbeiten ... auf.

- Klicken Sie mit der &RMBn; auf den Eintrag in der Liste und wählen Sie im Kontextmenü den Eintrag Bearbeiten ...

Es wird der Dialog Neue Erinnerung geöffnet.

#### Das Löschen/Reaktivieren einer Erinnerung

Eine bestehende Erinnerung können Sie auf folgende Weise löschen:

- Markieren Sie die gewünschten Einträge in der Liste und wählen Sie im Menü Aktionen Löschen.

- Klicken Sie mit der &RMBn; auf die gewünschten Listeneinträge und wählen Sie im Kontextmenü Löschen.

Wenn Sie eine aktive Erinnerung löschen, so wird sie als abgelaufene Erinnerung aufbewahrt, vorausgesetzt das sie zumindest einmal vor dem Löschen ausgelöst wurde und das Aufbewahren abgelaufener Erinnerungen nicht ausgeschaltet wurde. (Verwenden Sie den Einrichtungsdialog, um die nötigen Einstellungen dazu vorzunehmen.) Wenn Sie eine abgelaufene Erinnerung oder eine bislang nicht ausgelöste Erinnerung löschen, so wird sie endgültig gelöscht und nicht aufbewahrt.

Eine gelöschte Erinnerung kann aus der Liste abgelaufener Erinnerungen wieder aktiviert werden, vorausgesetzt, sie ist nicht tatsächlich bereits abgelaufen. Dazu müssen Sie zunächst abgelaufene Erinnerungen anzeigen lassen.

- Klicken Sie auf die gewünschten Einträge in der Liste und wählen Sie im Menü Aktionen Reaktivieren.

- Klicken Sie mit der &RMBn; auf die gewünschten Listeneinträge und wählen Sie im Kontextmenü Reaktivieren.

#### Erinnerungsfunktion aktivieren/deaktivieren

Siehe auch Deaktivieren/Aktivieren der Überwachung von Erinnerungen, entweder individuell pro Erinnerung oder für alle Erinnerungen.

#### Das Anzeigen einer Erinnerung

Um eine angelegte Erinnerung anzuzeigen, ohne diese bearbeiten zu können, gehen Sie wie folgt vor:

- Klicken Sie auf den gewünschten Eintrag in der Liste und wählen Sie im Menü Aktionen Ansicht.

- Klicken Sie mit der rechten Maustaste auf den gewünschten Listeneintrag und wählen Sie im Kontextmenü Ansicht.

Es wird der Dialog Neue Erinnerung geöffnet (es aber können keine Änderungen vorgenommen werden!):

#### Die Zurkenntnisnahme einer Erinnerung

Wie Sie eine Erinnerung zur Kenntnis nehmen wird unter Alarmnachrichtendialog erläutert.

#### Erinnerungsvorlagen

Wenn Sie häufiger ähnliche Erinnerungen anlegen, sollten Sie zu diesem Zweck eine Erinnerungsvorlage einrichten. Dies hat den Vorteil, dass Sie nicht jedes Mal alle sich wiederholenden Daten erneut eingeben müssen. Eine Vorlage kann bis auf das Startdatum alle normalen Erinnerungsdaten beinhalten.

Beispiel: Sie möchten eine Erinnerung für eine Fernsehsendung einrichten, deren Sendezeit von Woche zu Woche verschieden ist. Die Vorlage würde alle Erinnerungsdaten (Meldungstext, Klang &etc;) außer Zeit und Datum enthalten. Um nun die Erinnerung aus der Vorlage zu erstellen, müssen Sie nur den Dialog zum Einrichten einer neuen Erinnerung mit dieser Vorlage öffnen und danach Datum und Uhrzeit eingeben.

Um eine neue, auf einer Vorlage basierende Erinnerung anzulegen, öffnen Sie den Dialog Neue Erinnerung mit den entsprechenden Vorlagendaten:

- Wählen Sie im Menü Aktionen Neu von Vorlage und suchen Sie sich die gewünschte Vorlage aus.

- Klicken Sie mit der &RMBn; auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü Neue Erinnerung von Vorlage. Dann wählen Sie die gewünschte Vorlage aus.

- Öffnen Sie den Dialog Neue Erinnerung auf dem herkömmlichen Weg und klicken Sie dann auf Vorlage laden ....

##### Vorlagen einrichten

Sie können Vorlagen entweder mit dem Vorlagendialog erzeugen, bearbeiten und löschen, oder Sie erstellen eine auf einer bereits existierenden Erinnerung basierende Vorlage.

Sie können eine neue Vorlage auf folgende Weise erstellen:

- Öffnen Sie den Vorlagendialog indem Sie Datei Vorlagen ... wählen und dann auf Neu ... klicken. Daraufhin sehen Sie einen Vorlagendialog mit leeren Feldern.

- Öffnen Sie den Vorlagendialog, klicken Sie auf Datei Vorlagen ..., wählen Sie eine bestehende Vorlage aus der Liste und klicken Sie dann auf Kopieren. Dadurch wird eine neue Vorlage mit den Daten der bereits existierenden Vorlage erstellt.

- Markieren Sie eine Erinnerung in der Liste und wählen Sie Aktionen Vorlage erstellen ... . Dadurch wird eine neue Vorlage mit den Daten der bereits existierenden Erinnerung erstellt.

Um eine bestehende Vorlage zu ändern, öffnen Sie den Vorlagendialog indem Sie im Menü Datei Vorlagen ... wählen und dann auf Bearbeiten ... klicken. Die öffnet den unten beschriebenen Dialog "Erinnerungsvorlagen bearbeiten".

Um eine Vorlage zu löschen, öffnen Sie den Vorlagendialog indem Sie im Menü Datei Vorlagen ... auswählen. Markieren Sie eine oder mehrere Vorlagen und klicken Sie auf Löschen. Bevor die Vorlagen wirklich gelöscht werden, müssen Sie noch eine Nachfrage Bestätigen.

##### Der Dialog "Erinnerungsvorlagen bearbeiten"

Der Dialog zum Bearbeiten von Vorlagen ist ähnlich aufgebaut wie der Dialog Neue Erinnerung. Die folgenden Elemente sind allerdings unterschiedlich:

- Geben Sie unter Name der Vorlage: den Namen für diese Vorlage ein. Dies ist der Name, der im Vorlagendialog angezeigt wird. Wählen Sie einen einprägsamen, eindeutigen Namen. Es kann nicht mehrere Vorlagen mit dem gleichen Namen geben.

- Im Bereich Zeit steht Folgendes zur Auswahl:

  - Standard-Zeitpunkt, falls Sie keine besondere Erinnerungszeit wünschen. Erinnerungen die auf dieser Vorlage basieren, werden den normalen Standard-Zeitpunkt voreingestellt haben.

  - Zeit zum Eingeben einer Uhrzeit, zu der die Erinnerung ausgelöst wird.

  - Keine Zeit festgelegt bewirkt, dass die Erinnerung nur ein Datum, aber keine Zeit eingestellt hat.

  - Zeit ab jetzt bestimmt ein Zeitintervall, nachdem die Erinnerung ausgelöst wird. Gezählt wird ab dem Zeitpunkt, an dem die Erinnerung aus der Vorlage erzeugt wird.

- Auf der Karteikarte Wiederholung im Abschnitt Wiederholungsregel legen Sie die Art der Wiederholung fest.

#### Importieren von Erinnerungen aus externen Kalendern

Sie können mit Datei Erinnerungen importieren ... Erinnerungen aus anderen Kalendern in &kalarm; importieren. Die Importfunktion durchsucht die ausgewählte Kalenderdatei nach Ereignissen, die Erinnerungen enthalten und kopiert diese (unter Vergabe eindeutiger IDs) in den Kalender von &kalarm;. Ereignisse ohne Erinnerungen und andere Kalendereinträge werden ignoriert.

Wenn Sie Erinnerungen aus Kalenderdateien importieren, die nicht von &kalarm; erstellt wurden, kann es zu Abweichungungen gegenüber der ursprünglichen Anwendung kommen, es ist sogar möglich, dass der Zeitpunkt der Erinnerung vom Original abweicht. Dies hängt mit den zur Datenspeicherung verwendeten Konventionen der anderen Anwendung zusammen und ist unvermeidlich, wenn diese von den von &kalarm; erwarteten abweichen. Überprüfen Sie importierte Erinnerungen stets auf Abweichungen und korrigieren Sie die Einstellungen nötigenfalls.

#### Das Importieren von Geburtstagen aus &kaddressbook;

Sie können Erinnerungen für Geburtstage, die in &kaddressbook; gespeichert sind, über Datei Geburtstage importieren ... einrichten. Es wird ein Dialog angezeigt, in dem Sie die Geburtstage auswählen können, für die eine Erinnerung angelegt werden soll.

- Im Bereich Text für Erinnerung können Sie den Text eingeben, der in der Erinnerungsmeldung angezeigt werden soll. Der Text der Nachricht ergibt sich aus der Kombination des Textes im Eingabefeld Vorher, gefolgt vom Namen der Person mit dem angefügten Inhalt des Textes von Nachher. Es werden keine Leerzeichen hinzugefügt. Denken Sie also daran, die entsprechenden Leerzeichen selbst in die Eingabefelder einzufügen.

  Ändern Sie den Text der Erinnerung, wird die Liste mit den Geburtstagen neu ausgewertet.

- Markieren Sie im Bereich Geburtstage auswählen die Geburtstage, für die eine Erinnerung angelegt werden soll. Beachten Sie, dass die Liste nur die Einträge aus &kaddressbook; anzeigt, die ein Geburtsdatum enthalten und für die noch keine Erinnerung im derzeit unter Text für Erinnerung ausgewählten Format existiert.

- Die übrigen Elemente des Dialogs sind identisch mit den entsprechenden Elementen für Erinnerungen vom Typ Text, wie Sie im Dialog Neue Erinnerung angezeigt werden.

#### Rückgängigmachen / Wiederherstellen

Sie können viele kürzlich in dieser Sitzung von &kalarm; gemachten Änderungen rückgängig machen oder wiederherstellen. Die meisten Aktionen können rückgängig gemacht werden; dazu gehören z. B. das Erzeugen, Bearbeiten und Löschen von Erinnerungen und Vorlagen, sowie das Reaktivieren von Erinnerungen. Um einer unnötigen Verschwendung von Ressourcen vorzubeugen, ist die Rückgängig-Funktion auf die letzten 12 Aktionen beschränkt.

Um die letzte Änderung rückgängig zu machen, wählen Sie im Menü Bearbeiten Rückgängig. Um die letzte rückgängig gemachte Änderung wiederherzustellen wählen Sie im Menü Bearbeiten Wiederherstellen.

Um eine Änderung rückgängig zu machen, die nicht die letzte Änderung ist, klicken Sie in der Werkzeugleiste auf den Knopf Rückgängig und halten die Maustaste gedrückt. Es erscheint eine List mit Aktionen, die rückgängig gemacht werden können. Wählen Sie aus dieser Liste die Aktion aus, die Sie rückgängig machen möchten. Falls Sie die gewünschte Aktion nicht finden können, müssen Sie möglicherweise zuerst andere Aktionen rückgängig machen, von denen die gewünschte Aktion abhängig ist. Beispiel: Wenn Sie eine Erinnerung zuerst bearbeitet und dann gelöscht haben, können Sie die Bearbeitung nicht rückgängig machen, solange die Löschung noch nicht rückgängig gemacht wurde.

Das Wiederherstellen einer rückgängig gemachten Aktion, die nicht die letzte war, funktioniert auf die gleiche Weise mit dem Knopf Wiederherstellen.

### Der Dialog Erinnerungsdaten bearbeiten

Mit diesem Dialog können Sie eine Erinnerung anzeigen und bearbeiten.

Bildschirmphoto des Dialogs Erinnerungsdaten bearbeiten
Der Dialog Erinnerungsdaten bearbeiten

#### Die Erinnerungs-Aktion

Im Abschnitt Aktion können Sie den Erinnerungstyp auswählen:

- Text, um den Text für eine Erinnerung (auch mit Zeilenumbruch) einzugeben. Wählen Sie die folgenden Einstellungen:

  - Mit der Einstellung Klang können Sie auswählen, ob beim Auslösen der Erinnerung ein Klang wiedergegeben werden soll. Wählen Sie:

    - Keine, um kein akustisches Signal ertönen zu lassen.

    - Signalton, um einen Signalton ertönen zu lassen.

    - Vorlesen, um die Meldung nicht nur anzeigen, sondern auch vorlesen zu lassen. Diese Option ist nur verfügbar, wenn das Programm KTTSD (aus dem Paket kdeaccessibility) installiert und eingerichtet ist. Außerdem benötigen Sie einen kompatiblen Sprachsynthesizer wie &eg; Festival.

    - Klangdatei, um eine Klangdatei abzuspielen. Benutzen Sie den Knopf rechts daneben zur Auswahl einer Klangdatei und zur Einstellung der Lautstärke und Wiederholung. Wenn Sie mit der Maus über den Knopf fahren, zeigt ein Kurztipp an, welche Datei derzeit ausgewählt ist.

      &kalarm; benutzt &arts; für Wiederholung und Lautstärkeregelung. Wurde &kalarm; ohne Unterstützung für &arts; kompiliert, sind die Einstellungen für Wiederholung und Lautstärke nicht verfügbar, und anstelle des Dialogs für Klangdateien steht nur eine einfache Dateiauswahl zur Verfügung.

      Im Klangdatei-Dialog:

      - Geben Sie die Adresse der Klangdatei in das Textfeld ein, oder benutzen Sie den Knopf daneben, um mit der Dateiauswahl zu arbeiten. Sie können die ausgewählte Datei anhören, indem Sie den Abspielknopf links neben dem Textfeld betätigen.

      - Aktivieren Sie Wiederholen, um die Klangdatei kontinuierlich abzuspielen, solange die Erinnerung angezeigt wird. (Das Fenster der Erinnerungsmeldung enthält einen Knopf zum Stummschalten, falls Sie Ruhe möchten, die Erinnerung aber weiterhin angezeigt werden soll.)

      - Aktivieren Sie Lautstärke und regeln Sie mit dem Schieberegler die Lautstärke, mit der die Klangdatei wiedergegeben werden soll.

      - Wenn Sie es wünschen, kann der Klang auch langsam eingeblendet werden. Das bedeutet, dass die Klangdatei zuerst leise angespielt wird und die Lautstärke dann Schritt für Schritt erhöht wird. Die endgültige Lautstärke ist die, die Sie mit dem Schieberegler für die Lautstärke festgelegt haben. Um diese Funktion zu aktivieren, machen Sie ein Häkchen bei Einblenden und geben den Zeitraum in Sekunden unter Einblendedauer ein. Außerdem müssen Sie noch den Schieberegler für die Anfangslautstärke einstellen.

      Falls möglich wird zum Einstellen der Lautstärke &kmix; verwendet. Dadurch wird sichergestellt, dass die Lautstärke für die Erinnerung nicht von der Lautstärke des Rechners beeinträchtigt wird. Falls &kmix; nicht installiert (oder älter als &kde; 3.1 ist), wird die Lautstärke relativ zum Zeitpunkt des Auslösens der Erinnerung eingestellt. In dem Fall kann die Lautstärke stark variieren, je nach der eingestellten Hauptlautstärke des Rechners.

      Mit Hilfe des Knopfes Versuchen können Sie die gewählte Lautstärke testen.

  - Wählen Sie die Hintergrundfarbe für das Fenster der Erinnungsmeldung aus. Die Farbauswahl können Sie im Dialog Einrichtungsdialog einstellen.

  - Mit dem Knopf Schriftart und Farbe können Sie die Schriftart sowie Vorder- und Hintergrundfarbe für die Erinnungsmeldung auswählen. Markieren Sie das Feld Standardschrift benutzen, wenn die Meldung in der zum Zeitpunkt der Anzeige der Meldung eingestellten Standardschrift angezeigt werden soll. Die Standardschrift kann unter KAlarm einrichten ... eingestellt werden. Möchten Sie die Nachricht in einer bestimmten Schriftart anzeigen lassen, entfernen Sie die Markierung des Ankreuzfeldes Standardschrift benutzen.

  - Mit dem Knopf Besondere Aktionen ... können Sie Shell-Befehle angeben, die vor oder nach dem Auslösen der Erinnerung ausgeführt werden:

    - In das Feld Aktion vor der Erinnerung: geben Sie den Shell-Befehl ein, der vor dem Auslösen der Erinnerung ausgeführt werden soll. Beachten Sie, dass &kalarm; wartet, bis der Befehl vollständig ausgeführt wurde, bevor die Erinnerung angezeigt wird.

      Eine Aktion vor der Erinnerung wird nur einmal ausgeführt, wenn die Erinnerungsnachricht erstmals angezeigt wird; auch, wenn eine Voraberinnerung durch die eigentliche Erinnerungsnachricht ersetzt wird. Der Befehl wird unter den folgenden Umständen nicht ausgeführt:

      - Wenn eine Voraberinnerung angezeigt wird.

      - Wenn die Nachricht erneut angezeigt wird, nachdem die Erinnerung aufgeschoben wurde.

      - Wenn die Erinnerung fällig wurde während Sie sich abgemeldet haben und bei der nächsten Anmeldung erneut ausgelöst wird.

      - Wenn eine wiederkehrende Erinnerung ausgeführt wird, aber noch eine Nachricht (oder eine aufgeschobene Nachricht) einer vorangegangenen Erinnerung angezeigt wird. Mit anderen Worten, wenn eine frühere Erinnerungsnachricht noch nicht bestätigt wirde.

    - Geben Sie im Feld Aktion nach der Erinnerung: einen Kommandozeilenbefehl ein, der ausgeführt wird, wenn Sie die Erinnerung (entweder über den mit Schließen beschrifteten Knopf oder dem Schließen-Knopf in der Titelleiste) bestätigt haben. Der Befehl wird unter den folgenden Umständen nicht ausgeführt:

      - Wenn eine Voraberinnerung geschlossen wird.

      - Wenn Sie die Erinnerung aufschieben, außer, wenn der aufgeschobene Alarm schließlich bestätigt wird.

      - Wenn die Erinnerungsnachricht durch eine Abmeldung geschlossen wird.

    Lesen Sie die untenstehende Beschreibung zu Erinnerungs-Befehlen um zu erfahren, wie Shell-Befehle ausgeführt werden.

- Datei, um den Namen oder die Adresse (URL) einer Text- oder Bilddatei, deren Inhalt in der Erinnungsmeldung angezeigt werden soll, anzugeben. Mit dem Knopf rechts neben dem Eingabefeld kann ein Dateiauswahldialog angezeigt werden. Die Optionen können wie bei Erinnerungen des Typs Text eingestellt werden, jedoch ist die Option "Vorlesen" nicht verfügbar.

- Befehl um einen auszuführenden Befehl einzugeben.

  Diese Einstellung ist nicht verfügbar, wenn &kde; im Kiosk-Modus läuft.

  - Das Ankreuzfeld Geben Sie ein Skript ein ermöglicht Ihnen die Wahl ob Sie einen Shell-Befehl oder ein ganzes Skript eingeben möchten.

    Wenn diese Option nicht markiert ist, können Sie einen einzelnen Shell-Befehl eingeben. Der Befehl wird zur Ausführung an die Standard-Shell übergeben (definiert durch die Umgebungsvariable `SHELL`) und kann alle Optionen, Parameter, Pipes &etc; enthalten, die von der Shell auf einer Kommandozeile akzeptiert werden.

    Wenn diese Option markiert ist, können Sie ein auszuführendes Skript eingeben. Denken Sie daran, in der ersten Zeile z. B. `#!/bin/bash` einzugeben, um die auszuführende Shell anzugeben.

  - Im Abschnitt Ausgabe des Befehls können Sie angeben, was mit den Ausgaben des Befehls geschehen soll.

    - Wählen Sie Im Terminal ausführen, so wird der Befehl in einem Befehlsfenster ausgeführt. Das Terminal-Programm ist unter KAlarm einrichten ... einstellbar.

    - Wählen Sie In Datei speichern, um die Ausgaben des Befehls in eine Datei zu speichern. Der Ausgabe wird ein Präfix vorangestellt, dem Sie die geplante Ausführungszeit entnehmen können. Die gesamten Ausgaben werden an den möglicherweise schon bestehenden Dateiinhalt angehängt. Geben Sie den Dateinamen in das darunterliegende Feld ein oder benutzen Sie den Knopf rechts neben dem Feld, um eine Datei über den Dialog auszuwählen.

    - Wählen Sie Verwerfen um die gesamte Ausgabe des Befehls zu ignorieren.

- E-Mail, um den Inhalt einer E-Mail einzugeben, die bei Fälligkeit versendet wird. Geben Sie die Adressen der Empfänger, den Betreff und den Text der E-Mail in die entsprechenden Eingabefelder ein. Mit dem Knopf neben dem Eingabefeld für die Empfänger können Sie das Adressbuch von &kde; aufrufen und darin aufgeführte Empfänger auswählen. Anhänge können Sie über den Knopf Hinzufügen ... auswählen. Beachten Sie, dass Anhänge bei Fälligkeit der Erinnerung noch vorhanden sein müssen. Es wird keine Kopie der betreffenden Datei angelegt, wenn die Erinnerung angelegt wird. Um einen Anhang zu entfernen, markieren Sie ihn in der Liste und drücken Sie den Knopf Entfernen.

  Es stehen folgende Optionen zur Verfügung:

  - Aus der Liste Von können Sie eine &kmail;-Identität auswählen die als Absender der E-Mail eingestellt wird. Diese Option ist nur verfügbar, wenn unter KAlarm einrichten ... die Option KMail-Identitäten verwenden gewählt ist. Ansonsten wird die unter KAlarm einrichten ... voreingestellte E-Mail-Adresse als Absender eingestellt.

  - Markieren Sie das Ankreuzfeld Blindkopie an eigenes Postfach, wenn Sie bei Fälligkeit der Erinnerung eine Blindkopie der versendeten E-Mail erhalten wollen. Die E-Mail-Adresse, an die die Blindkopie verschickt wird, können Sie im Dialog KAlarm einrichten ... festlegen. Die Voreinstellung ist die im Kontrollzentrum von &kde; eingerichtete E-Mail-Adresse.

#### Verschiebung

Handelt es sich um eine wiederkehrende Erinnerung, die bei ihrer letzten Fälligkeit verschoben wurde, zeigt das Listenfeld Verschobene Erinnerung die verschobene Fälligkeitszeit an. Mit Hilfe von Ändern ... können Sie die verschobene Zeit ändern oder die Verschiebung aufheben.

#### Zeit

Im Abschnitt Zeit steht Folgendes zur Auswahl:

- Zeitpunkt, um Datum und Zeit einzutragen, zu der die Erinnerung ausgelöst werden soll. Wollen Sie lediglich ein Datum festlegen, müssen Sie zusätzlich das Ankreuzfeld Keine Zeit festgelegt markieren. Die Erinnerung wird dann bei nächster Gelegenheit zum eingestellten Tagesbeginn ausgelöst. (Die Einrichtung des Tagesbeginns wird beschrieben unter KAlarm einrichten ....)

  Bei einmaligen Erinnerungen muss die eingegebene Fälligkeit in der Zukunft liegen. Wenn Sie nur ein Datum ohne festgelegte Zeit eingeben, ist der heutige Tag oder ein späteres Datum möglich. Bei wiederkehrenden Erinnerungen bestehen diese Beschränkungen nicht. Der Zeitpunkt der Erinnerung wird automatisch auf die nächste Fälligkeit verschoben.

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

#### Erinnerung

Markieren Sie das Ankreuzfeld Erinnerung wenn Sie im Voraus auf die Fälligkeit einer Erinnerung aufmerksam gemacht werden wollen. Die Einstellung gilt auch für Wiederholungen der Erinnerung. Über die Eingabeelemente rechts neben dem Ankreuzfeld können Sie einstellen, wie weit im Voraus die Meldung erfolgen soll.

Eine Voraberinnerung vor jeder Wiederholung ist nur möglich, wenn Sie die Wiederholung über die Karteikarte "Wiederholung" einrichten. Falls Sie den Knopf "Einfache Wiederholung" verwenden, wird die Voraberinnerung nur vor der ersten Wiederholung ausgelöst.

Wenn sich die Erinnerung wiederholt, die Voraberinnerung aber nur einmal ausgelöst werden soll, dann markieren Sie das Ankreuzfeld Voraberinnerung nur für das erste Auftreten. Wenn das Ankreuzfeld nicht markiert ist, muss der Zeitraum für eine Voraberinnerung geringer als die Wiederholperiode sein.

#### Abbruch

Die Optionen zum Abbruch bei Verspätung legen fest, wie mit Erinnerungen zu verfahren ist, die erst nach ihrer Fälligkeit ausgelöst werden können:

- Das Ankreuzfeld Wenn überfällig, ignorieren bestimmt, was geschieht, wenn die Erinnerung nicht zum Zeitpunkt der Fälligkeit ausgelöst werden kann.

  Markieren Sie dieses Ankreuzfeld, um die Erinnerung abzubrechen, falls sie nicht innerhalb der angegebenen Zeit nach der Fälligkeit ausgelöst werden kann. Die Zeitspanne wird mit den Kontrollelementen neben dem Ankreuzfeld eingestellt. Wenn Sie beispielsweise eine Zeitspanne von einer Stunde einstellen, so wird die Erinnerung noch bis zu einer Stunde nach ihrer Fälligkeit ausgelöst. Falls auch diese Stunden überschritten wird, so wird die Erinnerung abgebrochen und somit nicht ausgelöst.

  Bei Erinnerungen ohne Zeitangabe (d. h. bei denen das Ankreuzfeld Keine Zeit festgelegt markiert ist), wird die Verspätung vom beginn des Tages an errechnet.

  Wenn Sie dieses Ankreuzfeld nicht markieren, so wird die Erinnerung ausgelöst, sobald es nach der Fälligkeit möglich ist; ganz egal wie groß die Verspätung ist.

  Eine Erinnerungsmeldung kann nur dann angezeigt werden, wenn Sie angemeldet sind und sowohl die graphische Oberfläche als auch die Erinnerungsfunktion aktiv sind.

- Markieren Sie das Ankreuzfeld Fenster nach dieser Zeitspanne automatisch schließen, so wird das Fenster mit der Erinnerungsmeldung automatisch geschlossen, falls es nach der Verspätungs-Zeitspanne immer noch angezeigt wird.

#### Wiederholung

Mit Hilfe des Knopfes Einfache Wiederholung und der Karteikarte Wiederholung können Sie einstellen, ob und wie die Erinnerung wiederholt werden soll. Die Karteikarte Wiederholung ermöglicht Ihnen flexiblere Einstellmöglichkeiten, aber für eine Wiederholung die einfach umschrieben werden kann, können Sie den einfach gehaltenen Dialog verwenden, den Sie über den Knopf Einfache Wiederholung erreichen.

Je nachdem welche Methode Sie für die Wiederholung gewählt haben, werden Voraberinnerungen unteschiedliche gehandhabt. Wenn Sie den Knopf Einfache Wiederholung benutzen, so wird die Voraberinnerung nur vor dem ersten Auslösen angezeigt. Wenn Sie die Karteikarte Wiederholung verwenden, so werden die Voraberinnerungen vor jeder Wiederholung angezeigt.

Sie können die Einfache Wiederholung auch zusammen mit der Karteikarte Wiederholung verwenden. Auf diese Weise lässt sich eine Wiederholung innerhalb einer Wiederholung einrichten. Jedes Mal wenn eine Erinnerung lt. der Karteikarte Wiederholung fällig wird, wird sie so oft wiederholt, wie Sie es in der Einfachen Wiederholung festgelegt haben. So könnten Sie z. B. eine Wiederholung für jeden Donnerstag Nachmittag stündlich bis 18 Uhr einrichten: Stellen Sie mit der Karteikarte Wiederholung eine Wiederholung jeden Donnerstag um 12:00 Uhr ein. Danach richten Sie eine einfache stündliche Wiederholung mit der Anzahl 7 oder einer Dauer von 6 Stunden ein.

Das zugrundeliegende Wiederholungsintervall der Erinnerung wird zur besseren Übersicht in der Karteikarte Erinnerung angezeigt. Die Einstellungen hierzu können Sie im Reiter Wiederholung vornehmen.

##### Der Dialog Erinnerungswiederholung

Markieren Sie das Ankreuzfeld Wiederholung alle, um eine einfache Wiederholung zu aktivieren. Dann richten Sie die Wiederholung wie folgt ein:

- Geben Sie das Zeitintervall zwischen den Wiederholungen mit den Kontrollen rechts daneben ein. Wählen Sie zuerst die die gewünschte Zeiteinheit (&eg; Tage) und geben Sie dann die entsprechende Anzahl ein.

- Geben Sie entweder die Anzahl der Wiederholungen oder die Dauer ein:

  - Wählen Sie Anzahl der Erinnerungen um anzugeben, wie oft die Erinnerung ausgelöst werden soll (inklusive der ursprünglichen Erinnerung). Wenn die Erinnerung 3-Mal zusätzlich zu der eigentlichen Erinnerung wiederholt werden soll, so geben Sie hier 4 ein.

  - Wählen Sie Dauer um eine Gesamtzeit anzugeben, in der die Erinnerungen wiederholt werden sollen. Die Dauer muss ein Vielfaches der Wiederholungszeit sein und wird beim Klick auf Ok automatisch entsprechend abgerundet.

Die Dauer einer einfachen Wiederholung ist eingeschränkt, wenn sie in Verbindung mit einer Wiederholung aus dem Karteireiter Wiederholung eingesetzt wird. In diesem Fall wird bei jeder normalen Wiederholung eine noch aktive einfache Wiederholung außer Kraft gesetzt um Überlappung zu vermeiden. Die Dauer einer einfachen Wiederholung ist also maximal so lang wie das längste Intervall einer normalen Wiederholung.

##### Das Karteifenster Wiederholung

Unter Wiederholungsregeln können Sie den Typ der Wiederholung oder das Wiederholungsintervall wie folgt festlegen:

- Soll die Erinnerung nur einmal ausgelöst werden, wählen Sie Keine Wiederholung.

- Wählen Sie beim Anmelden, um die Erinnerung bei jeder Anmeldung bis zum festgelegten Zeitpunkt zu wiederholen. (Eine solche Erinnerung wird auch fällig, wenn Sie die Erinnerungsfunktion aktivieren oder neustarten.)

- Zur Einstellung eines regelmäßigen Wiederholungsintervalls wählen Sie einen der entsprechenden Wiederholungstypen aus und stellen Sie im Drehfeld Wiederholung alle das gewünschte Intervall ein. Um beispielsweise eine vierzehntägige Wiederholung einzustellen, wählen Sie als Typ täglich aus und stellen das Intervall auf den Wert 14. Das selbe erreichen Sie durch Auswahl des Typs wöchentlich und Einstellung des Intervalls auf den Wert 2. Abhängig vom gewählten Typ stehen weitere Optionen bereit:

  - Bei wöchentlicher Wiederholung können Sie den oder die gewünschten Wochentage auswählen.

  - Bei einer monatlichen Wiederholung können Sie zwischen einem festen Datum oder einem Wochentag als Bezugspunkt wählen (&zb; am zweiten Dienstag).

  - Bei einer jährlichen Wiederholung können Sie zwischen einem festen Datum oder einer fester Position in einem Monat (&zb; der letzte Samstag im Mai) wählen.

  Möchten Sie einen täglichen Alarm nur an Werktagen ausführen lassen, wählen Sie wöchentliche Wiederholung und markieren nur die Werktage als Fälligkeit.

Im Abschnitt Wiederholung endet wird der Zeitraum, in dem die Wiederholung erfolgen soll wie folgt festgelegt:

- Wählen Sie Nie, wenn der Zeitraum der Wiederholung unbegrenzt sein soll.

- Wählen Sie nach:, um eine festgelegt Anzahl von Wiederholungen einzustellen.

- Wählen Sie am:, um einen festen Zeitpunkt anzugeben, zu dem die Wiederholung enden soll.

Möchten Sie bestimmte Zeiträume oder Daten vom eingestellten Wiederholungsintervall ausnehmen, können Sie diese unter Ausnahmen festlegen. Eine Liste der Ausnahmen wird links angezeigt. Um eine Ausnahme hinzuzufügen, geben Sie im Eingabefeld rechts ein Datum ein und drücken Sie den Knopf Hinzufügen. Um eine Ausnahme zu bearbeiten drücken Sie den Knopf Ändern. Das Löschen einer Ausnahme erfolgt über Markieren des Eintrags in der Liste und Drücken des Knopfes Löschen.

#### Andere Optionen

Mit dem Ankreuzfeld Zurkenntnisnahme der Erinnungsmeldung bestätigen können Sie festlegen, ob Sie beim Schließen der Erinnungsmeldung die Zurkenntnisnahme der Meldung bestätigen müssen. Dies bietet einen gewissen Schutz gegen das versehentliche Bestätigen einer Erinnerung.

Markieren Sie In &korganizer; anzeigen, um die Erinnerung auch im aktiven Kalender von &korganizer; einzutragen. So können Sie Erinnerungen in &korganizer; verfolgen und dennoch von den erweiterten Funktionen von &kalarm; profitieren.

Wenn Sie die Erinnerung zu einem späteren Zeitpunkt löschen oder bearbeiten, so wird die Änderung automatisch mit &korganizer; abgeglichen. Wenn Sie allerdings eine Änderung an der Erinnerung in &korganizer; vornehmen, wird sich die Änderung nicht in &kalarm; wiederspiegeln.

Benutzen Sie den Knopf Vorlage laden ... um eine Vorlage für die Erinnerung auszuwählen. Das Vorgehen wird im Abschnitt Erstellen und Bearbeiten einer Erinnerung beschrieben.

Drücken Sie dann Versuchen, um die Erinnerung zu testen und zu sehen, ob alles einwandfrei funktioniert. Die Erinnerung wird genauso ausgelöst als wäre sie auf herkömmlichem Weg ausgelöst worden.

Durch Klicken auf OK wird die Erinnerung zur Liste der festgelegten Erinnerungen hinzugefügt.

### Erinnerungsnachrichten

Ist die Fälligkeit einer Erinnerung erreicht, wird die Nachricht auf allen &kde;-Arbeitsflächen angezeigt, damit sie beim Umschalten zwischen den Arbeitsflächen nicht übersehen werden kann. Der festgelegte Zeitpunkt der Fälligkeit wird dabei angezeigt. Das ist nützlich, falls Sie zu der Zeit nicht am Rechner gewesen sind. (Für Voraberinnerungen wird der Zeitpunkt der eigentlichen Erinnerungsnachricht oder der Folgeerinnerung angezeigt, nicht die der Voraberinnerung, und der Fenstertitel ist Voraberinnerung).

Das Erinnerungsfenster bleibt sichtbar bis Sie es bestätigen, es sei denn die Option Fenster nach Verspätungs-Zeitspanne automatisch schließen im Dialog Neue Erinnerung ist aktiv. Bei einer wiederkehrenden Erinnerung wird, falls das Bestätigungsfenster einer zurückliegenden Fälligkeit noch geöffnet ist, zum Zeitpunkt der erneuten Fälligkeit das existierende Fenster lediglich nach vorn geschoben. Damit wird verhindert, dass Sie die selbe Erinnerungsnachricht mehrfach bestätigen müssen.

Das Erinnerungsfenster bietet Ihnen je nach Erinnerungstyp folgende Möglichkeiten:

- Sie bestätigen die Nachricht durch Klicken auf den Knopf Schließen. Damit wird das Fenster geschlossen (nach einer Nachfrage, sofern Sie dies mit dem Ankreuzfeld Zurkenntnisname der Erinnerungsmeldung bestätigen so eingestellt haben).

- Durch Drücken des Knopfs Bearbeiten ... erscheint der Dialog Neue Erinnerung, indem Sie die Einstellungen zu der Erinnerung überarbeiten können.

- Klicken Sie auf Verschieben ..., um die Optionen zum Verschieben der Erinnerung anzeigen zu lassen. Dann wählen Sie Verschieben auf Zeitpunkt, um Datum und Uhrzeit der neuen Fälligkeit einzugeben, oder wählen Sie Verschieben um Zeitintervall, um ein Zeitintervall bezogen auf den jetzigen Zeitpunkt (in Stunden und Minuten) einzugeben. Klicken Sie dann auf Verschieben, um die Erinnerungsmeldung wie angegeben zu verschieben.

  Die Fälligkeit der verschobenen Erinnerung muss vor der nächsten geplanten Erinnerung liegen. Deshalb sind die Knöpfe Verschieben ... und Ok im Verschieben-Dialog eine Minute vor der nächsten geplanten Fälligkeit deaktiviert.

  Der Knopf Verschieben ... ist nicht verfügbar für Erinnerungen, die durch die Einstellung Wiederholung beim Anmelden bei jeder Anmeldung angezeigt werden.

- Klicken Sie zum Stoppen der Wiedergabe einer Klangdatei auf das Symbol Die Wiedergabe der Klangdatei anhalten.

- Wenn Sie die Erinnerungsmeldung durch Ziehen und Ablegen einer E-Mail aus &kmail; heraus erzeugt haben, dann können Sie im Erinnerungsfenster auf das &kmail;-Symbol klicken und sofort öffnet sich &kmail; mit der entsprechenden E-Mail.

  Falls &kmail;s Indexe regeneriert wurden, so ist die Verknüpfung zu der E-Mail in &kmail; leider verloren und sie kann nicht von &kalarm; heraus aufgerufen werden.

- Der Knopf mit dem Symbol &kalarm; dient zur bequemen Aktivierung von &kalarm;.

Die Anzeige des Fensters für die Erinnerungsmeldungen kann auf zwei Arten erfolgen. Die betreffende Einstellung können Sie im Dialog KAlarm einrichten vornehmen.

- Als normales Fenster. In diesem Modus erhält das Fenster für die Erinnerungsmeldung bei der Anzeige den Eingabefokus, so dass Eingaben über die Tastatur an das betreffende Erinnerungsfenster gehen und nicht mehr an die Anwendung, mit der Sie gerade arbeiten.

- Als nicht-modales Fenster. In diesem Modus erhält das Fenster für die Erinnerungsmeldung bei der Anzeige nicht den Eingabefokus und stört Sie nicht bei Ihrer Arbeit. Allerdings verfügt es auch nicht über eine Titelzeile, so dass Sie das Fenster nicht verschieben oder die Größe ändern können.

### Das Kontrollleistensymbol

&kalarm; kann als Symbol im Systembereich der &kde;-Kontrollleiste ausgeführt werden. Dieses Symbol ermöglicht die Aktivierung von &kalarm; mit einem Mausklick und bietet sowohl eine Kontrolle als auch eine Statusanzeige für die Erinnerungsfunktion. Das normale Symbol von &kalarm; zeigt an, dass die Erinnerungsfunktion aktiv ist. Ein ausgegrautes Symbol zeigt an, dass die Erinnerungsfunktion nicht aktiv ist.

Wenn Sie den Mauszeiger über das Symbol bewegen, erscheint eine Kurzinfo mit den nächsten fälligen Erinnerungen innerhalb der nächsten 24 Stunden. Sie können diese Funktionalität im Dialog KAlarm einrichten ... abschalten und die Anzahl der angezeigten Erinnerungen einstellen.

Klicken Sie mit der linken Maustaste auf das Kontrollleistensymbol, um das Hauptfenster von &kalarm; ein- und auszublenden.

Klicken Sie mit der rechten Maustaste auf das Kontrollleistensymbol, um das Kontextmenü aufzurufen.

Erinnerungen aktivieren

  Die Überwachung von Erinnerungen aktivieren. Diese Einstellung wird nur dann angezeigt, wenn die Überwachung von Erinnerungen ausgeschaltet ist.

  Siehe auch Aktivieren/Deaktivieren der Überwachung von Erinnerungen.

Erinnerungen deaktivieren

  Deaktiviert die Überwachung von Erinnerungen. Diese Einstellung wird nur dann angezeigt, wenn die Überwachung von Erinnerungen aktiviert ist.

  Siehe auch Aktivieren/Deaktivieren der Überwachung von Erinnerungen.

Neue Erinnerung ...

  Öffnet den Dialog zum Erstellen einer neuen Erinnerung.

Neue Erinnerung von Vorlage

  Dies zeigt die Liste der Erinnerungsvorlagen in einem Menü an. Wenn Sie einen Eintrag auswählen, wird der Dialog zum Erstellen einer neuen Erinnerung angezeigt und die ausgewählte Erinnerungsvorlage geladen.

&kalarm; einrichten ...

  Zeigt den Einrichtungsdialog von &kalarm; an.

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

Wiederherstellen / Minimieren

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

  Diese Einstellung ist nur im Modus "Ständig im Systembereich aktiv" verfügbar. (Eine Erläuterung der Programm-Modi finden Sie unter &kalarm; einrichten.)

Beenden

  Schließt das &kalarm;-Kontrollleistensymbol.

  Im ständigen Programmmodus werden außerdem alle Hauptfenster von &kalarm; geschlossen. Das hat keine Auswirkungen auf die Überwachung von Erinnerungen durch die Erinnerungsfunktion (sofern Sie nicht außerdem die Einstellung Erinnerungsfunktion nur bei laufendem Programm aktivieren im Einstellungsdialog ausgewählt haben).

#### &kalarm; im Systembereich der Kontrollleiste anzeigen

Damit &kalarm; in der Kontrollleiste anzeigt werden kann, müssen Sie &kde; oder einen anderen passenden Fenstermanager verwenden. Falls &kalarm; im Modus ständig im Systembereich aktiv läuft, wird das Symbol in der Kontrollleiste immer angezeigt. Die folgenden Anweisungen gelten nur, wenn die Einstellung Nur bei Bedarf starten aktiv ist. (Siehe auch &kalarm; einrichten für eine Beschreibung der Modi.)

Damit &kalarm; im Systembereich der &kde;-Kontrollleiste angezeigt wird, wählen Sie im Menü Ansicht Im Systembereich anzeigen.

&kalarm; kann wie folgt wieder aus der Kontrollleiste entfernt werden:

- Wählen Sie im Menü Ansicht Nicht im Systembereich anzeigen.

- Klicken Sie mit der rechten Maustaste auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü Beenden.

### Erinnerungsdaten aktualisieren

Tritt der Fall auf, dass eine Erinnerung trotz Fälligkeit nicht ausgelöst wurde, können Sie die Alarmliste aktualisieren und alle ausgelassenen Erinnerungen auslösen, indem Sie im Menü Aktionen Erinnerungsdaten aktualisieren auswählen.

&kalarm; löst nicht ausgelöste Erinnerungen durch Zurücksetzen der Erinnerungsfunktion aus. Diese wird im Abschnitt Erinnerungsfunktion genauer erklärt.

### Erinnerungsfunktion aktivieren/deaktivieren

Erinnerungen können sowohl komplett als auch individuell aktiviert und deaktiviert werden:

- Erinnerungen aktiviert bezieht sich auf alle Erinnerungen. Wenn das Überwachen von Erinnerungen deaktiviert ist, prüft die Erinnerungsfunktion keine Fälligkeiten und somit werden auch keine Erinnerungen mehr angezeigt. Wenn das Überwachen von Erinnerungen eingeschaltet ist (dies ist die normale Situation), werden alle nicht manuell deaktivierten Erinnerungen zu ihrer Fälligkeit ausgelöst.

- Erinnerungen können individuell ein- oder abeschaltet werden, unabhängig vom gesamten Überwachungsstatus. Der Aktivierungsstatus einzelner Erinnerungen wird also durch das grundsätzliche Deaktivieren und wieder Reaktivieren von Erinnerungen nicht beeinflusst. Anders als bei der Erinnerungsüberwachung, die z. B. durch ein nicht laufendes &kalarm; außer Funktion sein könnte, lässt sich die individuelle Aktivierung/Deaktivierung pro Alarm nur über ein Menübefehle erreichen.

  Der individuelle Aktivierungsstatus einer Erinnerung ist in der Erinnerungs-Liste an der Farbe des jeweiligen Eintrags erkennbar. Die Farben sind unter Schriftart & Farbe einstellbar.

Damit eine Erinnerungsmeldung ausgelöst wird, muss sowohl die individuelle als auch die globale Erinnerungsfunktion aktiviert sein.

#### Aktivieren der Erinnerungsfunktion

Wenn &kalarm; ständig im Systembereich der Kontrollleiste aktiv ist und die Einstellung Erinnerungsfunktion nur bei laufendem Programm aktivieren aausgewählt ist, müssen Sie sicherstellen, dass &kalarm; läuft, damit die Erinnerungsfunktion aktiv ist.

Ist die Erinnerungsfunktion deaktiviert, können Sie diese wie folgt aktivieren:

- Wählen Sie im Menü Aktionen Erinnerungen aktiviert .

- Klicken Sie mit der rechten Maustaste auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü Erinnerungen aktiviert.

Hierdurch wird, sofern nötig, die Erinnerungsfunktion gestartet und von nun an wird die Liste der festgelegten Erinnerungen überwacht.

#### Deaktivieren der Erinnerungsfunktion

Die Überwachung von Erinnerungen kann auf verschiedene Arten deaktiviert werden. &kalarm; wird bis zur erneuten Aktivierung der Überwachung daran gehindert, weitere Erinnerungsnachrichten anzuzeigen, oder - falls die Erinnerungsfunktion beim Anmelden gestartet wird - bis zur nächsten Anmeldung.

Um die Erinnerungsfunktion zu deaktivieren, ohne die Erinnerungsfunktion zu stoppen, gehen Sie wie folgt vor:

- Wählen Sie im Menü Aktionen Erinnerungen deaktivieren.

- Klicken Sie mit der rechten Maustaste auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü Erinnerungen deaktivieren.

- Ist &kalarm; ständig im Systembereich aktiv und ist die Einstellung Erinnerungsfunktion nur bei laufendem Programm aktivieren eingeschaltet, beenden Sie &kalarm;.

Deaktivierung von Erinnerungen durch Anhalten der Erinnerungsfunktion:

- Wählen Sie Einstellungen Steuerung des Erinnerungsprogramms .... Es wird der Dialog Diensteverwaltung angezeigt, der die Möglichkeit zum Starten und Anhalten der Erinnerungsfunktion bietet.

#### Die Erinnerungsfunktion individuell aktivieren/deaktivieren

Ist die individuelle Erinnerungsfunktion deaktiviert, können Sie diese wie folgt aktivieren:

- Markieren Sie die gewünschten Einträge in der Liste und wählen Sie im Menü Aktionen Aktivieren.

- Klicken Sie mit der &RMBn; auf die gewünschten Listeneinträge und wählen Sie im Kontextmenü Aktivieren.

Zum Deaktivieren der Erinnerungsfunktion für einzelne Einträge können Sie wie folgt vorgehen:

- Markieren Sie die gewünschten Einträge in der Liste und wählen Sie im Menü Aktionen Deaktivieren.

- Klicken Sie mit der &RMBn; auf den gewünschten Listeneintrag und wählen Sie im Kontextmenü Deaktivieren.

### Beenden des Programms

Sie beenden &kalarm;, indem Sie alle Fenster und das Symbol im Systembereich der Kontrollleiste schließen. Wenn das Programm ständig im Systembereich aktiv ist, müssen Sie alle Nachrichtenfenster schließen und im Kontextmenü des Kontrollleistensymbols Beenden wählen.

Die Wirkung des Menüeintrages Datei Beenden oder der Kontextmenüeintrag Beenden hängt vom Ausführungsmodus ab: Im Modus Nur bei Bedarf starten wird das Symbol ausgeblendet, im Modus Ständig im Systembereich aktiv wird das Programm beendet.

Das Beenden von &kalarm; hat keine Auswirkungen auf dieErinnerungsfunktion, die weiterhin die Liste der festgelegten Erinnerungen überwacht und die Anzeige der Erinnerungsmeldungen veranlasst (sofern Sie nicht im Dialog &kalarm; einrichten die Einstellung Erinnerungsfunktion nur bei laufendem Programm aktivieren) ausgewählt haben.

## &kalarm; einrichten

Um &kalarm; an Ihre Bedürfnisse und Ihr System anzupassen, wählen Sie im Menü Einstellungen &kalarm; einrichten .... Es wird der Einrichtungsdialog von &kalarm; angezeigt.

### Allgemein

Der Bereich Allgemein erlaubt die Einstellung des Verhaltens von &kalarm;:

- Ausführungsmodus: Diese Einstellungen legen das Verhalten des Kontrollleistensymbols fest und erlauben die Beeinflussung der Nutzung der Systemresourcen durch &kalarm; z.B. durch Festlegen, ob &kalarm; ständig aktiv ist oder nicht. Wenn die Auslastung des Systems eine Rolle spielt, ist möglicherweise das Starten bei Bedarf erwünscht. Hierbei wird das Kontrollleistensymbol nicht angezeigt. Ist das Kontrollleistensymbol ständig im Systembereich aktiv werden mehr Systemresourcen verbraucht, aber Sie haben den Vorteil, dass der aktuelle Status immer verfügbar und der Zugriff auf &kalarm; erleichtert wird. Das Starten von &kalarm; bei Bedarf hat keine Auswirkung auf die Anzeige der Erinnungen, da für die Überwachung der Fälligkeiten nicht &kalarm; sondern die Erinnerungsfunktion zuständig ist.

  - Nur bei Bedarf starten: &kalarm; wird nur gestartet, wenn eine Erinnerung fällig ist, wenn Sie es von Hand starten oder wenn das Symbol in der Kontrollleiste angezeigt wird. In diesem Ausführungsmodus hat das Beenden des Symbols im Systembereich der Kontrollleiste keine Auswirkung auf Fenster von &kalarm;.

  - Ständig im Systembereich aktiv: &kalarm; läuft ständig und das Symbol im Systembereich der Kontrollleiste wird angezeigt, solange es aktiv ist. In diesem Modus werden beim Beenden über das Symbols in der Kontrollleiste das Hauptfenster von &kalarm; geschlossen und die Anwendung beendet, wenn gerade keine Erinnerungsfenster angezeigt werden. In diesem Modus sind folgende Einstellungen möglich:

    - Erinnerungsfunktion nur bei laufendem Programm aktivieren: Das Aktivieren dieser Einstellung bewirkt, dass Erinnerungen nur ausgelöst werden, wenn das Symbol in der Kontrollleiste sichtbar ist.

      - Vor Beenden warnen: Werden Erinnerungen nur ausgelöst, solange &kalarm; läuft, müssen Sie das Beenden von &kalarm; über das Symbol in der Kontrollleiste bestätigen. Dies verhindert, dass Sie versehentlich die Überwachung der Erinnerungen ausschalten. Zur Sicherheit wird diese Einstellung automatisch aktiviert, sobald Sie den Ausführungsmodus ändern.

  - Automatisch beim Anmelden starten: &kalarm; wird bei der Anmeldung in &kde; gestartet. Auf diese Weise ist sichergestellt, dass &kalarm; ständig läuft, bis Sie die Anwendung beenden.

  - Symbol im Systembereich beim Anmelden starten: Hierbei wird das Kontrollleistensymbol von &kalarm; bei der Anmeldung gestartet. &kalarm; bleibt aktiv bis das Symbol im Systembereich der Kontrollleiste beendet wird.

  - Überwachen der Erinnerungen beim Anmelden einschalten: Dadurch wird die Erinnerungsfunktion und damit auch die Erinnerungsüberwachung bei der KDE-Anmeldung gestartet. Damit Erinnerungen auch tatsächlich ausgelöst werden, müssen natürlich die entsprechenden Einstellungen im Abschnitt Ausführungsmodus gemacht werden.

    Diese Option sollte immer aktiviert sein, es sei denn Sie möchten &kalarm; nicht weiter verwenden.

    Diese Option wird automatisch bei jedem Start von &kalarm; erneut aktiviert. Falls Sie diese Option deaktiviert haben und den Start der Erinnerungsfunktion weiterhin verhindern möchten, so müssen Sie dies bei jedem Start von &kalarm; erneut tun.

- Tagesbeginn für Erinnerungen, die nicht auf eine Uhrzeit festgelegt wurden: Setzt die Uhrzeit für den Tagesbeginn, um Erinnerungen auszulösen, die an keine Uhrzeit gebunden sind. Darunter fallen z.B. Erinnerungen, für die Einstellung keine Zeit festgelegt aktiviert wurde. Am Tag der Fälligkeit werden diese Erinnerungen zum nächstmöglichen Zeitpunkt innerhalb von 24h beginnend mit der Uhrzeit des festgelegten Tagesbeginns ausgelöst.

- Wenn Sie Erinnerungen für den 29. Februar festlegen, die jährlich wiederkehren, können Sie festlegen, wie diese in den Jahren behandelt werden, die keine Schaltjahre sind. Die folgenden Optionen stehen zur Verfügung:

  - 28. Februar: Die Erinnerungsmeldung wird in Schaltjahren am 29. Februar ausgelöst, in allen anderen Jahren am 28. Februar.

  - 1. März: Die Erinnerungsmeldung wird in Schaltjahren am 29. Februar ausgelöst, in allen anderen Jahren am 1. März.

  - aussetzen: Die Erinnerungsmeldung wird in Schaltjahren am 29. Februar ausgelöst, in allen anderen Jahren wird die Erinnerungsmeldung ausgesetzt.

  Die Änderung dieser Einstellung bewirkt keine Änderung der nächsten Fälligkeit laufender Erinnerungen. Sie wirkt sich nur auf neu angelegte Erinnerungen aus sowie auf bestehende nach deren nächster Fälligkeit.

- Löschen bestätigen: Geben Sie hier an, ob Sie beim Löschen einer Erinnerung um eine Bestätigung gebeten werden wollen.

- Alte Erinnerungen: Die hier aufgeführten Einstellungen beeinflussen die Speicherung bereits abgelaufener Erinnerungen.

  - Erinnerungen nach ihrem Ablauf speichern: Wählen Sie diese Einstellung, wenn Sie abgelaufene Erinnerungen speichern wollen. Ist diese Einstellung nicht markiert, werden abgelaufene Erinnerungen gelöscht.

  - Abgelaufene Erinnerungen löschen nach: Hier können Sie die Anzahl Tage festlegen, die eine Erinnerung nach ihrer letzten Fälligkeit gespeichert bleibt.

  - Alte Erinnerungen löschen: Dieser Knopf löscht alle derzeit gespeicherten Erinnerungen, deren letzte Fälligkeit abgelaufen ist. Erinnerungen, die später ablaufen, werden hiervon nicht beeinflußt und werden wie eingestellt behandelt.

- Terminal für Befehls-Erinnerungen: Hier können Sie auswählen, welches Terminal-Programm zum Ausführen von Erinnerungsbefehlen verwendet werden soll. Die üblichsten Terminalprogramm (xterm und &konsole;) sind bereits voreingerichtet, es stehen aber nur die auf Ihrem System verfügbaren Programme auch tatsächlich zur Auswahl. Sie können die Befehls-Parameter, die diese Programme zum Ausführen Ihres Befehls verwenden, ansehen, indem Sie die Was ist das?-Hilfe zu dem jeweiligen Terminalprogramm aufrufen.

  Wenn Sie ein anderes Programm oder eines aus der Liste aber mit anderen Parametern benutzen möchten, wählen Sie Anderes und geben Sie das Terminal-Programm mit den entsprechenden Parametern in das Textfeld ein. Normalerweise wird der Erinnerungs-Befehl an das Ende dieses Kommandos angefügt. Alternativ können Sie aber auch diese Platzhalter verwenden:

  %c

    Hier wird der Erinnerungs-Befehl erscheinen.

  %w

    Hier wird der Erinnerungs-Befehl erscheinen. Zusätzlich wird noch das Kommando `sleep` angehängt.

  %C

    Es wird eine temporäre Befehlsdatei erstellt, deren Inhalt der Erinnerungs-Befehl ist. Das Kommando zum Ausführen dieser Datei wird hier erscheinen.

  %W

    Es wird eine temporäre Befehlsdatei erstellt, deren Inhalt der Erinnerungs-Befehl mit dem angehängten Kommando `sleep` ist. Das Kommando zum Ausführen dieser Datei wird hier erscheinen.

  Wenn die Befehls-Erinnerung ausgelöst wird, wird der Befehl in Anführungszeichen gestellt und erst dann in das Terminal-Fenster eingefügt.

### E-Mail

Der Bereich E-Mail bietet Einstellungen für den Versand und die Adressierung von E-Mail-Erinnerungen:

- E-Mail-Programm: Geben Sie hier das Programm an, mit dem E-Mail-Erinnerungen versendet werden sollen:

  - KMail: Wenn eine E-Mail-Erinnerung ausgelöst wird, so wird die E-Mail wie folgt mit &kmail; versandt (welches bei Bedarf gestartet wird):

    - Wenn &kmail; in der Version 1.7 oder neuer installiert ist, so wird die E-Mail automatisch versandt.

    - Falls die &kmail;-Version älter ist, so wird die E-Mail in den Postausgang gelegt und späteren Versandt.

  - Sendmail: Bei Fälligkeit einer E-Mail-Erinnerung wird diese automatisch mit sendmail verschickt. Diese Einstellung funktioniert nur, wenn Ihr System für die Verwendung von sendmail oder einem dazu kompatiblen Programm zum Mailversand (z.B. postfix oder qmail) eingerichtet ist

- Gesendete E-Mails in den Versandte Nachrichten Ordner von KMail kopieren: Aktivieren Sie diese Option, wenn bei jedem E-Mail-Versand eine Kopie der E-Mail in &kmail;s Ordner für gesendete Nachrichten kopiert werden soll.

  Diese Einstellung ist nicht verfügbar, wenn &kmail; als E-Mail-Programm ausgewählt ist, weil KMail ohnehin jede E-Mail in diesen Ordner kopiert.

- Wählen Sie die E-Mail-Adresse, die als Absender für E-Mail-Erinnerungen benutzt werden soll:

  - Wählen Sie Von:, um eine E-Mail-Adresse einzugeben.

  - Wählen Sie Adresse aus dem Kontrollzentrum verwenden, um die Adresse als Absender einzustellen, die im Kontrollzentrum eingerichtet ist.

  - Wählen Sie &kmail;-Identitäten verwenden, so haben Sie jedesmal beim Erstellen einer Erinnerung die Möglichkeit, auszuwählen, welche von &kmail;s Identitäten als Absender benutzt werden soll. Für Erinnerungen, die vor dem Einstellen dieser Option erstellt wurden, wird die Standard-Identität verwendet.

- Wählen Sie die E-Mail-Adresse, an die eine Blindkopie gesendet werden soll, wenn die Option Blindkopie an eigenes Postfach aktiviert ist.

  - Im Textfeld Blindkopie können Sie eine E-Mail-Adresse eingeben. Wenn Blindkopien an das Benutzerkonto Ihres Rechners gesendet werden, auf dem &kalarm; läuft, so könnten Sie auch einfach Ihr Benutzerkonto eingeben.

  - Wählen Sie Adresse aus dem Kontrollzentrum verwenden, um die Adresse als Absender einzustellen, die im Kontrollzentrum eingerichtet ist.

- Benachrichtigen, wenn E-Mails an externe Empfänger verschickt werden: Aktivieren Sie diese Einstellung, wenn eine Benachrichtigung angezeigt werden soll, sobald eine E-Mail-Erinnerung an einen externen Empfänger verschickt wird. Dies ist beispielsweise dann nützlich, wenn Sie keine ständige Verbindung ins Internet haben und auf diese Weise die nötigen Schritte zum ordnungsgemäßen Versand der Erinnerung einleiten können.

### Ansicht

Ansicht bietet Einstellungen zur Anzeige von Erinnerungen in &kalarm;:

- Erinnerungsliste: Die hier aufgeführten Einstellungen legen fest, welche Informationen beim Starten von &kalarm; in der Erinnerungsliste angezeigt werden. Sobald &kalarm; gestartet wurde können Sie die Anzeige über das Menü Ansicht ändern.

  - Zeitpunkt der Fälligkeit anzeigen: Wählen Sie diese Einstellung aus, um Datum und Uhrzeit der nächsten Fälligkeit anzuzeigen.

  - Verbleibende Zeit bis zur Fälligkeit anzeigen: Wählen Sie diese Einstellung aus, um die verbleibende Zeit bis zur nächsten Fälligkeit anzuzeigen. Die Zeitspanne wird, sofern nötig, in Tagen, Stunden und Minuten angezeigt.

- Kurzinfo im Systembereich der Kontrollleiste anzeigen: Diese Einstellungen legen fest, welche Informationen in der Kurzinfo angezeigt werden. Diese erscheint, wenn Sie mit dem Mauszeiger über dem Kontrollleistensymbol von &kalarm; verharren.

  - Erinnerungen der nächsten 24 Stunden anzeigen: Ist diese Einstellung aktiv, werden Informationen zu den innerhalb der nächsten 24 Stunden fälligen Erinnerungen angezeigt.

  - Maximale Anzahl angezeigter Erinnerungen: Deaktivieren Sie diese Einstellung, wenn Sie alle innerhalb der nächsten 24 Stunden fälligen Erinnerungen sehen wollen. Andernfalls können Sie hier die Anzahl der angezeigten Erinnerungen begrenzen.

  - Zeitpunkt der Fälligkeit anzeigen: Ist diese Einstellung aktiv, wird der Zeitpunkt der Fälligkeit angezeigt.

  - Verbleibende Zeit bis zur Fälligkeit: Aktivieren Sie diese Einstellung um die verbleibende Zeit bis zur nächsten Fälligkeit anzuzeigen. Die Zeitspanne wird in Stunden und Minuten angezeigt.

    - Vorangestellt: Geben Sie hier ein Symbol oder einen Text an, der bei der Anzeige der verbleibenden Zeit vorangestellt wird. Dies dient zur Unterscheidung der angezeigten Zeitspanne vom Zeitpunkt der Fälligkeit.

- Nachrichtenfenster haben eine Titelzeile und erhalten den Eingabefokus: Diese Einstellung legt den Fenstertyp der Nachrichtenfenster fest, z. B. ob eine Erinnerungsmeldung bei der Anzeige den Eingabefokus erhält. Weitere Einzelheiten finden Sie im Abschnitt Erinnerungsnachrichten.

- Alte Erinnerungen anzeigen: Wählen Sie diese Einstellung, wenn &kalarm; beim Start abgelaufene Erinnerungen anzeigen soll. Sie können die Anzeige nach dem Start von &kalarm; über Ansicht Alte Erinnerungen anzeigen ändern.

- Aktualisierungsintervall für das Symbol im Systembereich: Hierüber wir festgelegt, in welchen Abständen das Symbol von &kalarm; im Systembereich der Kontrollleiste aktualisiert wird. Darunter fällt auch die Überprüfung ob die Erinnerungsfunktion aktiv ist.

### Schriftart & Farbe

Im Bereich Schriftart & Farbe können Sie das Erscheinungsbild von Erinnerungsnachrichten und die in der Erinnerungs-Liste verwendeten Farben festlegen.

- Legen Sie die voreingestellte Schrift und die Hintergrundfarbe für Erinnerungsnachrichten fest.

- Bearbeiten Sie die Farbauswahl, die angezeigt wird, wenn Sie auf das Kombinationsfeld Hintergrundfarbe klicken.

  - Farbe hinzufügen ...: Zeigt einen Dialog zur Farbauswahl an. Die dort ausgewählte Farbe wird der Liste hinzugefügt.

  - Farbe entfernen: Entfernt die gerade im Kombinationsfeld Hintergrundfarbe angezeigt Farbe aus der Liste. Der Eintrag Eigene kann nicht entfernt werden. In diesem Fall ist der Knopf inaktiv.

- Legen Sie die Textfarbe fest, in der deaktivierte Erinnerungen in der Liste angezeigt werden sollen.

- Legen Sie die Textfarbe fest, in der abgelaufene Erinnerungen in der Liste angezeigt werden sollen.

### Bearbeiten

Der Abschnitt Bearbeiten ermöglicht die Auswahl von Standardwerten für den Dialog Neue Erinnerung:

Für die Anzeige von Erinnerungen:

- Setzen Sie hier die Voreinstellungen für die Ankreuzfelder Wenn überfällig, ignorieren, Fenster nach dieser Zeitspanne automatisch schließen und Zurkenntnisnahme der Erinnerungsmeldung bestätigen.

- Setzen Sie hier die voreingestellte Zeiteinheit für Vorab-Erinnerungen.

- Legen Sie hier die Voreinstellungen für Erinnerungs-Aktionen fest.

- Stellen Sie die Klang-Voreinstellungen. Beachten Sie, dass Sie die Klangdatei selbst dann auswählen können, wenn Klang deaktiviert oder Signalton oder Vorlesen ausgewählt ist.

Für Befehls-Erinnerungen:

- Setzen Sie hier die Voreinstellung für die Ankreuzfelder Geben Sie ein Skript ein und Im Terminal ausführen.

Für E-Mail-Erinnerungen:

- Setzen Sie hier die Voreinstellung für das Ankreuzfeld E-Mails als Kopie an sich selbst schicken.

Für alle Arten von Erinnerungen:

- Setzen Sie hier die Voreinstellung für Wiederholungen.

## Befehlszeilenoptionen

Wenn Befehlszeilenoptionen angegeben werden, zeigt &kalarm; die Erinnerungsliste nicht wie oben unter &kalarm; verwenden beschrieben an. Mit Befehlszeilenoptionen können Sie die folgenden Aktionen durchführen:

- Eine neue Erinnerung festlegen

- Steuerung der Erinnerungsfunktion

- Festlegen des Anzeigemodus von &kalarm;

- Hilfe ausgeben

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

In der Befehlszeile kann nur jeweils eine &kalarm;-Aktion aufgeführt werden. Wollen Sie mehrere Aktionen ausführen lassen, müssen Sie &kalarm; für jede der Aktionen einzeln ausführen.

### Eine neue Erinnerungsnachricht festlegen

Die folgenden Optionen werden zur Festlegung einer neuen Erinnerungsnachricht verwendet:

Option | Beschreibung
--- | ---
`-a`, `--ack-confirm` | Nachfragen, wenn die Erinnerungsnachricht bestätigt wird.
`-A`, `--attach URL` | Legt den Namen oder die &URL; eine Datei fest, die an die E-Mail angehängt werden soll. Die Option kann gegebenenfalls mehrfach verwendet werden. Diese Option kann nur zusammen mit der Option `--mail` angegeben werden.
`--auto-close` | Schließe das Erinnerungsfenster nach Ablauf des mit `--late-cancel` übergebenen Zeitraums. Diese Einstellung erfordert die Angabe von `--late-cancel`.
`-b`, `--beep` | Einen hörbaren Piepton ausgeben, wenn die Nachricht angezeigt wird. Dabei dürfen nicht gleichzeitig die Optionen `--sound` und `--play-repeat` verwendet werden.
`--bcc` | Blindkopie der E-Mail an Sie. Diese Option kann nur zusammen mit der Option `--mail` angegeben werden.
`-c`, `--color`, `--colour color` | Setzt die Hintergrundfarbe mit einem in &Qt; festgelegten Farbnamen oder durch Angabe eines hexadezimalen Wertes der Form 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg color` | Setzt die Vordergrundfarbe mit einem in &Qt; festgelegten Farbnamen oder oder durch Angabe eines hexadezimalen Wertes der Form 0xRRGGBB.
`-d`, `--disable` | Erinnerung deaktivieren. Die Erinnerung wird erst nach manueller Aktivierung wieder aktiv.

`-e`, `--exec Befehlzeile`

Hier können Sie eine Befehlszeile zur Ausführung angeben. Wird eine solche angegeben, muss diese als letzte Option an &kalarm; übergeben werden. Alle folgenden Parameter und Optionen werden als zur Befehlszeile gehörig interpretiert. `--file` und `--mail` können nicht zusammen mit dieser Option angegeben werden. `--ack-confirm`, `--beep`, `--color` und `--colorfg` werden bei gleichzeitiger Angabe dieser Option ignoriert.

`-f`, `--file URL` | Legt den Namen oder die &URL; einer Text- oder Bilddatei fest, deren Inhalt in der Erinnerungsnachricht angezeigt wird. `--exec` and `--mail` können nicht zusammen mit dieser Option angegeben werden. message darf nicht zusammen mit dieser Option verwendet werden.
`-F`, `--from-id ID` | Verwende die angegebene Identität aus &kmail; für die E-Mail. Die Angabe von `--mail` ist für diese Option erforderlich.

`-i`, `--interval Periode`

Legt das Intervall zwischen Wiederholungen der Erinnerung fest. Stunden/Minuten müssen im Format nHnM angegeben werden. n steht jeweils für eine Zahl, &eg; 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. Wird dabei die Option `--recurrence` angegeben, ist die Angabe von Y (Jahre) und M (Monate) nicht erlaubt.Diese Option ist zwingend erforderlich, falls die Option `--repeat` oder `--until` angegeben wird.

`-k`, `--korganizer` | Die Erinnerung wird als Ereignis im aktiven Kalender von &korganizer; angezeigt.
`-l`, `--late-cancel Zeitraum` | Die Erinnerung wird verworfen, wenn sie nicht innerhalb des angegebenen Zeitraums nach Erreichen der Fälligkeit ausgegeben werden kann. Der angegebene Zeitraum wird im selben Format angegeben wie bei der Option `--reminder` beschrieben ist. Die Voreinstellung für Zeitraum ist 1 Minute.
`-L`, `--login` | Die Erinnerung wird bei jedem Anmelden ausgelöst. Die Optionen `--interval`, `--repeat` und `--until` können nicht zusammen mit dieser Option verwendet werden.
`-m`, `--mail address` | Versenden einer E-Mail an die angegebene Adresse. Diese Option kann mehrfach angegeben werden. `--exec` und `--file` können nicht zusammen mit dieser Option angegeben werden. `--ack-confirm`, `--beep`, `--color` und `--colorfg` werden bei Angabe dieser Option ignoriert.
`-p`, `--play URL` | Legt den Namen oder die &URL; einer Klangdatei fest, die beim Anzeigen der Erinnerungsnachricht abgespielt wird. Diese Option kann nicht zusammen mit `--play-repeat`, `--beep` und `--speak` verwendet werden.
`-P`, `--play-repeat URL` | Legt den Namen oder die &URL; einer Klangdatei fest, die solange abgespielt wird wie die Erinnerungsachricht angezeigt wird. Diese Option kann nicht zusammen mit `--play-repeat`, `--beep` und `--speak` verwendet werden.
`--recurrence spec` | Diese Erinnerung wiederkehrend setzen. Geben Sie die Wiederholungseinstellungen in der Syntax von iCalendar an (beschrieben in RFC2445). Ein Beispiel: FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. `--until` kann nicht zusammen mit dieser Option verwendet werden.

`-r`, `--repeat Anzahl`

Legt fest, wie oft eine Erinnerung ausgelöst werden soll, oder, wenn es sich um eine wiederkehrende Erinnerung handelt, die über `--recurrence` angegeben wurde, wie oft die Erinnerung bei jeder Wiederholung ausgelöst wird. Ist die Einstellung `--recurrence` nicht angegeben, können Sie den Wert -1 angeben, damit die Erinnerung unbegrenzt wiederholt wird. Diese Einstellung muss gemeinsam mit der Einstellung `--interval` angegeben werden. Die Einstellung `--until` kann nicht mit dieser Einstellung kombiniert werden.

`-R`, `--reminder period`

Ausgabe einer Erinnerung eine bestimmte Zeit im Voraus. Diese gilt für die Erinnerung und sämtliche Wiederholungen, sofern vorhanden. Stunden/Minuten werden im Format nHnM, angegeben. Hierbei ist n ein Zahlenwert, &eg; 3H30M. 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. Diese Option kann nicht zusammen mit `--exec`, `--mail` oder `--reminder-once` verwendet werden.

`--reminder-once period` | Es wird genau eine Erinnerung im angegebenen Zeitraum vor der ersten Wiederholung dieser Erinnerung ausgegeben. Bei weiteren Wiederholungen erfolgt keine Erinnerung im Voraus. Die Einstellung kann nicht zusammen mit `--exec`, `--mail` oder `--reminder` angegeben werden.
`-s`, `--speak` | Die Nachricht wird vorgelesen, wenn sie angezeigt wird. Diese Einstellung erfordert, dass die Anwendung KTTSD sowie eine entsprechender Sprachsynthesizer installiert und eingerichtet ist. Diese Option kann nicht gemeinsam mit `--beep`, `--play` oder `--play-repeat` verwendet werden.
`-S`, `--subject subject` | Die Betreffzeile der E-Mail. Diese Option kann nur zusammen mit `--mail` verwendet werden.
`-t`, `--time Datum/Zeit` | Löst die Erinnerung am angegebenen Datum oder zum angegebenen Zeitpunkt aus. Sie geben entweder ein Datum ohne Zeit im Format jjjj-mm-dd an oder Datum und Zeit im Format [[[jjjj-]mm-]dd-]hh:mm an (fehlende Angaben werden auf den heutigen Tag gesetzt).
`-v`, `--volume percentage` | Legt die Lautstärke für das Abspielen der Klangdatei fest. Diese Option kann nur gemeinsam mit `--play` oder `--play-repeat` angegeben werden.
`-u`, `--until Datum/Zeit` | Wiederholt den Alarm bis zum angegebenen Zeitpunkt. Sie können ein Datum ohne Zeitangabe wie bei der Option `--time` beschrieben angeben. Die Option `--interval` muss hier angegeben werden, die Optionen `--repeat` und `--recurrence` dürfen nicht zusammen mit dieser Option angegeben werden.
message | Der anzuzeigende Text der Nachricht. Ist die Option `--mail` angegeben, der Text der E-Mail.

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 dieErinnerungsfunktion anzuhalten oder zu starten, den Dialog Neue Erinnerung oder die Anzeige von &kalarm; zu steuern.

Im Abschnitt Erinnerungsfunktion werden die Auswirkungen des Zurücksetzens oder Anhaltens der Erinnerungsfunktion beschrieben.

Option | Beschreibung
--- | ---
`--edit eventID` | Öffnet die Erinnerung mit der angegebenen ID im Dialog zur Bearbeitung von Erinnerungen.
`-n`, `--edit-new` | Öffnet den Dialog zum Erstellen einer neuen Erinnerung.
`--edit-new-preset Vorlagenname` | Zeigt den Bearbeitungsdialog für das Erstellen einer neuen Erinnerung an. Die angegebene Vorlage ist voreingestellt.
`--reset` | Setzt die Erinnerungsfunktion zurück.
`--stop` | Hält die Erinnerungsfunktion an.
`--tray` | Zeigt &kalarm; als Symbol im Systemabschnitt an.

Ein Beispiel für das Zurücksetzen der Erinnerungsfunktion:

    % kalarm --reset

### Hilfe-Optionen

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 E-Mail-Adressen der Autoren von &kalarm;.
`-v`, `--version` | Zeigt die Versionen der &Qt;-Bibliothek, von &kde; und von &kalarm;.
`--license` | Zeigt Informationen zur Lizenz an.

## Die Erinnerungsfunktion

Die Erinnerungsfunktion, &kalarmd;, überwacht die Kalenderdatei von &kalarm;. Wenn die Fälligkeit einer Erinnerung erreicht ist, veranlasst sie &kalarm;, zur Anzeige einer Erinnerungsmeldung oder zum Verwerfen der Nachricht, sofern die Fälligkeit bereits überschritten wurde und die Einstellung zur Anzeige abgelaufener Erinnerungen nicht ausgewählt wurde.

Dadurch wird die Erinnerungsfunktion im Hintergrund ohne Benutzeroberfläche gestartet. Ihre Steuerung wird weiter unten beschrieben.

### Start, Zurücksetzen und Anhalten der Erinnerungsfunktion

Die Erinnerungsfunktion wird üblicherweise bei der Anmeldung an &kde; gestartet (sofern Sie nicht den Autostart im Dialog Kalarm einrichten abgeschaltet haben) und läuft ständig bis zur Abmeldung. Falls aus irgend einem Grund die Erinnerungsfunktion nicht aktiv ist, werden die eingerichteten Erinnerungen nicht überwacht und &kalarm; zeigt keine Erinnerungsmeldungen an.

#### Das Starten der Erinnerungsfunktion

Um die Erinnerungsfunktion zu starten, können Sie &kalarm; entweder im graphischen Modus starten (d. h. ohne Befehlszeilenoptionen außer `--tray`), Erinnerungen mit Hilfe des Kontextmenüs von &kalarm; im Systembereich der Kontrollleiste aktivieren, den Dienst nach der weiter unten gegebenen Beschreibung neu starten oder den Start direkt von der Befehlszeile ausführen.

    % kalarmd

#### Das Zurücksetzen der Erinnerungsfunktion

Sie können die Erinnerungsfunktion auch ohne vorheriges Anhalten zurücksetzen. Das Zurücksetzen veranlasst dieErinnerungsfunktion, dazu, die Liste der festgesetzten Erinnerungen aus der Kalenderdatei neu einzulesen und die für &kalarm; relevanten Daten neu zu initialisieren.

Welche Gründe für ein Zurücksetzen der Erinnerungsfunktion gibt es? Es ist zwar unwahrscheinlich aber nicht unmöglich, dass &kalarm; zum Zeitpunkt der Fälligkeit einer Erinnerungsnachricht nicht gestartet werden konnte. Dadurch wird diese Nachricht nicht angezeigt, solange dieErinnerungsfunktion nicht zurückgesetzt oder neu gestartet wird.

Zurücksetzen startet die Erinnerungsfunktion, falls diese bisher noch nicht aktiv war.

Um die Erinnerungsfunktion zurückzusetzen, können Sie entweder den Menübefehl Aktionen Erinnerungdaten aktualisieren verwenden oder den folgenden Befehl eingeben:

    % kalarm --reset

#### Das Anhalten der Erinnerungsfunktion

Das Anhalten der Erinnerungsfunktion unterbricht die weitere Überwachung der Liste mit den festgelegten Erinnerungen bis zum Neustart der Erinnerungsfunktion.

Zum Anhalten der Erinnerungsfunktion geben Sie den folgenden Befehl ein:

    % kalarm --stop

## Entwicklerhandbuch zu &kalarm;(in englisch)

&kalarm; bietet für andere Programme eine Schnittstelle mit folgenden Funktionen:

- Eine neue Erinnerung festlegen

- Auslösen oder Verwerfen einer festgelegten Erinnerung

- Abbrechen einer bereits festgelegten Erinnerung

- Auslösen einer bereits festgelegten Erinnerung

- Anzeigen des Dialogs zum Bearbeiten von Erinnerungen

Jede der oben genannten Funktionen kann über eine &DCOP;-Funktion oder über die Befehlszeile aufgerufen werden. Wenn &kalarm; bereits gestartet wurde sollten Sie &DCOP;-Funktionen verwenden.

### Schnittstelle zu &DCOP;

Die in diesem Dokument beschriebenen DCOP-Aufrufe sind im Objekt `request` von &kalarm; implementiert. Die Schnittstelle dazu ist in der Datei `kalarmiface.h` festgelegt.

In der Version 1.2 von &kalarm; wurde die DCOP-Schnittstelle komplett überarbeitet, um einen bequemeren Aufruf der Funktionen zu ermöglichen und eine bessere Anpassung an die Standard-DCOP-Konfiguration von &kde; zu erreichen. Aus Kompatibilitätsgründen ist die alte Schnittstelle weiterhin verfügbar, wird aber künftig entfallen.

cancelEvent

#### cancelEvent

Verwerfen einer bereits festgelegten Erinnerung

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

##### Parameter

`calendarFile`

  Gibt die &URL; (nicht den Pfad) der Kalenderdatei an, die das zu löschende Ereignis enhält.

`eventID`

  Gibt die eindeutige Kennung des zu löschen Ereignisses an, das incalendarFile gespeichert ist.

##### 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.

triggerEvent

#### triggerEvent

Auslösen eines bereits festgelegten Alarmes

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

##### Parameter

`calendarFile`

  Gibt die &URL; (nicht den Pfad) der Kalenderdatei an, die das auszulösende Ereignis enthält.

`eventID`

  Gibt die eindeutige Kennung des auszulösenden Ereignisse an, das in calendarFile gespeichert ist.

##### Beschreibung

`triggerEvent()` ist eine &DCOP;-Funktion zur sofortigen Auslösung oder Ausführung einer Erinnerung. (Die festgelegte Fälligkeit spielt dabei keine Rolle). &kalarm; holt die Erinnerung aus der Kalenderdatei und zeigt sie an bzw. führt die entsprechende Aktion aus.

Ist die Erinnerung bereits fällig, löschte &kalarm; alle Fälligkeitstermine bis zum aktuellen Zeitpunkt und löscht die Erinnerung aus der Kalenderdatei, sofern keine weiteren Wiederholungen anliegen. Ist die Erinnerung noch nicht fällig, bleiben die vorgesehenen Fälligkeiten bestehen.

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.

handleEvent

#### handleEvent

Auslösen oder Löschen einer Erinnerung.

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

##### Parameter

`calendarFile`

  Gibt die &URL; (nicht den Pfad) der Kalenderdatei an, die das anzuzeigende, auszuführende bzw.zu löschende Ereignis enthält.

`eventID`

  Gibt die eindeutige Kennung des Ereignisses an, das an angezeigt, ausgeführt oder gelöscht werden soll und in calendarFile gespeichert ist.

##### Beschreibung

`handleEvent()` ist eine &DCOP;-Funktion zum Anzeigen, Ausführen oder Löschen einer Erinnerung. &kalarm; holt die Erinnerung aus der Kalenderdatei und führt, abhängig von deren Fälligkeit, die entsprechende Aktion aus.

- Ist die Erinnerung noch nicht fällig, geschieht gar nichts.

- Ist die Erinnerung fällig, wird wie folgt verfahren: Ist das Flag late-cancel gesetzt und die Erinnerung ist bereits überfällig, d. h. die Fälligkeit ist um den Zeitraum für late-cancel überschritten, zeigt &kalarm; diese weder an noch wird sie ausgeführt. Liegen keine weiteren Wiederholungen an, wird die Erinnerung von &kalarm; aus der Kalenderdatei gelöscht.

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

Eine neue Erinnerung festlegen.

    bool scheduleMessage(const QString& message,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const KURL& audioURL,
                         int reminder,
                         const QString& recurrence,
                         int simpleRepeatInterval,
                         int simpleRepeatCount)

    bool scheduleMessage(const QString& message,
                         const QString& dateTime,
                         int lateCancel, int flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const KURL& audioURL,
                         int reminder,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleMessage(const QString& message,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const KURL& audioURL,
                         int reminder,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parameter

`message`

  Gibt den Nachrichtentext der festgelegten Erinnerung an.

`dateTime`

  Legt das Datum oder Datum und Uhrzeit fest, an der die Nachricht angezeigt werden soll. Ist nur das Datum angegeben, sollte die Zeichenfolge das Format JJJJ-MM-TT aufweisen (so, wie es von `QDate::toString(Qt::ISODate)` zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format JJJJ-MM-TTHH:MM[:SS] (so, wie es von `QDateTime::toString(Qt::ISODate)` zurückgegeben wird) oder HH:MM[:SS] (wie es von `QTime::toString(Qt::ISODate)` zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.

`lateCancel`

  Die Erinnerung wird verworfen, wenn Sie nicht innerhalb des angegebenen Zeitraums (in Minuten) nach Fälligkeit ausgelöst werden kann. Ist der Wert 0 angegeben, wird die Erinnerung ausgelöst, egal wie viel Zeit nach der Fälligkeit verstrichen ist.

`flags`

  Angabe der gewünschten Flags für die Erinnerung. Die Kombination mehrerer Flags erfolgt durch ein logisches ODER. Die hier möglichen Flags sind in der Klasse `KAlarmIface` in `alarmiface.h` definiert. Beachten sie, dass nicht alle Flags auf Textbenachrichtigungen anwendbar sind.

`bgColor`

  Legt die Hintergrundfarbe für die Anzeige der Nachricht fest. Die Zeichenfolge kann im Format #RRGGBB (wie von `QColor::name()` zurückgegeben) übergeben werden. Alternativ kann die Zeichenfolge in jedem Format übergeben werden, das von `QColor::setNamedColor()` akzeptiert wird. Beispielsweise als Name aus der Farbdatenbank von X (&eg; red oder steelblue). Wird der Wert null als Zeichenfolge übergeben, wird die derzeit gültige Standard-Hintergrundfarbe verwendet.

`fgColor`

  Legt die Vordergrundfarbe für die Anzeige der Nachricht fest. Das Format der Zeichenfolge entspricht der des Parameters `bgColor`. Wird als Zeichenfolge der Wert null übergeben, wird die derzeit eingestellte Standard-Vordergrundfarbe verwendet.

`font`

  Legt die Schriftart für die Anzeige der Nachricht fest. Das Format der Zeichenfolge entspricht der Ausgabe von `QFont::toString()`. Wird die Zeichenfolge auf null gesetzt, wird die Nachricht mit der derzeit aktuellen Standard-Schriftart für Nachrichten angezeigt.

`audioURL`

  Gibt den Namen oder die &URL; einer Klangdatei an, die bei der Anzeige der Nachricht abgespielt wird. Setzen Sie den Wert auf null, wenn keine Klangdatei abgespielt werden soll.

`reminder`

  Legt fest, wieviele Minuten im Voraus eine Erinnerung für eine bald fällige Erinnerungsmeldung und, sofern vorhanden, deren Wiederholungen angezeigt werden soll. Stellen Sie hier den Wert 0 ein, erfolgt keine Erinnerung im Voraus.

`recurrence`

  Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in RFC2445 beschrieben ist. Die Angabe FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO würde 4 Wiederholungen im Abstand von drei Monaten, jeweils am letzten Montag im Monat festlegen. Für Erinnerungen, die nur einen Fälligkeitstermin haben, geben Sie hier eine leere Zeichenfolge an.

`recurType`

  Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse `KAlarmIface` in der Datei `kalarmiface.h` festgelegt. Monatliche Wiederholungen finden am Tag des Monatstyps statt, jährliche Wiederholungen finden am Datum im Jahrestyp statt, wobei in beiden Fällen das Datum dem Parameter `dateTime` entnommen wird.

`recurInterval`

  Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch `recurType` angegeben) zwischen zwei Fälligkeitsterminen an.

`recurCount`

  Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.

`endDateTime`

  Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter `dateTime` eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beeinhaltet `dateTime` nur eine Datum, darf auch dieser Parameter nur ein Datum enthalten.

`simpleRepeatInterval`

  Gibt die Anzahl Minuten zwischen den einfachen Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine einfache Wiederholung.

`simpleRepeatCount`

  Gibt die Anzahl der einfachen Wiederholungen einer Erinnerung an, einschließlich des ersten Auftretens.

##### Beschreibung

`scheduleMessage` ist eine &DCOP;-Funktion zum Festlegen der Fälligkeit einer Erinnerung zum angegebenen Datum und Uhrzeit. Die Funktion kennt drei Varianten. Der häufigste Aufruf erlaubt die Angabe einer frei wählbaren Wiederholung - verwenden Sie diese auch zum Festlegen von Erinnerungen, die nicht wiederholt werden sollen. Die anderen Varianten des Aufrufs bieten bequemen Zugang auf einen beschränkten Satz von Wiederholungsarten. Eine Variante gibt die Anzahl der Wiederholungen an, die andere den Termin für die letzte Fälligkeit.

Ist die festgelegte Fälligkeit (einschließlich der Wiederholungen) bereits überschritten, zeigt &kalarm; die Nachricht sofort an (oder ignoriert den Aufruf, wenn der Parameter `lateCancel` angegeben wurde und der dort festgelegte Zeitraum überschritten wurde). Liegt die festgelegte Fälligkeit (oder eine Wiederholung) in der Zukunft, speichert &kalarm; die Erinnerungsnachricht für die spätere Anzeige in der Kalenderdatei.

scheduleFile

#### scheduleFile

Festlegen einer neuen Erinnerung, die den Inhalt einer Text- oder Bilddatei anzeigt.

    bool scheduleFile(const KURL& URL,
                      const QString& dateTime,
                      int lateCancel,
                      int flags,
                      const QString& bgColor,
                      const KURL& audioURL,
                      int reminder,
                      const QString& recurrence,
                      int simpleRepeatInterval,
                      int simpleRepeatCount)

    bool scheduleFile(const KURL& URL,
                      const QString& dateTime,
                      int lateCancel,
                      int flags,
                      const QString& bgColor,
                      const KURL& audioURL,
                      int reminder,
                      int recurType,
                      int recurInterval,
                      int recurCount)

    bool scheduleFile(const KURL& URL,
                      const QString& dateTime,
                      int lateCancel,
                      int flags,
                      const QString& bgColor,
                      const KURL& audioURL,
                      int reminder,
                      int recurType,
                      int recurInterval,
                      const QString& endDateTime)

##### Parameter

`URL`

  Legt die Text- oder Bilddatei fest, deren Inhalt bei Fälligkeit angezeigt wird.

`dateTime`

  Legt das Datum oder Datum und Uhrzeit fest, zu der die Datei angezeigt werden soll. Ist nur das Datum angegeben, sollte die Zeichenfolge das Format JJJJ-MM-TT aufweisen (so, wie es von `QDate::toString(Qt::ISODate)` zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format JJJJ-MM-TTHH:MM[:SS] (so, wie es von `QDateTime::toString(Qt::ISODate)` zurückgegeben wird) oder HH:MM[:SS] (wie es von `QTime::toString(Qt::ISODate)` zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.

`lateCancel`

  Die Erinnerung wird verworfen, wenn Sie nicht innerhalb des angegebenen Zeitraums (in Minuten) nach Fälligkeit ausgelöst werden kann. Ist der Wert 0 angegeben, wird die Erinnerung ausgelöst, egal wie viel Zeit nach der Fälligkeit verstrichen ist.

`flags`

  Angabe der gewünschten Flags für die Erinnerung. Die Kombination mehrerer Flags erfolgt durch ein logisches ODER. Die hier möglichen Flags sind in der Klasse `KAlarmIface` in `kalarmiface.h` definiert. Beachten Sie, dass nicht alle Flags auf Dateierinnerungen anwendbar sind.

`bgColor`

  Gibt die Hintergrundfarbe für die Anzeige der Datei an. Die Zeichenfolge kann im Format #RRGGBB (as returned by `QColor::name()`) erfolgen, wobei RR, GG und BB zweistellige Hexadezimalwerte für Rot, Grün und Blau sind. Alternativ kann die Zeichenfolge in allen Formaten angegeben werden, die von `QColor::setNamedColor()` akzeptiert wird. Beispielsweise als Name aus der Farbdatenban von X (&eg; red or steelblue). Wird als Zeichenfolge der Wert null übergeben, wird die Datei mit der aktuell eingestellten Hintergrundfarbe dargestellt.

`audioURL`

  Gibt den Namen oder die &URL; einer Klangdatei an, die bei der Anzeige der Nachricht abgespielt wird. Setzen Sie den Wert auf null, wenn keine Klangdatei abgespielt werden soll.

`reminder`

  Legt fest, wieviele Minuten im Voraus eine Erinnerung für eine bald fällige Erinnerungsmeldung und, sofern vorhanden, deren Wiederholungen angezeigt werden soll. Stellen Sie hier den Wert 0 ein, erfolgt keine Erinnerung im Voraus.

`recurrence`

  Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in RFC2445 beschrieben ist. Die Angabe FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO würde 4 Wiederholungen im Abstand von drei Monaten, jeweils am letzten Montag im Monat festlegen. Für Erinnerungen, die nur einen Fälligkeitstermin haben, geben Sie hier eine leere Zeichenfolge an.

`recurType`

  Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse `KAlarmIface` in der Datei `kalarmiface.h` festgelegt. Monatliche Wiederholungen finden am Tag des Monatstyps statt, jährliche Wiederholungen finden am Datum im Jahrestyp statt, wobei in beiden Fällen das Datum dem Parameter `dateTime` entnommen wird.

`recurInterval`

  Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch `recurType` angegeben) zwischen zwei Fälligkeitsterminen an.

`recurCount`

  Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.

`endDateTime`

  Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter `dateTime` eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beeinhaltet `dateTime` nur eine Datum, darf auch dieser Parameter nur ein Datum enthalten.

`simpleRepeatInterval`

  Gibt die Anzahl Minuten zwischen den einfachen Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine einfache Wiederholung.

`simpleRepeatCount`

  Gibt die Anzahl der einfachen Wiederholungen einer Erinnerung an, einschließlich des ersten Auftretens.

##### Beschreibung

`scheduleFile()` ist eine &DCOP;-Funktion zur Anzeige einer Text- oder Bilddatei zum übergebenen Zeitpunkt. Abgesehen von der Angabe des Dateinamens oder der &URL; und dem Auslassen der Vordergrundfarbe und der Schriftart, ist die Verwendung dieser Funktion identisch mit `scheduleMessage` - Näheres finden Sie in der Beschreibung dieser Funktion.

scheduleCommand

#### scheduleCommand

Erzeugt eine neue Erinnerung, die bei Fälligkeit einen Shell-Befehl ausführt.

    bool scheduleCommand(const QString& commandLine,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         const QString& recurrence,
                         int simpleRepeatInterval,
                         int simpleRepeatCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parameter

`commandLine`

  Legt den Befehl fest, der bei Fälligkeit ausgeführt werden soll. Der Parameter `flags` zeigt an, ob es sich um eine Befehlszeile oder ein Befehlszeilenskript handelt.

`dateTime`

  Legt das Datum oder Datum und Uhrzeit fest, zu der der Befehl ausgeführt werden soll. Ist nur das Datum angegeben, sollte die Zeichenfolge das Format JJJJ-MM-TT aufweisen (so, wie es von `QDate::toString(Qt::ISODate)` zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format JJJJ-MM-TTHH:MM[:SS] (so, wie es von `QDateTime::toString(Qt::ISODate)` zurückgegeben wird) oder HH:MM[:SS] (wie es von `QTime::toString(Qt::ISODate)` zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.

`lateCancel`

  Die Erinnerung wird verworfen, wenn Sie nicht innerhalb des angegebenen Zeitraums (in Minuten) nach Fälligkeit ausgelöst werden kann. Ist der Wert 0 angegeben, wird die Erinnerung ausgelöst, egal wie viel Zeit nach der Fälligkeit verstrichen ist.

`flags`

  Angabe der gewünschten Flags für die Erinnerung. Die Kombination mehrerer Flags erfolgt durch ein logisches ODER. Die hier möglichen Flags sind in der Klasse `KAlarmIface` in `kalarmiface.h` definiert. Beachten Sie, dass nicht alle Flags auf Erinnerungen mit Befehlszeilen anwendbar sind.

`recurrence`

  Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in RFC2445 beschrieben ist. Die Angabe FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO würde 4 Wiederholungen im Abstand von drei Monaten, jeweils am letzten Montag im Monat festlegen. Für Erinnerungen, die nur einen Fälligkeitstermin haben, geben Sie hier eine leere Zeichenfolge an.

`recurType`

  Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse `KAlarmIface` in der Datei `kalarmiface.h` festgelegt. Monatliche Wiederholungen finden am Tag des Monatstyps statt, jährliche Wiederholungen finden am Datum im Jahrestyp statt, wobei in beiden Fällen das Datum dem Parameter `dateTime` entnommen wird.

`recurInterval`

  Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch `recurType` angegeben) zwischen zwei Fälligkeitsterminen an.

`recurCount`

  Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.

`endDateTime`

  Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter `dateTime` eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beeinhaltet `dateTime` nur eine Datum, darf auch dieser Parameter nur ein Datum enthalten.

`simpleRepeatInterval`

  Gibt die Anzahl Minuten zwischen den einfachen Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine einfache Wiederholung.

`simpleRepeatCount`

  Gibt die Anzahl der einfachen Wiederholungen einer Erinnerung an, einschließlich des ersten Auftretens.

##### Beschreibung

`scheduleCommand()` ist eine &DCOP;-Funktion zur Ausführung des übergebenen Shell-Befehls oder Shell-Skriptes zum angegebenen Zeitpunkt. Abgesehen von der Angabe einer Befehlszeile und dem Auslassen der Nachrichtenfarbe und der Parameter fürSchriftart und für die Klangdatei, ist die Verwendung identisch mit dem Aufruf von `scheduleMessage` . Weitere Einzelheiten finden Sie unter der Beschreibung dieser Funktion.

scheduleEmail

#### scheduleEmail

Festlegen einer E-Mail-Erinnerung

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& dateTime,
                       int lateCancel,
                       int flags,
                       const QString& recurrence,
                       int simpleRepeatInterval,
                       int simpleRepeatCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& dateTime,
                       int lateCancel,
                       int flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& dateTime,
                       int lateCancel,
                       nt flags,
                       int recurType,
                       int recurInterval,
                       const QString& endTime)

##### Parameter

`fromID`

  Die &kmail;-Identität, die als Absender der E-Mail verwendet werden soll. Erfolgt hier keine Angabe, wird die unter Einstellungen für E-Mail-Erinnerungen eingerichtete Adresse verwendet.

`addresses`

  Eine durch Kommas getrennte Liste von Empfänger-E-Mail-Adressen.

`subject`

  Gibt die Betreffzeile der E-Mail an.

`message`

  Gibt den Text der E-Mail an.

`attachments`

  Eine durch Kommas getrennte List von Pfaden oder &URL;s, der als Anhang zu versendenden Dateien.

`dateTime`

  Legt das Datum bzw. Datum und Zeit für den Versand der E-Mail fest. Ist nur das Datum angegeben, sollte die Zeichenfolge das Format JJJJ-MM-TT aufweisen (so, wie es von `QDate::toString(Qt::ISODate)` zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format JJJJ-MM-TTHH:MM[:SS] (so, wie es von `QDateTime::toString(Qt::ISODate)` zurückgegeben wird) oder HH:MM[:SS] (wie es von `QTime::toString(Qt::ISODate)` zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.

`lateCancel`

  Die Erinnerung wird verworfen, wenn Sie nicht innerhalb des angegebenen Zeitraums (in Minuten) nach Fälligkeit ausgelöst werden kann. Ist der Wert 0 angegeben, wird die Erinnerung ausgelöst, egal wie viel Zeit nach der Fälligkeit verstrichen ist.

`flags`

  Angabe der gewünschten Flags für die Erinnerung. Die Kombination mehrerer Flags erfolgt durch ein logisches ODER. Die hier möglichen Flags sind in der Klasse `KAlarmIface` in `kalarmiface.h` definiert. Beachten Sie, dass nicht alle Flags auf E-Mail-Erinnerungen anwendbar sind.

`recurrence`

  Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in RFC2445 beschrieben ist. Die Angabe FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO würde 4 Wiederholungen im Abstand von drei Monaten, jeweils am letzten Montag im Monat festlegen. Für Erinnerungen, die nur einen Fälligkeitstermin haben, geben Sie hier eine leere Zeichenfolge an.

`recurType`

  Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse `KAlarmIface` in der Datei `kalarmiface.h` festgelegt. Monatliche Wiederholungen finden am Tag des Monatstyps statt, jährliche Wiederholungen finden am Datum im Jahrestyp statt, wobei in beiden Fällen das Datum dem Parameter `dateTime` entnommen wird.

`recurInterval`

  Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch `recurType` angegeben) zwischen zwei Fälligkeitsterminen an.

`recurCount`

  Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.

`endDateTime`

  Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter `dateTime` eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beeinhaltet `dateTime` nur eine Datum, darf auch dieser Parameter nur ein Datum enthalten.

`simpleRepeatInterval`

  Gibt die Anzahl Minuten zwischen den einfachen Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine einfache Wiederholung.

`simpleRepeatCount`

  Gibt die Anzahl der einfachen Wiederholungen einer Erinnerung an, einschließlich des ersten Auftretens.

##### Beschreibung

`scheduleEmail()` ist eine &DCOP;-Funktion zum Versand einer E-Mail zu einem festgelegten Zeitpunkt. Abgesehen von der Angabe der E-Mail-Daten und dem Auslassen der Nachrichtenfarbe und der Parameter für die Schriftund die Klangdatei ist die Verwendung identisch mit `scheduleMessage` . Weiter Information finden Sie unter der Beschreibung dieser Funktion.

edit

#### edit

Es wird der Dialog Neue Erinnerung geöffnet.

    bool edit(const QString& eventID)

##### Parameter

`eventID`

  Gibt die eindeutige ID der zu bearbeitenden Erinnerung an.

##### Return value

false sofern die angegebene Erinnerung nicht gefunden wird oder den Status Nur-lesen hat, true sonst.

##### Beschreibung

`edit()` ist eine &DCOP;-Funktion zum Anzeigen des Dialogs Neue Erinnerung, um darin die angegebene Erinnerung zu bearbeiten.

editNew

#### editNew

Es wird der Dialog Neue Erinnerung zum Erstellen einer neuen Erinnerung geöffnet.

    bool editNew(const QString& templateName)

##### Parameter

`templateName`

  Gibt den Namen der Erinnerungsvorlage an, die zum Erstellen der neuen Erinnerung verwendet werden soll. Wird hier nichts übergeben, wird keine Vorlage verwendet.

##### Return value

false falls `templateName` wenn die übergebene Vorlage nicht gefunden wurde, true sonst.

##### Beschreibung

`editNew` ist eine &DCOP;-Funktion zur Anzeige des Dialogs Neue Erinnerung, um eine neue Erinnerung zu erstellen. Wird eine Erinnerungsvorlage als Parameter angegeben, wird diese im Dialog als Vorlage verwendet. Wird die angegebene Vorlage nicht gefunden, wird keine Vorlage für die Voreinstellungen verwendet.

### Befehlszeilenschnittstelle

Die Befehlszeilenoptionen ermöglichen anderen Programmen (beispielsweise der Erinnerungsfunktion) den Aufruf von &kalarm; zum Auslösen oder Löschen einer Erinnerung. Der Grund für die Verwendung der Befehlszeile liegt darin, dass &kalarm;, wird es ohne Befehlszeilenparameter gestartet und über &DCOP;-Aufrufe angesprochen, im graphischen Modus startet. Das ist bei der Kommunikation zwischen Programmen unerwünscht.

Programme sollten zunächst prüfen, ob &kalarm; bereits gestartet ist und, sofern dies der Fall ist, für die gewünschten Operationen &DCOP;-Aufrufe verwenden.

Die Befehlszeilenparameter für das Festlegen einer neuen Erinnerung werden im Kapitel Befehlszeilenoptionen beschrieben. Die Optionen für das Auslösen und Löschen von Erinnerungen lauten wie folgt:

Die Befehlszeilenparameter können, sofern gewünscht, von normalen Anwendern verwendet werden. Vorausgesetzt natürlich, sie sind in der Lage die nötigen Daten zu übergeben.

Option | Beschreibung
--- | ---
`--calendarURL url` | Verwende die Kalenderdatei mit der angegebenen &URL;. Diese Option wird ausschließlich zur Integritätsprüfung verwendet. Ist die angegebene &URL; nicht identisch mit der von &kalarm; verwendeten Kalenderdatei, wird dieser Parameter ignoriert.
`--cancelEvent eventID` | Lösche das Ereignis mit der angegebenen Kennung.
`--triggerEvent eventID` | Löse das Ereignis mit der angegebenen Kennung aus. Der Ablauf ist identisch mit dem Aufruf der &DCOP;-Funktion triggerEvent().
`--handleEvent eventID` | Auslösen oder Löschen des Ereignisses mit der angegebenen Kennung. Der Ablauf ist identisch mit dem Aufruf der &DCOP;-Funktion handleEvent().

`--cancelEvent`, `--triggerEvent` and `--handleEvent` are mutually exclusive. `--calendarURL`ist optional und kann nur zusammen mit einer der drei anderen Optionen verwendet werden.

Beispiele:

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

## Fragen und Antworten

&reporting.bugs; &updating.documentation;

Was ist die Erinnerungsfunktion?

Der Systemdienst Erinnerungsfunktion ist ein Programm, das im Hintergrund läuft, die eingerichteten Erinnerungen überwacht und &kalarm; dazu veranlasst die entsprechenden Nachrichten bei Fälligkeit anzuzeigen.

Wie heißen die Konfigurationsdateien von &kalarm;?

Die Datei `$KDEHOME/share/config/kalarmrc` enthält Ihre Einstellungen für &kalarm;.

Die Kalenderdatei mit den festgelegten Erinnerungen befindet sich unter `$KDEHOME/share/apps/kalarm/calendar.ics`. Sie können in der Einstellungsdatei in der Sektion `General` im Eintrag `Calendar` einen anderen Dateinamen festlegen.

Die Kalenderdatei mit den abgelaufenen Erinnerungen trägt den Namen `$KDEHOME/share/apps/kalarm/expired.ics`. Sie können in der Einstellungsdatei in der Sektion `General` im Eintrag `ExpiredCalendar` einen anderen Dateinamen festlegen.

Die Kalenderdatei mit den Erinnerungsvorlagen trägt den Namen `$KDEHOME/share/apps/kalarm/template.ics`. Sie können in der Einstellungsdatei in der Sektion `General` im Eintrag `TemplateCalendar` einen anderen Dateinamen festlegen.

Die Daten für die angezeigten Erinnerungen sind in der Kalenderdatei `$KDEHOME/share/apps/kalarm/displaying.ics` abgelegt.

Wie heißen die Konfigurationsdateien derErinnerungsfunktion?

Die Einstellungen der Erinnerungsfunktion werden zusammen mit Einzelheiten über die Anwendung &kalarm; in der Datei `$KDEHOME/share/config/kalarmdrc` abgelegt.

In welchem Format werden Erinnerungen gespeichert?

Die Kalenderdateien, in denen &kalarm; seine Erinnerungen speichert, sind Textdateien, deren Format durch RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar) festgelegt ist. Dies ist das Standardformat, das von allen Anwendungen in kdepim verwendet wird. &kalarm; verwendet, konform zu RFC 2445, bestimmte nicht-standardisierte Eigenschaften für die Erinnerungsfunktion: `X-KDE-KALARM-TYPE`, `X-KDE-KALARM-FONTCOLOR`, `X-KDE-KALARM-VOLUME`, `X-KDE-KALARM-SPEAK`, `X-KDE-KALARM-KMAILID`

Wie lauten die Programmnamen von &kalarm; und derErinnerungsfunktion?

Der Dateiname von &kalarm; ist kalarm und der Dateiname der Erinnerungsfunktion lautet kalarmd.

## Mitwirkende und Lizenz

&kalarm;

Copyright des Programms 2001, 2002, 2003, 2004, 2005, 2006 David Jarvie software@astrojar.org.uk

Autoren der Erinnerungsfunktion:

- Preston Brown pbrown@kde.org

- David Jarvie software@astrojar.org.uk

- Cornelius Schumacher schumacher@kde.org

Copyright der Dokumentation 2001, 2002, 2003, 2004, 2005, 2006 David Jarvie software@astrojar.org.uk

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

Übersetzung: Stephan Johach hunsum@gmx.de

&underFDL; &underGPL;

Vielen Dank an den Autor der Version KAlarm, die zu KDE 1 gehört , Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, der den Namen &kalarm; für dieses Programm für &kde; 2 und 3 freigegeben hat.

## Installation

### Woher bekommen Sie &kalarm;?

&install.intro.documentation;

&kalarm; für &kde; 2 und als eigenständiges Paket für &kde; 3 finden Sie auf http://www.astrojar.org.uk/kalarm

### Voraussetzungen

&kalarm; benötigt die Standardbibliotheken von &kde; (das Paket `kdelibs`). Für die Kompilierung benötigen Sie außerdem die Entwicklerpakete von &Qt;- und `kdelibs`. Das Entwicklerpaket von X11 ermöglicht, sofern vorhanden, eine Verbesserung der Funktionalität unter &kde; auch ohne Systembereich in der Kontrollleiste.

Die folgenden, optionalen Pakete erweitern &kalarm; um weitere Funktionen.

- &kmix; (aus dem Paket kdemultimedia) ermöglicht &kalarm; die Einstellung der Grundlautstärke beim Abspielen von Klangdateien.

- KTTSD (aus dem Paket kdeaccessibility): Ist diese Anwendung zusammen mit einem entsprechenden Sprachsynthesizer installiert und eingerichtet, kann &kalarm; angezeigte Erinnerungsnachrichten vorlesen.

&kalarm; benötigt zur Laufzeit etwa 12 MB Arbeitsspeicher, die Erinnerungsfunktion weitere 2,5 MB Arbeitsspeicher. Diese Anforderungen können allerdings abhängig von der Plattform und Konfiguration variieren.

Eine Liste der Änderungen finden Sie in der Datei `ChangeLog` oder auf http://www.astrojar.org.uk/kalarm.

### Kompilierung und Installation

Wenn Sie kein geeignetes vorkompiliertes Paket finden, müssen Sie&kalarm; selbst aus den Quelldateien kompilieren. Dazu benötigen Sie die Dateien `kdepim-x.x.tar.bz2` oder `kalarm-x.x.tar.bz2` (oder ähnlich), abhängig davon, ob Sie das gesamte &package; oder nur &kalarm; installieren möchten. Die Datei muss in einem neuen Unterverzeichnis entpackt werden. Das kann durch ``tar` `xvfj Paket.tar.bz2`` erfolgen. Dann wechseln Sie in das erzeugte Unterverzeichnis.

&install.compile.documentation;

Sind mehrere Versionen von &kde; installiert (&eg; &kde;2 und &kde;3), könnte &kalarm; irrtümlich im falschen &kde;-Ordner installiert werden. Falls nötig, können Sie den richtigen &kde;-Ordner als Parameter für den Befehl ``./configure`` angeben. Für den &kde;-Ordner `/opt/kde2` lautet der Befehl zum Beispiel:

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

Wenn Sie &kalarm; in einen Ordner installieren, in dem keine Version von &kde; installiert ist, müssen Sie diesen Installationsort &kde; bekanntmachen. Dazu müssen Sie der Umgebungsvariable `KDEDIRS` den Installationspfad von &kalarm; vor jedem Start von &kde; voranstellen.

Ist &kde; beispielsweise in `/opt/kde` installiert, zeigt `KDEDIRS` normalerweise auf `/etc/opt/kde:/opt/kde`. Wenn Sie &kalarm; in `/usr/local` installieren, müssten Sie `KDEDIRS` vor dem Start von &kde; auf `/usr/local:/etc/opt/kde:/opt/kde` setzen.

Die selbständige Version von &kalarm; verfügt über eine spezielle Einstellungsmöglichkeit, mit der Sie beim Aufruf von `./configure` durch Angabe eines Sprachkodes bzw. einer Liste von Sprachkodes festlegen können, für welche Sprache eine Dokumentation installiert werden soll.

``./configure` --enable-doc-language="fr en_GB"`

Beachten Sie, dass diese Option keinen Einfluss darauf hat, welche Übersetzungen für die Oberfläche installiert sind.

### Einrichtung

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

Um &kalarm; in einer anderen Umgebung als &kde; zu verwenden, müssen Sie selbst sicherstellen, dass die Erinnerungsfunktion bei jeder Anmeldung automatisch gestartet wird. Genauere Hinweise können Sie der Datei `INSTALL` aus der &kalarm;-Distribution entnehmen.

&documentation.index;