# Het handboek van &kalarm;

David
Jarvie

    &David.Jarvie.mail;

David
Jarvie

    &David.Jarvie.mail;

Ontwikkelaar

&Niels.Reedijk;&Ruben.Van.Laerhoven;&Freek.de.Kruijf;
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2016
2018
2019
2020
&David.Jarvie;
&FDLNotice;
2020-07-16
3.0.0 (Applications 20.08)

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

KDE
kdepim
kalarm
alarm
alarm vooraf
takenplanner

## Inleiding

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

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

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

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

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

Schermafbeelding van een berichtvenster van &kalarm;
Herinneringsbericht

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

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 alarmen

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

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

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

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

- Audio-alarmen 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 alarm, 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 commando-alarm een fout optrad, wordt er een wit-op-rood uitroepteken getoond in de kolom met kleuren bij de berichten. Details van de fout worden weergegeven in een tekstballon wanneer u uw muisaanwijzer op die regel in de lijst met alarmen zet. Dezelfde foutmeldingen worden getoond bij schermalarmen als er een uitvoerfout optrad bij een commando voor of na het alarm (zoals gedefinieerd in het dialoogvenster Speciale Acties), maar hier zonder de rode achtergrond in de kleurenkolom.

### Lijst met alarmen

Het hoofdvenster van &kalarm; toont de huidige lijst met openstaande alarmen. 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 terugkerend alarmwordt de tijd getoond waarop de eerstvolgende keer het alarm plaatsvindt. Voor een alarm met een herinnering vooraf, wordt de tijd getoond van het alarm zelf, niet van de herinnering vooraf.) Een pictogram links van elke alarmtekst/bestand/commando/e-mailonderwerp duidt het type alarm aan.

Schermafbeelding van het hoofdvenster van &kalarm;
Hoofdvenster

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

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

#### Het uiterlijk van de alarmenlijst veranderen

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

U kunt als optie de resterende tijd tot elk alarm afloopt tonen, samen met, of in plaats van, de geplande tijd van het alarm.

U kunt selecteren welke kolommen te tonen of te verbergen door Rechts te klikken op de kolomkop en het contextmenu gebruiken om de te tonen kolommen in te stellen. Maar merk op dat de kolom Melding, bestand of Commando en minstens een van de kolommen Tijd of Tijd tot, altijd worden getoond.

Als u meerdere kalenders gebruikt, kunt u een achtergrondkleur instellen voor kalenders. De bijbehorende alarmen zullen dan ook die kleurcode krijgen (zie Agenda's gebruiken).

#### Gearchiveerde alarmen

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

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

#### Zoeken in de alarmenlijst

U kunt de alarmenlijst doorzoeken om alarmen 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 alarmen 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:

- Alarmen met tekstbericht: de berichttekst wordt doorzocht.

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

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

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

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

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

### Alarmen aanmaken en bewerken

#### Een nieuw alarm aanmaken

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

- Bestand Nieuw selecteren.

- Rechts klikken op het pictogram in het systeemvak en Nieuw alarm kiezen uit het contextmenu.

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

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

- Volg, om een nieuw alarm te baseren op een alarmsjabloon, de instructies in het deel Alarmsjablonen.

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

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

- Sleep, om een nieuw alarm te creëren dat een kopie verzendt van een reeds bestaand e-mailbericht, het originele e-mailbericht vanuit &kmail; naar het hoofdvenster van &kalarm;. Selecteer dan de optie E-mail alarm. Het Dialoogvenster om alarmen te bewerken zal dan reeds het hele e-mailbericht bevatten, uitgezonderd de afzender.

- Sleep, om een nieuw alarm aan te maken dat een samenvatting toont van een reeds bestaande taak, de taak vanuit &korganizer; of een andere applicatie naar het hoofdvenster van &kalarm;. Dit opent het Dialoogvenster om alarmen te bewerken met de taakinhoud als alarmtekst.

- Sleep, om een nieuw alarm met shell-commando aan te maken de tekst van een script, die begint met #!, naar het hoofdvenster van &kalarm;. Selecteer dan de optie E-mail. Het Dialoogvenster om alarmen te bewerken zal dan reeds de tekst van het script bevatten.

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

- Sleep, om een audio-alarm aan te maken, de &URL; van het audiobestand naar het hoofdvenster van &kalarm;. Dit open het Dialoogvenster om alarmen te bewerken en stelt de bestandsnaam daar voor u in.

- Sleep, om een tekstalarm aan te maken, elk stuk tekst naar het hoofdvenster van &kalarm;. Indien gevraagd, selecteer dan de optie Alarm weergave. Dit opent Dialoogvenster om alarmen te bewerken met de tekst van het alarm al ingesteld.

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

#### Een bestaand alarm aanpassen

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

- Dubbelklikken op de juiste regel in de alarmenlijst.

- De alarm selecteren door te klikken op de regel in de alarmenlijst. Daarna op Bewerken Bewerken... klikken.

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

Dit toont het Dialoogvenster om alarmen te bewerken.

#### Een alarm verwijderen/opnieuw activeren

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

- 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 actief alarm verwijdert, wordt deze gearchiveerd als deze reeds ten minste één maal uitgevoerd is geweest voor het verwijderen, en als ingesteld is dat verlopen alarmen gearchiveerd moeten worden. (Gebruik hetConfiguratievenster om in te stellen of, en hoe lang gearchiveerde alarmen bijgehouden moeten worden.) Als u een gearchiveerde of een nog niet uitgevoerd openstaand alarm verwijderd, wordt deze permanent verwijderd.

Als het alarm nog niet verlopen is, kunt u een gearchiveerd alarm in de alarmenlijst terug activeren. Om dit te bereiken, moet u eerst de gearchiveerde alarmen zichtbaar maken, zoals beschreven inGearchiveerde alarmen. Dan:

- Selecteer een of meer gewenste gearchiveerde alarmen uit de alarmenlijst door erop te klikken. Kies daarna Acties Reactiveren .

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

#### Een alarm in- of uitschakelen

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

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

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

#### Een alarm bevestigen

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

#### Herinneringssjablonen

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

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

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

- Selecteer in het menu-item Bestand Nieuw Nieuw alarm van sjabloon , en dan het gewenste sjabloon selecteren.

- Rechts klikken op het pictogram in het systeemvak enNieuw alarm Nieuw alarm van sjabloon selecteren in het contextmenu. Dan het gewenste sjabloon selecteren.

- Het Dialoogvenster om alarmen te bewerken openen op de gewone manier, en op de knop Sjabloon laden... klikken om een sjabloon te selecteren zodat het alarm 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 alarmsjabloon aanmaken op basis van een reeds bestaand alarm.

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

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

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

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

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

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

  - Tijd selecteren om een tijd in te voeren waarop het alarm uitgevoerd moet worden.

  - Alleen datum selecteren om aan te geven dat het alarm 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 alarm 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 alarmen

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

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

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 alarmtype en opslagtype. Ze kunnen uitgeschakeld worden, als alleen-lezen ingesteld worden, of als standaardagenda ingesteld worden voor een bepaald alarmtype.

Type alarm

  De drie typen alarmen – actieve alarmen, verlopen alarmen en alarmsjablonen – worden opgeslagen in aparte alarmagenda'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 dat wenst.

Type opslag

  &kalarm; kent twee manieren om alarmagenda's op te slaan:

  - Lokaal bestand: Alarmen worden opgeslagen in een enkel, lokaal bestand in het iCalendar-formaat. Standaard slaat &kalarm; zijn agenda's op in een lokaal bestand (zie 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 alarmen opgeslagen in een lokale map, waarbij elk alarm in die map opgeslagen wordt als een apart iCalendar-bestand. Het voordeel hiervan is dat bij een corrupt bestand, er maar één alarm beschadigd wordt, en niet de hele agenda.

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 alarmen in de agenda genegeerd, en verschijnen ze dus ook niet in de alarmenlijst of de lijst met sjablonen. Als een agenda terug ingeschakeld wordt, worden de erin aanwezige alarmen één keer terug getoond, en, als het een actieve alarmagenda is, terug actief gemaakt.

Status alleen-lezen

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

  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 alarmen in een agendabestand dat niet beschrijfbaar is, dan kunt u de alarmen kopiëren door ze te importeren in een beschrijfbaar agendabestand met de volgende contextmenuoptie Importeren... van de agenda (zie Alarmen importeren uit externe agaenda's).

Standaard agendastatus

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

Importeren...

  Alarmen importeren uit externe agendabestanden in de geselecteerde agenda. Dit wordt verder uitgelegd in Importeren van alarmen uit externe agenda's. Deze mogelijkheid is niet beschikbaar voor uitgeschakelde of alleen-lezen agenda's.

Exporteren...

  Alle alarmen in de geselecteerde agenda exporteren naar een extern agendabestand. Dit wordt verder uitgelegd in Exporteren van alarmen 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 alarmen uit deze agenda in de lijst met alarmen. Op deze manier ziet u direct bij welke agenda bepaalde alarmen behoren.

Kleur weghalen

  Accentuering van kleur wissen voor de alarmen uit deze agenda in de lijst met alarmen. De optie verschijnt alleen nadat Kleur instellen op deze agenda is gebruikt.

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

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

- Gebruik Bestand Alarmen importeren... om alarmen van alle types (actieve alarmen, verlopen alarmen en alarmsjablonen) te importeren uit de agendabestanden.

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

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

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

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

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

- Om alle alarmen 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 alarmen 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 alarm, kunt u de tekst instellen die getoond moet worden in de alarmberichten 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 alarmtekst wijzigt, zal de selectielijst van verjaardagen opnieuw gecontroleerd worden.

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

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

Als u herinnneringsagenda's hebt ingesteld, zullen de alarmen 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 alarmen 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 alarmen en alarmsjablonen, en het opnieuw activeren van alarmen. Om ervoor te zorgen dat het systeem niet te veel belast wordt door de geschiedenis van acties, is het aantal van de veranderingen die bijgehouden worden beperkt tot de laatste 12 acties.

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 alarm 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 alarmen

In het venster voor bewerken van alarmen kunt u een alarm 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 alarmen 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 "Alarm 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 alarm dat wordt bewerkt.

##### Alarmen tonen

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

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

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

Het aansturen van het hoe een alarm te tonen is:

- De optie Geluid Laat u kiezen of een hoorbaar alarm moet klinken wanneer het alarmbericht wordt getoond. Kies:

  - Geen om het alarm zonder geluid te tonen.

  - Piep om pieptoon te laten klinken.

  - 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 het alarm wordt getoond. (Het venster met het alarmbericht bevat een knop om het afspelen van het geluid te stoppen als u stilte wilt maar het tonen van het alarm nog steeds wilt.)

    - 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 alarmbericht te selecteren. In de dialoog Lettertype & kleur van alarm 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 alarmbericht.

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

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

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

    - Wanneer een alarmbericht getoond wordt.

    - Wanneer het bericht opnieuw wordt getoond na uitstel van het alarm, tenzij Voor uitgestelde alarmen uitvoeren is geactiveerd.

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

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

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

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

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

  - Voer in het veld Actie na afloop alarm een shellcommando in om uit te voeren wanneer het alarm 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 alarmbericht gesloten wordt.

    - Wanneer u het alarm uitstelt, behalve wanneer het uitgestelde alarm uiteindelijk is bevestigd.

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

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

##### Alarmen met shell-commando

Commando-alarmen voeren een commando uit zonder een alarmbericht te tonen.

Dit type alarm is niet beschikbaar als &kde; in kiosk-modus werkt.

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

De besturing beschikbaar voor Alarmen 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.

- Als het commando een fout teruggeeft, zal normaal een foutmelding worden getoond en wordt er een foutindicatie getoond in de lijst met alarmen. De foutmelding kan voorkomen worden door Fouten niet melden te activeren.

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

##### Alarmen via e-mail

Alarmen via e-mail, sturen een e-mail zonder een alarmbericht 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 het alarm is wordt gestart; er wordt geen kopie opgeslagen op het moment dat het alarm wordt ingesteld. Om een bijlage te verwijderen, activeer het in de afrollijst en klik op de knop 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 het alarm wordt geactiveerd. Het e-mailadres waarnaar de kopie zal worden gezonden kan worden ingesteld in de Instellingendialoog, de standaard is uw e-mailadres ingesteld in &kmail; of de &systemsettings;.

##### Geluidsalarmen

Geluidsalarmen spelen een geluidsbestand af zonder een alarmbericht 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 het alarm een zich herhalend alarm is en het was uitgesteld nadat het voor het laatst was getoond, dan toont het groepsvak Uitgesteld alarm de tijd waarnaar het alarm 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 het alarm moet worden geactiveerd. Activeer Elke tijd als u alleen een datum voor het alarm wilt specificeren: in dat geval zal het alarm worden getoond bij de eerste gelegenheid op of na de ingestelde tijd bij de begindag, op de ingestelde datum. (&kalarm; instellen beschrijft hoe de tijd op de begindag in te stellen.)

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

- Tijdsduur vanaf nu om hoe lang na nu (in uren en minuten) het alarm 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 dit alarm, inclusief datums en tijden van herhalingen en uitzonderingen. Normaal laat u de elementen voor de tijdzone ongewijzigd tenzij u een goede reden hebt ze te wijzigen.

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 dit alarm moet gebruiken. Bij het aanmaken van een nieuw alarm wordt dit initieel ingesteld op de tijdzone geselecteerd in de Instellingendialoog, die de tijdzone van uw computer is tenzij u deze hebt gewijzigd.

- Selecteer Systeemtijdzone als u de lokale computertijdzone wilt gebruiken (op welke computer &kalarm; op dat moment draait).

#### Herinnering

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

Alarmen worden niet getoond voor sub-herhalingen binnen een herhaling. Alarmen worden alleen getoond voor elke hoofdherhaling van het alarm.

Als het alarm gebeurt, activeer dan Alarm alleen voor de eerste keer als u alleen een alarm wilt bij het gebeuren van het alarm. Als dit is geactiveerd en het is een alarm vooraf,dan is alarmsperiode niet onderworpen aan de normale limiet van kleiner dan het herhalings- of deelherhalingsinterval.

#### Afbreking

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

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

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

  Het te laat zijn van alleen-datum alarm, &ie; een voor wie de optie Elke tijd is geselecteerd, wordt berekend vanaf het tijdstip van het begin van de dag op de datum van de geplande datum van het alarm.

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

  Een alarm 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 alarmvenster 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.

De basis herhalingskarakteristieken van de alarmen worden voor het gemak getoond in de titel van het tabblad Herhaling. Het herhalingsinterval wordt eerst getoond, gevolgd door een deelherhalingsinterval ingesteld met de knop Deelherhaling.

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

- Om het alarm eenmalig te starten, selecteer Geen herhaling.

- Selecteer Bij aanmelden om het alarm af te laten gaan wanneer u zich aanmeldt, tot zijn geplande eindtijd. Dan, op zijn geplande eindtijd, zal het uiteindelijk nog een laatste keer afgaan. (Merk op dat een alarm dat herhaald wordt bij aanmelden ook zal afgaan op elk moment dat u &kalarm; herstart.)

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

  - Selecteer, voor een wekelijkse herhaling, elke dag van de week waarop u het alarm 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 het alarm 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 Alarm op 29 februari in niet-schrikkeljaren te selecteren:

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

    - 28 feb: het alarm zal gebeuren op 29 februari in schrikkeljaren en op 28 februari in niet-schrikkeljaren.

    - 1 maart: het alarm zal gebeuren op 29 februari in schrikkeljaren en op 1 maart in niet-schrikkeljaren.

  Om een dagelijks alarm plaats te laten vinden op alleen weekdagen, gebruik een wekelijkse herhaling en activeer elke weekdag.

In het groepsvak Einde herhaling, stel de algemene tijdsspanne voor herhaling als volgt in:

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

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

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

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

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

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

- U kunt een alarm beperken om niet te verschijnen op vrije dagen door Vrije dagen uitsluiten. Dit verandert niets aan de manier waarop het alarm is gepland; het onderdrukt eenvoudig het alarm wanneer het afloopt op een vrije dag. U kunt uw land of regio voor vakantiedagen selecteren in de Instellingendialoog.

- U kunt een alarm beperken om alleen af te lopen gedurende werktijd door Alleen tijdens werkuren te activeren. Dit verandert niets aan de manier waarop het alarm is gepland; het onderdrukt eenvoudig het alarm wanneer deze afloopt buiten werkuren. Werkdagen en werkuren worden ingesteld in de Instellingendialoog.

##### Deelherhaling

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

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

- Voer het tijdsinterval tussen herhalingen in in de vakjes naast Herhalen elke. Selecteer de gewenste tijdseenheden (&eg; dagen) en voer dan het aantal eenheden in.

- Specificeer ofwel het aantal herhalingen ofwel de duur:

  - Selecteer Aantal keren om hoe vaak het alarm af moet gaan na de hoofdherhaling. Om dus, bijvoorbeeld, het alarm 4 keer af te laten gaan for elke hoofdherhaling, &ie; 3 extra keer, dan zou u hier 3 moeten invoeren.

  - Selecteer Duur om de totale tijdsperiode gedurende welke het alarm herhaald moet worden. Dit hoeft geen exact veelvoud van het herhalingsinterval te zijn; het zal automatisch naar beneden worden afgerond wanneer u op OK klikt.

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

#### Andere besturing

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

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

Als u later het alarm in &kalarm; wijzigt of verwijdert, zal de afspraak in &korganizer; overeenkomstig worden gewijzigd of verwijderd. Maar als u de afspraak in &korganizer; wijzigt, zal het alarm in &kalarm; niet worden beïnvloed.

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

Druk op de knop Proberen om het alarm te testen en controleer of deze correct werkt. Het alarm wordt uitgevoerd alsof het op de normale manier is gepland. In het geval van een geluidsalarm, druk voor de tweede keer op de knop Proberen om het afspelen van het geluidsbestand te stoppen.

Druk op de knop OK wanneer alle details juist zijn, om het alarm aan de planningslijst toe te voegen. Merk op dat bij het bewerken van een bestaand alarm, de knop OK is uitgeschakeld zolang er geen wijzigingen zijn gedaan.

### Venster met alarmbericht

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

Vensters met alarmberichten blijven zichtbaar totdat u ze bevestigt, tenzij Venster automatisch sluiten na de late annuleringstijd was geactiveerd in de dialoog Alarm bewerken. In het geval van een zich herhalend alarm, als een niet bevestigd berichtvenster overblijft van een vorig afgaan van het alarm, dan blijft het bestaande venster eenvoudig zichtbaar wanneer het alarm zich herhaald. Dit vermijdt het hebben van meerdere kopieën van bevestigingen van hetzelfde bericht als u niet wilt of niet in staat bent een bericht te bevestigen op het moment dat het verschijnt.

Het venster met het alarmbericht biedt, voor zover van toepassing, de volgende opties van het getoonde bericht:

- Bevestig het alarm door te klikken op de knop Sluiten. Dit sluit het venster (na een vraag om bevestiging, als u Bevestiging bevestigen hebt geselecteerd).

- Bewerk het alarm door te klikken op de knop Bewerken.... Dit toont het Dialoogvenster om alarmen te bewerken.

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

  De tijd waarnaar het alarm moet worden verschoven moet eerder zijn dan zijn volgende geplande verschijning of het volgende alarm vooraf. Om deze reden zal de knop Verschuiven... in het venster met het alarmbericht en de knop OK in de dialog Verschuiven uitgeschakeld zijn één minuut voordat de volgende geplande tijd of alarm vooraf.

  Merk op dat als een herhaling is ingesteld na het alarm, u het alarm kunt verschuiven na de tijd van de herhaling. In dat geval zal de herhaling worden onderdrukt.

  De knop Verschuiven... is niet beschikbaar voor alarmen die bij aanmelden getoond worden omdat de optie Herhalen bij aanmelden is geselecteerd.

- Stop met het afspelen van het geluidsbestand van het alarm door te klikken op de knop die het symbool afspelen stoppen.

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

  Als de indexen van &kmail; opnieuw worden gegenereerd, zal de koppeling naar het e-mailbericht in &kmail; verloren gaan.

- De knop met het pictogram van &kalarm; biedt een gemakkelijke manier om &kalarm; activeren.

U kunt in het Configuratiedialoogvenster kiezen welke van de twee verschillende modi gebruikt moeten worden om de vensters met alarmberichten te tonen:

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

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

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

#### Positionering van een berichtvenster

U kunt in het Configuratiedialoogvenster kiezen welke van de 2 schema's gebruikt moeten worden om de vensters met alarmberichten 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 het alarm kunt bevestigen.

- De vensters worden getoond in het midden van het scherm. Om de kans te beperken om per ongeluk het alarm te bevestigen, zijn de knoppen in het venster eerst uitgeschakeld, en worden alleen actief na een in te stellen vertraging.

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

### Systeemvakhandeling

&kalarm; toont standaard een pictogram in het systeemvak. Dit pictogram voorziet zowel in besturing, als in een statusaanduiding van van een alarm. Een normaal pictogram van &kalarm; toont dat alle alarmen worden bekeken, terwijl twee verschillende gewijzigde pictogrammen aangegeven dat ofwel sommige alarmen of dat alle alarmen, niet worden gemonitord. De wijziging in pictogram hangt af van het pictogramthema dat wordt gebruikt.

Het pictogram van &kalarm; in het systeemvak is standaard automatisch verborgen wanneer er geen alarmen zijn die aflopen in de volgende 24 uur. U kunt de tijdslimiet van auto-verbergen wijzigen of altijd tonen in het pictogram tonen in het systeemmvak, met de Instellingendialoag. Om het pictogram te tonen wanneer het automatisch is verborgen, klik op de pijl in het systeemvak om verborgen pictogrammen te onthullen.

Als u met de muiscursor over het pictogram in het systeemvak beweegt, wordt een samenvatting van de eerst paar alarmberichten, die aflopen in de volgende 24 uur, als een tekstballon getoond. U kunt deze functie uitschakelen of het aantal te tonen alarmen en hun format in te stellen, in de Instellingendialoog.

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

Klik Rechts op het pictogram in het systeemvak om zijn contextmenu te tonen:

Alarmen inschakelen

  Activeert of deactiveert het monitoren van alarmen.

  Zie Herinneringenin- en uitschakelen for details.

Nieuw alarm

  Nadat u het alarmtype uit de verschijnende lijst hebt geselecteerd, opent zich de dialoog Alarmen bewerken om een nieuw alarm aan te maken.

Afspelen stoppen

  Stopt het afspelen van het geluidsbestand bij afspelen.

Verspreid vensters

  Verspreid de vensters van alarms- en foutmeldingen over het scherm of groepeert ze opnieuw bij elkaar.

&kalarm; instellen...

  Toont de instellingendialoog van &kalarm;.

  De Instellingendialoog wordt beschreven in &kalarm; instellen. Het omvat opties gerelateerd aan het pictogram van &kalarm; in het systeemvak.

Herstellen / minimaliseren

  Herstelt of minimaliseert het hoofdvenster van &kalarm;.

Afsluiten

  Sluit het systeemvakpictogram en hoofdvensters van &kalarm;.

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

#### &kalarm; in het systeemvak tonen

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

Om te kiezen of &kalarm; bij opstarten in het systeemvak getoond moet worden of niet, gebruik Beeld In systeemvak tonen overeenkomstig de voorkeuren ingesteld in het tabblad Beeld van de Instellingendialoog

Om &kalarm; uit het systeemvak te verwijderen, deactiveer Beeld In systeemvak tonen .

Om te kiezen of &kalarm; bij opstarten in het systeemvak getoond moet worden of niet, gebruik het tabblad Beeld van de Instellingendialoog.

### Alarmen verversen

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

U kunt een individuele agenda herladen en zijn alarmen in de lijst met alarmen herladen door Rechts te klikken in de agenda in de lijst met agenda's en de menu-optie Herladen te kiezen. Zie Herinneringsagenda's voor details.

### Alarmen in- en uitschakelen

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

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

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

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

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

  De status in of uitgeschakeld van een individueel alarm wordt aangegeven door zijn kleur in de lijst met alarmen (de kleur kan ingesteld worden in het tabblad Beeld van de instellingendialoog).

Om een alarm te activeren moet het individueel ingeschakeld worden evenals alarmen monitoren moet zijn ingeschakeld.

#### Alarmen monitoren inschakelen

Om alarmen monitoren actief te laten zijn, moet &kalarm; actief zijn. Nadat &kalarm; is geactiveerd, zal het vanaf dat moment automatisch starten wanneer u zich aanmeldt tenzij u het later uitschakelt in het tabblad Algemeen van de Instellingendialoog.

Als alarmen monitoren nu is uitgeschakeld, doe dan een van het volgende om alarmen in te schakelen:

- Selecteer Acties Alarmen activeren.

- Klik Rechts op het pictogram in het systeemvak en kies Alarmen inschakelen uit het contextmenu.

#### Alarmen monitoren uitschakelen

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

- Deactiveer Acties Alarmen inschakelen.

- Klik Rechts op het pictogram in het systeemvak en deactiveer Alarmen inschakelen uit het contextmenu.

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

- Stop &kalarm; zoals beschreven in &kalarm; beëindigen.

Alarmen kunnen permanent worden uitgeschakeld door te voorkomen dat &kalarm; bij aanmelden wordt gestart in het tabblad Algemeen van de Instellingendialoog.

#### Individuele alarmen in- of uitschakelen

Om individuele alarmen die nu zijn uitgeschakeld, doe een van de volgende acties:

- Selecteer een of meer alarmen uit de alarmenlijst door erop te klikken. Kies daarna Acties Inschakelen .

- Klik Rechts op de gewenste items in de lijst met alarmen en kies Inschakelen uit het contextmenu.

Om individuele alarmen die nu zijn ingeschakeld, doe een van de volgende acties:

- Selecteer een of meer alarmen uit de alarmenlijst door erop te klikken. Kies daarna Acties Uitschakelen .

- Klik Rechts op de gewenste items in de lijst met alarmen en kies Uitschakelen uit het contextmenu.

### Ontwaken uit slaapstand

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

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

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

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

De dialoog Uit slaapstand ontwaken wordt gebruikt in samenwerking met de lijst met alarmen in het hoofdvenster van &kalarm;.

- Geaccentueerd alarm gebruiken: deze stelt het alarm die nu is geaccentueerd in de lijst met alarmen zoals het alarm Uit slaapstand ontwaken. Elke bestaande geplande Uit slaapstand ontwaken wordt geannuleerd, zoals boven uitgelegd. De knop is alleen ingeschakeld als exact één alarm is geaccentueerd.

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

- Huidig alarm tonen: dit accentueert het huidige alarm Uit slaapstand ontwaken in de lijst alarmen, zodat het kan worden geïdentificeerd. De knop is uitgeschakeld als er nu geen Uit slaapstand ontwaken is geconfigureerd.

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

### &kalarm; afsluiten

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

## &kalarm; instellen

Om de werking van &kalarm; in te stellen naar de behoefte van uw systeem en uw persoonlijke voorkeuren, selecteer Instellingen &kalarm; instellen.... Dit toont de Instellingendialoog.

### Algemeen

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

- Opstarten bij aanmelden: zal &kalarm; automatisch opstarten bij het aanmelden bij een sessie, om er zeker van te zijn dat &kalarm; altijd actief is tenzij u handmatig afsluit.

  Deze optie zou altijd actief moeten zijn tenzij u het gebruik van &kalarm; niet wilt voortzetten.

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

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

- Bevestig verwijdering van alarmen Specificeert of u om een bevestiging wilt worden gevraagd, telkens als u een alarm verwijdert.

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

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

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

  %c

    De commandotekst van het alarm zal worden gesubstitueerd.

  %w

    De commandotekst van het alarm zal worden gesubstitueerd met een achtergevoegde `sleep`.

  %C

    Er zal een tijdelijk commandobestand worden aangemaakt met de commandotekst van het alarm en het uit te voeren commando zal worden gesubstitueerd.

  %W

    Er zal een tijdelijk commandobestand worden aangemaakt met de commandotekst van het alarm met een `sleep` achtergevoegd en het uit te voeren commando zal worden gesubstitueerd.

  %t

    De naam van &kalarm; in de huidige taal zal worden gesubstitueerd.

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

### Tijd & datum

De sectie Tijd & datum laat u opties instellen gerelateerd aan tijd en datum:

- Tijdzone: Selecteer uw tijdzone. &kalarm; gebruikt deze tijdzone overal, behalve wanneer u het overschrijft voor individuele alarmen.

- Vakantieregio: Selecteer uit welk land of regio de vakanties moeten worden gebruikt. Dit heeft betrekking op alarmen waarvoor de optie om vakantiedagen uit te sluiten is geselecteerd.

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

- Werkuren-groepsvak: Deze opties laten u uw werkuren, nodig wanneer de optie Alleen tijdens werkuren is geselecteerd voor een herhaling in de Dialoogvenster om alarmen te bewerken.

  - Alle werkdagen aanvinken.

  - Begintijd werkdag: voer de tijd in waarop u elke dag begint met uw werk.

  - Eindtijd werkdag: voer de tijd in waarop u elke dag uw werk beëindigd.

- KOrganizer afspraakduur: Voer de in te stellen afspraakduur in om de alarmen in &korganizer; in te stellen die naar &korganizer; worden gekopieerd. De standaard duur is nul.

### Opslag

De sectie Opslag laat u opties kiezen voor het opslaan en archiveren van alarmen:

- Nieuwe alarmen & sjablonen: Specificeert in welke agenda nieuwe alarmen en alarmsjablonen opgeslagen moeten worden bij het gebruiken van meerdere alarmagenda's:

  - In standaard agenda opslaan: Nieuwe alarmen en alarmsjablonen worden automatisch toegevoegd aan de standaard alarmagenda zonder vragen om bevestiging.

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

- Gearchiveerde alarmen-groepsvak: Deze opties besturen de opslag van gearchiveerde alarmen in het standaard alarmagenda-archief.

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

  - Verlopen alarmen verwijderen na: Stel het aantal dagen in om verlopen en verwijderde alarmen in het archief op te slaan, waarna ze permanent worden verwijderd.

  - Wis gearchiveerde alarmen: Deze knop gooit alle nu gearchiveerde alarmen uit de standaard gearchiveerde alarmagenda. (Andere gearchiveerde alarmagenda's blijven ongewijzigd in het geval ze gedeeld worden met andere mensen.) Dit heeft geen invloed op alarmen die vervolgens verlopen of worden verwijderd; ze zullen doorgaan om te worden gearchiveerd volgens de geselecteerde opties.

### E-mail

De sectie E-mail laat u opties kiezen voor het verzenden en adresseren van alarmen via e-mail:

- E-mailclient: Specificeer de te gebruiken e-mailclient voor het verzenden van alarmen via e-mail:

  - KMail: Wanneer een alarm via e-mail afloopt, zal de e-mail automatisch verzonden worden met gebruik van &kmail; (die, indien nodig, eerst gestart zal worden).

  - Sendmail: Wanneer een alarm via e-mail afloopt, zal de e-mail automatisch met &Sendmail; verzonden worden. Deze optie zal alleen werken als uw systeem geconfigureerd is om &Sendmail; te gebruiken of een aan &Sendmail; compatibele e-mail transport-agent zoals postfix of qmail.

- Kopiëren zendt e-mails in de map "verzonden mail" van &kmail;: Selecteer deze optie als, elke keer dat een alarm via e-mail afloopt, u een kopie van de verzonden e-mail wilt opslaan in de map `verzonden mail`.

  Deze optie is niet beschikbaar wanneer &kmail; is geselecteerd als de e-mailclient, omdat &kmail; dit automatisch doet.

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

- Selecteer uw te gebruiken e-mailadres als de afzenderadres in alarmen via e-mail:

  - Selecteer Van om een e-mailadres in te voeren.

  - Selecteer Standaard adres uit KMAIL of Systeeminstellingen gebruiken om het e-mailadres dat is ingesteld in de &kmail; of de &systemsettings; te gebruiken.

  - Selecteer Identiteiten van &kmail; gebruiken om in staat te zijn, op het moment dat u een alarm via e-mail configureert, te kiezen welke e-mail-identiteit van &kmail; u wilt gebruiken. De standaard identiteit zal worden gebruikt voor alarmen die al zijn ingesteld voordat u deze optie selecteerde.

- Selecteer uw te gebruiken e-mailadres voor het zenden van blinde kopieën van alarmen via e-mail aan uzelf wanneer de optie Kopie van e-mailbericht naar uzelf sturen is geselecteerd:

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

  - Selecteer Standaard adres uit KMAIL of Systeeminstellingen gebruiken om het e-mailadres dat is ingesteld in de &kmail; of de &systemsettings; te gebruiken.

### Beeld

De sectie Beeld laat u enige aspecten van het uiterlijk van &kalarm; besturen. In het tabblad Algemeen:

- Groepsvak In systeemvak weergeven: Indien geactiveerd zal het pictogram in het systeemvak worden getoond terwijl &kalarm; actief is, afhankelijk van de geselecteerde optie:

  - Altijd tonen: Het pictogram in het systeemvak wordt altijd getoond.

  - Automatisch verbergen bij geen actief alarm: Het pictogram in het systeemvak is verborgen als er geen actieve alarmen zijn.

  - Automatisch verbergen als geen alarm afloopt in de tijdsperiode: Het pictogram in het systeemvak is verborgen als geen alarm afloopt in de ingevoerde tijdsperiode, nu beginnend.

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

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

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

  - Alarmen voor de volgende 24 uur tonen: Indien geselecteerd zal een samenvatting van de eerste paar alarmen die in de volgende 24 uur aflopen worden getoond.

  - Maximum aantal te tonen alarmen: Deactiveer deze optie om alle alarmen van de volgende 24 uur te tonen. Activeer deze om het maximum aantal alarmen die zullen worden getoond in te stellen.

  - Tijd van het alarm tonen: Activeer deze optie om de tijd te tonen waarop elk alarm is gepland.

  - Resterende tijd tot alarm tonen: Activeer deze optie om de overblijvende tijd te tonen voor geplande verschijning van elk alarm. De overblijvende tijd wordt getoond in uren en minuten.

    - Prefix: Specificeer een symbool of te tonen tekst vóór de overblijvende tijd tot het alarm, om het te onderscheiden van de tijd waarop het alarm is gepland.

- Het groepsvak Lijst met alarmen stelt u in staat de kleuren te selecteren van de lijst met alarmen in het hoofdvenster van &kalarm;, om uitgeschakelde en gearchiveerde alarmen te tonen.

Het tabblad Herinneringsvensters bevat opties om het uiterlijk van alarmberichtvensters te besturen.

- Venster ver van de muiscursor plaatsen: Activeer deze optie om alarmberichtvensters zo ver mogelijk van de huidige positie van de muiscursor te plaatsen. Dit minimaliseert de kans om per ongeluk een alarm te bevestigen door onbedoeld op een knop te klikken net op het moment dat het berichtvenster verschijnt.

- Vensters in het midden, vertraging activatie knoppen: Activeer deze optie om alarmberichtvensters in het midden van het scherm te tonen. Om de kans te verkleinen om per ongeluk het alarm te bevestigen, worden de knoppen in het venster initieel uitgeschakeld. De vertraging in seconden voordat ze actief worden wordt ingesteld met de Vertraging voor de activatie van knoppen (seconden).

- Berichtenvensters hebben een titelbalk en het toetsenbord neem focus: Deze optie bestuurt of alarmberichtvensters modaal zijn of niet, &ie; of ze het toetsenbord focus krijgt wanneer ze verschijnen. Zie de sectie Herinneringsberichtvenster voor details.

### Bewerken

De sectie Bewerken laat u standaard waarden kiezen voor de opties in de Dialoogvenster om alarmen te bewerken:

- Het tabblad Algemeen bevat opties die van toepassing zijn op alle types alarmen.

  - Stelt de standaard statussen in voor In KOrganizer tonen en keuzevakjes Annuleren, indien te laat.

  - Het standaard herhalingstype instellen.

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

- Het tabblad Typen alarmen bevat opties die van toepassing zijn voor specifieke typen alarmen.

  - Om alarmen te tonen:

    - Stel de standaard statussen voor Venster voortaan automatisch sluiten en keuzevakjes Om bevestiging vragen.

    - Stelt de standaard eenheid in voor alarmsperioden.

    - Stelt de standaard eenheid in voor speciale alarmsacties.

    - Stelt de standaard geluidsopties in.

  - Voor alarmen met shell-commando:

    - Stelt de standaard statussen in voor Voer een script in en en keuzevakjes Uitvoeren in terminalvenster.

  - Voor alarmen via e-mail:

    - Stel de standaard status in voor het keuzevakje Kopie van e-mailbericht naar uzelf sturen.

- Het tabblad lettertype & kleur laat u de standaard voor het uiterlijk van alarmberichten instellen. Selecteer hun standaard lettertype en voorgrond en achtergrond kleuren in.

## Werking van commandoregelopdrachten

Wanneer commandoregelparameters worden aangeleverd zal &kalarm; de lijst met geplande alarmen niet tonen zoals bovenstaand beschreven in &kalarm; gebruiken. Commandoregelopties specifiek voor &kalarm; kunnen worden gebruikt om de volgende bewerkingen uit te voeren:

- een nieuw alarm plannen

- de weergavemodus van &kalarm; besturen

- hulp verkrijgen

Extra opties voor de opdrachtregel worden primair geleverd om andere toepassingen een interface te bieden naar &kalarm;. Ze worden beschreven in het hoofdstuk Gids voor ontwerpers naar &kalarm;.

De opdrachtregel moet alleen opties bevatten die van toepassing zijn op één &kalarm; bewerking. Als u meerdere bewerkingen wilt doen, dan moet u &kalarm; meerdere keren oproepen elke keer met een enkele set opties.

### Een nieuw alarm plannen

De volgende opties worden gebruikt om een nieuw alarm te plannen:

Optie | Beschrijving
--- | ---
`-a`, `--ack-confirm` | Nogmaals vragen om bevestiging wanneer het alarmbericht is bevestigd.
`-A`, `--attach URL` | Specificeer het pad of &URL; van een bestand die een bijlage is bij de e-mail. Deze optie kan, indien nodig, herhaald worden. `--mail` moet gespecificeerd worden met deze optie.
`--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` | Het alarm uitschakelen. Het zal niet meer uitgevoerd worden totdat het handmatig geactiveerd wordt.
`--disable-all` | Schakel monitoring van alarmen uit. Dit voorkomt elk aflopen van een alarm totdat u alarmen opnieuw inschakelt of &kalarm; herstart, &eg; bij volgende aanmelding. `--triggerEvent` kan niet gespecificeerd worden met deze optie.

`-e`, `--exec commandoregel`

Specificeer een uit te voeren shell-commando. Indien gespecificeerd, dan moet deze optie de laatste optie van &kalarm; zijn in de opdrachtregel van &kalarm;. Alle volgende commandoparameters en opties worden geïnterpreteerd als onderdeel van de de uit te voeren opdrachtregel. `--file` en `--exec-display` en `--mail` kunnen niet gespecificeerd worden met deze optie. `--ack-confirm`, `--beep`, `--color` en `--colorfg` worden genegeerd met deze optie.

`-E`, `--exec-display commandoregel`

Specificeer een uit te voeren commando om een de tekst van het alarmbericht te genereren. Indien gespecificeerd, dan moet deze optie de laatste optie van &kalarm; zijn in de opdrachtregel van &kalarm;. Alle volgende commandoparameters en opties worden geïnterpreteerd als onderdeel van de de uit te voeren opdrachtregel. `--exec`, `--file` en `--mail` kunnen niet gespecificeerd worden met deze optie.

`-f`, `--file URL` | Specificeer het pad of &URL; van een tekst- of afbeeldingsbestand waarvan de inhouden het alarmbericht moeten vormen. `--exec`, `--exec-display` en `--mail` kunnen niet gespecificeerd worden en bericht moet niet aanwezig zijn met deze optie.
`-F`, `--from-id ID` | Gebruik de gespecificeerde identiteit van &kmail; als de afzender van de e-mail. `--mail` moet gespecificeerd worden met deze optie.

`-i`, `--interval periode`

Stel het interval tussen herhalingen van het alarm in. Uren/minuten worden gespecificeerd in de opmaak nHnM, waar n een getal is, &eg; 3H30M. Andere tijdsperioden worden gespecificeerd in de opmaak nX, waar n een getal is en X is een van de volgende letters: Y (jaren), M (maanden), W (weken), D (dagen). Als `--recurrence` ook is gespecificeerd, zijn Y (jaren) en M (maanden) niet toegestaan. Verplicht als `--repeat` of `--until` is gespecificeerd.

`-k`, `--korganizer` | Toon het alarm als een afspraak in de actieve agenda van &korganizer;.
`-l`, `--late-cancel periode` | Annuleer het alarm als het niet zal aflopen binnen de gespecificeerde periode na de juiste tijd. Uren/minuten worden gespecificeerd in de opmaak nHnM, waar n een getal is, &eg; 3H30M. Andere tijdsperiodes worden gespecificeerd in de opmaak nX, waar n een getal is en X is een van de volgende letters: W (weken), D (dagen). De standaard waarde van periode is 1 minuut.
`-L`, `--login` | Laat het alarm aflopen elke keer dat u zich aanmeldt. `--interval`, `--repeat` en `--until` kunnen niet gespecificeerd worden met deze optie.
`-m`, `--mail adres` | Stuur een e-mail naar het gespecificeerde adres. Deze optie kan naar behoefte herhaald worden. `--exec`, `--exec-display` en `--file` kan niet worden gespecificeerd met deze optie. `--ack-confirm`, `--beep`, `--color` en `--colorfg` worden met deze optie genegeerd.
`-p`, `--play URL` | Specificeer het pad of &URL; van een eenmaal af te spelen audiobestand, ofwel als een audioalarm of wanneer het alarmbericht wordt getoond. `--play-repeat`, `--beep` en `--speak` kunnen niet gespecificeerd worden met deze optie.
`-P`, `--play-repeat URL` | Specificeer het pad of &URL; van een herhaald af te spelen audiobestand, ofwel tot Afspelen stoppen wordt gebruikt of zolang het alarmbericht wordt getoond. `--play`, `--beep` en `--speak` kunnen niet gespecificeerd worden met deze optie.
`--recurrence spec` | Stel het alarm in om opnieuw te verschijnen. Specificeer de herhaling met iCalendar syntaxis (gedefinieerd in RFC2445), &eg; FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. `--until` kan niet met deze optie worden gedefinieerd.

`-r`, `--repeat aantal`

Stel het aantal keren in dat het alarm moet aflopen of, als een herhaling is gespecificeerd met `--recurrence`, het aantal keren dat het alarm zou moeten aflopen elke keer dat `--recurrence` het activeert (&ie; een herhaling binnen een herhaling). Als `--recurrence` niet aanwezig is, specificeer -1 om het alarm zich oneindig te laten herhalen. `--interval` moet en `--until` mag niet gespecificeerd worden met deze optie.

`-R`, `--reminder periode`

Voer een herhalingsalarm de gespecificeerde tijdsduur voor of na de hoofdalarm uit en elk van zijn herhalingen (indien aanwezig). De periode is gespecificeerd in dezelfde indeling als beschreven voor `--late-cancel`. De herhaling zal standaard voor het alarm plaatsvinden. Om een herhaling na het alarm te specificeren, laat periode vooraf gaan met +, &eg; +3D. Deze optie kan niet gespecificeerd worden met `--exec`, `--mail` of `--reminder-once`.

`--reminder-once periode` | Voer eenmalig een herhalingsalarm de gespecificeerde tijdsduur voor of na de verschijning van het alarm uit. Er zal geen herhaling van de worden getoond voor of na opvolgende alarmen (indien aanwezig). De periode wordt gespecificeerd in dezelfde indeling als beschreven voor `--reminder`. Deze optie kan niet gespecificeerd worden met `--exec`, `--mail` of `--reminder`.
`-s`, `--speak` | Spreek het bericht uit wanneer het wordt getond. Deze optie vereist dat &jovie; is geïnstalleerd en geconfigureerd, samen met een compatibele spraaksynthesizer. `--beep`, `--play` en `--play-repeat` kunnen niet worden gespecificeerd met deze optie.
`-S`, `--subject onderwerp` | Het onderwerpregel van het e-mailbericht. `--mail` moet gespecificeerd worden met deze optie.

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

Laat het alarm aflopen op de gespecificeerde datum of de datum/tijd. Specificeer een datum zonder een tijd in het formaat jjjj-mm-dd[ TZ]; specificeer een datum en tijd met [[[jjjj-]mm-]dd-]hh:mm[ TZ] (waar weggelaten datumvelden standaard de waarde van vandaag krijgen). Als geen tijdzone is gespecificeerd, wordt de lokale systeemtijdzone aangenomen. Als een tijdzone is gespecificeerd, TZ, dan kan het de naam van een systeemtijdzone zijn (&eg; `Europe/London`) of `UTC` die de UTC tijdzone representeert.

`-v`, `--volume percentage` | Stel het geluidsvolume voor het afspelen van het geluidsbestand in. Deze optie kan alleen gebruikt worden wanneer `--play` of `--play-repeat` is gespecificeerd.

`-u`, `--until datum/tijd`

Herhaal het alarm tot de gespecificeerde datum of datum/tijd. Specificeer de datum of datum/tijd met gebruik van dezelfde syntaxis als voor `--time`. Merk op dat wanneer `--time` is gespecificeerd, de tijdzone genomen zal worden uit zijn waarde en geen tijdzone kan worden meegegeven in de waarde van `--until`. `--interval` moet gespecificeerd worden en `--repeat` en `--recurrence` kunnen dat niet met deze optie.

bericht | Te tonen berichttekst of, als `--mail` opgegeven is, de inhoud van het e-mailbericht.

Ofwel een berichttekst, `--file`, `--exec`, `--exec-display`, `--play` of `--play-repeat` moet gespecificeerd worden; behalve zoals boven aangegeven, alle opties zijn optioneel.

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 "Denk er aan te\nSTOPPEN"
    % kalarm -c 0xFF0000 -t 27-22:00 "Denk er aan te\nSTOPPEN"

### Andere opties

De volgende opties worden gebruikt om verschillende functies uit te voeren, inclusief het weergeven van Dialoogvenster om alarmen te bewerken.

Optie | Beschrijving
--- | ---
`--edit eventID` | De dialoog Alarm bewerken tonen om het alarm met de gespecificeerde gebeurtenis-ID te bewerken. De gebeurtenis-ID is de unieke ID van de gebeurtenis, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat [resourceID:]eventUID.
`--edit-new-audio` | Dialoogvenster voor het bewerken van een alarm tonen om een nieuwe audioalarm te bewerken.
`--edit-new-command` | De dialoog om alarmen te bewerken tonen, om een nieuwe commando-alarm te maken.
`--edit-new-display` | Dialoogvenster voor het bewerken van een alarm tonen om een nieuw weergave-alarm te bewerken.
`--edit-new-email` | Dialoogvenster voor het bewerken van een alarm tonen om een nieuwe e-mailalarm te bewerken.
`--edit-new-preset sjabloonnaam` | Dialoogvenster voor het bewerken met een vooraf ingesteld sjabloon met de gespecificeerde naam om een nieuw alarm te bewerken.
`--list` | Voer een lijst met geplande alarmen uit naar `stdout`. De lijst toont beknopte details van elk wachtend alarm: zijn hulpbron-identifier UID, volgende geplande tijd en berichttekst of bestand.
`--tray` | &kalarm; als een pictogram tonen in het systeemvak.
`--disable-all` | Alle alarmen volgen uitschakelen

Zie ook:

- kf5options(7)
- qt5options(7)

## Gids voor ontwikkelaars naar &kalarm;

&kalarm; biedt een interface waarmee andere toepassingen de volgende functies kunnen vragen:

- een nieuw alarm plannen

- een reeds gepland alarm annuleren

- een reeds gepland alarm activeren

- de dialoog om alarmen te bewerken tonen

- lijst met geplande alarmen

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

### &DBus;-interface

De &DBus; oproepen beschreven in dit document zijn allemaal geïmplementeerd in &DBus; objectpad `/kalarm` van &kalarm;. Het interface is gedefinieerd in de bestanden `org.kde.kalarm.kalarm.xml` en `kalarmiface.h`.

cancelEvent

#### cancelEvent

Annuleer een reeds gepland alarm.

    void cancelEvent(const QString& eventID)

##### Parameters

`eventID`

  Specificeert de unieke ID van de gebeurtenis om geannuleerd te worden, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat [resourceID:]eventUID.

##### Beschrijving

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

triggerEvent

#### triggerEvent

activeert een reeds gepland alarm.

    void triggerEvent(const QString& eventID)

##### Parameters

`eventID`

  Specificeert de unieke ID van de gebeurtenis om gestart te worden, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat [resourceID:]eventUID.

##### Beschrijving

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

Als het alarm is al is afgelopen zal &kalarm; alle geplande gevallen van het alarm tot op het huidige moment verwijderen en, als er geen herhalingen van het alarm over blijven, wordt het alarm uit de agenda verwijderd. Als het alarm nog niet is afgelopen, blijven zijn geplande gevallen ongewijzigd.

scheduleMessage

#### scheduleMessage

plan een nieuw alarmbericht.

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned vlaggen,
                         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 vlaggen,
                         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 vlaggen,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parameters

`bericht`

  Specificeert de tekst van het te plannen bericht of, als `vlaggen` het bit `DISPLAY_COMMAND` aan heeft staan, specificeert de uit te voeren opdrachtregel de aan te maken berichttekst.

`startDateTime`

  Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum alarm moet de tekenreeks in het formaat JJJJ-MM-DD[ TZ] (zoals teruggegeven door `QDate::toString(Qt::ISODate)`) zijn. Voor een alarm met een datum en tijd, moet de tekenreeks in het formaat JJJJ-MM-DDTHH:MM[:SS][ TZ] (zoals teruggegeven door `QDateTime::toString(Qt::ISODate)`) of HH:MM[:SS] (zoals teruggegeven door `QTime::toString(Qt::ISODate)`) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.

  Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, TZ, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; `Europe/London`) of `UTC` die de UTC tijdzone representeert.

`lateCancel`

  Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.

`vlaggen`

  Specificeert de logisch OF van de gewenste alarmsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse `KAlarmIface` in `kalarmiface.h`. Merk op dat niet alle vlagbits van toepassing zijn op de alarmberichten.

`bgColor`

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

`fgColor`

  Specificeert de voorgrond kleur voor het tonen van het bericht. Het formaat van de tekenreeks is hetzelfde als voor `bgColor` of zet als alternatief de tekenreeks op nul om de huidige standaard voorgrondkleur te specificeren.

`lettertype`

  Specificeert het lettertype voor het weergeven van het bericht. Het formaat van de tekenreeks is die uitgevoerd wordt door `QFont::toString()`. Zet de tekenreeks op nul om het standaard lettertype van het moment te tonen wanneer het bericht wordt getoond.

`audioURL`

  Specificeert het geluidsbestand dat afgespeeld moet worden wanneer het bericht wordt getoond. Zet de waarde op nul als geen geluidsbestand moet worden afgespeeld.

`reminderMins`

  Specificeert het aantal minuten voor de hoofdalarm en elk van zijn herhalingen (indien aanwezig) waarop een herhalingsalarm moet worden getoond. Specificeer een negatieve waarde voor een herhaling om te worden getoond na de hoofdalarm. Specificeer 0 als geen herhaling is vereist.

`herhaling`

  Specificeert een reguliere herhaling van het alarm, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in RFC2445. Bijvoorbeeld, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalend alarm, specificeer een lege tekenreeks.

`recurType`

  Specificeert het type herhaling voor het alarm. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse `KAlarmIface` in `kalarmiface.h`. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter `startDateTime`.

`recurInterval`

  Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door `recurType`) tussen herhalingen van het alarm.

`recurCount`

  Specificeert het aantal keren dat het alarm herhaald moet worden. Specificeer -1 om het alarm oneindig te herhalen.

`endDateTime`

  Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. Als `startDateTime` een tijd bevat, dan moet deze parameter ook een tijd bevatten; als `startDateTime` alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor `startDateTime` wordt gebruikt om deze waarde van de parameter te gebruiken.

`subRepeatInterval`

  Specificeert het aantal minuten tussen de sub-herhalingen van het alarm. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.

`subRepeatCount`

  Specificeert het aantal sub-herhalingen van het alarm, inclusief het initiële alarm.

##### Beschrijving

`scheduleMessage()` is een &DBus; aanroep om het gespecificeerde alarmbericht voor weergave op de gespecificeerde datum en tijd. Het heeft drie vormen. De meest algemene vorm staat een willekeurige te specificeren herhaling toe – gebruik deze ook voor zich niet herhalende alarmen. De andere vormen bieden een gemakkelijke toegang tot een beperkte set van typen herhalingen van alarmen, de een die een herhalingsaantal specificeert en de ander een eind tijd.

Als de geplande tijd (inclusief herhalingen) al is gepasseerd, zal &kalarm; het bericht onmiddellijk weergeven (tenzij de waarde van `lateCancel` aangeeft dat het nu te laat is om het alarm te tonen, in welk geval &kalarm; het verzoek negeert). Als de geplande tijd (of een herhaling) zich in de toekomst bevindt zal &kalarm; het alarmbericht toevoegen aan de actieve standaard alarmagenda voor latere weergave.

scheduleFile

#### scheduleFile

plan een nieuw alarm die de inhoud van een tekst- of afbeeldingsbestand toont.

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned vlaggen,
                      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 vlaggen,
                      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 vlaggen,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      const QString& endDateTime)

##### Parameters

`URL-adres`

  Specificeert het tekst- of afbeeldingsbestand waarvan de inhoud moet worden getoond in het geplande bericht.

`startDateTime`

  Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum alarm moet de tekenreeks in het formaat JJJJ-MM-DD[ TZ] (zoals teruggegeven door `QDate::toString(Qt::ISODate)`) zijn. Voor een alarm met een datum en tijd, moet de tekenreeks in het formaat JJJJ-MM-DDTHH:MM[:SS][ TZ] (zoals teruggegeven door `QDateTime::toString(Qt::ISODate)`) of HH:MM[:SS] (zoals teruggegeven door `QTime::toString(Qt::ISODate)`) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.

  Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, TZ, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; `Europe/London`) of `UTC` die de UTC tijdzone representeert.

`lateCancel`

  Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.

`vlaggen`

  Specificeert de logisch OF van de gewenste alarmsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse `KAlarmIface` in `kalarmiface.h`. Merk op dat niet alle vlagbits van toepassing zijn op de alarmen met een bestand.

`bgColor`

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

`audioURL`

  Specificeert het geluidsbestand dat afgespeeld moet worden wanneer het bericht wordt getoond. Zet de waarde op nul als geen geluidsbestand moet worden afgespeeld.

`reminderMins`

  Specificeert het aantal minuten voor de hoofdalarm en elk van zijn herhalingen (indien aanwezig) waarop een herhalingsalarm moet worden getoond. Specificeer een negatieve waarde voor een herhaling om te worden getoond na de hoofdalarm. Specificeer 0 als geen herhaling is vereist.

`herhaling`

  Specificeert een reguliere herhaling van het alarm, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in RFC2445. Bijvoorbeeld, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalend alarm, specificeer een lege tekenreeks.

`recurType`

  Specificeert het type herhaling voor het alarm. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse `KAlarmIface` in `kalarmiface.h`. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter `startDateTime`.

`recurInterval`

  Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door `recurType`) tussen herhalingen van het alarm.

`recurCount`

  Specificeert het aantal keren dat het alarm herhaald moet worden. Specificeer -1 om het alarm oneindig te herhalen.

`endDateTime`

  Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. Als `startDateTime` een tijd bevat, dan moet deze parameter ook een tijd bevatten; als `startDateTime` alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor `startDateTime` wordt gebruikt om deze waarde van de parameter te gebruiken.

`subRepeatInterval`

  Specificeert het aantal minuten tussen de sub-herhalingen van het alarm. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.

`subRepeatCount`

  Specificeert het aantal sub-herhalingen van het alarm, inclusief het initiële alarm.

##### Beschrijving

`scheduleFile()` is een &DBus; aanroep om het te tonen gespecificeerde tekst- of afbeeldingsbestand voor weergave op de gespecificeerde datum en tijd te plannen. Los van het specificeren van een pad naar een bestand of &URL; en weglaten van de voorgrondkleur en lettertype, is zijn gebruik identiek aan `scheduleMessage` - zie de beschrijving van die functie voor verdere details.

scheduleCommand

#### scheduleCommand

een nieuw alarm plannen die een shellcommando uitvoert.

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

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

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned vlaggen,
                         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`

  Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum alarm moet de tekenreeks in het formaat JJJJ-MM-DD[ TZ] (zoals teruggegeven door `QDate::toString(Qt::ISODate)`) zijn. Voor een alarm met een datum en tijd, moet de tekenreeks in het formaat JJJJ-MM-DDTHH:MM[:SS][ TZ] (zoals teruggegeven door `QDateTime::toString(Qt::ISODate)`) of HH:MM[:SS] (zoals teruggegeven door `QTime::toString(Qt::ISODate)`) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.

  Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, TZ, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; `Europe/London`) of `UTC` die de UTC tijdzone representeert.

`lateCancel`

  Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.

`vlaggen`

  Specificeert de logisch OF van de gewenste alarmsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse `KAlarmIface` in `kalarmiface.h`. Merk op dat niet alle vlagbits van toepassing zijn op de commando-alarmen.

`herhaling`

  Specificeert een reguliere herhaling van het alarm, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in RFC2445. Bijvoorbeeld, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalend alarm, specificeer een lege tekenreeks.

`recurType`

  Specificeert het type herhaling voor het alarm. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse `KAlarmIface` in `kalarmiface.h`. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter `startDateTime`.

`recurInterval`

  Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door `recurType`) tussen herhalingen van het alarm.

`recurCount`

  Specificeert het aantal keren dat het alarm herhaald moet worden. Specificeer -1 om het alarm oneindig te herhalen.

`endDateTime`

  Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. Als `startDateTime` een tijd bevat, dan moet deze parameter ook een tijd bevatten; als `startDateTime` alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor `startDateTime` wordt gebruikt om deze waarde van de parameter te gebruiken.

`subRepeatInterval`

  Specificeert het aantal minuten tussen de sub-herhalingen van het alarm. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.

`subRepeatCount`

  Specificeert het aantal sub-herhalingen van het alarm, inclusief het initiële alarm.

##### Beschrijving

`scheduleCommand()` is een &DBus; aanroep om de gespecificeerde shell-opdrachtregel of commandoscript voor uitvoering op de gespecificeerde datum en tijd te plannen. Los van het specificeren van een commando en weglaten van de parameters voor kleur van berichten, lettertype en audiobestand, is zijn gebruik identiek aan `scheduleMessage` - zie de beschrijving van die functie voor verdere details.

scheduleEmail

#### scheduleEmail

een nieuw alarm 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 vlaggen,
                       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 vlaggen,
                       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 vlaggen,
                       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`

  Specificeert de inhoud van het e-mailbericht.

`bijlagen`

  Een kommagescheiden lijst ven paden of &URL;'s die als bijlagen met het e-mailbericht worden verzonden.

`startDateTime`

  Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum alarm moet de tekenreeks in het formaat JJJJ-MM-DD[ TZ] (zoals teruggegeven door `QDate::toString(Qt::ISODate)`) zijn. Voor een alarm met een datum en tijd, moet de tekenreeks in het formaat JJJJ-MM-DDTHH:MM[:SS][ TZ] (zoals teruggegeven door `QDateTime::toString(Qt::ISODate)`) of HH:MM[:SS] (zoals teruggegeven door `QTime::toString(Qt::ISODate)`) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.

  Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, TZ, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; `Europe/London`) of `UTC` die de UTC tijdzone representeert.

`lateCancel`

  Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.

`vlaggen`

  Specificeert de logisch OF van de gewenste alarmsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse `KAlarmIface` in `kalarmiface.h`. Merk op dat niet alle vlagbits van toepassing zijn op de e-mailalarmen.

`herhaling`

  Specificeert een reguliere herhaling van het alarm, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in RFC2445. Bijvoorbeeld, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalend alarm, specificeer een lege tekenreeks.

`recurType`

  Specificeert het type herhaling voor het alarm. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse `KAlarmIface` in `kalarmiface.h`. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter `startDateTime`.

`recurInterval`

  Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door `recurType`) tussen herhalingen van het alarm.

`recurCount`

  Specificeert het aantal keren dat het alarm herhaald moet worden. Specificeer -1 om het alarm oneindig te herhalen.

`endDateTime`

  Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. Als `startDateTime` een tijd bevat, dan moet deze parameter ook een tijd bevatten; als `startDateTime` alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor `startDateTime` wordt gebruikt om deze waarde van de parameter te gebruiken.

`subRepeatInterval`

  Specificeert het aantal minuten tussen de sub-herhalingen van het alarm. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.

`subRepeatCount`

  Specificeert het aantal sub-herhalingen van het alarm, inclusief het initiële alarm.

##### Beschrijving

`scheduleEmail()` is een &DBus; aanroep om het te verzenden gespecificeerde e-mailbericht op de gespecificeerde datum en tijd te plannen. Los van het specificeren van de e-mail-header en de inhoud en weglaten van de parameters voor berichtkleur, lettertype en audiobestand, is zijn gebruik identiek aan `scheduleMessage` - zie de beschrijving van die functie voor verdere details.

scheduleAudio

#### scheduleAudio

een nieuw alarm plannen die een shellcommando uitvoert.

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

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

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

##### Parameters

`audioURL`

  Specificeert het geluidsbestand dat afgespeeld moet worden.

`volumePercent`

  Specificeert het te gebruiken volume als een percentage van het volledige volume. Specificeer -1 om het standaard volume te gebruiken.

`startDateTime`

  Specificeert de geplande datum of datum en tijd waarop het bericht moet worden getoond. Voor een alleen-datum alarm moet de tekenreeks in het formaat JJJJ-MM-DD[ TZ] (zoals teruggegeven door `QDate::toString(Qt::ISODate)`) zijn. Voor een alarm met een datum en tijd, moet de tekenreeks in het formaat JJJJ-MM-DDTHH:MM[:SS][ TZ] (zoals teruggegeven door `QDateTime::toString(Qt::ISODate)`) of HH:MM[:SS] (zoals teruggegeven door `QTime::toString(Qt::ISODate)`) zijn. Als geen datum is gespecificeerd, wordt de datum van vandaag gebruikt. Merk op dat seconden worden genegeerd.

  Als geen tijdzone is gespecificeerd, wordt de lokale tijdzone van het systeem aangenomen. Als een tijdzone is gespecificeerd, TZ, aanwezig is, kan het de naam van een systeemtijdzone zijn (&eg; `Europe/London`) of `UTC` die de UTC tijdzone representeert.

`lateCancel`

  Veroorzaak dat het alarm wordt geannuleerd als het niet kan worden geactiveerd binnen het gespecificeerde aantal minuten na de geplande tijd van het alarm. Als de waarde 0 is zal het alarm niet worden geannuleerd onafhankelijk van hoe veel later deze afloopt.

`vlaggen`

  Specificeert de logisch OF van de gewenste alarmsvlaggen. De bits van de vlag zijn die zijn gedefinieerd in de klasse `KAlarmIface` in `kalarmiface.h`. Merk op dat niet alle vlagbits van toepassing zijn op de commando-alarmen.

`herhaling`

  Specificeert een reguliere herhaling van het alarm, met gebruik van de syntaxis van iCalendar zoals gedefinieerd in RFC2445. Bijvoorbeeld, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO zou 4 herhalingen specificeren met 3-maandelijkse intervallen op de laatste maandag van de maand. Voor een zich niet herhalend alarm, specificeer een lege tekenreeks.

`recurType`

  Specificeert het type herhaling voor het alarm. De toegestane waarden zijn MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Deze zijn gedefinieerd in klasse `KAlarmIface` in `kalarmiface.h`. Maandelijkse herhalingen zijn van het type dag van de maand en jaarlijkse herhalingen zijn van het type datum in het jaar, met de datum in beide gevallen genomen uit de parameter `startDateTime`.

`recurInterval`

  Specificeert het aantal perioden (minuten/dagen/weken/maanden/jaren zoals gespecificeerd door `recurType`) tussen herhalingen van het alarm.

`recurCount`

  Specificeert het aantal keren dat het alarm herhaald moet worden. Specificeer -1 om het alarm oneindig te herhalen.

`endDateTime`

  Specificeert de einddatum of datum en tijd, voor herhalingen van het alarm. Als `startDateTime` een tijd bevat, dan moet deze parameter ook een tijd bevatten; als `startDateTime` alleen een datum bevat, dan moet deze parameter ook alleen een datum bevatten. Het mag geen tijdzone bevatten; dezelfde tijdzone als voor `startDateTime` wordt gebruikt om deze waarde van de parameter te gebruiken.

`subRepeatInterval`

  Specificeert het aantal minuten tussen de sub-herhalingen van het alarm. Specificeer 0 voor geen sub-herhalingen. Genegeerd als geen herhalingen zijn gespecificeerd.

`subRepeatCount`

  Specificeert het aantal sub-herhalingen van het alarm, inclusief het initiële alarm.

##### Beschrijving

`scheduleAudio()` is een &DBus; aanroep om het af te spelen gespecificeerde audiobestand op de gespecificeerde datum en tijd te plannen. Los van het specificeren van een volume en weglaten van parameters voor de bercihtkleur en lettertype, is gebruik identiek aan `scheduleMessage` - zie de beschrijving van die functie voor verdere details.

bewerken

#### bewerken

Toon de Dialoogvenster om alarmen te bewerken om een alarm te bewerken.

    bool edit(const QString& eventID)

##### Parameters

`eventID`

  Specificeert de unieke ID van de gebeurtenis om bewerkt te worden, optioneel vooraf gegaan door de configuratienaam of numerieke ID van de hulpbron met de gebeurtenis, in het formaat [resourceID:]eventUID.

##### Teruggegeven waarde

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

##### Beschrijving

`edit()` is een &DBus;-aanroep om de dialoog Alarm bewerken te tonen om het gespecificeerde alarm te bewerken.

editNew

#### editNew

Toon de Dialoogvenster om alarmen te bewerken om een nieuw alarm te bewerken.

    bool editNew(int type)

    bool editNew(const QString& sjabloonNaam)

##### Parameters

`type`

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

`sjabloonNaam`

  Specificeert de naam van een alarmsjabloon waarop het nieuwe alarm gebaseerd moet 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 een &DBus; aanroep om het Dialoogvenster om alarmen te bewerken te tonen om een nieuw alarm te bewerken. Als een type alarm is gespecificeerd als parameter, zal een blanco dialoog worden getoond. Alternatief, als een naam van een alarmsjabloon is als parameter is gespecificeerd, zal de dialoog ingevuld zijn met details uit het sjabloon.

lijst

#### lijst

Geeft een lijst van geplande alarmen.

    QString list()

##### Teruggegeven waarde

Lijst met alarmen, gescheiden door nieuwe-regel, elk in het formaat hulpbron_id:UID tijd tekst

##### Beschrijving

`list()` is een aanroep van &DBus; om een tekenreeks terug te geven met een samenvatting van geplande alarmen. De lijst toont beknopte details van elk wachtend alarm: zijn hulpbron-identifier UID, volgende geplande tijd en berichttekst of bestand.

### Commandoregel-interface

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

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.

De opties voor de commandoregel voor het plannen van een nieuw alarm zijn zoals beschreven in de sectie werken vanaf de opdrachtregel. De opties voor af laten lopen en annuleren van geplande alarmen zijn als volgt:

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

Optie | Beschrijving
--- | ---
`--cancelEvent eventID` | Annuleert het alarm met de gespecificeerde gebeurtenis-id. De uitgevoerde actie is hetzelfde als voor de aanroep van triggerEvent() &DBus;. `--cancelEvent` kan niet worden gespecificeerd bij deze optie.
`--triggerEvent eventID` | Start het alarm met de gespecificeerde gebeurtenis-id. De gebeurtenis-ID is de unieke ID van de gebeurtenis, optioneel voorafgegaan door de ID van de hulpbron met de gebeurtenis, in het formaat [resourceID:]eventUID. De genomen actie is dezelfde als voor de triggerEvent() &DBus;-aanroep. `--cancelEvent` kan met deze optie niet gespecificeerd worden.

Voorbeelden zijn:

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

## Vragen en antwoorden

Welke instellingenbestanden gebruikt &kalarm;?

De configuratie van &kalarm; is opgeslagen in de volgende bestanden in de map `qtpaths --paths GenericConfigLocation` :

- `kalarmrc` bevat uw voorkeuren voor &kalarm;.

- `kalarmresources` bevat de lijst met alarmagenda's nu in gebruik door &kalarm;.

Waar worden de alarmen van &kalarm; opgeslagen?

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

- `kalarm/calendar.ics` bevat actieve alarmen.

- `kalarm/expired.ics` bevat gearchiveerde alarmen.

- `kalarm/template.ics` bevat sjablonen voor alarmen.

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

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

In welk formaat worden alarmen opgeslagen?

De agendabestanden waarin &kalarm; zijn alarmen opslaat zijn tekstbestanden waarvan het formaat is gedefinieerd door het document RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). Dit is het standaard formaat gebruikt door alle kdepim-toepassingen. &kalarm; gebruikt bepaalde niet-standaard eigenschappen, conform RFC2445. Deze zijn gedocumenteerd in het bestand `kalarmcal/DESIGN.html` die wordt gedistribueerd met &kalarm;.

Wat is het programma kalarmautostart?

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

&kalarm; wordt gewoonlijk hersteld door de sessiemanager bij aanmelden (om zijn vensters in dezelfde status weer te geven als ze waren bij afmelden). Maar als het niet actief was bij afmelden, dan wordt het niet gestart door de sessiemanager en daarom is autostart nodig. Het probleem is dat wanneer een toepassing zowel beheerd wordt door de sessiemanager als autostart is, er geen garantie is welke eerst zijn gebeuren. Als autostart het eerst krijgt, zal het willen voorkomen dat de sessiemanager de status van de toepassing zal herstellen.

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.

Hoe kan ik &kalarm; gebruiken op een niet-&plasma; bureaublad?

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

## Dankbetuigingen en licentie

&kalarm;

Programma copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 &David.Jarvie; &David.Jarvie.mail;

Documentatie copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 &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.

&documentation.index;