<?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 % Dutch "INCLUDE"
><!-- change language only here -->
]>

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

<book lang="&language;">

<bookinfo>
<title
>Het handboek van &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
>Ontwikkelaar</contrib>
</othercredit>

&ged.vertaald;&Niels.Reedijk;&Ruben.Van.Laerhoven; 
</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>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2011-05-13</date>
<releaseinfo
>2.07.00 (&kde; 4.7)</releaseinfo>

<abstract>
<para
>&kalarm; is een persoonlijke planner voor herinneringen, commando's en e-mailberichten voor &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>herinnering</keyword>
<keyword
>herinnering vooraf</keyword>
<keyword
>takenplanner</keyword>
</keywordset>

</bookinfo>


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

<para
>&kalarm; stelt u in staat persoonlijke herinneringsberichten, het afspelen van geluidsbestanden, het uitvoeren van commando's en het verzenden van e-mails in te plannen.</para>

<para
>In zijn standaard grafische modus toont &kalarm; de lijst met herinneringendie in de wachtrij staan, met hun tijd(en) en details. U kunt nieuwe herinneringen aanmaken of u kunt bestaande herinneringen wijzigen of verwijderen. U kunt ook, als optie, reeds verlopen herinneringen bekijken.</para>

<para
>Bij het instellen van een herinnering, kunt u kiezen of deze herhaald moet worden, en of de herinnering geannuleerd moet worden als er geen melding van gemaakt kan worden op de ingestelde tijd. U kunt een berichttekst intypen, een tekst- of beeldbestand kiezen dat getoond moet worden, of een commando specificeren waarvan de uitvoer getoond moet worden bij het tonen van de herinnering. U kunt ook de kleur van het herinneringsbericht kiezen, of er een geluid afgespeeld moet worden en of het bericht voorgelezen moet worden.</para>

<para
>Herinneringen kunnen ook ingesteld worden vanaf de commandoregel, of via een &DBus;-oproep vanuit een ander programma.</para>

<para
>Wanneer een herinnering afloopt, wordt er een visueel herinneringsbericht getoond op elk &kde;-bureaublad opdat u het zeker ziet. Dit berichtvenster toont de geplande tijd voor de herinnering, en het heeft meestal een uitsteloptie om de herinnering later opnieuw te laten tonen. Een voorbeeld van een herinneringsbericht:</para>

<screenshot>
<screeninfo
>Schermafbeelding van een berichtvenster van &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Herinneringsbericht</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Wanneer er een commando uitgevoerd of een e-mail verzonden moet worden door de herinnering, geeft &kalarm; niets weer.</para>

<para
>Normaal staat er een pictogram van &kalarm; in het systeemvak hoewel dit, indien gewenst, verborgen kan worden.</para>

</chapter>

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

<para
>Als &kalarm; uitgevoerd wordt zonder extra parameters op de commandoregel, start &kalarm; in grafische modus, en toont daarbij de huidige lijst met openstaande herinneringen.</para>

<tip
><para
>Alle schuifregelaars in &kalarm; hebben een versnelling. Om de waarden met grotere stappen te veranderen: druk op &Shift; en klik op één van depijltjes van de schuifregelaar.</para>

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

<sect1 id="alarm-types">
<title
>Typen herinneringen</title>

<para
>De beschikbare basisfuncties in &kalarm; voor verschillende typen herinneringen zijn:</para>

<itemizedlist>
<listitem>
<para
>Herinneringen kunnen getoond worden met een tekstbericht dat u intypt, met de inhoud van een tekst- of beeldbestand, of met de tekstuitvoer van een commando dat uitgevoerd wordt op het moment dat de herinneringstijd bereikt wordt. Daarbij kan er ook een audiobestand afgespeeld worden, tekst voorgelezen worden of een bieptoon uitgestuurd worden. U kunt eveneens commando's instellen die uitgevoerd moeten worden voordat en nadat het herinneringsbericht getoond wordt.</para>
</listitem>

<listitem>
<para
>Herinneringen met shell-commando voeren ofwel een enkel commando ofwel een shellscript uit (door u ingetypt). Er wordt bij zo'n herinnering niets getoond, behalve als er een fout optreedt.</para>
</listitem>

<listitem>
<para
>Herinneringen via e-mail verzenden een e-mail. Er wordt niets getoond, behalve als er een fout optreedt.</para>
</listitem>

<listitem>
<para
>Audioherinneringen spelen een audio-bestand af. Er wordt niets getoond, behalve als er een fout optreedt.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Afhandelen van fouten</title>

<para
>Wanneer er een fout optreedt bij het uitvoeren van een herinnering, wordt er een foutmelding getoond (behalve als u ervoor hebt ingesteld dat dat type berichten niet meer getoond moet worden).</para>

<para
>Als er de laatste keer bij het uitvoeren van een commandoherinnering een fout optrad, wordt er een wit-op-rood uitroepteken getoond in de kolom met kleuren bij de berichten. Details van de fout worden weergegeven in een tekstballon wanneer u uw muisaanwijzer op die regel in de lijst met herinneringen zet. Dezelfde foutmeldingen worden getoond bij schermherinneringen als er een uitvoerfout optrad bij een commando voor of na het alarm (zoals gedefinieerd in het dialoogvenster Speciale Acties), maar hier zonder de rode achtergrond in de kleurenkolom.</para>

</sect2>
</sect1>

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

<para
>Het hoofdvenster van &kalarm; toont de huidige lijst met openstaande herinneringen. Daarbij worden ook de tijden, de herhalingsintervallen en kleuren getoond, en ook de berichttekst, de naam van de bestanden die afgespeeld of getoond moeten worden, het commando dat uitgevoerd moet worden, of het onderwerp van de e-mail. (Voor een terugkerende herinnering wordt de tijd getoond waarop de eerstvolgende keer de herinnering plaatsvindt. Voor een herinnering met een herinnering vooraf, wordt de tijd getoond van de herinnering zelf, niet van de herinnering vooraf.) Een pictogram links van elke herinneringstekst/bestand/commando/e-mailonderwerp duidt het type herinnering aan.</para>

<screenshot>
<screeninfo
>Schermafbeelding van het hoofdvenster van &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Hoofdvenster</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>In de lijst worden van herhaalde herinneringen deeerstvolgende keer dat ze plaatsvinden, en ook het basis herhalingsinterval getoond (&eg; <quote
>1 dag</quote
> voor iets dat dagelijks terugkomt, <quote
>3 weken</quote
> voor een herinnering die om de 3 weken maandag en woensdag voorkomt, of <quote
>aanmelden</quote
> voor een herinnering die herhaald wordt elke keer dat u zich aanmeldt).</para>

<para
>Als er de laatste keer bij het uitvoeren van een commandoherinnering, of van een pre- of postherinneringscommando, een fout optrad, wordt er een foutmelding getoond in de kleurenkolom, wat u hierboven kunt terugvinden in <link linkend="errors"
>Afhandelen van fouten</link
>.</para>

<sect2 id="listappear">
<title
>Het uiterlijk van de herinneringslijst veranderen</title>

<para
>De herinneringen kunnen gesorteerd worden op datum/tijd, herhalingsinterval, kleur, type of tekst door te klikken op de titelbalk van de desbetreffende kolom. Om de sortering om te keren klikt u nogmaals op de titelbalk van dezelfde kolom.</para>

<para
>Optioneel kunt u ook de resterende tijd tot een herinnering laten tonen, samen met, of in plaats van, de geplande tijd van de herinnering. Om de tijdskolom van de herinneringen te tonen of te verbergen, gaat u naar <menuchoice
><guimenu
>Beeld</guimenu
><guimenuitem
>Tijdstippen herinneringen tonen</guimenuitem
></menuchoice
>. Om de kolom met de resterende tijd te tonen of te verbergen, klikt u op <menuchoice
><guimenu
>Beeld</guimenu
><guimenuitem
>Resterende tijd tot herinneringen tonen</guimenuitem
></menuchoice
>. Er wordt steeds minstens één van de kolommen getoond.</para>

<para
>Als u meerdere kalenders gebruikt, kunt u een achtergrondkleur instellen voor kalenders. De bijbehorende herinneringen zullen dan ook die kleurcode krijgen.</para>

</sect2>

<sect2 id="expired">
<title
>Gearchiveerde herinneringen</title>

<para
>Standaard archiveert &kalarm; herinneringen voor een beperkte tijd wanneer ze verwijderd of verlopen zijn. (Opmerking: herinneringen die verwijderd zijn, worden enkel bijgehouden als ze reeds minstens één keer plaatsgevonden hebben.) U kunt instellen of &kalarm; herinneringen bijhoudt, en voor hoe lang, in het <link linkend="preferences-storage"
> Configuratievenster</link
>.</para>

<para
>Verlopen herinneringen kunnen toch getoond worden in de herinneringslijst door te klikken op <menuchoice
><guimenu
>Beeld</guimenu
><guimenuitem
> Verlopen herinneringen tonen</guimenuitem
></menuchoice
>. Om deze herinneringen terug te verbergen, klikt u nogmaals op hetzelfde item in het menu.</para>

</sect2>

<sect2 id="search">
<title
>Zoeken in de herinneringslijst</title>

<para
>U kunt de herinneringslijst doorzoeken om herinneringen te vinden die de zoektekst bevatten. Om deze functie op te starten, klikt u op <menuchoice
> <guimenu
> Bewerken</guimenu
><guimenuitem
> Zoeken...</guimenuitem
></menuchoice
>. In het dialoogvenster dat dan verschijnt, kunt u de typen herinneringen selecteren waarnaar gezocht moet worden. Om andere zoekresultaten te vinden kunt u <menuchoice
> <guimenu
>Bewerken</guimenu
><guimenuitem
>Volgende zoeken</guimenuitem
></menuchoice
> of <menuchoice
> <guimenu
>Bewerken</guimenu
><guimenuitem
>Vorige zoeken</guimenuitem
> </menuchoice
> aanklikken.</para>

<para
>Het zoeken wordt als volgt uitgevoerd:</para>

<itemizedlist>
<listitem>
<para
>Herinneringen met tekstbericht: de berichttekst wordt doorzocht.</para>
</listitem>

<listitem>
<para
>Herinneringen die een bestand tonen: er wordt gezocht in het bestandspad/&URL;.</para>
</listitem>

<listitem>
<para
>Herinneringen met shell-commando's: er wordt gezocht in het commando of het shell-script.</para>
</listitem>

<listitem>
<para
>Herinneringen via e-mail: er wordt gezocht in het onderwerp en de inhoud van de e-mail, maar ook in de ontvanger(s), en de URL's van bijlagen.</para>
</listitem>

<listitem>
<para
>Audioherinneringen: er wordt gezocht in het bestandspad/&URL;.</para>
</listitem>
</itemizedlist>

<note
><para
>Men kan enkel herinneringen die momenteel getoond worden in de herinneringslijst selecteren om in te zoeken. Als u dus eveneens in de verlopen herinneringen wilt zoeken, moet u ze eerst zichtbaar maken (zie hierboven).</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Herinneringen aanmaken en bewerken</title>

<sect2>
<title
>Een nieuwe herinnering aanmaken</title>

<para
>Om een nieuwe herinnering aan te maken, moet u één van volgende stappen doen, en dan het type herinnering selecteren uit de lijst die tevoorschijn komt. Dit toont het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>, waarin u herinneringen kan instellen.</para>

<itemizedlist>
<listitem>
<para
><menuchoice
><guimenu
>Bestand</guimenu
> <guimenuitem
>Nieuw</guimenuitem
></menuchoice
> selecteren.</para>
</listitem>

<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken op het pictogram in het systeemvak en <menuchoice
><guimenuitem
>Nieuwe herinnering</guimenuitem
></menuchoice
> kiezen uit het contextmenu.</para>
</listitem>

<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken in de herinneringslijst, dan <menuchoice
><guimenuitem
>Nieuw</guimenuitem
></menuchoice
> kiezen uit het contextmenu.</para>
</listitem>
</itemizedlist>

<para
>Anders kunt u nieuwe herinneringen aanmaken door gebruik te maken van op voorhand geconfigureerde herinneringen uit verschillende bronnen:</para>

<itemizedlist>
<listitem>
<para
>Volg, om een nieuwe herinnering te baseren op een herinneringssjabloon, de instructies in het deel <link linkend="templates"
>Herinneringssjablonen</link
>.</para>
</listitem>

<listitem>
<para
>Om een nieuwe herinnering te baseren op een reeds bestaande herinnering, markeer de bestaande herinnering in de lijst, en selecteer <menuchoice
> <guimenu
>Bestand</guimenu
><guimenuitem
>Kopiëren</guimenuitem
></menuchoice
>. Dit opent het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>, met de details van de geselecteerde herinnering reeds ingevuld.</para>
</listitem>

<listitem>
<para
>Sleep, om een nieuwe herinnering te creëren die een reeds bestaande e-mail toont, de juiste e-mail vanuit &kmail; naar het hoofdvenster van &kalarm;, of naar het pictogram van &kalarm; in het systeemvak. Dit opent het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> met als herinneringstekst het hele e-mailbericht (inclusief de afzender, de ontvanger, &etc;).</para>
</listitem>

<listitem>
<para
>Sleep, om een nieuwe herinnering te creëren die een kopie verzendt van een reeds bestaand e-mailbericht, de originele e-mail vanuit &kmail; naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Selecteer dan de <guilabel
>E-mail</guilabel
>-optie. Het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> zal dan reeds het hele e-mailbericht bevatten, uitgezonderd de afzender.</para>
</listitem>

<listitem>
<para
>Sleep, om een nieuw herinnering aan te maken die een samenvatting toont van een reeds bestaande taak, de taak vanuit &korganizer; of een andere applicatie naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Dit opent het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen tebewerken</link
> met de taakinhoud als herinneringstekst.</para>
</listitem>

<listitem>
<para
>U kunt eender welk stuk tekst naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak slepen, waarop het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen tebewerken</link
> geopend wordt, met als herinneringstekst dat stuk tekst.</para>
</listitem>

<listitem>
<para
>Sleep, om een herinnering aan te maken die een bestand toont, de &URL; van het tekst- of afbeeldingsbestand naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Dit opent het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> en vult daar de bestandsnaam voor u in.</para>
</listitem>

<listitem>
<para
>Sleep, om een audioherinnering aan te maken, de &URL; van het audiobestand naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Dit open het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> en stelt de bestandsnaam daar voor u in.</para>
</listitem>

<listitem>
<para
>U kunt automatisch herinneringen voor verjaardagen laten aanmaken voor mensen die in het &kaddressbook; staan. Instructies kunt u terugvinden in <link linkend="birthdays"
>Verjaardagen importeren uit &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Een bestaande herinnering aanpassen</title>

<para
>Om een openstaande herinnering aan te passen (verstreken herinneringen kunnen niet aangepast worden), zijn er volgende mogelijkheden:</para>

<itemizedlist>
<listitem>
<para
>Dubbelklikken op de juiste regel in de herinneringslijst.</para>
</listitem>

<listitem>
<para
>De herinnering selecteren door te klikken op de regel in de herinneringslijst. Daarna op <menuchoice
><guimenu
>Bewerken</guimenu
> <guimenuitem
>Bewerken...</guimenuitem
></menuchoice
> klikken.</para>
</listitem>

<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken op de juiste regel in de herinneringslijst en dan op <menuchoice
><guimenuitem
>Bewerken...</guimenuitem
> </menuchoice
> klikken in het contextmenu.</para>
</listitem>
</itemizedlist>

<para
>Dit toont het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>.</para>

</sect2>

<sect2>
<title
>Een herinnering verwijderen/opnieuw activeren</title>

<para
>Om bestaande herinneringen te verwijderen, selecteert u één of meer herinneringen door te klikken op de juiste regels in de herinneringslijst. Dan zijn er volgende mogelijkheden:</para>

<itemizedlist>
<listitem>
<para
>Op <menuchoice
> <guimenu
>Bewerken</guimenu
><guimenuitem
>Verwijderen</guimenuitem
> </menuchoice
> klikken.</para>
</listitem>
<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken op de geselecteerde rijen en op <menuchoice
><guimenuitem
>Verwijderen</guimenuitem
></menuchoice
> klikken in het contextmenu.</para>
</listitem>
<listitem>
<para
>&Shift;-<keycap
>Delete</keycap
> indrukken om ze te verwijderen zonder bevestiging.</para>
</listitem>
</itemizedlist>

<para
>Als u een actieve herinnering verwijdert, wordt deze gearchiveerd als dezereeds ten minste één maal uitgevoerd is geweest voor het verwijderen, en als ingesteld is dat verlopen alarmen gearchiveerd moeten worden. (Gebruik het<link linkend="preferences-storage"
>Configuratievenster</link
> om in te stellen of, en hoe lang gearchiveerde herinneringen bijgehouden moeten worden.) Als u een gearchiveerde of een nog niet uitgevoerde openstaande herinnering verwijderd, wordt deze permanent verwijderd.</para>

<para
>Als de herinnering nog niet verlopen is, kunt u een gearchiveerde herinnering in de herinneringslijst terug activeren. Om dit te bereiken, moet u eerst de gearchiveerde herinneringen zichtbaar maken, zoals beschreven in<link linkend="expired"
>Gearchiveerde herinneringen</link
>. Dan:</para>

<itemizedlist>
<listitem>
<para
>Selecteer een of meer gewenste gearchiveerde herinneringen uit de herinneringslijst door erop te klikken. Kies daarna <menuchoice
> <guimenu
>Acties</guimenu
><guimenuitem
>Reactiveren</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken op de gewenste regels in de lijst met verlopen herinneringen en op <menuchoice
><guimenuitem
>Reactiveren</guimenuitem
></menuchoice
> klikken in het contextmenu.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Een herinnering in- of uitschakelen</title>

<para
>Zie <link linkend="enable-disable"
>Herinneringen in- of uitschakelen</link
>om te weten te komen hoe herinneringen in- of uitgeschakeld moeten worden, zowel totaal als individueel.</para>

</sect2>

<sect2>
<title
>Een herinnering instellen om te ontwaken na onderbreken</title>

<para
>Zie <link linkend="wake-suspend"
>Ontwaken uit onderbreken</link
> voor hoe een herinnering in te stellen om uw systeem uit onderbreken of slaapstand te laten ontwaken.</para>

</sect2>

<sect2>
<title
>Een herinnering bevestigen</title>

<para
>Zie <link linkend="message-window"
>Berichtvenster voor herinneringen</link
> om te weten te komen hoe een alarm bevestigd moet worden.</para>

</sect2>

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

<para
>Als u regelmatig gelijkaardige herinneringen wilt instellen, kunt u een herinneringssjabloon creëren om te vermijden dat u elke keer alle details opnieuw moet intypen. Een sjabloon kan alle mogelijke details voor een herinnering bevatten, behalve de aanvangsdatum.</para>

<para
>Bijvoorbeeld: u wilt regelmatig herinnerd worden aan een televisieprogramma waarvan de tijd van week tot week varieert. Het sjabloon kan dan alle herinneringsdetails bevatten (berichttekst, of er een geluid afgespeeld moet worden, &etc;) uitgezonderd datum en tijd. Als u dan nu zo'n herinnering wilt aanmaken, opent u gewoon het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen tebewerken</link
> met het sjabloon, en vult u de datum en de tijd in.</para>

<para
>Om een herinnering te creëren die gebaseerd is op een sjabloon, opent u het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>, met de sjabloondetails reeds ingesteld.</para>

<itemizedlist>
<listitem>
<para
>In het menu het item <menuchoice
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Nieuw van sjabloon</guimenuitem
> </menuchoice
> selecteren, en dan het gewenste sjabloon selecteren.</para>
</listitem>

<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken op het pictogram in het systeemvak en<menuchoice
><guimenuitem
>Nieuwe herinnering van sjabloon</guimenuitem
> </menuchoice
> selecteren in het contextmenu. Dan het gewenste sjabloon selecteren.</para>
</listitem>

<listitem>
<para
>Het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> openen op de gewone manier, en op de knop <guibutton
>Sjabloon laden...</guibutton
> klikken om een sjabloon te selecteren zodat de herinnering de gewenste gegevens bevat.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Sjablonen instellen</title>

<para
>U kunt sjablonen creëren, aanpassen of verwijderen met behulp van het dialoogvenster Herinneringssjablonen, of u kunt een nieuw herinneringssjabloon aanmaken op basis van een reeds bestaande herinnering.</para>

<para
>Om een nieuw herinneringssjabloon te maken, zijn er volgende mogelijkheden:</para>

<itemizedlist>
<listitem>
<para
>Het dialoogvenster voor herinneringssjablonen wordt getoond door in het menu <menuchoice
><guimenu
>Bestand</guimenu
> <guimenuitem
>Sjablonen...</guimenuitem
> </menuchoice
> aan te klikken; daarna klikt u op <guibutton
>Nieuw</guibutton
> en kiest u het herinneringstype uit de getoonde lijst. Hiermee opent u een dialoogvenster met een leeg sjabloon dat u kunt invullen.</para>
</listitem>

<listitem>
<para
>Het dialoogvenster voor herinneringssjablonen laten tonen door in het menu <menuchoice
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Sjablonen...</guimenuitem
> </menuchoice
> aan te klikken; daarna selecteert u een reeds bestaand sjabloon uit de lijst, en klikt u op <guibutton
>Kopiëren</guibutton
>. Hierdoor wordt het dialoogvenster om herinneringssjablonen te bewerken geopend, ingevuld met de gegevens van het reeds bestaande sjabloon.</para>
</listitem>

<listitem>
<para
>Een herinnering aanduiden in de herinneringslijst en <menuchoice
> <guimenu
>Bestand</guimenu
><guimenuitem
>Nieuw sjabloon maken...</guimenuitem
></menuchoice
> selecteren. Hierdoor wordt het dialoogvenster om herinneringssjablonen te bewerken geopend, met een kopie van de gegevens van de geselecteerde herinnering.</para>
</listitem>
</itemizedlist>

<para
>Om een reeds bestaand sjabloon te bewerken, opent u het dialoogvenster herinneringssjablonen door het item <menuchoice
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Sjablonen...</guimenuitem
> </menuchoice
>  in het menu te selecteren, en dan op de knop <guibutton
>Bewerken</guibutton
> te klikken. Hierdoor wordt het dialoogvenster om herinneringsjablonen te bewerken getoond, zoals hieronder beschreven.</para>

<para
>Om bestaande sjablonen te verwijderen, opent u het dialoogvenster herinneringssjablonen door op <menuchoice
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Sjablonen...</guimenuitem
> </menuchoice
> te klikken, dan een of meerdere sjablo(o)n(en) te selecteren en op <guibutton
>Verwijderen</guibutton
> te klikken. Er wordt steeds een bevestiging gevraagd om te voorkomen dat sjablonen per ongeluk verwijderd worden.</para>

</sect3>

<sect3>
<title
>Dialoogvenster om sjablonen te bewerken</title>

<para
>Het dialoogvenster om sjablonen te bewerken is gelijkaardig aan het <link linkend="alarm-edit-dlg"
>Het dialoogvenster om alarmen te bewerken</link
>. De volgende punten zijn anders:</para>

<itemizedlist>
<listitem>
<para
>De naam van de sjabloon invoeren in <guilabel
>Naam sjabloon</guilabel
>. Deze naam wordt getoond in lijsten waar u sjablonen moet selecteren, dus u kunt best een naam kiezen die u herinnert aan de functie van de sjabloon. Elke sjabloonnaam moet uniek zijn.</para>
</listitem>

<listitem>
<para
>In het kader <guilabel
>Tijd</guilabel
> moet u een van volgende mogelijkheden selecteren:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Standaard tijd</guilabel
> als u geen uitvoertijd wilt specificeren.Herinneringen die dan op dit sjabloon gebaseerd worden, zullen in het begin de standaard uitvoertijd gebruiken, die ook bij nieuwe herinneringen gebruikt wordt.</para>
</listitem>

<listitem>
<para
><guilabel
>Tijd</guilabel
> selecteren om een tijd in te voeren waarop de herinnering uitgevoerd moet worden.</para>
</listitem>

<listitem>
<para
><guilabel
>Alleen datum</guilabel
> selecteren om aan te geven dat de herinnering enkel een datum zal bevatten, en geen tijd.</para>
</listitem>

<listitem>
<para
><guilabel
>Tijdsduur vanaf nu</guilabel
> om in te voeren hoe lang (in uren en minuten) het duurt, vanaf het moment dat een herinnering gecreëerd is, voordat deze uitgevoerd wordt.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>In het vak <guilabel
>Herhalingsregel</guilabel
> in de tab <guilabel
>Herhaling</guilabel
> moet er geen dag of maand gekozen worden voor respectievelijk wekelijkse of jaarlijkse herhalingen.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Agenda's met herinneringen</title>

<para
>Als u maar één computer gebruikt, en onafhankelijk werkt, maakt het waarschijnlijk niet uit waar de herinneringen van &kalarm; opgeslagen worden. Maar als u de herinneringen vanaf meer dan één computer moet kunnen bereiken, of op meerdere locaties op uw lokale computer, kunt u <quote
>agenda's met herinneringen</quote
> instellen om &kalarm; duidelijk te maken dat er andere agenda's met herinneringen gebruikt moeten worden in plaats van, of als toevoeging aan de standaardagenda's.</para>

<para
>U kunt agenda's bekijken en veranderen via de agendalijst, welke getoond kan worden naast de herinneringslijst in &kalarm;s hoofdvenster. Herinneringen van andere herinneringsagenda's worden samen getoond in de herinneringslijst. Als u een nieuwe herinnering opslaat, kunt u een optie instellen om te kiezen of de nieuwe herinnering opgeslagen moet worden in de standaard agenda, of dat er gevraagd moet worden in welke agenda deze nieuwe herinnering opgeslagen moet worden. Als u een reeds bestaande herinnering bewerkt, wordt deze automatisch terug opgeslagen in de agenda waar de oorspronkelijke herinnering vandaan kwam.</para>

<screenshot>
<screeninfo
>Schermafbeelding van het hoofdvenster van &kalarm;, waarin de agendalijst getoond wordt</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Hoofdvenster waarin de agendalijst getoond wordt</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Typen agenda's en opties</title>

<para
>Herinneringsagenda's wordt ingedeeld op basis van herinneringstype en opslagtype. Ze kunnen uitgeschakeld worden, als alleen-lezen ingesteld worden, of als standaardagenda ingesteld worden voor een bepaald herinneringstype.</para>

<variablelist>
<varlistentry>
<term
>Type herinnering</term>
<listitem>
<para
>De drie typen herinneringen &ndash; actieve herinneringen, verlopen herinneringen en herinneringssjablonen &ndash; worden opgeslagen in aparteherinneringsagenda's. Daarom heeft &kalarm; standaard drie aparte agenda's, één voor elk type (zie het deel <link linkend="faq"
>Vragen en Antwoorden</link
> voor meer details), welke u kunt veranderen indien u datwenst.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Type opslag</term>
<listitem>
<para
>&kalarm; kent 3 manieren om herinneringsagenda's op te slaan:</para>

<itemizedlist>
<listitem
><para
>Lokaal bestand: Herinneringen worden opgeslagen in een enkel, lokaal bestand in het iCalendar-formaat. Standaard slaat &kalarm; zijn agenda's op in een lokaal bestand (zie <link linkend="faq"
>Vragen en Antwoorden</link
> voor meer details). <quote
>Lokale bestanden</quote
> kunnen gewoon op de lokale computer staan, maar ook op het lokale netwerk opgeslagen worden, zolang hun locatie maar voorgesteld kan worden als een pad beginnend met <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Lokale map: hierbij worden herinneringen opgeslagen in een lokale map, waarbij elke herinnering in die map opgeslagen wordt als een apart iCalendar-bestand. Het voordeel hiervan is dat bij een corrupt bestand, er maar één herinnering beschadigd wordt, en niet de hele agenda.</para>
</listitem>

<listitem
><para
>Extern bestand: herinneringen worden in een enkel extern bestand opgeslagen, in het iCalendar-formaat. Hierdoor kunt u altijd toegang op afstand  toegang krijgen naar uw herinneringen, zonder dat het uitmaakt waar u zich bevindt. Dit geeft ook de mogelijkheid om andere mensen toegang te verlenen tot die herinneringen. Wanneer u externe bestanden gebruikt, werkt &kalarm; met een lokale cache van de data.</para>

<warning
><para
>Als een externe herinneringsagenda gedeeld wordt door meerdere gebruikers, kan het voorkomen dat veranderingen die gemaakt worden door één persoon niet automatisch beschikbaar zijn voor andere personen, of dat er een vertraging is voordat andere gebruikers ze zien. Het kan dus gebeuren dat een gebruiker een verandering maakt, welke daarna overschreven wordt door een andere gebruiker, zonder dat één van de gebruikers opmerkt wat er gebeurd is. De technische uitleg hiervoor: een verandering gemaakt door persoon A zal niet beschikbaar zijn voor persoon B totdat de kopie in cache bij persoon A extern opgeslagen wordt, en de kopie in cache bij persoon B bijgewerkt is met de gegevens in het externe bestand. Of en wanneer een lokale kopie bijgewerkt of extern opgeslagen wordt, hangt af van de configuratieparameters van de agenda, welke apart ingesteld worden door elke gebruiker.</para>

<para
>Om dit te vermijden, kunt u de configuratieparameters om agenda's extern op te slaan of bij te werken, aanpassen. Een andere mogelijkheid is dat er afspraken gemaakt worden met andere personen die niet de eigenaar van de agenda zijn, bijvoorbeeld dat zij die afsprakenagenda alleen openen in de modus alleen-lezen.</para
></warning>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Status in- of uitgeschakeld</term>
<listitem>
<para
>Een agenda uitschakelen heeft hetzelfde effect als deze te verwijderen, behalve dat deze blijft staan in de agendalijst, zodat het gemakkelijk is om deze terug te activeren. Als een agenda uitgeschakeld is, worden alle herinneringen in de agenda genegeerd, en verschijnen ze dus ook niet in de herinneringslijst of de lijst met sjablonen. Als een agenda terug ingeschakeld wordt, worden de erin aanwezige herinneringen één keer terug getoond, en, als het een actieve herinneringsagenda is, terug actief gemaakt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Status alleen-lezen</term>
<listitem>
<para
>Herinneringen kunnen niet toegevoegd worden aan, of bewerkt worden in een alleen-lezen agenda. U kunt de erin aanwezig herinneringen dus niet bewerken, en er ook geen nieuwe herinneringen in opslaan. Het is eveneens niet mogelijk om herinneringen uit te stellen, aangezien de uitsteltijd dan opgeslagen moet worden in de herinnering. Als er een alarm uitgevoerd is, wordt deze niet verwijderd uit de agenda en gearchiveerd, totdat uzelf of een andere gebruiker de agenda opent in de modus lezen/schrijven.</para>

<para
>U kunt de status alleen-lezen instellen in het dialoogvenster om agenda's te configureren. Toch kunnen sommige agenda's niet beschrijfbaar gemaakt worden wegens volgende redenen:</para>

<itemizedlist>
<listitem
><para
>Als een agenda gecreëerd werd door een andere applicatie, is het niet veilig om &kalarm; toe te staan de agenda bij te werken, omdat verschillen in het formaat ervoor kunnen zorgen dat de agenda onbruikbaar wordt voor de applicatie die deze oorspronkelijk gecreëerd heeft.</para>
</listitem>

<listitem
><para
>Als de agenda gecreëerd werd door een recentere versie van &kalarm; kunnen er gegevens verloren gaan als uw versie van &kalarm; de agenda bijwerkt.</para>
</listitem>

<listitem
><para
>Als de agenda gecreëerd werd door een oudere versie van &kalarm;, kunnen er gegevens verloren gaan, of zelfs onbruikbaar worden voor de oudere versie van &kalarm; wanneer uw versie van &kalarm; de agenda bijwerkt. Er zal u gevraagd worden of het formaat omgezet moet worden om het beschrijfbaar te maken, maar houdt daarbij in gedachte dat er mogelijk compatibiliteitsproblemen ontstaan als een oudere versie van &kalarm; de gegevens terug wilt benaderen.</para>
</listitem>

<listitem
><para
>Als u geen toelating hebt om te schrijven naar het bestand of de map met de agenda.</para>
</listitem>
</itemizedlist>

<para
>Als u schrijftoegang nodig hebt naar de herinneringen in een agendabestand dat niet beschrijfbaar is, dan kunt u de herinneringen kopiëren door ze te importeren in een beschrijfbaar agendabestand met de volgende contextmenuoptie <menuchoice
><guimenuitem
>Importeren...</guimenuitem
></menuchoice
> van de agenda (zie <link linkend="import"
>Herinneringen importeren uit externe agaenda's</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Standaard agendastatus</term>
<listitem>
<para
>Eén agenda per herinneringstype kan eventueel als standaardagenda voor dat herinneringstype gebruikt worden. Nieuwe herinneringen worden automatisch opgeslagen in de standaardagenda van dat herinneringstype, behalve wanneer u ervoor gekozen hebt een keuzevenster te laten zien voor nieuwe herinneringen en sjablonen in de <link linkend="preferences-storage"
>instellingendialoog</link
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3>
<title
>Agenda's gebruiken</title>

<para
>U kunt agenda's bekijken en aanpassen m.b.v. de agendalijst, welke getoond of verborgen kan worden door <menuchoice
> <guimenu
>Beeld</guimenu
> <guimenuitem
>Agenda's tonen</guimenuitem
> </menuchoice
>. Wanneer u de agendalijst gebruikt, moet u eerst het herinneringstype selecteren m.b.v. het afrolmenu bovenaan de lijst. Daarna kunt u ofwel op één van de knoppen onderaan de lijst klikken, ofwel <mousebutton
>rechts</mousebutton
> klikken op de juiste agenda in de lijst, en een item selecteren uit het contextmenu. De beschikbare acties zijn:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Toevoegen...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Een agenda van het geselecteerde type toevoegen aan de lijst. Er wordt u gevraagd een opslagmethode te kiezen, waarna de instellingendialoog van een agenda wordt getoond, waarin u de lokatie van het agendabestand en zijn karakteristieken kunt invoeren. Als er geen bestaande agenda voor herinneringen is, dan wordt er een aangemaakt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Verwijderen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>De geselecteerde agenda uit de lijst verwijderen. Het agendabestand zelf wordt intact gelaten; ze wordt enkel uit de lijstweergave verwijderd en kan dus later eventueel teruggeplaatst worden in de lijst.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Bewerken...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>De geselecteerde agenda bewerken. Dit toont de instellingendialoog voor de geselecteerde agenda.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Herladen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>De geselecteerde agenda herladen. De agenda wordt opnieuw ingelezen vanuit de opslaglocatie, zodat er verzekerd wordt dat er geen verschillen zijn tussen wat &kalarm; toont, en wat er momenteel reëel in de agenda staat. Als de agenda gedeeld wordt door meerdere gebruikers, zullen alle veranderingen die ze hebben doorgevoerd, nu eveneens getoond worden door &kalarm;.</para>

<warning
><para
>Als u een agenda op afstand herlaadt, zullen al uw wijzigingen sinds de agenda de laatste keer werd opgeslagen verloren gaan. Ook is het mogelijk dat herinneringen die verlopen zijn sinds de laatste opslag, opnieuw uitgevoerd worden.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Opslaan</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Alle veranderingen aan de geselecteerde agenda opslaan. De agenda wordt dan bijgewerkt met alle veranderingen in de herinneringen sinds de laatste keer dat de agenda opgeslagen of herladen werd. Dit is enkel nodig voor agenda's op afstand, omdat lokale agenda's direct automatisch opgeslagen worden na elke verandering. U kunt instellen wanneer en hoe vaak een agenda op afstand automatisch opgeslagen moet worden, door gebruik te maken van de instellingendialoog (met de optie <menuchoice
> <guimenuitem
>Bewerken...</guimenuitem
></menuchoice
> in het contextmenu).</para>

<warning
><para
>Als u een agenda op afstand, die gedeeld wordt met andere gebruikers, opslaat, gaan alle veranderingen die de anderen gemaakt hebben sinds u de laatste keer de agenda herlaadde (automatisch of handmatig) verloren.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importeren...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Herinneringen importeren uit een extern agendabestand in de geselecteerde agenda. Dit wordt verder uitgelegd in <link linkend="import"
>Importeren van herinneringen uit externe agenda's</link
>. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde of alleen-lezen agenda's.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Exporteren...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Alle herinneringen in de geselecteerde agenda exporteren naar een extern agendabestand. Dit wordt verder uitgelegd in <link linkend="export"
>Exporteren van herinneringen naar externe agenda's.</link
>. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde agenda's.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Details tonen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Details tonen van de geselecteerde agenda. Dit toont de locatie van de agenda, het opslagtype en statusinformatie.  </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Als standaard gebruiken</guimenuitem
></menuchoice
></term>
<listitem>
<para
>De geselecteerde agenda als standaard instellen voor het geselecteerde agendatype. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde of alleen-lezen agenda's.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Kleur instellen...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Een achtergrondkleur selecteren voor het markeren van de herinneringen uit deze agenda in de lijst met herinneringen. Op deze manier ziet u direct bij welke agenda bepaalde herinneringen behoren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Kleur weghalen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Met kleur accentueren voor de herinneringen in deze agenda in herinneringenlijst wissen.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Importeren van herinneringen uit externe agenda's</title>

<para
>U kunt herinneringen uit andere agendabestanden importeren in &kalarm;. Het importeren scant het geselecteerde agendabestand naar gebeurtenissen die herinneringen bevatten, en kopieert hen (met nieuwe unieke ID's) naar de agenda van &kalarm;. Gebeurtenissen zonder herinneringen, en agenda-items die geen gebeurtenissen zijn, worden genegeerd. U kunt herinneringen op twee manieren importeren:</para>

<itemizedlist>
<listitem>
<para
>Gebruik <menuchoice
><guimenu
>Bestand</guimenu
> <guimenuitem
>Herinneringen importeren...</guimenuitem
></menuchoice
> om herinneringen van alle types (actieve herinneringen, verlopen herinneringen en herinneringssjablonen) te importeren uit de agenda.</para>

<para
>Als u <link linkend="calendars"
>herinneringsagenda's</link
> geconfigureerd hebt, zullen herinneringen van elk type toegevoegd worden aan de juiste standaardagenda of als u ervoor gekozen hebt een keuzevenster te laten zien voor nieuwe herinneringen en sjablonen in de <link linkend="preferences-storage"
>instellingendialoog</link
>, zal u gevraagd worden welke agenda gebruikt moet worden.</para>
</listitem>

<listitem>
<para
><mousebutton
>Rechts</mousebutton
> klikken op een agenda in de agendalijst en <menuchoice
><guimenuitem
>Importeren...</guimenuitem
></menuchoice
> aanklikken in het contextmenu. Dit zal de herinneringen van het geselecteerde type importeren in die agenda. Als er bijvoorbeeld als agendatype herinneringssjablonen gekozen is, zullen de herinneringssjablonen (en niet de actieve of verlopen herinneringen) geïmporteerd worden.</para>
</listitem>
</itemizedlist>

<warning
><para
>Als u herinneringen importeert uit agendabestanden die aangemaakt werden door andere applicaties dan &kalarm;, kan het gebeuren dat herinneringen veranderd worden door het proces &ndash; zelfs herinneringstijden zouden kunnen veranderen. Dit hangt af van de afspraken over gegevensopslag in de andere toepassing en is dus onvermijdbaar als deze afspraken verschillen van die van &kalarm;. Controleer dus altijd de geïmporteerde herinneringen voor onverwachte veranderingen en pas ze eventueel aan.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Exporteren van herinneringen naar externe agenda's</title>

<para
>U kunt in &kalarm; ofwel de huidig geselecteerde herinneringen in de herinneringslijst, ofwel alle herinneringen van een herinneringsagenda exporteren naar andere agendabestanden. De verschillende methodes om dit te doen worden hieronder gegeven. Bij eender welke methode, kunt u ervoor kiezen om een nieuw agendabestand te laten maken of de geëxporteerde herinneringen toe te voegen aan een reeds bestaand agendabestand. Om herinneringen toe te voegen, vinkt u <guilabel
>Achter bestaand bestand voegen</guilabel
> aan in het dialoogvenster om bestanden te selecteren. Anders wordt een eventueel reeds bestaand bestand overschreven.</para>

<itemizedlist>
<listitem>
<para
>Om de huidig geselecteerde herinneringen in de herinneringslijst te exporteren, klikt u <mousebutton
>rechts</mousebutton
> op de selectie, en kiest u <menuchoice
><guimenuitem
>Exporteren...</guimenuitem
></menuchoice
> uit het contextmenu of gebruikt u <menuchoice
><guimenu
>Bestand</guimenu
> <guimenuitem
>Geselecteerde herinneringen exporteren...</guimenuitem
> </menuchoice
> in het hoofdmenu.</para>
</listitem>

<listitem>
<para
>Om alle herinneringen uit een agenda te exporteren, klikt u <mousebutton
>rechts</mousebutton
> op een agenda in de agendalijst en kiest u <menuchoice
> <guimenuitem
>Exporteren...</guimenuitem
></menuchoice
> uit het contextmenu.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Importeren van verjaardagen uit &kaddressbook; </title>

<para
>U kunt zichtbare herinneringen instellen voor verjaardagen die opgeslagen zijn in &kaddressbook; door <menuchoice
><guimenu
>Bestand</guimenu
> <guimenuitem
>Verjaardagen importeren...</guimenuitem
></menuchoice
> aan te klikken. Dit toont een dialoogvenster waar u de verjaardagen kunt selecteren waarvoor een alarm aangemaakt moet worden.</para>

<itemizedlist>
<listitem>
<para
>In het vak <guilabel
>Tekst herinnering</guilabel
>, kunt u de tekst instellen die getoond moet worden in de herinneringsberichten van de verjaardag. De berichttekst wordt samengesteld door het <guilabel
>voorvoegsel</guilabel
>, dan de naam van de persoon, en dan het <guilabel
>achtervoegsel</guilabel
> samen te voegen. Spaties worden niet automatisch toegevoegd, dus zorg ervoor dat er achteraan in het <guilabel
>voorvoegsel</guilabel
> en vooraan in het <guilabel
>achtervoegsel</guilabel
> een spatie staat.</para>

<note
><para
>Als u de herinneringstekst wijzigt, zal de selectielijst van verjaardagen opnieuw gecontroleerd worden.</para
></note>
</listitem>

<listitem>
<para
>In de lijst <guilabel
>Verjaardagen selecteren</guilabel
>, selecteert u de verjaardagen waarvoor u herinneringen aan wilt maken. Merk op dat de lijst alleen de items in &kaddressbook; toont die een verjaardag bevatten en die niet al een verjaardagherinnering bevatten in het formaat zoals dat nu is gedefinieerd in het groepsvak <guilabel
>Herinneringstekst</guilabel
>.</para>
</listitem>

<listitem>
<para
>De overige functies werken juist hetzelfde als bij de <guilabel
>Tekst</guilabel
>herinneringen in het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
>.</para>
</listitem>
</itemizedlist>

<para
>Als u <link linkend="calendars"
>herinnneringsagenda's</link
> hebt ingesteld, zullen de herinneringen toegevoegd worden aan de standaardagenda met de actieve herinneirngen, of als u in de <link linkend="preferences-storage"
>instellingendialoog</link
> geselecteerd hebt dat er gevraagd moet worden in welke agenda nieuwe herinneringen en sjablonen toegevoegd moeten worden, zal u gevraagd worden welke agenda u wilt gebruiken.gmen ucu  agend</para>

</sect2>

<sect2 id="undo">
<title
>Ongedaan maken/opnieuw</title>

<para
>U kunt de meest recente veranderingen in de huidige sessie van &kalarm; ongedaan maken of opnieuw uitvoeren. De meeste acties kunnen ongedaan gemaakt worden, zoals het aanmaken, bewerken en verwijderen van herinneringen en herinneringssjablonen, en het opnieuw activeren van herinneringen. Om ervoor te zorgen dat het systeem niet te veel belast wordt door de geschiedenis van acties, is het aantal van de veranderingen die bijgehouden worden beperkt tot de laatste 12 acties.</para>

<para
>Om de laatste verandering ongedaan te maken, selecteert u <menuchoice
> <guimenu
>Bewerken</guimenu
><guimenuitem
>Ongedaan maken</guimenuitem
> </menuchoice
>. Om de laatste ongedane actie opnieuw uit te voeren, selecteert u <menuchoice
> <guimenu
>Bewerken</guimenu
><guimenuitem
>Opnieuw</guimenuitem
> </menuchoice
>.</para>

<para
>Als u een andere actie dan de laatste ongedaan wilt maken, klikt u op <guibutton
>Ongedaan maken</guibutton
> en houdt u de muisknop ingedrukt. Er zal dan een lijst met acties getoond worden, waaruit u er een kunt kiezen. Als u niet direct de actie ziet waarnaar u aan het zoeken bent, kan het zijn dat u meer recente veranderingen eerst ongedaan moet maken, omdat de gewenste actie daar van afhangt. Als u bijvoorbeeld eerst een herinnering bewerkt en daarna verwijderd hebt, kunt u de bewerking niet ongedaan maken voordat u eerst de verwijdering ongedaan hebt gemaakt. </para>

<para
>Een andere verandering dan de laatste opnieuw uitvoeren werkt op een gelijkaardige manier met de knop <guibutton
>Opnieuw</guibutton
> in de werkbalk.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>Het venster voor bewerken van herinneringen</title>

<para
>In het venster voor bewerken van herinneringen kunt u een herinnering bekijken en bewerken. Als u &kalarm; voor de eerste keer gebruikt, wordt er een eenvoudigere vorm van het dialoogvenster getoond, met maar enkele zichtbare opties. Om alle mogelijkheden te zien, klikt u op de knop <guibutton
>Meer opties</guibutton
>; om terug te keren naar de versimpelde vorm, klikt u op de knop <guibutton
>Minder opties</guibutton
>. Het venster voor bewerken van herinneringen zal later op dezelfde manier getoond worden, aangezien &kalarm; onthoudt wat uw laatste keuze was.</para>

<para
>U kunt de standaard waarden van vele instellingen in de dialoog "Herinnering bewerken" met het <link linkend="preferences-edit"
>tabblad Bewerken van instellingen</link
>.</para>

<screenshot>
<screeninfo
>Schermafbeelding van de eenvoudige versie van het bewerkingsvenster voor afspraken</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Eenvoudige versie van het bewerkingsvenster voor getoonde afspraken</phrase>
</textobject>
<caption
><para
>Eenvoudige versie van het bewerkingsvenster voor getoonde afspraken</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Schermafbeelding van het bewerkingsvenster voor afspraken waar alle opties getoond worden</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Het bewerkingsvenster voor getoonde afspraken waar alle opties getoond worden</phrase>
</textobject>
<caption
><para
>Het bewerkingsvenster voor getoonde afspraken waar alle opties getoond worden</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Herinneringsactie</title>

<para
>De besturing in het groepsvak <guilabel
>Actie</guilabel
> hangt af van het type herinnering dat wordt bewerkt.</para>

<sect3>
<title
>Herinneringen tonen</title>

<para
>Herinneringen tonen toont een venster wanneer de herinnering afloopt. Selecteer de methode, die gebruikt wordt om het herinneringsvenster te genereren, met het keuzevak bovenaan:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Tekstbericht</guilabel
> om de tekst van een herinneringsbericht in te voeren (die nieuwe-regels mag bevatten) in het tekstvak.</para>
</listitem>

<listitem>
<para
><guilabel
>Inhoud van bestand</guilabel
> om het pad of &URL; van een tekst- of afbeeldingsbestand waarvan de inhoud getoond moet worden in het herinneringsbericht. Gebruik de knop maast het tekstvak om een bestandskeuzedialoog te tonen. De optie <guilabel
>Spreken</guilabel
> is niet beschikbaar voor dit type herinnering.</para>
</listitem>

<listitem>
<para
><guilabel
>Commando-uitvoer</guilabel
> om te specificeren dat de tekst van het herinneringsbericht moet worden gegenereerd door een commando dat wordt uitgevoerd wanneer de herinnering afgaat. Zie <link linkend="command-alarm"
>Herinneringen met shell-commando</link
> onderstaand voor details van hoe het uit voeren commando of script in te voeren.</para>
</listitem>
</itemizedlist>

<para
>Het aansturen van het hoe een herinnering te tonen is:</para>

<itemizedlist>
<listitem>
<para
>De optie <guilabel
>Geluid</guilabel
> Laat u kiezen of een hoorbare herinnering moet klinken wanneer het herinneringsbericht wordt getoond. Kies:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Geen</guilabel
> om de herinnering zonder geluid te tonen.</para>
</listitem>

<listitem>
<para
><guilabel
>Piep</guilabel
> om pieptoon te laten klinken.</para>
</listitem>

<listitem>
<para
><guilabel
>Spreken</guilabel
> om het herinneringsbericht uit te laten spreken naast het tonen. Deze optie is alleen beschikbaar als u &jovie; (uit het kdeaccessibility-pakket) hebt geïnstalleerd en ingesteld, samen met een compatibele spraaksynthesizer, &eg; <application
>Festival</application
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Geluidsbestand</guilabel
> om een audiobestand af te spelen. Gebruik de knop rechts om de dialoog Geluidsbestand weer te geven, die u een af te spelen bestand laat selecteren en het volume en herhalingsopties laat zetten. Als u met de muis over de selector gaat, zal er een tekstballon met het nu geselecteerde geluidsbestand worden getoond.</para>

<para
>In de dialoog Geluidsbestand:</para>

<itemizedlist>
<listitem>
<para
>Voer het pad van het geluidsbestand in of gebruik de knop naast het bewerkingsvenster om een bestandsselectiedialoog te tonen. U kunt naar het geselecteerde bestand luisteren door op de speelknop links van het bewerkingsvenster te klikken. Die knop wijzigt daarna van functie om u in staat te stellen het afspelen te stoppen wanneer u genoeg hebt gehoord.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Herhalen</guilabel
> on voortdurend het geluidsbestand te herhalen voor zolang als de herinnering wordt getoond. (Het venster met het herinneringsbericht bevat een knop om het afspelen van het geluid te stoppen als u stilte wilt maar het tonen van de herinnering nog steeds wilt.)</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Volume</guilabel
> en pas de schuif aan als u het volume van het geluidsbestand dat afgespeeld moet worden wilt aanpassen.</para>
</listitem>

<listitem>
<para
>Als u wilt kunt u het volume laten vervagen. Vervagen betekent beginnen met afspelen van het audiobestand op het ene volume en het langzaam laten veranderen naar het uiteindelijke volume, in een gespecificeerd tijdinterval. Het eindvolume is wat is ingevoerd in <guilabel
>Volume</guilabel
> hierboven. Om vervagen in te schakelen, activeer <guilabel
>Vervagen</guilabel
> en voer het tijdinterval in seconden in in het veld <guilabel
>Vervagingstijd</guilabel
> en stel de schuif van het <guilabel
>Initiële volume</guilabel
> in.</para>
</listitem>
</itemizedlist>

<tip
><para
>U kunt de knop <guibutton
>Proberen</guibutton
> om het geselecteerde geluidsniveau te testen.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Gebruik de knop <guibutton
>Lettertype &amp; kleur...</guibutton
> om een lettertype, een voor- en achtergrondkleur voor het herinneringsbericht te selecteren. In de dialoog <guilabel
>Lettertype &amp; kleur van herinnering kiezen</guilabel
>, activeer <guilabel
>Standaard lettertype gebruiken</guilabel
> om het bericht weer te geven in het lettertype dat als standaard is geconfigureerd op het moment dat het bericht wordt getoond. Om een specifiek lettertype voor het bericht te kiezen, deactiveer <guilabel
>Standaard lettertype gebruiken</guilabel
>. (Het standaard lettertype en de kleuren kunnen worden ingesteld in de <link linkend="preferences-edit"
>Instellingendialoog</link
>.)</para>

<para
>De geselecteerde kleuren worden getoond in het tekstinvoerveld in het herinneringsbericht.</para>
</listitem>

<listitem>
<para
>Gebruik de knop <guibutton
>Speciale acties...</guibutton
> om shell-commando's uit te voeren voor of na het tonen van de herinnering. In de dialoog <guilabel
>Speciale herinneringsacties</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>In het veld <guilabel
>Actie voorafgaand aan herinnering</guilabel
> voert u een shell-commando in dat uitgevoerd moet worden voor de herinnering getoond wordt. Merk op dat &kalarm; zal wachten totdat het commando is beëindigd voordat de herinnering getoond wordt.</para>

<para
>Een actie voorafgaand aan herinnering wordt alleen uitgevoerd alleen wordt uitgevoerd wanneer de herinnering initieel wordt getoond, inclusief wanneer een herinneringsbericht wordt vervangen door het actuele bericht. Het wordt <emphasis
>niet</emphasis
> uitgevoerd in elk van de volgende omstandigheden:</para>

<itemizedlist>
<listitem
><para
>Wanneer een herinneringsbericht getoond wordt.</para
></listitem>
<listitem
><para
>Wanneer het bericht opnieuw wordt getoond na uitstel van de herinnering.</para
></listitem>
<listitem
><para
>Wanneer het bericht werd getoond op het moment dat u zich afmeldde en dan wordt hersteld wanneer u zich weer aanmeldt.</para
></listitem>
<listitem
><para
>Wanneer een terugkerende herinnering afgaat maar het herinneringsbericht (of een uitgesteld herinneringsbericht) van een vorige gebeurtenis van de herinnering nog steeds zichtbaar is; met andere woorden, wanneer de vorige gebeurtenis van de herinnering nog niet als gezien is gemeld.</para
></listitem>
</itemizedlist>

<para
>De actie voorafgaand aan herinnering kan worden gebruikt om te besturen of het herinneringsbericht wordt getoond:</para>

<itemizedlist>
<listitem
><para
>Activeer <guilabel
>Bij fout herinnering annuleren</guilabel
> om de herinnering te annuleren als de actie voorafgaand aan de herinnering een foutstatus terug geeft. Dit zal voorkomen dat het herinneringsbericht getoond wordt en een actie na een herinnering wordt uitgevoerd.</para
></listitem>

<listitem
><para
>Normaal, als het commando voorafgaand aan een herinnering een fout teruggeeft, zal er een foutbericht worden getoond en een foutindicatie worden getoond in de lijst met herinneringen. Deze foutmeldingen kunnen voorkomen worden door <guilabel
>Fouten niet melden</guilabel
> te activeren.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Voer in het veld <guilabel
>Actie na afloop herinnering</guilabel
> een shellcommando in om uit te voeren wanneer de herinnering wordt bevestigt (of door op <guibutton
>Sluiten</guibutton
> te klikken of door de knop Sluiten in de titelbalk van het venster te gebruiken). Het wordt <emphasis
>niet</emphasis
> uitgevoerd in elk van de volgende omstandigheden:</para>

<itemizedlist>
<listitem
><para
>Wanneer een herinneringsbericht gesloten wordt.</para
></listitem>
<listitem
><para
>Wanneer u de herinnering uitstelt, behalve wanneer de uitgestelde herinnering uiteindelijk is bevestigd.</para
></listitem>
<listitem
><para
>Wanneer het herinneringsbericht gesloten wordt door zich af te melden.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Zie <link linkend="command-alarm"
>Herinneringen met shell-commando</link
> hieronder voor details over hoe shell-commando's worden uitgevoerd.</para>

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

<sect3 id="command-alarm">
<title
>Herinneringen met shell-commando</title>

<para
>Commando-herinneringen voeren een commando uit zonder een herinneringsbericht te tonen.</para>

<note
><para
>Deze type herinnering is niet beschikbaar als &kde; in kiosk-modus werkt.</para
></note>

<para
>Wanneer het commando wordt uitgevoerd zal de omgevingsvariabele <envar
>KALARM_UID</envar
> het gebeurtenis-UID van de herinnering bevatten. Merk op dat wanneer het commando wordt uitgevoerd vanuit de knop <guibutton
>Proberen</guibutton
> van de dialoog "Herinnering bewerken", <envar
>KALARM_UID</envar
> leeg zal zijn als het een nieuwe herinnering is of als de herinnering is gewijzigd in de dialoog, omdat de herinnering alleen een UID krijgt wanneer het is opgeslagen in de herinneringsagenda.</para>

<para
>De besturing beschikbaar voor Herinneringen met shell-commando command zijn:</para>

<itemizedlist>
<listitem>
<para
>Het keuzevakje <guilabel
>Voer een script in</guilabel
> laat u kiezen of u een shellcommandoregel of een script invoert.</para>

<para
>Als deze optie niet is geactiveerd kunt u een shell-commandoregel voor uitvoering invoeren. Het commando gaat direct naar de standaard shell (gedefinieerd door de omgevingsvariabele <envar
>SHELL</envar
>) en kan elke optie, parameter, piped commando, &etc;, toegestaan door de shell in een enkele regel bevatten.</para>

<para
>Als deze optie is geactiveerd kunt u de tekst van een uit te voeren script invoeren. denk er aan om een eerste regel, zoals <literal
>#!/bin/bash</literal
> in te voegen om er zeker van te zijn dat de juiste commando-interpretator wordt aangeroepen.</para>
</listitem>

<listitem>
<para
>Gebruik het groepsvak <guilabel
>Commandouitvoer</guilabel
> om te specificeren wat u wilt doen met alle terminaluitvoer die het commando produceert wanneer het wordt uitgevoerd.</para>

<itemizedlist>
<listitem>
<para
>Activeer <guilabel
>In terminalvenster uitvoeren</guilabel
> om te zorgen dat het commando uitgevoerd wordt in een terminalvenster. U kunt het type van het terminalvenster kiezen in de <link linkend="preferences-general"
>Instellingendialoog</link
>.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Naar bestand loggen</guilabel
> om de uitvoer van het commando op te slaan in een bestand. De uitvoer, voorafgegaan door een kop met de tijd waarop het commando was gepland te worden uitgevoerd, zal worden zal achteraan bestaande inhoud van het bestand worden gevoegd. Voer de bestandsnaam in in het bewerkingsvak of gebruik de knop naast het bewerkingsvak om een bestandsselectiedialoog te tonen.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Verwerpen</guilabel
> om de commando-uitvoer weg te gooien.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>Herinneringen via e-mail</title>

<para
>Herinneringen via e-mail, sturen een e-mail zonder een herinneringsbericht te tonen.</para>

<para
>Vul de adressen van de ontvangers, de regel met het onderwerp en de inhoud van het bericht in in de drie invoervelden. Gebruik de knop naast het vak voor de ontvanger om uw &kde; adresboek te tonen waaruit u e-mailadressen kunt selecteren. Bijlagen kunnen worden toegevoegd met de knop <guibutton
>Toevoegen...</guibutton
>. Merk op dat bijgevoegde bestanden nog steeds moeten bestaan wanneer de herinnering is wordt gestart; er wordt geen kopie opgeslagen op het moment dat de herinnering wordt ingesteld. Om een bijlage te verwijderen, activeer het in de afrollijst en klik op de knop <guibutton
>Verwijderen</guibutton
>.</para>

<para
>Stel de volgende opties in:</para>

<itemizedlist>
<listitem>
<para
>Het afrolmenu <guilabel
>Van</guilabel
> stelt u in staat te selecteren welke &kmail;-identiteit te gebruiken als uw afzender-e-mailadres. Deze optie verschijnt alleen als u het e-mailadres <guilabel
>Van</guilabel
> in de <link linkend="preferences-email"
>Instellingendialoog</link
> is ingesteld op <guilabel
>&kmail;-identiteiten gebruiken</guilabel
>. Ander is uw e-mailadres ingesteld in de <link linkend="preferences-email"
>Instellingendialoog</link
>, waarmee deze optie als niet van toepassing is geworden.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Kopie van e-mailbericht naar uzelf sturen</guilabel
> om een blinde kopie van de e-mail naar uzelf te sturen wanneer de herinnering wordt geactiveerd. Het e-mailadres waarnaar de kopie zal worden gezonden kan worden ingesteld in de <link linkend="preferences-email"
>Instellingendialaog</link
>, de standaard is uw e-mailadres ingesteld in &kde;-systeeminstellingen.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Geluidsherinneringen</title>

<para
>Geluidsherinneringen spelen een geluidsbestand af zonder een herinneringsbericht te tonen.</para>

<para
>Stel de volgende opties in:</para>

<itemizedlist>
<listitem>
<para
>Voer het pad in van het geluidsbestand of gebruik de knop naast het bewerkingsvak, om een dialoog voor het kiezen van een bestand te tonen.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Herhalen</guilabel
> om het geluidsbestand continu te herhalen totdat de optie <guilabel
>Afspelen stoppen</guilabel
> is geselecteerd. Om het afspelen van het bestand te stoppen, selecteer de menu-optie <menuchoice
><guimenu
>Acties</guimenu
> <guimenuitem
>Afspelen stoppen</guimenuitem
></menuchoice
> of klik <mousebutton
>Rechts</mousebutton
> op het pictogram in het systeemvak en kies <menuchoice
><guimenuitem
>Afspelen stoppen</guimenuitem
></menuchoice
> uit het contextmenu. Als u wilt kunt u een globale sneltoets voor deze actie instellen.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Volume</guilabel
> en pas de schuif aan als u het volume van het geluidsbestand dat afgespeeld moet worden wilt aanpassen.</para>
</listitem>

<listitem>
<para
>Als u wilt kunt u het volume laten vervagen. Vervagen betekent beginnen met afspelen van het audiobestand op het ene volume en het langzaam laten veranderen naar het uiteindelijke volume, in een gespecificeerd tijdinterval. Het eindvolume is wat is ingevoerd in <guilabel
>Volume</guilabel
> hierboven. Om vervagen in te schakelen, activeer <guilabel
>Vervagen</guilabel
> en voer het tijdinterval in seconden in in het veld <guilabel
>Vervagingstijd</guilabel
> en stel de schuif van het <guilabel
>Initiële volume</guilabel
> in.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Uitstel</title>

<para
>Als de herinnering een zich herhalende herinnering is en het was uitgesteld nadat het voor het laatst was getoond, dan toont het groepsvak <guilabel
>Uitgestelde herinnering</guilabel
> de tijd waarnaar de herinnering was uitgesteld. <guibutton
>Wijzigen...</guibutton
> toont een dialoog waarmee u de uitgestelde tijd kunt wijzigen of het uitstel kunt annuleren.</para>

</sect2>

<sect2>
<title
>Tijd</title>

<para
>In het groepsvak <guilabel
>Tijd</guilabel
>, selecteer ofwel</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Op datum/tijd</guilabel
> om de datum en tijd in te voeren wanneer de herinnering moet worden geactiveerd. Activeer <guilabel
>Elke tijd</guilabel
> als u alleen een datum voor de herinnering wilt specificeren: in dat geval zal de herinnering worden getoond bij de eerste gelegenheid op of na de ingestelde tijd bij de begindag, op de ingestelde datum. (<link linkend="preferences-time"
>&kalarm; instellen</link
> beschrijft hoe de tijd op de begindag in te stellen.)</para>

<para
>Voor een zich niet herhalende herinnering moet de ingevoerde datum/tijd zich in de toekomst bevinden of, als u alleen een datum invoert, moet het vandaag of later zijn. Voor een zich herhalende herinnering zijn er geen zulke beperkingen omdat de begindatum/tijd automatisch aangepast wordt aan het eerste voorkomen na de huidige tijd.</para>
</listitem>

<listitem>
<para
><guilabel
>Tijdsduur vanaf nu</guilabel
> om hoe lang na nu (in uren en minuten) de herinnering actief moet worden in te voeren.</para>
</listitem>
</itemizedlist>

<para
>Indien gewenst, kies een tijdzone om toe te passen op de uitzondering. Deze tijdzone wordt gebruikt voor alle datums en tijden gerelateerd aan deze herinnering, inclusief datums en tijden van herhalingen en uitzonderingen. Normaal laat u de elementen voor de tijdzone ongewijzigd tenzij u een goede reden hebt ze te wijzigen.</para>

<para
>De besturing van de tijdzone wordt alleen getoond wanneer de geselecteerde tijdzone verschilt van de standaard tijdzone ingesteld in de <link linkend="preferences-time"
>Instellingendialoog</link
> of als u op de knop <guibutton
>Tijdzone...</guibutton
> klikt.</para>

<itemizedlist>
<listitem>
<para
>Kies in het keuzevak de tijdzone die deze herinnering moet gebruiken. Bij het aanmaken van een nieuwe herinnering wordt dit initieel ingesteld op de tijdzone geselecteerd in de <link linkend="preferences-time"
>Instellingendialoog</link
>, die de tijdzone van uw computer is tenzij u deze hebt gewijzigd.</para>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Tijdzone negeren</guilabel
> als u de lokale computertijd wilt gebruiken (op welke computer &kalarm; op dat moment draait), met negeren van tijdzones.</para>

<warning
><para
>Het wordt aangeraden om deze optie niet te gebruiken wanneer de herinnering een terugkomst bevat uitgedrukt in uren of minuten. Wanneer u dit toch doet kan de herinnering op onvoorspelbare momenten tevoorschijn komen wanneer er wordt gewisseld van of naar zomertijd.</para
></warning>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Herinnering</title>

<para
>Voor een getoonde herinnering, activeer <guilabel
>Herinnering</guilabel
> als u een herinnering wilt weergeven ofwel voor of na de hoofdherinnering en elk van zijn herhalingen (indien aanwezig). Voer in, met de besturingsmiddelen naast het keuzevakje, hoe lang vooraf en na afloop, de herinnering wordt gegeven. Merk op dat als de herinnering terugkomt, de periode van de herhaling normaal beperkt is tot het kleiner zijn dan de herhaling of deelherhalingsinterval.</para>

<note
><para
>Herinneringen worden niet getoond voor deelherhalingen binnen een herhaling. Herinneringen worden alleen getoond voor elke hoofdherhaling van de herinnering.</para
></note>

<para
>Als de herinnering gebeurt, activeer dan <guilabel
>Herinnering alleen voor de eerste keer</guilabel
> als u alleen een herinnering wilt bij het gebeuren van de herinnering. Als dit is geactiveerd en het is een herinnering vooraf,dan is herinneringsperiode niet onderworpen aan de normale limiet van kleiner dan het herhalings- of deelherhalingsinterval.</para>


</sect2>

<sect2>
<title
>Afbreking</title>

<para
>De optie Afbreken bij te laat bepaalt hoe een herinnering wordt behandeld na zijn geplande tijd:</para>

<itemizedlist>
<listitem>
<para
>Het keuzevakje <guilabel
>Annuleren indien te laat</guilabel
> bepaalt wat er gebeurt als de herinnering niet kan worden gestart op zijn geplande tijd.</para>

<para
>Activeer dit vakje om de herinnering te annuleren als het niet af kan gaan binnen een gespecificeerde tijdsperiode na de juiste tijd. De tijdsperiode is geselecteerd met invoervakjes die verschijnen wanneer u het vakje activeert. Als u bijvoorbeeld een tijdsperiode van 1 uur invoert, zal de herinnering afgaan bij de eerste gelegenheid tot een uur nadat het zou aflopen, maar als het niet af kan gaan binnen een uur van zijn activatie zal het worden geannuleerd.</para>

<note
><para
>Het te laat zijn van alleen-datum herinnering, &ie; een voor wie de optie <guilabel
>Elke tijd</guilabel
> is geselecteerd, wordt berekend vanaf het tijdstip van het begin van de dag op de datum van de geplande datum van de herinnering.</para
></note>

<para
>Laat het vakje niet geactiveerd om de herinnering te starten bij het eerste gelegenheid beginnend bij de geplande tijd, onafhankelijk van hoeveel te laat het is.</para>

<note
><para
>Een herinnering kan alleen uitgevoerd worden wanneer u aangemeld bent en wanneer zowel X als &kalarm; actief zijn.</para
></note>
</listitem>

<listitem>
<para
>Activeer <guilabel
>Automatisch venster sluiten na deze tijd</guilabel
> als u het herinneringsvenster automatisch wilt sluiten als het nog steeds wordt getoond bij het aflopen van de afbreektijd bij te laat.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Herhaling</title>

<para
>Specificeren of en hoe een alarm herhaald moet worden door gebruikt te maken van het tabblad <guilabel
>Herhaling</guilabel
>.</para>

<note
><para
>De basis herhalingskarakteristieken van de herinneringen worden voor het gemak getoond in de titel van het tabblad <guilabel
>Herhaling</guilabel
>. Het herhalingsinterval wordt eerst getoond, gevolgd door een deelherhalingsinterval ingesteld met de knop <guibutton
>Deelherhaling</guibutton
>.</para
></note>

<para
>Stel het herhalingstype of tijdsperiode als volgt in in het groepsvakje <guilabel
>Herhalingsregel</guilabel
>:</para>

<itemizedlist>
<listitem
><para
>Om de herinnering eenmalig te starten, selecteer <guilabel
>Geen herhaling</guilabel
>.</para
></listitem>

<listitem
><para
>Selecteer <guilabel
>Bij aanmelden</guilabel
> om de herinnering af te laten gaan wanneer u zich aanmeldt, tot zijn geplande eindtijd. Dan, op zijn geplande eindtijd, zal het uiteindelijk nog een laatste keer afgaan. (Merk op dat een herinnering die herhaald wordt bij aanmelden ook zal afgaan op elk moment dat u &kalarm; herstart.)</para
></listitem>

<listitem>
<para
>Om te zorgen dat de herinnering zich herhaalt op reguliere intervals, selecteer een van de types tijdsperiode en voer dan in het vakje <guilabel
>Herhalen elke</guilabel
> hoeveel tijdsperioden voorbij moeten gaan tussen herhalingen. Om iets bijvoorbeeld elke veertien dagen zich te laten herhalen, kunt u <guilabel
>Dagelijks</guilabel
> selecteren en een waarde 14 invoeren of <guilabel
>Wekelijks</guilabel
> en een waarde 2 invoeren. Afhankelijk van het geselecteerde type tijdsperiode, kunnen er verdere opties zijn:</para>

<itemizedlist>
<listitem>
<para
>Selecteer, voor een wekelijkse herhaling, elke dag van de week waarop u de herinnering wilt uitvoeren.</para>
</listitem>

<listitem>
<para
>Voor een maandelijkse herhaling kunt u ofwel een vaste datum of een positie(&eg; de tweede dinsdag) selecteren.</para>
</listitem>

<listitem>
<para
>Voor een jaarlijkse herhaling kunt u ofwel een vaste dag in de maand of een positie in een maand (&eg; de laatste zaterdag in mei) selecteren. Activeer elke maand van het jaar waarin u de herinnering wilt starten.</para>

<para
>Als u een jaarlijkse herhaling instelt voor 29 februari kunt u specificeren hoe het behandeld wordt in niet-schrikkeljaren door de van toepassing zijnde optie <guilabel
>Herinnering op 29 februari in niet-schrikkeljaren</guilabel
> te selecteren:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Geen</guilabel
>: de herinnering zal alleen optreden op 29 februari in schrikkeljaren (dus nooit in 'gewone' jaren).</para>
</listitem>

<listitem
><para
><guilabel
>28 feb</guilabel
>: de herinnering zal gebeuren op 29 februari in schrikkeljaren en op 28 februari in niet-schrikkeljaren.</para>
</listitem>

<listitem
><para
><guilabel
>1 maart</guilabel
>: de herinnering zal gebeuren op 29 februari in schrikkeljaren en op 1 maart in niet-schrikkeljaren.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>Om een dagelijkse herinnering plaats te laten gebeuren op alleen weekdagen, gebruik een wekelijkse herhaling en activeer elke weekdag.</para
></tip>

</listitem>
</itemizedlist>

<para
>In het groepsvak <guilabel
>Einde herhaling</guilabel
>, stel de algemene tijdsspanne voor herhaling als volgt in:</para>

<itemizedlist>
<listitem
><para
>Selecteer <guilabel
>Geen einde</guilabel
> om de herhalingen oneindig door te laten lopen.</para
></listitem>

<listitem
><para
>Selecteer <guilabel
>Einde na</guilabel
> om het totale aantal keren van de herinnering te specificeren.</para
></listitem>

<listitem
><para
>Selecteer <guilabel
>Einde op</guilabel
> om de datum/tijd te specificeren tot waar de herinnering zal worden herhaald. Merk op dat dezelfde tijdzone gebruikt als de begintijd van de herinnering.</para>

<note
><para
>De einddatum/tijd bepaalt wanneer de laatste hoofdherinnering zal zijn, maar beperkt niet de deelherhalingen. Als deelherinneringen zijn ingesteld, zullen ze worden gestart als normale na de laatste hoofdherinnering, onafhankelijk van de einddatum/tijd.</para
></note>
</listitem>
</itemizedlist>

<para
>Het groepsvak <guilabel
>Uitzonderingen</guilabel
> stelt u in staat om bepaalde datums/tijden uit de herhaling, die u hebt ingesteld, uit te sluiten. Merk op dat deze instellingen niet getoond worden in de vereenvoudigde vorm van de dialoog Herinnering bewerken: om ze te zien, klik op <guibutton
>Meer opties</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>De lijst met uitzonderingen (&ie; uitgesloten datum/tijden) wordt links getoond. Om een nieuwe uitzondering toe te voegen, voer een datum rechts in en druk op <guibutton
>Toevoegen</guibutton
>. Om een uitzondering te wijzigen, accentueer het in de lijst, voer de nieuwe datum rechts in en druk op <guibutton
>Wijzigen</guibutton
>. Om een uitzondering te verwijderen, accentueer het in de lijst en druk op <guibutton
>Verwijderen</guibutton
>.</para>
</listitem>

<listitem>
<para
>U kunt een herinnering beperken om niet te verschijnen op vrije dagen door <guilabel
>Vrije dagen uitsluiten</guilabel
>. Dit verandert niets aan de manier waarop de herinnering is gepland; het onderdrukt eenvoudig de herinnering wanneer het afloopt op een vrije dag. U kunt uw land of regio voor vakantiedagen selecteren in de <link linkend="preferences-time"
>Instellingendialoog</link
>.</para>
</listitem>

<listitem>
<para
>U kunt een herinnering beperken om alleen af te lopen gedurende werktijd door <guilabel
>Alleen tijdens werkuren</guilabel
> te activeren. Dit verandert niets aan de manier waarop de herinnering is gepland; het onderdrukt eenvoudig de herinnering wanneer deze afloopt buiten werkuren. Werkdagen en werkuren worden ingesteld in de <link linkend="preferences-time"
>Instellingendialoog</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Deelherhaling</title>

<para
>U kunt de knop <guibutton
>Deelherhaling</guibutton
> gebruiken om een herhaling in een herhaling in te stellen. In dat geval wordt elke keer wanneer de herinnering afgaat zoals gespecificeerd in de hoofdherhaling, in plaats van eenmalig geactiveerd herhaald geactiveerd overeenkomstig de specificatie van uw deelherhaling. Om bijvoorbeeld een herinnering in te stellen die zich elk uur herhaalt vanaf het middaguur tot 18 uur elke donderdag, zou u een wekelijks herhaling op donderdag om 12:00 uur in moeten stellen en de dialoog Deelherhaling moeten gebruiken om een interval van 1 uur te specificeren en ofwel een aantal van 6 of een duur van 6 uren.</para>

<para
>In de dialoog Deelherhaling die wordt getoond wanneer u klikt op de knop <guibutton
>Deelherhaling</guibutton
>, activeer <guilabel
>Herhalen elke</guilabel
> om een haling in te stellen of het deactiveren om de herhaling te verwijderen. Als <guilabel
>Herhalen elke</guilabel
> is geactiveerd, stel dan de herhaling in als volgt:</para>

<itemizedlist>
<listitem
><para
>Voer het tijdsinterval tussen herhalingen in in de vakjes naast <guilabel
>Herhalen elke</guilabel
>. Selecteer de gewenste tijdseenheden (&eg; <guilabel
>dagen</guilabel
>) en voer dan het aantal eenheden in.</para>
</listitem>

<listitem
><para
>Specificeer ofwel het aantal herhalingen ofwel de duur:</para>

<itemizedlist>
<listitem
><para
>Selecteer <guilabel
>Aantal keren</guilabel
> om hoe vaak de herinnering af moet gaan na de hoofdherhaling. Om dus, bijvoorbeeld, de herinnering 4 keer af te laten gaan for elke hoofdherhaling, &ie; 3 extra keer, dan zou u hier 3 moeten invoeren.</para>
</listitem>

<listitem
><para
>Selecteer <guilabel
>Duur</guilabel
> om de totale tijdsperiode gedurende welke de herinnering herhaald moet worden. Dit hoeft geen exact veelvoud van het herhalingsinterval te zijn; het zal automatisch naar beneden worden afgerond wanneer u op <guibutton
>OK</guibutton
> klikt.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Om overlappende deelherhalingen voor dezelfde herhaling te voorkomen, is de duur van een deelherhaling beperkt tot minder dan het langste interval tussen hoofdherhalingen. Elke keer dat de herinnering afgaat zoals gespecificeerd in de hoofdherhaling, zal elke nog actieve deelherhaling, die is gestart bij de vorige herhaling, automatisch worden geannuleerd.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Andere besturing</title>

<para
>Voor herinneringen die worden getoond laat het keuzevakje <guilabel
>Om bevestiging vragen</guilabel
> u specificeren of u om bevestiging moet worden gevraagd wanneer u het berichtenvenster sluit of niet. Dit kan worden gebruikt als beveiliging tegen het per ongeluk bevestigen van herinneringen.</para>

<para
>Selecteer <guilabel
>In &korganizer; tonen</guilabel
> om de herinnering toe te voegen aan de actieve agenda van &korganizer;, waar het zal verschijnen als een afspraak zonder een herinnering. Deze optie stelt u in staat om herinneringen in &korganizer; te volgen terwijl u nog steeds gerbuik maakt van de functies van &kalarm;.</para>

<note
><para
>Als u later de herinnering in &kalarm; wijzigt of verwijdert, zal de afspraak in &korganizer; overeenkomstig worden gewijzigd of verwijderd. Maar als u de afspraak in &korganizer; wijzigt, zal de herinnering in &kalarm; niet worden beïnvloed.</para
></note>

<para
>Druk op de knop <guibutton
>Sjabloon laden</guibutton
> om een sjabloon te selecteren om de dialoog alvast in te vullen, zoals beschreven in <link linkend="create-edit"
>Herinneringen aanmaken en bewerken</link
>. </para>

<para
>Druk op de knop <guibutton
>Proberen</guibutton
> om de herinnering te testen en controleer of deze correct werkt. De herinnering wordt uitgevoerd alsof het op de normale manier is gepland.</para>

<para
>Druk op de knop <guibutton
>OK</guibutton
> wanneer alle details juist zijn, om de herinnering aan de planningslijst toe te voegen. Merk op dat bij het bewerken van een bestaande herinnering, de knop <guibutton
>OK</guibutton
> is uitgeschakeld zolang er geen wijzigingen zijn gedaan.</para>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Venster met herinneringsbericht</title>

<para
>Wanneer een herinneringsbericht gegeven moet worden, wordt het op elk &kde;-bureaublad getoond en kan het niet door gewone vensters worden bedekt, om te verzekeren dat u het ziet. Het berichtvenster toont de tijd waarop de herinnering was gepland, zodat u kunt zien wanneer het verscheen als u op dat moment weg was van de computer. Als de geplande tijd een andere tijdzone bevat dan de lokale instelling van uw computer, dan zal zijn tijdzone ook worden getoond. (Voor herhalingsberichten zal de datum/tijd van de hoofdherinnering of die van zijn weer verschijnen worden getoond, niet de tijd van het herhalingsbericht, en de venstertitel is <quote
>Herinnering</quote
>.)</para>

<para
>Vensters met herinneringsberichten blijven zichtbaar totdat u ze bevestigt, tenzij <guilabel
>Venster automatisch sluiten na de late annuleringstijd</guilabel
> was geactiveerd in de <link linkend="alarm-edit-dlg"
>dialoog Herinnering bewerken</link
>. In het geval van een zich herhalende herinnering, als een niet bevestigd berichtvenster overblijft van een vorig afgaan van de  herinnering, dan blijft het bestaande venster eenvoudig zichtbaar wanneer de herinnering zich herhaald. Dit vermijdt het hebben van meerdere kopieën van bevestigingen van hetzelfde bericht als u niet wilt of niet in staat bent een bericht te bevestigen op het moment dat het verschijnt.</para>

<para
>Het venster met het herinneringsbericht biedt, voor zover van toepassing, de volgende opties van het getoonde bericht:</para>

<itemizedlist>
<listitem>
<para
>Bevestig de herinnering door te klikken op de knop <guibutton
>Sluiten</guibutton
>. Dit sluit het venster (na een vraag om bevestiging, als u <guilabel
>Bevestiging bevestigen</guilabel
> hebt geselecteerd).</para>
</listitem>

<listitem>
<para
>Bewerk de herinnering door te klikken op de knop <guibutton
>Bewerken...</guibutton
>. Dit toont het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>.</para>
</listitem>

<listitem>
<para
>Toon opties, om de herinnering naar later te verschuiven, door op de knop <guibutton
>Verschuiven...</guibutton
> te klikken. Selecteer daarna <guilabel
>Naar datum/tijd verschuiven</guilabel
> om de datum en tijd wanneer het bericht weer moet worden getoond of selecteer <guilabel
>Met een tijdsinterval vertragen</guilabel
> om in te voeren hoelang na nu (in uren en minuten) het bericht opnieuw moet worden getoond. Klik daarna op <guibutton
>OK</guibutton
> om het herinneringsbericht te verschuiven en sluit zijn venster.</para>

<note
><para
>De tijd waarnaar de herinnering moet worden verschoven moet eerder zijn dan zijn volgende geplande verschijning of de volgende herinnering vooraf. Om deze reden zal de knop <guibutton
>Verschuiven...</guibutton
> in het venster met het herinneringsbericht en de knop <guibutton
>OK</guibutton
> in de dialog Verschuiven uitgeschakeld zijn één minuut voordat de volgende geplande tijd of herinnering vooraf.</para>
<para
>Merk op dat als een herhaling is ingesteld <emphasis
>na</emphasis
> de herinnering, u de herinnering <emphasis
>kunt</emphasis
> verschuiven na de tijd van de herhaling. In dat geval zal de herhaling worden onderdrukt.</para
></note>

<note
><para
>De knop <guibutton
>Verschuiven...</guibutton
> is niet beschikbaar voor herinneringen die bij aanmelden getoond worden omdat de optie <guilabel
>Herhalen bij aanmelden</guilabel
> is geselecteerd.</para
></note>
</listitem>

<listitem>
<para
>Stop met het afspelen van het geluidsbestand van de herinnering door te klikken op de knop die het symbool <quote
>afspelen stoppen</quote
>.</para>
</listitem>

<listitem>
<para
>Als het herinneringsbericht is gemaakt door een e-mail uit &kmail; te verslepen, dan kunt u direct toegang krijgen tot de e-mail in &kmail; door te klikken op de knop met het pictogram van &kmail;. Dit selecteert en accentueert de e-mail in de lijst van mappen van &kmail;.</para>

<warning
><para
>Als de indexen van &kmail; opnieuw worden gegenereerd, zal de koppeling naar het e-mailbericht in &kmail; verloren gaan.</para
></warning>
</listitem>

<listitem>
<para
>De knop met het pictogram van <guiicon
>&kalarm;</guiicon
> biedt een gemakkelijke manier om &kalarm; activeren.</para>
</listitem>
</itemizedlist>

<para
>U kunt in het <link linkend="preferences-view"
>Configuratiedialoogvenster</link
> kiezen welke van de twee verschillende modi gebruikt moeten worden om de vensters met herinneringsberichten te tonen:</para>

<itemizedlist>
<listitem>
<para
>Als een normaal venster. In deze modus wordt het toetsenbord gevangen in het berichtvenster van de herinnering, wanneer deze verschijnt. Als u dus aan het typen bent wanneer de herinnering geactiveerd wordt, zullen uw toetsaanslagen daarheen gestuurd worden i.p.v. naar de originele applicatie waar u aan het typen was. </para>
</listitem>

<listitem>
<para
>Als een niet-modaal venster. In deze modus is de focus van het toetsenbord niet aangetast wanneer het venster met het herinneringsbericht verschijnt, zodat het niet interfereert met wat u typt. In deze modus echter heeft het venster geen titelbalk of frame, zodat u het niet kunt verplaatsen of van grootte wijzigen.</para>
</listitem>
</itemizedlist>

<note
><para
>Wanneer een herinnering wordt getoond bovenop een toepassing in de modus volledig scherm, wordt het getoond als een niet-modaal venster onafhankelijk van deze instelling. Dit is vanwege beperkingen van het venstersysteem.</para
></note>

<sect2>
<title
>Positionering van een berichtvenster</title>

<para
>U kunt in het <link linkend="preferences-view"
>Configuratiedialoogvenster</link
> kiezen welke van de 2 schema's gebruikt moeten worden om de vensters met herinneringsberichten te positioneren:</para>

<itemizedlist>
<listitem>
<para
>De vensters worden zo ver mogelijk van de muisaanwijzer vandaan getoond. Dit zorgt ervoor dat u zo min mogelijk gestoord wordt in uw werk, en dat u niet per ongeluk de herinnering kunt bevestigen.</para>
</listitem>

<listitem>
<para
>De vensters worden getoond in het midden van het scherm. Om de kans te beperken om per ongeluk de herinnering te bevestigen, zijn de knoppen in het venster eerst uitgeschakeld, en worden alleen actief na een in te stellen vertraging.</para>
</listitem>
</itemizedlist>

<para
>Als er verschillende vensters met herinneringsberichten of foutmeldingen, getoond worden, dan kunt u can de vensters uitspreiden over het scherm om ze allemaal zichtbaar te maken of ze allemaal samen te groeperen in de linker bovenhoek van het scherm, door middel van de menu-optie <menuchoice
> <guimenu
>Beeld</guimenu
><guimenuitem
>Vensters verspreiden</guimenuitem
> </menuchoice
>. Als u dat wilt, kunt u een globale sneltoets voor deze actie instellen.</para>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Systeemvakhandeling</title>

<para
>&kalarm; toont standaard een pictogram in het systeemvak. Dit pictogram voorziet zowel in besturing, als in een statusaanduiding van van een herinnering. Een normaal pictogram van &kalarm; toont dat herinneringen worden bekeken, terwijl een grijs pictogram aangeeft dat dat niet wordt gedaan. Als individuele uitgeschakeld zijn, dan staat er een klein kruis over het pictogram.</para>

<para
>Als u met de muiscursor over het pictogram in het systeemvak beweegt, wordt een samenvatting van de eerst paar herinneringsberichten, die aflopen in de volgende 24 uur, als een tekstballon getoond. U kunt deze functie uitschakelen of het aantal te tonen herinneringen en hun format in te stellen, in de <link linkend="preferences-view"
>Instellingendialoog</link
>.</para>

<para
>Klik <mousebutton
>Links</mousebutton
> op het pictogram in het systeemvak om te schakelen tussen het tonen of verbergen van het hoofdvenster van &kalarm;.</para>

<para
>Klik <mousebutton
>Rechts</mousebutton
> op het pictogram in het systeemvak om zijn contextmenu te tonen:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Herinneringen inschakelen</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Activeert of deactiveert het monitoren van herinneringen.</action
></para>
<para
>Zie <link linkend="enable-disable"
>Herinneringenin- en uitschakelen</link
> for details.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nieuwe herinnering</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Nadat u het alarmtype uit de verschijnende lijst hebt geselecteerd, opent zich de dialoog Herinneringen bewerken om een nieuwe herinnering aan te maken.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nieuwe herinnering van sjabloon</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Toont een lijst met herinneringsjablonen in een menu. Als u er een selecteert, wordt het dialoogvenster om herinneringen te bewerken geopend, met de ingevulde details van dat sjabloon.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Afspelen stoppen</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Stopt het afspelen van het geluidsbestand bij afspelen.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Verspreid vensters</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Verspreid de vensters van herinnerings- en foutmeldingen over het scherm of groepeert ze opnieuw bij elkaar.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>&kalarm; instellen...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Toont de instellingendialoog van  &kalarm;.</action
></para>
<para
>De Instellingendialoog wordt beschreven in <link linkend="preferences"
>&kalarm; instellen</link
>. Het omvat opties gerelateerd aan het pictogram van &kalarm; in het systeemvak.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Herstellen / minimaliseren</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Herstelt of minimaliseert het hoofdvenster van &kalarm;.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Afsluiten</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Sluit het systeemvakpictogram en hoofdvensters van &kalarm;.</action
></para>
<para
>Sluit &kalarm; af als er geen herinneringsberichtvensters getoond worden.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>&kalarm; in het systeemvak tonen</title>

<para
>U moet het &kde; bureaublad of een andere geschikte vensterbeheerder gebruiken om &kalarm; te kunnen tonen in het systeemvak.</para>

<para
>Om &kalarm; in het systeemvak te tonen, activeer <menuchoice
> <guimenu
>Beeld</guimenu
><guimenuitem
>In systeemvak tonen</guimenuitem
> </menuchoice
>.</para>

<para
>Om &kalarm; uit het systeemvak te verwijderen, deactiveer <menuchoice
> <guimenu
>Beeld</guimenu
><guimenuitem
>In systeemvak tonen</guimenuitem
> </menuchoice
>.</para>

<para
>Om te kiezen of &kalarm; bij opstarten in het systeemvak getoond moet worden of niet, gebruik het tabblad <link linkend="preferences-view"
>Beeld</link
> van de Instellingendialoog.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Herinneringen verversen</title>

<para
>Indien, in het onwaarschijnlijke geval, een herinnering niet is geactiveerd toen dat zou moeten, kunt u de lijst met herinneringen verversen en elke gemiste herinnering activeren door <menuchoice
> <guimenu
>Acties</guimenu
><guimenuitem
>Herinneringen verversen</guimenuitem
> </menuchoice
> te kiezen. Dit maakt dat &kalarm; alle herinneringsagenda's herlaadt.</para>

<para
>U kunt een individuele agenda herladen en zijn herinneringen in de lijst met herinneringen herladen door <mousebutton
>Rechts</mousebutton
> te klikken in de agenda in de lijst met agenda's en de menu-optie <menuchoice
><guimenuitem
>Herladen</guimenuitem
></menuchoice
> te kiezen. Zie <link linkend="calendars"
>Herinneringsagenda's</link
> voor details.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Herinneringen in- en uitschakelen</title>

<para
>Herinneringen kunnen allemaal tegelijk of individueel worden in- of uitgeschakeld:</para>

<itemizedlist>
<listitem>
<para
><quote
>Monitoren van herinneringen</quote
> is van toepassing op herinneringen als geheel. Terwijl herinneringen monitoren is uitgeschakeld, worden er in geheel geen herinneringen geactiveerd. Terwijl herinneringen monitoren is ingeschakeld (de normale situatie), zullen alle herinneringen die niet individueel zijn uitgeschakeld worden geactiveerd op de bijbehorende tijden.</para>

<para
>Wanneer herinneringen monitoren opnieuw wordt ingeschakeld, zullen herinneringen die geactiveerd zouden zijn tijdens de tijd van uitgeschakeld zijn nu worden geactiveerd (tenzij een laat-annuleren optie dat voorkomt). Met andere woorden, herinneringen monitoren heeft hetzelfde effect als stoppen van &kalarm; &ndash; herinneringen worden uitgesteld totdat het opnieuw wordt ingeschakeld.</para>
</listitem>

<listitem>
<para
>Herinneringen kunne individueel in en uitgeschakeld worden, onafhankelijk van de status van herinneringen monitoren. Dus de status in- of uitgeschakeld van individuele herinneringen blijft ongewijzigd bij uitschakelen en dan opnieuw inschakelen van herinneringen monitoren. Anders dan bij herinneringen monitoren die potentieel uitgeschakeld kan zijn omdat &kalarm; niet actief is, kunnen individuele herinneringen alleen uitgeschakeld worden als u menu-commando's gebruikt.</para>

<para
>Wanneer een herinnering individueel opnieuw is ingeschakeld, wordt deze niet geactiveerd als het afliep tijdens de uitschakeling. In andere woorden, een individuele herinnering uitschakelen annuleert alle activering totdat het opnieuw is ingeschakeld.</para>

<para
>De status in of uitgeschakeld van een individuele herinnering wordt aangegeven door zijn kleur in de lijst met herinneringen (de kleur kan ingesteld worden in het tabblad <link linkend="preferences-view"
>Beeld</link
> van de instellingendialoog).</para>
</listitem>
</itemizedlist>

<para
>Om een herinnering te activeren moet het individueel ingeschakeld worden evenals herinneringen monitoren moet zijn ingeschakeld.</para>

<sect2>
<title
>Herinneringen monitoren inschakelen</title>

<para
>Om herinneringen monitoren actief te laten zijn, moet &kalarm; actief zijn. Nadat &kalarm; is geactiveerd, zal het vanaf dat moment automatisch starten wanneer u zich aanmeldt tenzij u het later uitschakelt in het tabblad <link linkend="preferences-general"
>Algemeen</link
> van de Instellingendialoog.</para>

<para
>Als herinneringen monitoren nu is uitgeschakeld, doe dan een van het volgende om herinneringen in te schakelen:</para>

<itemizedlist>
<listitem>
<para
>Selecteer <menuchoice
><guimenu
>Acties</guimenu
> <guimenuitem
>Herinneringen activeren</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klik <mousebutton
>Rechts</mousebutton
> op het pictogram in het systeemvak en kies <menuchoice
><guimenuitem
>Herinneringen inschakelen</guimenuitem
></menuchoice
> uit het contextmenu.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Herinneringen monitoren uitschakelen</title>

<para
>U kunt tijdelijk herinneringen monitoren uitschakelen, die voorkomt dat &kalarm; herinneringen controleert ofwel totdat u herinneringen opnieuw inschakeld of &ndash; aannemend dat &kalarm; is ingesteld om bij aanmelden te starten &ndash; tot de volgende keer dat u zich aanmeldt.</para>

<itemizedlist>
<listitem>
<para
>Deactiveer <menuchoice
><guimenu
>Acties</guimenu
> <guimenuitem
>Herinneringen inschakelen</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klik <mousebutton
>Rechts</mousebutton
> op het pictogram in het systeemvak en deactiveer <menuchoice
><guimenuitem
>Herinneringen inschakelen</guimenuitem
></menuchoice
> uit het contextmenu.</para>
</listitem>

<listitem>
<para
>&kalarm; uitvoeren met de commandoregeloptie <option
>--disable-all</option
>.</para>
</listitem>

<listitem>
<para
>Stop &kalarm; zoals beschreven in <link linkend="quitting"
>&kalarm; beëindigen</link
>.</para>
</listitem>
</itemizedlist>

<para
>Herinneringen kunnen permanent worden uitgeschakeld door te voorkomen dat &kalarm; bij aanmelden wordt gestart in het tabblad <link linkend="preferences-general"
>Algemeen</link
> van de Instellingendialoog.</para>

</sect2>

<sect2>
<title
>Individuele herinneringen in- of uitschakelen</title>

<para
>Om individuele herinneringen die nu zijn uitgeschakeld, doe een van de volgende acties:</para>

<itemizedlist>
<listitem>
<para
>Selecteer een of meer herinneringen uit de herinneringslijst door erop te klikken. Kies daarna <menuchoice
> <guimenu
>Acties</guimenu
><guimenuitem
>Inschakelen</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klik <mousebutton
>Rechts</mousebutton
> op de gewenste items in de lijst met herinneringen en kies <menuchoice
><guimenuitem
>Inschakelen</guimenuitem
></menuchoice
> uit het contextmenu.</para>
</listitem>
</itemizedlist>

<para
>Om individuele herinneringen die nu zijn ingeschakeld, doe een van de volgende acties:</para>

<itemizedlist>
<listitem>
<para
>Selecteer een of meer herinneringen uit de herinneringslijst door erop te klikken. Kies daarna <menuchoice
> <guimenu
>Acties</guimenu
><guimenuitem
>Uitschakelen</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klik <mousebutton
>Rechts</mousebutton
> op de gewenste items in de lijst met herinneringen en kies <menuchoice
><guimenuitem
>Uitschakelen</guimenuitem
></menuchoice
> uit het contextmenu.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Ontwaken uit onderbreken</title>

<para
>Het is mogelijk om een geselecteerde herinnering uw computer uit een slaapstand, al of niet op schijf, te laten ontwaken wanneer de herinnering afloopt, zodat de actie bij de herinnering kan gebeuren zelfs wanneer het systeem was afgesloten. Deze functie wordt bestuurt door een dialoog die  wordt geactiveerd door <menuchoice
><guimenu
>Acties</guimenu
> <guimenuitem
>Ontwaken uit slaapstand</guimenuitem
></menuchoice
> te selecteren. De dialoog staat toe de herinnering Ontwaken uit slaapstand in te stellen, te annuleren of te tonen.</para>

<para
>Gebruik van de functie Ontwaken uit slaapstand vereist de rechten van de systeembeheerder. U zult gevraagd worden naar het wachtwoord van root wanneer u een herinnering Ontwaken uit slaapstand instelt of annuleert.</para>

<note
><para
>Ontwaken uit slaapstand wordt op sommige computers niet ondersteund, meer specifiek de ouderen, en sommige computers ondersteunen het instellen van de tijd voor ontwaken uit slaapstand tot 24 uur vooruit. Er kunnen ook beperkingen zijn over uit welke modus van slaapstand de functie kan ontwaken. U zou moeten overwegen om het instellen dit type herinneringen te testen om te controleren of uw systeem deze functionaliteit bezit alvorens hier op te vertrouwen.</para
></note>

<warning
><para
>Uw computer kan op een bepaald moment slechts een enkele Uit slaapstand ontwaken plannen. Als u deze functie in &kalarm; gebruikt, moet u nagaan dat deze niet in conflict is met een andere toepassing die ook Uit slaapstand ontwaken gebruikt. Wanneer een toepassing Uit slaapstand ontwaken plant of wist, dan annuleert deze elke eerder ingestelde Uit slaapstand ontwaken, onafhankelijk of &kalarm; deze heeft ingesteld of een andere toepassing.</para
></warning>

<para
>De dialoog Uit slaapstand ontwaken wordt gebruikt in samenwerking met de lijst met herinneringen in het hoofdvenster van &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Geaccentueerde herinnering gebruiken</guibutton
>: deze stelt de herinnering die nu is geaccentueerd in de lijst met herinneringen zoals de herinnering Uit slaapstand ontwaken. Elke bestaande geplande Uit slaapstand ontwaken wordt geannuleerd, zoals boven uitgelegd. De knop is alleen ingeschakeld als exact één herinnering is geaccentueerd.</para>
</listitem>

<listitem>
<para
><guibutton
>Uit slaapstand ontwaken annuleren</guibutton
>: dit annuleert elke bestaande Uit slaapstand ontwaken (ofwel ingesteld door &kalarm; of elke andere toepassing - zie boven). Merk op dat dit alleen de ontwaakfunctie geassocieerd met de herinnering annuleerd; de herinnering zelf wordt niet verwijderd en zal normaal verder blijven werken.</para>
</listitem>

<listitem>
<para
><guibutton
>Huidige herinnering tonen</guibutton
>: dit accentueert de huidige herinnering Uit slaapstand ontwaken in de lijst herinneringen, zodat het kan worden geïdentificeerd. De knop is uitgeschakeld als er nu geen Uit slaapstand ontwaken is geconfigureerd.</para>
</listitem>

<listitem>
<para
>De aansturing van <guilabel
>Aantal minuten vóór de herinnering om te ontwaken uit slaapstand</guilabel
> stelt u in staat, als u dat wilt, om er zeker van te zijn dat het systeem tijd heeft om zich volledig te herstellen alvorens de herinnering te activeren, zodat de herinnering op de juiste tijd kan aflopen.</para>
</listitem>
</itemizedlist>

</sect1>

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

<para
>Beëindig &kalarm; door <menuchoice
> <guimenu
>Bestand</guimenu
><guimenuitem
>Afsluiten</guimenuitem
></menuchoice
> te selecteren of <menuchoice
><guimenuitem
>Afsluiten</guimenuitem
></menuchoice
> in het contextmenu van het pictogram in het systeemvak. Alternatief, als het pictogram in het systeemvak niet zichtbaar is, sluit alle vensters van &kalarm;.</para>

</sect1>
</chapter>

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

<para
>Om de werking van &kalarm; in te stellen naar de behoefte van uw systeem en uw persoonlijke voorkeuren, selecteer <menuchoice
><guimenu
>Instellingen</guimenu
> <guimenuitem
>&kalarm; instellen...</guimenuitem
></menuchoice
>. Dit  toont de Instellingendialoog.</para>

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

<para
>In de sectie <guilabel
>Algemeen</guilabel
> kunt u het algemene gedrag van &kalarm; beheren:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Opstarten bij aanmelden</guilabel
>: zal &kalarm; automatisch opstarten bij het aanmelden bij een &kde; sessie, om er zeker van te zijn dat &kalarm; altijd actief is tenzij u handmatig afsluit.</para>

<warning
><para
>Deze optie zou altijd actief moeten zijn tenzij u het gebruik van &kalarm; niet wilt voortzetten.</para
></warning>

<note
><para
>Deze optie wordt automatisch opnieuw geselecteerd wanneer &kalarm; actief wordt. Dus als u deze optie hebt gedeactiveerd en wilt voorkomen dat &kalarm; actief wordt bij aanmelden, dan moet u deze optie opnieuw deactiveren elke keer dat u &kalarm; uitvoert.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Waarschuwing voor af te sluiten</guilabel
>: Wanneer herinneringen zijn uitgeschakeld terwijl &kalarm; niet actief is, doet het selecteren van deze optie vragen u vragen om bevestiging als u probeert &kalarm; te beëindigen met de optie bij het pictogram in het systeemvak <menuchoice
><guimenu
>Afsluiten</guimenu
></menuchoice
>. Dit voorkomt het per ongeluk uitschakelen van herinneringen. Voor de veiligheid wordt deze optie standaard automatisch opnieuw ingeschakeld wanneer u uitvoeringsmodus wijzigt.</para>
</listitem>

<listitem
><para
><guilabel
>Bevestig verwijdering van herinneringen</guilabel
> Specificeert of u om een bevestiging wilt worden gevraagd, telkens als u een herinnering verwijdert.</para>
</listitem>

<listitem
><para
><guilabel
>Standaard tijdsinterval voor uitstel</guilabel
>: Voer het standaard tijdsinterval in in uren en minuten, om initieel te tonen wanneer de Dialoog voor uitstel van een herinnering wordt getoond. Merk op dat als een herinnering eerder is uitgesteld, het getoonde initiële interval in de Dialoog voor uitstel van een herinnering gelijk zal zijn aan de het laatst gebruikte interval voor uitstel nadat de herinnering was uitgesteld.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal voor herinneringen via een opdrachtregel</guilabel
>: Hier kunt u selecteren welk type terminalvenster gebruikt moet worden voor herinneringen die uitgevoerd worden in een terminalvenster. Sommige van de meest algemene terminalvenstertoepassingen zijn voorgeconfigureerd, &eg; <application
>xterm</application
>, &konsole;, hoewel alleen diegene die zijn geïnstalleerd in uw systeem hier zullen worden getoond. U kunt de actuele opdrachtopties, gebruikt voor elke toepassing, bekijken door de contexthelp voor zijn keuzerondje te tonen.</para>

<para
>Als u een andere toepassing wilt gebruiken of er van een die in de lijst wilt gebruiken maar met andere  commando-opties, selecteer  dan <guilabel
>Anders</guilabel
> en voer het commando om het terminalvenster op te roepen in. Standaard zal de commandotekst van de herinnering worden achtergevoegd bij wat u specificeert. Alternatief kunt u specificeren waar de commandotekst van de herinnering moet worden ingevoegd, door de volgende codes te gebruiken:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>De commandotekst van de herinnering zal worden gesubstitueerd.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>De commandotekst van de herinnering zal worden gesubstitueerd met een achtergevoegde <literal
>sleep</literal
>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Er zal een tijdelijk commandobestand worden aangemaakt met de commandotekst van de herinnering en het uit te voeren commando zal worden gesubstitueerd.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Er zal een tijdelijk commandobestand worden aangemaakt met de commandotekst van de herinnering met een <literal
>sleep</literal
> achtergevoegd en het uit te voeren commando zal worden gesubstitueerd.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Wanneer de commandoherinnering wordt geactiveerd zal zijn commandotekst omgeven worden door aanhalingstekens voordat het wordt ingevoegd in het commando voor het terminalvenster.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Datum en tijd</title>

<para
>De sectie <guilabel
>Tijd en datum</guilabel
> laat u opties instellen gerelateerd aan tijd en datum:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Tijdzone</guilabel
>: Selecteer uw tijdzone. &kalarm; gebruikt deze tijdzone overal, behalve wanneer u het overschrijft voor individuele herinneringen.</para>
</listitem>

<listitem
><para
><guilabel
>Vakantieregio</guilabel
>: Selecteer uit welk land of regio de vakanties moeten worden gebruikt. Dit heeft betrekking op herinneringen waarvoor de optie om vakantiedagen uit te sluiten is geselecteerd.</para>
</listitem>

<listitem
><para
><guilabel
>Begin van de dag voor herinneringen met alleen een datum</guilabel
>: Stel het tijdstip van het begin-van-de-dag in met het doel alleen-datum herinneringen te activeren, &ie; diegene waarvoor de optie <guilabel
>Elke tijd</guilabel
> was geselecteerd. Op de datum wanneer ze aflopen, zullen zulke herinneringen worden uitgevoerd bij het vroegste gelegenheid gedurende de 24 uur beginnend met de tijd van begin-van-de-dag.</para>
</listitem>

<listitem
><para
><guilabel
>Werkuren</guilabel
>-groepsvak: Deze opties laten u uw werkuren, nodig wanneer de optie <guilabel
>Alleen tijdens werkuren</guilabel
> is geselecteerd voor een herhaling in de <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>.</para>

<itemizedlist>
<listitem
><para
>Alle werkdagen aanvinken.</para>
</listitem>

<listitem
><para
><guilabel
>Begintijd werkdag</guilabel
>: voer de tijd in waarop u  elke dag begint met uw werk.</para>
</listitem>

<listitem
><para
><guilabel
>Eindtijd werkdag</guilabel
>: voer de tijd in waarop u elke dag uw werk beëindigd.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>KOrganizer afspraakduur</guilabel
>: Voer de in te stellen afspraakduur in om de herinneringen in &korganizer; in te stellen die naar &korganizer; worden gekopieerd. De standaard duur is nul.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Opslag</title>

<para
>De sectie <guilabel
>Opslag</guilabel
> laat u opties kiezen voor het opslaan en archiveren van herinneringen:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Nieuwe herinneringen &amp; sjablonen</guilabel
>: Specificeert in welke agenda nieuwe herinneringen en herinneringssjablonen opgeslagen moeten worden bij het gebruiken van meerdere herinneringsagenda's:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>In standaard agenda opslaan</guilabel
>: Nieuwe herinneringen en herinneringssjablonen worden automatisch toegevoegd aan de standaard herinneringsagenda zonder vragen om bevestiging.</para>
</listitem>

<listitem>
<para
><guilabel
>Vragen welke agenda te gebruiken bij opslaan</guilabel
>: Wanneer u een nieuwe herinnering of herinneringsjabloon aanmaakt en er is meer dan één beschrijfbare herinneringsagenda, zult u worden gevraagd om te kiezen in welke agenda het op te slaan. merk op dat wanneer herinneringen opgeslagen worden bij aflopen, ze altijd zonder vragen opgeslagen worden in de standaard gearchiveerde herinneringsagenda.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Gearchiveerde herinneringen</guilabel
>-groepsvak: Deze opties besturen de opslag van gearchiveerde herinneringen in het standaard herinneringsagenda-archief.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Behoud herinneringen na afloop</guilabel
>: Selecteer deze optie om afgelopen en verwijderde herinneringen te archiveren. Deactiveer het om geen herinneringen op te slaan nadat ze niet meer actief zijn. Merk op dat verwijderde herinneringen alleen gearchiveerd worden als ze eerder zijn afgelopen. Als u een herinnering verwijdert voordat deze ooit is geactiveerd wordt deze weggegooid.</para>
</listitem>

<listitem
><para
><guilabel
>Discard archived alarms after</guilabel
>: Set the number of days to store expired and deleted alarms in the archive, after which they are permanently deleted.</para>
</listitem>

<listitem
><para
><guibutton
>Clear archived alarms</guibutton
>: This button discards all currently archived alarms from the default archived alarm calendar. (Other archived alarm calendars are left unchanged in case they are shared with other people.) This has no effect on alarms which subsequently expire or are deleted; they will continue to be archived according to the selected options.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

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

<para
>The <guilabel
>Email</guilabel
> section lets you choose options for sending and addressing email alarms:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Email client</guilabel
>: Specify the email client to be used to send email alarms:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: When an email alarm is triggered, the email is sent using &kmail; (which is started first if necessary) as follows:</para>

<itemizedlist>
<listitem
><para
>Als de versie van &kmail; hoger of gelijk is aan 1.7, wordt de e-mail automatisch verzonden.</para>
</listitem>

<listitem
><para
>If &kmail; is an older version, the email is added to &kmail;'s <filename
>outbox</filename
> folder for later transmission.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: When an email alarm is triggered, the email is sent automatically using &Sendmail;. This option will only work if your system is configured to use &Sendmail;, or a &Sendmail; compatible mail transport agent such as <application
>postfix</application
> or <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Copy sent emails into &kmail;'s sent-items folder</guilabel
>: Select this option if, every time an email alarm is triggered, you want a copy of the transmitted email to be stored in &kmail;'s <filename
>sent-items</filename
> folder.</para>

<note
><para
>This option is not available when &kmail; is selected as the email client, since &kmail; automatically does this.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Notify when remote emails are queued</guilabel
>: Select this option to display a notification whenever an email alarm queues an email for sending to a remote system. This may be useful if, for example, you have a dial-up connection, or email is queued in &kmail;'s <filename
>outbox</filename
> folder, so that you can ensure that you do whatever is needed to actually transmit the email.</para>
</listitem>

<listitem>
<para
>Select your email address to be used as the sender's address in email alarms:</para>

<itemizedlist>
<listitem
><para
>Select <guilabel
>From</guilabel
> to enter an email address.</para>
</listitem>

<listitem
><para
>Select <guilabel
>Use address from System Settings</guilabel
> to use the email address which is configured in the &kde; System Settings.</para>
</listitem>

<listitem
><para
>Select <guilabel
>Use &kmail; identities</guilabel
> to be able to choose at the time you configure an email alarm which of &kmail;'s email identities to use. &kmail;'s default identity will be used for alarms which were already configured before you selected this option.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Select your email address to be used for sending blind copies of email alarms to yourself when the <guilabel
>Copy email to self</guilabel
> option is selected:</para>

<itemizedlist>
<listitem
><para
>Select <guilabel
>Bcc</guilabel
> to enter an email address. If blind copies are to be sent to your account on the computer which &kalarm; runs on, you could simply enter your user login name here.</para>
</listitem>

<listitem
><para
>Select <guilabel
>Use address from System Settings</guilabel
> to use the email address which is configured in the &kde; System Settings.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

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

<para
>The <guilabel
>View</guilabel
> section lets you control some aspects of &kalarm;'s appearance. In the <guilabel
>General</guilabel
> tab:</para>
<itemizedlist>

<listitem>
<para
><guilabel
>Show in system tray</guilabel
>: When selected, the system tray icon is displayed while &kalarm; is running. In this mode, closing the system tray icon closes all &kalarm; main windows, and if no message windows are visible, quits the application.</para>
</listitem>

<listitem>
<para
><guilabel
>System Tray Tooltip</guilabel
> group box: These options control what information is shown in the tooltip which appears when the mouse cursor hovers over &kalarm;'s system tray icon.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Show next 24 hours' alarms</guilabel
>: When selected, a summary of the first few alarms due in the next 24 hours is displayed.</para>
</listitem>

<listitem>
<para
><guilabel
>Maximum number of alarms to show</guilabel
>: Deselect this option to display all of the next 24 hours' alarms. Select it to set the maximum number of alarms which will be displayed.</para>
</listitem>

<listitem>
<para
><guilabel
>Show alarm time</guilabel
>: Select this option to show the time at which each alarm is scheduled.</para>
</listitem>

<listitem>
<para
><guilabel
>Show time until alarm</guilabel
>: Select this option to show the length of time remaining before each alarm's next scheduled occurrence. The length of time is shown in hours and minutes.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Prefix</guilabel
>: Specify a symbol or text to show in front of the length of time until the alarm, to distinguish it from the time at which the alarm is scheduled.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>The <guilabel
>Alarm List</guilabel
> group box allows the selection of the colors used in the alarm list in &kalarm;'s main window, to show disabled and archived alarms.</para>
</listitem>
</itemizedlist>

<para
>The <guilabel
>Alarm Windows</guilabel
> tab contains options to control the appearance of alarm message windows.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Position windows far from mouse cursor</guilabel
>: Select this option to display alarm message windows as far away from the current mouse cursor position as possible. This minimizes the chance of accidentally acknowledging an alarm by unintentionally clicking on a button just as the message window appears.</para>
</listitem>

<listitem>
<para
><guilabel
>Center windows, delay activating window buttons</guilabel
>: Select this option to display alarm message windows in the center of the screen. To reduce the chance of accidentally acknowledging the alarm, the window's buttons are initially disabled. The delay in seconds before they become active is set in <guilabel
>Button activation delay (seconds)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Message windows have a titlebar and take keyboard focus</guilabel
>: This option controls whether alarm message windows are modal or not, &ie; whether they grab the keyboard focus when they appear. See the <link linkend="message-window"
>Alarm Message Window</link
> section for details.</para>
</listitem>
</itemizedlist>
</sect1>

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

<para
>The <guilabel
>Edit</guilabel
> section lets you choose default values for the options in the <link linkend="alarm-edit-dlg"
>Alarm Edit dialog</link
>:</para>

<itemizedlist>
<listitem
><para
>The <guilabel
>General</guilabel
> tab contains options which apply to all alarm types.</para>

<itemizedlist>
<listitem
><para
>Set the default states for the <guilabel
>Show in KOrganizer</guilabel
> and <guilabel
>Cancel if late</guilabel
> check boxes.</para>
</listitem>

<listitem
><para
>Het standaard herhalingstype instellen.</para>
</listitem>

<listitem
><para
>De standaard afhandeling kiezen voor jaarlijkse gebeurtenissen, gepland op 29 februari, bij niet-schrikkeljaren.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>The <guilabel
>Alarm Types</guilabel
> tab contains options which apply to specific types of alarm.</para>

<itemizedlist>
<listitem>
<para
>Om herinneringen te tonen:</para>

<itemizedlist>
<listitem
><para
>Set the default states for the <guilabel
>Auto-close window after this time</guilabel
> and <guilabel
>Confirm acknowledgment</guilabel
> check boxes.</para>
</listitem>

<listitem
><para
>Set the default reminder period units.</para>
</listitem>

<listitem
><para
>Set the default special display alarm actions.</para>
</listitem>

<listitem
><para
>Set the default sound options. Note that a default sound file may be specified even if the sound type is not set to <guilabel
>Sound file</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Voor herinneringen met shell-commando:</para>

<itemizedlist>
<listitem
><para
>Set the default states for the <guilabel
>Enter a script</guilabel
> and <guilabel
>Execute in terminal window</guilabel
> check boxes.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Voor herinneringen via e-mail:</para>

<itemizedlist>
<listitem
><para
>Set the default state for the <guilabel
>Copy email to self</guilabel
> check box.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>The <guilabel
>Font &amp; Color</guilabel
> tab lets you set the default appearance of alarm messages. Select their default font, and foreground and background colors.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Command Line Operation</title>

<para
>When command line parameters are supplied, &kalarm; does not display the list of scheduled alarms as described in <link linkend="using-kalarm"
>Using &kalarm;</link
> above. Command line options specific to &kalarm; may be used to perform the following operations:</para>

<itemizedlist>
<listitem
><para
>een nieuwe herinnering plannen</para>
</listitem>
<listitem
><para
>control &kalarm;'s display mode</para>
</listitem>
<listitem
><para
>hulp verkrijgen</para>
</listitem>
</itemizedlist>

<para
>Additional command line options are provided primarily to enable other programs to interface to &kalarm;. They are described in the chapter <link linkend="cmdline-interface"
>Developer's Guide to &kalarm;</link
>.</para>

<para
>The command line must only contain options applicable to one &kalarm; operation. If you want to perform multiple operations, you must invoke &kalarm; multiple times with a single set of options each time.</para>

<sect1 id="cmdline-schedule">
<title
>Een nieuwe herinnering plannen</title>

<para
>De volgende opties worden gebruikt om een nieuwe herinnering te plannen:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Optie</entry>
  <entry
>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Prompt for confirmation when the alarm message is acknowledged.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specify the path or &URL; of a file which is to be attached to the email. This option may be repeated as necessary. <option
>--mail</option
> must be specified with this option.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Herinneringvenster automatisch sluiten na verlopen tijdsinterval van de periode <option
>--late-cancel</option
>. <option
>--late-cancel</option
> moet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Systeemgeluid weergeven als bericht wordt getoond. <option
>--speak</option
>, <option
>--play</option
> en <option
>--play-repeat</option
> kunnen niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Blinde kopie van e-mailbericht naar uzelf sturen. <option
>--mail</option
> moet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>kleur</replaceable
></option
></entry>
  <entry
>Stel de achtergrondkleur van het bericht in op de gespecificeerde &Qt;-kleurnaam of de hex-code 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>kleur</replaceable
></option
></entry>
  <entry
>Stel de voorgrondkleur van het bericht in op de gespecificeerde &Qt;-kleurnaam of de hex-code 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>De herinnering uitschakelen. Het zal niet meer uitgevoerd worden totdat het handmatig geactiveerd wordt.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Disable alarm monitoring. This prevents any alarms from being triggered until you re-enable alarms or restart &kalarm;, &eg; at next login. <option
>--triggerEvent</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>commandoregel</replaceable
></option
></entry>
  <entry
>Specify a shell command to execute. If specified, this option must be the last &kalarm; option in &kalarm;'s command line. All subsequent command parameters and options are interpreted as forming the command line to execute. <option
>--file</option
> and <option
>--exec-display</option
> and <option
>--mail</option
> cannot be specified with this option. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> and <option
>--colorfg</option
> are ignored with this option.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>commandoregel</replaceable
></option
></entry>
  <entry
>Specify a shell command to execute to generate the alarm message text. If specified, this option must be the last &kalarm; option in &kalarm;'s command line. All subsequent command parameters and options are interpreted as forming the command line to execute. <option
>--exec</option
>, <option
>--file</option
> and <option
>--mail</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specify the path or &URL; of a text or image file whose contents are to form the alarm message. <option
>--exec</option
>, <option
>--exec-display</option
> and <option
>--mail</option
> cannot be specified, and <replaceable
>message</replaceable
> must not be present with this option.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Use the specified &kmail; identity as the sender of the email. <option
>--mail</option
> must be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Set the interval between repetitions of the alarm. Hours/minutes are specified in the format <replaceable
>nHnM</replaceable
>, where <replaceable
>n</replaceable
> is a number, &eg; 3H30M. Other time periods are specified in the format <replaceable
>nX</replaceable
>, where <replaceable
>n</replaceable
> is a number and <replaceable
>X</replaceable
> is one of the following letters: Y (years), M (months), W (weeks), D (days). If <option
>--recurrence</option
> is also specified, Y (years) and M (months) are not allowed. Mandatory if <option
>--repeat</option
> or <option
>--until</option
> is specified.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Show the alarm as an event in &korganizer;'s active calendar.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Cancel the alarm if it cannot be triggered within the specified <replaceable
>period</replaceable
> after the correct time. Hours/minutes are specified in the format <replaceable
>nHnM</replaceable
>, where <replaceable
>n</replaceable
> is a number, &eg; 3H30M. Other time periods are specified in the format <replaceable
>nX</replaceable
>, where <replaceable
>n</replaceable
> is a number and <replaceable
>X</replaceable
> is one of the following letters: W (weeks), D (days). The default value of <replaceable
>period</replaceable
> is 1 minute.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Trigger the alarm every time you log in. <option
>--interval</option
>, <option
>--repeat</option
> and <option
>--until</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>adres</replaceable
></option
></entry>
  <entry
>Send an email to the specified address. This option may be repeated as necessary. <option
>--exec</option
>, <option
>--exec-display</option
> and <option
>--file</option
> cannot be specified with this option. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> and <option
>--colorfg</option
> are ignored with this option.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specify the path or &URL; of an audio file to be played once, either as an audio alarm or when the alarm message is displayed. <option
>--play-repeat</option
>, <option
>--beep</option
> and <option
>--speak</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specify the path or &URL; of an audio file to be played repeatedly, either until <guilabel
>Stop Play</guilabel
> is used, or for as long as the alarm message is displayed. <option
>--play</option
>, <option
>--beep</option
> and <option
>--speak</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Set the alarm to recur. Specify the recurrence using iCalendar syntax (defined in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), &eg; <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. <option
>--until</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>aantal</replaceable
></option
></entry>
  <entry
>Set the number of times the alarm should be triggered, or if a recurrence is specified with <option
>--recurrence</option
>, the number of times the alarm should be triggered each time <option
>--recurrence</option
> activates it (&ie; a repetition within a recurrence). If <option
>--recurrence</option
> is not present, specify -1 to repeat the alarm indefinitely. <option
>--interval</option
> must be, and <option
>--until</option
> cannot be, specified with this option.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Output a reminder alarm the specified length of time before or after the main alarm and each of its recurrences (if any). The <replaceable
>period</replaceable
> is specified in the same format as described for <option
>--late-cancel</option
>. By default, the reminder will occur before the alarm. To specify a reminder after the alarm, prefix <replaceable
>period</replaceable
> with <replaceable
>+</replaceable
>, &eg; +3D. This option cannot be specified with <option
>--exec</option
>, <option
>--mail</option
> or <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Output a reminder alarm once, the specified length of time before or after the first recurrence of the alarm. No reminder will be displayed before or after subsequent recurrences (if any). The <replaceable
>period</replaceable
> is specified in the same format as described for <option
>--reminder</option
>. This option cannot be specified with <option
>--exec</option
>, <option
>--mail</option
> or <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Speak the message when it is displayed. This option requires &jovie; to be installed and configured, together with a compatible speech synthesizer. <option
>--beep</option
>, <option
>--play</option
> and <option
>--play-repeat</option
> cannot be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>onderwerp</replaceable
></option
></entry>
  <entry
>The subject line of the email. <option
>--mail</option
> must be specified with this option.</entry>
</row>
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>datum/tijd</replaceable
></option
></entry>
  <entry
>Trigger alarm on the date or at the date/time specified. Specify a date without a time in the format <replaceable
>yyyy-mm-dd [TZ]</replaceable
>; specify a date and time by <replaceable
>[[[yyyy-]mm-]dd-]hh:mm [TZ]</replaceable
> (where omitted, date fields default to the values for today). If no time zone is specified, the local system time zone is assumed. If a time zone specifier <replaceable
>TZ</replaceable
> is present, it may be the name of a system time zone (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representing the UTC time zone, or <userinput
>Clock</userinput
> to use the local computer clock and ignore time zones.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>percentage</replaceable
></option
></entry>
  <entry
>Set the audio volume for playing the audio file. This option can only be used when <option
>--play</option
> or <option
>--play-repeat</option
> is specified.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>datum/tijd</replaceable
></option
></entry>
  <entry
>Repeat the alarm until the date or date/time specified. Specify the date or date/time using the same syntax as for <option
>--time</option
>. Note that if <option
>--time</option
> is specified, the time zone will be taken from its value and no time zone may be included in the <option
>--until</option
> value. <option
>--interval</option
> must be, and <option
>--repeat</option
> and <option
>--recurrence</option
> cannot be, specified with this option.</entry>
</row>
<row>
  <entry
><replaceable
>bericht</replaceable
></entry>
  <entry
>Te tonen berichttekst of, als <option
>--mail</option
> opgegeven is, de inhoud van het e-mailbericht.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Either a message text, <option
>--file</option
>, <option
>--exec</option
>, <option
>--exec-display</option
>, <option
>--play</option
> or <option
>--play-repeat</option
> must be specified; except as noted above, all the options are optional.</para>

<para
>Twee verschillende voorbeelden om een bericht met meerdere regels en een rode achtergrond te tonen op de 27ste van deze maand zijn:</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>"Remember to\nSTOP"</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>"Remember to\nSTOP"</replaceable></option></userinput>
</screen>
</informalexample>

</sect1>

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

<para
>The following options are used to display the <link linkend="alarm-edit-dlg"
>Alarm Edit dialog</link
>, or to control &kalarm;'s display mode.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Optie</entry>
  <entry
>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Display the Alarm Edit dialog to edit the alarm with the specified event ID.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Display the Alarm Edit dialog, in order to edit a new audio alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>De dialoog om alarmen te bewerken tonen, om een nieuwe commando-herinnering te maken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Display the Alarm Edit dialog, in order to edit a new display alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Display the Alarm Edit dialog, in order to edit a new email alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>sjabloonnaam</replaceable
></option
></entry>
  <entry
>Display the Alarm Edit dialog, preset with the alarm template of the specified name, in order to edit a new alarm.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>&kalarm; als een pictogram tonen in het systeemvak.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="cmdline-help">
<title
>Help-opties</title>

<para
>De volgende help-opties gelden voor alle &kde;-programma's:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Optie</entry>
  <entry
>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Een korte helptekst met opties tonen.</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Shows numerous generic &Qt;-specific options.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Shows numerous generic &kde;-specific options.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Alle opties tonen.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>De namen en e-mailadressen van de &kalarm;-auteurs tonen.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--version</option
></entry>
  <entry
>De huidige versies van de &Qt;-bibliotheek, &kde; en &kalarm; tonen.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Licentie-informatie tonen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

<chapter id="developers">
<title
>Developer's Guide to &kalarm;</title>

<para
>&kalarm; provides an interface to allow other applications to request the following functions:</para>

<itemizedlist>
<listitem
><para
>een nieuwe herinnering plannen</para
></listitem>
<listitem
><para
>een reeds geplande herinnering annuleren</para
></listitem>
<listitem
><para
>een reeds geplande herinnering activeren</para
></listitem>
<listitem
><para
>de dialoog om alarmen te bewerken tonen</para
></listitem>
</itemizedlist>

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

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

<para
>The &DBus; calls described in this document are all implemented in &kalarm;'s <constant
>/kalarm</constant
> &DBus; object path. The interface is defined in the files <filename
>org.kde.kalarm.kalarm.xml</filename
> and <filename
>kalarmiface.h</filename
>.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>Annuleer een reeds geplande herinnering.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Specificeert de unieke ID van de te annuleren gebeurtenis.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

<para
><function
>cancelEvent()</function
> is een &DBus;-aanroep om de gespecificeerde herinnering te annuleren. &kalarm; verwijdert de herinnering uit de agenda zonder het te tonen of uit te voeren.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>activeert een reeds geplande herinnering.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>eventID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Specificeert de unieke ID van de te activeren gebeurtenis.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

<para
><function
>triggerEvent()</function
> is een &DBus;-aanroep om het onmiddelijk tonen of uitvoeren van de gespecificeerde herinnering te activeren (onafhankelijk van welke tijd het was gepland). &kalarm; haalt de herinnering uit de agenda en toont het of voert het uit.</para>

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

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>plan een nieuw herinneringsbericht.</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
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>bericht</parameter
></term>
<listitem>
<para
>Specifies the text of the message to be scheduled, or if <parameter
>flags</parameter
> has the <userinput
>DISPLAY_COMMAND</userinput
> bit set, specifies the command line to execute to generate the message text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specifies the scheduled date, or date and time, at which the message should be displayed. For a date-only alarm, the string should be in the format <replaceable
>YYYY-MM-DD [TZ]</replaceable
> (as returned by <methodname
>QDate::toString(Qt::ISODate)</methodname
>). For an alarm with a date and time, the string should be in the format <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (as returned by <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) or <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (as returned by <methodname
>QTime::toString(Qt::ISODate)</methodname
>). If no date is specified, today's date is used. Note that any seconds value is ignored.</para>

<para
>If no time zone is specified, the local system time zone is assumed. If a time zone specifier <replaceable
>TZ</replaceable
> is present, it may be the name of a system time zone (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representing the UTC time zone, or <userinput
>Clock</userinput
> to use the local computer clock and ignore time zones.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Note that not all flag bits are applicable to message alarms.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Specifies the background color for displaying the message. The string may be in the format <quote
>#RRGGBB</quote
> (as returned by <methodname
>QColor::name()</methodname
>) where RR, GG and BB are two-digit hexadecimal values for red, green and blue. Alternatively the string may be in any of the other formats accepted by <methodname
>QColor::setNamedColor()</methodname
>, such as a name from the X color database (&eg; <quote
>red</quote
> or <quote
>steelblue</quote
>). Set the string to null to specify the current default background color.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fgColor</parameter
></term>
<listitem>
<para
>Specifies the foreground color for displaying the message. The format of the string is the same as for <parameter
>bgColor</parameter
>, or alternatively set the string to null to specify the current default foreground color.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lettertype</parameter
></term>
<listitem>
<para
>Specifies the font for displaying the message. The format of the string is that output by <methodname
>QFont::toString()</methodname
>. Set the string to null to use the default message font current at the time the message is displayed.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Specifies the audio file which is to be played when the message is displayed. Set the value to null if no audio file is to be played.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify a negative value for a reminder to be displayed after the main alarm. Specify 0 if no reminder is required.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. For example, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the <parameter
>startDateTime</parameter
> parameter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specifies the number of periods (minutes/days/weeks/months/years as specified by <parameter
>recurType</parameter
>) between recurrences of the alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specifies the end date, or date and time, for recurrences of the alarm. If <parameter
>startDateTime</parameter
> includes a time, this parameter must also include a time; if <parameter
>startDateTime</parameter
> contains only a date, this parameter must also contain only a date. It must not contain a time zone specifier; the same time zone as for <parameter
>startDateTime</parameter
> is used to interpret this parameter's value.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specifies the number of sub-repetitions of the alarm, including the initial occurrence.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beschrijving</title>
<para
><function
>scheduleMessage()</function
> is a &DBus; call to schedule the specified alarm message for display at the specified date and time. It has three forms. The most general form allows an arbitrary recurrence to be specified &ndash; use this also for non-repeating alarms. The other forms provide convenient access to a restricted set of alarm recurrence types, one specifying a repetition count and the other an end time.</para>

<para
>If the scheduled time (including any repetitions) has already passed, &kalarm; immediately displays the message (unless the <parameter
>lateCancel</parameter
> value indicates that it is now too late to display the alarm, in which case &kalarm; ignores the request). If the scheduled time (or a repetition) is in the future, &kalarm; adds the alarm message to the default active alarm calendar for later display.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>schedule a new alarm which displays the contents of a text or image file.</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
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>URL-adres</parameter
></term>
<listitem>
<para
>Specifies the text or image file whose contents are to be displayed in the message to be scheduled.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specifies the scheduled date, or date and time, at which the message should be displayed. For a date-only alarm, the string should be in the format <replaceable
>YYYY-MM-DD [TZ]</replaceable
> (as returned by <methodname
>QDate::toString(Qt::ISODate)</methodname
>). For an alarm with a date and time, the string should be in the format <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (as returned by <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) or <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (as returned by <methodname
>QTime::toString(Qt::ISODate)</methodname
>). If no date is specified, today's date is used. Note that any seconds value is ignored.</para>

<para
>If no time zone is specified, the local system time zone is assumed. If a time zone specifier <replaceable
>TZ</replaceable
> is present, it may be the name of a system time zone (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representing the UTC time zone, or <userinput
>Clock</userinput
> to use the local computer clock and ignore time zones.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Note that not all flag bits are applicable to file alarms.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Specifies the background color for displaying the file. The string may be in the format <quote
>#RRGGBB</quote
> (as returned by <methodname
>QColor::name()</methodname
>) where RR, GG and BB are two-digit hexadecimal values for red, green and blue. Alternatively the string may be in any of the other formats accepted by <methodname
>QColor::setNamedColor()</methodname
>, such as a name from the X color database (&eg; <quote
>red</quote
> or <quote
>steelblue</quote
>). Set the string to null to specify the current default background color.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Specifies the audio file which is to be played when the message is displayed. Set the value to null if no audio file is to be played.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify a negative value for a reminder to be displayed after the main alarm. Specify 0 if no reminder is required.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. For example, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the <parameter
>startDateTime</parameter
> parameter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specifies the number of periods (minutes/days/weeks/months/years as specified by <parameter
>recurType</parameter
>) between recurrences of the alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specifies the end date, or date and time, for recurrences of the alarm. If <parameter
>startDateTime</parameter
> includes a time, this parameter must also include a time; if <parameter
>startDateTime</parameter
> contains only a date, this parameter must also contain only a date. It must not contain a time zone specifier; the same time zone as for <parameter
>startDateTime</parameter
> is used to interpret this parameter's value.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specifies the number of sub-repetitions of the alarm, including the initial occurrence.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleFile()</function
> is a &DBus; call to schedule the specified text or image file for display at the specified date and time. Apart from specifying a file path or &URL; and omitting the foreground color and font, its usage is identical to <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - see the description of that function for further details.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>een nieuwe herinnering plannen die een shellcommando uitvoert.</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
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>commandLine</parameter
></term>
<listitem>
<para
>Specificeert het commando waarvan de uitvoering moet worden gepland. De parameter <parameter
>flags</parameter
> geeft aan of deze parameter een shell-commandoregel bevat of een commandoscript.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specifies the scheduled date, or date and time, at which the message should be displayed. For a date-only alarm, the string should be in the format <replaceable
>YYYY-MM-DD [TZ]</replaceable
> (as returned by <methodname
>QDate::toString(Qt::ISODate)</methodname
>). For an alarm with a date and time, the string should be in the format <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (as returned by <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) or <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (as returned by <methodname
>QTime::toString(Qt::ISODate)</methodname
>). If no date is specified, today's date is used. Note that any seconds value is ignored.</para>

<para
>If no time zone is specified, the local system time zone is assumed. If a time zone specifier <replaceable
>TZ</replaceable
> is present, it may be the name of a system time zone (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representing the UTC time zone, or <userinput
>Clock</userinput
> to use the local computer clock and ignore time zones.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Note that not all flag bits are applicable to command alarms.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. For example, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the <parameter
>startDateTime</parameter
> parameter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specifies the number of periods (minutes/days/weeks/months/years as specified by <parameter
>recurType</parameter
>) between recurrences of the alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specifies the end date, or date and time, for recurrences of the alarm. If <parameter
>startDateTime</parameter
> includes a time, this parameter must also include a time; if <parameter
>startDateTime</parameter
> contains only a date, this parameter must also contain only a date. It must not contain a time zone specifier; the same time zone as for <parameter
>startDateTime</parameter
> is used to interpret this parameter's value.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specifies the number of sub-repetitions of the alarm, including the initial occurrence.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleCommand()</function
> is a &DBus; call to schedule the specified shell command line, or command script, for execution at the specified date and time. Apart from specifying a command and omitting the message color, font and audio file parameters, its usage is identical to <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - see the description of that function for further details.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>een nieuwe herinnering plannen die een e-mail stuurt.</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
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>fromID</parameter
></term>
<listitem>
<para
>De te gebruiken identiteit van &kmail; als de afzender van de e-mail. Indien leeg, zal het e-mailadres van de afzender dat in de <link linkend="preferences-email"
>E-mailvoorkeuren</link
> in &kalarm; is ingesteld worden gebruikt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>adressen</parameter
></term>
<listitem>
<para
>Een door kommagescheiden lijst met e-mailadressen van ontvangers.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>onderwerp</parameter
></term>
<listitem>
<para
>Specificeert de regel met het onderwerp van de e-mail.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bericht</parameter
></term>
<listitem>
<para
>Specifies the email message body.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bijlagen</parameter
></term>
<listitem>
<para
>A comma-separated list of paths or &URL;s of files to send as email attachments.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specifies the scheduled date, or date and time, at which the message should be displayed. For a date-only alarm, the string should be in the format <replaceable
>YYYY-MM-DD [TZ]</replaceable
> (as returned by <methodname
>QDate::toString(Qt::ISODate)</methodname
>). For an alarm with a date and time, the string should be in the format <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (as returned by <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) or <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (as returned by <methodname
>QTime::toString(Qt::ISODate)</methodname
>). If no date is specified, today's date is used. Note that any seconds value is ignored.</para>

<para
>If no time zone is specified, the local system time zone is assumed. If a time zone specifier <replaceable
>TZ</replaceable
> is present, it may be the name of a system time zone (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representing the UTC time zone, or <userinput
>Clock</userinput
> to use the local computer clock and ignore time zones.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Note that not all flag bits are applicable to email alarms.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. For example, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the <parameter
>startDateTime</parameter
> parameter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specifies the number of periods (minutes/days/weeks/months/years as specified by <parameter
>recurType</parameter
>) between recurrences of the alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specifies the end date, or date and time, for recurrences of the alarm. If <parameter
>startDateTime</parameter
> includes a time, this parameter must also include a time; if <parameter
>startDateTime</parameter
> contains only a date, this parameter must also contain only a date. It must not contain a time zone specifier; the same time zone as for <parameter
>startDateTime</parameter
> is used to interpret this parameter's value.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specifies the number of sub-repetitions of the alarm, including the initial occurrence.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleEmail()</function
> is a &DBus; call to schedule the specified email for sending at the specified date and time. Apart from specifying the email header and contents and omitting the message color, font and audio file parameters, its usage is identical to <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - see the description of that function for further details.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>een nieuwe herinnering plannen die een shellcommando uitvoert.</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
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Specificeert het geluidsbestand dat afgespeeld moet worden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>volumePercent</parameter
></term>
<listitem>
<para
>Specifies the volume level to use, as a percentage of full volume. Specify -1 to use the default volume.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specifies the scheduled date, or date and time, at which the message should be displayed. For a date-only alarm, the string should be in the format <replaceable
>YYYY-MM-DD [TZ]</replaceable
> (as returned by <methodname
>QDate::toString(Qt::ISODate)</methodname
>). For an alarm with a date and time, the string should be in the format <replaceable
>YYYY-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (as returned by <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) or <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (as returned by <methodname
>QTime::toString(Qt::ISODate)</methodname
>). If no date is specified, today's date is used. Note that any seconds value is ignored.</para>

<para
>If no time zone is specified, the local system time zone is assumed. If a time zone specifier <replaceable
>TZ</replaceable
> is present, it may be the name of a system time zone (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representing the UTC time zone, or <userinput
>Clock</userinput
> to use the local computer clock and ignore time zones.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flags</parameter
></term>
<listitem>
<para
>Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Note that not all flag bits are applicable to command alarms.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. For example, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the <parameter
>startDateTime</parameter
> parameter.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specifies the number of periods (minutes/days/weeks/months/years as specified by <parameter
>recurType</parameter
>) between recurrences of the alarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specifies the end date, or date and time, for recurrences of the alarm. If <parameter
>startDateTime</parameter
> includes a time, this parameter must also include a time; if <parameter
>startDateTime</parameter
> contains only a date, this parameter must also contain only a date. It must not contain a time zone specifier; the same time zone as for <parameter
>startDateTime</parameter
> is used to interpret this parameter's value.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specifies the number of sub-repetitions of the alarm, including the initial occurrence.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleAudio()</function
> is a &DBus; call to schedule the specified audio file to be played at the specified date and time. Apart from specifying a volume and omitting the message color and font parameters, its usage is identical to <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - see the description of that function for further details.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>bewerken</refentrytitle>
</refmeta>
<refnamediv>
<refname
>bewerken</refname>
<refpurpose
>Display the <link linkend="alarm-edit-dlg"
>Alarm Edit dialog</link
> to edit an alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable>eventID</replaceable>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>eventID</parameter
></term>
<listitem>
<para
>Specifies the unique ID of the event to be edited.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Teruggegeven waarde</title>
<para
><returnvalue
>onwaar</returnvalue
> als de gespecificeerde herinnering niet gevonden kon worden of alleen-lezen is, anders <returnvalue
>waar</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

<para
><function
>edit()</function
> is een &DBus;-aanroep om de <link linkend="alarm-edit-dlg"
>dialoog Herinnering bewerken</link
> te tonen om de gespecificeerde herinnering te bewerken.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Display the <link linkend="alarm-edit-dlg"
>Alarm Edit dialog</link
> to edit a new alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>type</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>sjabloonNaam</replaceable
>)
</synopsis>

<refsect2>
<title
>Parameters</title>
<variablelist>
<varlistentry>
<term
><parameter
>type</parameter
></term>
<listitem>
<para
>Specificeert het type herinnering. De toegestane waarde zijn DISPLAY, COMMAND, EMAIL, AUDIO. Deze worden gedefinieerd in klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>sjabloonNaam</parameter
></term>
<listitem>
<para
>Specificeert de naam van een herinneringssjabloon waarop de nieuwe herinnering gebaseerd moet worden.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Teruggegeven waarde</title>
<para
><returnvalue
>false</returnvalue
> als <parameter
>type</parameter
> een ongeldige waarde heeft of geen sjabloon met de naam <parameter
>sjabloonNaam</parameter
> gevonden kan worden; anders <returnvalue
>true</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

<para
><function
>editNew()</function
> is a &DBus; call to display the <link linkend="alarm-edit-dlg"
>Alarm Edit dialog</link
> to edit a new alarm. If an alarm type is specified as a parameter, a blank dialog is displayed. Alternatively, if an alarm template name is specified as a parameter, the dialog is preset with details from the template.</para>

</refsect1>
</refentry>

</sect1>

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

<para
>Opdrachtregelopties worden geboden om andere programma's in staat te stellen &kalarm; op te starten als het nog niet actief is, om geplande herinneringen af te laten gaan of te annuleren of nieuwe te plannen. De reden voor het gebruik van opdrachtregelopties voor dit doel is dat als &kalarm; zonder deze opties zou worden gestart en &DBus;-verzoeken verzendt, het zou opstarten in zijn  standaard grafische modus, wat duidelijk ongewenst is voor een verzoek tussen programma's.</para>

<note
><para
>Programma's zouden eerst moeten controleren of &kalarm; al actief is; zo ja, dan zouden ze in plaats daarvan &DBus;-aanroepen moeten gebruiken om deze bewerkingen aan te vragen.</para
></note>

<para
>De opties voor de commandoregel voor het plannen van een nieuwe herinnering zijn zoals beschreven in de sectie <link linkend="cmdline-operation"
>werken vanaf de opdrachtregel</link
>. De opties voor af laten lopen en annuleren van geplande herinneringen zijn als volgt:</para>

<note
><para
>Normale gebruikers kunnen ook, als zij dat willen, deze opties op de opdrachtregel gebruiken (aannemend dat ze de nodige parameters kunnen leveren).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Optie</entry>
  <entry
>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Annuleer de herinnering met de gespecificeerde gebeurtenis-id. <option
>--triggerEvent</option
> kan niet worden gespecificeerd bij deze optie.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Start de herinnering met de gespecificeerde gebeurtenis-id. De uitgevoerde actie is hetzelfde als voor de aanroep van <link linkend="triggerEvent"
>triggerEvent()</link
> &DBus;. <option
>--cancelEvent</option
> kan niet worden gespecificeerd bij deze optie.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Voorbeelden zijn:</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
>Vragen en antwoorden</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Welke instellingenbestanden gebruikt &kalarm;?</para>
</question>
<answer>
<para
><filename
>$KDEHOME/share/config/kalarmrc</filename
> bevat uw voorkeuren voor &kalarm;.</para>
<para
><filename
>$KDEHOME/share/config/kresources/alarms/stdrc</filename
> bevat uw configuratie van de herinneringsagenda.</para>

<para
>($<envar
>KDEHOME</envar
> is gewoonlijk <filename class="directory"
>&tilde;/.kde</filename
> of iets soortgelijks.)</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Waar worden de herinneringen van &kalarm; opgeslagen?</para>
</question>
<answer>

<para
>De namen van de agendabestanden die &kalarm; de eerste keer dat het wordt uitgevoerd aanmaakt zijn als volgt (maar kunnen overschreven worden door items in de sectie <parameter
>General</parameter
> van het voorkeursbestand van &kalarm;):</para>

<itemizedlist>
<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
> bevat de actieve herinneringen (overschrijfbaar door het item <parameter
>Calendar</parameter
>).</para>
</listitem>

<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/expired.ics</filename
> bevat verlopen herinneringen (overschrijfbaar door het item <parameter
>ExpiredCalendar</parameter
>).</para>
</listitem>

<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/template.ics</filename
> bevat de herinneringssjablonen (overschrijfbaar door het item <parameter
>TemplateCalendar</parameter
>).</para>
</listitem>
</itemizedlist>

<para
>U kunt uitzoeken welke agendabestanden nu worden gebruikt door de details van elke agenda in de lijst van agendaherinneringen te bekijken. De bestandsnamen zijn opgeslagen in het configuratiebestand van agendaherinneringen.</para>

<para
>Details van nu getoonde herinneringen worden opgeslagen in het agendabestand <filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>In welk formaat worden herinneringen opgeslagen?</para>
</question>
<answer>
<para
>The calendar files in which &kalarm; stores its alarms are text files whose format is defined by the document <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. This is the standard format used by all kdepim applications. &kalarm; uses certain non-standard properties, in conformance with RFC2445. These are documented in the <filename
>DESIGN.html</filename
> file which is distributed with &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Wat is het programma <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> is een klein hulpprogramma waarvan de functie het automatisch starten van &kalarm; bij aanmelden is.</para>

<para
>&kalarm; is usually restored by the session manager at login (to redisplay its windows in the same state as they were when you logged off). But if it was not running when you logged off, it would not be started by the session manager and therefore needs to be autostarted. The problem is that when an application is both session managed and autostarted, there is no guarantee as to which will occur first. If autostart gets in first, it will prevent the session manager from restoring the application's state.</para>

<para
>Om dit probleem te vermijden wordt <application
>kalarmautostart</application
> automatisch gestart bij aanmelden in plaats van &kalarm;. Alles wat het doet is een kort moment wachten (om te verzekeren dat de sessiemanager tijd heeft om zijn taak te verrichten) alvorens &kalarm; te starten waarna het zich afsluit.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Dankbetuigingen en licentie</title>

<para
>&kalarm; </para>
<para
>Programma copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 2010, 2011 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Documentatie copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 &David.Jarvie; &David.Jarvie.mail; </para>

&meld.fouten;&vertaling.niels;&vertaling.freek; 
&underFDL; &underGPL; <para
>Dank aan de auteur van de &kde; 1 KAlarm applicatie, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, die vriendelijk toestemming gaf om de naam &kalarm; voor deze applicatie te gebruiken, die beschikbaar is vanaf &kde; 2. </para>

</chapter>

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

<sect1 id="getting-kalarm">
<title
>Hoe &kalarm; te verkrijgen</title>
&install.intro.documentation; <para
>&kalarm; is ook beschikbaar als standalone pakket voor &kde; 4, evenals voor oudere versies voor &kde; 3 en &kde; 2 vanaf <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
> </para>

</sect1>

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

<para
>&kalarm; vereist dat de standaard &kde; bibliotheken zijn geïnstalleerd (de pakketten <filename
>kdelibs</filename
> en <filename
>kdepimlibs</filename
>) plus het pakket <filename
>kdebase/runtime</filename
>. Om vanuit de broncode te compileren, hebt u ook de relevante bibliotheekontwikkelpakketten nodig en het &Qt; ontwikkelpakket.</para>

<para
>De volgende optionele pakketten, als ze zijn geïnstalleerd, vergroten het nut van &kalarm;:</para>

<itemizedlist>
<listitem
><para
>U kunt &kalarm; herinneringsberichten laten uitspreken wanneer ze worden getoond met behulp van &jovie; (uit het pakket kdeaccessibility), als dat is geïnstalleerd en geconfigureerd samen met een compatibele spraaksynthesizer.</para>
</listitem>
</itemizedlist>

<para
>U kunt een lijst met wijzigingen vinden in het bestand <filename
>Changelog</filename
> of bij <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Compilatie en installatie</title>

<para
>Als u geen geschikt voorgecompileerd binair pakket kunt krijgen, moet u &kalarm; zelf vanuit de broncode compileren. Haal het broncodepakketbestand <filename
>kdepim-x.x.tar.bz2</filename
> of <filename
>kalarm-x.x.tar.bz2</filename
> (of vergelijkbaar) op, afhankelijk van of u &package; of alleen &kalarm; wilt installeren. Pak het uit in een nieuwe map met een commando lijkend op <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>package.tar.bz2</replaceable
></option
></userinput
> en ga naar de map die is aangemaakt.</para>
&install.compile.documentation; <warning
><para
>Als u &kalarm; installeert in een map anders dan waar &kde; is geïnstalleerd, zal het niet goed draaien tenzij u zijn locatie aan &kde; bekend maakt. Hiervoor moet u de omgevingsvariabele <envar
>KDEDIRS</envar
> vooraf laten gaan met locatie van &kalarm;, elke keer voordat u &kde; start.</para>

<para
>Als &kde; bijvoorbeeld is geïnstalleerd in <literal
>/opt/kde</literal
>, zal <envar
>KDEDIRS</envar
> normaal ingesteld zijn op <literal
>/etc/opt/kde:/opt/kde</literal
>. Als u &kalarm; installeert in <literal
>/usr/local</literal
>, dan is het nodig om <envar
>KDEDIRS</envar
> in te stellen op <literal
>/usr/local:/etc/opt/kde:/opt/kde</literal
> voor het starten van &kde;.</para
></warning>

<para
>The standalone version of &kalarm; has a special configuration option which allows you to select which languages documentation is to be installed for by specifying a language code, or a list of language codes, as a parameter to <command
>./configure</command
>. By default, documentation in all available languages is installed. A list of documentation languages included in the package, together with their codes, is in the <filename
>DOC-LANGUAGES</filename
> file. For example, to install only French and British English documentation:</para>

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

<para
>Opmerking: deze optie heeft geen effect op de geïnstalleerde vertalingen van de (grafische) gebruikersinterface.</para>

</sect1>

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

<para
>Er is geen speciale configuratie nodig om &kalarm; uit te voeren in een &kde;-omgeving. Vanaf dat u &kalarm; de eerste keer opstart, zal deze elke keer dat u zich aanmeldt opstarten, opdat geplande alarmen in het oog gehouden kunnen worden.</para>

<para
>Om &kalarm; uit te voeren in een niet-&kde; omgeving, moet u controleren dat &kalarm; automatisch wordt opgestart wanneer u zichzelf aanmeldt. Gedetailleerde instructies vindt u in het <filename
>INSTALL</filename
>-bestand, dat meegeleverd wordt met &kalarm;.</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:
-->