# &kalarm;i käsiraamat

## Sissejuhatus

&kalarm; võimaldab ajastada isiklike häireteadete näitamist, helifailide esitamist, käskude käivitamist ja kirjade saatmist.

Vaikimisi käivitatavas graafilises režiimis näitab &kalarm; ootelolevate häirete nimekirja ühes käivitamise aja ja muude üksikasjadega. On võimalik luua uusi häireid või valida olemasolev, et seda muuta või sootuks kustutada. Lisavõimalusena võib lasta näidata ka varasemaid häireid.

Häiret luues või muutes on võimalik kirjutada häire teate tekst, valida teksti- või pildifail, mida sel puhul näidatakse, tegevus, mis käivitatakse või e-posti aadress, kuhu vastav kiri saadetakse. Samuti saab valida häireteate värvi, selle kordumise, heli esitamise või teate kõnelemise ja selle, kas häire tuleb tühistada või mitte, kui seda ei ole võimalik anda ettenähtud ajal.

Häireid saab ajastada ka käsurea abil või rakenduste esitatavate &DCOP;-väljakutsete vahendusel.

Kui häire aeg on kätte jõudnud, käivitatakse see kõigil &kde; töölaudadel, et sa kindlasti seda tähele paneksid. Teateaken näitab aega, millele häire on ajastatud. Tavaliselt on seal võimalik ka häiret edasi lükata. Üks näide häire kohta:

&kalarm;i teate aken Häireteade

Kui häire on määratud mingit käsku käivitama või kirja saatma, ei näita &kalarm; teadet.

&kalarm; võib töötada kahes režiimis: pidev (vaikimisi), mille puhul see töötab süsteemses salves, või nõudmisel, mille puhul see töötab ainult siis, kui vaja (soovi korral näidates ka siis ennast ikoonina süsteemses salves).

Käesolevas käsiraamatus on korduvalt viidatud häiredeemonile. See on rakendus, mis toimib taustal, kontrollides ootelolevaid häireid ja andes &kalarm;ile tegutseda, kui õige aeg on kätte jõudnud.

## &kalarm;i kasutamine

Käivitatuna ilma käsurea argumentideta alustab &kalarm; tööd graafilisena ning näitab parajasti kehtivat häirete nimekirja.

Kui &kalarm; käivitada graafilises režiimis, kontrollib ta, kas häiredeemon töötab või mitte. Kui ei, siis paneb &kalarm; selle tööle.

Kõigil &kalarm;i kerimiskastidel on olemas kiirendusvõimalus: kui soovid, et kasti väärtus muutuks suurema sammu võrra, hoia kerimisnooltele klõpsates all klahvi Shift.

### Häirete nimekiri

&kalarm;i peaaken näitab eesseisvaid häireid koos käivitamise ajaga, kordamise intervalli, värvide ning näidatava teksti, tekstifaili nime, käivitatava käsu või kirja saaja e-posti aadressiga. (Korduva alarmi korral on näidatav aeg järgmine käivitumise aeg. Meeldetuletusega häire korral näidatakse häire enda, mitte meeldetuletuse aega.) Iga häire teksti/faili/käsu/kirjateema kõrval vasakul asuv ikoon näitab, millist tüüpi häirega on tegemist.

&kalarm;i peaken Peaaken

Korduva alarmi korral näidatakse nimekirjas järgmise käivitamise aega ning kordumise intervalli (⪚ 1 päev igapäevaselt, 3 nädalat iga kolmanda nädala esmas- ja kolmapäeval käivitatava häire või sisselogimisel alati sisselogimise ajal käivitatava häire korral).

Häireid võib sorteerida kuupäeva/aja, kordumise intervalli, värvi, tüübi või teksti järgi, klõpsates vastava veeru tiitliribale. Sorteerimiseks samal alusel, aga vastupidises järjekorras klõpsa uuesti tiitliribale.

Näidata võib lasta ka iga häireni jäänud aega nii koos häire ajaga või ka ilma selleta. Häire ajaveeru näitamiseks või peitmiseks vali menüükäsk Vaade Näita häirete aegu. Häireni jäänud aja näitamiseks/peitmiseks vali menüükäsk Vaade Näita häireteni jäänud aega. Üht neist veergudest näidatakse alati. Seda, millist veergu vaikimisi näidatakse, saab määrata seadistustedialoogis.

#### Aegunud häired

Vaikimisi salvestab &kalarm; häired teatud ajaks ka pärast seda, kui need on aegunud või kustutatud. (Pane siiski tähele, et kustutatud häired salvestatakse ainult siis, kui neid on vähemalt korra käivitatud.) Seda, kas &kalarm; aegunud häired salvestab ja kui kaua neid säilitatakse, saab määrata seadistustedialoogis.

Aegunud häirete nägemiseks nimekirjas vali menüükäsk Vaade Näita aegunud häireid. Nende varjamiseks korda seda tegevust. Nende vaikimisi näitamise saab sisse lülitada seadistustedialoogis.

#### Otsimine häirete nimekirjas

Konkreetsete häirete leidmiseks võib kasutada otsingut. Selleks vali menüükäsk Redigeerimine Otsi. Otsingudialoogis määra, millist laadi häiret soovid otsida. Täiendavate sobivate häirete leidmiseks kasuta menüükäske Redigeerimine Otsi järgmine ja Redigeerimine Otsi eelmine .

Otsing sooritatakse järgmiselt:

- Tekstihäired: otsitakse teate teksti.

- Failihäired: otsitakse faili asukohta/URL-i.

- Käsuhäired: otsitakse käsurida või skripti.

- E-posti häired: lisaks kirja teemale ja sisule otsitakse ka saajaid ja kaasatud failide URL-e.

Otsimiseks saab valida ainult häireid, mida näidatakse parajasti häirete nimekirjas. See tähendab, et kui soovid otsida aegunud häireid, tuleb need kõigepealt nimekirjas nähtavaks muuta (seda kirjeldati eespool).

### Häire loomine ja muutmine

#### Uue häire loomine

Uue häire loomiseks talita ühel järgnevatest viisidest. See avab häire muutmise dialoogi, mis võimaldab häiret seadistada.

- Vali menüükäsk Toimingud Uus.

- Klõpsa hiire parema nupuga süsteemse salve ikoonil ja vali ilmuvast menüüst Uus.

- Klõpsa hiire parema nupuga süsteemse salve ikoonil.

- Klõpsa hiire parema nupuga häire nimel nimekirjas ja vali ilmuvast menüüst Uus.

- Tee topeltklõps tühjal ruumil häirete nimekirja viimase kirje järel.

Uusi häireid võib luua ka mitmesuguste allikate põhjal, mis annavad vähemalt osa parameetreid juba ette:

- Uue häire loomiseks häiremalli põhjal järgi osas Häiremallid toodud juhiseid.

- Uue häire lisamiseks varasema häire põhjal märgi soovitud häire nimekirjas ja vali menüükäsk Toimingud Kopeeri. See avab häire redigeerimise dialoogi, kus on juba ees valitud häire parameetrid.

- Uue häire loomiseks, mis näitaks olemasolevat e-kirja, lohista vastav kiri &kmail;ist &kalarm;i peaaknasse või süsteemse salve ikoonile. See avab häire redigeerimise dialoogi, kus kogu kirja, kaasa arvatud saatja, saaja jne., näidatakse häire tekstina.

- Uue häire loomiseks, mis saadaks olemasoleva e-kirja koopia, lohista vastav kiri &kmail;ist &kalarm;i peaaknasse või süsteemse salve ikoonile. Seejärel vali E-post. Häire redigeerimise dialoog näitab nüüd kogu kirja, välja arvatud saatja.

- Mis tahes teksti lohistamine &kalarm;i peaaknasse või süsteemse salve ikoonile avab häire redigeerimise dialoogi ja asetab lohistatud teksti sinna häire tekstina.

- Faili näitava häire loomiseks lohista faili URL &kalarm;i peaaknasse või süsteemse salve ikoonile. See avab häire redigeerimise dialoogi, kus faili nimi on juba ette määratud.

- Võimalik on automaatselt luua sünnipäevahäireid inimeste kohta, kes esinevad sinu &aadressiraamat;us. Seda kirjeldab lähemalt osa Sünnipäevade importimine &aadressiraamat;ust.

#### Olemasoleva häire muutmine

Olemasoleva häire muutmiseks (midagi muuta ei saa vaid aegunud häirete juures) võta ette mõni järgnev samm:

- Tee topeltklõps selle nimel häirete nimekirjas.

- Vali see klõpsuga häirete nimekirjas ja kasuta seejärel menüükäsku Toimingud Muuda

- Klõpsa selle nimel häirete nimekirjas hiire parema nupuga ja vali ilmuvast menüüst käsk Muuda.

See avab häire redigeerimise dialoogi.

#### Häire aktiveerimine/deaktiveerimine

Olemasoleva häire kustutamiseks:

- vali häire klõpsuga selle nimel nimekirjas. Seejärel vali menüükäsk Toimingud Kustuta .

- klõpsa hiire parema nupuga häire nimel nimekirjas ja vali ilmuvast menüüst Kustuta.

Kui kustutad aktiivse häire, salvestatakse see aegunud häirena juhul, kui seda on enne kustutamist vähemalt korra käivitatud ja kui aegunud häirete salvestamine on üldse lubatud (seda, kas ja kui jah, siis kui kaua aegunud häireid salvestatakse, saab määrata seadistustedialoogis). Kui kustutad aegunud häire või aktiivse, kuid käivitamata häire, kustutatakse see jäädavalt.

Kustutatud häire saab aegunud häirete nimekirjast uuesti aktiveerida, kui see ei ole just juba sealtki kustutatud. Selleks too kõigepealt aegunud häired nähtavale, nagu kirjeldab osa Aegunud häired. Seejärel:

- vali häire või häired klõpsuga nende nimel nimekirjas. Seejärel vali menüükäsk Toimingud Aktiveeri uuesti .

- klõpsa hiire parema nupuga häire nimel aegunud häirete nimekirjas ja vali ilmuvast menüüst Aktiveeri uuesti.

#### Häire lubamine/keelamine

Täpsemat infot häirete lubamise ja keelamise kohta kas ühe- või mitmekaupa leiab osast Häirete lubamine/keelamine.

#### Häire vaatamine

Olemasoleva häire vaatamiseks ilma võimaluseta seda muuta:

- vali häire klõpsuga selle nimel nimekirjas. Seejärel vali menüükäsk Toimingud Vaata .

- klõpsa hiire parema nupuga häire nimel nimekirjas ja vali ilmuvast menüüst Vaata.

See avab häire redigeerimise dialoogi kirjutuskaitstuna.

#### Häire nägemise kinnitamine

Seda, kuidas anda märku häire kättesaamisest, vaata osast Häireteate aken.

#### Häiremallid

Kui sul on sageli vaja ühesuguseid häireid käivitada, võid luua häiremalli, et mitte sisestada alati aina uuesti samu üksikasju. Mall võib sisaldada kõiki häires esinevaid detaile, välja arvatud muidugi algushetk.

Näiteks soovid määrata häire meelde tuletama telesaadet, mille aeg nädalast nädalasse muutub. Mall sisaldab kõiki häire üksikasju (teate tekst, kas mängida heli või mitte jne.), välja arvatud kuupäev ja kellaaeg. Siis on sul häire loomiseks vaja ainult häire redigeerimise dialoogis laadida vajalik mall ning sisestada kuupäev ja kellaaeg.

Uue häire loomiseks malli põhjal ava häire redigeerimise dialoog malli eelnevalt täidetud andmetega:

- Vali menüükäsk Toimingud Uus häire mallist ja seejärel vajalik mall.

- klõpsa hiire parema nupuga ikoonil süsteemses salves ja vali menüüst Uus häire mallist ning seejärel vajalik mall.

- Ava häire redigeerimise dialoog tavalisel viisil ning klõpsa nupule Laadi mall... Seejärel vali mall.

##### Mallide seadistamine

Malle saab luua, muuta või kustutada häiremallide dialoogis, samuti võib luua uue häiremalli olemasoleva malli baasil.

Uue häiremalli loomiseks:

- Ava häiremallide dialoog menüükäsuga Fail Mallid... ning klõpsa nupule Uus. See avab tühja malli redigeerimise dialoogi.

- Ava häiremallide dialoog menüükäsuga Fail Mallid..., vali nimekirjast olemasolev mall ja klõpsa nupul Kopeeri. See avab malli redigeerimise dialoogi, kus on juba ees valitud häire parameetrid.

- Vali soovitud häire häirete nimekirjas ja seejärel menüükäsk Toimingud Loo mall. See avab malli redigeerimise dialoogi, kus on juba ees valitud häire parameetrid.

Olemasoleva malli muutmiseks ava häiremallide dialoog menüükäsuga Fail Mallid... ja klõpsa nupule Muuda. See avab allpool kirjeldatava malli redigeerimise dialoogi.

Olemasoleva malli kustutamiseks ava häiremallide dialoog menüükäsuga Fail Mallid..., vali üks või enam mall ja klõpsa nupule Kustuta. Selle peale küsitakse sinu käest kinnitust, et vältida juhuslikku kustutamist.

##### Malli redigeerimise dialoog

Malli redigeerimise dialoog on sarnane häire redigeerimise dialoogiga. Erinevad on järgmised võimalused:

- Sisesta malli nimi väljale Malli nimi. See on nimi, mida näidatakse malli valimise nimekirjas, seepärast on mõttekas anda nimi, mille põhjal saaksid ka ise aru, milleks see on mõeldud. Mallil peab olema unikaalne nimi.

- Sektsioonis Aeg saab valida:

  - Vaikeaeg, kui sa ei soovi määrata konkreetset käivitamise aega. Sellele mallile tuginevad häired kasutavad sellisel juhul tavalist uute häirete käivitamise vaikeaega.

  - Aeg võimaldab sisestada häire käivitamise aja.

  - Suvaline aeg võimaldab määrata häire käivitumise aja ainult kuupäeva, mitte kellaajaga.

  - kastis Praegusest ajast alates saab sisestada, millal pärast praegust hetke (tundides ja minutites) tuleks häire käivitada.

- Kaardi Kordumine sektsioonis Kordamise reegel ei ole vaja määrata kuupäeva ega kuud vastavalt iganädalaste või igakuiste häirete jaoks.

#### Häirete importimine välistest kalendritest

Häireid saab &kalarm;i muudest kalendrifailidest importida menüükäsuga Fail Impordi häired.... Importimisel otsitakse valitud kalendrifailist häireid sisaldavaid sündmusi ning kopeeritakse need (koos uue unikaalse ID-ga) &kalarm;i kalendrisse. Häireteta sündmusi ja muud tüüpi kalendrikirjeid ignoreeritakse.

Kui importida häireid kalendrifailist, mis on loodud mõne muu rakendusega kui &kalarm;, võivad häired importimisel muutuda – isegi häire aeg võib muutuda. See sõltub häire loomiseks kasutatud rakenduse andmesalvestuse viisist ning muutused on vältimatud, kui see erineb sellest, mida eeldab &kalarm;. Seepärast tasub alati imporditud häired üle kontrollida, et neis ei esineks soovimatuid muudatusi, ning vajaduse korral neid kohandada.

#### Sünnipäevade importimine &aadressiraamat;ust

Sünnipäevade nägemiseks, mis leiduvad &aadressiraamat;us, vali menüükäsk Fail Impordi sünnipäevad.... See avab dialoogi, kus saab valida, millistele sünnipäevadele häire luua.

- Sektsioonis Häire tekst saab anda teksti, mida näidatakse sünnipäevade häireteadetes. Selle saab luua kujul prefiks pluss isiku nimi pluss sufiks. Tühikuid automaatselt ei lisata, nii et väljal Prefiks tuleb sul endal anda vajalikud lõpetavad tühikud ning väljal Sufiks vajalikud alustavad tühikud.

  Häire teksti muutes vaatab rakendus sünnipäevade nimekirja uuesti üle.

- Nimekirjas Sünnipäevade valimine vali kõik need sünnipäevad, millele soovid häiret luua. Pane tähele, et nimekirjas näidatakse ainult neid &aadressiraamat;u kirjeid, mis sisaldavad sünnipäeva ja millele ei ole juba määratud häiret parajasti sektsioonis Häire tekst määratud vormis.

- Ülejäänud valikud on sarnased häirete teksti võimalustega häirete redigeerimise dialoogis.

#### Võta tagasi / Tee uuesti

Enamikku &kalarm;i aktiivse seansi ajal ettevõetud toiminguid saab tagasi võtta ja uuesti teha, kaasa arvatud häirete ja häiremallide loomine, redigeerimine ja kustutamine ning häirete taasaktiveerimine. Et tagasivõtmiste ajalugu ei nõuaks liiga palju ressursse, on meelespeetavate muudatuste arvule seatud piiranguks 12.

Viimase toimingu tühistamiseks vali menüükäsk Redigeerimine Võta tagasi. Viimase tagasivõetud toimingu taassooritamiseks vali menüükäsk Redigeerimine Tee uuesti.

Mõne varasema muudatuse tühistamiseks klõpsa tööriistaribal nupule Võta tagasi ja hoia hiirenuppu all. Ilmub toimingute nimekiri, kus saad valida, milline neist tagasi võtta. Kui sa ei näe vajalikku toimingut, siis arvesta, et vaja võib olla kõigepealt tühistada mõned hilisemad toimingud, millest sinu soovitud toiming sõltub. Kui näiteks oled häiret redigeerinud ja seejärel selle kustutanud, ei saa sa redigeerimist tühistada, kui sa ei ole tühistanud kustutamiskäsku.

Mõne varasema muudatuse taassooritamine käib samamoodi, ainult et mõistagi tööriistariba nupuga Tee uuesti.

### Häire redigeerimise dialoog

Häire redigeerimise dialoog võimaldab häiret näha ja muuta.

Häire redigeerimise dialoog Häire redigeerimise dialoog

#### Häiretoiming

Määra häire tüüp kastis Toiming:

- Tekst võimaldab sisestada tekstikasti häire teksti (see võib olla ka mitmel real ja tarvitada reavahetusi). Määrata saab järgmisi võimalusi:

  - Valik Heli võimaldab valida, kas häireteate näitamise ajal esitatakse ka heli. Valikud on järgmised:

    - Puudub näitab häiret vaikselt.

    - Piiks toob kuuldavale piiksu.

    - Kõnelemine tähendab lisaks häireteate näitamisele ka selle kuuldavat esitamist. See valik on kasutatav ainult siis, kui paigaldatud ja seadistatud on KTTSD (moodulis kdeaccessibility) ning sobiv kõnesüntesaator, ⪚ Festival.

    - Helifail esitab helifaili. Paremal asuva nupuga saab avada helifaili dialoogi, kus saab valida esitatava faili ning määrata selle helitugevuse ja soovi korral kordamise. Hiirt nupu kohal seisma jättes näeb kohtspikris parajasti valitud helifaili.

      &kalarm; kasutab kordamiste ja helitugevuse juhtimiseks heliserverit &arts;. Kui &kalarm; on ehitatud ilma &arts;i toetuseta, ei saa kordamise ja helitugevuse valikuid kasutada ning täieliku helifaili dialoogi asemel näeb tavalist lihtsat failivalijat.

      Helifaili dialoogis:

      - Sisesta helifaili asukoht või kasuta tekstikasti kõrval olevat nuppu failidialoogi avamiseks. Valitud faili saab kuulata, kui klõpsata tekstiväljast vasakul pool asuvale esitamisnupule. Seejärel muudab nupp oma funktsiooni ja võimaldab esitamise peatada, kui oled faili piisavalt kuulanud.

      - Kasti Kordus märkimisel korratakse helifaili pidevalt seni, kuni häiret näidatakse (häreteate aknas on nupp, millega saab heli esitamise välja lülitada, kui sa soovid näha häiret ilma helita).

      - Vali Helitugevus ja kasuta liugurit määramaks, kui vali peab helifail esitamisel olema.

      - Soovi korral saab lasta helil tugevneda. See tähendab, et helifaili hakatakse mängima teatud helitugevusega, mis muutub järk-järgult, kuni saavutab määratud aja jooksul lõpliku helitugevuse. Lõplik helitugevus on see, mille määrasid valikuga Helitugevus. Tugevnemise võimaldamiseks märgi Tugevnemine, sisesta sekundites tugevnemise aeg ning määra liuguriga Algne helitugevus.

      Võimaluse korral kasutatakse helitugevuse määramiseks &kmix;i. See tagab, et helitugevust, millega häiret esitatakse, ei sega muudatused arvuti helitasemes. Kui &kmix; pole paigaldatud (või on varasem kui &kde; 3.1), määratakse helitugevus suhtelisena helitaseme suhtes häire käivitamise ajal. Sel juhul sõltub helitugevus, millega häiret esitatakse, arvuti helitaseme muudatustest.

      Nupuga Proovi saab valitud helitugevust testida.

  - Nupuga Font ja värv... saab valida häireteate fondi ning esi- või tagaplaani värvi. Dialoogis Häire fondi ja värvi valimine võib märkida kasti Kasutatakse vaikefonti, millisel juhul häiret näidatakse selle fondiga, mis häire kõlamise ajal on süsteemis vaikefondiks. (Vaikefonti saab määrata seadistustedialoogis.) Konkreetse fondi määramiseks häire tekstile eemalda märge kastist Kasutatakse vaikefonti.

    Valitud fonti ja värve näidatakse nupu kõrval näitetekstina. Seda saab muuta näiteks eritähtede väljanägemise uurimiseks.

  - Nupuga Eritoimingud... saab määrata shellikäsud, mis käivitatakse enne häire näitamist. Dialoogis Spetsiaalsed häiretoimingud:

    - Sisesta väljale Häire-eelne toiming shellikäsk, mis tuleb käivitada enne häire näitamist. Pane tähele, et &kalarm; ootab käsu lõplikku täitmist, enne kui näitab häiret.

      Häire-eelne toiming võetakse ette ainult üks kord, enne häire esimest kasutamist, kaasa arvatud juhul, kui meeldetuletus on asendatud tegeliku häirega. Seda ei võeta ette järgmistel juhtudel:

      - Meeldetuletuse esitamisel.

      - Häire esitamisel uuesti pärast selle edasilükkamist.

      - Häire esitamisel ajal, mil sa olid välja loginud, ning selle taastamisel, kui uuesti sisse logid.

      - Korduva häire käivitumisel, kui eelmine häire (või edasilükatud häire) on veel nähtav - see tähendab juhul, kui häire eelmist korda ei ole veel kustutatud.

    - Väljale Häirejärgne toiming saab sisestada shellikäsu, mis käivitatakse pärast häire kustutamist (kas klõpsuga nupule Sulge või akna tiitliriba sulgemisnupule). Seda ei võeta ette järgmistel juhtudel:

      - Meeldetuletuse sulgemisel.

      - Häire edasilükkamisel, välja arvatud juhul, kui edasilükatud häire lõpuks suletakse.

      - Häire sulgemisel väljalogimise tõttu.

    Vaata allpool häirekäskude kirjeldust, kus on juttu, kuidas käivitatakse shellikäsud.

- Fail lubab sisestada teksti- või pildifaili nime või &URL;-i, mille sisu esitatakse häireteatena. Tekstivälja kõrval asuv nupp avab faili valimise dialoogi. Ülejäänud valikud sarnanevad eelkirjeldatud tekstihäirete omadega, kuid siiski pole saadaval valik Kõnelemine.

- Käsk võimaldab sisestada käivitatava käsu.

  Seda võimalust ei saa kasutada, kui &kde; töötab nn. Kioski-režiimis.

  - Kastiga Skripti sisestamine saab määrata, kas sisestada shellikäsk või skripti.

    Kui see on märkimata, saab määrata käsureakorralduse, mis häire aktiveerumise ajal antakse. Käsk edastatakse vahetult vaikeshellile (selle määrab keskkonnamuutuja `SHELL`) ning see võib sisaldada mis tahes võtmeid, argumente, filtreeritavaid käske jne., mida shell üheainsa käsureakorralduse puhul vähegi võimaldab.

    Kui see on märgitud, saab sisestada käivitatava skripti teksti. Pane tähele, et esimesel real oleks midagi sellist nagu `#!/bin/bash`, et kutsutaks välja sobiv käsuinterpretaator.

  - Käsu väljund võimaldab määrata, mida võtta ette käsu käivitamisel tekkiva terminali väljundiga.

    - Käivitatakse terminali aknas: märkimisel käivitatakse käsk terminali aknas. Millist terminali kasutatakse, saab määrata seadistustedialoogis.

    - Logitakse faili: käsu väljund salvestatakse faili. Väljund, mille ette lisatakse päis, mis näitab aega, mil käsk oli ajastatud käivituma, lisatakse faili senisele sisule. Sisesta faili nimi tekstikasti või kasuta selle kõrval asuvat nuppu failidialoogi avamiseks, kust vajalik fail valida.

    - Unusta: käsu väljund unustatakse.

- E-post võimaldab saata kirja, määrates siin saajate aadressid, kirja teema ehk subjekti ning selle sisu. Adressaatide välja kõrval asuva nupuga saab avada &kde; aadressiraamatu ning valida sealt vajalikud aadressid. Kirjale saab ka faile lisada, kasutades selleks nuppu Lisa.... Arvesta, et kaasatud failid peavad olemas olema ka sel hetkel, kui häire käivitub. Häire määramise ajal neist koopiaid ei salvestata. Kaasatud faili eemaldamiseks vali see hüpikmenüüst ning klõpsa nupule Eemalda.

  Võimalik on määrata järgmisi valikuid:

  - Liitkastis Kellelt saab valida, millist &kmail;i identiteeti kasutada oma e-posti aadressina kirja saatmisel. See on kasutatav ainult siis, kui sinu e-posti aadressi välja Kellelt jaoks on seadistustedialoogis määratud valik Kasutatakse &kmail;i identiteete. Kui aga oled seadistustedialoogis määranud konkreetse e-posti aadress, ei ole siin midagi valida.

  - Kasti Kiri ka iseendale märkimisel saadetakse häire käivitamisel pimekoopia (BCC) saadetavast kirjast ka sulle. Aadressi, millele kiri saadetakse, saab määrata seadistustedialoogis, vaikimisi kasutatakse &kde; juhtimiskeskuses määratud aadressi.

#### Edasilükkamine

Kui häire on korduv ja on viimasel näitamisel edasi lükatud, siis näitab sektsioon Edasilükatud häire aega, millele häire on edasi lükatud. Klõps nupul Muuda... avab dialoogi, kus saab edasilükkamise aega muuta või selle üldse tühistada.

#### Aeg

Sektsioonis Aeg saab

- kasti Kuupäev/kellaaeg sisestada kuupäeva ja aja, millal häire käivitatakse. Märgi ära kast Suvaline aeg, kui soovid määrata ainult kuupäeva. Sellisel juhul näidatakse häiret tol kuupäeval esimesel võimalusel või pärast määratud algusaega (selle määramist kirjeldab osa &kalarm;i seadistamine).

  Mittekorduva häire korral peab sisestatav kuupäev/kellaaeg olema tulevikus või kui sisestada ainult kuupäev, siis mitte varasem kui käesolev päev. Korduva häire korral sellist piirangut pole, sest sellisel juhul rakendatakse kuupäeva/kellaaega automaatselt esimesel sobival käesolevale hetkele järgneval ajal.

- kastis Praegusest ajast alates sisestada, millal pärast praegust hetke (tundides ja minutites) tuleks häire käivitada.

#### Meeldetuletus

Kasti Meeldetuletus märkimisel saab lasta näidata meeldetuletust enne häiret ja enne selle kordusi (kui neid on). Seda, kui kaua enne häiret meeldetuletust näidatakse, saab määrata kohe kasti kõrval.

Meeldetuletusi ei näidata kordusesiseste alamkorduste puhul. Meeldetuletusi näidatakse ainult iga häire peakorduse eel.

Korduva häire korral märgi ära kast Meeldetuletus ainult häire esimesel käivitamisel, kui soovid, et meeldetuletust näidataks ainult enne häire esmakordset kasutamist. Kui kast märkimata jätta, on meeldetuletuse periood väiksem kui kordumise intervall.

#### Katkestamine

Katkestamisvalikud lubavad määrata, mida võetakse häirega ette pärast selle käivitamise aja möödumist:

- Tähtaja möödumisel häire katkestatakse võimaldab määrata, mis juhtub siis, kui häiret ei saa ettenähtud ajal käivitada.

  Kasti märkimisel katkestatakse häire, kui seda ei õnnestu käivitada määratud aja jooksul pärast käivitamisaega. Tähtaja saab määrata valikutega, mis ilmuvad siis, kui kasti märgistad. Kui näiteks määrad tähtajaks 1 tunni, käivitatakse häire pärast käivitamisaja saabumist esimesel võimalusel järgneva tunni jooksul, aga kui seda selle tunni jooksul ei õnnestu käivitada, häire tühistatakse.

  Ainult kuupäevaga määratud häirete korral, &ie; häirete puhul, mille korral on valitud Suvaline aeg, arvutatakse tähtaega vaikimisi kehtivast päevaalgusest.

  Kui jätta kast märkimata, käivitatakse häire pärast käivitamisaja möödumist esimesel võimalusel alati sõltumata sellest, kui palju aega on möödunud.

  Häire on võimalik käivitada ainult siis, kui oled end sisse loginud ja kui nii X kui ka häiredeemon töötavad.

- Valiku Akna automaatne sulgemine pärast seda aega märkimisel suletakse häireaken automaatselt pärast määratud tähtaja möödumist.

#### Kordamine

Määramaks, kas häiret korratakse või mitte, tuleb kasutada kaarti Kordus.

Häire kordumise põhimalli näidatakse kaardi Kordus pealkirjas. Kaardil on esmalt näha kordamise intervall, seejärel aga võimalike alamkorduste intervall, mis on määratud nupuga Alamkordus.

Sektsioonis Kordamise reegel saab määrata kordamiste tüübi või ajalise ulatuse:

- Häire ühekordseks käivitamiseks vali Ei korrata.

- Häire käivitamiseks igakordsel sisselogimisel vali sisselogimisel (arvesta, et sisselogimisel korratav häire käivitub ka juhul, kui oled häired keelanud ja need taas lubad või kui häiredeemoni uuesti käivitad või nullid).

- Kordamiseks regulaarse ajavahemiku järel vali meelepärane tüüp ning märgi kastis Kordamise intervall ära, milline hulk vastavaid perioode peab korduste vahele jääma. Näiteks selleks, et häire korduks iga kahe nädala järel, vali päev ja sisesta kasti 14 või vali nädal ja kirjuta kasti 2. Vastavalt valitud perioodile saab kasutada ka lisavalikuid:

  - nädalase vahe korral saab valida, millisel nädalapäeval peaks häire käivituma.

  - kuise vahe korral saab valida kas konkreetse kuupäeva või määratud nädalapäeva (⪚ teine teisipäev).

  - aastase vahe korral saab valida kas konkreetse kuupäeva või määratud kuu päeva (⪚ mai viimane laupäev). Vali ühtlasi kõik kuud, millal soovid häire käivitada.

  Häire käivitamiseks ainult teatud nädalapäevadel vali nädalane vahe ja märgi ära kõik vajalikud nädalapäevad.

Sektsioonis Kordamise lõpetamine saab määrata kordamiste ajalise ulatuse:

- ei lõpegi tähendab kordamist igavesti.

- lõpp saabub pärast lubab määrata korduste koguarvu.

- lõpp saabub lubab määrata kuupäeva/aja,millal häiret viimane kord korratakse.

Kui soovid teatud kuupäevad/ajad määratud kordamistest välja jätta, tee seda sektsioonis Erandid. Erandite (&ie; väljajäetud kuupäevade/aegade) nimekirja näidatakse vasakul. Uue erandi lisamiseks määra kuupäev paremal ja klõpsa nupule Lisa. Erandi muutmiseks vali see nimekirjas, määra paremal uus kuupäev ja klõpsa nupule Muuda. Erandi kustutamiseks vali see nimekirjas ja klõpsa nupule Kustuta.

##### Alamkordus

Nuppu Alamkordus saab kasutada kordusesisese kordamise määramiseks. Sellisel juhul ei käivitata häireid ajal, mida määrab kaart Kordamine, mitte ühekordselt, vaid korduvalt vastavalt intervallile, mis on määratud nupuga Alamkordus. Kui näiteks soovid luua häiret, mis kordub igal neljapäeval lõunast kella kuueni õhtul, võid kaardil Kordamine määrata häire kordamise iga nädala neljapäeval kell 12:00 ning alamkorduse dialoogis määrata intervalli 1 tund ja kordamise arvuks 6 või kestvuseks 6 tundi.

Alamkorduse dialoogis, mille saab avada klõpsuga nupule Alamkordus, saab kastiga Kordumise intervall kordamise sisse või välja lülitada, Kui Kordumise intervall on märgitud, saab kordamise seadistada järgmiselt:

- Määra kordamistevaheline intervall kasti Kordumise intervall kõrval olevate elementidega. Vali vajalik ajaühik (⪚ päev) ja seejärel ühiku arv.

- Määra kas kordamiste arv või kestvus:

  - Korduste arv võimaldab määrata, mitu korda häiret pärast peamist kordust käivitatakse. Kui näiteks soovid, et häiret käivitataks iga peakorduse puhul 4 korda, &ie; 3 lisakorda, sisesta siia 3.

  - Kestus võimaldab määrata aja, mille jooksul häiret korratakse. See ei pea täpselt ühilduma kordamise intervalliga: kui klõpsad OK, ümardatakse seda vajaduse korral intervallile vastavaks.

Ühe ja sama häire alamkorduste kattumise vältimiseks on alamkorduste kestus piiratud: see peab olema väiksem kui peakorduste pikim intervall. Iga kord, kui peakorduses määratud häire aktiveerub, katkestatakse automaatselt kõik häire eelmisest kordusest kehtima jäänud aktiivsed alamkordused.

#### Muud valikud

Kast Kinnituse küsimine lubab määrata, kas häireteate akna sulgemisel küsitakse sinu käest kinnitust. See võib olla kasulik näiteks häirete juhuslike sulgemiste vastu.

Kasti Näidatakse &korganizer;is märkimisel lisatakse häire &korganizer;i aktiivsesse kalendrisse, kus seda näidatakse ilma häireta sündmusena. See võimaldab pidada häiretel silma peal &korganizer;i abil, sekkumata samas &kalarm;i tegevusse.

Kui hiljem muudad sellist häiret &kalarm;is või selle seal kustutad, muudetakse või kustutatakse vastav sündmus ka &korganizer;is. Kui aga muudad sündmust &korganizer;is, ei mõjuta see häiret &kalarm;is.

Klõpsa nupule Lae mall ja vali eelnevalt määratud võimalustega mall, mida kirjeldatakse osas Häirete loomine ja muutmine.

Häire testimiseks klõpsa nupule Proovi. See käivitab häire täpselt nagu tavalisel käivitamisel.

Kui kõik üksikasjad on soovikohaselt paika pandud, klõpsa nupule OK, mis lisab häire nimekirja.

### Häireteate aken

Kui häire määratud aeg kätte jõuab, näidatakse seda igal &kde; töölaual ning seda ei saa varjata tavalise aknaga, mis tagab, et sa kindlasti seda märkad. Teateaken näitab aega, millal häire pidi käivituma, nii et sa võid seda näha ka juhul, kui oled arvuti juurde naasnud pärast mõningast eemalolekut. (Meeldetuletuste korral on küll näidatav kuupäev/aeg häire toimumise või kordumise, mitte meeldetuletuse enda aeg, ning ka akna tiitliribal seisab Meeldetuletus.)

Häireteate aknad jäävad nähtavale seni, kuni sa oled neile reageerinud, kui just pole märgitud valik Akna automaatne sulgemine pärast seda aega häire redigeerimise dialoogis. Korduva häire korral ilmub juhul, kui eelmise häirega käivitunud aken on jäänud sulgemata, seesama aken uuesti. Nii välditakse arvukate ühesuguste teadete ilmumist ekraanile, kui sa mingil põhjusel ei soovi või ei saa teate nägemist kinnitada selle ilmumisel.

Häireteate aken pakub vastavalt häire seadistustele järgmisi võimalusi:

- Häire nägemist saab kinnitada klõpsuga nupule Sulge. See sulgeb akna (pärast kinnituse küsimist, kui märgitud on võimalus Häire kustutamisel küsitakse kinnitust).

- Häiret saab muuta klõpsuga nupule Muuda... See avab häire redigeerimise dialoogi.

- Häire edasilükkamise võimalusi saab valida klõpsuga nupule Lükka edasi. Seejärel vali Lükka edasi kuupäevale/ajale ja sisesta kuupäev ning aeg, millal teadet uuesti tuleks näidata, või Lükka edasi ajavahemiku võrra ja sisesta, mitme tunni ja minuti võrra tuleks teate näitamist edasi lükata. Seejärel klõpsa häireteate edasilükkamiseks nupul Lükka edasi.

  Aeg, millele häire edasi lükatakse, peab olema varasem kui häire järgmine kordumine või meeldetuletus. Seepärast ei saa nuppu Lükka edasi häireteate aknas ja nuppu OK edasilükkamise dialoogis kasutada, kui häire järgmise korduseni või meeldetuletuseni on jäänud vähem kui minut.

  Nupp Lükka edasi ei ilmu nende häirete korral, mida näidatakse sisselogimisel võimaluse Korratakse sisselogimisel valimise tõttu.

- Nupp, millel on kujutatud mängimise lõpetamise sümbol, lubab lõpetada häirele määratud helifaili esitamise.

- Kui häireteade on loodud kirja &kmail;ist lohistades, saab kirja &kmail;is ka otsekohe näha klõpsuga &kmail;i ikooniga nupule. See valib kirja &kmail;is ja tõstab selle esile.

  &kmail;i indeksi regenereerimisel läheb link kirjale &kmail;is kaotsi.

- Nupp, millel on kujutatud &kalarm;i ikoon, pakub mugava võimaluse &kalarm; aktiveerida.

Häireteate akent saab näidata kahel erineval moel vastavalt valitud seadistusele. Režiimi saab valida seadistustedialoogis.

- Tavalise akna korral võtab see ilmudes fookuse ka klaviatuuri jaoks, nii et kui töötad parajasti mõnes muus aknas, siis seal enam klahvile vajutamine ei toimi.

- Niinimetatud mittemodaalse akna korral häireteade küll ilmub, kuid klaviatuuri fookus ei muutu ning mõnes muus aknas töötamise korral võid seal oma tegevust jätkata. Selles režiimis ei ole aga aknal ka tiitliriba, mistõttu seda ei saa liigutada.

### Süsteemse salve ikoon

&kalarm; on võimalik panna tööle ikoonina süsteemses salves. See ikoon võimaldab üheainsa klõpsuga aktiveerida &kalarm;i ning lubab häire jälgimist nii juhtida kui vaadata selle olekut. Tavaline &kalarm;i ikoon näitab, et häireid jälgitakse, hallikas ikoon aga osutab, et alarme ei jälgita.

Kuii jätad hiirekursori mõneks hetkeks süsteemse salve ikooni kohale, näidatakse kohtspikrina järgmise 24 tunni jooksul käivitatavaid häireteateid või vähemalt neist esimesi. Selle võimaluse saab ka välja lülitada või näidatavate häirete arvu ja vormi muuta seadistustedialoogis.

Klõps hiire vasaku nupuga süsteemse salve ikoonil lülitab &kalarm;i peaakna näitamist ja peitmist.

Klõps hiire parema nupuga süsteemse salve ikoonil avab selle kontekstimenüü:

Luba häired

- Lubab häirete jälgimise. Seda saab kasutada ainult siis, kui häired ei ole parajasti sisse lülitatud.

  Täpsemat infot leiab osast Häire lubamine ja keelamine.

Keela häired

- Keelab häirete jälgimise. Seda saab kasutada ainult siis, kui häired on parajasti sisse lülitatud.

  Täpsemat infot leiab osast Häire lubamine ja keelamine.

Uus häire...

- Avab häire redigeerimise dialoogi ja lubab luua uue häire.

Uus häire mallist

- Näitab alammenüüs häiremallide nimekirja. Neist mõnda valides avatakse häire redigeerimise dialoog, kus mallis antud väärtused on juba ette täidetud.

&kalarm;i seadistamine...

- Avab &kalarm;i seadistustedialoogi.

  Seadistustedialoogi kirjeldatakse osas &kalarm;i seadistamine. Seal on juttu ka &kalarm;i süsteemse salve ikooni puudutavatest valikutest.

Taasta / Minimeeri

- Taastab või minimeerib &kalarm;i peaakna.

  See võimalus on kasutatav ainult pideva töörežiimi korral (töörežiime kirjeldab osa &kalarm;i seadistamine).

Välju

- Sulgeb &kalarm;i süsteemse salve ikooni.

  Ainult pidevas töörežiimis sulgeb see käsk ka kõik &kalarm;i peaaknad. See ei mõjuta kuidagi häiredeemoni häirete jälgimist (kui just seadistuste dialoogis ei ole märgitud Kui süsteemses salves ikooni pole, siis keelatakse häired).

#### &kalarm;i näitamine süsteemses salves

&kalarm;i näitamiseks süsteemses salves peab töötama &kde; või mõni muu sobiv töölaud. Kui &kalarm; töötab pidevas režiimis, on süsteemse salve ikoon alati nähtaval. Siintoodud juhised kehtivad ainult nõudmisel režiimi korral (täpsemat infot töörežiimide kohta leiab osast &kalarm;i seadistamine).

&kalarm;i nägemiseks süsteemses salves vali menüükäsk Vaade Näita ikooni süsteemses salves.

&kalarm;i näitamise lõpetamiseks süsteemses salves:

- vali menüükäsk Vaade Peida ikoon süsteemses salves.

- klõpsa hiire parema nupuga süsteemse salve ikoonil ja vali ilmuvast menüüst Välju.

### Häirete uuendamine

Väga ebatõenäolisel juhtumil, kui mõni häire ei käivitu ajal, mil ta pidanuks käivituma, saab häirete nimekirja uuendada ja kõik vahelejäänud häired käivituma panna menüükäsuga Toimingud Uuenda häireid.

&kalarm; käivitab vahelejäänud häired uuesti, lähtestades häiredeemoni, millest on lähemalt juttu osas Häiredeemon.

### Häirete lubamine ja keelamine

Häireid saab lubada ja keelata nii korraga kui ükshaaval:

- Häirete jälgimine käib kõigi häirete kohta. Kui see on keelatud, ei kontrolli häiredeemon enam häireid ning seepärast neid ka enam ei käivitata. Kui häirete jälgimine on lubatud (vaikimisi ongi), käivitatakse ettenähtud ajal kõik häired, mida ei ole konkreetselt keelatud.

- Sõltumata häirete jälgimise olekust saab häireid ka ükshaaval lubada või keelata. See tähendab, et konkreetsete häirete lubamise või keelamise olek ei muutu, kui häirete jälgimine keelata ning hiljem uuesti lubada. Kui häirete jälgimise võib lõpetada ka näiteks see, et &kalarm; või häiredeemon ei tööta, siis konkreetseid häireid saab keelata ainult menüükäskudega.

  Iga häire olekut näitab selle värv häirete nimekirjas (värv saab muuta seadistustedialoogi kaardil Font ja värv).

Häire käivitamiseks peab see olema lubatud, samuti peab olema lubatud häirete jälgimine.

#### Häire jälgimise lubamine

Kui &kalarm; töötab pidevas režiimis ning seadistuste dialoogis on märgitud Kui süsteemses salves ikooni pole, siis keelatakse häired, pead kontrollima, et &kalarm; ikka töötaks, sest muidu ei ole ka häirete jälgimine võimalik.

Kui häire jälgimine on parajasti keelatud, siis saab häired lubada järgmiselt:

- vali menüükäsk Toimingud Häired lubatud.

- klõpsa hiire parema nupuga ikoonil süsteemses salves ja vali menüüst Häired lubatud.

Seejärel käivitatakse vajadusel häiredeemon ning häireid asutakse nende tähtaja saabumisel jälgima.

#### Häire jälgimise keelamine

Häire jälgimist saab mitmel moel keelata ja nii takistada &kalarm;il näitamast häireid seni, kuni need on taas lubatud või kuni – eeldusel, et häiredeemon on seadistatud käivituma sisselogimisel – sa uuesti sisse logid.

Häirete keelamiseks häiredeemonit peatamata:

- vali menüükäsk Toimingud Keela häired.

- klõpsa hiire parema nupuga ikoonil süsteemses salves ja vali menüüst Keela häired.

- kui &kalarm; töötab pidevas režiimis ja seadistuste dialoogis on märgitud Kui süsteemses salves ikooni pole, siis keelatakse häired, lihtsalt lõpeta &kalarm;i töö.

Häirete keelamiseks häiredeemonit peatades:

- vali menüükäsk Seadistused Häiredeemoni juhtimine.... See avab teenuste halduri, kus on võimalik häiredeemon peatada.

#### Konkreetsete häirete lubamine ja keelamine

Konkreetsete häirete lubamiseks, mis on parajasti keelatud, talita järgmiselt:

- vali häire/häired klõpsuga selle/nende nimel nimekirjas. Seejärel vali menüükäsk Toimingud Luba .

- klõpsa hiire parema nupuga häire nimel nimekirjas ja vali ilmuvast menüüst Luba.

Konkreetsete häirete keelamiseks, mis on parajasti lubatud, talita järgmiselt:

- vali häire/häired klõpsuga selle/nende nimel nimekirjas. Seejärel vali menüükäsk Toimingud Keela .

- klõpsa hiire parema nupuga häire nimel nimekirjas ja vali ilmuvast menüüst Keela.

### Rakenduse töö lõpetamine

&kalarm;i töö saab lõpetada kõiki selle aknaid ja süsteemse salve ikooni sulgedes või kui rakendus töötab pidevas režiimis, siis kõiki teateaknaid sulgedes ja valides süsteemse salve ikooni kontekstimenüüst Välju.

Menüükäsk Fail Välju sulgeb ainult konkreetse akna. Süsteemse salve ikooni kontekstimenüü käsu Välju toime sõltub töörežiimist: nõudmisel režiimi korral peidetakse süsteemse salve ikoon, pideva režiimi korral lõpetatakse rakenduse töö.

&kalarm;i töö lõpetamine ei mõjuta häiredeemonit, mis juhul, kui see juba töötab, jätkab ajastatud häirete jälgimist ja sunnib need määratud ajal ilmuma (kui seadistustedialoogis ei ole just märgitud Kui süsteemses salves ikooni pole, siis keelatakse häired).

## &kalarm;i seadistamine

&kalarm;i tegevuse seadistamiseks nii, et see rahuldaks nii süsteemi kui sind ennast, vali menüükäsk Seadistused &kalarm;i seadistamine.... See avab, nagu nimigi ütleb, seadistustedialoogi.

### Üldine

Kaardil Üldine saab määrata &kalarm;i üldist käitumist:

- Sektsioon Töörežiim: siinsed valikud puudutavad &kalarm;i süsteemse salve ikooni ning võimaldavad teatud määral juhtida ka &kalarm;i süsteemi ressursside kasutamist vastavalt sellele, kas see töötab pidevalt või mitte. Kui süsteemi jõudlus on sulle oluline, võib olla eelistatav rakenduse töö ainult nõudmisel ja ilma ikooni süsteemses salves näitamata. Pidev töö kasutab rohkem süsteemi ressursse, kuid see-eest on ka pidevalt näha häireikoon ning kogu rakendus on paremini ligipääsetav. &kalarm;i töö nõudmisel ei mõjuta häirete käivitamist, sest nende nimekirja jälgib ja nende käivitamisega tegeleb häiredeemon, mitte &kalarm;.

  - Käivitatakse vaid nõudmisel: &kalarm; käivitatakse ainult siis, kui häire käivitatakse, kui käivitad selle käsitsi või kui näidatakse selle ikooni süsteemses salves. Selles režiimis näidatakse küll süsteemse salve ikooni, kuid selle sulgemine ei mõjuta kuidagi ühtegi &kalarm;i akent.

  - Töötatakse pidevalt süsteemses salves: &kalarm; töötab pidevas režiimis ning töötamise ajal näidatakse alati ikooni süsteemses salves. Selles režiimis suleb süsteemse salve ikooni sulgemine kõik &kalarm;i peaaknad ja kui ühtki teadeteakent ei ole nähtaval, lõpetab ka rakenduse töö. Selle režiimi korral saab kasutada järgmisi lisavõimalusi:

    - Kui süsteemses salves ikooni pole, siis keelatakse häired: selle valimine tähendab, et häireid ei käivitata, kui süsteemses salves pole &kalarm;i ikooni.

      - Hoiatus enne väljumist: kui häired &kalarm;i mittetöötamise ajal välja lülitada, siis selle võimaluse valimisel küsitakse sinu käest alati kinnitust, kui proovid lõpetada kalarm;i töö süsteemse salve ikooni kontekstimenüü käsuga Välju. See väldib häirete juhuslikku väljalülitamist. Turvalisuse kaalutlustel lülitatakse see võimalus alati vaikimisi sisse, kui vahetad töörežiimi.

  - Käivitatakse sisselogimise ajal automaatselt: kalarm; käivitatakse kohe &kde; seansi sisselogimise ajal, mis tagab, et &kalarm; töötab sisuliselt kogu aeg, kui sa just käsitsi selle tööd ei lõpeta.

  - Sisselogimisel laetakse süsteemse salve ikoon automaatselt: selle korral näidatakse &kalarm;i ikooni süsteemses salves kohe sisselogimisel. &kalarm; töötab, kuni süsteemse salve ikoon suletakse.

  - Alarmide monitooringu käivitamine sisselogimisel: käivitab häirete jälgimise KDE-sse sisselogimisel, pannes tööle häiredeemoni. Pane tähele, et häirete aktiveerimiseks tuleb langetada vajalikud valikud ka sektsioonis Töörežiim.

    See valik peaks olema alati märgitud, kui sa just ei kavatse &kalarm;i kasutamisest loobuda.

    See valik lülitatakse alati automaatselt sisse, kui käivitad &kalarm;i. See tähendab, et kui oled selle valiku välja lülitanud ning soovid ka edaspidi vältida häiredeemoni töölepanekut sisselogimise ajal, tuleb see valik välja lülitada iga kord, kui käivitad &kalarm;i.

- Ainult kuupäevaga määratud häirete alguskellaaeg:: määrab alguskellaaja ainult kuupäevaga määratud häiretele, &ie; häiretele, mille puhul on valitud võimalus Suvaline aeg. Määratud kuupäeval käivituvad sellised häired alates alguskellaajast 24 tunni jooksul esimesel võimalusel.

- Kui oled seadnud aastase kordumise 29. veebruarile, saab määrata, kuidas käsitletakse selliseid häireid juhul, kui tegemist ei ole liigaastaga:

  - 28. veebruaril: häire käivitatakse liigaastal 29. ning muudel aastatel 28. veebruaril.

  - 1. märtsil: häire käivitatakse liigaastal 29. veebruaril ning muudel aastatel 1. märtsil.

  - Ei korrata: häire käivitatakse liigaastal 29. veebruaril, muudel aastatel seda ei käivitatagi.

  Selle võimaluse muutmine ei põhjusta ühegi olemasoleva häire järgmise ajastatud kordumise ümberarvutamist. See mõjutab ainult uusi häireid või olemasolevaid häireid pärast nende järgmist käivitamist.

- Häire kustutamisel küsitakse kinnitust: määrab, kas iga kord, kui sulged häireteate, küsitakse sinu käest selle kinnitust.

- Sektsioon Aegunud häired: siinsed valikud puudutavad varasemate häirete salvestamist.

  - Häired jäetakse aegudes alles: selle valimisel aegunud häired salvestatakse, mittevalimisel häired pärast nende tähtaja läbisaamist kustutatakse. Pane tähele, et kustutatud häired salvestatakse ainult siis, kui neid on eelnevalt käivitatud. Kui kustutad häire enne selle käivitamist, kustutatakse see täielikult.

  - Aegunud häired visatakse minema pärast: määrab päevade arvu, mille järel häired pärast nende viimast aktiveerimist kustutatakse.

  - Kustuta aegunud häired: see nupp kustutab kõik parajasti salvestatud aegunud häired. Sel ei ole mingit mõju häiretele, mis aeguvad alles hiljem: need salvestatakse vastavalt muudele valikutele.

- Käsualarmide terminal: siin saab valida, millist terminali kasutatakse käsuhäirete jaoks, mis käivitatakse terminaliaknas. Mõned levinumad terminalirakendused on juba eelnevalt seadistatud, ⪚ xterm, &konsole;, ehkki siin näidatakse ainult neid, mis on sinu süsteemi paigaldatud. Iga rakenduse korral kasutatavaid tegelikke käske näeb vastavate kirjete kontekstiabis.

  Kui soovid kasutada mõnda muud rakendust või mõnda nimekirjas olevat teistsuguste võtmetega, vali Muu ning sisesta käsk, millega terminaliaken välja kutsutakse. Vaikimisi lisatakse häire käsustring sellele, mida sa siia sisestad. Sa võid küll ka ise määrata, kuhu häire käsustring lisatakse, kasutades järgmisi koode:

  %c

- Häire käsustringi kohatäitja.

%w

- Häire käsustringi kohatäitja, millele lisatakse `sleep`.

%C

- Luuakse ajutine käsufail, mis sisaldab häire käsustringi, ning see asendab faili käivitamise käsku.

%W

- Luuakse ajutine käsufail, mis sisaldab häire käsustringi ja mille lisatakse `sleep`, ning see asendab faili käivitamise käsku.

Käsuhäire käivitamisel seatakse käsustring jutumärkidesse, enne kui lisatakse terminaliakna käsku.

### E-post

Sektsioonis E-post saab määrata kirja teel saadetavate häirete saatmise valikuid ja aadresside võimalusi:

- E-posti rakendus: määrab, millist e-posti klienti kasutada häire saatmiseks kirja teel:

  - KMail: kirja teel saadetava häire käivitamisel lähetatakse kiri &kmail;i vahendusel (mis vajaduse korral esmalt käivitatakse) järgmiselt:

    - kui &kmail; on versiooniga 1.7 või uuem, saadetakse kiri automaatselt.

    - kui &kmail; on vanema versiooniga, lisatakse kiri &kmail;i kausta `väljuvad`, kust selle saab hiljem ära saata.

  - Sendmail: kirja teel saadetava häire käivitamisel läkitatakse kiri automaatselt teele rakenduse sendmail vahendusel. See võimalus toimib ainult siis, kui süsteem on seadistatud kasutama sendmaili või sendmailiga ühilduvat rakendust, näiteks postfix või qmail.

- Koopia saadetud kirjadest jääb &kmail;i kausta 'saadetud': selle valimisel salvestatakse iga kord, kui käivitatakse e-posti häire, saadetud kirja koopia &kmail;i kausta `saadetud`.

  Seda valikut ei saa kasutada, kui e-posti kliendiks on valitud &kmail;, sest &kmail; teeb seda niigi automaatselt.

- Vali oma e-posti aadress, mida kasutatakse e-posti häirete saatmisel saatja aadressina:

  - Vali Kellelt e-posti aadressi sisestamiseks.

  - Vali Kasutatakse juhtimiskeskuses määratud aadressi, et tarvitada aadressi, mis on määratud kindlaks &kde; juhtimiskeskuses.

  - Vali Kasutatakse &kmail;i identiteete, mis võimaldab e-posti häire seadistamise ajal valida kasutatava &kmail;i identiteedi. Juba seadistatud häirete jaoks kasutatakse selle valiku valimisel &kmail;i vaikeidentiteeti.

- Vali e-posti aadress, millega saata endale e-posti häiretest pimekoopia, kui valitud on Kiri saadetakse ka iseendale:

  - Vali Bcc e-posti aadressi sisestamiseks. Kui pimekoopia saadetakse sinu kontole samas arvutis, kus töötab &kalarm;, võid siia sisestada ka lihtsalt oma kasutajanime.

  - Vali Kasutatakse juhtimiskeskuses määratud aadressi, et tarvitada aadressi, mis on määratud kindlaks &kde; juhtimiskeskuses.

- Märguanne kirja järjekorda panekul: selle valimisel näidatakse märguannet, kui e-posti rakendus paneb kirja teel saadetava häire järjekorda, mitte ei saada seda kohe minema. See on kasulik näiteks juhul, kui kasutad sissehelistamist või kui kiri pannakse ootele &kmail;i kausta `väljuvad`, millisel juhul võid ette võtta vajalikud sammud, et kirjad ka tegelikult teele läkitataks.

### Vaade

Sektsioonis Vaade saab määrata mõningaid &kalarm;i välimusse puutuvaid valikuid:

- Sektsioonis Süsteemse salve kohtspikker saab määrata, millist infot näidatakse kohtspikril, mis ilmub, kui hoida hiirekursorit mõne hetke &kalarm;i süsteemse salve ikooni kohal.

  - Järgmise 24 tunni häirete näitamine: selle valimisel näidatakse järgmise 24 tunni või vähemalt mõne esimese sellesse vahemikku jääva häire kokkuvõtet.

  - Maks. näidatavate häirete arv: selle valimata jätmisel näidatakse kõiki järgmise 24 tunni häireid, valimisel saab määrata, mitut häiret maksimaalselt näidatakse.

  - Häireaja näitamine: selle valimisel näidatakse aega, millal iga häire peab käivituma.

  - Häireni jäänud aja näitamine: selle valimisel näidatakse, kui palju aega on jäänud iga häire järgmise käivitamiseni. Aega näidatakse tundides ja minutites.

    - Prefiks: määrab sümboli või teksti, mida näidatakse häireni jäänud aja korral, et oleks võimalik seda eristada häire enda ajast.

- Teateaken tiitliribaga ja klahvide kasutamisvõimalusega: määrab, kas häireteadete aknad on modaalsed või mitte; &ie; kas nad haaravad ilmudes endale ka klaviatuuri fookuse. Täpsemalt vaata osa Häireteate aken

- Süsteemse salve ikooni värskendamise intervall: määrab &kalarm;i süsteemse salve ikooni uuendamise sageduse, et see näitaks, milliseid häireid parajasti jälgitakse. Sellega kaasneb kontroll, kas häiredeemon ikka töötab.

### Font ja värv

Sektsioonis Font ja värv saab määrata häireteadete vaikevälimuse ja häireloendis kasutatavad värvid:

- Valida häireteadete vaikimisi fondi ja taustavärvi.

- Muuta värvivaliku nimekirja, mida näidatakse klõpsuga taustavärvi liitkastile:

  - Lisa värv...: avab värvi valimise dialoogi, kus saab valida nimekirjale lisatava värvi.

  - Eemalda värv: eemaldab parajasti liitkastis Tausta värv näidatava värvi nimekirjast. Nimekirjast ei saa eemaldada kohandatud värvi ning selle näitamisel ei ole ka selle nupu kasutamine võimalik.

- Valida keelatud häirete värvi nende näitamisel häirete nimekirjas.

- Valida aegunud häirete värvi nende näitamisel häirete nimekirjas.

### Redigeerimine

Sektsioonis Redigeerimine saab määrata häire redigeerimise dialoogi vaikeväärtusi:

Näidatavate häirete korral:

- Valida vaikeväärtused võimalustele Tähtaja möödumisel häire katkestatakse, Akna automaatne sulgemine pärast seda aega ja Häire nägemise kinnituse küsimine.

- Valida meeldetuletuste perioodi vaikeühik.

- Valida spetsiaalse häire näitamise vaiketoimingu.

- Määrata vaikimisi helivalikud. Pane tähele, et vaikehelifaili saab määrata isegi siis, kui heli tüübiks ei ole valitud helifail.

Käsuhäirete korral:

- Valida vaikeväärtused võimalustele Skripti sisestamine ja Käivitatakse terminaliaknas.

E-posti häirete korral:

- Valida vaikeväärtuse võimalusele Kiri saadetakse ka iseendale.

Kõigi häiretüüpide korral:

- Valida häirete kordumise vaiketüüp.

## Käsurea kasutamine

Kui käivitamisel määratakse mingid käsurea argumendid, siis ei näita &kalarm; ajastatud häirete nimekirja, mida kirjeldati eespool &kalarm;i kasutamisest kõneldes. &kalarm;i spetsiifilisi käsurea võtmeid saab kasutada järgmiste toimingute teostamiseks:

- uue häire ajastamine

- häiredeemoni juhtimine

- &kalarm;i esitusviisi juhtimine

- abi hankimine

Muid käsurea võtmeid saab kasutada ennekõike muude rakenduste &kalarm;iga suhtlemise võimaldamiseks. Neid kirjeldatakse peatükis &kalarm;ist arendajatele.

Käsureale tohib korraga kaasata võtmeid ainult ühe &kalarm;i toimingu tarbeks. Kui soovid läbi viia mitu toimingut, tuleb &kalarm; välja kutsuda mitu korda, andes iga kord konkreetse toimingu võtmed.

### Uue häire ajastamine

Uue häire ajastamiseks saab kasutada järgmisi võtmeid:

Võti | Kirjeldus
`-a`, `--ack-confirm` | Kinnituse küsimine häire nägemisel ja sulgemisel.
`-A`, `--attach `URL`` | Määrab kirjale kaasatava faili nime või &URL;-i. Seda võtit võib vajadusel korrata. Selle võtme kasutamisel peab olema määratud ka võti `--mail`.
`--auto-close` | Sulgeb automaatselt häireakna pärast aja möödumist, mille määrab `--late-cancel`. Selle võtme kasutamisel peab olema määratud ka võti `--late-cancel`.
`-b`, `--beep` | Kuuldava piiksu esitamine teate näitamisel. Selle võtme korral ei tohi kasutada võtit `--speak`, `--play` ega `--play-repeat`.
`--bcc` | Pimekoopia kirjast iseendale. Selle võtme kasutamisel peab olema määratud ka võti `--mail`.
`-c`, `--color`, `--colour `värv`` | Määrab teate taustavärvi vastava &Qt; värvi nime või 16-koodis 0xRRGGBB kohaselt.
`-C`, `--colorfg`, `--colourfg `värv`` | Määrab teate esiplaani vastava &Qt; värvi nime või 16-koodis 0xRRGGBB kohaselt.
`-d`, `--disable` | Keelab häire. Seda ei käivitata enne, kui oled selle käsitsi lubanud.
`-e`, `--exec `käsurea käsk`` | Määrab käivitatava shellikäsu. Selle kasutamise korral peab see &kalarm;i võti olema &kalarm;i käsurea viimane võti. Kõiki eelnevaid võtmeid tõlgendatakse käivitatava käsu osana. Selle korral ei saa kasutada võtmeid `--file` ega `--mail`. Võtmeid `--ack-confirm`, `--beep`, `--color` ja `--colorfg` aga lihtsalt ignoreeritakse.
`-f`, `--file `URL`` | Määrab teksti- või pildifaili nime või &URL;-i, mille sisu kujutab endast häireteate sisu. Selle puhul ei saa määrata võtmeid `--exec` ja `--mail` ning esineda ei tohi argument `teade`.
`-F`, `--from-id `ID`` | Kirja saatjaks määratakse konkreetne &kmail;i identiteet. Selle kasutamisel peab kasutama ka võtit `--mail`.
`-i`, `--interval `periood`` | Määrab intervalli häire kordamiste vahel. Tunnid ja minutid määratakse vormingus `nHnM`, kus `n` on arv, ⪚ 3H30M. Muud perioodid määratakse vormingus `nX`, kus `n` on arv ja `X` üks järgmistest tähtedest: Y (aastad), M (kuud), W (nädalad), D (päevad). Kui määratud on ka võti `--recurrence`, ei saa kasutada Y (aastad) ja M (kuud). See võti on kohustuslik, kui kasutatakse võtmeid `--repeat` või `--until`.
`-k`, `--korganizer` | Näitab häiret sündmusena &korganizer;i aktiivses kalendris.
`-l`, `--late-cancel `periood`` | Katkestab häire, kui seda ei saa pärast ettenähtud aega käivitada määratud `periood`i jooksul. See `periood` määratakse samasuguse süntaksiga, nagu võti `--reminder`. Vaikimisi on `periood` 1 minut.
`-L`, `--login` | Käivitab häire igal sisselogimisel. Selle võtme kasutamisel ei saa kasutada võtmeid `--interval`, `--repeat` ja `--until`.
`-m`, `--mail `aadress`` | Määrab kirja saatmise antud aadressile. Seda võtit võib vajadusel korrata. Sellega koos ei saa kasutada võtmeid `--exec` ja `--file`. Võtmeid `--ack-confirm`, `--beep`, `--color` ja `--colorfg` aga lihtsalt ignoreeritakse.
`-p`, `--play `URL`` | Määrab häire näitamisel mängitava helifaili nime või &URL;-i. Selle võtme kasutamisel ei saa kasutada võtit `--play-repeat`, `--beep` ega `--speak`.
`-P`, `--play-repeat `URL`` | Määrab häire näitamisel korduvalt mängitava helifaili nime või &URL;-i. Selle võtme kasutamisel ei saa kasutada võtit `--play`, `--beep` ega `--speak`.
`--recurrence `määratlus`` | Määrab häire korduma. Kordumise määratlus peab kasutama iCalendari süntaksit (selle defineerib RFC2445), ⪚ FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. Sellega koos ei saa kasutada võtit `--until`.
`-r`, `--repeat `kordade_arv`` | Määrab, mitu korda häiret käivitatakse või kui võtmega `--recurrence` on määratud kordumine, siis mitu korda häire käivitatakse alati, kui `--recurrence` selle aktiveerib (&ie; kordus korduse sees). Kui võtit `--recurrence` pole antud, määrab väärtus -1 häire lõputult korduma. Selle võtmega peab kasutama võtit `--interval`, kuid ei saa kasutada võtit `--until`.
`-R`, `--reminder `periood`` | Määrab meeldetuletuse näitamise määratud ajal enne häiret ja selle kordusi (kui neid on). Tunnid ja minutid määratakse vormingus `nHnM`, kus `n` on number, ⪚ 3H30M. Muud perioodid määratakse vormingus `nX`, kus `n` on number ja `X` üks järgmistest tähtedest: Y (aastad), M (kuud), W (nädalad), D (päevad). Seda võtit ei saa kasutada koos võtmetega `--exec`, `--mail` või `--reminder-once`.
`--reminder-once `periood`` | Määrab meeldetuletuse näitamise määratud ajal enne häire esimest kordumist. Häire järgmiste kordumiste ajal (kui neid on) meeldetuletust enam ei näidata. Seda võtit ei saa kasutada koos võtmetega `--exec`, `--mail` või `--reminder`.
`-s`, `--speak` | Kõneleb näidatava teate. Selleks peab olema paigaldatud ja seadistatud KTTSD ning sobiv kõnesüntesaator. Seda võtit ei saa kasutada koos võtmetega `--beep`, `--play` ja `--play-repeat`.
`-S`, `--subject `subjekt`` | Määrab kirja subjektirea ehk teema. Selle kasutamisel peab kasutama ka võtit `--mail`.
`-t`, `--time `kuupäev/aeg`` | Käivitab häire määratud kuupäeval või kuupäeval/ajal. Kuupäev ilma ajata määratakse vormingus `yyyy-mm-dd`, kuupäev ajaga vormingus `[[[yyyy-]mm-]dd-]hh:mm` (kui see ära jäetakse, määratakse kuupäevaks vaikimisi käesolev kuupäev).
`-v`, `--volume `protsent`` | Määrab audiofaili esitamise helitugevuse. Seda võtit saab kasutada ainult koos võtmega `--play` või `--play-repeat`.
`-u`, `--until `kuupäev/aeg`` | Kordab häiret kuni määratud kuupäeva või kuupäeva/kellaajani. Kuupäev ilma kellaajata määratakse samas vormingus nagu argumendi `--time` puhul. Selle võtme kasutamine nõuab võtit `--interval` ja välistab võtmed `--repeat` ning `--recurrence`.
`teade` | Näidatava teate tekst või koos võtmega `--mail` kirja sisu.

Määratud peab olema kas teate tekst, `--file` või `--exec`; kui ülal ei ole teisiti märgitud, on ülejäänud võtmed kõigest võimalikud, mitte kohustuslikud.

Kaks alternatiivi, mis näitavad mitmerealist teadet punasel taustal käesoleva kuu 27. päeval kell 22.00:

    % kalarm -c red -t 27-22:00 "Jäta nüüd töö\nKOHE POOLELI"
    % kalarm -c 0xFF0000 -t 27-22:00 "Jäta nüüd töö\nKOHE POOLELI"

### Muud võtmed

Järgmisi võtmeid saab kasutada häiredeemoni peatamiseks või lähtestamiseks, häire redigeerimisdialoogi avamiseks ning &kalarm;i esitusviisi juhtimiseks.

Vaata osa Häiredeemon, kus räägitakse lähemalt häiredeemoni lähtestamisest ja peatamisest.

Võti | Kirjeldus
`--edit `sündmuseID`` | Avab häire redigeerimisdialoogi määratud sündmuse ID-ga häire redigeerimiseks.
`-n`, `--edit-new` | Avab häire redigeerimise dialoogi uue häire redigeerimiseks.
`--edit-new-preset `mallinimi`` | Avab häire redigeerimise dialoogi määratud nimega häiremalliga uue häire redigeerimiseks.
`--reset` | Lähtestab häiredeemoni.
`--stop` | Peatab häiredeemoni.
`--tray` | Näitab &kalarm;i ikoonina süsteemses salves.

Näide häiredeemoni lähtestamise kohta:

    % kalarm --reset

### Abivõtmed

Järgmised abivõtmed on kasutatavad kõigi &kde; rakenduste puhul:

Võti | Kirjeldus
`--help` | Näitab lühidalt võtmete abiteksti.
`--help-qt` | Näitab &Qt; spetsiifilisi võtmeid.
`--help-kde` | Näitab &kde; spetsiifilisi võtmeid.
`--help-all` | Näitab kõiki võtmeid.
`--author` | Näitab &kalarm;i autorite nimesid ja e-posti aadresse.
`-v`, `--version` | Näitab &Qt; teegi, &kde; ja &kalarm;i töötavat versiooni.
`--license` | Näitab infot litsentsi kohta.

## Häiredeemon

Häiredeemon &kalarmd; jälgib &kalarm;i kalendrifaili ja tuvastab eesseisvaid häireid. Kui häire tähtaeg kätte jõuab, annab ta &kalarm;ile korralduse seda näidata või käivitada või katkestada, kui tähtaeg on möödas ja antud alarmi puhul ei ole valitud võimalust käivitada teda ka hiljem esimesel võimalusel.

Häiredemon töötab taustal, sel puudub kasutajaliides. Seda saab juhtida järgmiselt.

### Häiredeemoni käivitamine, lähtestamine ja peatamine

Häiredeemon käivitatakse tavaliselt &kde; seansi sisselogimisel (kui just seadistustedialoogis ei ole automaatne käivitamine ära keelatud ja sa ei kasuta &kalarm;i) ning see töötab kuni väljalogimiseni. Kui deemon mingil põhjusel ei tööta, ei jälgi ka miski häireid ning &kalarm; ei näita ega käivita häireid.

#### Häiredeemoni käivitamine

Häiredeemoni käivitamiseks võib kas käivitada &kalarm;i selle vaikimisi graafilises režiimis (&ie; ilma käsurea võtmeteta või ainult võtmega `--tray`), lubada häired &kalarm;i süsteemse salve ikooni menüüst, lähtestada deemoni (seda kirjeldatakse edaspidi) või käivitada häiredeemoni otse käsurealt käsuga:

    % kalarmd

#### Häiredeemoni lähtestamine

Häiredeemon on võimalik ka lähtestada ilma seda peatamata. Lähtestamine sunnib häiredeemoni uuesti lugema ajastatud teadete nimekirja kalendrifailist ja taasinitsialiseerima oma &kalarm;iga seotud andmed.

Aga miks peaks üldse olema vaja häiredeemon lähtestada? See ei ole küll väga tõenäoline, aga kui &kalarm; ei suuda mingil põhjusel tööle hakata, kui häiredeemon annab talle korralduse häire käivitada, siis seda häiret ei näidatagi ega käivitata, kuni häiredeemon pole lähtestatud või uuesti käivitatud.

Lähtestamine käivitab häiredeemoni arusaamaga, nagu poleks ta varem töötanud.

Häiredeemoni lähtestamiseks kasuta menüükäsku Toimingud Uuenda häireid või anna järgmine käsk:

    % kalarm --reset

#### Häiredeemoni peatamine

Häiredeemoni peatamine katkestab ajastatud häireteadete jälgimise, kuni deemon ei ole uuesti käivitatud.

Häiredeemoni peatamiseks anna järgmine käsk:

    % kalarm --stop

## &kalarm;ist arendajatele

&kalarm; pakub välja liidese, mis võimaldab muudel rakendustel esitada soovi järgmiste funktsioonide kasutamiseks:

- uue häire ajastamine

- käivitada või katkestada juba ajastatud häire

- katkestada juba ajastatud häire

- käivitada juba ajastatud häire

- avada häire redigeerimise dialoog

Kõiki mainitud funktsioone saab teostada nii &DCOP;-väljakutse kui käsurea vahendusel. &DCOP;-väljakutsed on eelistatud, kui &kalarm; juba töötab.

### &DCOP;-liides

Käsiraamatus kirjeldatud DCOP-väljakutsed on teostatud &kalarm;i DCOP-objektis `request`. Liides on defineeritud failis `kalarmiface.h`.

&kalarm;i versioonis 1.2 töötati DCOP-liides põhjalikult ümber, et võimaldada funktsioonide hõlpsamat väljakutsumist ning ühilduda paremini &kde; standardse DCOP-i seadistusega. Ühilduvuse nimel saab endiselt kasutada ka vana DCOP-liidest, kuid tulevikus see eemaldatakse.

cancelEvent

cancelEvent

katkestab juba ajastatud häire.

    void cancelEvent(const QString& calendarFile,
                     const QString& eventID)

##### Parameetrid

`calendarFile`

- Määrab katkestatavat sündmust sisaldava kalendrifaili &URL;-i.

`eventID`

- Määrab katkestatava sündmuse unikaalse ID, nagu see on salvestatud `calendarFile`'is.

##### Kirjeldus

`cancelEvent()` on &DCOP;-väljakutse määratud häire katkestamiseks. &kalarm; kustutab häire kalendrifailist ilma seda näitamata või käivitamata.

Parameetrit `calendarFile` kasutatakse vaid ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoneeritakse.

triggerEvent

triggerEvent

käivitab juba ajastatud häire.

    void triggerEvent(const QString& calendarFile,
                      const QString& eventID)

##### Parameetrid

`calendarFile`

- Määrab käivitatavat sündmust sisaldava kalendrifaili &URL;-i.

`eventID`

- Määrab käivitatava sündmuse unikaalse ID, nagu see on salvestatud `calendarFile`'is.

##### Kirjeldus

`triggerEvent()` on &DCOP;-väljakutse määratud häire koheseks näitamiseks või käivitamiseks (sõltumata ajast, mis selle käivitamiseks on määratud). &kalarm; hangib häire kalendrifailist ja seejärel näitab seda või käivitab selle.

Kui häire tähtaeg on nagunii kätte jõudnud, kustutab &kalarm; seejärel kõik häire senised kordused ja kui kordusi ei ole rohkem järele jäänud, siis ka häire kalendrifailist. Kui häire tähtaeg ei ole veel saabunud, jäävad kõik ajastatud korrad muutmata.

Parameetrit `calendarFile` kasutatakse vaid ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoneeritakse.

handleEvent

handleEvent

käivitab või katkestab juba ajastatud häire.

    void handleEvent(const QString& calendarFile,
                     const QString& eventID)

##### Parameetrid

`calendarFile`

- Määrab näidatavat/käivitatavat või katkestatavat sündmust sisaldava kalendrifaili &URL;-i.

`eventID`

- Määrab näidatava/käivitatava või katkestatava sündmuse unikaalse ID, nagu see on salvestatud `calendarFile`'is.

##### Kirjeldus

`handleEvent()` on &DCOP;-väljakutse määratud häire näitamiseks/käivitamiseks või katkestamiseks. &kalarm; hangib häire kalendrifailist ning määrab seejärel, mida ette võtta vastavalt sellele, millal on häire tähtaeg.

- Kui häire täheaeg ei ole veel käes, ei juhtu midagi.

- Kui häire tähtaeg on käes, tegutsetakse järgmiselt: kui on määratud katkestamise väärtus ja see on möödas, &ie; kui ajastatud käivitusaeg oli enam kui määratud katkestamise perioodi eest, ei näita ega käivita &kalarm; häiret. Vastasel juhul &kalarm; näitab või käivitab häire. Kui häirel on veel määratud kordusi, kustutab &kalarm; seejäre häire kalendrifailist.

Parameetrit `calendarFile` kasutatakse vaid ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoneeritakse.

scheduleMessage

scheduleMessage

uue häire ajastamine.

    bool scheduleMessage(const QString& message,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const KURL& audioURL,
                         int reminder,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleMessage(const QString& message,
                         const QString& dateTime,
                         int lateCancel, int flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const KURL& audioURL,
                         int reminder,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleMessage(const QString& message,
                         const QString& dateTime,
                         int lateCancel,
                         int flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const KURL& audioURL,
                         int reminder,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parameetrid

`message`

- Määrab ajastatava teate teksti.

`dateTime`

- Määrab kuupäeva või kuupäeva ja kellaaja, millal teadet näidatakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul YYYY-MM-DD (nagu tagastab `QDate::toString(Qt::ISODate)`). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul YYYY-MM-DDTHH:MM[:SS] (nagu tagastab `QDateTime::toString(Qt::ISODate)`) või HH:MM[:SS] (nagu tagastab `QTime::toString(Qt::ISODate)`). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.

`lateCancel`

- Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.

`flags`

- Määrab soovitud häirelippude loogilise funktsiooni OR. Lipubitid on määratud failis `kalarmiface.h` klassiga `KAlarmIface`. Arvesta, et mitte kõiki lipubitte ei saa teatehäire korral kasutada.

`bgColor`

- Määrab näidatava teate taustavärvi. String võib olla kujul #RRGGBB (nagu tagastab `QColor::name()`), kus RR, GG ja BB on vastavalt punase, rohelise ja sinise kahekohalised kuueteistkümnendväärtused. String võib olla mõnel muul kujul, mida tunnustab `QColor::setNamedColor()`, näiteks X'i värvide andmebaasi nimi (⪚ red või steelblue). Kui string tühjaks jätta, kasutatakse parajasti vaikimisi kehtivat taustavärvi.

`fgColor`

- Määrab näidatava teate esiplaani värvi. Stringi kuju on samasugune parameetriga `bgColor`. Kui string tühjaks jätta, kasutatakse parajasti vaikimisi kehtivat esiplaani värvi.

`font`

- Määrab teate näitamisel kasutatava fondi. String peab olema kujul, nagu seda tunnustab `QFont::toString()`. Kui string tühjaks jätta, kasutatakse teate näitamisel ajal kehtivat vaikimisi teatefonti.

`audioURL`

- Määrab teate näitamisel mängitava helifaili. Väärtuse 0 andmisel helifaili ei esitata.

`reminder`

- Määrab minutites aja enne häire ja selle korduste (kui neid on) käivitamist, millal näidatakse meeldetuletust. Kui meeldetuletust vaja ei ole, määra 0.

`recurrence`

- Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC2445. Näiteks FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.

`recurType`

- Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis `kalarmiface.h` klassiga `KAlarmIface`. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist `dateTime`.

`recurInterval`

- Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab `recurType`).

`recurCount`

- Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.

`endDateTime`

- Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui `dateTime` sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui `dateTime` sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.

`subRepeatInterval`

- Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.

`subRepeatCount`

- Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).

##### Kirjeldus

`scheduleMessage()` on &DCOP;-väljakutse määratud häireteate ajastamiseks määratud kuupäevale ja ajale. Sel on kolm vormi. Kõige üldisem vorm lubab määrata suvalise kordumise ning seda saab kasutada ka mittekorduvate häirete korral. Teised vormid võimaldavad mugavalt määrata piiratuma häire kordumise tüübi, üks neist kindla korduste arvuga korduva häire ja teine lõppemisajaga korduva häire.

Kui määratud aeg (sealhulgas ka korduste aeg) on juba möödas, näitab &kalarm; teadet otsekohe (kui just `lateCancel` väärtus ei anna teada, et häiret on juba liiga hilja näidata, millisel juhul &kalarm; ignoreerib soovi. Kui tähtaeg (või korduse tähtaeg) seisab veel ees, lisab &kalarm; häireteate kalendrifaili, et seda hiljem näidata.

scheduleFile

scheduleFile

uue häire ajastamine, mis näitab teksti- või pildifaili sisu.

    bool scheduleFile(const KURL& URL,
                      const QString& dateTime,
                      int lateCancel,
                      int flags,
                      const QString& bgColor,
                      const KURL& audioURL,
                      int reminder,
                      const QString& recurrence,
                      int subRepeatInterval,
                      int subRepeatCount)

    bool scheduleFile(const KURL& URL,
                      const QString& dateTime,
                      int lateCancel,
                      int flags,
                      const QString& bgColor,
                      const KURL& audioURL,
                      int reminder,
                      int recurType,
                      int recurInterval,
                      int recurCount)

    bool scheduleFile(const KURL& URL,
                      const QString& dateTime,
                      int lateCancel,
                      int flags,
                      const QString& bgColor,
                      const KURL& audioURL,
                      int reminder,
                      int recurType,
                      int recurInterval,
                      const QString& endDateTime)

##### Parameetrid

`URL`

- Määrab teksti- või pildifaili, mille sisu näidatakse ajastatavas häireteates.

`dateTime`

- Määrab kuupäeva või kuupäeva ja kellaaja, millal faili näidatakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul YYYY-MM-DD (nagu tagastab `QDate::toString(Qt::ISODate)`). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul YYYY-MM-DDTHH:MM[:SS] (nagu tagastab `QDateTime::toString(Qt::ISODate)`) või HH:MM[:SS] (nagu tagastab `QTime::toString(Qt::ISODate)`). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.

`lateCancel`

- Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.

`flags`

- Määrab soovitud häirelippude loogilise funktsiooni OR. Lipubitid on määratud failis `kalarmiface.h` klassiga `KAlarmIface`. Arvesta, et mitte kõiki lipubitte ei saa failihäire korral kasutada.

`bgColor`

- Määrab näidatava faili taustavärvi. String võib olla kujul #RRGGBB (nagu tagastab `QColor::name()`), kus RR, GG ja BB on vastavalt punase, rohelise ja sinise kahekohalised kuueteistkümnendväärtused. String võib olla mõnel muul kujul, mida tunnustab `QColor::setNamedColor()`, näiteks X'i värvide andmebaasi nimi (⪚ red või steelblue). Kui string tühjaks jätta, kasutatakse parajasti vaikimisi kehtivat taustavärvi.

`audioURL`

- Määrab teate näitamisel mängitava helifaili. Väärtuse 0 andmisel helifaili ei esitata.

`reminder`

- Määrab minutites aja enne häire ja selle korduste (kui neid on) käivitamist, millal näidatakse meeldetuletust. Kui meeldetuletust vaja ei ole, määra 0.

`recurrence`

- Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC2445. Näiteks FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.

`recurType`

- Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis `kalarmiface.h` klassiga `KAlarmIface`. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist `dateTime`.

`recurInterval`

- Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab `recurType`).

`recurCount`

- Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.

`endDateTime`

- Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui `dateTime` sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui `dateTime` sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.

`subRepeatInterval`

- Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.

`subRepeatCount`

- Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).

##### Kirjeldus

`scheduleFile()` on &DCOP;-väljakutse määratud teksti- või pildifaili näitamise ajastamiseks määratud kuupäevale ja ajale. Kui kõrvale jätta faili nime või &URL;-i ning esiplaani värvi ja fondi määramine, on selle kasutamine samasugune funktsiooniga `scheduleMessage`, mille juurest tasubki otsida ka selle funktsiooni täpsemat kirjeldust.

scheduleCommand

scheduleCommand

uue häire ajastamine, mis käivitab shellikäsu.

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

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

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

##### Parameetrid

`commandLine`

- Määrab käivitatava käsu. Parameeter `flags` osutab, kas parameeter sisaldab shellikäsku või skripti.

`dateTime`

- Määrab kuupäeva või kuupäeva ja kellaaja, millal käsk käivitatakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul YYYY-MM-DD (nagu tagastab `QDate::toString(Qt::ISODate)`). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul YYYY-MM-DDTHH:MM[:SS] (nagu tagastab `QDateTime::toString(Qt::ISODate)`) või HH:MM[:SS] (nagu tagastab `QTime::toString(Qt::ISODate)`). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.

`lateCancel`

- Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.

`flags`

- Määrab soovitud häirelippude loogilise funktsiooni OR. Lipubitid on määratud failis `kalarmiface.h` klassiga `KAlarmIface`. Arvesta, et mitte kõiki lipubitte ei saa käsuhäire korral kasutada.

`recurrence`

- Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC2445. Näiteks FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.

`recurType`

- Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis `kalarmiface.h` klassiga `KAlarmIface`. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist `dateTime`.

`recurInterval`

- Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab `recurType`).

`recurCount`

- Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.

`endDateTime`

- Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui `dateTime` sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui `dateTime` sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.

`subRepeatInterval`

- Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.

`subRepeatCount`

- Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).

##### Kirjeldus

`scheduleCommand()` on &DCOP;-väljakutse määratud shellikäsu käivitamise ajastamiseks määratud kuupäevale ja ajale. Kui kõrvale jätta ühelt poolt käsurea käsu määramine ning teiselt poolt teate värvi määramine, on selle kasutamine samasugune funktsiooniga `scheduleMessage`, mille juurest tasuks vaadata ka selle funktsiooni täpsemat kirjeldust.

scheduleEmail

scheduleEmail

uue häire ajastamine, mis saadab häire e-postitsi.

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

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

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

##### Parameetrid

`fromID`

- &kmail;i identiteet, mida kasutatakse kirja saatja määramiseks. Kui see on andmata, kasutatakse saatja aadressina aadressi, mis on määratud &kalarm;i e-posti seadistustes.

`addresses`

- Komadega eraldatud saajate e-posti aadresside nimekiri.

`subject`

- Määrab kirja subjektirea ehk teema.

`message`

- Määrab kirja sisu.

`attachments`

- Komadega eraldatud failide asukohtade võu &URL;-ide nimekiri, mis kaastakse kirjale.

`dateTime`

- Määrab kuupäeva või kuupäeva ja kellaaja, millal kiri saadetakse. Ainult kuupäevaga määratud häire puhul peab string olema kujul YYYY-MM-DD (nagu tagastab `QDate::toString(Qt::ISODate)`). Kuupäeva ja kellaajaga määratud häire korral peab string olema kujul YYYY-MM-DDTHH:MM[:SS] (nagu tagastab `QDateTime::toString(Qt::ISODate)`) või HH:MM[:SS] (nagu tagastab `QTime::toString(Qt::ISODate)`). Kui kuupäeva ei ole määratud, kasutatakse käesolevat kuupäeva. Pane tähele, et sekundeid ignoreeritakse.

`lateCancel`

- Annab korralduse häire katkestada, kui seda ei saa käivitada määratud arvu minutite jooksul pärast häire ettenähtud aega. Kui väärtus on 0, ei katkestata häiret sellele vaatamata, kui palju aega on ettenähtud ajast möödas.

`flags`

- Määrab soovitud häirelippude loogilise funktsiooni OR. Lipubitid on määratud failis `kalarmiface.h` klassiga `KAlarmIface`. Arvesta, et mitte kõiki lipubitte ei saa e-posti häire korral kasutada.

`recurrence`

- Määrab häire regulaarse kordumise iCalendari süntaksis, nagu selle defineerib RFC2445. Näiteks FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO määrab 4 kordust 3-kuiste intervallidega kuu viimasel esmaspäeval. Mittekorduva häire korral määra tühi string.

`recurType`

- Määrab häire kordumise tüübi. Lubatud väärtused on MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Need on defineeritud failis `kalarmiface.h` klassiga `KAlarmIface`. Igakuised kordumised on kuupäeva ja iga-aastased kordumised samuti kuupäeva tüüpi, kusjuures mõlemal juhul võetakse kuupäev parameetrist `dateTime`.

`recurInterval`

- Määrab häire korduste vaheliste perioodide hulga (minutid/päevad/nädalad/kuud/aastad, nagu selle määrab `recurType`).

`recurCount`

- Määrab, mitu korda häiret korrata. -1 tähendab häire lõputut kordamist.

`endDateTime`

- Määrab häire kordumise lõppkuupäeva või kuupäeva ja kellaaja. Kui `dateTime` sisaldab kellaaega, peab ka see parameeter sisaldama kellaaega; kui `dateTime` sisaldab ainult kuupäeva, peab ka see parameeter sisaldama ainult kuupäeva.

`subRepeatInterval`

- Määrab häire alamkorduste intervalli minutites. Väärtuse 0 korral lihtne alamkordused puuduvad. Kui kordamist pole määratud, seda eiratakse.

`subRepeatCount`

- Määrab häire alamkorduste arvu (kaasa arvatud esimene kordus).

##### Kirjeldus

`scheduleEmail()` on &DCOP;-väljakutse määratud e-kirja saatmise ajastamiseks määratud kuupäevale ja ajale. Kui kõrvale jätta ühelt poolt kirja päise ja sisu määramine ning teiselt poolt teate värvi määramine, on selle kasutamine samasugune funktsiooniga `scheduleMessage`, mille juurest tasuks vaadata ka selle funktsiooni täpsemat kirjeldust.

edit

edit

See avab häire redigeerimise dialoogi.

    bool edit(const QString& sündmuseID)

##### Parameetrid

`eventID`

- Määrab redigeeritava sündmuse unikaalse ID.

##### Tagastatav väärtus

false, kui määratud häiret ei leita või kui see ei ole redigeeritav, muul juhul true.

##### Kirjeldus

`edit()` on &DCOP;-väljakutse, mis avab häire redigeerimise dialoogi määratud häire redigeerimiseks.

editNew

editNew

See avab häire redigeerimise dialoogi uue häire redigeerimiseks.

    bool editNew(const QString& mallinimi)

##### Parameetrid

`mallinimi`

- Määrab häiremalli nime, millele uus häire tugineb, või puudub, kui malli ei kasutata.

##### Tagastatav väärtus

false, kui `mallinimi` on antud, aga sellise nimega malli ei leita, muul juhul true.

##### Kirjeldus

`editNew()` on &DCOP;-väljakutse, mis avab häire redigeerimise dialoogi uue häire redigeerimiseks. Kui parameetrina anda häiremalli nimi, täidetakse dialoog ette malli andmetega. Kui määratud malli ei leita, avatakse küll häire redigeerimise dialoog, aga mõistagi ei ole selles siis midagi ette antud.

### Käsurealiides

Käsurea võtmeid pakutakse võimaldamaks muudel rakendustel (näiteks häiredeemon) käivitada &kalarm;i, kui see juba ei tööta, ajastatud häirete käivitamiseks või katkestamiseks või uute häirete ajastamiseks. Põhjus, miks selleks kasutatakse käsurea võtmeid, peitub selles, et kui &kalarm; käivitada ilma käsurea parameetriteta ja seejärel esitada talle &DCOP;-väljakutse, käivitub see vaikimisi graafilises režiimis, mis rakendustevaheliste väljakutsete puhul ei ole kindlasti soovitav.

Rakendused peaksid esmalt kontrollima, kas &kalarm; juba töötab. Kui jah, siis tuleks vastavate toimingute soovid esitada &DCOP;-väljakutsetena.

Käsurea võtmeid uue häire ajastamiseks on kirjeldatud osas Käsurea kasutamine. Võtmed ajastatud häirete käivitamiseks ja peatamiseks on järgmised:

Ka tavalised kasutajad võivad soovi korral siintoodud käsurea võtmeid kasutada (eeldusel mõistagi, et nad määravad parameetrile vajaliku info).

Võti | Kirjeldus
`--calendarURL `url`` | Määratud &URL;-iga kalendrifaili kasutamine. See võti on kasutusel ainult ühtlusekontrolliks: kui &URL; ei määra &kalarm;i käesolevat vaikekalendrifaili, soovi ignoreeritakse.
`--cancelEvent `eventID`` | Katkestab määratud sündmuse ID-ga häire.
`--triggerEvent `eventID`` | Käivitab määratud sündmuse ID-ga häire. Sooritatav toiming on samasugune, nagu &DCOP;-väljakutse triggerEvent().
`--handleEvent `eventID`` | Käivitab või katkestab määratud sündmuse ID-ga häire. &kalarm; määrab vajaliku tegevuse samamoodi, nagu &DCOP;-väljakutse handleEvent() korral.

`--cancelEvent`, `--triggerEvent` ja`--handleEvent` on vastastikku välistavad. `--calendarURL` ei ole kohustuslik, kuid seda saab kasutada vaid koos ühe eelnevalt mainituga.

Näited:

    % kalarm --triggerEvent &kalarm;-387486299.702 --calendarURL file:/home/zaphod/hydra.ics
    % kalarm --cancelEvent &kalarm;-388886299.793

## Küsimused ja vastused

&reporting.bugs; &updating.documentation;

Mis on häiredeemon?

Käesolevas käsiraamatus on korduvalt viidatud häiredeemonile. See on rakendus, mis toimib taustal, kontrollides ootel olevaid häireid ja andes &kalarm;ile käsu tegutseda, kui õige aeg on kätte jõudnud.

Millist seadistustefaili kasutab &kalarm;?

&kalarm;i seadistused on failis `$KDEHOME/share/config/kalarmrc`.

Ajastatud häireid sisaldav kalendrifail on `$KDEHOME/share/apps/kalarm/calendar.ics`, kui seadistustefailis ei ole just määratud mõnda muud kalendrifaili (kirje `Calendar` sektsioonis `General`).

Aegunud häireid sisaldav kalendrifail on `$KDEHOME/share/apps/kalarm/expired.ics`, kui seadistustefailis ei ole just määratud mõnda muud kalendrifaili (kirje `ExpiredCalendar` sektsioonis `General`).

Häiremalle sisaldav kalendrifail on `$KDEHOME/share/apps/kalarm/template.ics`, kui seadistustefailis ei ole just määratud mõnda muud kalendrifaili (kirje `TemplateCalendar` sektsioonis `General`).

Parajasti näidatavate häirete üksikasju sisaldab kalendrifail `$KDEHOME/share/apps/kalarm/displaying.ics`.

Millist seadistustefaili kasutab häiredeemon?

Häiredeemoni seadistused on failis `$KDEHOME/share/config/kalarmdrc`, samas leiab ka &kalarm;i klientrakenduse üksikasjad.

Millises vormingus häired salvestatakse?

Kalendrifailid, milles &kalarm; salvestab häired, on tekstifailid, mille vormingu määrab kindlaks dokument RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). See on standardvorming, mida kasutavad kõik mooduli kdepim rakendused. &kalarm; kasutab teatud mittestandardseid omadusi komponendis Alarm, mis vastavad küll RFC2445 nõuetele: `X-KDE-KALARM-NEXTRECUR`, `X-KDE-KALARM-REPEAT`, `X-KDE-KALARM-TYPE`, `X-KDE-KALARM-NEXTREPEAT`, `X-KDE-KALARM-FONTCOLOR`, `X-KDE-KALARM-VOLUME`, `X-KDE-KALARM-SPEAK`, `X-KDE-KALARM-EMAILID`.

Milline on &kalarm;i ja häiredeemoni rakenduse nimi?

&kalarm;i rakenduse nimi on kalarm ja häiredeemoni rakenduse nimi on kalarmd.

## Autorid ja litsents

&kalarm;

Rakenduse autoriõigus 2001, 2002, 2003, 2004, 2005, 2006, 2007: David Jarvie &David.Jarvie.mail;

Häiredeemoni autorid:

- Preston Brown pbrown@kde.org

- David Jarvie &David.Jarvie.mail;

- Cornelius Schumacher schumacher@kde.org

Dokumentatsiooni autoriõigus 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008: David Jarvie &David.Jarvie.mail;

Tõlge eesti keelde: Marek Laane bald@starman.ee

&underFDL; &underGPL;

Tänusõnad kuuluvad ka &kde; 1 rakenduse KAlarm autorile Stefan Nikolausele stefan.nikolaus@stuco.uni-oldenburg.de, kes lahkelt lubas nimetust &kalarm; kasutada ka käesoleva &kde; 2/&kde; 3 rakenduse puhul.

## Paigaldamine

### &kalarm;i hankimine

&install.intro.documentation;

&kalarm; on saadaval &kde; 2 jaoks ja autonoomse paketina &kde; 3 jaoks veebiaadressil http://www.astrojar.org.uk/kalarm.

### Nõuded

&kalarm; nõuab &kde; standardsete teekide olemasolu (pakett `kdelibs`). Lähtekoodi kompileerimiseks on vajalikud ka &Qt; ja `kdelibs` arenduspaketid. Olemasolu korral saab X11 arenduspaketti kasutada &kalarm;i paremaks toimimiseks &kde;s süsteemse salve puudumisel.

Järgmised lisapaketid pakuvad paigaldamise korral &kalarm;ile lisavõimalusi:

- &kmix; (moodulis kdemultimedia): kui see on paigaldatud, saab &kalarm;is määrata audiofailide esitamisel kasutatava absoluutse helitugevuse.

- KTTSD (moodulis kdeaccessibility): kui see on paigaldatud ja seadistatud ning süsteemis on ka sobiv kõnesüntesaator, saab &kalarm;il lasta näidatavaid häireteateid ka kõnelda.

&kalarm; kasutab töötamiseks umbes 12 Mb ja häiredeemon umbes 2,5 Mb mälu, kuid see võib erineda vastavalt platvormile ja seadistusele.

Muudatustega saab tutvuda failis `ChangeLog` või veebiaadressil http://www.astrojar.org.uk/kalarm.

### Kompileerimine ja paigaldus

Kui sul ei õnnestu hankida sobivat eelkompileeritud binaarpaketti, tuleb &kalarm; käsitsi lähtekoodist kompileerida. Hangi selleks fail `kdepim-x.x.tar.bz2` või `kalarm-x.x.tar.bz2` (või midagi sarnast) vastavalt sellele, kas soovid paigaldada kogu &package; või ainult &kalarm;i. Paki see lahti uude kataloogi käsuga ``tar` `xvfj `pakett.tar.bz2``` (või sarnasega) ning liigu kataloogi, kuhu paketi lahti pakkisid.

&install.compile.documentation;

Kui sul on paigaldatud enam kui üks &kde; versioon (nt. &kde; 2 ja &kde; 3), võib juhtuda, et paigaldad &kalarm;i valesse &kde; kataloogi. Vajaduse korral võid &kde; kataloogi määrata parameetrina käsule ``./configure``. Kui näiteks &kde; on paigaldatud kataloogi `/opt/kde2`, siis:

``./configure` --prefix=`/opt/kde2``

Kui paigaldad &kalarm;i mõnda muusse kataloogi kui see, kuhu on paigaldatud &kde;, ei tööta rakendus korrektselt, kui sa ei anna selle asukohta &kde;-le teada. Selleks tuleb lisada keskkonnamuutujale `KDEDIRS` iga kord enne &kde; käivitamist &kalarm;i asukoht.

Kui näiteks &kde; on paigaldatud asukohta `/opt/kde`, on `KDEDIRS` tavaliselt `/etc/opt/kde:/opt/kde`. Kui paigaldad &kalarm;i asukohta `/usr/local`, tuleb määrata `KDEDIRS` väärtuseks `/usr/local:/etc/opt/kde:/opt/kde`, enne kui &kde; käivitada.

&kalarm;il on spetsiaalne konfiguratsioonivõti, mis lubab määrata, millises keeles dokumentatsioon paigaldada, andes selles käsu `./configure` parameetrina ühe või enam keelekoodi. Vaikimisi paigaldatakse dokumentatsioon kõigis saadaolevates keeltes. Paketti kaasatud keelte loendi koos nende koodidega toob ära fail `DOC-LANGUAGES`. Näiteks ainult prantsus- ja ingliskeelse dokumentatsiooni paigaldamiseks anna käsk:

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

Pane tähele, et see võti ei mõjuta seda, millises keeles kasutajaliidese tõlked on paigaldatud.

### Seadistamine

&kalarm;i töötamiseks &kde; töölaual ei ole vaja midagi spetsiaalselt seadistada. Kui oled &kalarm;i esimest korda käivitanud, käivitub häiredeemon edaspidi igal sisselogimisel ja hakkab jälgima ajastatud häireid.

&kalarm;i kasutamiseks mõnel muul töölaual kui &kde; tuleb ennekõike tagada, et häiredeemon käivituks sisselogimisel automaatselt. Täpsemad juhised leiab failist `INSTALL`, mis on &kalarm;iga kaasa pandud.

&documentation.index;