<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalarm;">
  <!ENTITY package "kdepim">
  <!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>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2013-05-28</date>
<releaseinfo
>2.10.03 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&kalarm; ist ein Planer für Erinnerungsnachrichten sowie für termingesteuerten E-Mail-Versand und Befehlsausführungen für &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
>In der Standardansicht zeigt &kalarm; 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 &kde;-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
>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 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>

<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 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. Um die Spalte mit der Fälligkeit der Erinnerung auszublenden oder anzuzeigen, wählen Sie im Menü <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Erinnerungszeiten anzeigen</guimenuitem
></menuchoice
>, für die Spalte mit der verbleibenden Zeit wählen Sie <menuchoice
><guimenu
>Ansicht</guimenu
><guimenuitem
>Zeiten bis zur nächsten Erinnerung anzeigen</guimenuitem
></menuchoice
>. Es wird in jedem Fall eine der Spalten 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="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"
>Neue Erinnerung</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
>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"
>Neue Erinnerung</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; oder auf das Symbol im Systemabschnitt der Kontrollleiste. Wählen Sie dann <guilabel
>Anzeige-Erinnerung</guilabel
>. Damit wird der Dialog <link linkend="alarm-edit-dlg"
>Neue Erinnerung</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; oder auf das Symbol im Systemabschnitt der Kontrollleiste. 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; oder auf das Symbol im Systemabschnitt der Kontrollleiste. Damit wird der Dialog <link linkend="alarm-edit-dlg"
>Neue Erinnerung</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; oder auf das Symbol im Systemabschnitt der Kontrollleiste. 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; oder das Symbol im Systemabschnitt der Kontrollleiste. Im Dialog <link linkend="alarm-edit-dlg"
>Neue Erinnerung</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; oder das Symbol im Systemabschnitt der Kontrollleiste. Im Dialog <link linkend="alarm-edit-dlg"
>Neue Erinnerung</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; oder auf das Symbol im Systemabschnitt der Kontrollleiste. 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"
>Neue Erinnerung</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 Ruhezustand oder Tiefschlaf.</para>

</sect2>

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

<para
>Wie Sie eine Erinnerung zur Kenntnis nehmen, wird im Abschnitt unter <link linkend="message-window"
>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"
>Neue Erinnerung</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"
>Neue Erinnerung</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"
>Neue Erinnerung</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="edit-alarm"
>Neue Erinnerung</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 drei 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>

<listitem
><para
>Datei auf Fremdrechner: Erinnerungen werden in einer einzelnen entfernten Datei im iCalendar-Format gespeichert. Damit haben Sie die Möglichkeit, von verschiedenen Orten auf die Erinnerungen zuzugreifen oder Kalender mit Erinnerungen für Andere einsehbar zu machen. In diesem Fall arbeitet &kalarm; mit einem lokalen Zwischenspeicher der Daten.</para>

<warning
><para
>Wenn ein Kalender auf einem Fremdrechner von mehreren Personen gemeinsam benutzt wird, sind Änderungen eines Benutzers nicht automatisch für die anderen Benutzer verfügbar oder es dauert eine gewisse Zeit, bis diese Änderungen für Andere sichtbar sind. So kann es passieren, das Änderungen gegenseitig unbemerkt überschrieben werden. Der Grund dafür ist, dass zuerst der geänderte Zwischenspeicher in der entfernten Datei abgespeichert und dann von dem anderen Benutzer wieder eingelesen werden muss. Jeder Benutzer muss für diesen Erinnerungskalender selbst einstellen, ob und wann er gespeichert beziehungsweise neu geladen wird.</para>

<para
>Um diese Problem zu verhindern, sollten die Einstellungen für das Speichern und Laden des Kalenders angepasst oder die Regelung vereinbart werden, dass der Kalender für die Erinnerungen nur für den Eigentümer im Schreibmodus, für alle anderen dagegen nur im Lesemodus geöffnet wird.</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
>Speichern</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Speichert alle Änderungen im ausgewählten Kalender. Der Kalender wird mit allen Änderungen von Erinnerungen seit dem letzten Laden oder Speichern aktualisiert. Dies ist nur für entfernte Kalender erforderlich, da lokale Kalender automatisch nach jeder Änderung gespeichert werden. Mit <guimenuitem
>Bearbeiten ...</guimenuitem
> aus dem Kontextmenü eines entfernten Kalenders öffnen Sie einen Dialog, um Zeitpunkt und Häufigkeit für die automatische Speicherung einzustellen.</para>

<warning
><para
>Wenn Sie einen gemeinsam mit Anderen benutzten Kalender auf einem Fremdrechner speichern, gehen alle Änderungen der anderen Benutzer seit dem Laden dieses Kalenders - ob automatisch oder manuell - verloren.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importieren ...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importiert Erinnerungen aus einer externen Kalenderdatei 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öscht die Farbe für Hervorhebung für dieses Erinnerungs-Kalender in der Erinnerungsliste.</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ählte Kalenderdatei nach Ereignissen, die Erinnerungen enthalten und kopiert diese (unter Vergabe eindeutiger IDs) in den Kalender von &kalarm;. Ereignisse ohne Erinnerungen und andere Kalendereinträge werden ignoriert. 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 dem Kalender 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>

<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"
>Neue Erinnerung</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 Erinnerungsdaten 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
>Erinnerungsdaten bearbeiten</guilabel
> </screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Der einfache Dialog <guilabel
>Erinnerungsdaten bearbeiten</guilabel
> für eine Anzeige-Erinnerung</phrase>
</textobject>
<caption
><para
>Der einfache Dialog <guilabel
>Erinnerungsdaten bearbeiten</guilabel
> für eine Anzeige-Erinnerung</para
></caption>
</mediaobject>
</screenshot>

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

<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 werde, 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 das Programm &jovie; (aus dem Paket kdeaccessibility) installiert und eingerichtet ist. Außerdem benötigen Sie einen kompatiblen Sprachsynthesizer wie &eg; <application
>Festival</application
>.</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 Sie es wünschen, kann der Klang auch langsam eingeblendet werden. Das bedeutet, dass die Klangdatei zuerst leise angespielt wird und die Lautstärke dann Schritt für Schritt erhöht wird. Die endgültige Lautstärke ist die, die Sie mit dem Schieberegler für die <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 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 Ereignis-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
>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. 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"
>Einrichtungsdialog</link
> festlegen. Die Voreinstellung ist die im Systemeinstellungen von &kde; eingerichtete E-Mail-Adresse.</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 Sie es wünschen, kann der Klang auch langsam eingeblendet werden. Das bedeutet, dass die Klangdatei zuerst leise angespielt wird und die Lautstärke dann Schritt für Schritt erhöht wird. Die endgültige Lautstärke ist die, die Sie mit dem Schieberegler für die <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
>Zeitzone ignorieren</guilabel
>, wenn die lokale Zeit des Rechners benutzt werden soll, auf dem &kalarm; läuft.</para>

<warning
><para
>Sie sollten diese Einstellung nicht verwenden, wenn für die Erinnerung eine Uhrzeit angegeben ist, ansonsten könnte sie nach dem Wechsel von Sommerzeit zu Winterzeit und umgekehrt zu unerwarteten Zeiten ausgelöst werden.</para
></warning>
</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-window">
<title
>Erinnerungsnachrichten</title>

<para
>Ist die Fälligkeit einer Erinnerung erreicht, wird die Nachricht auf allen &kde;-Arbeitsflächen angezeigt, damit sie beim Umschalten zwischen den Arbeitsflächen nicht übersehen werden kann. Der festgelegte Zeitpunkt der Fälligkeit wird dabei angezeigt. Das ist nützlich, falls Sie zu der Zeit nicht am Rechner gewesen sind. 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"
>Neue Erinnerung</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"
>Neue Erinnerung</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 sofort öffnet sich &kmail; mit der entsprechenden E-Mail.</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 von &kalarm;.</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>

<sect2>
<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>

</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. Ein ausgegrautes Symbol zeigt an, dass die Erinnerungsfunktion nicht aktiv ist. Einzelne deaktivierte Erinnerungen werden mit einem kleinen Kreuz auf dem Symbol gekennzeichnet.</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 &kde;-Arbeitsumgebung oder unter einem Fenstermanager, der 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 Tiefschlaf 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 Ruhezustand</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 in &kde; 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
>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>
</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>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Zeit und Datum</title>

<para
>Die Karteikarte <guilabel
>Zeit und 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"
>Neue Erinnerung</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 Ereignisdauer</guilabel
>: Geben Sie die Dauer von Ereignissen 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 beeinflußt 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>

<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
>: Wenn eine E-Mail-Erinnerung ausgelöst wird, so wird die E-Mail wie folgt mit &kmail; versandt (welches bei Bedarf gestartet wird):</para>

<itemizedlist>
<listitem
><para
>Wenn &kmail; in der Version 1.7 oder neuer installiert ist, so wird die E-Mail automatisch versandt.</para>
</listitem>

<listitem
><para
>Falls die &kmail;-Version älter ist, so wird die E-Mail in den Postausgang gelegt zum späteren Versand.</para>
</listitem>
</itemizedlist>
</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
>Adresse aus den KDE-Systemeinstellungen verwenden</guilabel
>, um die Adresse als Absender einzustellen, die in den Systemeinstellungen 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
>Adresse aus den KDE-Systemeinstellungen verwenden</guilabel
>, um die Adresse als Absender einzustellen, die in den Systemeinstellungen 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, z. B. ob eine Erinnerungsmeldung bei der Anzeige den Eingabefokus erhält. Weitere Einzelheiten finden Sie im Abschnitt <link linkend="message-window"
>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"
>Neue Erinnerung</link
>:</para>

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

<itemizedlist>
<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 Ereignis 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
>-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 Einstellung erfordert, dass die Anwendung &jovie; sowie ein entsprechender Sprachsynthesizer 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>
<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
>Europe/London</userinput
>), <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) oder <userinput
>Clock</userinput
> für die lokale Zeit des Rechners 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"
>Neue Erinnerung</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 die Erinnerung mit der angegebenen ID im Dialog zur Bearbeitung von Erinnerungen.</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, wenn Akonadi verwendet wird, 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>

</sect1>

<sect1 id="cmdline-help">
<title
>Hilfe-Optionen</title>

<para
>Die folgenden Optionen sind allen &kde;-Programmen gemeinsam:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Option</entry>
  <entry
>Beschreibung</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Zeigt einen kurzen Hilfetext zu den Optionen.</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Zeit verschiedene &Qt;-spezifische Optionen an.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Zeigt verschiedene &kde;-spezifische Optionen an.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Zeigt alle Optionen an.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Zeigt Namen und E-Mail-Adressen der Autoren von &kalarm;.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--version</option
></entry>
  <entry
>Zeigt die Versionen der &Qt;-Bibliothek, von &kde; und von &kalarm;.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Zeigt Informationen zur Lizenz an.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</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 ID der zu verwerfenden Erinnerung an.</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 ID der auszulösenden Erinnerung an.</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
>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
>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
>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
>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] [Clock]</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
>Europe/London</userinput
>), <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) oder <userinput
>Clock</userinput
> für die lokale Zeit des Rechners 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
>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
>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
>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
>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] [Clock]</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
>Europe/London</userinput
>), <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) oder <userinput
>Clock</userinput
> für die lokale Zeit des Rechners 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
>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
>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
>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
>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] [Clock]</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
>Europe/London</userinput
>), <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) oder <userinput
>Clock</userinput
> für die lokale Zeit des Rechners 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
>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
>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
>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
>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] [Clock]</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
>Europe/London</userinput
>), <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) oder <userinput
>Clock</userinput
> für die lokale Zeit des Rechners 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
>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
>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
>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
>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] [Clock]</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
>Europe/London</userinput
>), <userinput
>UTC</userinput
> für die Zeitzone UTC (Coordinated Universal Time - koordinierte Weltzeit) oder <userinput
>Clock</userinput
> für die lokale Zeit des Rechners 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"
>Neue Erinnerung</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 ID der zu bearbeitenden Erinnerung an.</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"
>Neue Erinnerung</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"
>Neue Erinnerung</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"
>Neue Erinnerung</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
> (wenn Akonadi benutzt wird), or <returnvalue
><replaceable
>UID</replaceable
> <replaceable
>time</replaceable
> <replaceable
>text</replaceable
></returnvalue
> (wenn KResources benutzt wird).</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschreibung</title>

<para
><function
>list()</function
> ist ein &DBus;-Aufruf zur Ausgabe einer Zeichenkette mit einer Zusammenfassung der geplanten Erinnerungen. Die Ausgabe enthält eine Zusammenfassung der Details zu jeder ausstehenden Erinnerung: die Kennung der Ressource, wenn Akonadi verwendet wird, 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
>Verwirft die Erinnerung mit der angegebenen <replaceable
>eventID</replaceable
>. <option
>--triggerEven</option
> kann nicht zusammen mit dieser Option angegeben werden.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Löst das Ereignis mit der angegebenen Kennung aus. Der Ablauf ist identisch mit dem Aufruf der &DBus;-Funktion <link linkend="triggerEvent"
>triggerEvent()</link
>. <option
>--cancelEvent</option
> kann nicht zusammen mit dieser Option 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>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Wie heißen die Konfigurationsdateien von &kalarm;?</para>
</question>
<answer>
<para
>Die Datei <filename
>$KDEHOME/share/config/kalarmrc</filename
> enthält Ihre Einstellungen für &kalarm;.</para>
<para
>Die Datei <filename
>$KDEHOME/share/config/kresources/alarms/stdrc</filename
> enthält Ihre Einstellungen für den Erinnerungs-Kalender.</para>

<para
>($<envar
>KDEHOME</envar
> ist üblicherweise <filename class="directory"
>&tilde;/.kde</filename
> oder ähnlich.)</para>
</answer>
</qandaentry>

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

<para
>Beim ersten Start erstellt &kalarm; Kalenderdateien mit den folgenden Namen, wenn diese Einstellungen nicht im Abschnitt <parameter
>Allgemein</parameter
> der Einrichtungsdatei für &kalarm; geändert wurden:</para>

<itemizedlist>
<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
> enthält aktive Erinnerungen, dies kann durch den Eintrag  <parameter
>Calendar</parameter
> überschrieben werden.</para>
</listitem>

<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/expired.ics</filename
> enthält abgelaufene Erinnerungen, dies kann durch den Eintrag  <parameter
>ExpiredCalendar</parameter
> überschrieben werden.</para>
</listitem>

<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/template.ics</filename
> enthält Erinnerungsvorlagen, dies kann durch den Eintrag  <parameter
>TemplateCalendar</parameter
> überschrieben werden.</para>
</listitem>
</itemizedlist>

<para
>Die aktuell verwendeten Kalenderdateien werden im Einstellungsdialog der einzelnen Kalender aus der Kalenderliste angezeigt. Die Namen der Kalenderdateien werden in der Einrichtungsdatei jedes Erinnerungs-Kalenders gespeichert.</para>

<para
>Die Daten für die angezeigten Erinnerungen sind in der Kalenderdatei <filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
> abgelegt.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>In welchem Format werden Erinnerungen gespeichert?</para>
</question>
<answer>
<para
>Die Kalenderdateien, in denen &kalarm; seine 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.html</filename
> dokumentiert.</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>

</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 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Copyright der Dokumentation 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 &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>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-kalarm">
<title
>Woher bekommen Sie &kalarm;?</title>
&install.intro.documentation; <para
>&kalarm; für &kde; 4 und auch ältere Versionen für &kde; 3 und &kde; 2 finden Sie auf <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
> </para>

</sect1>

<sect1 id="requirements">
<title
>Voraussetzungen</title>

<para
>&kalarm; benötigt die Standardbibliotheken von &kde; (die Pakete <filename
>kdelibs</filename
>, <filename
>kdepimlibs</filename
> packages) und <filename
>kdebase/runtime</filename
>). Für die Kompilierung benötigen Sie außerdem die Entwicklerpakete für diese Bibliotheken sowie für &Qt;.</para>

<para
>Die folgenden, optionalen Pakete erweitern &kalarm; um weitere Funktionen.</para>

<itemizedlist>
<listitem
><para
>&jovie; (aus dem Paket kdeaccessibility): Ist diese Anwendung zusammen mit einem entsprechenden Sprachsynthesizer installiert und eingerichtet, kann &kalarm; angezeigte Erinnerungsnachrichten vorlesen.</para>
</listitem>
</itemizedlist>

<para
>Eine Liste der Änderungen finden Sie in der Datei <filename
>Changelog</filename
> oder auf <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Kompilierung und Installation</title>

<para
>Wenn Sie kein geeignetes vorkompiliertes Paket finden, müssen Sie &kalarm; selbst aus den Quelldateien kompilieren. Dazu benötigen Sie die Dateien <filename
>kdepim-x.x.tar.bz2</filename
> oder <filename
>kalarm-x.x.tar.bz2</filename
> (oder ähnlich), abhängig davon, ob Sie das gesamte &package; oder nur &kalarm; installieren möchten. Die Datei muss in einem neuen Unterverzeichnis entpackt werden. Das kann durch <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>Paket.tar.bz2</replaceable
></option
></userinput
> erfolgen. Dann wechseln Sie in das erzeugte Unterverzeichnis.</para>
&install.compile.documentation; <warning
><para
>Wenn Sie &kalarm; in einen Ordner installieren, in dem keine Version von &kde; installiert ist, müssen Sie diesen Installationsort &kde; bekanntmachen. Dazu müssen Sie der Umgebungsvariable <envar
>KDEDIRS</envar
> den Installationspfad von &kalarm; vor jedem Start von &kde; voranstellen.</para>

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

<para
>Die selbständige Version von &kalarm; verfügt über eine spezielle Einstellungsmöglichkeit, mit der Sie beim Aufruf von <command
>./configure</command
> durch Angabe eines Sprachkodes bzw. einer Liste von Sprachkodes festlegen können, für welche Sprache eine Dokumentation installiert werden soll. In der Voreinstellung werden alle verfügbaren Sprachen installiert. Eine Liste der übersetzen Dokumentationen mit dem zugehörigen Sprachencode finden Sie in der Datei <filename
>DOC-LANGUAGES</filename
>. Um zum Beispiel nur die französische oder englische Übersetzung der Dokumentation zu installieren, geben Sie folgendes ein:</para>

<para
><userinput
><command
>./configure</command
> --enable-doc-language=<replaceable
>"fr en_GB"</replaceable
></userinput
></para>

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

</sect1>

<sect1 id="configuration">
<title
>Einrichtung</title>

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

<para
>Um &kalarm; in einer anderen Umgebung als &kde; 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>

</sect1>

</appendix>

&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:
-->

