# Het handboek van &kalarm;

David
Jarvie

    &David.Jarvie.mail;

David
Jarvie

    &David.Jarvie.mail;

Ontwikkelaar

&ged.vertaald;&Niels.Reedijk;&Ruben.Van.Laerhoven;
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
&David.Jarvie;
&FDLNotice;
2011-05-13
2.07.00 (&kde; 4.7)

&kalarm; is een persoonlijke planner voor herinneringen, commando's en e-mailberichten voor &kde;.

KDE
kdepim
kalarm
herinnering
herinnering vooraf
takenplanner

## Inleiding

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

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

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

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

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

Schermafbeelding van een berichtvenster van &kalarm;
Herinneringsbericht

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

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

## &kalarm; gebruiken

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

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.

### Typen herinneringen

De beschikbare basisfuncties in &kalarm; voor verschillende typen herinneringen zijn:

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

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

- Herinneringen via e-mail verzenden een e-mail. Er wordt niets getoond, behalve als er een fout optreedt.

- Audioherinneringen spelen een audio-bestand af. Er wordt niets getoond, behalve als er een fout optreedt.

#### Afhandelen van fouten

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

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

### Herinneringslijst

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

Schermafbeelding van het hoofdvenster van &kalarm;
Hoofdvenster

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

Als er de laatste keer bij het uitvoeren van een commandoherinnering, of van een pre- of postherinneringscommando, een fout optrad, wordt er een foutmelding getoond in de kleurenkolom, wat u hierboven kunt terugvinden in Afhandelen van fouten.

#### Het uiterlijk van de herinneringslijst veranderen

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

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

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

#### Gearchiveerde herinneringen

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

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

#### Zoeken in de herinneringslijst

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

Het zoeken wordt als volgt uitgevoerd:

- Herinneringen met tekstbericht: de berichttekst wordt doorzocht.

- Herinneringen die een bestand tonen: er wordt gezocht in het bestandspad/&URL;.

- Herinneringen met shell-commando's: er wordt gezocht in het commando of het shell-script.

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

- Audioherinneringen: er wordt gezocht in het bestandspad/&URL;.

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

### Herinneringen aanmaken en bewerken

#### Een nieuwe herinnering aanmaken

Om een nieuwe herinnering aan te maken, moet u één van volgende stappen doen, en dan het type herinnering selecteren uit de lijst die tevoorschijn komt. Dit toont het Dialoogvenster om herinneringen te bewerken, waarin u herinneringen kan instellen.

- Bestand Nieuw selecteren.

- Rechts klikken op het pictogram in het systeemvak en Nieuwe herinnering kiezen uit het contextmenu.

- Rechts klikken in de herinneringslijst, dan Nieuw kiezen uit het contextmenu.

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

- Volg, om een nieuwe herinnering te baseren op een herinneringssjabloon, de instructies in het deel Herinneringssjablonen.

- Om een nieuwe herinnering te baseren op een reeds bestaande herinnering, markeer de bestaande herinnering in de lijst, en selecteer Bestand Kopiëren. Dit opent het Dialoogvenster om herinneringen te bewerken, met de details van de geselecteerde herinnering reeds ingevuld.

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

- Sleep, om een nieuwe herinnering te creëren die een kopie verzendt van een reeds bestaand e-mailbericht, de originele e-mail vanuit &kmail; naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Selecteer dan de E-mail-optie. Het Dialoogvenster om herinneringen te bewerken zal dan reeds het hele e-mailbericht bevatten, uitgezonderd de afzender.

- Sleep, om een nieuw herinnering aan te maken die een samenvatting toont van een reeds bestaande taak, de taak vanuit &korganizer; of een andere applicatie naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Dit opent het Dialoogvenster om herinneringen tebewerken met de taakinhoud als herinneringstekst.

- U kunt eender welk stuk tekst naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak slepen, waarop het Dialoogvenster om herinneringen tebewerken geopend wordt, met als herinneringstekst dat stuk tekst.

- Sleep, om een herinnering aan te maken die een bestand toont, de &URL; van het tekst- of afbeeldingsbestand naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Dit opent het Dialoogvenster om herinneringen te bewerken en vult daar de bestandsnaam voor u in.

- Sleep, om een audioherinnering aan te maken, de &URL; van het audiobestand naar het hoofdvenster van &kalarm; of naar het pictogram van &kalarm; in het systeemvak. Dit open het Dialoogvenster om herinneringen te bewerken en stelt de bestandsnaam daar voor u in.

- U kunt automatisch herinneringen voor verjaardagen laten aanmaken voor mensen die in het &kaddressbook; staan. Instructies kunt u terugvinden in Verjaardagen importeren uit &kaddressbook;.

#### Een bestaande herinnering aanpassen

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

- Dubbelklikken op de juiste regel in de herinneringslijst.

- De herinnering selecteren door te klikken op de regel in de herinneringslijst. Daarna op Bewerken Bewerken... klikken.

- Rechts klikken op de juiste regel in de herinneringslijst en dan op Bewerken... klikken in het contextmenu.

Dit toont het Dialoogvenster om herinneringen te bewerken.

#### Een herinnering verwijderen/opnieuw activeren

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

- Op Bewerken Verwijderen klikken.

- Rechts klikken op de geselecteerde rijen en op Verwijderen klikken in het contextmenu.

- &Shift;-Delete indrukken om ze te verwijderen zonder bevestiging.

Als u een actieve herinnering verwijdert, wordt deze gearchiveerd als dezereeds ten minste één maal uitgevoerd is geweest voor het verwijderen, en als ingesteld is dat verlopen alarmen gearchiveerd moeten worden. (Gebruik hetConfiguratievenster om in te stellen of, en hoe lang gearchiveerde herinneringen bijgehouden moeten worden.) Als u een gearchiveerde of een nog niet uitgevoerde openstaande herinnering verwijderd, wordt deze permanent verwijderd.

Als de herinnering nog niet verlopen is, kunt u een gearchiveerde herinnering in de herinneringslijst terug activeren. Om dit te bereiken, moet u eerst de gearchiveerde herinneringen zichtbaar maken, zoals beschreven inGearchiveerde herinneringen. Dan:

- Een of meerdere gewenste gearchiveerde herinneringen selecteren in de herinneringslijst door erop te klikken. Dan op Acties Reactiveren klikken.

- Rechts klikken op de gewenste regels in de lijst met verlopen herinneringen en op Reactiveren klikken in het contextmenu.

#### Een herinnering in- of uitschakelen

Zie Herinneringen in- of uitschakelenom te weten te komen hoe herinneringen in- of uitgeschakeld moeten worden, zowel totaal als individueel.

#### Een herinnering instellen om te ontwaken na onderbreken

Zie Ontwaken uit onderbreken voor hoe een herinnering in te stellen om uw systeem uit onderbreken of slaapstand te laten ontwaken.

#### Een herinnering bevestigen

Zie Berichtvenster voor herinneringen om te weten te komen hoe een alarm bevestigd moet worden.

#### Herinneringssjablonen

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

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

Om een herinnering te creëren die gebaseerd is op een sjabloon, opent u het Dialoogvenster om herinneringen te bewerken, met de sjabloondetails reeds ingesteld.

- In het menu het item Bestand Nieuw van sjabloon selecteren, en dan het gewenste sjabloon selecteren.

- Rechts klikken op het pictogram in het systeemvak enNieuwe herinnering van sjabloon selecteren in het contextmenu. Dan het gewenste sjabloon selecteren.

- Het Dialoogvenster om herinneringen te bewerken openen op de gewone manier, en op de knop Sjabloon laden... klikken om een sjabloon te selecteren zodat de herinnering de gewenste gegevens bevat.

##### Sjablonen instellen

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

Om een nieuw herinneringssjabloon te maken, zijn er volgende mogelijkheden:

- Het dialoogvenster voor herinneringssjablonen wordt getoond door in het menu Bestand Sjablonen... aan te klikken; daarna klikt u op Nieuw en kiest u het herinneringstype uit de getoonde lijst. Hiermee opent u een dialoogvenster met een leeg sjabloon dat u kunt invullen.

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

- Een herinnering aanduiden in de herinneringslijst en Bestand Nieuw sjabloon maken... selecteren. Hierdoor wordt het dialoogvenster om herinneringssjablonen te bewerken geopend, met een kopie van de gegevens van de geselecteerde herinnering.

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

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

##### Dialoogvenster om sjablonen te bewerken

Het dialoogvenster om sjablonen te bewerken is gelijkaardig aan het Het dialoogvenster om alarmen te bewerken. De volgende punten zijn anders:

- De naam van de sjabloon invoeren in Naam sjabloon. 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.

- In het kader Tijd moet u een van volgende mogelijkheden selecteren:

  - Standaard tijd als u geen uitvoertijd wilt specificeren.Herinneringen die dan op dit sjabloon gebaseerd worden, zullen in het begin de standaard uitvoertijd gebruiken, die ook bij nieuwe herinneringen gebruikt wordt.

  - Tijd selecteren om een tijd in te voeren waarop de herinnering uitgevoerd moet worden.

  - Alleen datum selecteren om aan te geven dat de herinnering enkel een datum zal bevatten, en geen tijd.

  - Tijdsduur vanaf nu om in te voeren hoe lang (in uren en minuten) het duurt, vanaf het moment dat een herinnering gecreëerd is, voordat deze uitgevoerd wordt.

- In het vak Herhalingsregel in de tab Herhaling moet er geen dag of maand gekozen worden voor respectievelijk wekelijkse of jaarlijkse herhalingen.

#### Agenda's met herinneringen

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

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

Schermafbeelding van het hoofdvenster van &kalarm;, waarin de agendalijst getoond wordt
Hoofdvenster waarin de agendalijst getoond wordt

##### Typen agenda's en opties

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

Type herinnering

  De drie typen herinneringen – actieve herinneringen, verlopen herinneringen en herinneringssjablonen – worden opgeslagen in aparteherinneringsagenda's. Daarom heeft &kalarm; standaard drie aparte agenda's, één voor elk type (zie het deel Vragen en Antwoorden voor meer details), welke u kunt veranderen indien u datwenst.

Type opslag

  &kalarm; kent 3 manieren om herinneringsagenda's op te slaan:

  - Lokaal bestand: Herinneringen worden opgeslagen in een enkel, lokaal bestand in het iCalendar-formaat. Standaard slaat &kalarm; zijn agenda's op in een lokaal bestand (zie Vragen en Antwoorden voor meer details). Lokale bestanden 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 `/`.

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

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

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

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

Status in- of uitgeschakeld

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

Status alleen-lezen

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

  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:

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

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

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

  - Als u geen toelating hebt om te schrijven naar het bestand of de map met de agenda.

  Als u schrijftoegang nodig hebt naar de herinneringen in een agendabestand dat niet beschrijfbaar is, dan kunt u de herinneringen kopiëren door ze te importeren in een beschrijfbaar agendabestand met de volgende contextmenuoptie Importeren... van de agenda (zie Herinneringen importeren uit externe agaenda's).

Standaard agendastatus

  Eén agenda per herinneringstype kan eventueel als standaardagenda voor dat herinneringstype gebruikt worden. Nieuwe herinneringen worden automatisch opgeslagen in de standaardagenda van dat herinneringstype, behalve wanneer u ervoor gekozen hebt een keuzevenster te laten zien voor nieuwe herinneringen en sjablonen in de instellingendialoog.

##### Agenda's gebruiken

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

Toevoegen...

  Een agenda van het geselecteerde type toevoegen aan de lijst. Er wordt u gevraagd een opslagmethode te kiezen, waarna de instellingendialoog van een agenda wordt getoond, waarin u de lokatie van het agendabestand en zijn karakteristieken kunt invoeren. Als er geen bestaande agenda voor herinneringen is, dan wordt er een aangemaakt.

Verwijderen

  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.

Bewerken...

  De geselecteerde agenda bewerken. Dit toont de instellingendialoog voor de geselecteerde agenda.

Herladen

  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;.

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

Opslaan

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

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

Importeren...

  Herinneringen importeren uit een extern agendabestand in de geselecteerde agenda. Dit wordt verder uitgelegd in Importeren van herinneringen uit externe agenda's. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde of alleen-lezen agenda's.

Exporteren...

  Alle herinneringen in de geselecteerde agenda exporteren naar een extern agendabestand. Dit wordt verder uitgelegd in Exporteren van herinneringen naar externe agenda's.. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde agenda's.

Details tonen

  Details tonen van de geselecteerde agenda. Dit toont de locatie van de agenda, het opslagtype en statusinformatie.

Als standaard gebruiken

  De geselecteerde agenda als standaard instellen voor het geselecteerde agendatype. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde of alleen-lezen agenda's.

Kleur instellen...

  Een achtergrondkleur selecteren voor het markeren van de herinneringen uit deze agenda in de lijst met herinneringen. Op deze manier ziet u direct bij welke agenda bepaalde herinneringen behoren.

Kleur weghalen

  Met kleur accentueren voor de herinneringen in deze agenda in herinneringenlijst wissen.

#### Importeren van herinneringen uit externe agenda's

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

- Gebruik Bestand Herinneringen importeren... om herinneringen van alle types (actieve herinneringen, verlopen herinneringen en herinneringssjablonen) te importeren uit de agenda.

  Als u herinneringsagenda's geconfigureerd hebt, zullen herinneringen van elk type toegevoegd worden aan de juiste standaardagenda of als u ervoor gekozen hebt een keuzevenster te laten zien voor nieuwe herinneringen en sjablonen in de instellingendialoog, zal u gevraagd worden welke agenda gebruikt moet worden.

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

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

#### Exporteren van herinneringen naar externe agenda's

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

- Om de huidig geselecteerde herinneringen in de herinneringslijst te exporteren, klikt u rechts op de selectie, en kiest u Exporteren... uit het contextmenu of gebruikt u Bestand Geselecteerde herinneringen exporteren... in het hoofdmenu.

- Om alle herinneringen uit een agenda te exporteren, klikt u rechts op een agenda in de agendalijst en kiest u Exporteren... uit het contextmenu.

#### Importeren van verjaardagen uit &kaddressbook;

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

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

  Als u de herinneringstekst wijzigt, zal de selectielijst van verjaardagen opnieuw gecontroleerd worden.

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

- De overige functies werken juist hetzelfde als bij de Tekstherinneringen in het Dialoogvenster om alarmen te bewerken.

Als u herinnneringsagenda's hebt ingesteld, zullen de herinneringen toegevoegd worden aan de standaardagenda met de actieve herinneirngen, of als u in de instellingendialoog geselecteerd hebt dat er gevraagd moet worden in welke agenda nieuwe herinneringen en sjablonen toegevoegd moeten worden, zal u gevraagd worden welke agenda u wilt gebruiken.gmen ucu agend

#### Ongedaan maken/opnieuw

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

Om de laatste verandering ongedaan te maken, selecteert u Bewerken Ongedaan maken . Om de laatste ongedane actie opnieuw uit te voeren, selecteert u Bewerken Opnieuw .

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

Een andere verandering dan de laatste opnieuw uitvoeren werkt op een gelijkaardige manier met de knop Opnieuw in de werkbalk.

### Het venster voor bewerken van herinneringen

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

U kunt de standaard waarden van vele instellingen in de dialoog "Herinnering bewerken" met het tabblad Bewerken van instellingen.

Schermafbeelding van de eenvoudige versie van het bewerkingsvenster voor afspraken
Eenvoudige versie van het bewerkingsvenster voor getoonde afspraken

Eenvoudige versie van het bewerkingsvenster voor getoonde afspraken

Schermafbeelding van het bewerkingsvenster voor afspraken waar alle opties getoond worden
Het bewerkingsvenster voor getoonde afspraken waar alle opties getoond worden

Het bewerkingsvenster voor getoonde afspraken waar alle opties getoond worden

#### Herinneringsactie

De besturing in het groepsvak Actie hangt af van het type herinnering dat wordt bewerkt.

##### Herinneringen tonen

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

- Tekstbericht om de tekst van een herinneringsbericht in te voeren (die nieuwe-regels mag bevatten) in het tekstvak.

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

- Commando-uitvoer om te specificeren dat de tekst van het herinneringsbericht moet worden gegenereerd door een commando dat wordt uitgevoerd wanneer de herinnering afgaat. Zie Herinneringen met shell-commando onderstaand voor details van hoe het uit voeren commando of script in te voeren.

Het aansturen van het hoe een herinnering te tonen is:

- De optie Geluid Laat u kiezen of een hoorbare herinnering moet klinken wanneer het herinneringsbericht wordt getoond. Kies:

  - Geen om de herinnering zonder geluid te tonen.

  - Piep om pieptoon te laten klinken.

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

  - Geluidsbestand 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.

    In de dialoog Geluidsbestand:

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

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

    - Activeer Volume en pas de schuif aan als u het volume van het geluidsbestand dat afgespeeld moet worden wilt aanpassen.

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

    U kunt de knop Proberen om het geselecteerde geluidsniveau te testen.

- Gebruik de knop Lettertype & kleur... om een lettertype, een voor- en achtergrondkleur voor het herinneringsbericht te selecteren. In de dialoog Lettertype & kleur van herinnering kiezen, activeer Standaard lettertype gebruiken 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 Standaard lettertype gebruiken. (Het standaard lettertype en de kleuren kunnen worden ingesteld in de Instellingendialoog.)

  De geselecteerde kleuren worden getoond in het tekstinvoerveld in het herinneringsbericht.

- Gebruik de knop Speciale acties... om shell-commando's uit te voeren voor of na het tonen van de herinnering. In de dialoog Speciale herinneringsacties:

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

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

    - Wanneer een herinneringsbericht getoond wordt.

    - Wanneer het bericht opnieuw wordt getoond na uitstel van de herinnering.

    - Wanneer het bericht werd getoond op het moment dat u zich afmeldde en dan wordt hersteld wanneer u zich weer aanmeldt.

    - Wanneer een terugkerende herinnering afgaat maar het herinneringsbericht (of een uitgesteld herinneringsbericht) van een vorige gebeurtenis van de herinnering nog steeds zichtbaar is; met andere woorden, wanneer de vorige gebeurtenis van de herinnering nog niet als gezien is gemeld.

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

    - Activeer Bij fout herinnering annuleren om de herinnering te annuleren als de actie voorafgaand aan de herinnering een foutstatus terug geeft. Dit zal voorkomen dat het herinneringsbericht getoond wordt en een actie na een herinnering wordt uitgevoerd.

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

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

    - Wanneer een herinneringsbericht gesloten wordt.

    - Wanneer u de herinnering uitstelt, behalve wanneer de uitgestelde herinnering uiteindelijk is bevestigd.

    - Wanneer het herinneringsbericht gesloten wordt door zich af te melden.

  Zie Herinneringen met shell-commando hieronder voor details over hoe shell-commando's worden uitgevoerd.

##### Herinneringen met shell-commando

Commando-herinneringen voeren een commando uit zonder een herinneringsbericht te tonen.

Deze type herinnering is niet beschikbaar als &kde; in kiosk-modus werkt.

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

De besturing beschikbaar voor Herinneringen met shell-commando command zijn:

- Het keuzevakje Voer een script in laat u kiezen of u een shellcommandoregel of een script invoert.

  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 `SHELL`) en kan elke optie, parameter, piped commando, &etc;, toegestaan door de shell in een enkele regel bevatten.

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

- Gebruik het groepsvak Commandouitvoer om te specificeren wat u wilt doen met alle terminaluitvoer die het commando produceert wanneer het wordt uitgevoerd.

  - Activeer In terminalvenster uitvoeren om te zorgen dat het commando uitgevoerd wordt in een terminalvenster. U kunt het type van het terminalvenster kiezen in de Instellingendialoog.

  - Activeer Naar bestand loggen 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.

  - Activeer Verwerpen om de commando-uitvoer weg te gooien.

##### Herinneringen via e-mail

Herinneringen via e-mail, sturen een e-mail zonder een herinneringsbericht te tonen.

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

Stel de volgende opties in:

- Het afrolmenu Van 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 Van in de Instellingendialoog is ingesteld op &kmail;-identiteiten gebruiken. Ander is uw e-mailadres ingesteld in de Instellingendialoog, waarmee deze optie als niet van toepassing is geworden.

- Activeer Kopie van e-mailbericht naar uzelf sturen om een blinde kopie van de e-mail naar uzelf te sturen wanneer de herinnering wordt geactiveerd. Het e-mailadres waarnaar de kopie zal worden gezonden kan worden ingesteld in de Instellingendialaog, de standaard is uw e-mailadres ingesteld in &kde;-systeeminstellingen.

##### Geluidsherinneringen

Geluidsherinneringen spelen een geluidsbestand af zonder een herinneringsbericht te tonen.

Stel de volgende opties in:

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

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

- Activeer Volume en pas de schuif aan als u het volume van het geluidsbestand dat afgespeeld moet worden wilt aanpassen.

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

#### Uitstel

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

#### Tijd

In het groepsvak Tijd, selecteer ofwel

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

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

- Tijdsduur vanaf nu om hoe lang na nu (in uren en minuten) de herinnering actief moet worden in te voeren.

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

De besturing van de tijdzone wordt alleen getoond wanneer de geselecteerde tijdzone verschilt van de standaard tijdzone ingesteld in de Instellingendialoog of als u op de knop Tijdzone... klikt.

- Kies in het keuzevak de tijdzone die deze herinnering moet gebruiken. Bij het aanmaken van een nieuwe herinnering wordt dit initieel ingesteld op de tijdzone geselecteerd in de Instellingendialoog, die de tijdzone van uw computer is tenzij u deze hebt gewijzigd.

- Activeer Tijdzone negeren als u de lokale computertijd wilt gebruiken (op welke computer &kalarm; op dat moment draait), met negeren van tijdzones.

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

#### Herinnering

For a display alarm, check Reminder if you want to display a reminder either before or after the main alarm and each of its recurrences (if any). Enter how long in advance or afterwards, using the edit controls beside the check box. Note that if the alarm recurs, the reminder period is normally limited to being less than the recurrence or sub-repetition interval.

Herinneringen worden niet getoond voor sub-herhalingen binnen een herhaling. Herinneringen worden alleen getoond voor elke hoofdherhaling van de herinnering.

If the alarm recurs, check Reminder for first recurrence only if you only want a reminder for the alarm's first recurrence. If this is checked, and it is an advance reminder, the reminder period is not subject to the normal limit of being less than the recurrence or sub-repetition interval.

#### Afbreking

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

- Het keuzevakje Annuleren indien te laat bepaalt wat er gebeurt als de herinnering niet kan worden gestart op zijn geplande tijd.

  Check this box to cancel the alarm if it cannot be triggered within a specified time period after the right time. The time period is selected using controls which appear when you check the box. For example, if you enter a time period of 1 hour, the alarm will be triggered at the first opportunity up to an hour after it is due, but if it cannot be triggered within an hour its activation will be canceled.

  The lateness of date-only alarms, &ie; ones for which the Any time option is selected, is calculated from the start-of-day time on the alarm's scheduled date.

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

  Een herinnering kan alleen uitgevoerd worden wanneer u aangemeld bent en wanneer zowel X als &kalarm; actief zijn.

- Activeer Automatisch venster sluiten na deze tijd als u het herinneringsvenster automatisch wilt sluiten als het nog steeds wordt getoond bij het aflopen van de afbreektijd bij te laat.

#### Herhaling

Specificeren of en hoe een alarm herhaald moet worden door gebruikt te maken van het tabblad Herhaling.

The alarm's basic repetition characteristics are displayed for convenience in the title of the Recurrence tab. The recurrence interval is shown first, followed by any sub-repetition interval set up using the Sub-Repetition button.

Stel het herhalingstype of tijdsperiode als volgt in in het groepsvakje Herhalingsregel:

- Om de herinnering eenmalig te starten, selecteer Geen herhaling.

- Select At login to trigger the alarm whenever you log in, until its scheduled end time. Then, at its scheduled end time it will finally be triggered one last time. (Note that an alarm repeated at login will also be triggered any time you restart &kalarm;.)

- To make the alarm recur at regular intervals, select one of the time period types and then enter in the Recur every box how many time periods should elapse between recurrences. For example, to repeat every fortnight, you could select Daily and enter a value of 14, or select Weekly and enter a value of 2. Depending on the time period type selected, you may have further options:

  - Selecteer, voor een wekelijkse herhaling, elke dag van de week waarop u de herinnering wilt uitvoeren.

  - Voor een maandelijkse herhaling kunt u ofwel een vaste datum of een positie(&eg; de tweede dinsdag) selecteren.

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

    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 Herinnering op 29 februari in niet-schrikkeljaren te selecteren:

    - Geen: de herinnering zal alleen optreden op 29 februari in schrikkeljaren (dus nooit in 'gewone' jaren).

    - 28 feb: de herinnering zal gebeuren op 29 februari in schrikkeljaren en op 28 februari in niet-schrikkeljaren.

    - 1 maart: de herinnering zal gebeuren op 29 februari in schrikkeljaren en op 1 maart in niet-schrikkeljaren.

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

In the Recurrence End group box, set the overall recurrence time span as follows:

- Selecteer Geen einde om de herhalingen oneindig door te laten lopen.

- Selecteer Einde na om het totale aantal keren van de herinnering te specificeren.

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

  De einddatum/tijd bepaalt wanneer de laatste hoofdherinnering zal zijn, maar beperkt niet sub-herhalingen. Als sub-herinneringen zijn ingesteld, zullen ze worden gestart als normaal na de laatste hoofdherinnering, onafhankelijk van de einddatum/tijd.

The Exceptions group box allows you to exclude certain date/times from the recurrence which you have set up. Note that these controls are not shown in the simplified form of the Alarm Edit dialog: to see them, click More Options.

- The list of exceptions (&ie; excluded date/times) is shown on the left. To add a new exception, enter a date on the right and press Add. To change an exception, highlight it in the list, enter the new date on the right and press Change. To delete an exception, highlight it in the list and press Delete.

- You can restrict an alarm not to occur on holidays by checking Exclude holidays. This does not change the way the alarm is scheduled; it simply suppresses the alarm whenever it happens to trigger on a holiday. You can select your holiday country or region in the Configuration dialog.

- You can restrict an alarm to occur only during working time by checking Only during working hours. This does not change the way the alarm is scheduled; it simply suppresses the alarm whenever it happens to trigger outside working hours. Work days and working hours are set in the Configuration dialog.

##### Deelherhaling

You can use the Sub-Repetition button to set up a repetition within a repetition. In this case, each time the alarm is due as specified in the main recurrence, instead of being triggered just once it is triggered repeatedly in accordance with your sub-repetition specification. For example, to set up an alarm which repeats every hour from noon to 6 pm each Thursday, you would set up a weekly recurrence on Thursday at 12:00, and use the Sub-Repetition dialog to specify an interval of 1 hour and either a count of 6 or a duration of 6 hours.

In the Sub-Repetition dialog which is displayed when you click the Sub-Repetition button, check Repeat every to set up a repetition, or uncheck it to remove the repetition. If Repeat every is checked, set up the repetition as follows:

- Enter the time interval between repetitions in the controls beside Repeat every. Select the desired time units (&eg; days) and then enter the number of units.

- Specificeer ofwel het aantal herhalingen ofwel de duur:

  - Select Number of times to enter how many times the alarm should be triggered after the main recurrence. So, for example, to make the alarm occur 4 times at each main recurrence, &ie; 3 additional times, you should enter 3 here.

  - Select Duration to enter the total time period during which the alarm should be repeated. This need not be an exact multiple of the repetition interval; it will automatically be rounded down when you click OK.

To prevent overlapping sub-repetitions for the same alarm, a sub-repetition's duration is restricted to be less than the longest interval between main recurrences. Each time the alarm recurs as specified in the main recurrence, any still active sub-repetition which started at the previous recurrence is automatically cancelled.

#### Andere besturing

For display alarms, the Confirm acknowledgment check box lets you specify whether you will be prompted for confirmation when you close the alarm message window. This may be used as a safeguard against accidental acknowledgment of alarms.

Select Show in &korganizer; to add the alarm to &korganizer;'s active calendar, where it will appear as an event without an alarm. This option allows you to track alarms in &korganizer; while still making use of &kalarm;'s functions.

If you later modify or delete the alarm in &kalarm;, the &korganizer; event will be modified or deleted correspondingly. But if you change the event in &korganizer;, the alarm in &kalarm; will not be affected.

Druk op de knop Sjabloon laden om een sjabloon te selecteren om de dialoog alvast in te vullen, zoals beschreven in Herinneringen aanmaken en bewerken.

Press the Try button to test the alarm and check whether it works correctly. The alarm is executed just as if it had been scheduled in the normal way.

Press the OK button when all details are correct, to add the alarm to the scheduled list. Note that when editing an existing alarm, the OK button is disabled while no changes have been made.

### Venster met herinneringsbericht

When an alarm message is due, it is displayed on each &kde; desktop and cannot be covered by ordinary windows, to ensure that you see it. The message window shows the time for which the alarm was scheduled, so that you can see when it popped up if you were away from the computer at the time. If the alarm's scheduled time is in a different time zone from your local computer's setting, its time zone will also be displayed. (For reminder messages, the date/time shown is that for the main alarm or its recurrence, not the reminder message time, and the window title is Reminder.)

Alarm message windows remain visible until you acknowledge them, unless Auto-close window after late-cancelation time was checked in the Alarm Edit dialog. In the case of a recurring alarm, if an unacknowledged message window remains from a previous occurrence of the alarm, the existing window is simply popped up when the alarm recurs. This avoids having to acknowledge multiple copies of the same message should you not wish, or be unable, to acknowledge a message at the time it appears.

The alarm message window provides whichever of the following options are applicable to the displayed alarm:

- Acknowledge the alarm by clicking the Close button. This closes the window (after a prompt for confirmation, if you selected Confirm acknowledgment).

- Edit the alarm by clicking the Edit... button. This displays the Alarm Edit dialog.

- Display options to defer the alarm until later by clicking the Defer... button. Then select Defer to date/time to enter the date and time when the message is to be redisplayed, or select Defer for time interval to enter how long after now (in hours and minutes) the message should be redisplayed. Then click OK to defer the alarm message and close its window.

  The time the alarm is deferred to must be earlier than its next scheduled occurrence or next advance reminder. For this reason, the Defer... button in the alarm message window and the OK button in the Deferral dialog are disabled one minute before the next occurrence or advance reminder.

  Note that if a reminder is configured after the alarm, you can defer the alarm past its reminder time. In this case, the reminder will be suppressed.

  The Defer... button is not available for alarms which are displayed at login due to the Repeat at login option having been selected.

- Stop playing the alarm's sound file by clicking the button showing the stop playing symbol.

- If the alarm message was created by dragging an email from &kmail;, you can directly access the email in &kmail; by clicking the button showing the &kmail; icon. This will select and highlight the email in &kmail;'s folder list.

  If &kmail;'s indexes are regenerated, the link to the email in &kmail; will be lost.

- The button showing the &kalarm; icon provides a convenient way to activate &kalarm;.

You can choose in the Configuration dialog which of two different modes should be used to display alarm message windows:

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

- As a non-modal window. In this mode, the keyboard focus is unaffected when the alarm message window appears, so it will not interfere with your typing. However in this mode the window has no titlebar or frame, so you cannot move it or resize it.

When an alarm is displayed on top of a full screen application, it is shown as a non-modal window regardless of this configuration setting. This is due to a limitation of the window system.

#### Positioning of Message Windows

U kunt in het Configuratiedialoogvenster kiezen welke van de 2 schema's gebruikt moeten worden om de vensters met herinneringsberichten te positioneren:

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

- The windows are displayed in the center of the screen. To reduce the chance of accidentally acknowledging the alarm, the buttons on the window are initially disabled, becoming active only after a configurable delay.

If you have several alarm message windows, or error messages, displayed, you can spread the windows out across the screen to make them all visible, or group them all together again in the top left corner of the screen, by means of the View Spread Windows menu option. If you wish, you can set up a global shortcut key for this action.

### Systeemvakhandeling

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

If you hover the mouse cursor over the system tray icon, a summary of the first few message alarms due in the next 24 hours are displayed as a tooltip. You can switch this feature off, or configure the number of alarms to display and their format, in the Configuration dialog.

Left click on the system tray icon to toggle between displaying and hiding the &kalarm; main window.

Right click on the system tray icon to display its context menu:

Herinneringen inschakelen

  Enables or disables monitoring of alarms.

  See Enabling and Disabling Alarms for details.

Nieuwe herinnering

  After you select the alarm type from the list which appears, opens the Alarm Edit dialog to create a new alarm.

Nieuwe herinnering van sjabloon

  Toont een lijst met herinneringsjablonen in een menu. Als u er een selecteert, wordt het dialoogvenster om herinneringen te bewerken geopend, met de ingevulde details van dat sjabloon.

Afspelen stoppen

  Stopt het afspelen van het geluidsbestand bij afspelen.

Verspreid vensters

  Spreads alarm and error message windows across the screen, or groups them together again.

&kalarm; instellen...

  Toont de instellingendialoog van &kalarm;.

  The Configuration dialog is described in Configuring &kalarm;. It includes options relating to the &kalarm; system tray icon.

Herstellen / minimaliseren

  Herstelt of minimaliseert het hoofdvenster van &kalarm;.

Afsluiten

  Sluit het systeemvakpictogram en hoofdvensters van &kalarm;.

  Sluit &kalarm; af als er geen herinneringsberichtvensters getoond worden.

#### &kalarm; in het systeemvak tonen

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

To display &kalarm; in the system tray, select View Show in System Tray .

To remove &kalarm; from the system tray, deselect View Show in System Tray.

To choose whether or not &kalarm; will be shown at startup in the system tray, use the View tab of the Configuration dialog.

### Herinneringen verversen

If in the unlikely event that any alarm was not triggered when it should have been, you can refresh the alarm list and trigger any missed alarms by selecting Actions Refresh Alarms . This causes &kalarm; to reload all alarm calendars.

You can reload an individual calendar and refresh its alarms in the alarm list by Right clicking the calendar in the calendars list and selecting the Reload menu option. See Alarm Calendars for details.

### Herinneringen in- en uitschakelen

Herinneringen kunnen allemaal tegelijk of individueel worden in- of uitgeschakeld:

- Alarm monitoring applies to alarms as a whole. While alarm monitoring is disabled, no alarms are triggered at all. While alarm monitoring is enabled (the normal situation), all alarms which are not individually disabled will trigger at the appropriate times.

  When alarm monitoring is re-enabled, alarms which would have triggered while it was disabled are now triggered (unless any late-cancel option prevents this). In other words, disabling alarm monitoring has the same effect as stopping &kalarm; – alarms are postponed until it is re-enabled.

- Alarms may be individually enabled and disabled, independently of the alarm monitoring status. So the enabled/disabled status of individual alarms will be unchanged by disabling and then re-enabling alarm monitoring. Unlike alarm monitoring which could potentially be disabled due to &kalarm; not running, individual alarms can only be disabled if you use menu commands to do so.

  When an alarm is individually re-enabled, it is not now triggered if it became due while disabled. In other words, disabling an individual alarm cancels all its occurrences until it is re-enabled.

  An alarm's individual enabled/disabled status is indicated by its color in the alarm list (the color being configurable in the View tab of the Configuration dialog).

For an alarm to trigger, it must be individually enabled as well as alarm monitoring being enabled.

#### Enabling Alarm Monitoring

For alarm monitoring to occur, &kalarm; must be running. Once you run &kalarm;, it will from then on start automatically whenever you log in unless you later disable it in the General tab of the Configuration dialog.

If alarm monitoring is currently disabled, do one of the following to enable alarms:

- Selecteer Acties Herinneringen activeren.

- Right click on the system tray icon and choose Enable Alarms from the context menu.

#### Disabling Alarm Monitoring

You can temporarily disable alarm monitoring, which prevents &kalarm; from checking any alarms either until you re-enable alarms, or – assuming that &kalarm; is configured to start at login – until the next time you log in.

- Unselect Actions Enable Alarms.

- Right click on the system tray icon and uncheck Enable Alarms from the context menu.

- &kalarm; uitvoeren met de commandoregeloptie `--disable-all`.

- Stop &kalarm; as described in Quitting &kalarm;.

Alarms may be permanently disabled by preventing &kalarm; from being started at login using the General tab of the Configuration dialog.

#### Individuele herinneringen in- of uitschakelen

To enable individual alarms which are currently disabled, do one of the following:

- Select one or more alarms by clicking on their entries in the alarm list. Then choose Actions Enable .

- Right click on the desired entries in the alarm list and choose Enable from the context menu.

To disable individual alarms which are currently enabled, do one of the following:

- Select one or more alarms by clicking on their entries in the alarm list. Then choose Actions Disable .

- Right click on the desired entries in the alarm list and choose Disable from the context menu.

### Ontwaken uit onderbreken

It is possible to configure a selected alarm to wake your computer from hibernation or suspension when the alarm triggers, so that the alarm action can occur even when the system was shut down. This function is controlled by a dialog which is accessed by selecting Actions Wake From Suspend. The dialog allows the Wake From Suspend alarm to be set, cancelled or displayed.

Use of the Wake From Suspend function requires administrative privileges. You will be prompted for the root password when you set or cancel a Wake From Suspend alarm.

Wake From Suspend is not supported on some computers, especially older ones, and some computers only support setting a wakeup time up to 24 hours ahead. There may also be restrictions on which suspend mode the function will wake from. You should consider setting up test alarms to check your system's capability before relying on this feature.

Your computer can only schedule a single Wake From Suspend at a time. If you use this function with &kalarm;, you must ensure that this does not conflict with any other application which also uses Wake From Suspend. Whenever an application schedules or clears Wake From Suspend, this cancels any previously set Wake From Suspend, no matter whether set by &kalarm; or any other application.

The Wake From Suspend dialog is used in conjunction with the alarm list in &kalarm;'s main window.

- Use highlighted alarm: this sets the alarm currently highlighted in the alarm list as the Wake From Suspend alarm. Any existing scheduled Wake From Suspend is cancelled, as explained above. The button is enabled only if exactly one alarm is highlighted.

- Cancel wake from suspend: this cancels any existing Wake From Suspend (whether set by &kalarm; or any other application - see above). Note that this only cancels the wakeup function associated with the alarm; the alarm itself is not deleted and will continue to operate as normal.

- Show current alarm: this highlights the current Wake From Suspend alarm in the alarm list, so that it can be identified. The button is disabled if no Wake From Suspend is currently configured.

- The Number of minutes before alarm to wake from suspend control allows you, if you wish, to ensure that the system has time to fully restore itself before the alarm triggers, so that the alarm can trigger at the correct time.

### &kalarm; afsluiten

Quit &kalarm; by selecting File Quit, or Quit in the system tray icon context menu. Alternatively, if the system tray icon is not visible, close all &kalarm;'s windows.

## &kalarm; instellen

To configure &kalarm;'s operation to suit your system and your personal preferences, select Settings Configure &kalarm;.... This displays the Configuration dialog.

### Algemeen

In de sectie Algemeen kunt u het algemene gedrag van &kalarm; beheren:

- Start at login: &kalarm; will be started automatically at &kde; session login, ensuring that &kalarm; runs at all times unless you manually quit.

  This option should always be checked unless you intend to discontinue use of &kalarm;.

  This option is automatically reselected whenever &kalarm; is run. So if you have unchecked this option and want to continue to prevent &kalarm; from running at login, you need to uncheck this option again each time you run &kalarm;.

- Warn before quitting: When alarms are disabled while &kalarm; is not running, selecting this option prompts you for confirmation if you attempt to terminate &kalarm; using the system tray icon's Quit option. This prevents accidental disabling of alarms. For safety, this option is automatically re-enabled by default whenever you change run mode.

- Confirm alarm deletions: Specify whether you should be prompted for confirmation each time you delete an alarm.

- Default defer time interval: Enter the default time interval, in hours and minutes, to show initially when the Defer Alarm dialog is displayed. Note that if an alarm has been deferred previously, the interval shown initially in the Defer Alarm dialog will be equal to the deferral interval used the last time that alarm was deferred.

- Terminal for Command Alarms: Here, you can select which type of terminal window should be used for command alarms which are executed in a terminal window. Some of the most common terminal window applications are preconfigured, &eg; xterm, &konsole;, although only those which are installed on your system will be shown here. You can view the actual command options used for each application by displaying the context help for its radio button.

  If you want to use another application, or want to use one of those listed but with different command options, select Other and enter the command to invoke the terminal window. By default, the alarm's command string will be appended to what you specify. Alternatively, you may specify where the alarm's command string should be inserted, by use of the following codes:

  %c

    The alarm's command string will be substituted.

  %w

    The alarm's command string will be substituted, with a `sleep` appended.

  %C

    A temporary command file containing the alarm's command string will be created, and the command to execute the file will be substituted.

  %W

    A temporary command file containing the alarm's command string will be created with a `sleep` appended, and the command to execute the file will be substituted.

  When the command alarm is triggered, its command string will be quoted before being inserted into the terminal window command.

### Datum en tijd

The Time and Date section lets you set options relating to time and date:

- Time zone: Select your time zone. &kalarm; uses this time zone throughout, except when you override it for individual alarms.

- Holiday region: Select which country's or region's holidays to use. This affects recurring alarms for which the option to exclude holidays is selected.

- Start of day for date-only alarms: Set the start-of-day time for the purposes of triggering date-only alarms, &ie; ones for which the Any time option was selected. On the date when they are due, such alarms will be output at the earliest opportunity during the 24 hours starting from the start-of-day time.

- Working Hours group box: These options let you define your working hours, needed when the Only during working hours option is selected for a recurrence in the Alarm Edit dialog.

  - Alle werkdagen aanvinken.

  - Daily start time: enter the time at which you start work each day.

  - Daily end time: enter the time at which you finish work each day.

- KOrganizer event duration: Enter the event duration to set in &korganizer; for alarms which are copied to &korganizer;. The default duration is zero.

### Opslag

The Storage section lets you choose options for saving and archiving alarms:

- New Alarms & Templates: Specify which calendar to store new alarms and alarm templates in when using multiple alarm calendars:

  - Store in default calendar: New alarms and alarm templates are automatically added to the default alarm calendar without prompting for confirmation.

  - Prompt for which calendar to store in: When you create a new alarm or alarm template and there is more than one writeable alarm calendar, you will be prompted to choose which calendar to save it in. Note that when alarms are saved on expiry, they are always stored in the default archived alarm calendar without prompting.

- Archived Alarms group box: These options control the storage of archived alarms in the default archived alarm calendar.

  - Keep alarms after expiry: Select this option to archive expired and deleted alarms. Deselect it to keep no record of alarms once they cease to be active. Note that deleted alarms are only archived if they have previously been triggered. If you delete an alarm before it ever triggers, it is discarded.

  - Discard archived alarms after: Set the number of days to store expired and deleted alarms in the archive, after which they are permanently deleted.

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

### E-mail

The Email section lets you choose options for sending and addressing email alarms:

- Email client: Specify the email client to be used to send email alarms:

  - KMail: When an email alarm is triggered, the email is sent using &kmail; (which is started first if necessary) as follows:

    - Als de versie van &kmail; hoger of gelijk is aan 1.7, wordt de e-mail automatisch verzonden.

    - If &kmail; is an older version, the email is added to &kmail;'s `outbox` folder for later transmission.

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

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

  This option is not available when &kmail; is selected as the email client, since &kmail; automatically does this.

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

- Select your email address to be used as the sender's address in email alarms:

  - Select From to enter an email address.

  - Select Use address from System Settings to use the email address which is configured in the &kde; System Settings.

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

- Select your email address to be used for sending blind copies of email alarms to yourself when the Copy email to self option is selected:

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

  - Select Use address from System Settings to use the email address which is configured in the &kde; System Settings.

### Beeld

The View section lets you control some aspects of &kalarm;'s appearance. In the General tab:

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

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

  - Show next 24 hours' alarms: When selected, a summary of the first few alarms due in the next 24 hours is displayed.

  - Maximum number of alarms to show: Deselect this option to display all of the next 24 hours' alarms. Select it to set the maximum number of alarms which will be displayed.

  - Show alarm time: Select this option to show the time at which each alarm is scheduled.

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

    - Prefix: Specify a symbol or text to show in front of the length of time until the alarm, to distinguish it from the time at which the alarm is scheduled.

- The Alarm List group box allows the selection of the colors used in the alarm list in &kalarm;'s main window, to show disabled and archived alarms.

The Alarm Windows tab contains options to control the appearance of alarm message windows.

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

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

- Message windows have a titlebar and take keyboard focus: This option controls whether alarm message windows are modal or not, &ie; whether they grab the keyboard focus when they appear. See the Alarm Message Window section for details.

### Bewerken

The Edit section lets you choose default values for the options in the Alarm Edit dialog:

- The General tab contains options which apply to all alarm types.

  - Set the default states for the Show in KOrganizer and Cancel if late check boxes.

  - Het standaard herhalingstype instellen.

  - De standaard afhandeling kiezen voor jaarlijkse gebeurtenissen, gepland op 29 februari, bij niet-schrikkeljaren.

- The Alarm Types tab contains options which apply to specific types of alarm.

  - Om herinneringen te tonen:

    - Set the default states for the Auto-close window after this time and Confirm acknowledgment check boxes.

    - Set the default reminder period units.

    - Set the default special display alarm actions.

    - Set the default sound options. Note that a default sound file may be specified even if the sound type is not set to Sound file.

  - Voor herinneringen met shell-commando:

    - Set the default states for the Enter a script and Execute in terminal window check boxes.

  - Voor herinneringen via e-mail:

    - Set the default state for the Copy email to self check box.

- The Font & Color tab lets you set the default appearance of alarm messages. Select their default font, and foreground and background colors.

## Command Line Operation

When command line parameters are supplied, &kalarm; does not display the list of scheduled alarms as described in Using &kalarm; above. Command line options specific to &kalarm; may be used to perform the following operations:

- een nieuwe herinnering plannen

- control &kalarm;'s display mode

- hulp verkrijgen

Additional command line options are provided primarily to enable other programs to interface to &kalarm;. They are described in the chapter Developer's Guide to &kalarm;.

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

### Een nieuwe herinnering plannen

De volgende opties worden gebruikt om een nieuwe herinnering te plannen:

Optie | Beschrijving
--- | ---
`-a`, `--ack-confirm` | Prompt for confirmation when the alarm message is acknowledged.
`-A`, `--attach URL` | Specify the path or &URL; of a file which is to be attached to the email. This option may be repeated as necessary. `--mail` must be specified with this option.
`--auto-close` | Herinneringvenster automatisch sluiten na verlopen tijdsinterval van de periode `--late-cancel`. `--late-cancel` moet gespecificeerd worden met deze optie.
`-b`, `--beep` | Systeemgeluid weergeven als bericht wordt getoond. `--speak`, `--play` en `--play-repeat` kunnen niet gespecificeerd worden met deze optie.
`--bcc` | Blinde kopie van e-mailbericht naar uzelf sturen. `--mail` moet gespecificeerd worden met deze optie.
`-c`, `--color`, `--colour kleur` | Stel de achtergrondkleur van het bericht in op de gespecificeerde &Qt;-kleurnaam of de hex-code 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg kleur` | Stel de voorgrondkleur van het bericht in op de gespecificeerde &Qt;-kleurnaam of de hex-code 0xRRGGBB.
`-d`, `--disable` | De herinnering uitschakelen. Het zal niet meer uitgevoerd worden totdat het handmatig geactiveerd wordt.
`--disable-all` | Disable alarm monitoring. This prevents any alarms from being triggered until you re-enable alarms or restart &kalarm;, &eg; at next login. `--triggerEvent` cannot be specified with this option.

`-e`, `--exec commandoregel`

Specify a shell command to execute. If specified, this option must be the last &kalarm; option in &kalarm;'s command line. All subsequent command parameters and options are interpreted as forming the command line to execute. `--file` and `--exec-display` and `--mail` cannot be specified with this option. `--ack-confirm`, `--beep`, `--color` and `--colorfg` are ignored with this option.

`-E`, `--exec-display commandoregel` | Specify a shell command to execute to generate the alarm message text. If specified, this option must be the last &kalarm; option in &kalarm;'s command line. All subsequent command parameters and options are interpreted as forming the command line to execute. `--exec`, `--file` and `--mail` cannot be specified with this option.
`-f`, `--file URL` | Specify the path or &URL; of a text or image file whose contents are to form the alarm message. `--exec`, `--exec-display` and `--mail` cannot be specified, and message must not be present with this option.
`-F`, `--from-id ID` | Use the specified &kmail; identity as the sender of the email. `--mail` must be specified with this option.

`-i`, `--interval periode`

Set the interval between repetitions of the alarm. Hours/minutes are specified in the format nHnM, where n is a number, &eg; 3H30M. Other time periods are specified in the format nX, where n is a number and X is one of the following letters: Y (years), M (months), W (weeks), D (days). If `--recurrence` is also specified, Y (years) and M (months) are not allowed. Mandatory if `--repeat` or `--until` is specified.

`-k`, `--korganizer` | Show the alarm as an event in &korganizer;'s active calendar.
`-l`, `--late-cancel periode` | Cancel the alarm if it cannot be triggered within the specified period after the correct time. Hours/minutes are specified in the format nHnM, where n is a number, &eg; 3H30M. Other time periods are specified in the format nX, where n is a number and X is one of the following letters: W (weeks), D (days). The default value of period is 1 minute.
`-L`, `--login` | Trigger the alarm every time you log in. `--interval`, `--repeat` and `--until` cannot be specified with this option.
`-m`, `--mail adres` | Send an email to the specified address. This option may be repeated as necessary. `--exec`, `--exec-display` and `--file` cannot be specified with this option. `--ack-confirm`, `--beep`, `--color` and `--colorfg` are ignored with this option.
`-p`, `--play URL` | Specify the path or &URL; of an audio file to be played once, either as an audio alarm or when the alarm message is displayed. `--play-repeat`, `--beep` and `--speak` cannot be specified with this option.
`-P`, `--play-repeat URL` | Specify the path or &URL; of an audio file to be played repeatedly, either until Stop Play is used, or for as long as the alarm message is displayed. `--play`, `--beep` and `--speak` cannot be specified with this option.
`--recurrence spec` | Set the alarm to recur. Specify the recurrence using iCalendar syntax (defined in RFC2445), &eg; FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. `--until` cannot be specified with this option.

`-r`, `--repeat aantal`

Set the number of times the alarm should be triggered, or if a recurrence is specified with `--recurrence`, the number of times the alarm should be triggered each time `--recurrence` activates it (&ie; a repetition within a recurrence). If `--recurrence` is not present, specify -1 to repeat the alarm indefinitely. `--interval` must be, and `--until` cannot be, specified with this option.

`-R`, `--reminder periode`

Output a reminder alarm the specified length of time before or after the main alarm and each of its recurrences (if any). The period is specified in the same format as described for `--late-cancel`. By default, the reminder will occur before the alarm. To specify a reminder after the alarm, prefix period with +, &eg; +3D. This option cannot be specified with `--exec`, `--mail` or `--reminder-once`.

`--reminder-once periode` | Output a reminder alarm once, the specified length of time before or after the first recurrence of the alarm. No reminder will be displayed before or after subsequent recurrences (if any). The period is specified in the same format as described for `--reminder`. This option cannot be specified with `--exec`, `--mail` or `--reminder`.
`-s`, `--speak` | Speak the message when it is displayed. This option requires &jovie; to be installed and configured, together with a compatible speech synthesizer. `--beep`, `--play` and `--play-repeat` cannot be specified with this option.
`-S`, `--subject onderwerp` | The subject line of the email. `--mail` must be specified with this option.

`-t`, `--time datum/tijd`

Trigger alarm on the date or at the date/time specified. Specify a date without a time in the format yyyy-mm-dd [TZ]; specify a date and time by [[[yyyy-]mm-]dd-]hh:mm [TZ] (where omitted, date fields default to the values for today). If no time zone is specified, the local system time zone is assumed. If a time zone specifier TZ is present, it may be the name of a system time zone (&eg; `Europe/London`), `UTC` representing the UTC time zone, or `Clock` to use the local computer clock and ignore time zones.

`-v`, `--volume percentage` | Set the audio volume for playing the audio file. This option can only be used when `--play` or `--play-repeat` is specified.
`-u`, `--until datum/tijd` | Repeat the alarm until the date or date/time specified. Specify the date or date/time using the same syntax as for `--time`. Note that if `--time` is specified, the time zone will be taken from its value and no time zone may be included in the `--until` value. `--interval` must be, and `--repeat` and `--recurrence` cannot be, specified with this option.
bericht | Te tonen berichttekst of, als `--mail` opgegeven is, de inhoud van het e-mailbericht.

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

Twee verschillende voorbeelden om een bericht met meerdere regels en een rode achtergrond te tonen op de 27ste van deze maand zijn:

    % kalarm -c red -t 27-22:00 "Remember to\nSTOP"
    % kalarm -c 0xFF0000 -t 27-22:00 "Remember to\nSTOP"

### Andere opties

The following options are used to display the Alarm Edit dialog, or to control &kalarm;'s display mode.

Optie | Beschrijving
--- | ---
`--edit eventID` | Display the Alarm Edit dialog to edit the alarm with the specified event ID.
`--edit-new-audio` | Display the Alarm Edit dialog, in order to edit a new audio alarm.
`--edit-new-command` | De dialoog om alarmen te bewerken tonen, om een nieuwe commando-herinnering te maken.
`--edit-new-display` | Display the Alarm Edit dialog, in order to edit a new display alarm.
`--edit-new-email` | Display the Alarm Edit dialog, in order to edit a new email alarm.
`--edit-new-preset sjabloonnaam` | Display the Alarm Edit dialog, preset with the alarm template of the specified name, in order to edit a new alarm.
`--tray` | &kalarm; als een pictogram tonen in het systeemvak.

### Help-opties

De volgende help-opties gelden voor alle &kde;-programma's:

Optie | Beschrijving
--- | ---
`--help` | Een korte helptekst met opties tonen.
`--help-qt` | Shows numerous generic &Qt;-specific options.
`--help-kde` | Shows numerous generic &kde;-specific options.
`--help-all` | Alle opties tonen.
`--author` | De namen en e-mailadressen van de &kalarm;-auteurs tonen.
`-v`, `--version` | De huidige versies van de &Qt;-bibliotheek, &kde; en &kalarm; tonen.
`--license` | Licentie-informatie tonen.

## Developer's Guide to &kalarm;

&kalarm; provides an interface to allow other applications to request the following functions:

- een nieuwe herinnering plannen

- een reeds geplande herinnering annuleren

- een reeds geplande herinnering activeren

- de dialoog om alarmen te bewerken tonen

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

### &DBus;-interface

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

cancelEvent

#### cancelEvent

Annuleer een reeds geplande herinnering.

    void cancelEvent(const QString& eventID)

##### Parameters

`eventID`

  Specificeert de unieke ID van de te annuleren gebeurtenis.

##### Beschrijving

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

triggerEvent

#### triggerEvent

activeert een reeds geplande herinnering.

    void triggerEvent(const QString& eventID)

##### Parameters

`eventID`

  Specificeert de unieke ID van de te activeren gebeurtenis.

##### Beschrijving

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

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

scheduleMessage

#### scheduleMessage

plan een nieuw herinneringsbericht.

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parameters

`bericht`

  Specifies the text of the message to be scheduled, or if `flags` has the `DISPLAY_COMMAND` bit set, specifies the command line to execute to generate the message text.

`startDateTime`

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

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

`lateCancel`

  Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.

`flags`

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class `KAlarmIface` in `kalarmiface.h`. Note that not all flag bits are applicable to message alarms.

`bgColor`

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

`fgColor`

  Specifies the foreground color for displaying the message. The format of the string is the same as for `bgColor`, or alternatively set the string to null to specify the current default foreground color.

`lettertype`

  Specifies the font for displaying the message. The format of the string is that output by `QFont::toString()`. Set the string to null to use the default message font current at the time the message is displayed.

`audioURL`

  Specifies the audio file which is to be played when the message is displayed. Set the value to null if no audio file is to be played.

`reminderMins`

  Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify a negative value for a reminder to be displayed after the main alarm. Specify 0 if no reminder is required.

`herhaling`

  Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in RFC2445. For example, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.

`recurType`

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class `KAlarmIface` in `kalarmiface.h`. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the `startDateTime` parameter.

`recurInterval`

  Specifies the number of periods (minutes/days/weeks/months/years as specified by `recurType`) between recurrences of the alarm.

`recurCount`

  Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

`endDateTime`

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

`subRepeatInterval`

  Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.

`subRepeatCount`

  Specifies the number of sub-repetitions of the alarm, including the initial occurrence.

##### Beschrijving

`scheduleMessage()` is a &DBus; call to schedule the specified alarm message for display at the specified date and time. It has three forms. The most general form allows an arbitrary recurrence to be specified – use this also for non-repeating alarms. The other forms provide convenient access to a restricted set of alarm recurrence types, one specifying a repetition count and the other an end time.

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

scheduleFile

#### scheduleFile

schedule a new alarm which displays the contents of a text or image file.

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      const QString& recurrence,
                      int subRepeatInterval,
                      int subRepeatCount)

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      int recurCount)

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      const QString& endDateTime)

##### Parameters

`URL-adres`

  Specifies the text or image file whose contents are to be displayed in the message to be scheduled.

`startDateTime`

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

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

`lateCancel`

  Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.

`flags`

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class `KAlarmIface` in `kalarmiface.h`. Note that not all flag bits are applicable to file alarms.

`bgColor`

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

`audioURL`

  Specifies the audio file which is to be played when the message is displayed. Set the value to null if no audio file is to be played.

`reminderMins`

  Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify a negative value for a reminder to be displayed after the main alarm. Specify 0 if no reminder is required.

`herhaling`

  Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in RFC2445. For example, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.

`recurType`

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class `KAlarmIface` in `kalarmiface.h`. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the `startDateTime` parameter.

`recurInterval`

  Specifies the number of periods (minutes/days/weeks/months/years as specified by `recurType`) between recurrences of the alarm.

`recurCount`

  Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

`endDateTime`

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

`subRepeatInterval`

  Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.

`subRepeatCount`

  Specifies the number of sub-repetitions of the alarm, including the initial occurrence.

##### Beschrijving

`scheduleFile()` is a &DBus; call to schedule the specified text or image file for display at the specified date and time. Apart from specifying a file path or &URL; and omitting the foreground color and font, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleCommand

#### scheduleCommand

een nieuwe herinnering plannen die een shellcommando uitvoert.

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parameters

`commandLine`

  Specificeert het commando waarvan de uitvoering moet worden gepland. De parameter `flags` geeft aan of deze parameter een shell-commandoregel bevat of een commandoscript.

`startDateTime`

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

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

`lateCancel`

  Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.

`flags`

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class `KAlarmIface` in `kalarmiface.h`. Note that not all flag bits are applicable to command alarms.

`herhaling`

  Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in RFC2445. For example, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.

`recurType`

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class `KAlarmIface` in `kalarmiface.h`. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the `startDateTime` parameter.

`recurInterval`

  Specifies the number of periods (minutes/days/weeks/months/years as specified by `recurType`) between recurrences of the alarm.

`recurCount`

  Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

`endDateTime`

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

`subRepeatInterval`

  Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.

`subRepeatCount`

  Specifies the number of sub-repetitions of the alarm, including the initial occurrence.

##### Beschrijving

`scheduleCommand()` is a &DBus; call to schedule the specified shell command line, or command script, for execution at the specified date and time. Apart from specifying a command and omitting the message color, font and audio file parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleEmail

#### scheduleEmail

een nieuwe herinnering plannen die een e-mail stuurt.

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       const QString& recurrence,
                       int subRepeatInterval,
                       int subRepeatCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       const QString& endTime)

##### Parameters

`fromID`

  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 E-mailvoorkeuren in &kalarm; is ingesteld worden gebruikt.

`adressen`

  Een door kommagescheiden lijst met e-mailadressen van ontvangers.

`onderwerp`

  Specificeert de regel met het onderwerp van de e-mail.

`bericht`

  Specifies the email message body.

`bijlagen`

  A comma-separated list of paths or &URL;s of files to send as email attachments.

`startDateTime`

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

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

`lateCancel`

  Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.

`flags`

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class `KAlarmIface` in `kalarmiface.h`. Note that not all flag bits are applicable to email alarms.

`herhaling`

  Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in RFC2445. For example, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.

`recurType`

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class `KAlarmIface` in `kalarmiface.h`. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the `startDateTime` parameter.

`recurInterval`

  Specifies the number of periods (minutes/days/weeks/months/years as specified by `recurType`) between recurrences of the alarm.

`recurCount`

  Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

`endDateTime`

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

`subRepeatInterval`

  Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.

`subRepeatCount`

  Specifies the number of sub-repetitions of the alarm, including the initial occurrence.

##### Beschrijving

`scheduleEmail()` is a &DBus; call to schedule the specified email for sending at the specified date and time. Apart from specifying the email header and contents and omitting the message color, font and audio file parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleAudio

#### scheduleAudio

een nieuwe herinnering plannen die een shellcommando uitvoert.

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       const QString& recurrence,
                       int subRepeatInterval,
                       int subRepeatCount)

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       const QString& endDateTime)

##### Parameters

`audioURL`

  Specificeert het geluidsbestand dat afgespeeld moet worden.

`volumePercent`

  Specifies the volume level to use, as a percentage of full volume. Specify -1 to use the default volume.

`startDateTime`

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

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

`lateCancel`

  Causes the alarm to be canceled if it cannot be triggered within the specified number of minutes after the alarm's scheduled time. If the value is 0, the alarm will not be canceled no matter how late it is triggered.

`flags`

  Specifies the logical OR of the desired alarm flags. The flag bits are those defined in class `KAlarmIface` in `kalarmiface.h`. Note that not all flag bits are applicable to command alarms.

`herhaling`

  Specifies a regular recurrence for the alarm, using iCalendar syntax as defined in RFC2445. For example, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO would specify 4 repetitions at 3-monthly intervals on the last Monday of the month. For a non-recurring alarm, specify an empty string.

`recurType`

  Specifies the recurrence type for the alarm. The permissible values are MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. These are defined in class `KAlarmIface` in `kalarmiface.h`. Monthly recurrences are of the day of the month type, and yearly recurrences are of the date in the year type, with the date in both cases taken from the `startDateTime` parameter.

`recurInterval`

  Specifies the number of periods (minutes/days/weeks/months/years as specified by `recurType`) between recurrences of the alarm.

`recurCount`

  Specifies the number of times that the alarm should be repeated. Specify -1 to repeat the alarm indefinitely.

`endDateTime`

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

`subRepeatInterval`

  Specifies the number of minutes between sub-repetitions of the alarm. Specify 0 for no sub-repetition. Ignored if no recurrence is specified.

`subRepeatCount`

  Specifies the number of sub-repetitions of the alarm, including the initial occurrence.

##### Beschrijving

`scheduleAudio()` is a &DBus; call to schedule the specified audio file to be played at the specified date and time. Apart from specifying a volume and omitting the message color and font parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

bewerken

#### bewerken

Display the Alarm Edit dialog to edit an alarm.

    bool edit(const QString& eventID)

##### Parameters

`eventID`

  Specifies the unique ID of the event to be edited.

##### Teruggegeven waarde

onwaar als de gespecificeerde herinnering niet gevonden kon worden of alleen-lezen is, anders waar.

##### Beschrijving

`edit()` is a &DBus; call to display the Alarm Edit dialog to edit the specified alarm.

editNew

#### editNew

Display the Alarm Edit dialog to edit a new alarm.

    bool editNew(int type)

    bool editNew(const QString& templateName)

##### Parameters

`type`

  Specificeert het type herinnering. De toegestane waarde zijn DISPLAY, COMMAND, EMAIL, AUDIO. Deze worden gedefinieerd in klasse `KAlarmIface` in `kalarmiface.h`.

`sjabloonNaam`

  Specificeert de naam van een herinneringssjabloon waarop de nieuwe herinnering op gebaseerd worden.

##### Teruggegeven waarde

false als `type` een ongeldige waarde heeft of geen sjabloon met de naam `sjabloonNaam` gevonden kan worden; anders true.

##### Beschrijving

`editNew()` is a &DBus; call to display the Alarm Edit dialog to edit a new alarm. If an alarm type is specified as a parameter, a blank dialog is displayed. Alternatively, if an alarm template name is specified as a parameter, the dialog is preset with details from the template.

### Commandoregel-interface

Command line options are provided to enable other programs to start up &kalarm; if it is not already running, in order to trigger or cancel scheduled alarms, or schedule new alarms. The reason for using command line options for this purpose is that if &kalarm; were started without any command line parameters and then sent &DBus; requests, it would start in its default graphical mode, which is clearly undesirable for an inter-program request.

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.

The command line options for scheduling a new alarm are as described in the chapter Command Line Operation. The options for triggering and canceling scheduled alarms are as follows:

Normale gebruikers kunnen ook, als zij dat willen, deze opties op de commandoregel gebruiken (aannemend dat ze de nodige parameters kunnen leveren).

Optie | Beschrijving
--- | ---
`--cancelEvent eventID` | Annuleer de herinnering met de gespecificeerde gebeurtenis-id. `--triggerEvent` kan niet worden gespecificeerd met deze optie.
`--triggerEvent eventID` | Start de herinnering met de gespecificeerde gebeurtenis-id. De uitgevoerde actie is hetzelfde als voor de aanroep van triggerEvent() &DBus;. `--cancelEvent` kan niet worden gespecificeerd met deze optie.

Voorbeelden zijn:

    % kalarm --triggerEvent &kalarm;-387486299.702
    % kalarm --cancelEvent &kalarm;-388886299.793

## Vragen en antwoorden

&reporting.bugs; &updating.documentation;

Welke instellingenbestanden gebruikt &kalarm;?

`$KDEHOME/share/config/kalarmrc` bevat uw voorkeuren voor &kalarm;.

`$KDEHOME/share/config/kresources/alarms/stdrc` bevat uw configuratie van de herinneringsagenda.

($`KDEHOME` is gewoonlijk `˜/.kde` of iets soortgelijks.)

Waar worden de herinneringen van &kalarm; opgeslagen?

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

- `$KDEHOME/share/apps/kalarm/calendar.ics` bevat de actieve herinneringen (overschrijfbaar door het item `Calendar`).

- `$KDEHOME/share/apps/kalarm/expired.ics` bevat verlopen herinneringen (overschrijfbaar door het item `ExpiredCalendar`).

- `$KDEHOME/share/apps/kalarm/template.ics` bevat de herinneringssjablonen (overschrijfbaar door het item `TemplateCalendar`).

You can find out which calendar files are currently in use by viewing each calendar's details in the alarm calendars list. The file names are stored in the alarm calendar configuration file.

Details van nu getoonde herinneringen worden opgeslagen in het agendabestand `$KDEHOME/share/apps/kalarm/displaying.ics`.

In welk formaat worden herinneringen opgeslagen?

The calendar files in which &kalarm; stores its alarms are text files whose format is defined by the document RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). This is the standard format used by all kdepim applications. &kalarm; uses certain non-standard properties, in conformance with RFC2445. These are documented in the `DESIGN.html` file which is distributed with &kalarm;.

Wat is het programma kalarmautostart?

kalarmautostart is een klein hulpprogramma waarvan de functie het automatisch starten van &kalarm; bij aanmelden is.

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

Om dit probleem te vermijden wordt kalarmautostart 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.

## Dankbetuigingen en licentie

&kalarm;

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

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

&meld.fouten;&vertaling.niels;&vertaling.freek; &underFDL; &underGPL;

Dank aan de auteur van de &kde; 1 KAlarm applicatie, Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, die vriendelijk toestemming gaf om de naam &kalarm; voor deze applicatie te gebruiken, die beschikbaar is vanaf &kde; 2.

## Installatie

### Hoe &kalarm; te verkrijgen

&install.intro.documentation;

&kalarm; is ook beschikbaar als standalone pakket voor &kde; 4, evenals voor oudere versies voor &kde; 3 en &kde; 2 vanaf http://www.astrojar.org.uk/kalarm

### Benodigdheden

&kalarm; requires the standard &kde; libraries to be installed (the `kdelibs` and `kdepimlibs` packages), plus the `kdebase/runtime` package. To compile from source, you also need the relevant library development packages, and the &Qt; development package.

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

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

U kunt een lijst met wijzigingen vinden in het bestand `Changelog` of bij http://www.astrojar.org.uk/kalarm.

### Compilatie en installatie

If you cannot obtain a suitable precompiled binary package, you need to compile &kalarm; yourself from source files. Get the source package file `kdepim-x.x.tar.bz2` or `kalarm-x.x.tar.bz2` (or similar), depending on whether you want to install &package; or just &kalarm;. Unpack it in a new folder using a command similar to ``tar` `xvfj package.tar.bz2``, and change to the folder which has been created.

&install.compile.documentation;

Als u &kalarm; installeert in een map anders dan waar &kde; is geïnstalleerd, zal het niet goed draaien tenzij u zijn locatie aan &kde; bekend maakt. Hiervoor moet u de omgevingsvariabele `KDEDIRS` vooraf laten gaan met locatie van &kalarm;, elke keer voordat u &kde; start.

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

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

``./configure` --enable-doc-language="fr en_GB"`

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

### Configuratie

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

Om &kalarm; uit te voeren in een niet-&kde; omgeving, moet u controleren dat &kalarm; automatisch wordt opgestart wanneer u zichzelf aanmeldt. Gedetailleerde instructies vindt u in het `INSTALL`-bestand, dat meegeleverd wordt met &kalarm;.

&documentation.index;