<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % 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
><year
>2016</year
><year
>2018</year
><year
>2019</year
><year
>2020</year
><year
>2021</year
><year
>2022</year
><year
>2023</year
><year
>2024</year
><year
>2025</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2025-03-17</date>
<releaseinfo
>3.11.0 (KDE Gear 25.04)</releaseinfo>

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


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

</bookinfo>


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

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

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

<para
>Bij het instellen van een alarm, kunt u kiezen of deze herhaald moet worden, en of het alarm 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 het alarm. U kunt ook de kleur van het alarmbericht kiezen, of er een geluid afgespeeld moet worden en of het bericht voorgelezen moet worden.</para>

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

<para
>Wanneer een alarm afloopt, als het venstersysteem dat toestaat, wordt er een visueel alarmbericht getoond op elk bureaublad opdat u het zeker ziet. Dit berichtvenster toont de geplande tijd voor het alarm, en het heeft meestal een uitsteloptie om het alarm later opnieuw te laten tonen. Een voorbeeld van een alarmbericht:</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
>Optioneel kan een alarmbericht getoond worden als een melding in plaats van in een venster.</para>

<para
>Wanneer er een commando uitgevoerd of een e-mail verzonden moet worden door het alarm, 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 alarmen.</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 alarmen</title>

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

<itemizedlist>
<listitem>
<para
>Alarmen 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 alarmtijd bereikt wordt. Daarbij kan er ook een audiobestand afgespeeld worden, tekst voorgelezen worden of een pieptoon uitgestuurd worden. U kunt eveneens commando's instellen die uitgevoerd moeten worden voordat en nadat het alarmbericht getoond wordt.</para>
</listitem>

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

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

<listitem>
<para
>Audio-alarmen 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 alarm, 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 commando-alarm 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 alarmen zet. Dezelfde foutmeldingen worden getoond bij schermalarmen 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 alarmen</title>

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

<para
>Merk op dat de kolom <guilabel
>Naam</guilabel
> alleen bestaat als het gebruikt van alarmnamen is ingeschakeld in het tabblad <link linkend="preferences-general"
>Algemeen</link
> van de configuratiedialoog.</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 alarmen 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 alarm die om de 3 weken maandag en woensdag voorkomt, of <quote
>aanmelden</quote
> voor een alarm die herhaald wordt elke keer dat u zich aanmeldt).</para>

<para
>Als er de laatste keer bij het uitvoeren van een commando-alarm, of van een pre- of postalarmcommando, 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 alarmenlijst veranderen</title>

<para
>De alarmen kunnen gesorteerd worden op datum/tijd, herhalingsinterval, kleur, type, naam 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
>U kunt als optie de resterende tijd tot elk alarm afloopt tonen, samen met, of in plaats van, de geplande tijd van het alarm.</para>

<para
>U kunt selecteren welke kolommen te tonen of te verbergen door <mousebutton
>Rechts</mousebutton
> te klikken op de kolomkop en het contextmenu gebruiken om de te tonen kolommen in te stellen. Maar merk op dat minstens een van de kolommen <guilabel
>Naam, Melding, Bestand of Commando</guilabel
> en minstens een van de kolommen <guilabel
>Tijd</guilabel
> of <guilabel
>Tijd tot</guilabel
>, altijd worden getoond.</para>

<para
>Als u meerdere kalenders gebruikt, kunt u een achtergrondkleur instellen voor kalenders. De bijbehorende alarmen zullen dan ook die kleurcode krijgen (zie <link linkend="using-calendars"
>Agenda's gebruiken</link
>).</para>

</sect2>

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

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

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

</sect2>

<sect2 id="datepicker">
<title
>Filteren in de alarmenlijst op datum</title>

<para
>U kunt de alarmlijst beperken om alleen alarmen te tonen die gepland zijn op een geselecteerde datum. Dit wordt bereikt door de alarmdatumselectie, die getoond of verborgen kan worden door <menuchoice
><guimenu
>Beeld</guimenu
> <guimenuitem
>Datumselectie tonen</guimenuitem
> </menuchoice
>. Selecteer een datum door erop te klikken in de datumselectie of maak dat ongedaan door er nogmaals op te klikken. De datumselectie toont een enkele maand. Om een andere maand te tonen, gebruik de pijltjes in de datumselectie of het muiswiel.</para>

</sect2>

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

<para
>U kunt de alarmenlijst doorzoeken om alarmen 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 alarmen 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
>Alarmen met tekstbericht: de berichttekst wordt doorzocht.</para>
</listitem>

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

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

<listitem>
<para
>Alarmen 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
>Audio-alarmen: er wordt gezocht in het bestandspad/&URL;.</para>
</listitem>
</itemizedlist>

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

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

<sect2>
<title
>Een nieuw alarm aanmaken</title>

<para
>Om een nieuw alarm aan te maken, moet u één van volgende stappen doen, en dan het type alarm selecteren uit de lijst die tevoorschijn komt. Dit toont het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
>, waarin u alarmen 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
>Nieuw alarm</guimenuitem
></menuchoice
> kiezen uit het contextmenu.</para>
</listitem>

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

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

<itemizedlist>
<listitem>
<para
>Om de datum van het alarm vooraf in te stellen in de <link linkend="alarm-edit-dlg"
>Alarmbewerkingsdialoog</link
>, klik <mousebutton
>rechts</mousebutton
> op de gewenste datum in de alarmdatumselectie (zie <link linkend="datepicker"
>De alarmlijst filteren op datum</link
>) en selecteer het passende alarmtype uit het contextmenu.</para>
</listitem>

<listitem>
<para
>Volg, om een nieuw alarm te baseren op een alarmsjabloon, de instructies in het deel <link linkend="templates"
>Alarmsjablonen</link
>.</para>
</listitem>

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

<listitem>
<para
>Sleep, om een nieuw alarm te creëren die een reeds bestaand e-mailbericht toont, het e-mailbericht vanuit &kmail; naar het hoofdvenster van &kalarm;. Selecteer daarna de optie <guilabel
>Alarm tonen</guilabel
>. Dit opent het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
> met als alarmtekst het hele e-mailbericht (inclusief de afzender, de ontvanger, &etc;).</para>
</listitem>

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

<listitem>
<para
>Sleep, om een nieuw alarm aan te maken dat een samenvatting toont van een reeds bestaande taak, de taak vanuit &korganizer; of een andere applicatie naar het hoofdvenster van &kalarm;. Dit opent het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
> met de taakinhoud als alarmtekst.</para>
</listitem>

<listitem>
<para
>Sleep, om een nieuw alarm met shell-commando aan te maken de tekst van een script, die begint met <quote
>#!</quote
>, naar het hoofdvenster van &kalarm;. Selecteer dan de optie <guilabel
>E-mail</guilabel
>. Het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
> zal dan reeds de tekst van het script bevatten.</para>
</listitem>

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

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

<listitem>
<para
>Sleep, om een tekstalarm aan te maken, elk stuk tekst naar het hoofdvenster van &kalarm;. Indien gevraagd, selecteer dan de optie <guilabel
>Alarm weergave</guilabel
>. Dit opent <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
> met de tekst van het alarm al ingesteld.</para>
</listitem>

<listitem>
<para
>U kunt automatisch alarmen 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 bestaand alarm aanpassen</title>

<para
>Om een openstaand alarm aan te passen (verstreken alarmen kunnen niet aangepast worden), zijn er volgende mogelijkheden:</para>

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

<listitem>
<para
>De alarm selecteren door te klikken op de regel in de alarmenlijst. 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 alarmenlijst 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 alarmen te bewerken</link
>.</para>

</sect2>

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

<para
>Om bestaande alarmen te verwijderen, selecteert u één of meer alarmen door te klikken op de juiste regels in de alarmenlijst. 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 actief alarm verwijdert, wordt deze gearchiveerd als deze reeds 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 alarmen bijgehouden moeten worden.) Als u een gearchiveerde of een nog niet uitgevoerd openstaand alarm verwijderd, wordt deze permanent verwijderd.</para>

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

<itemizedlist>
<listitem>
<para
>Selecteer een of meer gewenste gearchiveerde alarmen uit de alarmenlijst 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 alarmen en op <menuchoice
><guimenuitem
>Reactiveren</guimenuitem
></menuchoice
> klikken in het contextmenu.</para>
</listitem>
</itemizedlist>

</sect2>

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

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

</sect2>

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

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

</sect2>

<sect2>
<title
>Een alarm bevestigen</title>

<para
>Zie <link linkend="message-display"
>Venster met alarmbericht</link
> voor hoe een alarm te bevestigen.</para>

</sect2>

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

<para
>Als u regelmatig gelijkaardige alarmen wilt instellen, kunt u een alarmsjabloon creëren om te vermijden dat u elke keer alle details opnieuw moet intypen. Een sjabloon kan alle mogelijke details voor een alarm 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 alarmdetails bevatten (berichttekst, of er een geluid afgespeeld moet worden, &etc;) uitgezonderd datum en tijd. Als u dan nu zo'n alarm wilt aanmaken, opent u gewoon het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
> met het sjabloon, en vult u de datum en de tijd in.</para>

<para
>Om een alarm te creëren die gebaseerd is op een sjabloon, opent u het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen 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
>Nieuw alarm 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
>Nieuw alarm</guimenuitem
> <guimenuitem
>Nieuw alarm 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 alarmen te bewerken</link
> openen op de gewone manier, en op de knop <guibutton
>Sjabloon laden...</guibutton
> klikken om een sjabloon te selecteren zodat het alarm 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 alarmsjabloon aanmaken op basis van een reeds bestaand alarm.</para>

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

<itemizedlist>
<listitem>
<para
>Het dialoogvenster voor alarmsjablonen 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 alarmtype uit de getoonde lijst. Hiermee opent u een dialoogvenster met een leeg sjabloon dat u kunt invullen.</para>
</listitem>

<listitem>
<para
>Het dialoogvenster voor alarmsjablonen 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 alarmsjablonen te bewerken geopend, ingevuld met de gegevens van het reeds bestaande sjabloon.</para>
</listitem>

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

<para
>Om een reeds bestaand sjabloon te bewerken, opent u het dialoogvenster alarmsjablonen 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 alarmsjablonen te bewerken getoond, zoals hieronder beschreven.</para>

<para
>Om bestaande sjablonen te verwijderen, opent u het dialoogvenster alarmsjablonen 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"
>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.Alarmen die dan op dit sjabloon gebaseerd worden, zullen in het begin de standaard uitvoertijd gebruiken, die ook bij nieuwe alarmen gebruikt wordt.</para>
</listitem>

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

<listitem>
<para
><guilabel
>Alleen datum</guilabel
> selecteren om aan te geven dat het alarm 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 alarm 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 alarmen</title>

<para
>Als u maar één computer gebruikt, en onafhankelijk werkt, maakt het waarschijnlijk niet uit waar de alarmen van &kalarm; opgeslagen worden. Maar als u de alarmen vanaf meer dan één computer moet kunnen bereiken, of op meerdere locaties op uw lokale computer, kunt u <quote
>agenda's met alarmen</quote
> instellen om &kalarm; duidelijk te maken dat er andere agenda's met alarmen 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 alarmenlijst in &kalarm;s hoofdvenster. Alarmen van andere alarmagenda's worden samen getoond in de alarmenlijst. Als u een nieuw alarm opslaat, kunt u een optie instellen om te kiezen of de nieuw alarm opgeslagen moet worden in de standaard agenda, of dat er gevraagd moet worden in welke agenda dit nieuwe alarm opgeslagen moet worden. Als u een reeds bestaand alarm bewerkt, wordt deze automatisch terug opgeslagen in de agenda waar het oorspronkelijke alarm 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 alarmtype en opslagtype. Ze kunnen uitgeschakeld worden, als alleen-lezen ingesteld worden, of als standaardagenda ingesteld worden voor een bepaald alarmtype.</para>

<variablelist>
<varlistentry>
<term
>Type alarm</term>
<listitem>
<para
>De drie typen alarmen &ndash; actieve alarmen, verlopen alarmen en alarmsjablonen &ndash; worden opgeslagen in aparte alarmagenda'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 dat wenst.</para>
</listitem>
</varlistentry>

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

<itemizedlist>
<listitem
><para
>Lokaal bestand: Alarmen 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
>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 kopie van de gegevens.</para>

<warning
><para
>&kalarm; monitort geen alarmagenda's op wijzigingen, als er dus wijzigingen gemaakt worden door iemand anders, dan zou &kalarm; ze kunnen overschrijven. Om dit te vermijden, wordt u aangeraden een van de volgende beleidsregel te gebruiken:</para>
<itemizedlist>
<listitem
><para
>Zorg er voor dat slechts één persoon of toepassing tegelijk toegang heeft tot de agenda.</para
></listitem>
<listitem
><para
>Alle gebruikers anders dan de eigenaar van de agenda zou de agenda als alleen-lezen moeten configureren.</para
></listitem>
</itemizedlist>
<para
>Anders, als minimum zou u de agenda moeten herladen alvorens deze te wijzigen of te vertrouwen op zijn inhoud, met de methode beschreven in <link linkend="using-calendars"
>Agenda's gebruiken</link
>. Merk ook op dat als de agenda als alleen-lezen is geconfigureerd, &kalarm; het zal overschrijven wanneer een alarm afgaat. </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 alarmen in de agenda genegeerd, en verschijnen ze dus ook niet in de alarmenlijst of de lijst met sjablonen. Als een agenda terug ingeschakeld wordt, worden de erin aanwezige alarmen één keer terug getoond, en, als het een actieve alarmagenda is, terug actief gemaakt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Status alleen-lezen</term>
<listitem>
<para
>Alarmen kunnen niet toegevoegd worden aan, of bewerkt worden in een alleen-lezen agenda. U kunt de erin aanwezig alarmen dus niet bewerken, en er ook geen nieuwe alarmen in opslaan. Het is eveneens niet mogelijk om alarmen uit te stellen, aangezien de uitsteltijd dan opgeslagen moet worden in het alarm. 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 alarmen in een agendabestand dat niet beschrijfbaar is, dan kunt u de alarmen 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"
>Alarmen importeren uit externe agaenda's</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Standaard agendastatus</term>
<listitem>
<para
>Eén agenda per alarmtype kan eventueel als standaardagenda voor dat alarmtype gebruikt worden. Nieuwe alarmen worden automatisch opgeslagen in de standaardagenda van dat alarmtype, behalve wanneer u ervoor gekozen hebt een keuzevenster te laten zien voor nieuwe alarmen 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 alarmtype 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 alarmen 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 alarmen die verlopen zijn sinds de laatste opslag, opnieuw uitgevoerd worden.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importeren...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Alarmen importeren uit externe agendabestanden in de geselecteerde agenda. Dit wordt verder uitgelegd in <link linkend="import"
>Importeren van alarmen 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 alarmen in de geselecteerde agenda exporteren naar een extern agendabestand. Dit wordt verder uitgelegd in <link linkend="export"
>Exporteren van alarmen 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 alarmen uit deze agenda in de lijst met alarmen. Op deze manier ziet u direct bij welke agenda bepaalde alarmen behoren.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Kleur weghalen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Accentuering van kleur wissen voor de alarmen uit deze agenda in de lijst met alarmen. De optie verschijnt alleen nadat <guimenuitem
>Kleur instellen</guimenuitem
> op deze agenda is gebruikt.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

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

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

<itemizedlist>
<listitem>
<para
>Gebruik <menuchoice
><guimenu
>Bestand</guimenu
> <guimenuitem
>Alarmen importeren...</guimenuitem
></menuchoice
> om alarmen van alle types (actieve alarmen, verlopen alarmen en alarmsjablonen) te importeren uit de agendabestanden.</para>

<para
>Als u <link linkend="calendars"
>alarmagenda's</link
> geconfigureerd hebt, zullen alarmen van elk type toegevoegd worden aan de juiste standaardagenda of als u ervoor gekozen hebt een keuzevenster te laten zien voor nieuwe alarmen 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 alarmen van het geselecteerde type importeren in die agenda. Als er bijvoorbeeld als agendatype alarmsjablonen gekozen is, zullen de alarmsjablonen (en niet de actieve of verlopen alarmen) geïmporteerd worden.</para>
</listitem>
</itemizedlist>

<warning
><para
>Als u alarmen importeert uit agendabestanden die aangemaakt werden door andere applicaties dan &kalarm;, kan het gebeuren dat alarmen veranderd worden door het proces &ndash; zelfs alarmtijden 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 alarmen voor onverwachte veranderingen en pas ze eventueel aan.</para
></warning>

</sect2>

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

<para
>U kunt in &kalarm; ofwel de huidig geselecteerde alarmen in de alarmenlijst, ofwel alle alarmen van een alarmagenda 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 alarmen toe te voegen aan een reeds bestaand agendabestand. Om alarmen 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 alarmen in de alarmenlijst 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 alarmen exporteren...</guimenuitem
> </menuchoice
> in het hoofdmenu.</para>
</listitem>

<listitem>
<para
>Om alle alarmen 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>

<note
><para
>Deze functie is alleen beschikbaar als de <link linkend="akonadi-plugin"
>Akonadi plug-in</link
> van &kalarm; is geïnstalleerd en ingeschakeld.</para>
</note>

<para
>U kunt zichtbare alarmen 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 alarm</guilabel
>, kunt u de tekst instellen die getoond moet worden in de alarmberichten 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 alarmtekst 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 alarmen 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
>alarmen 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 alarmen 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 alarmen 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 alarmen en alarmsjablonen, en het opnieuw activeren van alarmen. 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 alarm 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
>Dialoogvenster om alarmen te bewerken</title>

<para
>Het Dialoogvenster om alarmen te bewerken biedt u het bekijken en bewerken van alarmen. 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 Dialoogvenster om alarmen te bewerken 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 "Alarm bewerken" met het <link linkend="preferences-edit"
>tabblad Bewerken van instellingen</link
>.</para>

<screenshot>
<screeninfo
>Schermafbeelding van de eenvoudige versie van het Dialoogvenster om alarmen te bewerken</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Eenvoudige versie van het Dialoogvenster om alarmen te bewerken voor een getoond alarm</phrase>
</textobject>
<caption
><para
>Eenvoudige versie van het Dialoogvenster om alarmen te bewerken voor een getoond alarm</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
>Dialoogvenster om alarmen te bewerken voor een getoond alarm, waar alle opties getoond worden</phrase>
</textobject>
<caption
><para
>Dialoogvenster om alarmen te bewerken voor een getoond alarm, waar alle opties getoond worden</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Alarmnaam</title>

<para
>U kunt aan het alarm een naam geven in het veld <guilabel
>Alarmnaam</guilabel
>. Dit maakt het gemakkelijker u te helpen bij het identificeren van het alarm. U hoeft geen naam in te voeren en het hoeft niet uniek te zijn.</para>

<para
>Merk op dat dit veld alleen getoond wordt als het gebruik van alarmnamen is ingeschakeld in het tabblad <link linkend="preferences-general"
>Algemeen</link
> van de configuratiedialoog.</para>

</sect2>

<sect2>
<title
>Herinneringsactie</title>

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

<sect3>
<title
>Alarmen tonen</title>

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

<itemizedlist>
<listitem>
<para
><guilabel
>Tekstbericht</guilabel
> om de tekst van een alarmbericht 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 alarmbericht. Gebruik de knop maast het tekstvak om een bestandskeuzedialoog te tonen. De optie <guilabel
>Spreken</guilabel
> is niet beschikbaar voor dit type alarm.</para>
</listitem>

<listitem>
<para
><guilabel
>Commando-uitvoer</guilabel
> om te specificeren dat de tekst van het alarmbericht moet worden gegenereerd door een commando dat wordt uitgevoerd wanneer het alarm afgaat. Zie <link linkend="command-alarm"
>Alarmen 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 alarm te tonen is:</para>

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

<itemizedlist>
<listitem>
<para
><guilabel
>Geen</guilabel
> om het alarm 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 alarmbericht uit te laten spreken naast het tonen. Deze optie is alleen beschikbaar als &kalarm; was gebouwd met ingeschakelde spraak en u de &Qt; Spraakmodule hebt geïnstalleerd en deze werkt.</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 het alarm wordt getoond. (Het venster met het alarmbericht bevat een knop om het afspelen van het geluid te stoppen als u stilte wilt maar het tonen van het alarm 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 de audio-backend, die nu gebruikt wordt, het ondersteunt, 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 alarmbericht te selecteren. In de dialoog <guilabel
>Lettertype &amp; kleur van alarm 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 alarmbericht.</para>
</listitem>

<listitem>
<para
>De optie <guilabel
>Methode van tonen</guilabel
> laat u selecteren hoe het alarm wordt getoond. Kies:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Venster</guilabel
> om het alarm in een venster te tonen. Deze optie biedt de volledige reeks van te gebruiken opties bij het configureren van het alarm.</para>
</listitem>

<listitem>
<para
><guilabel
>Melding</guilabel
> om het standaard meldingensysteem te gebruiken voor het tonen van het alarmbericht. Vanwege de beperkingen van het meldingensysteem kunnen de volgende alarmconfiguratie-opties niet gebruikt worden bij meldingen: lettertype en kleurinstellingen; een geluidsbestand afspelen wanneer het alarm wordt getoond; bevestiging van alarm gezien; automatisch sluiten van het tonen bij verlopen van de te annuleringstijd bij te laat.</para>
</listitem>
</itemizedlist>

<para
>Zie de sectie <link linkend="message-window"
>Venster met alarmbericht</link
> voor verdere details over hoe alarmberichten getoond worden.</para>
</listitem>

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

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

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

<itemizedlist>
<listitem
><para
>Wanneer een alarmbericht getoond wordt.</para
></listitem>
<listitem
><para
>Wanneer het bericht opnieuw wordt getoond na uitstel van het alarm, tenzij <guilabel
>Voor uitgestelde alarmen 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 terugkerend alarm afgaat maar het alarmbericht (of een uitgesteld alarmbericht) van een vorige gebeurtenis van het alarm nog steeds zichtbaar is; met andere woorden, wanneer de vorige gebeurtenis van het alarm nog niet als gezien is gemeld.</para
></listitem>
</itemizedlist>

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

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

<listitem
><para
>Normaal, als het commando voorafgaand aan een alarm een fout teruggeeft, zal er een foutbericht worden getoond en een foutindicatie worden getoond in de lijst met alarmen. 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 alarm</guilabel
> een shellcommando in om uit te voeren wanneer het alarm 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 alarmbericht gesloten wordt.</para
></listitem>
<listitem
><para
>Wanneer u het alarm uitstelt, behalve wanneer het uitgestelde alarm uiteindelijk is bevestigd.</para
></listitem>
<listitem
><para
>Wanneer het alarmbericht gesloten wordt door zich af te melden.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

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

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

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

<para
>Commando-alarmen voeren een commando uit zonder een alarmbericht te tonen.</para>

<note
><para
>Dit type alarm 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 het alarm bevatten. Merk op dat wanneer het commando wordt uitgevoerd vanuit de knop <guibutton
>Proberen</guibutton
> van "Dialoogvenster om alarmen te bewerken", <envar
>KALARM_UID</envar
> leeg zal zijn als het een nieuw alarm is of als het alarm is gewijzigd in de dialoog, omdat het alarm alleen een UID krijgt wanneer het is opgeslagen in de alarmagenda.</para>

<para
>De besturing beschikbaar voor Alarmen 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
>Als het commando een fout teruggeeft, zal normaal een foutmelding worden getoond en wordt er een foutindicatie getoond in de lijst met alarmen. De foutmelding kan voorkomen worden door <guilabel
>Fouten niet melden</guilabel
> te activeren.</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
>Alarmen via e-mail</title>

<para
>Alarmen via e-mail, sturen een e-mail zonder een alarmbericht 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. (Merk op dat de knop alleen wordt getoond als de <link linkend="akonadi-plugin"
>Akonadi plug-in</link
> van &kalarm; is geïnstalleerd en ingeschakeld).  Bijlagen kunnen worden toegevoegd met de knop <guibutton
>Toevoegen...</guibutton
>. Merk op dat bijgevoegde bestanden nog steeds moeten bestaan wanneer het alarm is wordt gestart; er wordt geen kopie opgeslagen op het moment dat het alarm 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 het alarm wordt geactiveerd. Het e-mailadres waarnaar de kopie zal worden gezonden kan worden ingesteld in de <link linkend="preferences-email"
>Instellingendialoog</link
>, de standaard is uw e-mailadres ingesteld in &kmail;.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Geluidsalarmen</title>

<para
>Geluidsalarmen spelen een geluidsbestand af zonder een alarmbericht 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 de audio-backend, die nu gebruikt wordt, het ondersteunt, 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 het alarm een zich herhalend alarm is en het was uitgesteld nadat het voor het laatst was getoond, dan toont het groepsvak <guilabel
>Uitgesteld alarm</guilabel
> de tijd waarnaar het alarm 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 het alarm moet worden geactiveerd. Activeer <guilabel
>Elke tijd</guilabel
> als u alleen een datum voor het alarm wilt specificeren: in dat geval zal het alarm 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 herhalend alarm 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 herhalend alarm 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) het alarm 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 dit alarm, 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 dit alarm moet gebruiken. Bij het aanmaken van een nieuw alarm 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
>Selecteer <guilabel
>Systeemtijdzone</guilabel
> als u de lokale computertijdzone wilt gebruiken (op welke computer &kalarm; op dat moment draait).</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Herinnering</title>

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

<note
><para
>Alarmen worden niet getoond voor sub-herhalingen binnen een herhaling. Alarmen worden alleen getoond voor elke hoofdherhaling van het alarm.</para
></note>

<para
>Als het alarm gebeurt, activeer dan <guilabel
>Alarm alleen voor de eerste keer</guilabel
> als u alleen een alarm wilt bij het gebeuren van het alarm. Als dit is geactiveerd en het is een alarm vooraf,dan is alarmsperiode 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 alarm wordt behandeld na zijn geplande tijd:</para>

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

<para
>Activeer dit vakje om het alarm 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 het alarm 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 alarm, &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 het alarm.</para
></note>

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

<note
><para
>Een alarm 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 alarmvenster 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 alarmen 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 het alarm eenmalig te starten, selecteer <guilabel
>Geen herhaling</guilabel
>.</para
></listitem>

<listitem
><para
>Selecteer <guilabel
>Bij aanmelden</guilabel
> om het alarm 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 alarm dat herhaald wordt bij aanmelden ook zal afgaan op elk moment dat u &kalarm; herstart.)</para
></listitem>

<listitem>
<para
>Om te zorgen dat het alarm 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 het alarm 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 het alarm 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
>Alarm op 29 februari in niet-schrikkeljaren</guilabel
> te selecteren:</para>

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

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

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

<tip
><para
>Om een dagelijks alarm plaats te laten vinden 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 het alarm te specificeren.</para
></listitem>

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

<note
><para
>De einddatum/tijd bepaalt wanneer de laatste hoofdalarm zal zijn, maar beperkt niet sub-herhalingen. Als sub-alarmen zijn ingesteld, zullen ze worden gestart als normaal na de laatste hoofdalarm, 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 Dialoogvenster om alarmen te 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 alarm beperken om niet te verschijnen op vrije dagen door <guilabel
>Vrije dagen uitsluiten</guilabel
>. Dit verandert niets aan de manier waarop het alarm is gepland; het onderdrukt eenvoudig het alarm 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 alarm beperken om alleen af te lopen gedurende werktijd door <guilabel
>Alleen tijdens werkuren</guilabel
> te activeren. Dit verandert niets aan de manier waarop het alarm is gepland; het onderdrukt eenvoudig het alarm 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 het alarm afgaat zoals gespecificeerd in de hoofdherhaling, in plaats van eenmalig geactiveerd herhaald geactiveerd overeenkomstig de specificatie van uw deelherhaling. Om bijvoorbeeld een alarm in te stellen dat 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 het alarm af moet gaan na de hoofdherhaling. Om dus, bijvoorbeeld, het alarm 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 het alarm 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 het alarm 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
>Als de systeemconfiguratie meerdere alarmen toestaat om het systeem uit een onderbreking te laten ontwaken, dan kunt u <guilabel
>Ontwaken uit onderbreking</guilabel
> selecteren om het systeem te laten ontwaken als het is onderbroken wanneer het alarm afgaat. Deze functie is niet beschikbaar voor alarmen met alleen een datum omdat hun tijd niet gedefinieerd is. Zie <link linkend="wake-suspend"
>Ontwaken uit onderbreking</link
> voor meer informatie.</para>

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

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

<note
><para
>Als u later het alarm in &kalarm; wijzigt of verwijdert, zal de afspraak in &korganizer; overeenkomstig worden gewijzigd of verwijderd. Maar als u de afspraak in &korganizer; wijzigt, zal het alarm 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"
>Alarmen aanmaken en bewerken</link
>. </para>

<para
>Druk op de knop <guibutton
>Proberen</guibutton
> om het alarm te testen en controleer of deze correct werkt. Het alarm wordt uitgevoerd alsof het op de normale manier is gepland. In het geval van een geluidsalarm, 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 het alarm aan de planningslijst toe te voegen. Merk op dat bij het bewerken van een bestaand alarm, de knop <guibutton
>OK</guibutton
> is uitgeschakeld zolang er geen wijzigingen zijn gedaan.</para>

</sect2>
</sect1>

<sect1 id="message-display">
<title
>Venster met alarmbericht</title>

<para
>Alarmberichten kunnen in vensters of als meldingen getoond worden, afhankelijk van de gekozen optie in de <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
>. Deze twee opties voor tonen worden onderstaand beschreven.</para>

<para
>Als u meldingen voor het bureaublad uitzet zal het uitvoeren van te tonen alarmen worden onderbroken totdat meldingen opnieuw worden ingeschakeld. Merk op dat dit van toepassing is op alle te tonen alarmen, ongeacht of ze getoond worden in vensters of als meldingen.</para>

<sect2 id="message-window">
<title
>Venster met alarmbericht</title>

<para
>Alarmberichten die in vensters getoond worden bieden de volledige functionaliteit.</para>

<para
>Wanneer een alarmbericht gegeven moet worden, wordt het, zo mogelijk, op elk bureaublad getoond en kan het niet door gewone vensters worden bedekt, om te verzekeren dat u het ziet. (Merk op dat alleen het X11 venstersysteem deze faciliteit nu biedt.) Het berichtvenster toont de tijd waarop het alarm 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 hoofdalarm of die van zijn weer verschijnen worden getoond, niet de tijd van het herhalingsbericht, en de venstertitel is <quote
>Alarm</quote
>.)</para>

<para
>Vensters met alarmberichten 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"
>Dialoogvenster om alarmen te bewerken</link
>. In het geval van een zich herhalend alarm, als een niet bevestigd berichtvenster overblijft van een vorig afgaan van het alarm, dan blijft het bestaande venster eenvoudig zichtbaar wanneer het alarm 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 alarmbericht biedt, voor zover van toepassing, de volgende opties van het getoonde bericht:</para>

<itemizedlist>
<listitem>
<para
>Bevestig het alarm 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 het alarm door te klikken op de knop <guibutton
>Bewerken...</guibutton
>. Dit toont het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
>.</para>
</listitem>

<listitem>
<para
>Toon opties, om het alarm naar later te verschuiven, door op de knop <guibutton
>Verschuiven...</guibutton
> te klikken. Selecteer daarna <guilabel
>Verschuiven naar</guilabel
> om in te voeren hoelang na nu het bericht opnieuw getoond moet worden (de knop <guilabel
>Voorinstelling</guilabel
> laat u kiezen uit een lijst van algemene tijdsintervallen) of selecteer <guilabel
>Verschuiven tot</guilabel
> om de datum en tijd in te wanneer het bericht opnieuw moet worden getoond. Klik daarna op <guibutton
>OK</guibutton
> om het alarmbericht te verschuiven en sluit zijn venster.</para>

<note
><para
>De tijd waarnaar het alarm moet worden verschoven moet eerder zijn dan zijn volgende geplande verschijning of het volgende alarm vooraf. Om deze reden zal de knop <guibutton
>Verschuiven...</guibutton
> in het venster met het alarmbericht en de knop <guibutton
>OK</guibutton
> in de dialog Verschuiven uitgeschakeld zijn één minuut voordat de volgende geplande tijd of alarm vooraf.</para>
<para
>Merk op dat als een herhaling is ingesteld <emphasis
>na</emphasis
> het alarm, u het alarm <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 alarmen 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 het alarm door te klikken op de knop die het symbool <quote
>afspelen stoppen</quote
>.</para>
</listitem>

<listitem>
<para
>Als het alarmbericht 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 toont de e-mail en selecteert de map met 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 <guiicon
>&kalarm;</guiicon
> biedt een gemakkelijke manier om het hoofdvenster van &kalarm; te activeren, met dat alarm geaccentueerd.</para>
</listitem>
</itemizedlist>

<para
>De manier waarop die alarmberichtvensters getoond worden hangt af van het venstersysteem dat in gebruik is.</para>

<itemizedlist>
<listitem>
<para
><application
>X11 venstersysteem</application
></para>

<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 alarmberichten te tonen:</para>

<itemizedlist>
<listitem>
<para
>Als een normaal venster. In deze modus wordt het toetsenbord gevangen in het berichtvenster van het alarm, wanneer deze verschijnt. Als u dus aan het typen bent wanneer het alarm 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 alarmbericht 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>

<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 alarmberichten 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 het alarm kunt bevestigen.</para>
</listitem>

<listitem>
<para
>De vensters worden getoond in het midden van het scherm. Om de kans te beperken om per ongeluk het alarm 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 alarmberichten 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>

</listitem>

<listitem>
<para
><application
>Wayland venstersysteem</application
></para>

<para
>Het venstersysteem  van Wayland biedt toepassingen geen controle op de positie of decoratie van hun vensters, dus de opties voor tonen zijn veel meer beperkt.</para>

<para
>Om de kans te beperken om per ongeluk het alarm te bevestigen, zijn de knoppen in het venster eerst uitgeschakeld, en worden alleen actief na een in te stellen vertraging.</para>

</listitem>

</itemizedlist>

</sect2>

<sect2>
<title
>Meldingen met alarmbericht</title>

<para
>Alarmberichten die getoond worden als meldingen bieden minder functionaliteit dan die getoond worden in vensters.</para>

<para
>Wanneer een alarmbericht gegeven moet worden, wordt het als een melding getoond. De melding toont de tijd waarvoor het alarm was gepland. Als de geplande tijd van het alarm in een andere tijdzone is dan de instelling van uw locale computer, zal zijn tijdzone ook getoond worden. (Voor herinneringsberichten is de getoonde datum/tijd die voor het hoofdalarm of zijn herhaling, niet de berichttijd van de herinnering en een kop met “Herinnering” wordt getoond.)</para>

<para
>De melding sluit automatisch na een korte tijd. (Merk op dat de verlooptijd gemeenschappelijk is voor alle toepassingen; het kan gewijzigd worden in &systemsettings;.) Nadat een melding verloopt kan het nog steeds bekeken worden in de meldingengeschiedenis totdat u het verwijdert of totdat u zich afmeldt. Omdat toepassingen geen manier hebben voor toegang tot de meldingengeschiedenis, kan &kalarm; meldingen niet verwijderen of veranderen in de geschiedenis zoals het zou kunnen voor alarmvensters. De geschiedenis kan dus meerdere meldingen voor hetzelfde alarm hebben, inclusief herinneringen en herhalingen.</para>

<para
>De alarmberichtmelding biedt de volgende opties. Merk op dat een optie selecteren de melding onmiddellijk zal sluiten en voorkomen om te worden getoond in de meldingengeschiedenis. Merk ook op dat deze opties alleen beschikbaar zijn als de melding actief is, alvorens het verloopt. Als u vervolgens toegang krijgt tot de melding in de meldingengeschiedenis, dan zal, vanwege de beperkingen van het meldingensysteem, de enige beschikbare interactie zijn het verwijderen uit de geschiedenis.</para>

<itemizedlist>
<listitem>
<para
>Bevestig het alarm door te klikken op de knop <guibutton
>Sluiten</guibutton
>. Dit sluit de melding.</para>
</listitem>

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

<listitem>
<para
>Opties voor tonen om het alarm tot later uit te stellen door te klikken op de knop <guibutton
>Uitstellen</guibutton
>. Deze knop wordt alleen getoond als het mogelijk is het alarm uit te stellen. Zie de beschrijving van de optie uitstellen in de sectie <link linkend="message-window"
>Venster met alarmbericht</link
> voor details.</para>
</listitem>

<listitem>
<para
>Overal klikken op de melding anders dan op een knop zal het hoofdvenster van &kalarm; activeren, met dat alarm geaccentueerd.</para>
</listitem>

</itemizedlist>

</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 alarm. Een normaal pictogram van &kalarm; toont dat alle alarmen worden bekeken, terwijl twee verschillende gewijzigde pictogrammen aangegeven dat ofwel sommige alarmen of dat alle alarmen, niet worden gemonitord. De wijziging in pictogram hangt af van het pictogramthema dat wordt gebruikt.</para>

<para
>Het pictogram van &kalarm; in het systeemvak is standaard automatisch verborgen wanneer er geen alarmen 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 alarmberichten, die aflopen in de volgende 24 uur, als een tekstballon getoond. U kunt deze functie uitschakelen of het aantal te tonen alarmen 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
>Alarmen inschakelen</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Activeert of deactiveert het monitoren van alarmen.</action
></para>
<para
>Zie <link linkend="enable-disable"
>Herinneringenin- en uitschakelen</link
> for details.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nieuw alarm</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Nadat u het alarmtype uit de verschijnende lijst hebt geselecteerd, opent zich de dialoog Alarmen bewerken om een nieuw alarm 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 alarms- 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 alarmberichtvensters getoond worden.</para>
</listitem>
</varlistentry>
</variablelist>

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

<para
>U moet het &plasma; 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
>Alarmen verversen</title>

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

<para
>U kunt een individuele agenda herladen en zijn alarmen in de lijst met alarmen 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
>Alarmen in- en uitschakelen</title>

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

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

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

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

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

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

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

<sect2>
<title
>Alarmen monitoren inschakelen</title>

<para
>Om alarmen 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 alarmen monitoren nu is uitgeschakeld, doe dan een van het volgende om alarmen in te schakelen:</para>

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

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

</sect2>

<sect2>
<title
>Alarmen monitoren uitschakelen</title>

<para
>U kunt tijdelijk alarmen monitoren uitschakelen, die voorkomt dat &kalarm; alarmen controleert ofwel totdat u alarmen 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
>Alarmen inschakelen</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Klik <mousebutton
>Rechts</mousebutton
> op het pictogram in het systeemvak en deactiveer <menuchoice
><guimenuitem
>Alarmen 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
>Alarmen 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 alarmen in- of uitschakelen</title>

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

<itemizedlist>
<listitem>
<para
>Selecteer een of meer alarmen uit de alarmenlijst 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 alarmen en kies <menuchoice
><guimenuitem
>Inschakelen</guimenuitem
></menuchoice
> uit het contextmenu.</para>
</listitem>
</itemizedlist>

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

<itemizedlist>
<listitem>
<para
>Selecteer een of meer alarmen uit de alarmenlijst 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 alarmen 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
>Alarmen kunnen geconfigureerd worden om uw computer te laten ontwaken uit slaapstand of onderbreking wanneer het alarm afgaat, zodat de alarmactie gedaan kan worden zelfs wanneer het systeem is afgesloten. Het mechanisme dat wordt gebruikt door &kalarm; om het systeem te laten ontwaken, en het gebruikersinterface om het te besturen, hangt af van het type systeem en de rechten van de gebruiker. Er zijn twee mogelijkheden:</para>

<sect2>
<title
>Ontwaken uit slaapstand door de Linux kernel</title>

<para
>Op Linux systemen, als de gebruiker de mogelijkheid heeft van de alarmtimer van de kernel (<literal
>cap_wake_alarm</literal
>), dan kan elk aantal alarmen ingesteld worden om uit onderbreking te ontwaken. In dat geval, wordt ontwaken uit onderbreking geconfigureerd voor elk individueel alarm in de <link linkend="alarm-edit-dlg"
>Dialoog voor bewerken van alarmen</link
> met de optie <guilabel
>Ontwaken uit onderbreking</guilabel
>.</para>

<para
>U kunt configureren hoe lang van voor het alarm te ontwaken uit onderbreking, om er zeker van te zijn dat het systeem tijd heeft om zichzelf volledig te herstellen voordat het alarm afgaat, in de <link linkend="preferences-time"
>Configuratiedialoog</link
>.</para>

</sect2>

<sect2>
<title
>RTC Ontwaken uit slaapstand</title>

<para
>Op niet-Linux systemen, of op Linux systemen waar de gebruiker geen <literal
>cap_wake_alarm</literal
> mogelijkheid heeft, wordt de real time clock (<acronym
>RTC</acronym
>) gebruikt. Dit kan alleen ingesteld worden voor één alarm tegelijk. In dat geval wordt een speciale dialoog Ontwaken-uit-onderbreking gebruikt om het te configureren. De dialoog biedt het alarm Ontwaken uit onderbreking om te worden ingesteld, geannuleerd of getoond. Voor toegang tot de dialoog, selecteer <menuchoice
><guimenu
>Acties</guimenu
> <guimenuitem
>Ontwaken uit onderbreking</guimenuitem
></menuchoice
>.</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 alarm 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 alarmen 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 alarmen in het hoofdvenster van &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Geaccentueerd alarm gebruiken</guibutton
>: deze stelt het alarm die nu is geaccentueerd in de lijst met alarmen zoals het alarm Uit slaapstand ontwaken. Elke bestaande geplande Uit slaapstand ontwaken wordt geannuleerd, zoals boven uitgelegd. De knop is alleen ingeschakeld als exact één alarm 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 het alarm annuleerd; het alarm zelf wordt niet verwijderd en zal normaal verder blijven werken.</para>
</listitem>

<listitem>
<para
><guibutton
>Huidig alarm tonen</guibutton
>: dit accentueert het huidige alarm Uit slaapstand ontwaken in de lijst alarmen, 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 het alarm 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 het alarm te activeren, zodat het alarm op de juiste tijd kan aflopen.</para>
</listitem>
</itemizedlist>

</sect2>
</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
>Uitvoeringsmodus</guilabel
>: dit biedt u te selecteren of &kalarm; automatisch moet worden uitgevoerd, handmatig of helemaal niet.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Automatisch uitvoeren</guilabel
>: dit selecteren om &kalarm; automatisch na aanmelden uit te voeren om te verzekeren dat het altijd actief is. Deze optie moet geselecteerd worden om &kalarm; normaal te laten functioneren en om altijd alarmen te starten.</para>
</listitem>

<listitem>
<para
><guilabel
>Alleen handmatig uitvoeren</guilabel
>: dit selecteren als u het &kalarm; alleen af en toe wilt gebruiken. Het zal niet automatisch actief worden en u moet het handmatig uitvoeren wanneer u het vereist. Nadat het afsluit (of nadat u zich afmeldt), zal het niet langer functioneren of alarmen starten totdat u het handmatig opnieuw start.</para>
</listitem>

<listitem>
<para
><guilabel
>Niet uitvoeren</guilabel
>: dit selecteren als u wilt stoppen met het gebruik van &kalarm;. Het zal niet langer gestart worden bij aanmelden en nadat het afsluit of u meldt zich af, zal het niet langer alarmen starten.</para>

<para
>Merk op dat als u later &kalarm; opnieuw uitvoert na het selecteren van deze optie, &kalarm; weer normaal zal functioneren en automatisch actief zal zijn na aanmelden. Als u nog steeds &kalarm; daarna niet wilt gebruiken, u dan deze optie <guilabel
>Niet uitvoeren</guilabel
> nog eens moet selecteren.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Waarschuwing voor afsluiten</guilabel
>: &kalarm; moet actief zijn om alarmen te starten. Selecteer deze optie zodat wanneer u probeert &kalarm; af te sluiten met de optie <menuchoice
><guimenu
>Afsluiten</guimenu
></menuchoice
> u gewaarschuwd wordt dat alarmen uitgeschakeld zullen worden en gevraagd worden om bevestiging. Voor de veiligheid wordt deze optie standaard automatisch opnieuw ingeschakeld wanneer u de uitvoeringsmodus wijzigt.</para>
</listitem>

<listitem
><para
><guilabel
>Alarmnamen inschakelen</guilabel
>: Specificeer of elk alarm een naam kan worden gegeven om u te helpen deze te identificeren. Dit bepaalt of de kolom <guilabel
>Naam</guilabel
> getoond zal worden in de <link linkend="alarm-list"
>alarmlijst</link
> en of het veld <guilabel
>Alarmnaam</guilabel
> zal verschijnen in de <link linkend="alarm-edit-dlg"
>Dialoog alarm bewerken</link
>.</para>
</listitem>

<listitem
><para
><guilabel
>Bevestig verwijdering van alarmen</guilabel
> Specificeert of u om een bevestiging wilt worden gevraagd, telkens als u een alarm 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 alarm wordt getoond. Merk op dat als een alarm eerder is uitgesteld, het getoonde initiële interval in de Dialoog voor uitstel van een alarm gelijk zal zijn aan de het laatst gebruikte interval voor uitstel nadat het alarm was uitgesteld.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal voor alarmen via een opdrachtregel</guilabel
>: Hier kunt u selecteren welk type terminalvenster gebruikt moet worden voor alarmen 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 het alarm worden achtergevoegd bij wat u specificeert. Alternatief kunt u specificeren waar de commandotekst van het alarm moet worden ingevoegd, door de volgende codes te gebruiken:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>De commandotekst van het alarm zal worden gesubstitueerd.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>De commandotekst van het alarm 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 het alarm 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 het alarm met een <literal
>sleep</literal
> achtergevoegd en het uit te voeren commando zal worden gesubstitueerd.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>De naam van &kalarm; in de huidige taal zal worden gesubstitueerd.</para>
</listitem>
</varlistentry>
</variablelist>

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

<listitem>
<para
><guilabel
>Plug-ins</guilabel
>: deze sectie biedt u het kiezen welke van de geïnstalleerde plug-ins van &kalarm; te gebruiken.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Audio-backend</guilabel
>: kies welk audiosysteem te gebruiken om geluidsbestanden af te spelen. Alleen geïnstalleerd audio-plug-ins staan in de lijst; als er geen geïnstalleerd zijn, dan wordt deze optie niet getoond.</para>
</listitem>

<listitem
><para
><guilabel
>Akonadi inschakelen</guilabel
>: kiese of &akonadi; wordt gebruikt om de mogelijkheden te leveren die er afhankelijk van zijn. Zie <link linkend="akonadi-plugin"
>Akonadi plug-in</link
> voor details. merk op dat deze optie alleen getoond wordt wanneer de Akonadi plug-in is geïnstalleerd.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Tijd &amp; datum</title>

<para
>De sectie <guilabel
>Tijd &amp; 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 alarmen.</para>
</listitem>

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

<listitem
><para
><guilabel
>Ontwaken uit onderbreking voor het alarm</guilabel
>: voer het aantal minuten in voordat het alarm afgaat om het systeem te laten ontwaken, voor alarmen ingesteld om te ontwaken uit onderbreking. Dit biedt u de verzekering dat het systeem tijd heeft om zichzelf volledig te herstellen voordat het alarm afgaat, zodat het alarm af kan gaan op de juiste tijd. Deze optie wordt alleen getoond als de systeemconfiguratie meerder alarmen biedt om het systeem te laten ontwaken uit onderbreking. Zie <link linkend="wake-suspend"
>Ontwaken uit onderbreking</link
> voor meer informatie.</para>
</listitem>

<listitem
><para
><guilabel
>Begin van de dag voor alarmen met alleen een datum</guilabel
>: Stel het tijdstip van het begin-van-de-dag in met het doel alleen-datum alarmen te activeren, &ie; diegene waarvoor de optie <guilabel
>Elke tijd</guilabel
> was geselecteerd. Op de datum wanneer ze aflopen, zullen zulke alarmen 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 alarmen 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 alarmen 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 alarmen:</para>

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

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

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

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

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

<listitem
><para
><guilabel
>Verlopen alarmen verwijderen na</guilabel
>: Stel het aantal dagen in om verlopen en verwijderde alarmen in het archief op te slaan, waarna ze permanent worden verwijderd.</para>
</listitem>

<listitem
><para
><guibutton
>Wis gearchiveerde alarmen</guibutton
>: Deze knop gooit alle nu gearchiveerde alarmen uit de standaard gearchiveerde alarmagenda. (Andere gearchiveerde alarmagenda's blijven ongewijzigd in het geval ze gedeeld worden met andere mensen.) Dit heeft geen invloed op alarmen 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 alarmen via e-mail:</para>

<note
><para
>Opties die afhangen van &kmail; zijn alleen beschikbaar als de <link linkend="akonadi-plugin"
>Akonadi plug-in</link
> van &kalarm; is geïnstalleerd en ingeschakeld.</para>
</note>

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

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Wanneer een alarm via e-mail afloopt, zal de e-mail automatisch verzonden worden met gebruik van &kmail;.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Wanneer een alarm 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 map "verzonden mail" van &kmail;</guilabel
>: Selecteer deze optie als, elke keer dat een alarm via e-mail afloopt, u een kopie van de verzonden e-mail wilt opslaan in de map <filename
>verzonden mail</filename
>.</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 alarm 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 alarmen via e-mail:</para>

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

<listitem
><para
>Selecteer <guilabel
>Standaard adres uit Kmail-identiteit gebruiken</guilabel
> om het e-mailadres dat is ingesteld in de &kmail; te gebruiken.</para>
</listitem>

<listitem
><para
>Selecteer <guilabel
>Identiteiten van &kmail; gebruiken</guilabel
> om in staat te zijn, op het moment dat u een alarm via e-mail configureert, te kiezen welke e-mail-identiteit van &kmail; u wilt gebruiken. De standaard identiteit zal worden gebruikt voor alarmen 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 alarmen 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
>Standaard adres uit Kmail-identiteit gebruiken</guilabel
> om het e-mailadres dat is ingesteld in de &kmail; 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 actief alarm</guilabel
>: Het pictogram in het systeemvak is verborgen als er geen actieve alarmen zijn.</para>
</listitem>

<listitem>
<para
><guilabel
>Automatisch verbergen als geen alarm afloopt in de tijdsperiode</guilabel
>: Het pictogram in het systeemvak is verborgen als geen alarm 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
>Alarmen voor de volgende 24 uur tonen</guilabel
>: Indien geselecteerd zal een samenvatting van de eerste paar alarmen die in de volgende 24 uur aflopen worden getoond.</para>
</listitem>

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

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

<listitem>
<para
><guilabel
>Resterende tijd tot alarm tonen</guilabel
>: Activeer deze optie om de overblijvende tijd te tonen voor geplande verschijning van elk  alarm. 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 het alarm, om het te onderscheiden van de tijd waarop het alarm is gepland.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

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

<para
>Het tabblad <guilabel
>Herinneringsvensters</guilabel
> bevat opties om het uiterlijk van alarmberichtvensters te besturen. De beschikbare opties hangen af van het venstersysteem dat in gebruik is.</para>

<itemizedlist>
<listitem>
<para
><application
>X11 venstersysteem</application
></para>

<itemizedlist>
<listitem>
<para
><guilabel
>Venster ver van de muiscursor plaatsen</guilabel
>: Activeer deze optie om alarmberichtvensters zo ver mogelijk van de huidige positie van de muiscursor te plaatsen. Dit minimaliseert de kans om per ongeluk een alarm 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 alarmberichtvensters in het midden van het scherm te tonen. Om de kans te verkleinen om per ongeluk het alarm 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 alarmberichtvensters modaal zijn of niet, &ie; of ze het toetsenbord focus krijgt wanneer ze verschijnen. Zie de sectie <link linkend="message-display"
>Venster met alarmbericht</link
> voor details.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><application
>Wayland venstersysteem</application
></para>

<itemizedlist>
<listitem>
<para
>Om de kans te verkleinen om per ongeluk het alarm 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>
</itemizedlist>
</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 alarmen te bewerken</link
>:</para>

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

<itemizedlist>
<listitem
><para
>De standaard methode instellen voor tonen van alarmberichten.</para>
</listitem>

<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 alarmen</guilabel
> bevat opties die van toepassing zijn voor specifieke typen alarmen.</para>

<itemizedlist>
<listitem>
<para
>Om alarmen 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 alarmsperioden.</para>
</listitem>

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

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

<listitem>
<para
>Voor alarmen 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 alarmen 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 alarmberichten 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 alarmen 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 nieuw alarm 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 nieuw alarm plannen</title>

<para
>De volgende opties worden gebruikt om een nieuw alarm 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 alarmbericht 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
>Het alarm 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 alarmen uit. Dit voorkomt elk aflopen van een alarm totdat u alarmen 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 alarmbericht 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 alarmbericht 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 het alarm 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 het alarm 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 het alarm 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 het alarm 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
>-n</option
>, <option
>--name <replaceable
>naam</replaceable
></option
></entry>
  <entry
>Een naam specificeren om u te helpen het alarm te identificeren.</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Het alarm als een melding tonen, niet in een venster. <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> en <option
>--auto-close</option
> kunnen niet gespecificeerd worden met deze optie.</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 audioalarm of wanneer het alarmbericht 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 alarmbericht 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 het alarm 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 het alarm moet aflopen of, als een herhaling is gespecificeerd met <option
>--recurrence</option
>, het aantal keren dat het alarm 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 het alarm 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 herhalingsalarm de gespecificeerde tijdsduur voor of na de hoofdalarm 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 het alarm plaatsvinden. Om een herhaling na het alarm 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 herhalingsalarm de gespecificeerde tijdsduur voor of na de verschijning van het alarm uit. Er zal geen herhaling van de worden getoond voor of na opvolgende alarmen (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 getoond. Deze optie vereist dat &kalarm; is gebouwd met ingeschakelde spraak en de &Qt; spraakmodule is geïnstalleerd en werkt. De opties <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>
<!-- test-set-time time (debug mode)-->
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>datum/tijd</replaceable
></option
></entry>
  <entry
>Laat het alarm 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 datumvelden standaard de waarde van vandaag krijgen). 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
>) of <userinput
>UTC</userinput
> die de UTC tijdzone representeert.</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 het alarm 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
>Het Dialoogvenster om alarmen te bewerken tonen om het alarm met de gespecificeerde gebeurtenis-ID te bewerken. De gebeurtenis-ID is de unieke ID van de gebeurtenis, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat <replaceable
>[resourceID:]eventUID</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Dialoogvenster om alarmen te bewerken tonen om een nieuw audioalarm te bewerken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Het Dialoogvenster om alarmen te bewerken tonen, om een nieuw commando-alarm te maken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Dialoogvenster om alarmen te bewerken tonen om een nieuw weergave-alarm te bewerken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Dialoogvenster om alarmen te bewerken tonen om een nieuwe e-mailalarm te bewerken.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>sjabloonnaam</replaceable
></option
></entry>
  <entry
>Dialoogvenster om alarmen te bewerken tonen, met een vooraf ingesteld sjabloon met de gespecificeerde naam om een nieuw alarm te bewerken.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Voer een lijst met geplande alarmen uit naar <filename
>stdout</filename
>. De lijst toont beknopte details van elk wachtend alarm: zijn hulpbron-identifier 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 alarmen volgen uitschakelen</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Zie ook:</para>
<simplelist>
<member
>kf6options(7)</member>
<member
>qt6options(7)</member>
</simplelist>

</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 nieuw alarm plannen</para
></listitem>
<listitem
><para
>een reeds gepland alarm annuleren</para
></listitem>
<listitem
><para
>een reeds gepland alarm activeren</para
></listitem>
<listitem
><para
>Het Dialoogvenster om alarmen te bewerken tonen</para
></listitem>
<listitem
><para
>lijst met geplande alarmen</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 gepland alarm.</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 gebeurtenis om geannuleerd te worden, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

<para
><function
>cancelEvent()</function
> is een &DBus;-aanroep om het gespecificeerde alarm te annuleren. &kalarm; verwijdert het alarm 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 gepland alarm.</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 gebeurtenis om gestart te worden, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beschrijving</title>

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

<para
>Als het alarm is al is afgelopen zal &kalarm; alle geplande gevallen van het alarm tot op het huidige moment verwijderen en, als er geen herhalingen van het alarm over blijven, wordt het alarm uit de agenda verwijderd. Als het alarm 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 alarmbericht.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>name</replaceable
>,
                     const QString&amp; <replaceable
>message</replaceable
>,
                     const QString&amp; <replaceable
>startDateTime</replaceable
>,
                     int <replaceable
>lateCancel</replaceable
>,
                     unsigned <replaceable
>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
>name</replaceable
>,
                     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
>name</replaceable
>,
                     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
>naam</parameter
></term>
<listitem>
<para
>Specificeert een optionele naam voor het alarm.</para>
</listitem>
</varlistentry>

<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 alarm moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD[ TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een alarm 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]</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
>) of <userinput
>UTC</userinput
> die de UTC tijdzone representeert.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm 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 alarmsvlaggen. 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 alarmberichten.</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 hoofdalarm en elk van zijn herhalingen (indien aanwezig) waarop een herhalingsalarm moet worden getoond. Specificeer een negatieve waarde voor een herhaling om te worden getoond na de hoofdalarm. Specificeer 0 als geen herhaling is vereist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van het alarm, 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 herhalend alarm, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor het alarm. 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 het alarm.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. 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 het alarm. 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 het alarm, inclusief het initiële alarm.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beschrijving</title>
<para
><function
>scheduleMessage()</function
> is een &DBus; aanroep om het gespecificeerde alarmbericht 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 alarmen. De andere vormen bieden een gemakkelijke toegang tot een beperkte set van typen herhalingen van alarmen, 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 het alarm te tonen, in welk geval &kalarm; het verzoek negeert). Als de geplande tijd (of een herhaling) zich in de toekomst bevindt zal &kalarm; het alarmbericht toevoegen aan de actieve standaard alarmagenda voor latere weergave.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>plan een nieuw alarm die de inhoud van een tekst- of afbeeldingsbestand toont.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>name</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>startDateTime</replaceable
>,
                  int <replaceable
>lateCancel</replaceable
>,
                  unsigned <replaceable
>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
>name</replaceable
>,
                  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
>name</replaceable
>,
                  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
>naam</parameter
></term>
<listitem>
<para
>Specificeert een optionele naam voor het alarm.</para>
</listitem>
</varlistentry>

<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 alarm moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD[ TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een alarm 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]</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
>) of <userinput
>UTC</userinput
> die de UTC tijdzone representeert.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm 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 alarmsvlaggen. 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 alarmen 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 hoofdalarm en elk van zijn herhalingen (indien aanwezig) waarop een herhalingsalarm moet worden getoond. Specificeer een negatieve waarde voor een herhaling om te worden getoond na de hoofdalarm. Specificeer 0 als geen herhaling is vereist.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van het alarm, 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 herhalend alarm, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor het alarm. 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 het alarm.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. 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 het alarm. 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 het alarm, inclusief het initiële alarm.</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 nieuw alarm plannen die een shellcommando uitvoert.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>vlaggen</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>vlaggen</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>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
>naam</parameter
></term>
<listitem>
<para
>Specificeert een optionele naam voor het alarm.</para>
</listitem>
</varlistentry>

<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 alarm moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD[ TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een alarm 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]</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
>) of <userinput
>UTC</userinput
> die de UTC tijdzone representeert.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm 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 alarmsvlaggen. 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-alarmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van het alarm, 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 herhalend alarm, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor het alarm. 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 het alarm.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. 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 het alarm. 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 het alarm, inclusief het initiële alarm.</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 nieuw alarm plannen die een e-mail stuurt.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>vlaggen</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>vlaggen</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail((const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>addresses</replaceable
>,
                   const QString&amp; <replaceable
>subject</replaceable
>,
                   const QString&amp; <replaceable
>message</replaceable
>,
                   const QString&amp; <replaceable
>attachments</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>, 
                   unsigned <replaceable
>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
>naam</parameter
></term>
<listitem>
<para
>Specificeert een optionele naam voor het alarm.</para>
</listitem>
</varlistentry>

<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 alarm moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD[ TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een alarm 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]</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
>) of <userinput
>UTC</userinput
> die de UTC tijdzone representeert.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm 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 alarmsvlaggen. 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-mailalarmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van het alarm, 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 herhalend alarm, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor het alarm. 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 het alarm.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. 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 het alarm. 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 het alarm, inclusief het initiële alarm.</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 nieuw alarm plannen die een shellcommando uitvoert.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>vlaggen</replaceable
>,
                   const QString&amp; <replaceable
>recurrence</replaceable
>,
                   int <replaceable
>subRepeatInterval</replaceable
>, 
                   int <replaceable
>subRepeatCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>vlaggen</replaceable
>,
                   int <replaceable
>recurType</replaceable
>,
                   int <replaceable
>recurInterval</replaceable
>,
                   int <replaceable
>recurCount</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>name</replaceable
>,
                   const QString&amp; <replaceable
>audioURL</replaceable
>,
                   int <replaceable
>volumePercent</replaceable
>,
                   const QString&amp; <replaceable
>startDateTime</replaceable
>,
                   int <replaceable
>lateCancel</replaceable
>,
                   unsigned <replaceable
>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
>naam</parameter
></term>
<listitem>
<para
>Specificeert een optionele naam voor het alarm.</para>
</listitem>
</varlistentry>

<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 alarm moet de tekenreeks in het formaat <replaceable
>JJJJ-MM-DD[ TZ]</replaceable
> (zoals teruggegeven door <methodname
>QDate::toString(Qt::ISODate)</methodname
>) zijn. Voor een alarm 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]</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
>) of <userinput
>UTC</userinput
> die de UTC tijdzone representeert.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm 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 alarmsvlaggen. 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-alarmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>herhaling</parameter
></term>
<listitem>
<para
>Specificeert een reguliere herhaling van het alarm, 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 herhalend alarm, specificeer een lege tekenreeks.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurType</parameter
></term>
<listitem>
<para
>Specificeert het type herhaling voor het alarm. 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 het alarm.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>endDateTime</parameter
></term>
<listitem>
<para
>Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. 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 het alarm. 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 het alarm, inclusief het initiële alarm.</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 alarmen te bewerken</link
> om een alarm 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 gebeurtenis om bewerkt te worden, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat <replaceable
>[resourceID:]eventUID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Teruggegeven waarde</title>
<para
><returnvalue
>onwaar</returnvalue
> als het gespecificeerde alarm 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 het <link linkend="alarm-edit-dlg"
>Dialoogvenster om alarmen te bewerken</link
> te tonen om het gespecificeerde alarm 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 alarmen te bewerken</link
> om een nieuw alarm 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 alarm. 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 alarmsjabloon waarop het nieuwe alarm 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 alarmen te bewerken</link
> te tonen om een nieuw alarm te bewerken. Als een type alarm is gespecificeerd als parameter, zal een blanco dialoog worden getoond. Alternatief, als een naam van een alarmsjabloon 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 alarmen.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Teruggegeven waarde</title>
<para
>Lijst met alarmen, gescheiden door nieuwe-regel, elk in het formaat <returnvalue
><replaceable
>hulpbron_id</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>tijd</replaceable
> <replaceable
>tekst</replaceable
></returnvalue
></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 alarmen. De lijst toont beknopte details van elk wachtend alarm: zijn hulpbron-identifier 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 alarmen 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 nieuw alarm 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 alarmen 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
>Annuleert het alarm 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>
<row>
  <entry
><option
>--triggerEvent <replaceable
>eventID</replaceable
></option
></entry>
  <entry
>Start het alarm met de gespecificeerde gebeurtenis-id. De gebeurtenis-ID is de unieke ID van de gebeurtenis, optioneel voorafgegaan door de ID van de hulpbron met de gebeurtenis, in het formaat <replaceable
>[resourceID:]eventUID</replaceable
>. De genomen actie is dezelfde als voor de <link linkend="triggerEvent"
>triggerEvent()</link
> &DBus;-aanroep. <option
>--cancelEvent</option
> kan met deze optie niet gespecificeerd worden.</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>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Welke instellingenbestanden gebruikt &kalarm;?</para>
</question>
<answer>
<para
>De configuratie van &kalarm; is opgeslagen in de volgende bestanden in de map <command
>qtpaths --paths GenericConfigLocation</command
> :</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarmrc</filename
> bevat uw voorkeuren voor &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarmresources</filename
> bevat de lijst met alarmagenda's nu in gebruik door &kalarm;.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

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

<para
>Wanneer &kalarm; voor de eerste keer wordt uitgevoerd, maakt het de volgende alarmagenda's aan in de map <command
>qtpaths --paths GenericDataLocation</command
> :</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
> bevat actieve alarmen.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
> bevat gearchiveerde alarmen.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
> bevat sjablonen voor alarmen.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
> is een speciaal agendabestand voor details van alarmen die nu worden getoond, die &kalarm; in staat stelt, wanneer het opnieuw wordt gestart, om alarmen opnieuw te tonen die werden getoond toen het eerder werd gestopt.</simpara>
</listitem>
</itemizedlist>

<para
>U kunt vervolgens deze agenda's vervangen, behalve <filename
>displaying.ics</filename
> of extra alarmagenda's aanmaken in elke locatie die u kiest. U kunt uitvinden welke agendabestanden nu in gebruik zijn door de details van agenda's te bekijken in de lijst alarmagenda's.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>In welk formaat worden alarmen opgeslagen?</para>
</question>
<answer>
<para
>De agendabestanden waarin &kalarm; zijn alarmen 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-kalarmcalendar.html</filename
> die wordt gedistribueerd met &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Wat is de functie van de Akonadi plug-in van &kalarm;?</para>
</question>
<answer>
<para
>&kalarm; gebruikt zijn Akonadi plug-in om alle mogelijkheden te leveren die afhangen van &akonadi; (de &kde; &PIM; opslagservice over bureaubladen). Als deze plug-in niet is geïnstalleerd en ingeschakeld, zullen aan &kalarm; de volgende mogelijkheden ontbreken: <itemizedlist>
<listitem>
<simpara
>E-mails via &kmail; verzenden, waarmee &Sendmail; als de enige optie om e-mails te verzenden overblijft (zie <link linkend="preferences-email"
>E-mailvoorkeuren</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Slepen en loslaten van e-mails.</simpara>
</listitem>
<listitem>
<simpara
>Selectie van e-mailadressen uit &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Importeren van verjaardagen uit &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Migratie van &akonadi; alarmagendahulpbronnen bij de eerste keer uitvoeren van een nieuwe versie van &kalarm;.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Als de plug-in is geïnstalleerd, het kan ingeschakeld en uitgeschakeld worden in het tabblad <link linkend="preferences-general"
>Algemeen</link
> van de configuratiedialoog.</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>

<qandaentry>
<question>
<para
>Hoe kan ik &kalarm; gebruiken op een niet-&plasma; bureaublad?</para>
</question>
<answer>
<para
>Om &kalarm; uit te voeren in een niet-&plasma; 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>
</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, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Documentatie copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2016, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025 &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>

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

