<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % German "INCLUDE"
><!-- change language only here -->
]>

<!-- The language must NOT be changed here. -->

<book id="kalarm" lang="&language;">

<bookinfo id="kalarminfo">
<title
>Das Handbuch zu &kalarm;</title>

<authorgroup>
<author
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
> <address
>&David.Jarvie.mail;</address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
>&David.Jarvie.mail;</address
></affiliation>
<contrib
>Entwickler</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Frank</firstname
><surname
>Schütte</surname
><affiliation
><address
><email
>f.schuette@t-online.de</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Stephan</firstname
><surname
>Johach</surname
><affiliation
><address
><email
>hunsum@gmx.de</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Thomas</firstname
><surname
>Reitelbach</surname
><affiliation
><address
><email
>tr@erdfunkstelle.de</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Torbjörn</firstname
><surname
>Klatt</surname
><affiliation
><address
><email
>torbjoern.k@googlemail.com</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year
><year
>2004</year
><year
>2005</year
><year
>2006</year
><year
>2007</year
><year
>2008</year
><year
>2009</year
><year
>2010</year
><year
>2011</year
><year
>2012</year
><year
>2013</year
><year
>2016</year
><year
>2018</year
><year
>2019</year
><year
>2020</year
><year
>2021</year
><year
>2022</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>2022-5-2</date>
<releaseinfo
>3.5.0 (Anwendungen 22.08)</releaseinfo>

<abstract>
<para
>&kalarm; ist ein Planer für Erinnerungsnachrichten sowie für termingesteuerten E-Mail-Versand und Befehlsausführungen von &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>Alarm</keyword>
<keyword
>Erinnerung</keyword>
<keyword
>Zeitplaner</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Einleitung</title>

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

<para
>&kalarm; zeigt eine Liste mit den Zeiten und Details 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.</para>

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

<para
>Erinnerungen können auch über eine Befehlszeile oder von anderen Programmen via &DBus; eingegeben werden.</para>

<para
>Wenn eine Erinnerung fällig ist, wird die Nachricht auf jeder Arbeitsfläche angezeigt, damit sie nicht beim Umschalten zwischen den Arbeitsflächen übersehen werden kann. Die festgelegte Erinnerungszeit 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:</para>

<screenshot>
<screeninfo
>Bildschirmfoto eines Nachrichtenfensters von &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Erinnerungsnachricht</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Optional kann eine Erinnerungsnachricht als Benachrichtigung statt in einem Fenster angezeigt werden.</para>

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

<para
>&kalarm; wird normalerweise als Symbol im Systemabschnitt der Kontrollleiste angezeigt, dieses Verhalten kann aber auch abgeschaltet werden.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Arbeiten mit &kalarm;</title>

<para
>Wird &kalarm; ohne Befehlszeilenparameter aufgerufen, startet es in der grafischen Ansicht, in der alle ausstehenden Termine angezeigt werden.</para>

<tip
><para
>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 &Shift;taste gedrückt.</para>

<mediaobject>
<imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</tip>

<sect1 id="alarm-types">
<title
>Erinnerungstypen</title>

<para
>Dies sind die wichtigsten Funktionen für die verschiedenen Erinnerungstypen von &kalarm;:</para>

<itemizedlist>
<listitem>
<para
>Anzeige-Erinnerungen zeigen entweder eine eingegebene Textnachricht an, den Inhalt einer Text- oder Bilddatei oder die Textausgabe eines Befehl, der beim Auslösen der Erinnerung ausgeführt wird. Zusätzlich zu diesen Anzeigen können auch Audiodateien abgespielt, ein Text vorgelesen oder ein einfacher Piepton ausgegeben werden. Außerdem können noch vor oder nach der Anzeige der Nachricht Befehle ausgeführt werden. </para>
</listitem>

<listitem>
<para
>Mit Befehls-Erinnerungen wird entweder ein Befehl oder ein eingegebenes Skript ausgeführt.  Es wird nichts angezeigt, ausser beim Auftreten eines Fehler.</para>
</listitem>

<listitem>
<para
>Mit E-Mail-Erinnerungen wird eine E-Mail versendet. Es wird nichts angezeigt, ausser beim Auftreten eines Fehler.</para>
</listitem>

<listitem>
<para
>Mit Audio-Erinnerungen wird eine Audiodatei abgespielt. Es wird nichts angezeigt, ausser beim Auftreten eines Fehler.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Fehlerbehandlung</title>

<para
>Tritt ein Fehler beim Auslösen einer Erinnerung auf, dann wird eine Nachricht angezeigt, sofern nicht früher bereits ausgewählt wurde, diese Art von Nachricht nicht mehr anzuzeigen.</para>

<para
>Ist bei der letzten Auslösung einer Befehls-Erinnerung ein Fehler aufgetreten, wird dies durch ein weißes Ausrufungszeichen auf rotem Hintergrund in der Farbenspalte der Erinnerungsliste angezeigt. Weitere Informationen über den Fehler sehen Sie in einer Kurzinfo, wenn der Mauszeiger auf die Zeile in der Erinnerungsliste geführt wird. Auf die gleiche Art - nur roten Ausrufungszeichen - werden für Anzeige-Erinnerungen Fehler bei der Ausführung der Aktionen vor oder nach der Erinnerung gekennzeichnet</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Erinnerungsliste</title>

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

<para
>Die Spalte <guilabel
>Name</guilabel
> ist nur dann vorhanden, wenn Sie Namen für Erinnerungen auf der Karteikarte <link linkend="preferences-general"
>Allgemein</link
> des Einrichtungsdialogs aktiviert haben.</para>

<screenshot>
<screeninfo
>Bildschirmfoto des Hauptfensters von &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Das Hauptfenster</phrase>
</textobject>
</mediaobject>
</screenshot>

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

<para
>Ist bei der letzten Auslösung einer Befehls-Erinnerung oder bei der Ausführung der besonderen Aktion vor oder nach einer Anzeige-Erinnerung ein Fehler aufgetreten, wird dies wie oben unter<link linkend="errors"
>Fehlerbehandlung</link
> beschrieben in der Erinnerungsliste angezeigt.</para>

<sect2 id="listappear">
<title
>Erscheinungsbild der Erinnerungsliste einstellen</title>

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

<para
> Wahlweise können Sie die verbleibende Zeit bis zur Fälligkeit zusätzlich oder anstelle der Fälligkeitszeit anzeigen lassen.</para>

<para
>Um die Spalte mit der Fälligkeit der Erinnerung auszublenden oder anzuzeigen, klicken Sie mit der &RMBn; auf den Spaltentitel und wählen Sie im Kontextmenü die anzuzeigenden Spalten. Eine der Spalten <guilabel
>Name</guilabel
> oder <guilabel
>Nachricht, Datei oder Befehl</guilabel
> und mindestens eine der Spalten <guilabel
>Zeit</guilabel
> oder <guilabel
>Zeit bis</guilabel
> werden jedoch immer angezeigt.</para>

<para
>Wenn Sie mehrere Erinnerungs-Kalender benutzen. können Sie für jeden Kalender eine eigene Hintergrundfarbe einstellen, mit der die Erinnerungen aus diesem Kalender angezeigt werden. Siehe auch <link linkend="using-calendars"
>Kalender verwenden</link
>.</para>

</sect2>

<sect2 id="expired">
<title
>Abgelaufene Erinnerungen</title>

<para
>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 im <link linkend="preferences-storage"
>Einrichtungsdialog</link
> einstellen, ob und wie lange &kalarm; abgelaufene Erinnerungen aufbewahrt.</para>

<para
>Abgelaufene Erinnerungen können mit  <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Abgelaufene Erinnerungen anzeigen</guimenuitem
></menuchoice
> in der Erinnerungsliste angezeigt werden. Um sie wieder auszublenden, deaktivieren Sie im Menü <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Abgelaufene Erinnerungen anzeigen</guimenuitem
></menuchoice
>.</para>

</sect2>

<sect2 id="datepicker">
<title
>Erinnerungsliste nach Datum filtern</title>

<para
>Sie können die Erinnerungsliste auf Erinnerungen eingrenzen, die an einem bestimmten Datum ausgeführt werden sollen. Dies erreichen Sie durch die Auswahl des Erinnerungsdatums, welche mittels <menuchoice
><guimenu
>Ansicht</guimenu
> <guimenuitem
>Datumsauswahl anzeigen</guimenuitem
> </menuchoice
> ein- und ausgeblendet werden kann. Mit einem Klick wählen Sie ein Datum aus der Auswahl aus, mit einem zweiten Klick wählen Sie es wieder ab. Die Datumsauswahl zeigt einen einzelnen Monat an. Um einen anderen Monat anzuzeigen, benutzen Sie die Pfeile in der Datumsauswahl.</para>

</sect2>

<sect2 id="search">
<title
>Durchsuchen der Erinnerungsliste</title>

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

<para
>So wird eine Suche durchgeführt:</para>

<itemizedlist>
<listitem>
<para
>Textnachricht-Erinnerungen: Es wird nach dem Text der Erinnerung gesucht.</para>
</listitem>

<listitem>
<para
>Dateiinhalt-Erinnerungen: Es wird nach dem Dateipfad/-Ordner gesucht.</para>
</listitem>

<listitem>
<para
>Befehls-Erinnerungen: Es wird nach der Befehlszeile oder dem Befehlsskript gesucht.</para>
</listitem>

<listitem>
<para
>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.</para>
</listitem>

<listitem>
<para
>Audio-Erinnerungen: Es wird nach dem Dateipfad/-Ordner gesucht.</para>
</listitem>
</itemizedlist>

<note
><para
>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.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Erstellen und Bearbeiten einer Erinnerung</title>

<sect2>
<title
>Das Erstellen einer neuen Erinnerung</title>

<para
>Um eine neue Erinnerung anzulegen, führen Sie einen der folgenden Schritte aus und wählen dann einen Erinnerungstyp aus der Liste. In jedem Fall wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> angezeigt, mit dessen Hilfe Sie die Einstellungen für die neue Erinnerung vornehmen.</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie im Menü <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Neu ...</guimenuitem
></menuchoice
></para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; auf das Symbol im Systemabschnitt der Kontrollleiste und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Neue Erinnerung</guimenuitem
></menuchoice
></para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; in die Erinnerungsliste und wählen Sie <menuchoice
><guimenuitem
>Neu&nbsp;...</guimenuitem
></menuchoice
> aus dem Kontextmenü.</para>
</listitem>
</itemizedlist>

<para
>Alternativ können Sie neue vorkonfigurierte Erinnerungen aus folgenden Quellen anlegen:</para>

<itemizedlist>
<listitem>
<para
>Um das Datum einer Erinnerung im <link linkend="alarm-edit-dlg"
>Bearbeitungsdialog</link
> voreinzustellen, <mousebutton
>rechtsklicken</mousebutton
> Sie auf das gewünschte Datum im Auswahlfeld (siehe <link linkend="datepicker"
>Erinnerungsliste nach Datum filtern</link
>) und wählen Sie den passenden Erinnerungstyp aus dem Kontextmenü.</para>
</listitem>

<listitem>
<para
>Falls Sie für neue Erinnerungen eine Vorlage verwenden möchten, folgen Sie am besten den Hinweisen im Abschnitt <link linkend="templates"
>Erinnerungsvorlagen</link
>.</para>
</listitem>

<listitem>
<para
>Soll eine Erinnerung auf einer bereits existierenden basieren, markieren Sie die betreffende Erinnerung in der Liste und wählen Sie <menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Kopieren</guimenuitem
></menuchoice
>. Hierdurch öffnet sich der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> mit den Einstellungen der markierten Erinnerung.</para>
</listitem>

<listitem>
<para
>Um eine neue Erinnerung anzulegen, die eine vorhandene E-Mail anzeigen soll, ziehen Sie die E-Mail aus &kmail; in das Hauptfenster von &kalarm;. Wählen Sie dann <guilabel
>Anzeige-Erinnerung</guilabel
>. Damit wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> mit der kompletten E-Mail (einschließlich Absender, Empfänger &etc;) als Erinnerungstext geöffnet.</para>
</listitem>

<listitem>
<para
>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;. Wählen Sie dann <guilabel
>E-Mail-Erinnerung</guilabel
>. Damit öffnen Sie den Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>. Die gesamte E-Mail (ausgenommen der Absender) ist bereits als Erinnerungstext eingetragen.</para>
</listitem>

<listitem>
<para
>Um eine neue Erinnerung anzulegen, die eine Zusammenstellung der vorhandenen Aufgaben anzeigen soll, ziehen Sie die Aufgaben aus &korganizer; oder anderen Anwendungen in das Hauptfenster von &kalarm;. Damit wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> mit der Aufgabenliste als Erinnerungstext geöffnet.</para>
</listitem>

<listitem>
<para
>Um eine neue Befehls-Erinnerung anzulegen, ziehen Sie den Text ein Skripts, das mit dem Zeichen <quote
>#!</quote
> beginnt, in das Hauptfenster von &kalarm;. Wählen Sie dann die Einstellung <guilabel
>Befehls-Erinnerung</guilabel
>. Damit wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> mit dem Text des Skripts geöffnet.</para>
</listitem>

<listitem>
<para
>Um eine Datei als Erinnerung anzeigen zu lassen, ziehen Sie die Adresse/&URL; einer Datei mit Text oder einem Bild auf das Hauptfenster von &kalarm;. Im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>  wird dann der betreffende Dateiname voreinstellt.</para>
</listitem>

<listitem>
<para
>Um eine Audio-Erinnerung zu erstellen, ziehen Sie eine Adresse/&URL;  einer Audiodatei auf das Hauptfenster von &kalarm;. Im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>  wird dann der betreffende Dateiname voreinstellt.</para>
</listitem>

<listitem>
<para
>Um eine neue Text-Erinnerung anzulegen, ziehen Sie einen beliebigen Text in das Hauptfenster von &kalarm;. Auf Nachfrage wählen Sie die Einstellung <guilabel
>Erinnerung anzeigen</guilabel
>. Damit öffnen Sie den Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>. Der Text ist bereits als Erinnerungstext eingetragen.</para>
</listitem>

<listitem>
<para
>Sie können für Personen, die sich in &kaddressbook; eingetragen sind, automatisch Geburtstagstermine eintragen lassen. Eine Beschreibung hierzu finden Sie unter <link linkend="birthdays"
>Importieren von Geburtstagen aus &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Das Bearbeiten einer Erinnerung</title>

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

<itemizedlist>
<listitem>
<para
>Führen Sie einen Doppelklick auf den Eintrag in der Liste aus.</para>
</listitem>

<listitem>
<para
>Wählen Sie den Eintrag in der Liste aus und rufen Sie den Menüpunkt <menuchoice
><guimenu
>Bearbeiten</guimenu
> <guimenuitem
>Bearbeiten&nbsp;...</guimenuitem
></menuchoice
> auf.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; auf den Eintrag in der Liste und wählen Sie im Kontextmenü den Eintrag <menuchoice
><guimenuitem
>Bearbeiten&nbsp;...</guimenuitem
></menuchoice
></para>
</listitem>
</itemizedlist>

<para
>Es wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> geöffnet.</para>

</sect2>

<sect2>
<title
>Das Löschen/Aktivieren einer Erinnerung</title>

<para
>Um vorhandene Erinnerungen zu löschen, wählen Sie eine oder mehrere Erinnerungen durch Klicken auf die Einträge in der Liste aus. Sie haben nun folgende Möglichkeiten:</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie im Menü <menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Löschen ...</guimenuitem
></menuchoice
></para>
</listitem>
<listitem>
<para
>Klicken Sie mit der &RMBn; auf die ausgewählten Einträge und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Löschen</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Um Einträge ohne Bestätigung sofort zu entfernen, drücken Sie die Tastenkombination <keycombo action="simul"
>&Shift;<keycap
>Entf</keycap
></keycombo
>.</para>
</listitem>
</itemizedlist>

<para
>Wenn Sie eine aktive Erinnerung löschen, so wird sie aufbewahrt, vorausgesetzt dass sie zumindest einmal vor dem Löschen ausgelöst wurde und das Aufbewahren abgelaufener Erinnerungen nicht ausgeschaltet wurde. Verwenden Sie den <link linkend="preferences-storage"
>Einrichtungsdialog</link
>, 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.</para>

<para
>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 <link linkend="expired"
>abgelaufene Erinnerungen</link
> anzeigen lassen.</para>

<itemizedlist>
<listitem>
<para
>Klicken Sie auf die gewünschten Einträge in der Liste und wählen Sie im Menü <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Aktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Klicken Sie mit der &RMBn; auf die gewünschten Listeneinträge und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Aktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Erinnerungsfunktion aktivieren/deaktivieren</title>

<para
>Siehe auch <link linkend="enable-disable"
>Deaktivieren/Aktivieren der Überwachung von Erinnerungen</link
>, entweder einzeln für jede Erinnerung oder für alle Erinnerungen.</para>

</sect2>

<sect2>
<title
>Erinnerung zum Aufwachen aus dem Ruhezustand einrichten</title>

<para
>Siehe <link linkend="wake-suspend"
>Aufwachen aus dem Ruhezustand</link
> für das Einstellen einer Erinnerung für das Aufwachen aus dem Standby-Modus oder Ruhezustand.</para>

</sect2>

<sect2>
<title
>Die Zurkenntnisnahme einer Erinnerung</title>

<para
>Wie Sie eine Erinnerung zur Kenntnis nehmen, wird im Abschnitt <link linkend="message-display"
>Anzeige von Erinnerungsnachrichten</link
> erläutert.</para>

</sect2>

<sect2 id="templates">
<title
>Erinnerungsvorlagen</title>

<para
>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.</para>

<para
>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 <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> mit dieser Vorlage öffnen und danach Datum und Uhrzeit eingeben.</para>

<para
>Um eine neue, auf einer Vorlage basierende Erinnerung anzulegen, öffnen Sie den Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> mit den entsprechenden Vorlagendaten:</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie im Menü <menuchoice
><guimenu
>Datei</guimenu
><guisubmenu
>Neu</guisubmenu
> <guimenuitem
>Neue Erinnerung von Vorlage</guimenuitem
></menuchoice
> und suchen Sie sich die gewünschte Vorlage aus.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü <menuchoice
><guimenu
>Neue Erinnerung</guimenu
><guimenuitem
>Neue Erinnerung von Vorlage</guimenuitem
></menuchoice
>. Dann wählen Sie die gewünschte Vorlage aus.</para>
</listitem>

<listitem>
<para
>Öffnen Sie den Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> auf dem herkömmlichen Weg und klicken Sie dann auf <guibutton
>Vorlage laden&nbsp;...</guibutton
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Vorlagen einrichten</title>

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

<para
>Sie können eine neue Vorlage auf folgende Weise erstellen:</para>

<itemizedlist>
<listitem>
<para
>Öffnen Sie den Vorlagendialog, indem Sie <menuchoice
> <guimenu
>Datei</guimenu
><guimenuitem
>Vorlagen&nbsp;...</guimenuitem
></menuchoice
> wählen und dann auf <guibutton
>Neu</guibutton
> klicken und einen Vorlagentyp aus der Liste wählen. Daraufhin sehen Sie einen Vorlagendialog mit leeren Feldern.</para>
</listitem>

<listitem>
<para
>Öffnen Sie den Vorlagendialog, indem Sie auf <menuchoice
> <guimenu
>Datei</guimenu
><guimenuitem
>Vorlagen&nbsp;...</guimenuitem
></menuchoice
> klicken, wählen dann eine bestehende Vorlage aus der Liste und klicken auf <guibutton
>Kopieren</guibutton
>. Dadurch wird eine neue Vorlage mit den Daten der bereits existierenden Vorlage erstellt.</para>
</listitem>

<listitem>
<para
>Markieren Sie eine Erinnerung in der Liste und wählen Sie <menuchoice
> <guimenu
>Datei</guimenu
><guimenuitem
>Vorlage erstellen&nbsp;...</guimenuitem
> </menuchoice
>. Dadurch wird eine neue Vorlage mit den Daten der bereits existierenden Erinnerung erstellt.</para>
</listitem>
</itemizedlist>

<para
>Um eine bestehende Vorlage zu ändern, öffnen Sie den Vorlagendialog indem Sie im Menü <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Vorlagen&nbsp;...</guimenuitem
></menuchoice
> wählen und dann auf <guibutton
>Bearbeiten&nbsp;...</guibutton
> klicken. Damit wird der  unten beschriebenen Dialog <quote
>Erinnerungsvorlagen bearbeiten</quote
> geöffnet.</para>

<para
>Um eine Vorlage zu löschen, öffnen Sie den Vorlagendialog indem Sie im Menü <menuchoice
><guimenu
>Datei</guimenu
><guimenuitem
>Vorlagen&nbsp;...</guimenuitem
></menuchoice
> auswählen. Markieren Sie eine oder mehrere Vorlagen und klicken Sie auf <guibutton
>Löschen</guibutton
>. Bevor die Vorlagen wirklich gelöscht werden, müssen Sie noch eine Nachfrage bestätigen.</para>

</sect3>

<sect3>
<title
>Der Dialog <quote
>Erinnerungsvorlagen bearbeiten</quote
></title>

<para
>Der Dialog zum Bearbeiten von Vorlagen ist ähnlich aufgebaut wie der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>. Die folgenden Elemente sind allerdings unterschiedlich:</para>

<itemizedlist>
<listitem>
<para
>Geben Sie unter <guilabel
>Name der Vorlage:</guilabel
> 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.</para>
</listitem>

<listitem>
<para
>Im Bereich <guilabel
>Zeit</guilabel
> steht Folgendes zur Auswahl:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Standard-Zeitpunkt</guilabel
>, falls Sie keine besondere Erinnerungszeit wünschen. Erinnerungen die auf dieser Vorlage basieren, werden den normalen Standard-Zeitpunkt voreingestellt haben.</para>
</listitem>

<listitem>
<para
><guilabel
>Zeit</guilabel
> zum Eingeben einer Uhrzeit, zu der die Erinnerung ausgelöst wird.</para>
</listitem>

<listitem>
<para
><guilabel
>Nur Datum</guilabel
> bewirkt, dass die Erinnerung nur ein Datum, aber keine Zeit eingestellt hat.</para>
</listitem>

<listitem>
<para
><guilabel
>Zeit ab jetzt</guilabel
> bestimmt ein Zeitintervall, nachdem die Erinnerung ausgelöst wird. Gezählt wird ab dem Zeitpunkt, an dem die Erinnerung aus der Vorlage erzeugt wird.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Auf der Karteikarte <guilabel
>Wiederholung</guilabel
> im Abschnitt <guilabel
>Wiederholungsregel</guilabel
> legen Sie die Art der Wiederholung fest.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Erinnerungs-Kalender</title>

<para
>Wenn Sie nur mit einem Rechner und allein arbeiten, spielt es keine Rolle, wo die Erinnerungen gespeichert werden. Wenn Sie jedoch auf Erinnerungen auf mehreren Rechnern oder an verschiedenen Speicherorten auf einem Rechner zugreifen wollen, können Sie <quote
>Erinnerungs-Kalender</quote
> festlegen, die &kalarm; anstelle oder zusätzlich zum vorhandenen Kalender benutzt.</para>

<para
>Kalender können in der Kalenderliste betrachtet und bearbeitet werden. Die Kalenderliste wird neben den Erinnerungen im Hauptfenster von &kalarm; angezeigt. Erinnerungen aus allen Kalendern werden gemeinsam in der Erinnerungsliste dargestellt. Wenn Sie eine neue Erinnerung speichern, können Sie angeben, ob sie automatisch in der Standard-Kalender gespeichert wird oder ob eine Nachfrage über den Speicherort erscheinen soll. Wenn Sie einen vorhandene Erinnerung bearbeiten, wird sie automatisch im ursprünglichen Erinnerungs-Kalender gespeichert.</para>

<screenshot>
<screeninfo
>Bildschirmfoto des Hauptfensters von &kalarm; mit der Kalenderliste</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Hauptfenster mit der Kalenderliste</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Kalenderarten und deren Einstellungen</title>

<para
>Erinnerungs-Kalender werden nach Erinnerungstyp und Speichertyp unterschieden. Kalender können deaktiviert werden, nur lesbar und als Standardkalender für den Erinnerungstyp gesetzt werden.</para>

<variablelist>
<varlistentry>
<term
>Erinnerungstyp</term>
<listitem>
<para
>Die drei Arten von Erinnerungstypen &ndash; aktive Erinnerungen, abgelaufene Erinnerungen und Erinnerungsvorlagen &ndash; werden in getrennten Erinnerungs-Kalendern gespeichert. Daher hat &kalarm; drei Standard-Kalender für jeden einzelnen Erinnerungstyp. Weitere Informationen dazu finden Sie im Kapitel <link linkend="faq"
>Fragen und Antworten</link
>. Diese Standard-Kalender können bei Bedarf auch geändert werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Speichertyp</term>
<listitem>
<para
>In &kalarm; gibt es zwei Speichertypen für Erinnerungs-Kalender:</para>

<itemizedlist>
<listitem
><para
>Lokale Datei: Erinnerungen werden in einer einzigen lokalen Datei im iCalendar-Format gespeichert. Dies ist die Standardeinstellung in &kalarm;, weitere Informationen finden Sie im Kapitel <link linkend="faq"
>Fragen und Antworten</link
>. Zusätzlich zu den Dateien auf dem Rechner können auch <quote
>lokale Dateien</quote
> in eigenen Netz verwendet werden, wenn der Pfad zu diesen Dateien mit <literal
>/</literal
> beginnt.</para>
</listitem>

<listitem
><para
>Lokaler Ordner: Erinnerungen werden jeweils in einer eigenen iCalendar-Datei in einem lokalen Ordner gespeichert. Dies hat den Vorteil, dass bei nicht mehr lesbaren Dateien nur eine Erinnerung, nicht aber der gesamte Kalender verloren ist.</para>
</listitem>
<!--FIXME not in kf5?
<listitem
><para
>Remote file: Alarms are stored in a single remote
file in iCalendar format. This storage method allows you to access
your alarm data remotely no matter where you are, or enables alarm
calendars to be viewed by other people. When using remote files,
&kalarm; works with a local cache of the data.</para>

<warning
><para
>If a remote alarm calendar is shared between users,
changes made by one person may not be automatically made available to
another user, or there could be a time delay before the other user
sees it. So one user could make a change which is then overwritten by
another user without either person noticing what has happened. The
technical reason for this is that a change made by person A will only
be available to person B after person A's cached copy has first been
saved to the remote file, and then person B's cached copy
of the remote file has been reloaded. When and if the calendar is
saved and reloaded depends on the calendar configuration parameters
which each user has set for that alarm calendar.</para>

<para
>Ways to avoid this problem include adjusting the calendar save
and reload configuration parameters, or adopting a policy that users
other than the alarm calendar's owner should open it in read-only
mode.</para
></warning>
</listitem>
-->
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Status aktiviert/deaktiviert</term>
<listitem>
<para
>Das Deaktivieren eines Kalenders hat den gleichen Effekt wie das Löschen, nur dass er noch in der Kalenderliste angezeigt wird und daher leichter wieder aktiviert werden kann. Die Erinnerungen eines deaktivierten Kalenders werden ignoriert und erscheinen nicht in der Erinnerungs- oder Vorlagenliste. Wird ein Kalender wieder aktiviert, so werden die darin enthaltenen Erinnerungen wieder angezeigt und - falls es sich um einen aktiven Kalender handelt - wieder als aktive Erinnerungen eingesetzt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Status „Nur Lesen“</term>
<listitem>
<para
>In einem nur lesbaren Kalender können Erinnerungen nicht bearbeitet oder hinzugefügt werden. Außerdem ist es nicht möglich Erinnerungen aufzuschieben, da dafür ein Schreibzugriff auf die Erinnerung erforderlich ist. Nach Fälligkeit werden die Erinnerungen nicht aus dem Kalender gelöscht und archiviert, bis der Kalender von einem der Benutzer im Schreibmodus erneut geladen wird.</para>

<para
>Ein Kalender kann im Einstellungsdialog auf den Status „Nur Lesen“ gesetzt werden. Aus verschiedenen Gründe können einige Kalender jedoch nicht beschreibbar gesetzt werden:</para>

<itemizedlist>
<listitem
><para
>Wenn ein Kalender von einem anderen Programm erstellt wurde, könnte es durch die Aktualisierung zu Datenverlusten kommen, weil der Kalender durch unterschiedliche Datenformate für das andere Programm eventuell nicht mehr brauchbar ist.</para>
</listitem>

<listitem
><para
>Wenn der Kalender von einer neueren Version von &kalarm; erstellt wurde, können Daten verloren gehen, wenn Ihre Version von &kalarm; den Kalender aktualisiert.</para>
</listitem>

<listitem
><para
>Wenn ein Kalender mit einer früheren Version von &kalarm; erstellt wurde, können Daten verloren gehen oder den Zugriff mit der früheren Version verhindern, wenn Ihre Version von &kalarm; den Kalender aktualisiert. Auf Nachfrage wird der Kalender beschreibbar gemacht, um das Format zu konvertieren. Beachten Sie dabei die möglichen Probleme beim späteren Zugriff mit einer früheren Version von &kalarm;.</para>
</listitem>

<listitem
><para
>Wenn Sie keine Schreibrechte für den Ordner oder die Datei des Kalenders haben.</para>
</listitem>
</itemizedlist>

<para
>Wenn Sie Schreibzugriff auf Erinnerungen in einem Kalender benötigen, der nur lesbar ist, können Sie die Erinnerungen in einen Kalender kopieren, für den Sie Schreibrechte haben. Verwenden Sie dazu die Menüoption <menuchoice
><guimenuitem
>Importieren ...</guimenuitem
></menuchoice
> aus dem Kontextmenü. Weitere Informationen dazu finden Sie im Kapitel <link linkend="import"
>Importieren von Erinnerungen aus externen Kalendern</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Standard-Kalenderstatus</term>
<listitem>
<para
>Ein Kalender jedes Erinnerungstyps kann auf Wunsch als Standard für diesen Typ eingestellt werden. Neue Erinnerungen werden dann automatisch in dem Standardkalender für ihren Typ gespeichert, wenn nicht im <link linkend="preferences-storage"
>Einrichtungsdialog</link
> die Nachfrage für neue Erinnerungen und Vorlagen aktiviert ist, in welchem Kalender gespeichert werden soll.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="using-calendars">
<title
>Kalender verwenden</title>

<para
>Kalender können in der Kalenderliste betrachtet und bearbeitet werden. Diese Liste kann im Menü mit <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Kalender anzeigen</guimenuitem
></menuchoice
> ein- oder ausgeblendet werden. Um Kalender zu bearbeiten, stellen Sie zuerst den Erinnerungstyp im Auswahlfeld über der Liste ein. Drücken Sie dann einen Knopf unterhalb der Liste oder klicken Sie mit der &RMBn; auf einen Kalender in der Liste und wählen einen Eintrag aus dem Kontextmenü. Folgende Aktionen sind darin verfügbar:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Hinzufügen ...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Fügt einen Kalender des gewählten Typs zur Liste hinzu. Zuerst muss ein Speichertyp angegeben werden, dann wird der Einrichtungsdialog für den Kalender zur Auswahl der Einstellungen und des Speicherorts angezeigt. Wenn noch kein Erinnerungs-Kalender am eingegebenen Speicherort existiert, wird ein neuer Kalender erstellt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Entfernen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Entfernt die Anzeige des ausgewählten Kalenders aus der Liste. Der Kalender selbst wird nicht gelöscht, sondern nur aus der Liste  ausgeblendet. Er kann nachträglich wieder in die Liste eingefügt werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Bearbeiten ...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Öffnet den Einstellungsdialog zur Bearbeitung des ausgewählten Kalenders.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Neu laden</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Lädt den ausgewählten Kalender neu. Der Kalender wird wieder vom Speicherort eingelesen, damit ist sichergestellt, dass die in &kalarm; angezeigten Daten und der aktuelle Status des Kalenders abgeglichen ist. Wird ein Kalender gemeinsam mit anderen Benutzern verwendet, werden alle Änderungen der Benutzer von &kalarm; übernommen.</para>

<warning
><para
>Wenn Sie einen entfernten Kalender neu laden, werden alle Ihre Änderungen für Erinnerungen seit dem letzten Speichern verworfen. Außerdem werden alle Erinnerungen, die seit dem letzten Speichern abgelaufen sind, erneut ausgelöst.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importieren ...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importiert Erinnerungen aus externen Kalenderdateien in den ausgewählten Kalender. Weitere Informationen dazu finden Sie unter <link linkend="import"
>Importieren von Erinnerungen aus externen Kalendern</link
>. Diese Option ist für deaktivierte oder nur lesbare Kalender nicht verfügbar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Exportieren ...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Exportiert alle Erinnerungen aus dem gewählten Kalender in eine externe Kalenderdatei. Weitere Informationen dazu finden Sie unter <link linkend="export"
>Exportieren von Erinnerungen in externe Kalendern</link
>. Diese Option ist für deaktivierte Kalender nicht verfügbar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Details anzeigen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Zeigt ausführliche Informationen wie Speicherort und -typ, Berechtigungen und den Staus des ausgewählten Kalenders an. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Als Standard verwenden</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Benutzt den ausgewählten Kalender als Standard für den ausgewählten Kalendertyp. Diese Option ist für deaktivierte oder nur lesbare Kalender nicht verfügbar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Farbe wählen ...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Auswahl der Hintergrundfarbe für die Hervorhebung von Erinnerungen diesem Kalender in der Erinnerungsliste. Damit ist auf einen Blick zu erkennen, zu welchem Kalender eine Erinnerung gehört.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Farbe löschen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Löschen der Hintergrundfarbe für die Hervorhebung von Erinnerungen diesem Kalender in der Erinnerungsliste. Diese Einstellung erscheint nur, wenn <guimenuitem
>Farbe wählen</guimenuitem
> für diesen Kalender benutzt wurde.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Importieren von Erinnerungen aus externen Kalendern</title>

<para
>Sie können Erinnerungen aus anderen Kalendern in &kalarm; importieren. Die Importfunktion durchsucht die ausgewählten Kalenderdateien nach Terminen, die Erinnerungen enthalten und kopiert diese (unter Vergabe eindeutiger IDs) in den Kalender von &kalarm;. Termine ohne Erinnerungen und andere Kalendereinträge werden ignoriert. Es gibt zwei Möglichkeiten um Erinnerungen zu importieren:</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie <menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Erinnerungen importieren ...</guimenuitem
></menuchoice
>, um alle Erinnerungsarten (aktive Erinnerungen, abgelaufene Erinnerungen und Erinnerungsvorlagen) aus den Kalenderdateien zu importieren.</para>

<para
>Wenn Sie <link linkend="calendars"
>Erinnerungs-Kalender</link
> eingestellt haben, werden Erinnerungen jeder Art zur zugehörigen Standard-Kalender hinzugefügt. Ist im <link linkend="preferences-storage"
>Einrichtungsdialog</link
> die Nachfrage aktiviert, in welchem Kalender gespeichert werden soll, muss ein Kalender zur Speicherung angegeben werden.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; auf einen Kalender in der Liste und wählen Sie dann <guimenuitem
>Importieren ...</guimenuitem
> aus dem Kontextmenü. Damit werden nur die Erinnerungen des aktuell gewählten Typs in den Kalender importiert. Sind zum Beispiel Erinnerungsvorlagen als Kalendertyp ausgewählt, dann werden nur Erinnerungsvorlagen und keine aktiven oder abgelaufenen Erinnerungen importiert.</para>
</listitem>
</itemizedlist>

<warning
><para
>Wenn Sie Erinnerungen aus Kalenderdateien importieren, die nicht von &kalarm; erstellt wurden, kann es zu Abweichungen 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.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Exportieren von Erinnerungen in externe Kalender</title>

<para
>Erinnerungen können aus &kalarm; in andere Kalenderdateien exportiert werden, entweder nur die aktuell ausgewählten Erinnerungen aus der Erinnerungsliste oder alle Erinnerungen aus einem Kalender. Dies wird weiter unten erläutert. Es kann entweder ein neuer Kalender erstellt werden oder die exportierten Erinnerungen werden an eine vorhandenen Kalenderdatei eingefügt. Wählen Sie im Dateiauswahldialog <guilabel
>An vorhandene Datei anhängen</guilabel
>, sonst wird eine vorhandene Datei überschrieben.</para>

<itemizedlist>
<listitem>
<para
>Um Erinnerungen zu exportieren, die aktuell in der Erinnerungsliste ausgewählt sind, klicken Sie mit der &RMBn; auf die Auswahl und wählen Sie im Kontextmenü den Eintrag <menuchoice
><guimenuitem
>Exportieren&nbsp;...</guimenuitem
></menuchoice
> oder benutzen <menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Ausgewählte Erinnerungen exportieren ...</guimenuitem
></menuchoice
>  im Hauptmenü.</para>
</listitem>

<listitem>
<para
>Um alle Erinnerungen aus einem Kalender zu exportieren, klicken Sie mit der &RMBn; auf einen Kalender in der Kalenderliste und wählen Sie im Kontextmenü den Eintrag <menuchoice
><guimenuitem
>Exportieren&nbsp;...</guimenuitem
></menuchoice
></para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Das Importieren von Geburtstagen aus &kaddressbook;</title>

<note
><para
>Diese Funktion ist nur verfügbar, wenn &kalarm;s <link linkend="akonadi-plugin"
>Akonadi-Modul</link
> installiert und aktiviert ist.</para>
</note>

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

<itemizedlist>
<listitem>
<para
>Im Bereich <guilabel
>Text für Erinnerung</guilabel
> 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 <guilabel
>Vorangestellt</guilabel
>, gefolgt vom Namen der Person mit dem angefügten Inhalt des Textes von <guilabel
>Angehängt</guilabel
>. Es werden keine Leerzeichen hinzugefügt. Denken Sie also daran, die entsprechenden Leerzeichen selbst in die Eingabefelder einzufügen.</para>

<note
><para
>Ändern Sie den Text der Erinnerung, wird die Liste mit den Geburtstagen neu ausgewertet.</para
></note>
</listitem>

<listitem>
<para
>Markieren Sie im Bereich <guilabel
>Geburtstage auswählen</guilabel
> 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 <guilabel
>Text für Erinnerung</guilabel
> ausgewählten Format existiert.</para>
</listitem>

<listitem>
<para
>Die übrigen Elemente des Dialogs sind identisch mit den entsprechenden Elementen für Erinnerungen vom Typ <guilabel
>Text</guilabel
>, wie Sie im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> angezeigt werden.</para>
</listitem>
</itemizedlist>

<para
>Wenn Sie <link linkend="calendars"
>Erinnerungs-Kalender</link
> eingestellt haben, werden Erinnerungen zum Standard-Kalender für aktive Erinnerungen hinzugefügt. Ist im <link linkend="preferences-storage"
>Einrichtungsdialog</link
> die Nachfrage aktiviert, in welchem Kalender gespeichert werden soll, muss ein Kalender zur Speicherung angegeben werden.</para>
</sect2>

<sect2 id="undo">
<title
>Rückgängigmachen / Wiederherstellen</title>

<para
>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.</para>

<para
>Um die letzte Änderung rückgängig zu machen, wählen Sie im Menü <menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Rückgängig</guimenuitem
></menuchoice
>. Um die letzte rückgängig gemachte Änderung wiederherzustellen wählen Sie im Menü <menuchoice
><guimenu
>Bearbeiten</guimenu
><guimenuitem
>Wiederherstellen</guimenuitem
></menuchoice
>.</para>

<para
>Um eine Änderung rückgängig zu machen, die nicht die letzte Änderung ist, klicken Sie in der Werkzeugleiste auf den Knopf <guibutton
>Rückgängig</guibutton
> 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.</para>

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

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>Der Dialog Erinnerung bearbeiten</title>

<para
>Im Bearbeitungsdialog können Erinnerungen betrachtet und bearbeitet werden. Wenn Sie &kalarm; das erste Mal benutzen, wird der Dialog nur in einer einfache Version mit wenigen Einstellungsmöglichkeiten angezeigt. Um alle Optionen zu sehen, klicken Sie auf den Knopf <guibutton
>Mehr Optionen</guibutton
>. Mit <guibutton
>Weniger Optionen</guibutton
> wird wieder die vereinfachte Form des Dialogs angezeigt. Die zuletzt angezeigte Form dieses Dialogs wird beim nächsten Aufruf immer wieder hergestellt.</para>

<para
>Die Standardwerte für viele Einstellungen im Dialog „Erinnerungen bearbeiten“ können Sie auf der Karteikarte <link linkend="preferences-edit"
>Bearbeiten</link
> des Einrichtungsdialogs angeben.</para>

<screenshot>
<screeninfo
>Bildschirmfoto des einfachen Dialogs <guilabel
>Erinnerung bearbeiten</guilabel
> </screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Der einfache Dialog <guilabel
>Erinnerung bearbeiten</guilabel
> für eine Anzeige-Erinnerung</phrase>
</textobject>
<caption
><para
>Der einfache Dialog <guilabel
>Erinnerung bearbeiten</guilabel
> für eine Anzeige-Erinnerung</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Bildschirmfoto des Dialogs <guilabel
>Erinnerung bearbeiten</guilabel
> mit allen Optionen</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Der Dialog <guilabel
>Erinnerung bearbeiten</guilabel
> für eine Anzeige-Erinnerung mit allen Optionen</phrase>
</textobject>
<caption
><para
>Der Dialog <guilabel
>Erinnerung bearbeiten</guilabel
> für eine Anzeige-Erinnerung mit allen Optionen</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Erinnerungsname</title>

<para
>Im Feld <guilabel
>Erinnerungsname</guilabel
> können Sie einen Namen für die Erinnerung eingeben. Dies dient dazu, den Alarm leichter zu identifizieren. Sie müssen keinen Namen eingeben, und er muss nicht eindeutig sein.</para>

<para
>Dieses Feld wird nur dann angezeigt, wenn Sie Namen für Erinnerungen auf der Karteikarte <link linkend="preferences-general"
>Allgemein</link
> des Einrichtungsdialogs aktiviert haben.</para>

</sect2>

<sect2>
<title
>Die Erinnerungs-Aktion</title>

<para
>Die Einstellungsmöglichkeiten im Abschnitt <guilabel
>Aktion</guilabel
> sind je nach Typ der Erinnerung verschieden.</para>

<sect3>
<title
>Anzeige-Erinnerungen</title>

<para
>Anzeige-Erinnerungen zeigen bei Fälligkeit der Erinnerung ein Fenster an. Im Auswahlfeld oben kann eine Methode ausgewählt werden, die den Inhalt des Nachrichtenfensters erzeugt:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Textnachricht</guilabel
>, um den Text für eine Erinnerung (auch mit Zeilenumbruch) einzugeben.</para>
</listitem>

<listitem>
<para
><guilabel
>Dateiinhalt</guilabel
>, um den Namen oder die Adresse (&URL;) einer Text- oder Bilddatei, deren Inhalt in der Erinnerungsmeldung angezeigt werden soll, anzugeben. Mit dem Knopf rechts neben dem Eingabefeld kann ein Dateiauswahldialog geöffnet werden. Die Option <quote
>Vorlesen</quote
> ist für diesen Erinnerungstyp nicht verfügbar.</para>
</listitem>

<listitem>
<para
><guilabel
>Ausgabe des Befehl</guilabel
>, um einen Befehl einzugeben, der bei Fälligkeit der Erinnerung ausgeführt wird und den Text der Nachricht erzeugt. Weitere Informationen über die Eingabe eines Befehls oder Skripts finden Sie im Abschnitt <link linkend="command-alarm"
>Befehls-Erinnerungen</link
>.</para>
</listitem>
</itemizedlist>

<para
>Für Anzeige-Erinnerungen sind folgende Einstellungen möglich:</para>

<itemizedlist>
<listitem>
<para
>Mit der Einstellung <guilabel
>Klang</guilabel
> können Sie auswählen, ob beim Auslösen der Erinnerung ein Klang wiedergegeben werden soll. Wählen Sie:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Kein</guilabel
>, um kein akustisches Signal ertönen zu lassen.</para>
</listitem>

<listitem>
<para
><guilabel
>Signalton</guilabel
>, um einen Signalton ertönen zu lassen.</para>
</listitem>

<listitem>
<para
><guilabel
>Vorlesen</guilabel
>, um die Meldung nicht nur anzeigen, sondern auch vorlesen zu lassen. Diese Option ist nur verfügbar, wenn &kalarm; mit Sprachausgabe-Unterstützung erstellt wurde und das &Qt;-Sprachausgabemodul installiert und eingerichtet ist.</para>
</listitem>

<listitem>
<para
><guilabel
>Klangdatei</guilabel
>, 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.</para>

<para
>Im Klangdatei-Dialog:</para>

<itemizedlist>
<listitem>
<para
>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. Wird ein Klang abgespielt, können Sie mit diesem Knopf die Wiedergabe anhalten.</para>
</listitem>

<listitem>
<para
>Aktivieren Sie <guilabel
>Wiederholen</guilabel
>, 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.)</para>
</listitem>

<listitem>
<para
>Aktivieren Sie <guilabel
>Lautstärke einstellen</guilabel
> und regeln Sie mit dem Schieberegler die Lautstärke, mit der die Klangdatei wiedergegeben werden soll.</para>
</listitem>

<listitem>
<para
>Wenn das aktuell genutzte &phonon;-Audio-Backend es unterstützt, 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 <guilabel
>Lautstärke</guilabel
> festgelegt haben. Um diese Funktion zu aktivieren, machen Sie ein Häkchen bei <guilabel
>Einblenden</guilabel
> und geben den Zeitraum in Sekunden unter <guilabel
>Einblendedauer</guilabel
> ein. Außerdem müssen Sie noch den Schieberegler für die <guilabel
>Anfangslautstärke</guilabel
> einstellen.</para>
</listitem>
</itemizedlist>

<tip
><para
>Mit Hilfe des Knopfes <guibutton
>Versuchen</guibutton
> können Sie die gewählte Lautstärke testen.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Mit dem Knopf <guibutton
>Schriftart &amp; Farbe</guibutton
> können Sie die Schriftart sowie Vorder- und Hintergrundfarbe für die Erinnungsmeldung auswählen. Markieren Sie das Feld <guilabel
>Standardschrift benutzen</guilabel
>, wenn die Meldung in der zum Zeitpunkt der Anzeige der Meldung eingestellten Standardschrift angezeigt werden soll. Möchten Sie die Nachricht in einer bestimmten Schriftart anzeigen lassen, entfernen Sie die Markierung des Ankreuzfeldes <guilabel
>Standardschrift benutzen</guilabel
>. Die Standardschrift und -farben  können im <link linkend="preferences-edit"
>Einrichtungsdialog</link
> eingestellt werden.</para>

<para
>Die ausgewählten Farben werden dann im Eingabefeld für die Textnachricht angezeigt.</para>
</listitem>

<listitem>
<para
>Mit der Einstellung <guilabel
>Anzeigemethode</guilabel
> können Sie das Verhalten beim Auslösen der Erinnerung einstellen. Wählen Sie:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Fenster</guilabel
> zur Anzeige der Erinnerung in einem eigenen Fenster. Mit dieser Einstellung stehen Ihnen alle Optionen für das Einrichten einer Erinnerung zur Verfügung.</para>
</listitem>

<listitem>
<para
><guilabel
>Benachrichtigung</guilabel
>, um das Standard-Benachrichtigungssystem für die Anzeige der Erinnerung zu benutzen. Wegen der Einschränkungen des Benachrichtigungssystems können folgende Einstellungen für Erinnerungen mit Benachrichtigungen nicht verwendet werden: Schrift und Farbe, Auswahl einer Audiodatei für eine Erinnerung, Bestätigung der Zurkenntnisnahme einer Erinnerung und automatisches Schließen der Anzeige beim Ablauf verspäteter Erinnerungen.</para>
</listitem>
</itemizedlist>

<para
>Im Abschnitt <link linkend="message-display"
>Anzeige von Erinnerungsnachrichten</link
> finden Sie weitere Informationen zu diesem Thema.</para>
</listitem>

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

<itemizedlist>
<listitem>
<para
>In das Feld <guilabel
>Vorab-Aktion für Erinnerung:</guilabel
> 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.</para>

<para
>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:</para>

<itemizedlist>
<listitem
><para
>Wenn eine Voraberinnerung angezeigt wird.</para
></listitem>
<listitem
><para
>Wenn die Nachricht erneut angezeigt wird, nachdem die Erinnerung aufgeschoben wurde, es sei denn <guilabel
>Für verschobene Erinnerungen ausführen</guilabel
> ist aktiviert.</para
></listitem>
<listitem
><para
>Wenn die Erinnerung fällig wurde während Sie sich abgemeldet haben und bei der nächsten Anmeldung erneut ausgelöst wird.</para
></listitem>
<listitem
><para
>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 wurde.</para
></listitem>
</itemizedlist>

<para
>Mit der Aktion vor der Erinnerung kann eingestellt werden, ob die Nachricht für die Erinnerung angezeigt wird.</para>

<itemizedlist>
<listitem
><para
>Wählen Sie <guilabel
>Erinnerung bei Fehler aussetzen</guilabel
>, dann wird die Erinnerung verworfen, wenn der Befehl vor der Erinnerung mit einem Fehler beendet wurde. Damit verhindern Sie, dass die Erinnerungsnachricht angezeigt und die Aktion nach der Erinnerung ausgeführt wird.</para
></listitem>

<listitem
><para
>Wenn der Befehl vor der Erinnerung mit einem Fehler beendet wurde, wird normalerweise eine Fehlermeldung und ein Hinweis darauf in der Erinnerungsliste angezeigt. Diese Benachrichtigungen können mit der Auswahl von <guilabel
>Keine Erinnerung bei Fehlern</guilabel
> unterdrückt werden.</para
></listitem>
</itemizedlist>
</listitem>

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

<itemizedlist>
<listitem
><para
>Wenn eine Voraberinnerung geschlossen wird.</para
></listitem>
<listitem
><para
>Wenn Sie die Erinnerung aufschieben, außer, wenn die aufgeschobene Erinnerung schließlich bestätigt wird.</para
></listitem>
<listitem
><para
>Wenn die Erinnerungsnachricht durch eine Abmeldung geschlossen wird.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Lesen Sie die unten stehende Beschreibung zu <link linkend="command-alarm"
>Befehls-Erinnerungen</link
> um zu erfahren, wie Shell-Befehle ausgeführt werden.</para>

</listitem>
</itemizedlist>
</sect3>

<sect3 id="command-alarm">
<title
>Befehls-Erinnerungen</title>

<para
>Befehls-Erinnerungen führen einen Befehls aus, ohne eine Nachricht anzuzeigen.</para>

<note
><para
>Dieser Erinnerungstyp ist nicht verfügbar, wenn &kde; im Kiosk-Modus läuft.</para
></note>

<para
>Wenn der Befehl ausgeführt wird, enthält die Umgebungsvariable <envar
>KALARM_UID</envar
> die Termin-UID der Erinnerung. Wenn der Befehl im Bearbeitungsdialog für Erinnerungen durch Drücken von <guibutton
>Versuchen</guibutton
> ausgeführt wird, ist <envar
>KALARM_UID</envar
> bei neuen oder gerade geänderten Erinnerungen leer, da der Erinnerung erst beim Speichern in den Kalender eine UID zugewiesen wird.</para>

<para
>Für Befehls-Erinnerungen gibt es folgende Einstellungen:</para>

<itemizedlist>
<listitem>
<para
>Das Ankreuzfeld <guilabel
>Skript statt Befehl verwenden</guilabel
> ermöglicht Ihnen die Wahl, ob Sie einen Shell-Befehl oder ein ganzes Skript eingeben möchten.</para>

<para
>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 <envar
>SHELL</envar
>) und kann alle Optionen, Parameter, Pipes &etc; enthalten, die von der Shell auf einer Befehlszeile akzeptiert werden.</para>

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

<listitem
><para
>Wenn der Befehl mit einem Fehler beendet wurde, wird normalerweise eine Fehlermeldung und ein Hinweis darauf in der Erinnerungsliste angezeigt. Diese Benachrichtigung kann mit der Auswahl von <guilabel
>Keine Benachrichtigung bei Fehlern</guilabel
> unterdrückt werden.</para
></listitem>

<listitem>
<para
>Im Abschnitt <guilabel
>Ausgabe des Befehls</guilabel
> können Sie angeben, was mit den Ausgaben des Befehls geschehen soll.</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie <guilabel
>Im Terminal ausführen</guilabel
>, so wird der Befehl in einem Befehlsfenster ausgeführt. Das Terminal-Programm kann im <link linkend="preferences-general"
>Einrichtungsdialog</link
> ausgewählt werden.</para>
</listitem>

<listitem>
<para
>Wählen Sie <guilabel
>In Datei speichern</guilabel
>, 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.</para>
</listitem>

<listitem>
<para
>Wählen Sie <guilabel
>Verwerfen</guilabel
> um die gesamte Ausgabe des Befehls zu ignorieren.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>E-Mail-Erinnerungen</title>

<para
>Mit E-Mail-Erinnerungen wird nur eine E-Mail versendet, es wird keine Nachricht für die Erinnerung angezeigt.</para>

<para
>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. (Der Knopf wird nur angezeigt, wenn &kalarm;s <link linkend="akonadi-plugin"
>Akonadi-Modul</link
> installiert und aktiviert ist.) Anhänge können Sie über den Knopf <guibutton
>Hinzufügen ...</guibutton
> 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 <guibutton
>Entfernen</guibutton
>.</para>

<para
>Es stehen folgende Optionen zur Verfügung:</para>

<itemizedlist>
<listitem>
<para
>Aus der Liste <guilabel
>Von</guilabel
> können Sie eine &kmail;-Identität auswählen, die als Absender der E-Mail eingestellt wird. Diese Option ist nur verfügbar, wenn im <link linkend="preferences-email"
>Einrichtungsdialog</link
> die Option <guilabel
>KMail-Identitäten verwenden</guilabel
> gewählt ist. Ansonsten wird die im <link linkend="preferences-email"
>Einrichtungsdialog</link
> voreingestellte E-Mail-Adresse als Absender verwendet.</para>
</listitem>

<listitem>
<para
>Markieren Sie das Ankreuzfeld <guilabel
>Blindkopie an eigenes Postfach senden</guilabel
>, 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 <link linkend="preferences-email"
>Einrichtungsdialog</link
> festlegen. Als Vorgabe wird Ihre E-Mail-Adresse aus &kmail; verwendet.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Audio-Erinnerung</title>

<para
>Mit Audio-Erinnerungen wird nur eine Audiodatei abgespielt, es wird keine Nachricht für die Erinnerung angezeigt.</para>

<para
>Es stehen folgende Optionen zur Verfügung:</para>

<itemizedlist>
<listitem>
<para
>Geben Sie den Namen oder die Adresse der Klangdatei an oder benutzen Sie den Knopf neben den Eingabefeld, um einen Dateiauswahldialog zu öffnen.</para>
</listitem>

<listitem>
<para
>Ist die Einstellung <guilabel
>Wiederholen</guilabel
> aktiv, wird die Audiodatei solange abgespielt, bis die Wiedergabe angehalten wird. Diese Aktion <guimenuitem
>Wiedergabe anhalten</guimenuitem
> finden Sie im Menü <guimenu
>Aktionen</guimenu
> und auch im Kontextmenü, das durch Klicken mit der &RMBn; auf das Symbol im Systemabschnitt der Kontrollleiste geöffnet wird. Sie können auch einen globalen Kurzbefehl für diese Aktion festlegen. </para>
</listitem>

<listitem>
<para
>Aktivieren Sie <guilabel
>Lautstärke einstellen</guilabel
> und regeln Sie mit dem Schieberegler die Lautstärke, mit der die Klangdatei wiedergegeben werden soll.</para>
</listitem>

<listitem>
<para
>Wenn das aktuell genutzte &phonon;-Audio-Backend es unterstützt, 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 <guilabel
>Lautstärke</guilabel
> festgelegt haben. Um diese Funktion zu aktivieren, machen Sie ein Häkchen bei <guilabel
>Einblenden</guilabel
> und geben den Zeitraum in Sekunden unter <guilabel
>Einblendedauer</guilabel
> ein. Außerdem müssen Sie noch den Schieberegler für die <guilabel
>Anfangslautstärke</guilabel
> einstellen.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Verschiebung</title>

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

</sect2>

<sect2>
<title
>Zeit</title>

<para
>Im Abschnitt <guilabel
>Zeit</guilabel
> steht Folgendes zur Auswahl:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Zeitpunkt</guilabel
>, 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 <guilabel
>Keine Zeit festgelegt</guilabel
> markieren. Die Erinnerung wird dann bei nächster Gelegenheit zum eingestellten Tagesbeginn ausgelöst. Die Einrichtung des Tagesbeginns wird im <link linkend="preferences-time"
>Einrichtungsdialog</link
> von &kalarm; beschrieben.</para>

<para
>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.</para>
</listitem>

<listitem>
<para
><guilabel
>Zeit ab jetzt</guilabel
>, um einzutragen nach welchem Zeitintervall vom Zeitpunkt der Eingabe (in Stunden und Minuten) die Erinnerung ausgelöst werden soll.</para>
</listitem>
</itemizedlist>

<para
>Für die Erinnerung kann bei Bedarf eine Zeitzone eingestellt werden. Dieser Wert wird dann für alle Daten und Zeiten der Erinnerung benutzt, auch für Wiederholungen und Ausnahmen von Daten und Zeiten. Normalerweise sollten die Einstellungen hier unverändert bleiben.</para>

<para
>Die Einstellungen für die Zeitzone werden nur dann angezeigt, wenn die ausgewählte Zeitzone von der Einstellung im <link linkend="preferences-time"
>Einrichtungsdialog</link
> abweicht oder wenn Sie auf den Knopf <guibutton
>Zeitzone klicken ...</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>Im Auswahlfeld kann die Zeitzone für die Erinnerung eingestellt werden. Als Zeitzone wird hier bei einer neuen Erinnerung die Einstellung aus dem <link linkend="preferences-time"
>Einrichtungsdialog</link
> übernommen, das ist als Standard die für den Rechner eingestellte Zeitzone.</para>
</listitem>

<listitem>
<para
>Wählen Sie <guilabel
>Systemzeitzone</guilabel
>, wenn die lokale Zeit des Rechners benutzt werden soll, auf dem &kalarm; zum Zeitpunkt der Ausführung läuft.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Erinnerung</title>

<para
>Markieren Sie das Ankreuzfeld <guilabel
>Erinnerung</guilabel
>, wenn Sie vor oder nach einer Erinnerung auf die Fälligkeit aufmerksam gemacht werden wollen. Die Einstellung gilt auch für Wiederholungen der Erinnerung, auch wenn hier zu berücksichtigen ist, dass die hier angegebene Zeitspanne nicht die Wiederholungsperiode überschreiten kann. Über die Eingabeelemente rechts neben dem Ankreuzfeld können Sie einstellen, wie weit im Voraus oder im Nachhinein die Meldung erfolgen soll.</para>

<note
><para
>Erinnerungen werden nicht für zusätzliche Wiederholungen, sondern nur für die Hauptwiederholung angezeigt.</para
></note>

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


</sect2>

<sect2>
<title
>Abbruch</title>

<para
>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:</para>

<itemizedlist>
<listitem>
<para
>Das Ankreuzfeld <guilabel
>Ignorieren bei Überfälligkeit</guilabel
> bestimmt, was geschieht, wenn die Erinnerung nicht zum Zeitpunkt der Fälligkeit ausgelöst werden kann.</para>

<para
>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.</para>

<note
><para
>Bei Erinnerungen ohne Zeitangabe (d. h. bei denen das Ankreuzfeld <guilabel
>Keine Zeit festgelegt</guilabel
> markiert ist), wird die Verspätung vom Beginn des Tages an errechnet.</para
></note>

<para
>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.</para>

<note
><para
>Eine Erinnerungsmeldung kann nur dann angezeigt werden, wenn Sie angemeldet sind und sowohl die grafische Oberfläche als auch &kalarm; ausgeführt werden.</para
></note>
</listitem>

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

</sect2>

<sect2>
<title
>Wiederholung</title>

<para
>Auf der Karteikarte <guilabel
>Wiederholung</guilabel
> kann eingestellt werden, ob und wie oft eine Erinnerung wiederholt werden soll.</para>

<note
><para
>Das zugrundeliegende Wiederholungsintervall der Erinnerung wird zur besseren Übersicht auf dem Karteireiter der Karte <guilabel
>Wiederholung</guilabel
> mit dargestellt. Zuerst wird das Wiederholungsintervall, dann das Zusatz-Wiederholungsintervall angezeigt, das durch Klicken auf den Knopf <guibutton
>Zusatz-Wiederholung</guibutton
> eingegeben werden kann.</para
></note>

<para
>Unter <guilabel
>Wiederholungsregeln</guilabel
> können Sie den Typ der Wiederholung oder das Wiederholungsintervall wie folgt festlegen:</para>

<itemizedlist>
<listitem
><para
>Soll die Erinnerung nur einmal ausgelöst werden, wählen Sie <guilabel
>Keine Wiederholung</guilabel
>.</para
></listitem>

<listitem
><para
>Wählen Sie <guilabel
>beim Anmelden</guilabel
>, um die Erinnerung bei jeder Anmeldung bis zum festgelegten Zeitpunkt zu wiederholen. Eine solche Erinnerung wird auch fällig, wenn Sie &kalarm; neu starten.</para
></listitem>

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

<itemizedlist>
<listitem>
<para
>Bei wöchentlicher Wiederholung können Sie den oder die gewünschten Wochentage auswählen.</para>
</listitem>

<listitem>
<para
>Bei einer monatlichen Wiederholung können Sie zwischen einem festen Datum oder einem Wochentag als Bezugspunkt wählen (&eg; am zweiten Dienstag).</para>
</listitem>

<listitem>
<para
>Bei einer jährlichen Wiederholung können Sie zwischen einem festen Datum oder einer fester Position in einem Monat (&eg; der letzte Samstag im Mai) wählen.</para>

<para
>Wenn Sie jährlich wiederkehrende Erinnerungen für den 29. Februar festlegen, können Sie angeben, wie diese in den Jahren behandelt werden, die keine Schaltjahre sind. Die folgenden Optionen stehen für <guilabel
>Erinnerungen für den 29.Februar in Nicht-Schaltjahren</guilabel
> zur Verfügung:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Kein</guilabel
>: Die Erinnerungsmeldung wird in Schaltjahren am 29. Februar ausgelöst, in allen anderen Jahren wird die Erinnerungsmeldung ausgesetzt.</para>
</listitem>

<listitem
><para
><guilabel
>28. Februar</guilabel
>: Die Erinnerungsmeldung wird in Schaltjahren am 29. Februar ausgelöst, in allen anderen Jahren am 28. Februar.</para>
</listitem>

<listitem
><para
><guilabel
>1. März</guilabel
>: Die Erinnerungsmeldung wird in Schaltjahren am 29. Februar ausgelöst, in allen anderen Jahren am 1. März.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>Möchten Sie eine tägliche Erinnerung nur an Werktagen ausführen lassen, wählen Sie wöchentliche Wiederholung und markieren nur die Werktage als Fälligkeit.</para
></tip>

</listitem>
</itemizedlist>

<para
>Im Abschnitt <guilabel
>Wiederholung endet</guilabel
> wird der Zeitraum, in dem die Wiederholung erfolgen soll wie folgt festgelegt:</para>

<itemizedlist>
<listitem
><para
>Wählen Sie <guilabel
>Nie</guilabel
>, wenn der Zeitraum der Wiederholung unbegrenzt sein soll.</para
></listitem>

<listitem
><para
>Wählen Sie <guilabel
>nach:</guilabel
>, um eine festgelegt Anzahl von Wiederholungen einzustellen.</para
></listitem>

<listitem
><para
>Wählen Sie <guilabel
>am:</guilabel
>, um einen festen Zeitpunkt anzugeben, zu dem die Wiederholung enden soll. Für diesen Zeitpunkt wird die gleiche Zeitzone wie für die Startzeit der Erinnerung verwendet.</para>

<note
><para
>Enddatum und -Zeit legen nur fest, wann die letzte Hauptwiederholung stattfindet. Gibt es zu der Erinnerung auch Zusatz-Wiederholungen, werden diese unabhängig vom Enddatum auch noch nach der letzten Hauptwiederholung ausgelöst.</para
></note>
</listitem>
</itemizedlist>

<para
>Im Bereich <guilabel
>Ausnahmen</guilabel
> können bestimmte Daten oder Zeiten von der eingestellten Wiederholung der Erinnerung ausgeschlossen werden. Diese Einstellungsmöglichkeiten werden nur im erweiterten Dialog angezeigt, klicken Sie dazu auf <guibutton
>Mehr Optionen</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>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 <guilabel
>Hinzufügen</guilabel
>. Um eine Ausnahme zu bearbeiten drücken Sie den Knopf <guibutton
>Ändern</guibutton
>. Das Löschen einer Ausnahme erfolgt über Markieren des Eintrags in der Liste und Drücken des Knopfes <guibutton
>Löschen</guibutton
>.</para>
</listitem>

<listitem>
<para
>Wählen Sie <guilabel
>Feiertage ausschließen</guilabel
>, um Erinnerungen an Feiertagen nicht auszulösen. Damit wird eine Erinnerung an Feiertagen verworfen. Die Feiertage für ein Land oder eine Region können im <link linkend="preferences-time"
>Einrichtungsdialog</link
> eingegeben werden.</para>
</listitem>

<listitem>
<para
>Die Fälligkeit einer Erinnerung kann auf Arbeitszeiten begrenzt werden, indem Sie <guilabel
>Nur während Arbeits-Bürozeiten</guilabel
> auswählen. Damit wird eine Erinnerung außerhalb der Arbeitszeiten nicht ausgelöst. Arbeitstage und -zeiten können im <link linkend="preferences-time"
>Einrichtungsdialog</link
> eingegeben werden.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Zusatz-Wiederholung</title>

<para
>Sie können die <guibutton
>Zusatz-Wiederholung</guibutton
> dazu verwenden, um eine Wiederholung innerhalb einer Wiederholung einzurichten. Jedes Mal wenn die Wiederholung einer Erinnerung fällig wird, wird sie so oft wiederholt, wie Sie es in der Zusatz-Wiederholung festgelegt haben. So könnten Sie z. B. eine Wiederholung für jeden Donnerstag Nachmittag stündlich bis 18 Uhr einrichten: Stellen Sie eine Wiederholung jeden Donnerstag um 12:00 Uhr ein. Danach richten Sie eine zusätzliche stündliche Wiederholung mit der Anzahl 6 oder einer Dauer von 6 Stunden ein.</para>

<para
>Mit dem Klicken auf den Knopf <guibutton
>Zusatz-Wiederholung</guibutton
> öffnen Sie einen Dialog. Wählen Sie hier <guilabel
>Wiederholung alle</guilabel
> um die Wiederholung ein- oder auszuschalten. Ist diese Einstellung aktiviert, richten Sie die Wiederholung wie folgt ein:</para>

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

<listitem
><para
>Geben Sie entweder die Anzahl der Wiederholungen oder die Dauer ein:</para>

<itemizedlist>
<listitem
><para
>Wählen Sie <guilabel
>Anzahl der Erinnerungen</guilabel
> um anzugeben, wie oft die Erinnerung nach der ersten Erinnerung noch ausgelöst werden soll. Wenn die Erinnerung insgesamt 4-mal, &ie; 3-mal zusätzlich zu der eigentlichen Erinnerung wiederholt werden soll, so geben Sie hier 3 ein.</para>
</listitem>

<listitem
><para
>Wählen Sie <guilabel
>Dauer</guilabel
> um eine Gesamtzeit anzugeben, in der die Erinnerungen wiederholt werden sollen. Die Dauer muss ein Vielfaches der Wiederholungszeit sein und wird beim Klick auf <guibutton
>Ok</guibutton
> automatisch entsprechend abgerundet.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Um zu verhindern, dass sich Zusatzwiederholungen für die gleiche Erinnerung überschneiden, wird die Dauer der Zusatzwiederholung auf den größten Zeitraum der eigentlichen Wiederholung begrenzt. Jedesmal wenn die Erinnerung mit der Hauptwiederholung ausgelöst wird, dann wird jede noch fällige Zusatzwiederholung für die letzte Hauptwiederholung verworfen.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Andere Optionen</title>

<para
>Für Anzeige-Erinnerungen können Sie mit dem Ankreuzfeld <guilabel
>Zurkenntnisnahme der Erinnungsmeldung bestätigen</guilabel
> 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.</para>

<para
>Markieren Sie <guilabel
>In &korganizer; anzeigen</guilabel
>, 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. </para>

<note
><para
>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; widerspiegeln.</para
></note>

<para
>Benutzen Sie den Knopf <guibutton
>Vorlage laden ...</guibutton
> um eine Vorlage für die Erinnerung auszuwählen. Das Vorgehen wird im Abschnitt <link linkend="create-edit"
>Erstellen und Bearbeiten einer Erinnerung</link
> beschrieben. </para>

<para
>Drücken Sie dann <guibutton
>Versuchen</guibutton
>, um die Erinnerung zu testen und zu sehen, ob alles einwandfrei funktioniert. Die Erinnerung wird genauso ausgeführt als wäre sie auf herkömmlichem Weg ausgelöst worden. Bei einer Audio-Erinnerung drücken Sie <guibutton
>Versuchen</guibutton
> noch einmal. um die Wiedergabe anzuhalten.</para>

<para
>Durch Klicken auf <guibutton
>OK</guibutton
> wird die Erinnerung zur Liste der festgelegten Erinnerungen hinzugefügt. Beachten Sie, dass der Knopf <guibutton
>OK</guibutton
> erst nach der ersten Änderung aktiviert ist.</para>

</sect2>
</sect1>

<sect1 id="message-display">
<title
>Anzeige von Erinnerungsnachrichten</title>

<para
>Erinnerungsnachrichten können im Fenster oder als Benachrichtigung angezeigt werden, abhängig von den Einstellungen im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>. Die zwei Optionen zur Anzeige werden im Folgenden beschrieben.</para>

<para
>Wenn Sie Benachrichtigungen für den Desktop abschalten, wird die Anzeige von Erinnerungsnachrichten ausgesetzt, bis die Benachrichtigungen wieder aktiviert werden. Beachten Sie, dass dies für alle Anzeige-Erinnerungen gilt, unabhängig davon, ob sie in Fenstern oder als Benachrichtigungen angezeigt werden.</para>

<sect2 id="message-window">
<title
>Erinnerungsnachrichten</title>

<para
>Erinnerungsnachrichten, die in einem Fenster angezeigt werden, bieten die umfassendste  Funktionalität.</para>

<para
>Ist die Fälligkeit einer Erinnerung erreicht, wird die Nachricht auf allen 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. Wenn die Zeitzone der Fälligkeit der Erinnerung von der lokalen Zeitzone des Rechners abweicht, wird die Zeitzone auch mit angezeigt. (Für Voraberinnerungen wird der Zeitpunkt der eigentlichen Erinnerungsnachricht oder der Folgeerinnerung angezeigt, nicht die der Voraberinnerung, und der Fenstertitel ist <quote
>Voraberinnerung</quote
>).</para>

<para
>Das Erinnerungsfenster bleibt sichtbar, bis Sie die Zurkenntnisnahme bestätigen, es sei denn die Option <guilabel
>Fenster nach dieser Zeitspanne automatisch schließen</guilabel
> im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> 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 dieselbe Erinnerungsnachricht mehrfach bestätigen müssen.</para>

<para
>Das Erinnerungsfenster bietet Ihnen je nach Erinnerungstyp folgende Möglichkeiten:</para>

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

<listitem>
<para
>Durch Drücken des Knopfs <guibutton
>Bearbeiten ...</guibutton
> erscheint der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>, indem Sie die Einstellungen zu der Erinnerung überarbeiten können.</para>
</listitem>

<listitem>
<para
>Klicken Sie auf <guibutton
>Verschieben ...</guibutton
>, um die Optionen zum Verschieben der Erinnerung anzeigen zu lassen. Dann wählen Sie <guilabel
>Verschieben auf diesen Zeitpunkt</guilabel
>, um Datum und Uhrzeit der neuen Fälligkeit einzugeben, oder wählen Sie <guilabel
>Verschieben um diese Zeitspanne</guilabel
>, um ein Zeitintervall bezogen auf den jetzigen Zeitpunkt (in Stunden und Minuten) einzugeben. Klicken Sie dann auf <guibutton
>OK</guibutton
>, um die Erinnerungsmeldung wie angegeben zu verschieben.</para>

<note
><para
>Die Fälligkeit der verschobenen Erinnerung muss vor der nächsten geplanten Erinnerung liegen. Deshalb sind die Knöpfe <guibutton
>Verschieben ...</guibutton
> und <guibutton
>Ok</guibutton
> im Verschieben-Dialog eine Minute vor der nächsten geplanten Fälligkeit deaktiviert.</para>
<para
>Beachten Sie, dass Sie eine Erinnerung mit einer eingestellten Erinnerungszeit <emphasis
>nach</emphasis
> der Fälligkeit durchaus zeitlich nach die Erinnerungszeit verschieben können. In diesem Fall wird die Fälligkeitserinnerung unterdrückt.</para
></note>

<note
><para
>Der Knopf <guibutton
>Verschieben ...</guibutton
> ist nicht verfügbar für Erinnerungen, die durch die Einstellung <guilabel
>Wiederholung beim Anmelden</guilabel
> bei jeder Anmeldung angezeigt werden.</para
></note>
</listitem>

<listitem>
<para
>Klicken Sie zum Stoppen der Wiedergabe einer Klangdatei auf das Symbol <quote
>Die Wiedergabe der Klangdatei anhalten</quote
>.</para>
</listitem>

<listitem>
<para
>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 es öffnet sich &kmail; mit der entsprechenden E-Mail und dem Ordner, der sie enthält.</para>

<warning
><para
>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.</para
></warning>
</listitem>

<listitem>
<para
>Der Knopf mit dem Symbol <guiicon
>&kalarm;</guiicon
> dient zur bequemen Aktivierung des Hauptfensters von &kalarm; mit der hervorgehobenen Erinnerung.</para>
</listitem>
</itemizedlist>

<para
>Im <link linkend="preferences-view"
>Einrichtungsdialog</link
> können Sie den Modus für das Fenster mit der  Erinnerungsnachricht einstellen:</para>

<itemizedlist>
<listitem>
<para
>Als normales Fenster. In diesem Modus erhält das Fenster für die Erinnerungsmeldung bei der Anzeige den Eingabefokus, sodass Eingaben über die Tastatur an das betreffende Erinnerungsfenster gehen und nicht mehr an die Anwendung, mit der Sie gerade arbeiten. </para>
</listitem>

<listitem>
<para
>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 Titelleiste oder einen Rahmen, sodass Sie das Fenster nicht verschieben oder die Größe ändern können.</para>
</listitem>
</itemizedlist>

<note
><para
>Wenn eine Erinnerung in einer Anwendung im Volltextmodus angezeigt wird, handelt es sich unabhängig von der Einstellung um ein nicht-modales Fenster. Dies ist eine Einschränkung des Fenstersystems.</para
></note>

<sect3>
<title
>Anordnung von Fenstern mit Erinnerungsnachrichten</title>

<para
>Im <link linkend="preferences-view"
>Einrichtungsdialog</link
> können Sie zwei unterschiedliche Positionen zu Anzeige des Fensters mit der  Erinnerungsnachricht einstellen:</para>

<itemizedlist>
<listitem>
<para
>Das Erinnerungsfenster wird möglichst weit entfernt von der aktuellen Position des Mauszeigers angezeigt. Mit dieser Einstellung wird Ihr Arbeitsablauf am wenigsten gestört und damit verringert sich die Wahrscheinlichkeit, dass unbeabsichtigt durch einen Mausklick die Zurkenntnisnahme einer Erinnerung bestätigt wird.</para>
</listitem>

<listitem>
<para
>Das Erinnerungsfenster wird in der Bildschirmmitte angezeigt. Um zu verhindern, dass unbeabsichtigt durch einen Mausklick die Zurkenntnisnahme einer Erinnerung bestätigt wird, werden die Knöpfe im Fenster zu Anfang kurzzeitig deaktiviert und erst nach einer einstellbaren Verzögerungszeit aktiviert.</para>
</listitem>
</itemizedlist>

<para
>Werden mehrere Fenster mit Erinnerungsnachrichten oder Fehlermeldungen angezeigt, können diese Fenster auf dem Bildschirm verteilt werden, sodass alle sichtbar sind. Alternativ können alle Fenster gemeinsam in der oberen linken Ecke des Bildschirms angeordnet werden. Diese Einstellung finden Sie im Menü <menuchoice
> <guimenu
>Ansicht</guimenu
><guimenuitem
>Fenster verteilen</guimenuitem
></menuchoice
>. Für diese Aktion ist auch die Eingabe eines globalen Kurzbefehls möglich.</para>

</sect3>
</sect2>

<sect2>
<title
>Benachrichtigungen für Erinnerungsnachrichten</title>

<para
>Erinnerungsnachrichten, die als Benachrichtigung angezeigt werden, bieten weniger Funktionen als Erinnerungen, die im Fenster angezeigt werden.</para>

<para
>Ist die Fälligkeit einer Erinnerung erreicht, wird sie als Benachrichtigung angezeigt. Der festgelegte Zeitpunkt der Fälligkeit wird dabei angezeigt. Wenn die Zeitzone der Fälligkeit der Erinnerung von der lokalen Zeitzone des Rechners abweicht, wird die Zeitzone auch mit angezeigt. (Für Voraberinnerungen wird der Zeitpunkt der eigentlichen Erinnerungsnachricht oder der Folgeerinnerung angezeigt, nicht die der Voraberinnerung, und der Fenstertitel ist <quote
>Voraberinnerung</quote
>).</para>

<para
>Die Benachrichtigung wird nach kurzer Zeit geschlossen. Diese Zeitspanne wird für alle Anwendungen verwendet und kann in den &systemsettings; eingerichtet werden. Nach dem Zeitablauf einer Erinnerung wird die Erinnerung immer noch im Verlauf angezeigt, bis Sie sie löschen oder sich abmelden. Da es für Anwendungen keinen Zugriff auf den Verlauf von Benachrichtigungen gibt, kann &kalarm; Benachrichtigungen im Verlauf nicht entfernen oder ersetzen wie bei Erinnerungsfenster. Daher kann der Verlauf mehrere Benachrichtigungen für die gleiche Erinnerung enthalten, einschließlich Erinnerungen und Wiederholungen.</para>

<para
>In der Benachrichtigung über Erinnerungsnachrichten gibt es folgende Optionen. Durch Auswahl einer Option wird die Benachrichtigung sofort geschlossen und nicht im Verlauf angezeigt. Diese Optionen sind nur dann verfügbar, wenn die Benachrichtigung vor dem Zeitablauf aktiv ist. Greifen Sie fortlaufend auf die Benachrichtigung im Verlauf zu, kann die Benachrichtigung wegen der Beschränkungen des Benachrichtigungssystems nur aus dem Verlauf entfernt werden.</para>

<itemizedlist>
<listitem>
<para
>Sie bestätigen die Nachricht durch Klicken auf den Knopf <guibutton
>Schließen</guibutton
>. Damit wird die Benachrichtigung geschlossen.</para>
</listitem>

<listitem>
<para
>Durch Drücken des Knopfs <guibutton
>Bearbeiten ...</guibutton
> erscheint der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>, indem Sie die Einstellungen zu der Erinnerung überarbeiten können.</para>
</listitem>

<listitem>
<para
>Anzeigeeinstellungen zum Aufschieben einer Erinnerung werden durch Klicken auf <guibutton
>Zurückstellen</guibutton
> angezeigt. Dieser Knopf wird nur angezeigt, wenn eine Erinnerung verschoben werden kann. Weitere Details zu Einstellungen zum Zurückstellen einer Erinnerung finden Sie im Abschnitt <link linkend="message-window"
>Erinnerungsnachrichten</link
>.</para>
</listitem>

<listitem>
<para
>Klicken Sie irgendwo in eine Benachrichtigung, aber nicht auf einen Knopf, dann wird das Hauptfenster von &kalarm; mit dieser Erinnerung hervorgehoben aktiviert,</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Das Kontrollleistensymbol</title>

<para
>&kalarm; wird in der Standardeinstellung als Symbol im Systemabschnitt der Kontrollleiste angezeigt. Dieses Symbol bietet sowohl eine Kontrolle als auch eine Statusanzeige für die Erinnerungsfunktion. Das normale Symbol von &kalarm; zeigt an, dass die Erinnerungsfunktion aktiv ist. Zwei andere Symbole zeigen an, dass die Erinnerungen nicht überwacht werden. Die geänderten Symbole hängen ab vom verwendeten Symboldesign.</para>

<para
>Das Symbol von &kalarm; im Systemabschnitt der Kontrollleiste wird in der Voreinstellung automatisch ausgeblendet, wenn innerhalb der nächsten 24 Stunden keine Erinnerung fällig wird. Der Zeitraum für das automatische Ausblenden kann geändert werden oder das Symbol wird dauerhaft im Systemabschnitt der Kontrollleiste angezeigt. Diese Einstellungen finden Sie im <link linkend="preferences-view"
>Einrichtungsdialog</link
>. Um ein automatisch ausgeblendetes Symbol wieder anzuzeigen, klicken Sie auf den Pfeil zur Anzeige ausgeblendeter Symbole im Systemabschnitt der Kontrollleiste.</para>

<para
>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 <link linkend="preferences-view"
>Einrichtungsdialog</link
> abschalten und die Anzahl der angezeigten Erinnerungen einstellen.</para>

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

<para
>Klicken Sie mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Kontrollleistensymbol, um das Kontextmenü aufzurufen.</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Erinnerungen aktivieren</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Aktiviert oder deaktiviert die Überwachung von Erinnerungen.</action
></para>
<para
>Siehe auch <link linkend="enable-disable"
>Aktivieren/Deaktivieren der Überwachung von Erinnerungen</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Neue Erinnerung</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Wählen Sie einen Erinnerungstyp aus dem Untermenü, dann wird der Dialog zur Erstellung einer neuen Erinnerung angezeigt.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Wiedergabe anhalten</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Hält die Wiedergabe der gerade abgespielten Audiodatei an.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Fenster verteilen</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Verteilt Fenster mit Erinnerungsnachrichten oder Fehlermeldungen auf dem Bildschirm oder gruppiert sie wieder zusammen.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>&kalarm; einrichten ...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Zeigt den Einrichtungsdialog von &kalarm; an.</action
></para>
<para
>Der Einrichtungsdialog wird unter <link linkend="preferences"
>&kalarm; einrichten</link
> beschrieben. Er enthält auch Einstellmöglichkeiten für das &kalarm;-Kontrollleistensymbol.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Wiederherstellen / Minimieren</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Stellt das Hauptfenster von &kalarm; wieder her bzw. minimiert es.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Beenden</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Schließt das &kalarm;-Kontrollleistensymbol und die Hauptfenster.</action
></para>
<para
>Beendet &kalarm;, wenn keine Erinnerungsfenster angezeigt werden.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>&kalarm; im Systemabschnitt der Kontrollleiste anzeigen</title>

<para
>&kalarm; kann nur in der &plasma;-Arbeitsumgebung oder unter einer Fensterverwaltung, die diese Funktion unterstützt, im Systemabschnitt angezeigt werden.</para>

<para
>Wählen Sie <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Im Systemabschnitt der Kontrollleiste anzeigen</guimenuitem
></menuchoice
>, um &kalarm; im Systemabschnitt der Kontrollleiste entsprechend der Einstellung auf der Seite <link linkend="preferences-view"
>Anzeige</link
> des Einrichtungsdialogs anzuzeigen.</para>

<para
>Um &kalarm; aus dem Systemabschnitt der Kontrollleiste zu entfernen,  wählen Sie im Menü <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Im Systembereich anzeigen</guimenuitem
></menuchoice
> ab.</para>

<para
>Die Einstellung für die Anzeige von &kalarm; in der Kontrollleiste nach dem Start des Systems kann auf der Karteikarte <link linkend="preferences-view"
>Ansicht</link
> des Einrichtungsdialogs geändert werden.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Erinnerungsdaten aktualisieren</title>

<para
>Tritt der Fall auf, dass eine Erinnerung trotz Fälligkeit nicht ausgelöst wurde, können Sie die Erinnerungsliste aktualisieren und alle ausgelassenen Erinnerungen auslösen, indem Sie im Menü <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Erinnerungsdaten aktualisieren</guimenuitem
></menuchoice
> auswählen. Dann werden alle Kalenderdateien für Erinnerungen neu eingelesen.</para>

<para
>Sie können einen einzelnen Kalender und die darin enthaltenen Erinnerungen aktualisieren, indem Sie mit der &RMBn; auf diesen Kalender in der Kalenderliste klicken und dann im Kontextmenü <guimenuitem
>Neu laden</guimenuitem
> wählen. Weitere Informationen finden Sie im Kapitel <link linkend="calendars"
>Erinnerungs-Kalender</link
>.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Erinnerungsfunktion aktivieren/deaktivieren</title>

<para
>Erinnerungen können sowohl insgesamt als auch einzeln aktiviert und deaktiviert werden:</para>

<itemizedlist>
<listitem>
<para
><quote
>Erinnerungen aktiviert</quote
> bezieht sich auf alle Erinnerungen. Wenn das Überwachen von Erinnerungen deaktiviert ist, 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.</para>

<para
>Wird die Erinnerungsfunktion wieder aktiviert, werden alle Erinnerungen mit einer Fälligkeit im Zeitraum, in dem diese Funktion deaktiviert war, sofort ausgelöst, wenn das nicht durch die Einstellung zum Abbruch bei Verspätung verhindert wird. Die Deaktivierung der Erinnerungsfunktion hat den gleichen Effekt wie das Beenden von &kalarm; &ndash; alle Fälligkeiten sind bis zur Reaktivierung aufgeschoben.</para>
</listitem>

<listitem>
<para
>Erinnerungen können einzeln ein- oder abgeschaltet 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 je Erinnerung nur über  Menübefehle erreichen.</para>

<para
>Wird eine einzelne Erinnerung wieder reaktiviert und der Zeitpunkt der Fälligkeit lag im Zeitraum, in der die Erinnerung deaktiviert war, so wird sie jetzt fällig. Mit der Deaktivierung einer einzelnen Erinnerung werden auch alle Fälligkeiten bis zur Reaktivierung abgeschaltet.</para>

<para
>Der individuelle Aktivierungsstatus einer Erinnerung ist in der Erinnerungs-Liste an der Farbe des jeweiligen Eintrags erkennbar. Die Farben sind auf der Karteikarte <link linkend="preferences-view"
>Ansicht</link
> des Einrichtungsdialogs einstellbar.</para>
</listitem>
</itemizedlist>

<para
>Damit eine Erinnerung ausgelöst wird, muss sowohl die individuelle als auch die globale Erinnerungsfunktion aktiviert sein.</para>

<sect2>
<title
>Aktivieren der Erinnerungsfunktion</title>

<para
>Für die Erinnerungsfunktion muss &kalarm; ausgeführt werden. Wenn &kalarm; einmal gestartet wurde, dann wird das Programm von diesem Zeitpunkt an immer automatisch bei der Anmeldung gestartet. Diese Verhalten kann auf der Karteikarte <link linkend="preferences-general"
>Allgemein</link
> des Einrichtungsdialogs abgeschaltet werden.</para>

<para
>Ist die Erinnerungsfunktion deaktiviert, können Sie diese wie folgt aktivieren:</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie im Menü <menuchoice
><guimenu
>Aktionen</guimenu
> <guimenuitem
>Erinnerungen aktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Erinnerungen aktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Deaktivieren der Erinnerungsfunktion</title>

<para
>Die Überwachung von Erinnerungen kann auf verschiedene Arten deaktiviert werden. &kalarm; wird bis zur erneuten Aktivierung der Überwachung daran gehindert, Erinnerungsnachrichten zu überwachen, oder &ndash; falls die &kalarm; beim Anmelden gestartet wird &ndash; bis zur nächsten Anmeldung.</para>

<itemizedlist>
<listitem>
<para
>Wählen Sie im Menü <menuchoice
><guimenu
>Aktionen</guimenu
> <guimenuitem
>Erinnerungen aktivieren</guimenuitem
></menuchoice
> ab.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der <mousebutton
>rechten</mousebutton
> Maustaste auf das Symbol in der Kontrollleiste und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Erinnerungen aktivieren</guimenuitem
></menuchoice
> ab.</para>
</listitem>

<listitem>
<para
>Starten Sie &kalarm; mit der Befehlszeilenoption <option
>--disable-all</option
>.</para>
</listitem>

<listitem>
<para
>Beenden Sie &kalarm; wie in <link linkend="quitting"
>&kalarm; beenden</link
> beschrieben.</para>
</listitem>
</itemizedlist>

<para
>Die Erinnerungsfunktion kann auch dauerhaft abgeschaltet werden, indem Sie den automatischen Start von &kalarm; beim Anmelden auf der Karteikarte <link linkend="preferences-general"
>Allgemein</link
> des Einrichtungsdialogs deaktivieren.</para>

</sect2>

<sect2>
<title
>Einzelne Erinnerungen aktivieren/deaktivieren</title>

<para
>Ist eine einzelne Erinnerung deaktiviert, können Sie diese wie folgt aktivieren:</para>

<itemizedlist>
<listitem>
<para
>Markieren Sie die gewünschten Einträge in der Liste und wählen Sie im Menü <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Aktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; auf die gewünschten Listeneinträge und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Aktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

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

<itemizedlist>
<listitem>
<para
>Markieren Sie die gewünschten Einträge in der Liste und wählen Sie im Menü <menuchoice
><guimenu
>Aktionen</guimenu
><guimenuitem
>Deaktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klicken Sie mit der &RMBn; auf die gewünschten Listeneinträge und wählen Sie im Kontextmenü <menuchoice
><guimenuitem
>Deaktivieren</guimenuitem
></menuchoice
>.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Aufwachen aus dem Ruhezustand</title>

<para
>Es ist möglich eine ausgewählte Erinnerung so einzurichten, dass Ihr Computer aus dem Standby-Modus oder Ruhezustand aufgeweckt wird, wenn die Fälligkeit der Erinnerung erreicht ist, so dass die Aktion der Erinnerung auch ausgeführt werden kann, wenn Ihr System schlafen gelegt wurde. Diese Funktion finden Sie unter <menuchoice
><guimenu
>Aktionen</guimenu
> <guimenuitem
>Aufwachen aus dem Standby-Modus</guimenuitem
></menuchoice
>. Dieser Dialog ermöglicht es Ihnen eine Erinnerung zum Aufwachen aus dem Ruhezustand einzurichten, abzubrechen und anzuzeigen.</para>

<para
>Die Funktion für das Aufwachen aus dem Ruhezustand setzt Systemverwalterrechte voraus. Beim Einstellen oder Abbrechen einer Erinnerung für das Aufwachen aus dem Ruhezustand werden Sie nach dem Passwort für den Benutzer "root" gefragt.</para>

<note
><para
>Einige Computer, insbesondere ältere, unterstützen das Aufwachen aus dem Ruhezustand nicht. Einige können nur Aufwachzeiten verarbeiten, die nicht mehr als 24 Stunden in der Zukunft liegen. Zusätzlich ist es möglich, dass Ihr System nur aus bestimmten Ruhezuständen mit dieser Funktion aufgewacht werden kann. Es empfiehlt sich einen Testalarm einzustellen, um die Möglichkeiten ihres Systems zu testen.</para
></note>

<warning
><para
>Da Ihr Computer nur ein einziges Aufwachereignis aus dem Ruhezustand planen kann, sollten Sie sicher stellen, dass andere Anwendungen, die ebenfalls das Aufwachen aus dem Ruhezustand nutzen, nicht mit den in &kalarm; eingestellten Plänen kollidieren. Immer wenn eine Anwendung ein Aufwachereignis aus dem Ruhezustand plant oder entfernt, bricht dies alle vorher eingestellten Aufwachen aus dem Ruhezustand ab. Dies ist unabhängig davon, ob diese von &kalarm; oder einer anderen Anwendung eingestellt wurden.</para
></warning>

<para
>Der Dialog zum Einrichten des Aufwachens aus dem Ruhezustand wird in Verbindung mit der Erinnerungsliste im Hauptfenster von &kalarm; genutzt.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Hervorgehobene Erinnerung nutzen</guibutton
>: Dies stellt die derzeit ausgewählte Erinnerung in der Erinnerungsliste als eine Erinnerung für das Aufwachen aus dem Ruhezustand ein. Sollte bereits ein Aufwachen aus dem Ruhezustand geplant sein, wird dieses wie oben erklärt abgebrochen. Wenn mehr als eine Erinnerung ausgewählt ist, ist dieser Knopf nicht aktiv.</para>
</listitem>

<listitem>
<para
><guibutton
>Aufwachen aus dem Ruhezustand abbrechen</guibutton
>: Dies bricht ein geplantes Aufwachen aus dem Ruhezustand ab (es ist egal, ob dies von &kalarm; oder einer anderen Anwendung eingestellt wurde - siehe oben). Beachten Sie, dass dies nur das Aufwachen aus dem Ruhezustand einer Erinnerung abbricht. Die Erinnerung selbst wird nicht gelöscht sondern weiterhin ganz normal behandelt.</para>
</listitem>

<listitem>
<para
><guibutton
>Aktuelle Erinnerung anzeigen</guibutton
>: Dies markiert die derzeit eingestellte Erinnerung zum Aufwachen aus dem Ruhezustand in der Erinnerungsliste, so dass Sie diese ausfindig machen können. Ist keine Erinnerung zum Aufwachen aus dem Ruhezustand eingestellt, so ist dieser Knopf nicht aktiv.</para>
</listitem>

<listitem>
<para
>Über <guilabel
>Anzahl Minuten vor der Erinnerung für das Aufwachen aus dem Ruhezustand</guilabel
> können Sie sicher stellen, dass das System ausreichend Zeit zum Wiederherstellen hat, bevor die Erinnerung ausgelöst wird und die Erinnerung zum richtigen Zeitpunkt ausgeführt wird.</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="quitting">
<title
>Beenden von &kalarm;</title>

<para
>Um &kalarm; zu beenden, wählen Sie im Menü <menuchoice
><guimenu
>Datei</guimenu
> <guimenuitem
>Beenden</guimenuitem
></menuchoice
> oder im Kontextmenü des Symbols im Systemabschnitt der Kontrollleiste <menuchoice
><guimenuitem
>Beenden</guimenuitem
></menuchoice
>. Wird das Symbol nicht in der Kontrollleiste angezeigt, schließen Sie alle Fenster von &kalarm;.</para>

</sect1>
</chapter>

<chapter id="preferences">
<title
>&kalarm; einrichten</title>

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

<sect1 id="preferences-general">
<title
>Allgemein</title>

<para
>Der Bereich <guilabel
>Allgemein</guilabel
> erlaubt die Einstellung des Verhaltens von &kalarm;:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Automatisch beim Anmelden starten</guilabel
>: &kalarm; wird bei der Anmeldung gestartet. Auf diese Weise ist sichergestellt, dass &kalarm; ständig läuft, bis Sie die Anwendung beenden.</para>

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

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

<listitem>
<para
><guilabel
>Vor Beenden warnen</guilabel
>: 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.</para>
</listitem>

<listitem
><para
><guilabel
>Erinnerungsnamen aktivieren</guilabel
>: Legen Sie fest, ob jede Erinnerung einen Namen erhalten soll, damit Sie sie identifizieren können. Dies bestimmt, ob die Spalte <guilabel
>Name</guilabel
> in der <link linkend="alarm-list"
>Erinnerungsliste</link
> angezeigt wird, und ob das Feld <guilabel
>Erinnerungsname</guilabel
> im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> angezeigt wird.</para>
</listitem>

<listitem
><para
><guilabel
>Löschen bestätigen</guilabel
>: Geben Sie hier an, ob Sie beim Löschen einer Erinnerung um eine Bestätigung gebeten werden wollen.</para>
</listitem>

<listitem
><para
><guilabel
>Standard-Verschiebung um diese Zeitspanne</guilabel
>: Geben Sie hier eine Zeitspanne in Minuten und Stunden ein, die als Vorgabe im Dialog <guilabel
>Erinnerung verschieben</guilabel
> benutzt wird. Wurde eine Erinnerung jedoch bereits verschoben, dann wird als Vorgabe in diesem Dialog die vorher eingetragene Zeitspanne verwendet.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal für Befehls-Erinnerungen</guilabel
>: Hier können Sie auswählen, welches Terminal-Programm zum Ausführen von Erinnerungsbefehlen verwendet werden soll. Die üblichsten Terminalprogramm (<application
>xterm</application
> 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 <quote
>Was ist das?</quote
>-Hilfe zu dem jeweiligen Terminalprogramm aufrufen.</para>

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

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>Hier wird der Erinnerungs-Befehl erscheinen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>Hier wird der Erinnerungs-Befehl erscheinen. Zusätzlich wird noch der Befehl <literal
>sleep</literal
> angehängt.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Es wird eine temporäre Befehlsdatei erstellt, deren Inhalt der Erinnerungs-Befehl ist. Der Befehl zum Ausführen dieser Datei wird hier erscheinen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Es wird eine temporäre Befehlsdatei erstellt, deren Inhalt der Erinnerungs-Befehl mit dem angehängten Befehl <literal
>sleep</literal
> ist. Der Befehl zum Ausführen dieser Datei wird hier erscheinen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>Wird durch den Namen von &kalarm; in der aktuell eingestellten Sprache ersetzt.</para>
</listitem>
</varlistentry>
</variablelist>

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

<listitem
><para
><guilabel
>Akonadi aktivieren</guilabel
>: Wählen Sie hier aus, ob &akonadi; benutzt werden soll, um Funktionen bereitstellen zu können, die davon abhängen. Siehe <link linkend="akonadi-plugin"
>Akonadi-Modul</link
> für mehr Details. Beachten Sie, dass diese Option nur angezeigt wird, wenn das Akonadi-Modul installiert ist.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Zeit &amp; Datum</title>

<para
>Die Karteikarte <guilabel
>Zeit &amp; Datum</guilabel
> enthält Einstellungen für Zeit und Datum:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Zeitzone</guilabel
>: Stellen Sie hier Ihre Zeitzone ein, sie wird in &kalarm; als Standard benutzt, wenn für einzelne Erinnerungen keine Zeitzone angegeben ist.</para>
</listitem>

<listitem
><para
><guilabel
>Region für Feiertage</guilabel
>: Wählen Sie hier ein Land oder eine Region aus, deren Feiertagsregelung verwendet wird. Diese Einstellung wird für wiederkehrende Erinnerungen benutzt, die an Feiertagen nicht ausgelöst werden sollen. </para>
</listitem>

<listitem
><para
><guilabel
>Tagesbeginn für Erinnerungen, die nicht auf eine Uhrzeit festgelegt wurden</guilabel
>: 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 <guilabel
>keine Zeit festgelegt</guilabel
> 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.</para>
</listitem>

<listitem
><para
>Im Abschnitt <guilabel
>Arbeits-/Bürozeiten</guilabel
> finden Sie Einstellungen für die tägliche Arbeitszeit. Diese Einstellungen werden für wiederkehrende Erinnerungen verwendet, für die im Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> die Option <guilabel
>Nur während Arbeits-/Bürozeiten</guilabel
> ausgewählt ist.</para>

<itemizedlist>
<listitem
><para
>Kreuzen Sie hier die Arbeitstage einer Woche an.</para>
</listitem>

<listitem
><para
><guilabel
>Beginn der Arbeitszeit</guilabel
>: Geben Sie die Zeit ein, zu der ein Arbeitstag beginnt.</para>
</listitem>

<listitem
><para
><guilabel
>Ende der Arbeitszeit</guilabel
>: Geben Sie die Zeit ein, zu der ein Arbeitstag endet.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>KOrganizer-Termindauer</guilabel
>: Geben Sie die Dauer von Terminen in Stunden und Minuten ein, die nach &korganizer; kopiert werden. Als Voreinstellung ist keine Dauer festgelegt.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Speicherplatz für Erinnerungen</title>

<para
>Die Karteikarte <guilabel
>Speichern</guilabel
> bietet Einstellungen für die Speicherung und Behandlung abgelaufener Erinnerungen:</para>

<itemizedlist>
<listitem>
<para
>Im Abschnitt <guilabel
>Neue Erinnerungen &amp; Vorlagen</guilabel
> wird der Kalender zur Speicherung neuer Erinnerungen und Vorlagen festgelegt, wenn mehrere Erinnerung-Kalender benutzt werden.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Im Standard-Kalender speichern</guilabel
>: Neue Erinnerungen und Erinnerungsvorlagen werden automatisch ohne Nachfrage in dem als Standard festgelegten Erinnerungs-Kalender gespeichert.</para>
</listitem>

<listitem>
<para
><guilabel
>Nachfragen, in welchem Kalender gespeichert werden soll</guilabel
>: Wenn Sie bei Verwendung mehrerer beschreibbarer Erinnerungs-Kalender eine neue Erinnerung oder Vorlage erstellen, wird mit dieser Einstellung jedesmal der Speicherort abgefragt. Beachten Sie, dass Erinnerungen beim Ablauf immer automatisch ohne Nachfrage in dem Standard-Kalender für abgelaufene Erinnerungen gespeichert werden.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Abgelaufene Erinnerungen</guilabel
>: Die hier aufgeführten Einstellungen beeinflussen die Speicherung bereits abgelaufener Erinnerungen.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Erinnerungen nach ihrem Ablauf speichern</guilabel
>: Wählen Sie diese Einstellung, wenn Sie abgelaufene Erinnerungen speichern möchten. Ist diese Einstellung nicht markiert, werden abgelaufene Erinnerungen gelöscht. Beachten Sie, dass gelöschte Erinnerungen nur dann gespeichert werden, wenn sie vorher ausgelöst wurden. Wird eine Erinnerung vor der Fälligkeit gelöscht, wird sie nicht gespeichert.</para>
</listitem>

<listitem
><para
><guilabel
>Abgelaufene Erinnerungen löschen nach:</guilabel
> Hier können Sie die Anzahl Tage festlegen, die eine Erinnerung nach ihrer letzten Fälligkeit im Archiv gespeichert bleibt.</para>
</listitem>

<listitem
><para
><guibutton
>Abgelaufene Erinnerungen löschen</guibutton
>: Dieser Knopf löscht alle derzeit gespeicherten Erinnerungen, deren letzte Fälligkeit abgelaufen ist, aus dem Standard-Kalender für abgelaufene Erinnerungen. Abgelaufene Erinnerungen in anderen Kalender werden nicht behandelt, sie könnten noch von anderen Personen benutzt werden. Erinnerungen, die später ablaufen oder gelöscht wurden, werden hiervon nicht beeinflusst und werden wie eingestellt behandelt.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>E-Mail</title>

<para
>Die Seite <guilabel
>E-Mail</guilabel
> bietet Einstellungen für den Versand und die Adressierung von E-Mail-Erinnerungen:</para>

<note
><para
>Einstellungen, die von &kmail; abhängen, sind nur verfügbar, wenn &kalarm;s <link linkend="akonadi-plugin"
>Akonadi-Modul</link
> installiert und aktiviert ist.</para>
</note>

<itemizedlist>
<listitem>
<para
><guilabel
>E-Mail-Programm</guilabel
>: Geben Sie hier das Programm an, mit dem E-Mail-Erinnerungen versendet werden sollen:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Beim Auslösen einer E-Mail-Erinnerung wird die E-Mail automatisch mit &kmail; verschickt.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: 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. <application
>postfix</application
> oder <application
>qmail</application
>) eingerichtet ist.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Gesendete E-Mails in den Ordner „Versendete Nachrichten“ von KMail kopieren</guilabel
>: 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.</para>

<note
><para
>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.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Benachrichtigen, wenn E-Mails an externe Empfänger verschickt werden</guilabel
>: 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.</para>
</listitem>

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

<itemizedlist>
<listitem
><para
>Wählen Sie <guilabel
>Von:</guilabel
>, um eine E-Mail-Adresse einzugeben.</para>
</listitem>

<listitem
><para
>Wählen Sie <guilabel
>Standardidentität aus KMail verwenden</guilabel
>, um die Standardadresse als Absender einzustellen, die in &kmail; eingerichtet ist.</para>
</listitem>

<listitem
><para
>Wählen Sie <guilabel
>&kmail;-Identitäten verwenden</guilabel
>, 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.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Wählen Sie die E-Mail-Adresse, an die eine Blindkopie gesendet werden soll, wenn die Option <guilabel
>Blindkopie</guilabel
> aktiviert ist.</para>

<itemizedlist>
<listitem
><para
>Im Textfeld <guilabel
>Blindkopie</guilabel
> 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.</para>
</listitem>

<listitem
><para
>Wählen Sie <guilabel
>Standardidentität aus KMail verwenden</guilabel
>, um die Standardadresse als Absender einzustellen, die in &kmail; eingerichtet ist.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Ansicht</title>

<para
><guilabel
>Ansicht</guilabel
> bietet Einstellungen zum Erscheinungsbild von Erinnerungen in &kalarm;: In der Karteikarte <guilabel
>Allgemein</guilabel
>:</para>
<itemizedlist>

<listitem>
<para
>Gruppenfeld <guilabel
>Im Systembereich der Kontrollleiste anzeigen</guilabel
>: Das Symbol wird entsprechend der gewählten Einstellung im Systemabschnitt der Kontrollleiste angezeigt, solange &kalarm; läuft:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Immer anzeigen</guilabel
>: Das Symbol im Systemabschnitt der Kontrollleiste wird immer angezeigt.</para>
</listitem>

<listitem>
<para
><guilabel
>Automatisch ausblenden, wenn keine Erinnerungen aktiv sind</guilabel
>: Das Symbol im Systemabschnitt der Kontrollleiste wird ausgeblendet, wenn es keine aktiven Erinnerungen gibt.</para>
</listitem>

<listitem>
<para
><guilabel
>Automatisch ausblenden, wenn im Zeitraum keine Erinnerungen fällig sind</guilabel
>: Das Symbol im Systemabschnitt der Kontrollleiste wird ausgeblendet, wenn keine Erinnerung innerhalb des angegebenen Zeitraums ab jetzt fällig ist.</para>
</listitem>
</itemizedlist>

<para
>Wenn das Symbol im Systemabschnitt der Kontrollleiste ausgeblendet ist, können Sie es mit der Option zur Anzeige ausgeblendeter Symbole des Systemabschnitts der Kontrollleiste wieder einblenden.</para>

<para
>Wenn <guilabel
>Im Systembereich der Kontrollleiste anzeigen</guilabel
>ausgewählt ist, werden beim Beenden über das Symbol in der Kontrollleiste alle Hauptfenster von &kalarm; geschlossen und die Anwendung beendet, wenn gerade keine Erinnerungsfenster angezeigt werden.</para>
</listitem>

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

<itemizedlist>
<listitem>
<para
><guilabel
>Erinnerungen der nächsten 24 Stunden anzeigen</guilabel
>: Ist diese Einstellung aktiv, werden Informationen zu den innerhalb der nächsten 24 Stunden fälligen Erinnerungen angezeigt.</para>
</listitem>

<listitem>
<para
><guilabel
>Maximale Anzahl angezeigter Erinnerungen</guilabel
>: Deaktivieren Sie diese Einstellung, wenn Sie alle innerhalb der nächsten 24 Stunden fälligen Erinnerungen sehen wollen. Anderenfalls können Sie hier die Anzahl der angezeigten Erinnerungen begrenzen.</para>
</listitem>

<listitem>
<para
><guilabel
>Zeitpunkt der Fälligkeit anzeigen</guilabel
>: Ist diese Einstellung aktiv, wird der Zeitpunkt der Fälligkeit angezeigt.</para>
</listitem>

<listitem>
<para
><guilabel
>Verbleibende Zeit bis zur Fälligkeit anzeigen</guilabel
>: Aktivieren Sie diese Einstellung um die verbleibende Zeit bis zur nächsten Fälligkeit anzuzeigen. Die Zeitspanne wird in Stunden und Minuten angezeigt.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Vorangestellt</guilabel
>: 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.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Im Abschnitt <guilabel
>Erinnerungsliste</guilabel
> können die Farben für die Anzeige deaktivierter und abgelaufener Erinnerungen in der Erinnerungsliste des Hauptfensters von &kalarm; eingestellt werden.</para>
</listitem>
</itemizedlist>

<para
>Die Karteikarte <guilabel
>Erinnerungsdialoge</guilabel
> enthält die Einstellungen für das Erscheinungsbild des Fensters der Erinnerungsnachrichten.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Erinnerungsfenster möglichst weit vom Mauszeiger entfernt platzieren</guilabel
>: Mit dieser Einstellung wird verhindert, dass unbeabsichtigt durch einen Mausklick die Zurkenntnisnahme einer Erinnerung bestätigt wird, weil gerade in diesem Augenblick das Erinnerungsfenster unter dem Mauszeiger angezeigt wird.</para>
</listitem>

<listitem>
<para
><guilabel
>Erinnerungsfenster in der Bildschirmmitte platzieren, Fensterknöpfe verzögert aktivieren</guilabel
>: Mit dieser Einstellung wird das Fenster mit der Erinnerungsnachricht mitten auf dem Bildschirm angezeigt. Um zu verhindern, dass unbeabsichtigt durch einen Mausklick die Zurkenntnisnahme einer Erinnerung bestätigt wird, werden die Knöpfe im Fenster der Erinnerungsnachricht zu Anfang kurzzeitig deaktiviert. Die Verzögerungszeit dafür wird mit <guilabel
>Verzögerung für Knopf-Aktivierung (Sekunden)</guilabel
> eingestellt.</para>
</listitem>

<listitem>
<para
><guilabel
>Nachrichtenfenster haben eine Titelleiste und erhalten den Eingabefokus</guilabel
>: Diese Einstellung legt den Fenstertyp der Nachrichtenfenster fest, &ie; ob eine Erinnerungsmeldung bei der Anzeige den Eingabefokus erhält. Weitere Einzelheiten finden Sie im Abschnitt <link linkend="message-display"
>Anzeige von Erinnerungsnachrichten</link
>. </para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-edit">
<title
>Bearbeiten</title>

<para
>Die Seite <guilabel
>Bearbeiten</guilabel
> ermöglicht die Auswahl von Standardwerten für den Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>:</para>

<itemizedlist>
<listitem
><para
>Die Karteikarte <guilabel
>Allgemein</guilabel
> erlaubt Einstellungen für alle Arten von Erinnerungen.</para>

<itemizedlist>
<listitem
><para
>Legen Sie hier die Standardmethode für die Anzeige von Erinnerungsnachrichten fest.</para>
</listitem>

<listitem
><para
>Setzen Sie hier die Voreinstellung für die Ankreuzfelder <guilabel
>In KOrganizer anzeigen</guilabel
> und <guilabel
>Ignorieren bei Überfälligkeit</guilabel
>.</para>
</listitem>

<listitem
><para
>Setzen Sie hier die Voreinstellung für Wiederholungen.</para>
</listitem>

<listitem
><para
>Wählen Sie die Einstellung für die Bearbeitung von jährlichen Erinnerungen für den 29. Februar in Jahren, die keine Schaltjahre sind.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Die Karteikarte <guilabel
>Erinnerungstypen</guilabel
> erlaubt Einstellungen für bestimmte Arten von Erinnerungen.</para>

<itemizedlist>
<listitem>
<para
>Anzeige-Erinnerungen</para>

<itemizedlist>
<listitem
><para
>Setzen Sie hier die Voreinstellungen für die Ankreuzfelder <guilabel
>Fenster nach Verspätungszeitspanne automatisch schließen</guilabel
> und <guilabel
>Zurkenntnisnahme der Erinnerungsmeldung bestätigen</guilabel
>.</para>
</listitem>

<listitem
><para
>Setzen Sie hier die voreingestellte Zeiteinheit für Vorab-Erinnerungen.</para>
</listitem>

<listitem
><para
>Legen Sie hier die besonderen Aktionen für die Erinnerung fest.</para>
</listitem>

<listitem
><para
>Stellen Sie die Klang-Voreinstellungen. Beachten Sie, dass Sie die Klangdatei selbst dann auswählen können, wenn <guilabel
>Klang</guilabel
> deaktiviert oder <guilabel
>Signalton</guilabel
> oder <guilabel
>Vorlesen</guilabel
> ausgewählt ist.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Für Befehls-Erinnerungen:</para>

<itemizedlist>
<listitem
><para
>Setzen Sie hier die Voreinstellung für die Ankreuzfelder <guilabel
>Skript statt Befehl verwenden</guilabel
> und <guilabel
>Im Terminal ausführen</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Für E-Mail-Erinnerungen:</para>

<itemizedlist>
<listitem
><para
>Setzen Sie hier die Voreinstellung für das Ankreuzfeld <guilabel
>Blindkopie an eigenes Postfach senden</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Auf der Karteikarte <guilabel
>Schriftart &amp; Farbe</guilabel
> können Sie die Voreinstellung für das Erscheinungsbild von Erinnerungsnachrichten festlegen. Wählen Sie eine Standardschriftart sowie eine Vorder- und Hintergrundfarbe aus.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Befehlszeilenoptionen</title>

<para
>Wenn Befehlszeilenoptionen angegeben werden, zeigt &kalarm; die Erinnerungsliste nicht wie oben unter <link linkend="using-kalarm"
>&kalarm; verwenden</link
> beschrieben an. Mit Befehlszeilenoptionen können Sie die folgenden Aktionen durchführen:</para>

<itemizedlist>
<listitem
><para
>eine neue Erinnerung festlegen</para>
</listitem>
<listitem
><para
>den Anzeigemodus von &kalarm; einstellen</para>
</listitem>
<listitem
><para
>Hilfe anzeigen lassen </para>
</listitem>
</itemizedlist>

<para
>Weitere Befehlszeilenoptionen dienen in erster Linie der Zusammenarbeit von &kalarm; mit anderen Programmen . Sie werden im Kapitel <link linkend="cmdline-interface"
>Entwicklerhandbuch zu &kalarm;</link
> beschrieben.</para>

<para
>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.</para>

<sect1 id="cmdline-schedule">
<title
>Eine neue Erinnerungsnachricht festlegen</title>

<para
>Die folgenden Optionen werden zur Festlegung einer neuen Erinnerungsnachricht verwendet:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Option</entry>
  <entry
>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Nachfragen, wenn die Erinnerungsnachricht bestätigt wird.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>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 <option
>--mail</option
> angegeben werden.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Schließt das Erinnerungsfenster nach Ablauf des mit <option
>--late-cancel</option
> übergebenen Zeitraums. Diese Einstellung erfordert die Angabe von <option
>--late-cancel</option
>.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Einen hörbaren Piepton ausgeben, wenn die Nachricht angezeigt wird. Dabei dürfen nicht gleichzeitig die Optionen <option
>--sound</option
>  und <option
>--play-repeat</option
> verwendet werden.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Blindkopie der E-Mail an Sie. Diese Option kann nur zusammen mit der Option <option
>--mail</option
> angegeben werden.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>Farbe</replaceable
></option
></entry>
  <entry
>Setzt die Hintergrundfarbe mit einem in &Qt; festgelegten Farbnamen oder durch Angabe eines hexadezimalen Wertes der Form 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>Farbe</replaceable
></option
></entry>
  <entry
>Setzt die Vordergrundfarbe mit einem in &Qt; festgelegten Farbnamen oder durch Angabe eines hexadezimalen Wertes der Form 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Erinnerung deaktivieren. Die Erinnerung wird erst nach manueller Aktivierung wieder aktiv.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Beobachtung der Erinnerungen ausschalten. Dies hindert alle Erinnerungen solange daran ausgelöst zu werden, bis Sie Erinnerungen allgemein wieder aktivieren oder &kalarm; neu starten, &eg; bei der nächsten Anmeldung. <option
>--triggerEven</option
> kann nicht zusammen mit dieser Option angegeben werden.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>Befehlszeile</replaceable
></option
></entry>
  <entry
>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. <option
>--file</option
>  und <option
>--exec-display</option
> und <option
>--mail</option
> können nicht zusammen mit dieser Option angegeben werden. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> und <option
>--colorfg</option
> werden bei gleichzeitiger Angabe dieser Option ignoriert.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>Befehlszeile</replaceable
></option
></entry>
  <entry
>Hier können Sie eine Befehlszeile eingeben, die ausgeführt wird, um den Erinnerungstext zu erstellen. 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. <option
>--exec</option
>, <option
>--file</option
> und <option
>--mail</option
> können nicht zusammen mit dieser Option angegeben werden</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Legt den Namen oder die &URL; einer Text- oder Bilddatei fest, deren Inhalt in der Erinnerungsnachricht angezeigt wird. <option
>--exec</option
>, <option
>--exec-display</option
> and <option
>--mail</option
> können nicht zusammen mit dieser Option angegeben werden. <replaceable
>Nachricht</replaceable
> darf nicht zusammen mit dieser Option verwendet werden.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Verwende die angegebene Identität aus &kmail; für die E-Mail. Die Angabe von <option
>--mail</option
> ist für diese Option erforderlich.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>Periode</replaceable
></option
></entry>
  <entry
>Legt das Intervall zwischen Wiederholungen der Erinnerung fest. Stunden/Minuten müssen im Format <replaceable
>nHnM</replaceable
> angegeben werden. <replaceable
>n</replaceable
> steht jeweils für eine Zahl, &eg; 3H30M, steht. Andere Zeitperioden können im Format <replaceable
>nX</replaceable
>, wobei <replaceable
>n</replaceable
> für eine Zahl steht und <replaceable
>X</replaceable
> einer der Buchstaben Y (Jahre), M (Monate), W (Wochen), D (Tage) ist. Wird dabei die Option <option
>--recurrence</option
> angegeben, ist die Angabe von Y (Jahre) und M (Monate) nicht erlaubt.Diese Option ist zwingend erforderlich, falls die Option <option
>--repeat</option
> oder <option
>--until</option
> angegeben wird.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Die Erinnerung wird als Termin im aktiven Kalender von &korganizer; angezeigt.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>Zeitraum</replaceable
></option
></entry>
  <entry
>Bricht die Erinnerung ab, wenn Sie nicht im angegebenen <replaceable
>Zeitraum</replaceable
> nach der eingestellten Zeit ausgelöst werden kann. Stunden/Minuten werden im Format <replaceable
>nHnM</replaceable
>, angegeben. Hierbei ist <replaceable
>n</replaceable
> ein Zahlenwert, &eg; 3H30M. Andere Zeitperioden können im Format <replaceable
>nX</replaceable
>, wobei <replaceable
>n</replaceable
> für eine Zahl steht und <replaceable
>X</replaceable
> einer der Buchstaben Y (Jahre), M (Monate), W (Wochen), D (Tage) ist. Der Standardwert für <replaceable
>Zeitraum</replaceable
> ist 1 Minute.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Die Erinnerung wird bei jedem Anmelden ausgelöst. Die Optionen <option
>--interval</option
>, <option
>--repeat</option
> und <option
>--until</option
> können nicht zusammen mit dieser Option verwendet werden.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>Adresse</replaceable
></option
></entry>
  <entry
>Versenden einer E-Mail an die angegebene Adresse. Diese Option kann mehrfach angegeben werden. <option
>--exec</option
>, <option
>--exec-display</option
> und <option
>--file</option
> können nicht zusammen mit dieser Option angegeben werden. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> und <option
>--colorfg</option
> werden bei Angabe dieser Option ignoriert.</entry>
</row>
<row>
  <entry
><option
>-n</option
>, <option
>--name</option
></entry>
  <entry
>Geben Sie einen Namen an, um die Erinnerung zu kennzeichnen</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Zeigt die Erinnerung als Benachrichtigung, nicht in einem Fenster. Die Optionen <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> and <option
>--auto-close</option
> können nicht zusammen mit dieser Option verwendet werden.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Legt den Namen oder die &URL; einer Klangdatei fest, die entweder als Audi-Erinnerung oder beim Anzeigen der Erinnerungsnachricht abgespielt wird. Diese Option kann nicht zusammen mit <option
>--play-repeat</option
>, <option
>--beep</option
> und <option
>--speak</option
> verwendet werden.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Legt den Namen oder die &URL; einer Klangdatei fest, die solange abgespielt wird bis, <guilabel
>Wiedergabe anhalten</guilabel
> ausgewählt wird oder wie die Erinnerungsnachricht angezeigt wird. Diese Option kann nicht zusammen mit <option
>--play-repeat</option
>, <option
>--beep</option
> und <option
>--speak</option
> verwendet werden.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Diese Erinnerung wiederkehrend setzen. Geben Sie die Wiederholungseinstellungen in der Syntax von iCalendar an (beschrieben in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>). Ein Beispiel: <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. <option
>--until</option
> kann nicht zusammen mit dieser Option verwendet werden.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>Anzahl</replaceable
></option
></entry>
  <entry
>Legt fest, wie oft eine Erinnerung ausgelöst werden soll, oder, wenn es sich um eine wiederkehrende Erinnerung handelt, die über <option
>--recurrence</option
> angegeben wurde, wie oft die Erinnerung bei jeder Wiederholung ausgelöst wird. Ist die Einstellung <option
>--recurrence</option
> nicht angegeben, können Sie den Wert -1 angeben, damit die Erinnerung unbegrenzt wiederholt wird. Diese Einstellung muss gemeinsam mit der Einstellung <option
>--interval</option
> angegeben werden. Die Einstellung <option
>--until</option
> kann nicht mit dieser Einstellung kombiniert werden.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>Periode</replaceable
></option
></entry>
  <entry
>Ausgabe einer Erinnerung eine bestimmte Zeit vor oder nach der Fälligkeit und all ihrer Wiederholungen (sofern welche vorhanden). <replaceable
>Periode</replaceable
> wird in dem selben Format angeben, wie für <option
>--latel-cancel</option
> beschrieben. Standardmäßig wird die Erinnerung vor ihrer Fälligkeit ausgelöst. Um eine Erinnerung nach der Fälligkeit anzugeben, stellen Sie ein <replaceable
>+</replaceable
> der <replaceable
>Periode</replaceable
> voran, &eg; +3D. Diese Option kann nicht zusammen mit <option
>--exec</option
>, <option
>--mail</option
> oder <option
>--reminder-once</option
> verwendet werden.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>Periode</replaceable
></option
></entry>
  <entry
>Es wird genau eine Erinnerung im angegebenen Zeitraum vor oder nach der ersten Wiederholung dieser Erinnerung ausgegeben. Bei weiteren Wiederholungen erfolgt keine Erinnerung im Voraus oder Nachhinein. <replaceable
>Periode</replaceable
> wird in dem selben Format angeben, wie für <option
>--reminder</option
> beschrieben. Die Einstellung kann nicht zusammen mit <option
>--exec</option
>, <option
>--mail</option
> oder <option
>--reminder</option
> angegeben werden.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Die Nachricht wird vorgelesen, wenn sie angezeigt wird. Diese Option erfordert, dass &kalarm; mit Sprachausgabe-Unterstützung erstellt wurde und das &Qt;-Sprachausgabemodul installiert und eingerichtet ist. Diese Option kann nicht gemeinsam mit <option
>--beep</option
>, <option
>--play</option
> oder <option
>--play-repeat</option
> verwendet werden.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>Betreff</replaceable
></option
></entry>
  <entry
>Die Betreffzeile der E-Mail. Diese Option kann nur zusammen mit <option
>--mail</option
> verwendet werden.</entry>
</row>
<!-- test-set-time time (debug mode)-->
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>Datum/Zeit</replaceable
></option
></entry>
  <entry
>Die Erinnerung wird am angegebenen Datum oder Datum/Zeit ausgelöst. Ein Datum ohne Zeitangabe hat das Format <replaceable
>yyyy-mm-dd [TZ]</replaceable
>, Datum und Zeit haben das Format <replaceable
>[[[yyyy-]mm-]dd-]hh:mm[TZ]</replaceable
>. Ausgelassene optionale Angaben werden durch die entsprechenden Werten des aktuellen Datums ersetzt. Ist keine Zeitzone angegeben, dann wird die lokale Zeitzone des Systems verwendet. Zusammen mit dem Parameter  <replaceable
>TZ</replaceable
> kann der Name einer Zeitzone des Systems (&eg; <userinput
>Europa/London</userinput
>) oder <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) angegeben werden.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>Prozent</replaceable
></option
></entry>
  <entry
>Legt die Lautstärke für das Abspielen der Klangdatei fest. Diese Option kann nur gemeinsam mit <option
>--play</option
> oder <option
>--play-repeat</option
> angegeben werden.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>Datum/Zeit</replaceable
></option
></entry>
  <entry
>Wiederholt die Erinnerung bis zum angegebenen Zeitpunkt. Sie können ein Datum oder Datum/Zeit wie bei der Option <option
>--time</option
> beschrieben angeben. Ist die Option <option
>--time</option
> angegeben, wird daraus die Zeitzone gelesen. Dann darf die Option <option
>--until</option
> keine Angabe einer Zeitzone enthalten. Die Option <option
>--interval</option
> muss hier angegeben werden, die Optionen <option
>--repeat</option
> und <option
>--recurrence</option
> kann nicht zusammen mit dieser Option verwendet werden.</entry>
</row>
<row>
  <entry
><replaceable
>Nachricht</replaceable
></entry>
  <entry
>Der anzuzeigende Text der Nachricht. Ist die Option <option
>--mail</option
> angegeben, der Text der E-Mail.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Es muss entweder ein Nachrichtentext oder die Option <option
>--file</option
>, <option
>, --exec</option
><option
>--exec-display</option
>, <option
>--play</option
> oder <option
>--play-repeat</option
> angegeben werden. Alle anderen Optionen sind nicht zwingend notwendig.</para>

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

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Denke daran,\nanzuhalten"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Denke daran,\nanzuhalten"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Andere Optionen</title>

<para
>Die folgenden Optionen werden dazu verwendet, um verschiedene Funktionen auszuführen, unter anderem den Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> aufzurufen.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Option</entry>
  <entry
>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Öffnet den Dialog zum Bearbeiten der Erinnerung mit der angegebenen Kennung.eventID gibt die eindeutige Kennung des Ereignisses an, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format <replaceable
>[resourceID:]eventUID</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Öffnet den Dialog zum Erstellen einer neuen Audio-Erinnerung.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Öffnet den Dialog zum Erstellen einer neuen Befehls-Erinnerung.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Öffnet den Dialog zum Erstellen einer neuen Anzeige-Erinnerung.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Öffnet den Dialog zum Erstellen einer neuen E-Mail-Erinnerung.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>Vorlagenname</replaceable
></option
></entry>
  <entry
>Zeigt den Bearbeitungsdialog für das Erstellen einer neuen Erinnerung an. Die angegebene Vorlage ist voreingestellt.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Ausgabe der geplanten Erinnerungen auf der Standardausgabe <filename
>stdout</filename
>. Die Ausgabe enthält eine Zusammenfassung der Details zu jeder ausstehenden Erinnerung: die Kennung der Ressource, UID, nächster geplanter Erinnerungstermin  und den Nachrichtentext oder -datei.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Zeigt &kalarm; als Symbol im Systemabschnitt an.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Deaktiviert die Überwachung aller Erinnerungen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Siehe auch:</para>
<simplelist>
<member
>kf5options(7)</member>
<member
>qt5options(7)</member>
</simplelist>

</sect1>

</chapter>

<chapter id="developers">
<title
>Entwicklerhandbuch zu &kalarm;</title>

<para
>&kalarm; bietet für andere Programme eine Schnittstelle mit folgenden Funktionen:</para>

<itemizedlist>
<listitem
><para
>eine neue Erinnerung festlegen</para
></listitem>
<listitem
><para
>Abbrechen einer bereits festgelegten Erinnerung</para
></listitem>
<listitem
><para
>Auslösen einer bereits festgelegten Erinnerung</para
></listitem>
<listitem
><para
>Anzeigen des Dialogs zum Bearbeiten von Erinnerungen</para
></listitem>
<listitem
><para
>Liste der geplanten Erinnerungen</para
></listitem>
</itemizedlist>

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

<sect1 id="dbus-interface">
<title
>Schnittstelle zu &DBus;</title>

<para
>Die in diesem Dokument beschriebenen &DBus;-Aufrufe sind im &DBus;-Objektpfad <constant
>/kalarm</constant
> von &kalarm; implementiert. Die Schnittstelle dazu ist in den Dateien <filename
>org.kde.kalarm.kalarm.xml</filename
> und <filename
>kalarmiface.h</filename
> festgelegt.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>Verwerfen einer bereits festgelegten Erinnerung</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Gibt die eindeutige Kennung des zu löschenden Ereignisses an, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>cancelEvent()</function
> ist eine &DBus;-Funktion, um die angegebene Erinnerung zu verwerfen. Die Erinnerung wird ohne Anzeige oder Ausführung aus dem Kalender entfernt.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>Auslösen einer bereits festgelegten Erinnerung</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Gibt die eindeutige Kennung des auszulösenden Ereignisses an, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>triggerEvent()</function
> ist eine &DBus;-Funktion zur sofortigen Auslösung oder Ausführung einer Erinnerung. (Die festgelegte Fälligkeit spielt dabei keine Rolle). &kalarm; holt die Erinnerung aus dem Kalender und zeigt sie an bzw. führt die entsprechende Aktion aus.</para>

<para
>Ist die Erinnerung bereits fällig, löscht &kalarm; alle Fälligkeitstermine bis zum aktuellen Zeitpunkt und löscht die Erinnerung aus dem Kalender,sofern keine weiteren Wiederholungen anliegen. Ist die Erinnerung noch nicht fällig, bleiben die vorgesehenen Fälligkeiten bestehen.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>Eine neue Erinnerung festlegen.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     const QString&amp; <replaceable
>recurrence</replaceable
>,
                     int <replaceable
>subRepeatInterval</replaceable
>, 
                     int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>, 
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     int <replaceable
>recurType</replaceable
>, 
                     int <replaceable
>recurInterval</replaceable
>, 
                     int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>, 
                     int <replaceable
>lateCancel</replaceable
>, 
                     unsigned <replaceable
>flags</replaceable
>, 
                     const QString&amp; <replaceable
>bgColor</replaceable
>, 
                     const QString&amp; <replaceable
>fgColor</replaceable
>, 
                     const QString&amp; <replaceable
>font</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>reminderMins</replaceable
>, 
                     int <replaceable
>recurType</replaceable
>, 
                     int <replaceable
>recurInterval</replaceable
>, 
                     const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Gibt einen optionalen Namen für die Erinnerung an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>message</parameter
></term>
<listitem>
<para
>Enthält den Text der Nachricht für die Erinnerung, oder mit gesetztem Bit <userinput
>DISPLAY_COMMAND</userinput
> für den Parameter <parameter
>flags</parameter
> den auszuführenden Befehl, mit dem der Nachrichtentext erzeugt wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>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 <replaceable
>JJJJ-MM-TT [TZ]</replaceable
> aufweisen (so, wie es von <methodname
>QDate::toString(Qt::ISODate)</methodname
> zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format <replaceable
>JJJJ-MM-TTHH:MM[ TZ]</replaceable
> (so, wie es von <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) oder <replaceable
>HH:MM[:SS]</replaceable
> (wie es von <methodname
>QTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.</para>

<para
>Ist keine Zeitzone angegeben, dann wird die lokale Zeitzone des Systems verwendet. Zusammen mit dem Parameter  <replaceable
>TZ</replaceable
> kann der Name einer Zeitzone des Systems (&eg; <userinput
>Europa/London</userinput
>) oder <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) angegeben werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> in <filename
>alarmiface.h</filename
> definiert. Beachten sie, dass nicht alle Flags auf Textbenachrichtigungen anwendbar sind.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>fgColor</parameter
></term>
<listitem>
<para
>Legt die Vordergrundfarbe für die Anzeige der Nachricht fest. Das Format der Zeichenfolge entspricht der des Parameters <parameter
>bgColor</parameter
>. Wird als Zeichenfolge der Wert null übergeben, wird die derzeit eingestellte Standard-Vordergrundfarbe verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>font</parameter
></term>
<listitem>
<para
>Legt die Schriftart für die Anzeige der Nachricht fest. Das Format der Zeichenfolge entspricht der Ausgabe von <methodname
>QFont::toString()</methodname
>. Wird die Zeichenfolge auf null gesetzt, wird die Nachricht mit der derzeit aktuellen Standard-Schriftart für Nachrichten angezeigt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Legt fest, wieviele Minuten im Voraus eine Erinnerung für eine bald fällige Erinnerungsmeldung und, sofern vorhanden, deren Wiederholungen angezeigt werden soll. Für eine Erinnerung nach der Fälligkeit geben Sie einen negativen Wert an. Stellen Sie hier den Wert 0 ein, erfolgt keine Erinnerung im Voraus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
> beschrieben ist. Die Angabe <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse <classname
>KAlarmIface</classname
> in der Datei <filename
>kalarmiface.h</filename
> 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 <parameter
>startdateTime</parameter
> entnommen wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch <parameter
>recurType</parameter
> angegeben) zwischen zwei Fälligkeitsterminen an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter <parameter
>startdateTime</parameter
> eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beinhaltet <parameter
>startdateTime</parameter
> nur ein Datum, darf auch dieser Parameter nur ein Datum enthalten. Die Angabe einer Zeitzone ist nicht erforderlich, es wird die Zeitzone im Parameter <parameter
>startDateTime</parameter
> zur Berechnung verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl Minuten zwischen den Zusatz-Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine Zusatz-Wiederholung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Zusatz-Wiederholung einer Erinnerung an, einschließlich des ersten Auftretens.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beschreibung</title>
<para
><function
>scheduleMessage</function
> ist eine &DBus;-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. </para>

<para
>Ist die festgelegte Fälligkeit (einschließlich der Wiederholungen) bereits überschritten, zeigt &kalarm; die Nachricht sofort an (oder ignoriert den Aufruf, wenn der Parameter <parameter
>lateCancel</parameter
> 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 Standard-Erinnerungskalender.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>Festlegen einer neuen Erinnerung, die den Inhalt einer Text- oder Bilddatei anzeigt.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  const QString&amp; <replaceable
>recurrence</replaceable
>,
                  int <replaceable
>subRepeatInterval</replaceable
>, 
                  int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  int <replaceable
>recurType</replaceable
>,
                  int <replaceable
>recurInterval</replaceable
>,
                  int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>flags</replaceable
>,
                  const QString&amp; <replaceable
>bgColor</replaceable
>,
                  const QString&amp; <replaceable
>audioURL</replaceable
>,
                  int <replaceable
>reminderMins</replaceable
>,
                  int <replaceable
>recurType</replaceable
>,
                  int <replaceable
>recurInterval</replaceable
>,
                  const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Gibt einen optionalen Namen für die Erinnerung an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
>Legt die Text- oder Bilddatei fest, deren Inhalt bei Fälligkeit angezeigt wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>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 <replaceable
>JJJJ-MM-TT [TZ]</replaceable
> aufweisen (so, wie es von <methodname
>QDate::toString(Qt::ISODate)</methodname
> zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format <replaceable
>JJJJ-MM-TTHH:MM[ TZ]</replaceable
> (so, wie es von <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) oder <replaceable
>HH:MM[:SS]</replaceable
> (wie es von <methodname
>QTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.</para>

<para
>Ist keine Zeitzone angegeben, dann wird die lokale Zeitzone des Systems verwendet. Zusammen mit dem Parameter  <replaceable
>TZ</replaceable
> kann der Name einer Zeitzone des Systems (&eg; <userinput
>Europa/London</userinput
>) oder <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) angegeben werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
> definiert. Beachten Sie, dass nicht alle Flags auf Dateierinnerungen anwendbar sind.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Gibt die Hintergrundfarbe für die Anzeige der Datei an. Die Zeichenfolge kann im Format <quote
>#RRGGBB</quote
> (as returned by <methodname
>QColor::name()</methodname
>) 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 <methodname
>QColor::setNamedColor()</methodname
> akzeptiert wird. Beispielsweise als Name aus der Farbdatenbank von X (&eg; <quote
>red</quote
> or <quote
>steelblue</quote
>). Wird als Zeichenfolge der Wert null übergeben, wird die Datei mit der aktuell eingestellten Hintergrundfarbe dargestellt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Legt fest, wieviele Minuten im Voraus eine Erinnerung für eine bald fällige Erinnerungsmeldung und, sofern vorhanden, deren Wiederholungen angezeigt werden soll. Für eine Erinnerung nach der Fälligkeit geben Sie einen negativen Wert an. Stellen Sie hier den Wert 0 ein, erfolgt keine Erinnerung im Voraus.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
> beschrieben ist. Die Angabe <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse <classname
>KAlarmIface</classname
> in der Datei <filename
>kalarmiface.h</filename
> 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 <parameter
>startdateTime</parameter
> entnommen wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch <parameter
>recurType</parameter
> angegeben) zwischen zwei Fälligkeitsterminen an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter <parameter
>startdateTime</parameter
> eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beinhaltet <parameter
>startdateTime</parameter
> nur ein Datum, darf auch dieser Parameter nur ein Datum enthalten. Die Angabe einer Zeitzone ist nicht erforderlich, es wird die Zeitzone im Parameter <parameter
>startDateTime</parameter
> zur Berechnung verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl Minuten zwischen den Zusatz-Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine Zusatz-Wiederholung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Zusatz-Wiederholung einer Erinnerung an, einschließlich des ersten Auftretens.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
><function
>scheduleFile()</function
> ist eine &DBus;-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 <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
> </link
> - Näheres finden Sie in der Beschreibung dieser Funktion.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>Erzeugt eine neue Erinnerung, die bei Fälligkeit einen Shell-Befehl ausführt.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     const QString&amp; <replaceable
>recurrence</replaceable
>,
                     int <replaceable
>subRepeatInterval</replaceable
>, 
                     int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     int <replaceable
>recurType</replaceable
>,
                     int <replaceable
>recurInterval</replaceable
>,
                     int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>commandLine</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>flags</replaceable
>,
                     int <replaceable
>recurType</replaceable
>,
                     int <replaceable
>recurInterval</replaceable
>,
                     const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Gibt einen optionalen Namen für die Erinnerung an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>commandLine</parameter
></term>
<listitem>
<para
>Legt den Befehl fest, der bei Fälligkeit ausgeführt werden soll. Der Parameter <parameter
>flags</parameter
> zeigt an, ob es sich um eine Befehlszeile oder ein Befehlszeilenskript handelt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>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 <replaceable
>JJJJ-MM-TT [TZ]</replaceable
> aufweisen (so, wie es von <methodname
>QDate::toString(Qt::ISODate)</methodname
> zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format <replaceable
>JJJJ-MM-TTHH:MM[ TZ]</replaceable
> (so, wie es von <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) oder <replaceable
>HH:MM[:SS]</replaceable
> (wie es von <methodname
>QTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.</para>

<para
>Ist keine Zeitzone angegeben, dann wird die lokale Zeitzone des Systems verwendet. Zusammen mit dem Parameter  <replaceable
>TZ</replaceable
> kann der Name einer Zeitzone des Systems (&eg; <userinput
>Europa/London</userinput
>) oder <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) angegeben werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
> definiert. Beachten Sie, dass nicht alle Flags auf Erinnerungen mit Befehlszeilen anwendbar sind.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
> beschrieben ist. Die Angabe <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse <classname
>KAlarmIface</classname
> in der Datei <filename
>kalarmiface.h</filename
> 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 <parameter
>startdateTime</parameter
> entnommen wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch <parameter
>recurType</parameter
> angegeben) zwischen zwei Fälligkeitsterminen an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter <parameter
>startdateTime</parameter
> eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beinhaltet <parameter
>startdateTime</parameter
> nur ein Datum, darf auch dieser Parameter nur ein Datum enthalten. Die Angabe einer Zeitzone ist nicht erforderlich, es wird die Zeitzone im Parameter <parameter
>startDateTime</parameter
> zur Berechnung verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl Minuten zwischen den Zusatz-Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine Zusatz-Wiederholung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Zusatz-Wiederholung einer Erinnerung an, einschließlich des ersten Auftretens.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
><function
>scheduleCommand()</function
> ist eine &DBus;-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ür Schriftart und für die Klangdatei, ist die Verwendung identisch mit dem Aufruf von <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage </function
></link
>. Weitere Einzelheiten finden Sie unter der Beschreibung dieser Funktion.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>Festlegen einer E-Mail-Erinnerung</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>, 
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   const QString&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Gibt einen optionalen Namen für die Erinnerung an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fromID</parameter
></term>
<listitem>
<para
>Die &kmail;-Identität, die als Absender der E-Mail verwendet werden soll. Erfolgt hier keine Angabe, wird die unter <link linkend="preferences-email"
>Einstellungen für E-Mail-Erinnerungen</link
> eingerichtete Adresse verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>addresses</parameter
></term>
<listitem>
<para
>Eine durch Kommas getrennte Liste von Empfänger-E-Mail-Adressen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subject</parameter
></term>
<listitem>
<para
>Gibt die Betreffzeile der E-Mail an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>message</parameter
></term>
<listitem>
<para
>Gibt den Text der E-Mail an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>attachments</parameter
></term>
<listitem>
<para
>Eine durch Kommas getrennte List von Pfaden oder &URL;s, der als Anhang zu versendenden Dateien.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>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 <replaceable
>JJJJ-MM-TT [TZ]</replaceable
> aufweisen (so, wie es von <methodname
>QDate::toString(Qt::ISODate)</methodname
> zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format <replaceable
>JJJJ-MM-TTHH:MM[ TZ]</replaceable
> (so, wie es von <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) oder <replaceable
>HH:MM[:SS]</replaceable
> (wie es von <methodname
>QTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.</para>

<para
>Ist keine Zeitzone angegeben, dann wird die lokale Zeitzone des Systems verwendet. Zusammen mit dem Parameter  <replaceable
>TZ</replaceable
> kann der Name einer Zeitzone des Systems (&eg; <userinput
>Europa/London</userinput
>) oder <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) angegeben werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
> definiert. Beachten Sie, dass nicht alle Flags auf E-Mail-Erinnerungen anwendbar sind.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
> beschrieben ist. Die Angabe <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse <classname
>KAlarmIface</classname
> in der Datei <filename
>kalarmiface.h</filename
> 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 <parameter
>startdateTime</parameter
> entnommen wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch <parameter
>recurType</parameter
> angegeben) zwischen zwei Fälligkeitsterminen an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter <parameter
>startdateTime</parameter
> eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beinhaltet <parameter
>startdateTime</parameter
> nur ein Datum, darf auch dieser Parameter nur ein Datum enthalten. Die Angabe einer Zeitzone ist nicht erforderlich, es wird die Zeitzone im Parameter <parameter
>startDateTime</parameter
> zur Berechnung verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl Minuten zwischen den Zusatz-Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine Zusatz-Wiederholung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Zusatz-Wiederholung einer Erinnerung an, einschließlich des ersten Auftretens.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
><function
>scheduleEmail()</function
> ist eine &DBus;-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 Schrift und die Klangdatei ist die Verwendung identisch mit <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
> </link
>. Weitere Informationen finden Sie unter der Beschreibung dieser Funktion.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>Erzeugt eine neue Erinnerung, die bei Fälligkeit einen Shell-Befehl ausführt.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>flags</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   const QString&amp; <replaceable
>endDateTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>name</parameter
></term>
<listitem>
<para
>Gibt einen optionalen Namen für die Erinnerung an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Gibt die Klangdatei an, die abgespielt werden soll. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>volumePercent</parameter
></term>
<listitem>
<para
>Legt die Lautstärke fest (in Prozent der Maximallautstärke). Mit einem Wert von 1 wird die Standardlautstärke verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>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 <replaceable
>JJJJ-MM-TT [TZ]</replaceable
> aufweisen (so, wie es von <methodname
>QDate::toString(Qt::ISODate)</methodname
> zurückgeliefert wird. Werden Datum und Uhrzeit angegeben, sollte die Zeichenfolge im Format <replaceable
>JJJJ-MM-TTHH:MM[ TZ]</replaceable
> (so, wie es von <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) oder <replaceable
>HH:MM[:SS]</replaceable
> (wie es von <methodname
>QTime::toString(Qt::ISODate)</methodname
> zurückgegeben wird) angegeben werden. Wird kein Datum angeben, wird das aktuelle Datum angenommen. Beachten Sie, dass der Wert für Sekunden ignoriert wird.</para>

<para
>Ist keine Zeitzone angegeben, dann wird die lokale Zeitzone des Systems verwendet. Zusammen mit dem Parameter  <replaceable
>TZ</replaceable
> kann der Name einer Zeitzone des Systems (&eg; <userinput
>Europa/London</userinput
>) oder <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) angegeben werden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
> definiert. Beachten Sie, dass nicht alle Flags auf Erinnerungen mit Befehlszeilen anwendbar sind.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrence</parameter
></term>
<listitem>
<para
>Legt ein Wiederholungsintervall für die Erinnerung fest. Hierbei erfolgt die Angabe in der Syntax von iCalender, die in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
> beschrieben ist. Die Angabe <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Gibt den Wiederholungstyp der Erinnerung an. Die erlaubten Werte sind MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Diese sind in der Klasse <classname
>KAlarmIface</classname
> in der Datei <filename
>kalarmiface.h</filename
> 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 <parameter
>startdateTime</parameter
> entnommen wird.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Intervalle (Minuten/Tage/Wochen/Monate/Jahre wie durch <parameter
>recurType</parameter
> angegeben) zwischen zwei Fälligkeitsterminen an.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Wiederholungen der Erinnerung an. Bei Angabe des Wertes -1 erfolgt die Wiederholung ohne Begrenzung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Gibt das Enddatum, oder Datum und Uhrzeit für Wiederholungen der Erinnerung an. Beinhaltet der Parameter <parameter
>startdateTime</parameter
> eine Uhrzeit, muss auch dieser Parameter eine Uhrzeit enthalten, beinhaltet <parameter
>startdateTime</parameter
> nur ein Datum, darf auch dieser Parameter nur ein Datum enthalten. Die Angabe einer Zeitzone ist nicht erforderlich, es wird die Zeitzone im Parameter <parameter
>startDateTime</parameter
> zur Berechnung verwendet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Gibt die Anzahl Minuten zwischen den Zusatz-Wiederholungen einer Erinnerung an. Bei Angabe von 0 erfolgt keine Zusatz-Wiederholung.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Gibt die Anzahl der Zusatz-Wiederholung einer Erinnerung an, einschließlich des ersten Auftretens.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>
<para
><function
>scheduleAudi()</function
> ist eine &DBus;-Funktion zum Abspielen einer Audiodatei zu einem festgelegten Zeitpunkt. Abgesehen von der Angabe der Lautstärke und dem Auslassen der Nachrichtenfarbe und der Parameter für die Schrift ist die Verwendung identisch mit <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
> </link
>. Weitere Informationen finden Sie unter der Beschreibung dieser Funktion.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>edit</refname>
<refpurpose
>Es wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> geöffnet.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Gibt die eindeutige Kennung des zu bearbeitenden Ereignisses an, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Rückgabewert</title>
<para
><returnvalue
>false</returnvalue
> sofern die angegebene Erinnerung nicht gefunden wird oder den Status Nur-lesen hat, <returnvalue
>true</returnvalue
> sonst.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>edit()</function
> ist eine &DBus;-Funktion zum Anzeigen des Dialogs <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>, um darin die angegebene Erinnerung zu bearbeiten.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Es wird der Dialog <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
> zum Erstellen einer neuen Erinnerung geöffnet.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>type</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>templateName</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameter</title>
<variablelist>
<varlistentry>
<term
><parameter
>type</parameter
></term>
<listitem>
<para
>Gibt den Erinnerungstyp an. Erlaubte Werte sind DISPLAY, COMMAND, EMAIL und AUDIO, sie sind in Klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
> definiert.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>templateName</parameter
></term>
<listitem>
<para
>Gibt den Namen der Erinnerungsvorlage an, die zum Erstellen der neuen Erinnerung verwendet werden soll.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Rückgabewert</title>
<para
>Gibt <returnvalue
>false</returnvalue
> zurück, wenn <parameter
>type</parameter
> einen ungültigen Wert hat oder wenn keine Vorlage mit dem Namen <parameter
>templateName</parameter
> gefunden wurde, anderenfalls wird <returnvalue
>true</returnvalue
> zurückgegeben.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>editNew</function
> ist eine &DBus;-Funktion zur Anzeige des Dialogs <link linkend="alarm-edit-dlg"
>Erinnerung bearbeiten</link
>, um eine neue Erinnerung zu erstellen. Wird ein Erinnerungstyp als Parameter angegeben, dann sind im Dialog alle Eingabefelder leer, wird jedoch eine Erinnerungsvorlage als Parameter angegeben, wird diese im Dialog als Vorlage verwendet.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>list</refentrytitle>
</refmeta>
<refnamediv>
<refname
>list</refname>
<refpurpose
>Gibt eine Liste der geplanten Erinnerungen zurück.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Rückgabewert</title>
<para
>Liste der Erinnerungen, getrennt durch Zeilenumbruch, im Format <returnvalue
><replaceable
>resource_id</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>time</replaceable
> <replaceable
>text</replaceable
></returnvalue
></para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>list()</function
> ist ein &DBus;-Aufruf zur Ausgabe einer Zeichenfolge mit einer Zusammenfassung der geplanten Erinnerungen. Die Ausgabe enthält eine Zusammenfassung der Details zu jeder ausstehenden Erinnerung: die Kennung der Ressource, UID, nächster geplanter Erinnerungstermin  und den Nachrichtentext oder -datei.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Befehlszeilenschnittstelle</title>

<para
>Die Befehlszeilenoptionen ermöglichen anderen Programmen 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 &DBus;-Aufrufe angesprochen, im grafischen Modus startet. Das ist bei der Kommunikation zwischen Programmen unerwünscht.</para>

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

<para
>Die Befehlszeilenparameter für das Festlegen einer neuen Erinnerung werden im Kapitel <link linkend="cmdline-operation"
>Befehlszeilenoptionen</link
> beschrieben. Die Optionen für das Auslösen und Löschen von Erinnerungen lauten wie folgt:</para>

<note
><para
>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.</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Option</entry>
  <entry
>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Stoppt die Erinnerung mit der angegebenen Ereignis-Kennung. eventID ist die eindeutige Kennung des Ereignisses, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format <replaceable
>[resourceID:]eventUID</replaceable
>. Die ausgeführte Aktion entspricht dem &DBus;-Befehl <link linkend="cancelEvent"
>cancelEvent()</link
>. Die Option <option
>--triggerEvent</option
>  hier nicht angegeben werden.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Löst die Erinnerung mit der angegebenen Ereignis-Kennung aus.eventID ist die eindeutige Kennung des Ereignisses, optional mit Präfixen des Einrichtungsnamens oder der numerischen Kennung der Ressource mit dem Ereignis. Verwenden Sie das Format <replaceable
>[resourceID:]eventUID</replaceable
>. Die ausgeführte Aktion entspricht dem &DBus;-Befehl <link linkend="triggerEvent"
>triggerEvent()</link
>. Die Option <option
>--cancelEvent</option
>  hier nicht angegeben werden.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Beispiele:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299.793</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Fragen und Antworten</title>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Welche Einrichtungsdatei verwendet &kalarm;?</para>
</question>
<answer>
<para
>Die Einstellungen für &kalarm; finden Sie in folgenden Dateien im Ordner <command
>qtpaths --paths GenericConfigLocation</command
>:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarmrc</filename
> enthält Ihre Einstellungen für &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarmresources</filename
> einhält eine Liste von aktuell benutzten Erinnerungskalendern.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>In welchen Dateien werden die Erinnerungen gespeichert?</para>
</question>
<answer>

<para
>Beim ersten Start von &kalarm; werden die folgenden Erinnerungskalender im Ordner <command
>qtpaths --paths GenericDataLocation</command
> erstellt:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
>enthält die aktiven Erinnerungen.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
>enthält die abgelaufenen Erinnerungen.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
> enthält die Erinnerungsvorlagen.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
> ist eine spezielle Kalenderdatei mit den Details der aktuell angezeigten Erinnerungen. Damit kann &kalarm; beim Neustart alle beim Beenden angezeigten Erinnerungen wieder anzeigen.</simpara>
</listitem>
</itemizedlist>

<para
>Sie können diese Kalender außer <filename
>displaying.ics</filename
> später ersetzen oder zusätzliche Erinnerungs-Kalender an einem beliebigen Ort erstellen. Sie können herausfinden, welche Kalenderdateien derzeit verwendet werden, indem Sie die Details jedes Kalenders in der Liste der Erinnerungs-Kalender anzeigen lassen.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>In welchem Format werden Erinnerungen gespeichert?</para>
</question>
<answer>
<para
>Die Kalenderdateien, in denen &kalarm; die Erinnerungen speichert, sind Textdateien, deren Format durch <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
> festgelegt ist. Dies ist das Standardformat, das von allen Anwendungen in kdepim verwendet wird. &kalarm; verwendet, konform zu RFC 2445, bestimmte nicht-standardisierte Eigenschaften. Diese sind in der mit &kalarm; mitgelieferten <filename
>DESIGN-kalarmcalendar.html</filename
> dokumentiert.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Was ist der Zweck von &kalarm;s Akonadi-Modul?</para>
</question>
<answer>
<para
>&kalarm; verwendet das Akonadi-Modul, um Funktionen bereitzustellen, die auf &akonadi; aufbauen (der &PIM;-Speicherdienst von &kde;). Wenn das Modul nicht installiert und aktiviert ist, fehlen die folgenden Funktionen in &kalarm;: <itemizedlist>
<listitem>
<simpara
>Versenden von E-Mails via &kmail;, sodass &Sendmail; als einzige Option für den E-Mail-Versand verbleibt (siehe <link linkend="preferences-email"
>E-mail-Einstellungen</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Ziehen und Ablegen von E-Mails.</simpara>
</listitem>
<listitem>
<simpara
>Auswählen von E-Mail-Adressen aus &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Importieren von Geburtstagen aus &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Migration von &akonadi;-Erinnerungskalender-Ressourcen beim ersten Ausführen einer neuen &kalarm;-Version.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Wenn das Modul installiert ist, kann es in den Einstellungen unter <link linkend="preferences-general"
>Allgemeinen</link
> ein- und ausgeschaltet werden.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Was ist das Programm <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> ist ein Hilfsprogramm um &kalarm; automatisch beim Anmelden zu starten.</para>

<para
>&kalarm; wird normalerweise bei der Anmeldung durch die Sitzungsverwaltung gestartet, damit das Programmfenster im gleichen Zustand wie beim Abmelden wieder angezeigt wird. Wenn aber das Programmfenster beim Abmelden nicht geöffnet war, muss das Programm trotzdem als Symbol im Systemabschnitt der Kontrollleiste automatisch gestartet werden. Diese Problem betrifft alle Programme, die sowohl von der Sitzungsverwaltung wie auch automatisch gestartet werden. Erfolgt der automatische Start zuerst, kann die Sitzungsverwaltung ein beim Abmelden geöffnetes Programmfenster nicht mehr wiederherstellen.</para>

<para
>Um dieses Problem zu lösen, wird beim Anmelden automatisch <application
>kalarmautostart</application
> und nicht &kalarm; gestartet. <application
>kalarmautostart</application
> wartet einen kurzen Zeitraum, damit die Sitzungsverwaltung ein beim Abmelden geöffnetes Fenster wiederherstellen kann. Erst dann startet es &kalarm; und wird beendet.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Wie kann ich &kalarm; auf einer anderen Arbeitsumgebung als &plasma; benutzen?</para>
</question>
<answer>
<para
>Um &kalarm; in einer anderen Umgebung als &plasma; zu verwenden, müssen Sie selbst sicherstellen, dass &kalarm; bei jeder Anmeldung automatisch gestartet wird. Genauere Hinweise können Sie der Datei <filename
>INSTALL</filename
> aus der &kalarm;-Distribution entnehmen.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Danksagungen und Lizenz</title>

<para
>&kalarm; </para>
<para
>Copyright des Programms 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Copyright der Dokumentation 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Übersetzung: Frank Schütte <email
>F.Schuette@t-online.de</email
></para
> <para
>Übersetzung: Stephan Johach <email
>hunsum@gmx.de</email
></para
> <para
>Übersetzung: Torbjörn Klatt <email
>torbjoern.k@googlemail.com</email
></para
> &underFDL; &underGPL; <para
>Vielen Dank an den Autor der Version KAlarm aus &kde; 1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, der den Namen &kalarm; für dieses Programm ab &kde; 2 freigegeben hat. </para>

</chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->

