<?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 id="kalarm" lang="&language;">

<bookinfo id="kalarminfo">
<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>

&Niels.Reedijk;&Ruben.Van.Laerhoven;&Freek.de.Kruijf; 
</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

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

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

<abstract>
<para
>&kalarm; 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
>Lijst met herinneringen</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 (zie <link linkend="using-calendars"
>Agenda's gebruiken</link
>).</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. Selecteer daarna de optie <guilabel
>Herinnering tonen</guilabel
>. 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 optie <guilabel
>E-mail herinnering</guilabel
>. 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
>Sleep, om een nieuwe herinnering met shell-commando aan te maken de tekst van een script, die begint met <quote
>#!</quote
>, naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Selecteer dan de optie <guilabel
>E-mail</guilabel
>. Het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> zal dan reeds de tekst van het script bevatten.</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
>Sleep, om een tekstherinnering aan te maken, elke stuk tekst naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Indien gevraagd, selecteer dan de optie <guilabel
>Weergaveherinnering</guilabel
>. Dit opent <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> met de tekst van de herinnering al ingesteld.</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
>Selecteer in het menu-item <menuchoice
> <guimenu
>Bestand</guimenu
> <guimenuitem
>Nieuw</guimenuitem
> <guimenuitem
>Nieuwe herinnering van sjabloon</guimenuitem
> </menuchoice
>, 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</guimenuitem
> <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 id="using-calendars">
<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, tenzij <guilabel
>Voor uitgestelde herinneringen uitvoeren</guilabel
> is geactiveerd.</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 sub-herhalingen 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 sub-herhalingen. Als sub-herinneringen zijn ingesteld, zullen ze worden gestart als normaal 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. 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. In het geval van een geluidsherinnering, druk voor de tweede keer op de knop <guibutton
>Proberen</guibutton
> om het afspelen van het geluidsbestand te stoppen.</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
>Het pictogram van &kalarm; in het systeemvak is standaard automatisch verborgen wanneer er geen herinneringen zijn die aflopen in de volgende 24 uur. U kunt de tijdslimiet van auto-verbergen wijzigen of altijd tonen in het pictogram tonen in het systeemmvak, met de <link linkend="preferences-view"
>Instellingendialoag</link
>. Om het pictogram te tonen wanneer het automatisch is verborgen, klik op de pijl in het systeemvak om verborgen pictogrammen te onthullen.</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
>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 te kiezen of &kalarm; bij opstarten in het systeemvak getoond moet worden of niet, gebruik <menuchoice
><guimenu
>Beeld</guimenu
> <guimenuitem
>In systeemvak tonen</guimenuitem
></menuchoice
> overeenkomstig de voorkeuren ingesteld in het tabblad <link linkend="preferences-view"
>Beeld</link
> van de Instellingendialoog</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 slaapstand</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
>Verlopen herinneringen verwijderen na</guilabel
>: Stel het aantal dagen in om verlopen en verwijderde herinneringen in het archief op te slaan, waarna ze permanent worden verwijderd.</para>
</listitem>

<listitem
><para
><guibutton
>Wis gearchiveerde herinneringen</guibutton
>: Deze knop gooit alle nu gearchiveerde herinneringen uit de standaard gearchiveerde herinneringsagenda. (Andere gearchiveerde herinneringsagenda's blijven ongewijzigd in het geval ze gedeeld worden met andere mensen.) Dit heeft geen invloed op herinneringen die vervolgens verlopen of worden verwijderd; ze zullen doorgaan om te worden gearchiveerd volgens de geselecteerde opties.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

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

<para
>De sectie <guilabel
>E-mail</guilabel
> laat u opties kiezen voor het verzenden en adresseren van herinneringen via e-mail:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>E-mailclient</guilabel
>: Specificeer de te gebruiken e-mailclient voor het verzenden van herinneringen via e-mail:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Wanneer een herinnering via e-mail afloopt, zal de e-mail verzonden worden met gebruik van &kmail; (die, indien nodig, eerst  zal worden gestart) als volgt:</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
>Als &kmail; een oudere versie is, zal de e-mail worden toegevoegd aan de <filename
>postvak-uit</filename
>-map van &kmail; voor latere verzending.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Wanneer een herinnering via e-mail afloopt, zal de e-mail automatisch met &Sendmail; verzonden worden. Deze optie zal alleen werken als uw systeem geconfigureerd is om &Sendmail; te gebruiken of een aan &Sendmail; compatibele e-mail transport-agent zoals <application
>postfix</application
> of <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Kopiëren zendt e-mails in de verzonden berichten-map van &kmail;</guilabel
>: Selecteer deze optie als, elke keer dat een herinnering via e-mail afloopt, u een kopie van de verzonden e-mail wilt opslaan in de <filename
>verzonden-berichten</filename
>-map.</para>

<note
><para
>Deze optie is niet beschikbaar wanneer &kmail; is geselecteerd als de e-mailclient, omdat &kmail; dit automatisch doet.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Melden als externe e-mailberichten in de wachtrij worden geplaatst</guilabel
>: Selecteer deze optie om een melding te geven wanneer een herinnering via e-mail een e-mail in de wachtrij zet voor verzending naar een ander systeem. Dit kan nuttig zijn als u, bijvoorbeeld, een inbel-verbinding hebt of e-mail in de wachtrij wordt gezet in de <filename
>postvak-uit</filename
>-map van &kmail;, zodat u er zeker van kunt zijn dat u dat doet wat nodig is om de e-mail daadwerkelijk te verzenden.</para>
</listitem>

<listitem>
<para
>Selecteer uw te gebruiken e-mailadres als de afzenderadres in herinneringen via e-mail:</para>

<itemizedlist>
<listitem
><para
>Selecteer <guilabel
>Van</guilabel
> om een e-mailadres in te voeren.</para>
</listitem>

<listitem
><para
>Selecteer <guilabel
>Adres uit systeeminstellingen gebruiken</guilabel
> om het e-mailadres dat is ingesteld in de Systeeminstellingen van &kde; te gebruiken.</para>
</listitem>

<listitem
><para
>Selecteer <guilabel
>Identiteiten van &kmail; gebruiken</guilabel
> om in staat te zijn, op het moment dat u een herinnering via e-mail configureert, te kiezen welke e-mail-identiteit van &kmail; u wilt gebruiken. De standaard identiteit zal worden gebruikt voor herinneringen die al zijn ingesteld voordat u deze optie selecteerde.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Selecteer uw te gebruiken e-mailadres voor het zenden van blinde kopieën van herinneringen via e-mail aan uzelf wanneer de optie <guilabel
>Kopie van e-mailbericht naar uzelf sturen</guilabel
> is geselecteerd:</para>

<itemizedlist>
<listitem
><para
>Selecteer <guilabel
>Bcc</guilabel
> om een e-mailadres in te voeren. Als blinde kopieën verzonden moeten worden naar uw account op de computer waarop &kalarm; actief is, u zou eenvoudig uw gebruikersnaam hier in kunnen voeren.</para>
</listitem>

<listitem
><para
>Selecteer <guilabel
>Adres uit systeeminstellingen gebruiken</guilabel
> om het e-mailadres dat is ingesteld in de Systeeminstellingen van &kde; te gebruiken.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

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

<para
>De sectie <guilabel
>Beeld</guilabel
> laat u enige aspecten van het uiterlijk van &kalarm; besturen. In het tabblad <guilabel
>Algemeen</guilabel
>:</para>
<itemizedlist>

<listitem>
<para
>Groepsvak <guilabel
>In systeemvak weergeven</guilabel
>: Indien geactiveerd zal het pictogram in het systeemvak worden getoond terwijl &kalarm; actief is, afhankelijk van de geselecteerde optie:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Altijd tonen</guilabel
>: Het pictogram in het systeemvak wordt altijd getoond.</para>
</listitem>

<listitem>
<para
><guilabel
>Automatisch verbergen bij geen actieve herinnering</guilabel
>: Het pictogram in het systeemvak is verborgen als er geen actieve herinneringen zijn.</para>
</listitem>

<listitem>
<para
><guilabel
>Automatisch verbergen als geen herinnering afloopt in de tijdsperiode</guilabel
>: Het pictogram in het systeemvak is verborgen als geen herinnering afloopt in de ingevoerde tijdsperiode, nu beginnend.</para>
</listitem>
</itemizedlist>

<para
>Wanneer het pictogram in het systeemvak automatisch is verborgen, kunt u het zichtbaar maken met de optie van het systeemvak om verborgen pictogrammen te tonen.</para>

<para
>Wanneer <guilabel
>In systeemvak weergeven</guilabel
> is geactiveerd, zal het sluiten van het pictogram in het systeemvak alle hoofdvensters van &kalarm; sluiten en, als er geen berichtenvensters zichtbaar zijn, sluit de toepassing.</para>
</listitem>

<listitem>
<para
>Groepsvak <guilabel
>Tekstballon in systeemvak tonen</guilabel
>: Deze opties besturen welke informatie wordt getoond in de tekstballon die verschijnt wanneer de muiscursor boven het pictogram van &kalarm; in het systeemvak staat.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Herinneringen voor de volgende 24 uur tonen</guilabel
>: Indien geselecteerd zal een samenvatting van de eerste paar herinneringen die in de volgende 24 uur aflopen worden getoond.</para>
</listitem>

<listitem>
<para
><guilabel
>Maximum aantal te tonen herinneringen</guilabel
>: Deactiveer deze optie om alle herinneringen van de volgende 24 uur te tonen. Activeer deze om het maximum aantal herinneringen die zullen worden getoond in te stellen.</para>
</listitem>

<listitem>
<para
><guilabel
>Tijd van de herinnering tonen</guilabel
>: Activeer deze optie om de tijd te tonen waarop elke herinnering is gepland.</para>
</listitem>

<listitem>
<para
><guilabel
>Resterende tijd tot herinnering tonen</guilabel
>: Activeer deze optie om de overblijvende tijd te tonen voor geplande verschijning van elke  herinnering. De overblijvende tijd wordt getoond in uren en minuten.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Prefix</guilabel
>: Specificeer een symbool of te tonen tekst vóór de overblijvende tijd tot de herinnering, om het te onderscheiden van de tijd waarop de herinnering is gepland.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Het groepsvak <guilabel
>Lijst met herinneringen</guilabel
> stelt u in staat de kleuren te selecteren van de lijst met herinneringen in het hoofdvenster van &kalarm;, om uitgeschakelde en gearchiveerde herinneringen te tonen.</para>
</listitem>
</itemizedlist>

<para
>Het tabblad <guilabel
>Herinneringsvensters</guilabel
> bevat opties om het uiterlijk van herinneringsberichtvensters te besturen.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Venster ver van de muiscursor plaatsen</guilabel
>: Activeer deze optie om herinneringsberichtvensters zo ver mogelijk van de huidige positie van de muiscursor te plaatsen. Dit minimaliseert de kans om per ongeluk een herinnering te bevestigen door onbedoeld op een knop te klikken net op het moment dat het berichtvenster verschijnt.</para>
</listitem>

<listitem>
<para
><guilabel
>Vensters in het midden, vertraging activatie knoppen</guilabel
>: Activeer deze optie om herinneringsberichtvensters in het midden van het scherm te tonen. Om de kans te verkleinen om per ongeluk de herinnering te bevestigen, worden de knoppen in het venster initieel uitgeschakeld. De vertraging in seconden voordat ze actief worden wordt ingesteld met de <guilabel
>Vertraging voor de activatie van knoppen (seconden)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Berichtenvensters hebben een titelbalk en het toetsenbord neem focus</guilabel
>: Deze optie bestuurt of herinneringsberichtvensters modaal zijn of niet, &ie; of ze het toetsenbord focus krijgt wanneer ze verschijnen. Zie de sectie <link linkend="message-window"
>Herinneringsberichtvenster</link
> voor details.</para>
</listitem>
</itemizedlist>
</sect1>

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

<para
>De sectie <guilabel
>Bewerken</guilabel
> laat u standaard waarden kiezen voor de opties in de <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
>:</para>

<itemizedlist>
<listitem
><para
>Het tabblad <guilabel
>Algemeen</guilabel
> bevat opties die van toepassing zijn op alle types herinneringen.</para>

<itemizedlist>
<listitem
><para
>Stelt de standaard statussen in voor <guilabel
>In KOrganizer tonen</guilabel
> en keuzevakjes <guilabel
>Annuleren, indien te laat</guilabel
>.</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
>Het tabblad <guilabel
>Typen herinneringen</guilabel
> bevat opties die van toepassing zijn voor specifieke typen herinneringen.</para>

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

<itemizedlist>
<listitem
><para
>Stel de standaard statussen voor <guilabel
>Venster voortaan automatisch sluiten</guilabel
> en keuzevakjes <guilabel
>Om bevestiging vragen</guilabel
>.</para>
</listitem>

<listitem
><para
>Stelt de standaard eenheid in voor herinneringsperioden.</para>
</listitem>

<listitem
><para
>Stelt de standaard eenheid in voor speciale herinneringsacties.</para>
</listitem>

<listitem
><para
>Stelt de standaard geluidsopties in.</para>
</listitem>
</itemizedlist>
</listitem>

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

<itemizedlist>
<listitem
><para
>Stelt de standaard statussen in voor <guilabel
>Voer een script in</guilabel
> en en keuzevakjes <guilabel
>Uitvoeren in terminalvenster</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

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

<itemizedlist>
<listitem
><para
>Stel de standaard status in voor het keuzevakje <guilabel
>Kopie van e-mailbericht naar uzelf sturen</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Het tabblad <guilabel
>lettertype &amp; kleur</guilabel
> laat u de standaard voor het uiterlijk van herinneringsberichten instellen. Selecteer hun standaard lettertype en voorgrond en achtergrond kleuren in.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Werking van commandoregelopdrachten</title>

<para
>Wanneer commandoregelparameters worden aangeleverd zal &kalarm; de lijst met geplande herinneringen niet tonen zoals bovenstaand beschreven in <link linkend="using-kalarm"
>&kalarm; gebruiken</link
>. Commandoregelopties specifiek voor &kalarm; kunnen worden gebruikt om de volgende bewerkingen uit te voeren:</para>

<itemizedlist>
<listitem
><para
>een nieuwe herinnering plannen</para>
</listitem>
<listitem
><para
>de weergavemodus van &kalarm; besturen</para>
</listitem>
<listitem
><para
>hulp verkrijgen</para>
</listitem>
</itemizedlist>

<para
>Extra opties voor de opdrachtregel worden primair geleverd om andere toepassingen een interface te bieden naar &kalarm;. Ze worden beschreven in het hoofdstuk <link linkend="cmdline-interface"
>Gids voor ontwerpers naar &kalarm;</link
>.</para>

<para
>De opdrachtregel moet alleen opties bevatten die van toepassing zijn op één &kalarm; bewerking. Als u meerdere bewerkingen wilt doen, dan moet u &kalarm; meerdere keren oproepen elke keer met een enkele set opties.</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
>Nogmaals vragen om bevestiging wanneer het herinneringsbericht is bevestigd.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specificeer het pad of &URL; van een bestand die een bijlage is bij de e-mail. Deze optie kan, indien nodig, herhaald worden. <option
>--mail</option
> moet gespecificeerd worden met deze optie.</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
>Schakel monitoring van herinneringen uit. Dit voorkomt elk aflopen van een herinnering totdat u herinneringen opnieuw inschakelt of &kalarm; herstart, &eg; bij volgende aanmelding. <option
>--triggerEvent</option
> kan niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>commandoregel</replaceable
></option
></entry>
  <entry
>Specificeer een uit te voeren shell-commando. Indien gespecificeerd, dan moet deze optie de laatste optie van &kalarm; zijn in de opdrachtregel van &kalarm;. Alle volgende commandoparameters en opties worden geïnterpreteerd als onderdeel van de de uit te voeren opdrachtregel. <option
>--file</option
> en <option
>--exec-display</option
> en <option
>--mail</option
> kunnen niet gespecificeerd worden met deze optie. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> en <option
>--colorfg</option
> worden genegeerd met deze optie.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>commandoregel</replaceable
></option
></entry>
  <entry
>Specificeer een uit te voeren commando om een de tekst van het herinneringsbericht te genereren. Indien gespecificeerd, dan moet deze optie de laatste optie van &kalarm; zijn in de opdrachtregel van &kalarm;. Alle volgende commandoparameters en opties worden geïnterpreteerd als onderdeel van de de uit te voeren opdrachtregel. <option
>--exec</option
>, <option
>--file</option
> en <option
>--mail</option
> kunnen niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specificeer het pad of &URL; van een tekst- of afbeeldingsbestand waarvan de inhouden het herinneringsbericht moeten vormen. <option
>--exec</option
>, <option
>--exec-display</option
> en <option
>--mail</option
> kunnen niet gespecificeerd worden en <replaceable
>bericht</replaceable
> moet niet aanwezig zijn met deze optie.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Gebruik de gespecificeerde identiteit van &kmail; als de afzender van de e-mail. <option
>--mail</option
> moet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Stel het interval tussen herhalingen van de herinnering in. Uren/minuten worden gespecificeerd in de opmaak <replaceable
>nHnM</replaceable
>, waar <replaceable
>n</replaceable
> een getal is, &eg; 3H30M. Andere tijdsperioden worden gespecificeerd in de opmaak <replaceable
>nX</replaceable
>, waar <replaceable
>n</replaceable
> een getal is en <replaceable
>X</replaceable
> is een van de volgende letters: Y (jaren), M (maanden), W (weken), D (dagen). Als <option
>--recurrence</option
> ook is gespecificeerd, zijn Y (jaren) en M (maanden) niet toegestaan. Verplicht als <option
>--repeat</option
> of <option
>--until</option
> is gespecificeerd.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Toon de herinnering als een afspraak in de actieve agenda van &korganizer;.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Annuleer de herinnering als het niet zal aflopen binnen de gespecificeerde <replaceable
>periode</replaceable
> na de juiste tijd. Uren/minuten worden gespecificeerd in de opmaak <replaceable
>nHnM</replaceable
>, waar <replaceable
>n</replaceable
> een getal is, &eg; 3H30M. Andere tijdsperiodes worden gespecificeerd in de opmaak <replaceable
>nX</replaceable
>, waar <replaceable
>n</replaceable
> een getal is en <replaceable
>X</replaceable
> is een van de volgende letters: W (weken), D (dagen). De standaard waarde van <replaceable
>periode</replaceable
> is 1 minuut.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Laat de herinnering aflopen elke keer dat u zich aanmeldt. <option
>--interval</option
>, <option
>--repeat</option
> en <option
>--until</option
> kunnen niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>adres</replaceable
></option
></entry>
  <entry
>Stuur een e-mail naar het gespecificeerde adres. Deze optie kan naar behoefte herhaald worden. <option
>--exec</option
>, <option
>--exec-display</option
> en <option
>--file</option
> kan niet worden gespecificeerd met deze optie. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> en <option
>--colorfg</option
> worden met deze optie genegeerd.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specificeer het pad of &URL; van een eenmaal af te spelen audiobestand, ofwel als een audioherinnering of wanneer het herinneringsbericht wordt getoond. <option
>--play-repeat</option
>, <option
>--beep</option
> en <option
>--speak</option
> kunnen niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Specificeer het pad of &URL; van een herhaald af te spelen audiobestand, ofwel tot <guilabel
>Afspelen stoppen</guilabel
> wordt gebruikt of zolang het herinneringsbericht wordt getoond. <option
>--play</option
>, <option
>--beep</option
> en <option
>--speak</option
> kunnen niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Stel de herinnering in om opnieuw te verschijnen. Specificeer de herhaling met iCalendar syntaxis (gedefinieerd 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
> kan niet met deze optie worden gedefinieerd.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>aantal</replaceable
></option
></entry>
  <entry
>Stel het aantal keren in dat de herinnering moet aflopen of, als een herhaling is gespecificeerd met <option
>--recurrence</option
>, het aantal keren dat de herinnering zou moeten aflopen elke keer dat <option
>--recurrence</option
> het activeert (&ie; een herhaling binnen een herhaling). Als <option
>--recurrence</option
> niet aanwezig is, specificeer -1 om de herinnering zich oneindig te laten herhalen. <option
>--interval</option
> moet en <option
>--until</option
> mag niet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Voer een herhalingsherinnering de gespecificeerde tijdsduur voor of na de hoofdherinnering uit en elk van zijn herhalingen (indien aanwezig). De <replaceable
>periode</replaceable
> is gespecificeerd in dezelfde indeling als beschreven voor <option
>--late-cancel</option
>. De herhaling zal standaard voor de herinnering plaatsvinden. Om een herhaling na de herinnering te specificeren, laat <replaceable
>periode</replaceable
> vooraf gaan met <replaceable
>+</replaceable
>, &eg; +3D. Deze optie kan niet gespecificeerd worden met <option
>--exec</option
>, <option
>--mail</option
> of <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Voer eenmalig een herhalingsherinnering de gespecificeerde tijdsduur voor of na de verschijning van de herinnering uit. Er zal geen herhaling van de worden getoond voor of na opvolgende herinneringen (indien aanwezig). De <replaceable
>periode</replaceable
> wordt gespecificeerd in dezelfde indeling als beschreven voor <option
>--reminder</option
>. Deze optie kan niet gespecificeerd worden met <option
>--exec</option
>, <option
>--mail</option
> of <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Spreek het bericht uit wanneer het wordt getond. Deze optie vereist dat &jovie; is geïnstalleerd en geconfigureerd, samen met een compatibele spraaksynthesizer. <option
>--beep</option
>, <option
>--play</option
> en <option
>--play-repeat</option
> kunnen niet worden gespecificeerd met deze optie.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>onderwerp</replaceable
></option
></entry>
  <entry
>Het onderwerpregel van het e-mailbericht. <option
>--mail</option
> moet gespecificeerd worden met deze optie.</entry>
</row>
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>datum/tijd</replaceable
></option
></entry>
  <entry
>Laat de herinnering aflopen op de gespecificeerde datum of de datum/tijd. Specificeer een datum zonder een tijd in het formaat <replaceable
>jjjj-mm-dd [TZ]</replaceable
>; specificeer een datum en tijd met <replaceable
>[[[jjjj-]mm-]dd-]hh:mm [TZ]</replaceable
> (waar weggelaten krijgen datumvelden standaard de waarden voor vandaag). Als geen tijdzone is gespecificeerd, wordt de lokale systeemtijdzone aangenomen. Als een tijdzone is gespecificeerd, <replaceable
>TZ</replaceable
>, dan kan het de naam van een systeemtijdzone zijn (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> die de UTC tijdzone representeert of <userinput
>Klok</userinput
> om de lokale computerklok te gebruiken en tijdzones te negeren.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>percentage</replaceable
></option
></entry>
  <entry
>Stel het geluidsvolume voor het afspelen van het geluidsbestand in. Deze optie kan alleen gebruikt worden wanneer <option
>--play</option
> of <option
>--play-repeat</option
> is gespecificeerd.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>datum/tijd</replaceable
></option
></entry>
  <entry
>Herhaal de herinnering tot de gespecificeerde datum of datum/tijd. Specificeer de datum of datum/tijd met gebruik van dezelfde syntaxis als voor <option
>--time</option
>. Merk op dat wanneer <option
>--time</option
> is gespecificeerd, de tijdzone genomen zal worden uit zijn waarde en geen tijdzone kan worden meegegeven in de waarde van <option
>--until</option
>. <option
>--interval</option
> moet gespecificeerd worden en <option
>--repeat</option
> en <option
>--recurrence</option
> kunnen dat niet met deze optie.</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
>Ofwel een berichttekst, <option
>--file</option
>, <option
>--exec</option
>, <option
>--exec-display</option
>, <option
>--play</option
> of <option
>--play-repeat</option
> moet gespecificeerd worden; behalve zoals boven aangegeven, alle opties zijn optioneel.</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
>"Denk er aan te\nSTOPPEN"</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
>"Denk er aan te\nSTOPPEN"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

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

<para
>De volgende opties worden gebruikt om verschillende functies uit te voeren, inclusief het weergeven van <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
>.</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
>Geef de dialoog voor bewerking van een herinnering weer om de herinnering met de gespecificeerde event-ID te bewerken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Dialoogvenster voor het bewerken van een herinnering tonen om een nieuwe audioherinnering te bewerken.</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
>Dialoogvenster voor het bewerken van een herinnering tonen om een nieuwe weergaveherinnering te bewerken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Dialoogvenster voor het bewerken van een herinnering tonen om een nieuwe e-mailherinnering te bewerken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>sjabloonnaam</replaceable
></option
></entry>
  <entry
>Dialoogvenster voor het bewerken met een vooraf ingesteld sjabloon met de gespecificeerde naam om een nieuwe herinnering te bewerken.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Voer een lijst met geplande herinneringen uit naar <filename
>stdout</filename
>. De lijst toont beknopte details van elke wachtende herinnering: zijn hulpbron-identifier (bij gebruik van Akonadi), UID, volgende geplande tijd en berichttekst of bestand.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>&kalarm; als een pictogram tonen in het systeemvak.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Alle herinneringen volgen uitschakelen</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
>Toont vele generieke opties specifiek voor &Qt;.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Toont vele generieke opties specifiek voor &kde;.</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
>Gids voor ontwikkelaars naar &kalarm;</title>

<para
>&kalarm; biedt een interface waarmee andere toepassingen de volgende functies kunnen vragen:</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>
<listitem
><para
>lijst met geplande herinneringen</para
></listitem>
</itemizedlist>

<para
>Elk van de bovenstaande functies is geïmplementeerd zowel door een &DBus; aanroep als door de opdrachtregel. &DBus; oproepen moeten bij voorkeur worden gebruikt als &kalarm; al actief is.</para>

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

<para
>De &DBus; oproepen beschreven in dit document zijn allemaal geïmplementeerd in &DBus; objectpad <constant
>/kalarm</constant
> van &kalarm;. Het interface is gedefinieerd in de bestanden <filename
>org.kde.kalarm.kalarm.xml</filename
> en <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
>Als de herinnering is al is afgelopen zal &kalarm; alle geplande gevallen van de herinnering tot op het huidige moment verwijderen en, als er geen herhalingen van de herinnering over blijven, wordt de herinnering uit de agenda verwijderd. Als de herinnering nog niet is afgelopen, blijven zijn geplande gevallen ongewijzigd.</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
>vlaggen</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
>vlaggen</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
>vlaggen</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
>Specificeert de tekst van het te plannen bericht of, als <parameter
>vlaggen</parameter
> het bit <userinput
>DISPLAY_COMMAND</userinput
> aan heeft staan, specificeert de uit te voeren opdrachtregel de aan te maken berichttekst.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum herinnering moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een herinnering met een datum en tijd, moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) of <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (zoals teruggegeven door <methodname
>QTime::toString(Qt::ISODate)</methodname
>) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.</para>

<para
>Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, <replaceable
>TZ</replaceable
>, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> die de UTC tijdzone representeert of <userinput
>Clock</userinput
> om de lokale computerklok te gebruiken en tijdzones te negeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat de herinnering wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van de herinnering. Als de waarde 0 is zal de herinnering niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vlaggen</parameter
></term>
<listitem>
<para
>Specificeert de logisch OF van de gewenste herinneringsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Merk op dat niet alle vlagbits van toepassing zijn op de herinneringsberichten.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Specificeert de achtergrondkleur voor het weergeven van het bericht. De tekenreeks kan in het formaat <quote
>#RRGGBB</quote
> zijn (zoals teruggegeven door <methodname
>QColor::name()</methodname
>) waar RR, GG en BB tweecijferige hexadecimale waarden zijn voor rood, groen en blauw. Alternatief mag de tekenreeks in elk van de andere formaten zijn geaccepteerd door <methodname
>QColor::setNamedColor()</methodname
>, zoals een naam uit de X-kleurdatabase (&eg; <quote
>rood</quote
> of <quote
>staalblauw</quote
>). Zet de tekenreeks op nul om de huidige standaard achtergrondkleur te specificeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fgColor</parameter
></term>
<listitem>
<para
>Specificeert de voorgrond kleur voor het tonen van het bericht. Het formaat van de tekenreeks is hetzelfde als voor <parameter
>bgColor</parameter
> of zet als alternatief de tekenreeks op nul om de huidige standaard voorgrondkleur te specificeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lettertype</parameter
></term>
<listitem>
<para
>Specificeert het lettertype voor het weergeven van het bericht. Het formaat van de tekenreeks is die uitgevoerd wordt door <methodname
>QFont::toString()</methodname
>. Zet de tekenreeks op nul om het standaard lettertype van het moment te tonen wanneer het bericht wordt getoond.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Specificeert het geluidsbestand dat afgespeeld moet worden wanneer het bericht wordt getoond. Zet de waarde op nul als geen geluidsbestand moet worden afgespeeld.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten voor de hoofdherinnering en elk van zijn herhalingen (indien aanwezig) waarop een herhalingsherinnering moet worden getoond. Specificeer een negatieve waarde voor een herhaling om te worden getoond na de hoofdherinnering. Specificeer 0 als geen herhaling is vereist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van de herinnering, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Bijvoorbeeld, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalende herinnering, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor de herinnering. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door <parameter
>recurType</parameter
>) tussen herhalingen van de herinnering.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal keren dat de herinnering herhaald moet worden. Specificeer -1 om de herinnering oneindig te herhalen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van de herinnering. Als <parameter
>startDateTime</parameter
> een tijd bevat, dan moet deze parameter ook een tijd bevatten; als <parameter
>startDateTime</parameter
> alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor <parameter
>startDateTime</parameter
> wordt gebruikt om deze waarde van de parameter te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten tussen de sub-herhalingen van de herinnering. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal sub-herhalingen van de herinnering, inclusief de initiële herinnering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beschrijving</title>
<para
><function
>scheduleMessage()</function
> is een &DBus; aanroep om het gespecificeerde herinneringsbericht voor weergave op de gespecificeerde datum en tijd. Het heeft drie vormen. De meest algemene vorm staat een willekeurige te specificeren herhaling toe &ndash; gebruik deze ook voor zich niet herhalende herinneringen. De andere vormen bieden een gemakkelijke toegang tot een beperkte set van typen herhalingen van herinneringen, de een die een herhalingsaantal specificeert en de ander een eind tijd.</para>

<para
>Als de geplande tijd (inclusief herhalingen) al is gepasseerd, zal &kalarm; het bericht onmiddellijk weergeven (tenzij de waarde van <parameter
>lateCancel</parameter
> aangeeft dat het nu te laat is om de herinnering te tonen, in welk geval &kalarm; het verzoek negeert). Als de geplande tijd (of een herhaling) zich in de toekomst bevindt zal &kalarm; het herinneringsbericht toevoegen aan de actieve standaard herinneringsagenda voor latere weergave.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>plan een nieuwe herinnering die de inhoud van een tekst- of afbeeldingsbestand toont.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>vlaggen</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
>vlaggen</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
>vlaggen</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
>Specificeert het tekst- of afbeeldingsbestand waarvan de inhoud moet worden getoond in het geplande bericht.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum herinnering moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een herinnering met een datum en tijd, moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) of <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (zoals teruggegeven door <methodname
>QTime::toString(Qt::ISODate)</methodname
>) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.</para>

<para
>Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, <replaceable
>TZ</replaceable
>, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> die de UTC tijdzone representeert of <userinput
>Clock</userinput
> om de lokale computerklok te gebruiken en tijdzones te negeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat de herinnering wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van de herinnering. Als de waarde 0 is zal de herinnering niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vlaggen</parameter
></term>
<listitem>
<para
>Specificeert de logisch OF van de gewenste herinneringsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Merk op dat niet alle vlagbits van toepassing zijn op de herinneringen met een bestand.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bgColor</parameter
></term>
<listitem>
<para
>Specificeert de achtergrondkleur voor het weergeven van het bestand. De tekenreeks kan in het formaat <quote
>#RRGGBB</quote
> zijn (zoals teruggegeven door <methodname
>QColor::name()</methodname
>) waar RR, GG en BB tweecijferige hexadecimale waarden zijn voor rood, groen en blauw. Alternatief mag de tekenreeks in elk van de andere formaten zijn geaccepteerd door <methodname
>QColor::setNamedColor()</methodname
>, zoals een naam uit de X-kleurdatabase (&eg; <quote
>rood</quote
> of <quote
>staalblauw</quote
>). Zet de tekenreeks op nul om de huidige standaard achtergrondkleur te specificeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>audioURL</parameter
></term>
<listitem>
<para
>Specificeert het geluidsbestand dat afgespeeld moet worden wanneer het bericht wordt getoond. Zet de waarde op nul als geen geluidsbestand moet worden afgespeeld.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>reminderMins</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten voor de hoofdherinnering en elk van zijn herhalingen (indien aanwezig) waarop een herhalingsherinnering moet worden getoond. Specificeer een negatieve waarde voor een herhaling om te worden getoond na de hoofdherinnering. Specificeer 0 als geen herhaling is vereist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van de herinnering, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Bijvoorbeeld, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalende herinnering, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor de herinnering. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door <parameter
>recurType</parameter
>) tussen herhalingen van de herinnering.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal keren dat de herinnering herhaald moet worden. Specificeer -1 om de herinnering oneindig te herhalen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van de herinnering. Als <parameter
>startDateTime</parameter
> een tijd bevat, dan moet deze parameter ook een tijd bevatten; als <parameter
>startDateTime</parameter
> alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor <parameter
>startDateTime</parameter
> wordt gebruikt om deze waarde van de parameter te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten tussen de sub-herhalingen van de herinnering. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal sub-herhalingen van de herinnering, inclusief de initiële herinnering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleFile()</function
> is een &DBus; aanroep om het te tonen gespecificeerde tekst- of afbeeldingsbestand voor weergave op de gespecificeerde datum en tijd te plannen. Los van het specificeren van een pad naar een bestand of &URL; en weglaten van de voorgrondkleur en lettertype, is zijn gebruik identiek aan <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - zie de beschrijving van die functie voor verdere 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
>vlaggen</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
>vlaggen</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
>vlaggen</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
>Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum herinnering moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een herinnering met een datum en tijd, moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) of <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (zoals teruggegeven door <methodname
>QTime::toString(Qt::ISODate)</methodname
>) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.</para>

<para
>Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, <replaceable
>TZ</replaceable
>, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> die de UTC tijdzone representeert of <userinput
>Clock</userinput
> om de lokale computerklok te gebruiken en tijdzones te negeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat de herinnering wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van de herinnering. Als de waarde 0 is zal de herinnering niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vlaggen</parameter
></term>
<listitem>
<para
>Specificeert de logisch OF van de gewenste herinneringsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Merk op dat niet alle vlagbits van toepassing zijn op de commando-herinneringen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van de herinnering, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Bijvoorbeeld, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalende herinnering, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor de herinnering. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door <parameter
>recurType</parameter
>) tussen herhalingen van de herinnering.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal keren dat de herinnering herhaald moet worden. Specificeer -1 om de herinnering oneindig te herhalen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van de herinnering. Als <parameter
>startDateTime</parameter
> een tijd bevat, dan moet deze parameter ook een tijd bevatten; als <parameter
>startDateTime</parameter
> alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor <parameter
>startDateTime</parameter
> wordt gebruikt om deze waarde van de parameter te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten tussen de sub-herhalingen van de herinnering. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal sub-herhalingen van de herinnering, inclusief de initiële herinnering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleCommand()</function
> is een &DBus; aanroep om de gespecificeerde shell-opdrachtregel of commandoscript voor uitvoering op de gespecificeerde datum en tijd te plannen. Los van het specificeren van een commando en weglaten van de parameters voor kleur van berichten, lettertype en audiobestand, is zijn gebruik identiek aan <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - zie de beschrijving van die functie voor verdere 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
>vlaggen</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
>vlaggen</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
>vlaggen</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
>Specificeert de inhoud van het e-mailbericht.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bijlagen</parameter
></term>
<listitem>
<para
>Een kommagescheiden lijst ven paden of &URL;'s die als bijlagen met het e-mailbericht worden verzonden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum herinnering moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een herinnering met een datum en tijd, moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) of <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (zoals teruggegeven door <methodname
>QTime::toString(Qt::ISODate)</methodname
>) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.</para>

<para
>Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, <replaceable
>TZ</replaceable
>, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> die de UTC tijdzone representeert of <userinput
>Clock</userinput
> om de lokale computerklok te gebruiken en tijdzones te negeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat de herinnering wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van de herinnering. Als de waarde 0 is zal de herinnering niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vlaggen</parameter
></term>
<listitem>
<para
>Specificeert de logisch OF van de gewenste herinneringsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Merk op dat niet alle vlagbits van toepassing zijn op de e-mailherinneringen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van de herinnering, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Bijvoorbeeld, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalende herinnering, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor de herinnering. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door <parameter
>recurType</parameter
>) tussen herhalingen van de herinnering.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal keren dat de herinnering herhaald moet worden. Specificeer -1 om de herinnering oneindig te herhalen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van de herinnering. Als <parameter
>startDateTime</parameter
> een tijd bevat, dan moet deze parameter ook een tijd bevatten; als <parameter
>startDateTime</parameter
> alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor <parameter
>startDateTime</parameter
> wordt gebruikt om deze waarde van de parameter te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten tussen de sub-herhalingen van de herinnering. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal sub-herhalingen van de herinnering, inclusief de initiële herinnering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleEmail()</function
> is een &DBus; aanroep om het te verzenden gespecificeerde e-mailbericht op de gespecificeerde datum en tijd te plannen. Los van het specificeren van de e-mail-header en de inhoud en weglaten van de parameters voor berichtkleur, lettertype en audiobestand, is zijn gebruik identiek aan <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - zie de beschrijving van die functie voor verdere 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
>vlaggen</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
>vlaggen</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
>vlaggen</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
>Specificeert het te gebruiken volume als een percentage van het volledige volume. Specificeer -1 om het standaard volume te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startDateTime</parameter
></term>
<listitem>
<para
>Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum herinnering moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een herinnering met een datum en tijd, moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) of <replaceable
>HH:MM[:SS] [Clock]</replaceable
> (zoals teruggegeven door <methodname
>QTime::toString(Qt::ISODate)</methodname
>) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.</para>

<para
>Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, <replaceable
>TZ</replaceable
>, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> die de UTC tijdzone representeert of <userinput
>Clock</userinput
> om de lokale computerklok te gebruiken en tijdzones te negeren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat de herinnering wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van de herinnering. Als de waarde 0 is zal de herinnering niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>vlaggen</parameter
></term>
<listitem>
<para
>Specificeert de logisch OF van de gewenste herinneringsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Merk op dat niet alle vlagbits van toepassing zijn op de commando-herinneringen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van de herinnering, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Bijvoorbeeld, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalende herinnering, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor de herinnering. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse <classname
>KAlarmIface</classname
> in <filename
>kalarmiface.h</filename
>. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter <parameter
>startDateTime</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door <parameter
>recurType</parameter
>) tussen herhalingen van de herinnering.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal keren dat de herinnering herhaald moet worden. Specificeer -1 om de herinnering oneindig te herhalen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van de herinnering. Als <parameter
>startDateTime</parameter
> een tijd bevat, dan moet deze parameter ook een tijd bevatten; als <parameter
>startDateTime</parameter
> alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor <parameter
>startDateTime</parameter
> wordt gebruikt om deze waarde van de parameter te gebruiken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatInterval</parameter
></term>
<listitem>
<para
>Specificeert het aantal minuten tussen de sub-herhalingen van de herinnering. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>subRepeatCount</parameter
></term>
<listitem>
<para
>Specificeert het aantal sub-herhalingen van de herinnering, inclusief de initiële herinnering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>
<para
><function
>scheduleAudio()</function
> is een &DBus; aanroep om het af te spelen gespecificeerde audiobestand op de gespecificeerde datum en tijd te plannen. Los van het specificeren van een volume en weglaten van parameters voor de bercihtkleur en lettertype, is gebruik identiek aan <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - zie de beschrijving van die functie voor verdere details.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>bewerken</refentrytitle>
</refmeta>
<refnamediv>
<refname
>bewerken</refname>
<refpurpose
>Toon de <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> om een herinnering te bewerken.</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
>Specificeert de unieke ID van de te bewerken gebeurtenis.</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
>Toon de <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> om een nieuwe herinnering te bewerken.</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 een &DBus; aanroep om het <link linkend="alarm-edit-dlg"
>Dialoogvenster om herinneringen te bewerken</link
> te tonen om een nieuwe herinnering te bewerken. Als een type herinnering is gespecificeerd als parameter, zal een blanco dialoog worden getoond. Alternatief, als een naam van een herinneringssjabloon is als parameter is gespecificeerd, zal de dialoog ingevuld zijn met details uit het sjabloon.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>lijst</refentrytitle>
</refmeta>
<refnamediv>
<refname
>lijst</refname>
<refpurpose
>Geeft een lijst van geplande herinneringen.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Teruggegeven waarde</title>
<para
>Lijst met herinneringen, gescheiden door nieuwe-regels, elk in het formaat <returnvalue
><replaceable
>hulpbron_id</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>tijd</replaceable
> <replaceable
>tekst</replaceable
></returnvalue
> (bij gebruik van Akonadi) of <returnvalue
><replaceable
>UID</replaceable
> <replaceable
>tijd</replaceable
> <replaceable
>tekst</replaceable
></returnvalue
> (bij gebruik van KResources).</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

<para
><function
>list()</function
> is een aanroep van &DBus; om een tekenreeks terug te geven met een samenvatting van geplande herinneringen. De lijst toont beknopte details van elke wachtende herinnering: zijn hulpbron-identifier (bij gebruik van Akonadi), UID, volgende geplande tijd en berichttekst of bestand.</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
>De agendabestanden waarin &kalarm; zijn herinneringen opslaat zijn tekstbestanden waarvan het formaat is gedefinieerd door het document <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. Dit is het standaard formaat gebruikt door alle kdepim-toepassingen. &kalarm; gebruikt bepaalde niet-standaard eigenschappen, conform RFC2445. Deze zijn gedocumenteerd in het bestand <filename
>DESIGN.html</filename
> die wordt gedistribueerd met &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; wordt gewoonlijk hersteld door de sessiemanager bij aanmelden (om zijn vensters in dezelfde status weer te geven als ze waren bij afmelden). Maar als het niet actief was bij afmelden, dan wordt het niet gestart door de sessiemanager en daarom is autostart nodig. Het probleem is dat wanneer een toepassing zowel beheerd wordt door de sessiemanager als autostart is, er geen garantie is welke eerst zijn gebeuren. Als autostart het eerst krijgt, zal het willen voorkomen dat de sessiemanager de status van de toepassing zal herstellen.</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
>De standalone versie van &kalarm; heeft een speciale configuratie-optie die toestaat om te selecteren in welke talen documentatie geïnstalleerd moet worden door een taalcode te specificeren of een lijst met taalcodes, als een parameter voor <command
>./configure</command
>. Standaard is documentatie in alle beschikbare talen geïnstalleerd. Een lijst met talen met documentatie in het pakket, samen met hun codes, is in het bestand <filename
>DOC-LANGUAGES</filename
>. Bijvoorbeeld, om alleen Franse en Brits Engelse documentatie te installeren:</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:
-->

