# Handbok &kalarm;

David
Jarvie

    software@astrojar.org.uk

David
Jarvie

    software@astrojar.org.uk

Utvecklare
Stefan
Asserhäll

    stefan.asserhall@comhem.se

Översättare
2001
2002
2003
David Jarvie
&FDLNotice;
2003-12-01
1.00.00

&kalarm; är en personlig schemaläggare av alarm/påminnelsemeddelanden och kommandon för &kde;.

KDE
kdepim
kalarm
alarm
påminnelse

## Inledning

&kalarm; är en personlig schemaläggare av kommandon och personliga alarmmeddelanden. Den låter dig ställa in personliga alarm/påminnelsemeddelanden som dyker upp på skärmen vid tidpunkter som du anger, eller kan du ställa in kommandon att köra eller e-post att skicka.

I sitt normala grafiska läge, visar &kalarm; en lista med pågående alarm, med tider och information. Du kan skapa nya alarm, eller du kan välja befintliga alarm för att ändra eller ta bort dem. Du kan också välja att se utgångna alarm.

När du ställer in eller ändrar ett alarm, kan du antingen skriva in texten för alarmmeddelandet, ange en text- eller bildfil som ska visas, ett kommando som ska köras eller e-post som ska skickas. Du kan också välja färgen för alarmmeddelandet, om det ska repeteras, om ett ljud ska spelas och om alarmet ska avbrytas om det inte kan visas vid den schemalagda tiden.

Alarm kan också schemaläggas på kommandoraden, eller via &DCOP;-anrop från andra program.

När ett alarmmeddelande ska visas, syns det på alla &kde;-skrivbord för att vara säker på att du inte missar det. Meddelandefönstret visar tiden då alarmet var schemalagt. Det har oftast ett alternativ som anger att det ska skjutas upp, och visas igen senare. Ett exempel på ett alarmmeddelande:

Skärmbild av &kalarm;s meddelandefönster
Alarmmeddelande

När alarmet anger ett kommando som ska köras, visar &kalarm; ingenting.

&kalarm; kan köra i ett av två lägen: kontinuerligt (det normala) då det kör i &kde;:s systembricka, eller på begäran då det kör när det behövs (med möjligheten att visa en oberoende ikon i systembrickan).

Det här dokumentet refererar på olika ställen till alarmdemonen. Det är ett program som kör i bakgrunden, kontrollerar pågående alarm och talar om för &kalarm; att de ska visas när de inträffar.

## Att använda &kalarm;

### Grafiskt läge

När det körs utan kommandoradsväljare, startar &kalarm; i grafiskt läge, och visar den nuvarande listan med pågående alarm.

När &kalarm; startar i grafiskt läge, kontrolleras om alarmdemonen kör. Om den inte redan kör, så startar &kalarm; den.

Alla sifferrutor i &kalarm; har en accelerationsfunktion. För att ändra värdet med större steg, håll nere skift-tangenten medan du klickar på pilknapparna.

#### Alarmlista

Huvudfönstret i &kalarm; visar den nuvarande listan med pågående alarm, med tider, antal upprepningar, färger och meddelandetexter, namn på filer som ska visas, kommandon som ska köras eller e-postrubriker. (För ett alarm som upprepas, är tiden som anges nästa gång alarmet ska visas.) En ikon till vänster om varje alarm text/fil/kommando anger alarmets typ.

Skärmbild av &kalarm;s huvudfönster
Huvudfönster

För ett upprepat alarm, visar listan nästa gång det är schemalagt att visas och det grundläggande upprepningsintervallet (t.ex. 1 dag för daglig upprepning, 3 veckor för en upprepning som utlöses på måndag och onsdag var tredje vecka, Inloggning för ett alarm som upprepas vid inloggning).

Alarmen kan sorteras efter datum/tid, antal upprepningar, färg eller meddelandetext genom att klicka på rubriken för lämplig kolumn. För att vända sorteringsordning, klicka på kolumnens rubrik en gång till.

Du kan välja att visa återstående tid till varje alarm går ut, tillsammans med, eller istället för, alarmets schemalagda tid. För att visa eller gömma alarmtidskolumnen, välj Visa Visa alarmtider. För att visa eller dölja kolumnen tid till alarm, välj Visa Visa tid till alarm. Åtminstone en av dessa kolumner visas alltid.

Utgångna alarm kan visas i alarmlistan genom att välja Visa Visa utgångna alarm. För att gömma dem igen, upprepa åtgärden.

#### Att lägga till ett nytt alarm

För att lägga till ett nytt alarmmeddelande, gör något av följande. Detta visar redigeringsfönstret för alarmmeddelanden som beskrivs nedan.

- Välj Åtgärder Ny .

- Högerklicka på ikonen i systembrickan och välj Nytt alarm i den sammanhangsberoende menyn.

- Dubbelklicka på det tomma utrymmet under den sista posten i alarmlistan.

- Högerklicka på det tomma utrymmet under den sista posten i alarmlistan och välj Ny i den sammanhangsberoende menyn.

Som ett alternativ kan du skapa nya alarm förinställda från olika källor:

- För att basera det nya alarmet på ett befintligt, markera det befintliga alarmet i listan och välj Åtgärder Kopiera. Då visas alarmet med redigeringsrutan redan ifylld med en kopia av det markerade alarmets information.

- För att skapa ett nytt allarm som visar befintlig e-post, dra brevet från &kmail; till &kalarm;s huvudfönster eller systembrickans ikon. Det visar dialogrutan för alarmredigering med hela brevet (inklusive avsändare, mottagare, etc.) som alarmtexten.

- Genom att dra vilket textstycke som helst till &kalarm;s huvudfönster eller systembrickans ikon, visas dialogrutan för alarmredigering med alarmets text angiven.

- För att skapa ett alarm som visar en fil, dra filens webbadress till &kalarm;s huvudfönster eller systembrickans ikon. Det visar dialogrutan för alarmredigering med filnamnet angivet.

- Du kan automatiskt skapa födelsedagsalarm för personer i adressboken enligt beskrivningen i Importera födelsedagar från adressboken.

#### Ändra ett befintligt alarm

För att ändra ett befintligt alarm (utgångna alarm kan inte påverkas), gör något av följande:

- Dubbelklicka på posten i alarmlistan.

- Välj det genom att klicka på posten i alarmlistan. Välj sedan Åtgärder Ändra.

- Högerklicka på posten i alarmlistan och välj Ta bort i den sammanhangsberoende menyn.

Det här visar redigeringsfönstret för alarm:

Skärmbild av alarmredigeringsfönstret
Alarmredigeringsfönstret

Välj alarmtyp i rutan Åtgärd.

- Text för att skriva in en alarmmeddelandetext (som kan innehålla flera rader) i redigeringsrutan. Ange följande alternativ:

  - Kryssrutan Bekräfta meddelande låter dig ange om du vill bli tillfrågad om bekräftelse när du stänger alarmmeddelandets fönster. Det här kan användas som en säkerhetsåtgärd för att undvika att bekräfta alarm av misstag.

  - Markera kryssrutan Ljud om du vill att ett hörbart alarm ska ljuda när alarmmeddelandet visas. Normalt hörs ett pip, använd knappen till höger för att välja en ljudfil som ska spelas. För att återgå till ett pip, klicka på knappen igen. För att se vad det aktuella ljudet är, håll musen över knappen till ett verktygstips visas.

  - Markera rutan Påminnelse om du vill visa en påminnelse innan huvudalarmet och var och en av dess upprepningar (om det finns några). Ange hur långt i förväg med redigeringskontrollerna intill kryssrutan.

  - Välj bakgrundsfärg för fönstret med alarmmeddelandet. (Färgvalslistan kan anpassas i inställningsdialogrutan.)

  - Använd knappen Teckensnitt och färg... för att välja ett teckensnitt för alarmmeddelandet. Markera Använd standardteckensnitt i dialogrutan Välj alarmteckensnitt och färg för att visa meddelandet med vilket teckensnittet som än är förvalt när meddelandet visas. (Förvalt teckensnitt kan ställas in i inställningsdialogrutan.) För att välja ett särskilt teckensnitt för meddelandet, avmarkera Använd standardteckensnitt.

- Arkiv för att skriva in namnet eller webbadressen till en textfil vars innehåll ska visas i alarmmeddelandet. Använd knappen intill redigeringsrutan för att visa en filvalsdialogruta. Ange alternativ på samma sätt som för textalarm ovan.

- Kommando för att skriva in en skalkommandorad att köra. Kommandot skickas direkt till förvalt skal (definierat av miljövariabeln `SHELL`), och kan innehålla alla alternativ, väljare, kommandon med rörledning, etc. som tillåts av skalet på en ensam kommandorad.

  Det här alternativet är inte tillgängligt om &kde; kör i kioskläge.

- E-post för att skriva in e-post att skicka. Fyll i mottagarnas adresser, e-postrubriken och meddelandetexten i de tre redigeringsfälten. Använd knappen intill adressredigeringsrutan för att visa &kde;:s adressbok, där du kan välja e-postmottagare. Bilagor kan läggas till med knappen Lägg till... Observera att bilagor måste fortfarande finnas vid tiden då alarmet inträffar. Ingen kopia lagras när alarmet ställs in. För att ta bort en bilaga, markera det i kombinationsrutan och klicka på knappen Ta bort.

  E-postadressen som kopian skickas till kan ställas in i inställningsdialogrutan, där det förvalda värdet är e-postadressen som ställts in i &kde;:s Inställningscentral.

  Ställ in följande alternativ:

  - Markera kryssrutan Kopiera e-post till mig själv för att skicka en dold kopia av e-posten till dig själv när alarmet inträffar. E-postadressen som kopian skickas till kan ställas in i inställningsdialogrutan, där det förvalda värdet är e-postadressen som ställts in i &kde;:s Inställningscentral.

Om alarmet är återkommande, och det skjutits upp efter att det visats senast, så visar rutan Uppskjutna alarm tiden som det skjutits upp till. Ändra... visar en dialogruta som låter dig ändra tiden eller inte längre skjuta upp alarmet.

Använd rutan Tid, för att antingen välja

- Vid datum/tid för att skriva in datum och tid då alarmet ska visas. Markera kryssrutan När som helst om du bara vill ange ett datum för alarmet: i detta fall visas alarmet vid det första tillfället efter den inställda tiden då dagen börjar, på det angivna datumet. (Anpassa &kalarm; beskriver hur man ställer in tiden då dagen börjar.)

  För ett alarm som inte upprepas måste datum och tid som du skriver in vara i framtiden, eller om du bara skriver in ett datum måste det vara idag eller senare. För ett alarm som upprepas finns inga sådana begränsningar, eftersom startdatum och tid automatiskt justeras till första upprepningen efter aktuell tid.

- Tid från nu för att skriva in hur långt från nuvarande tid (i timmar och minuter) som alarmet ska visas.

Alarmets grundläggande upprepningskaraktäristik visas av bekvämlighetsskäl under fliken Alarm. Ange om och hur alarmet ska upprepas under fliken Upprepning.

- Välj typ av upprepning i rutan Upprepningsregel , på följande sätt:

  - För att bara visa alarmet en gång, välj Ingen upprepning.

  - Markera Vid inloggning om du vill att alarmet ska visas så fort du loggar in, till den schemalagda sluttiden. (Observera att ett alarm som upprepas vid inloggning också visas så fort du aktiverar alarm, eller startar om eller återställer alarmdemonen.)

  - För att låta alarmet upprepas med regelbundna intervall, välj en tidsperiod och skriv sedan in i rutan Upprepa var hur många tidsperioder som ska gå ut mellan upprepningarna. För att till exempel upprepa var 14:e dag, kan du välja Varje dag och skriva in värdet 14, eller välja Varje vecka och skriva in värdet 2. Beroende på tidsperioden som väljs, kan det finnas ytterligare alternativ:

    - För en veckovis upprepning, markera varje dag i veckan då du vill visa alarmet.

    - För en månadsvis upprepning, kan du antingen välja ett fast datum eller en position (t.ex. den andra tisdagen).

    - För en månadsvis upprepning, kan du antingen välja ett fast datum under månaden eller en position under en månaden (t.ex. den sista lördagen i maj). Markera varje månad under året då du vill aktivera alarmet.

    För att ställa in ett dagligt alarm som bara ska inträffa på vardagar, använd veckovis upprepning och markera alla vardagar.

- Ställ in det övergripande tidsområdet i rutan Upprepningens slut på följande sätt:

  - Välj Inget slut för att fortsätta upprepningarna för evigt.

  - Välj Sluta efter för att ange totalt antal upprepningar av alarmet.

  - Välj Sluta vid för att ange datum/tid som alarmet kommer att upprepas till.

- Om du vill undanta vissa datum eller tider från upprepningen som du har ställt in, ange dem i grupprutan Undantag. Listan med undantag (dvs datum eller tider) visas till vänster. För att lägga till ett nytt undantag, skriv in ett datum till höger och tryck på Lägg till. För att ändra ett undantag, skriv in det nya datumet till höger och tryck på Ändra. För att ta bort ett undantag, markera det i listan och tryck på Ta bort.

Kryssrutan Hoppa över om sent avgör vad som händer om alarmet inte kan aktiveras vid sin schemalagda tid. Markera den här rutan för att avbryta alarmet om det inte kan aktiveras inom en minut efter den riktiga tiden. Lämna rutan omarkerad för att aktivera alarmet vid det första möjliga tillfället efter den schemalagda tiden. Alarm med bara datum, dvs. de som har alternativet När som helst markerat, avbryts om de inte kan visas inom 24 timmar efter tiden då dagen anses börja på det schemalagda datumet.

Ett alarm kan bara aktiveras medan du är inloggad, och medan både X och alarmdemonen kör.

Tryck på knappen Ställ in alarm när alla uppgifter är riktiga, för att lägga till alarmet i listan på schemalagda alarm.

#### Ta bort ett alarm

För att ta bort ett befintligt alarm, gör något av följande:

- Välj det genom att klicka på posten i alarmlistan. Välj sedan Åtgärder Ta bort .

- Högerklicka på posten i alarmlistan och välj Ta bort i den sammanhangsberoende menyn.

#### Visa ett alarm

För att ändra ett befintligt alarm, utan att kunna ändra det, gör något av följande:

- Välj det genom att klicka på posten i alarmlistan. Välj sedan Åtgärder Visa .

- Högerklicka på posten i alarmlistan och välj Visa i den sammanhangsberoende menyn.

Det här visar redigeringsfönstret för alarm i skrivskyddat läge.

#### Bekräfta ett alarm

Se Alarmmeddelandefönster för hur man bekräftar alarm.

#### Importera födelsedagar från adressboken

Du kan ställa in visning av alarm vid födelsedagar som är lagrade i adressboken med &kaddressbook;Arkiv Importera födelsedagar.... Då visas en dialogruta som låter dig välja för vilka födelsedagar alarm ska skapas.

- I rutan Alarmtext kan du ställa in texten som visas i alarmmeddelandet för födelsedag. Meddelandetexten skapas genom att kombinera texten i Prefix, följt av personens namn, följt av texten i Suffix. Inga mellanslag läggs till, så kom ihåg att lägga till eventuellt nödvändiga avslutande mellanslag i Prefix och inledande mellanslag i Suffix.

  Om du ändrar alarmtexten, utvärderas listan för val av födelsedag igen.

- Välj födelsedagarna som du vill skapa alarm för i listan Välj födelsedagar. Observera att listan bara visar poster från adressboken som innehåller en födelsedag, och som inte redan har ett födelsedagsalarm med formatet som för närvarande anges i rutan Alarmtext.

- Återstående inställningar är likadana som för Text-alarm i dialogrutan för alarmredigering.

#### Att visa &kalarm; i systembrickan

Du måste köra &kde;-skrivbordet för att visa &kalarm; i systembrickan. Om &kalarm; kör i kontinuerligt läge, visas ikonen i systembrickan alltid. De här anvisningarna gäller bara läget på begäran. (Se Anpassa &kalarm; för en beskrivning av körlägen.)

För att visa &kalarm; i &kde;:s systembricka, välj Visa Visa i systembricka .

För att ta bort &kalarm; från &kde;:s systembricka, gör något av följande:

- Välj Visa Dölj från systembrickan .

- Högerklicka på ikonen i systembrickan och välj Avsluta i den sammanhangsberoende menyn.

Användning av ikonen i systembrickan beskrivs nedan.

#### Aktivera/stänga av alarmbevakning

##### Aktivera alarmbevakning

Först, om &kalarm;s körläge är kontinuerligt och du har valt Inaktivera alarm när programmet inte är startat i inställningsdialogrutan, måste du försäkra dig om att &kalarm; kör för att alarmbevakning ska ske.

Därefter, om bevakning för närvarande är avstängd, gör något av följande:

- Välj Åtgärder Aktivera alarm .

- Högerklicka på ikonen i systembrickan och välj Aktivera alarm i den sammanhangsberoende menyn.

Alarmdemonen startas om det behövs, och alarm bevakas så att de kan visas när det är dags.

När alarmdemonen startas, påverkar det alla andra program som använder alarmdemonen.

##### Stänga av alarmbevakning

Det finns flera sätt att inaktivera alarmbevakning, som förhindrar att &kalarm; visar ytterligare alarm, antingen till de aktiveras igen, eller - under förutsättning att alarmdemonen är inställd att starta vid inloggning - till nästa gång du loggar in.

För att inaktivera alarm utan att stoppa alarmdemonen (och därför utan att påverka andra program som använder alarmdemonen), gör något av följande:

- Välj Åtgärder Alarm aktiverade .

- Högerklicka på ikonen i systembrickan och välj Alarm aktiverade i den sammanhangsberoende menyn.

- Om &kalarm;s körläge är kontinuerligt och du har valt Inaktivera alarm när programmet inte är startat i inställningsdialogrutan, avsluta &kalarm;.

Att inaktivera alarm genom att stoppa alarmdemonen:

- Välj Inställningar Styr alarmdemonen... . Det här visar tjänsthanterarens dialogruta, som gör det möjligt att stoppa alarmdemonen.

Det här påverkar alla andra program som använder alarmdemonen.

#### Förnya alarm

Om den osannolika händelsen att ett alarm inte visas när det skulle ha visats inträffar, kan du uppdatera alarmlistan och visa alla alarm som inte visats, genom att välja Åtgärder Förnya alarm .

&kalarm; visar alarm som hoppats över genom att återställa alarmdemonen, som beskrivs i avsnittet Alarmdemonen.

#### Styra alarmdemonen

För att styra alarmdemonen, välj Inställningar Styr alarmdemonen... . Det här visar tjänsthanterarens dialogruta, som låter dig stoppa eller starta alarmdemonen, och ställa in om den kör automatiskt vid inloggning. Se Styra alarmdemonen med tjänsthanteraren för mer information.

#### Avsluta programmet

Avsluta &kalarm; genom att stänga alla fönster och ikonen i systembrickan, eller vid kontinuerligt körläge, genom att stänga alla meddelandefönster och välja Avsluta i den sammanhangsberoende menyn för ikonen i systembrickan.

Arkiv Avsluta stänger bara själva fönstret. Effekten för menyalternativet Avsluta i den sammanhangsberoende menyn för systembrickans ikon beror på körläget: för läget på begäran göms systembrickans ikon, medan i kontinuerligt läge avslutas programmet.

Om Inaktivera alarm när programmet inte är startat inte är markerat i inställningsdialogrutan, händer ingenting med alarmdemonen när &kalarm; avslutas, som fortsätter att bevaka schemalagda alarm och begära att de visas när de inträffar, om den redan är aktiv.

### Alarmmeddelandefönster

När ett alarmmeddelande ska visas, syns det på alla &kde;-skrivbord och kan inte täckas av vanliga fönster, för att vara säker på att du ser det. Meddelandefönstret visar tiden då alarmet var schemalagt, så att du kan se när det visades om du inte var vid datorn när det dök upp. (För påminnelsemeddelanden, visas datum/tid för huvudalarmet eller dess upprepning, inte påminnelsens tid, och fönsternamnet är Påminnelse).

I fallet med upprepade alarm, om ett meddelandefönster som inte bekräftas finns kvar från ett tidigare tillfälle då alarmet inträffade, dyker helt enkelt det befintliga fönstret upp när alarmet upprepas. Det här undviker att flera kopior av samma meddelande måste bekräftas, om du inte vill eller kan bekräfta ett meddelande när det inträffar.

När ett fönster med ett alarmmeddelande visas, gör något av följande:

- Bekräfta det genom att klicka på knappen Stäng. Det här stänger fönstret (efter förfrågan om bekräftelse, om du markerat Bekräfta meddelande).

- Visa alternativ för att skjuta upp alarmet genom att klicka på knappen Skjut upp.... Välj sedan Skjut upp till datum/tid för att skriva in datum och tid när meddelandet ska visas igen, eller välj Skjut upp under tidsintervall för att skriva in hur mycket senare (i timmar och minuter) som meddelandet ska visas igen. Klicka sedan på Skjut upp för att skjuta upp alarmmeddelandet.

  Tiden alarmet skjuts upp till måste vara tidigare än nästa schemalagda upprepning eller påminnelse.

  Knappen Skjut upp... är inte tillgänglig för alarm som visas vid inloggning beroende på att alternativet Upprepa vid inloggning markerades.

Knappen med &kalarm;-ikonen tillhandahåller ett bekvämt sätt att aktivera &kalarm;. Att klicka på den har ingen effekt på fönstret med alarmmeddelandet.

Alarmmeddelandefönstret kan visas med två olika lägen, beroende på vad du föredrar. Du kan välja läget i inställningsdialogrutan.

- Som ett normalt fönster. I det här läget övertar alarmmeddelandefönstret tangentbordsfokus när det visas, så om du håller på att skriva vid tillfället, hamnar dina tangentnedtryckningar i det istället för ditt ursprungliga program.

- Som ett fönster som inte fokuseras. I det här läget påverkas inte tangentbordsfokus när alarmmeddelandefönstret visas, så det stör inte det du skriver. Dock har fönstret ingen namnlist i det här läget, så du kan inte flytta det.

### Ikonen i systembrickan

&kalarm; kan köras som en ikon i &kde;:s systembricka. Den här ikonen möjliggör aktivering av &kalarm; med ett klick, och ger både styrning och statusindikering av alarmbevakning. En normal &kalarm;-ikon anger att alarm bevakas, medan ett rött kors genom ikonen anger att alarm inte bevakas.

Om du håller muspekaren över systembrickans ikon, visas en sammanfattning av några av de första alarmmeddelanden som går ut under följande 24 timmar som ett verktygstips. Du kan stänga av funktionen, eller ställa in antalet alarm att visa, och deras format, i inställningsdialogrutan.

Vänsterklicka på ikonen i systembrickan för att välja att visa eller gömma &kalarm;s huvudfönster.

Högerklicka på ikonen i systembrickan för att visa den sammanhangsberoende menyn.

Aktivera alarm

  Aktiverar bevakning av alarm.

  Se Aktivera/stänga av alarmbevakning för detaljer.

Alarm aktiverade

  Stänger av bevakning av alarm.

  Se Aktivera/stänga av alarmbevakning för detaljer.

Nytt alarm...

  Visar redigeringsdialogrutan för alarm för att skapa ett nytt alarm.

  Dialogrutan för alarmredigering beskrivs under Ändra ett befintligt alarm.

Anpassa &kalarm;...

  Visar &kalarm;s inställningsdialogruta.

  Inställningsdialogrutan beskrivs under Anpassa &kalarm;. Den innehåller också alternativ som har att göra med &kalarm;s ikon i systembrickan.

Styr alarmdemonen...

  Visar tjänsthanterarens dialogruta, som låter dig styra alarmdemonen.

  Se Styra alarmdemonen med tjänsthanteraren för mer information.

Återställ/minimera

  Återställer eller minimerar &kalarm;s huvudfönster.

  Det här alternativet är bara tillgängligt i kontinuerligt körläge. (Se Anpassa &kalarm; för en beskrivning av körlägen.)

Avsluta

  Stänger &kalarm;s ikon i systembrickan.

  Bara i kontinuerligt körläge, stängs också alla &kalarm;s huvudfönster. Det har ingen effekt på bevakningen av alarm av alarmdemonen, om du inte har valt Inaktivera alarm när programmet inte är startat i inställningsdialogrutan.

### Kommandoradsväljare

När kommandoradsväljare anges, visar inte &kalarm; listan med schemalagda alarm som beskrivs ovan för grafiskt läge. Speciella kommandoradsväljare för &kalarm; kan användas för att utföra följande operationer:

- schemalägg ett nytt alarm

- styr alarmdemonen

- styr &kalarm;s visningsläge

- skaffa hjälp

Ytterligare kommandoradsväljare är tillgängliga främst för att låta andra program arbeta ihop med &kalarm;. De beskrivs i kapitlet Utvecklingsguide för &kalarm;.

Kommandoraden får bara innehålla väljare för en &kalarm; operation. Om du vill utföra flera operationer, måste du anropa &kalarm; flera gånger, med en enda uppsättning väljare varje gång.

#### Schemalägg ett nytt alarm

Följande väljare används för att schemalägga ett nytt alarm:

Alternativ | Beskrivning
--- | ---
`-a`, `--ack-confirm` | Fråga en extra gång när du bekräftar alarmet.
`-A`, `--attach webbadress` | Ange namnet eller webbadressen för en fil som ska bifogas e-post. Den här väljaren kan upprepas efter behov. `--mail` måste anges tillsammans med den här väljaren.
`-b`, `--beep` | Spela ett hörbart ljud när meddelandet visas. `--sound` får inte finnas om den här väljaren anges.
`--bcc` | Skicka en dold kopia av e-posten till dig själv. `--mail` måste anges med den här väljaren.
`-c`, `--color`, `--colour färg` | Visa meddelandet med bakgrundsfärgen enligt det angivna &Qt;-färgnamnet eller hexadecimala koden 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg färg` | Visa meddelandet med förgrundsfärgen enligt det angivna &Qt;-färgnamnet eller hexadecimala koden 0xRRGGBB.

`-e`, `--exec kommandorad`

Anger ett skalkommando som ska köras. Om angiven, så måste den här väljaren vara den sista väljaren på &kalarm;s kommandorad. Alla efterföljande kommandoradsväljare tolkas som om de utgör kommandoraden som ska köras. `--file` och `--mail` kan inte anges tillsammans med den här väljaren. `--ack-confirm`, `--beep`, `--color` och `--colorfg` ignoreras med den här väljaren.

`-f`, `--file webbadress` | Ange namnet eller webbadressen för en text- eller bildfil vars innehåll ska användas som alarmmeddelande. `--exec` och `--mail` kan inte anges, och meddelande får inte finnas med den här väljaren.
`-i`, `--interval period` | Ange intervallet mellan upprepningar av alarmet. Timmar/minuter anges med formatet nHnM, där n är ett tal, t.ex. 3H30M. Andra tidsperioder anges på formatet nX, där n är ett tal och X är en av följande bokstäver: Y (år), M (månader), W (veckor), D (dagar). Krävs om `--repeat` eller `--until` anges. --recurrence kan inte anges med den här väljaren.
`-l`, `--late-cancel` | Avbryt alarmet om det inte kan visas vid den riktiga tiden.
`-L`, `--login` | Visa alarmet varje gång då loggar in. `--interval`, `--repeat` och `--until` kan inte anges tillsammans med den här väljaren.
`-m`, `--mail adress` | Skicka e-post till angiven adress. Alternativet kan upprepas om nödvändigt. `--exec` och `--file` kan inte anges tillsammans med den här väljaren. `--ack-confirm`, `--beep`, `--color` och `--colorfg` ignoreras med den här väljaren.
`--recurrence spec` | Ställ in att alarmet ska upprepas. Ange upprepningsintervall med iCalendar-syntax (definierad av RFC2445), t.ex. FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. `--repeat`, `--interval`, och `--until` kan inte anges tillsammans med den här väljaren.
`-r`, `--repeat antal` | Antal gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt. `--interval` måste anges, och `--until` eller `--recurrence` kan inte anges tillsammans med den här väljaren.

`-R`, `--reminder period`

Visa ett påminnelsealarm angiven tid innan huvudalarmet och var och en av dess upprepningar (om det finns några). Timmar/minuter anges med formatet nHnM, där n är ett tal, t.ex. 3H30M. Andra tidsperioder anges på formatet nX, där n är ett tal och X är en av följande bokstäver: Y (år), M (månader), W (veckor), D (dagar). Den här väljaren kan inte anges med `--exec` eller `--mail`.

`-s`, `--sound webbadress` | Ange namnet eller webbadressen för en ljudfil som ska spelas när alarmmeddelandet visas. `--beep` får inte finnas om den här väljaren anges.
`-S`, `--subject ämne` | E-postens rubrik. `--mail` måste anges med den här väljaren.
`-t`, `--time datum/tid` | Visa alarmet på datum eller datum/tid som anges. Ange ett datum utan en tid med formatet åååå-mm-dd, och ange ett datum och en tid med [[[åååå-]mm-]dd-]tt:mm (där utelämnade fält antas gälla dagens datum).
`-u`, `--until datum/tid` | Upprepa alarmet till det datum eller datum/tid som anges. Ange ett datum utan en tid med samma format som för `--time`. `--interval` måste anges, och `--repeat` eller `--recurrence` kan inte anges tillsammans med den här väljaren.
meddelande | Meddelandetext som ska visas, eller om `--mail` anges, meddelandetexten i e-posten.

Antingen en meddelandetext, `--file` eller `--exec` måste anges. Annars är alla väljare valfria, utom där annat anges.

Två olika exempel som visar ett meddelande med flera rader, med röd bakgrund vid klockan 20:00 den 27:de innevarande månad, är:

    % kalarm -c red -t 27-22:00 "Kom ihåg att \nSTOPPA"
    % kalarm -c 0xFF0000 -t 27-22:00 "Kom ihåg att\nSTOPPA"

#### Övriga alternativ

Följande alternativ används för att återställa eller stanna alarmdemonen, eller styra &kalarm;s visningsläge.

Se avsnittet Alarmdemonen för en beskrivning om hur alarmdemonen kan återställas.

Alternativ | Beskrivning
--- | ---
`--reset` | Att återställa alarmdemonen.
`--stop` | Stoppar alarmdemonen.
`--tray` | Visar &kalarm; som en ikon i &kde;:s systembricka.

Till exempel, för att återställa alarmdemonen:

    % kalarm --reset

#### Hjälpalternativ

Följande hjälpalternativ är gemensamma för alla &kde;-program:

Alternativ | Beskrivning
--- | ---
`--help` | Visar en kortfattad hjälptext för väljare.
`--help-qt` | Visar talrika generella &Qt;-specifika väljare.
`--help-kde` | Visar talrika generella &kde;-specifika väljare.
`--help-all` | Visar alla alternativ.
`--author` | Visar namn och e-postadresser för &kalarm;s upphovsmän.
`-v`, `--version` | Visar de versioner av &Qt;-biblioteket, &kde; och &kalarm; som kör.
`--license` | Visar licensinformation.

### Alarmdemon

Alarmdemonen, &kalarmd;, bevakar &kalarm;s kalenderfil för alarm som inträffar. När den avgör att ett alarm har gått ut, talar den om för &kalarm; att visa det, eller att avbryta det om det är sent och sen visning inte valts för alarmmeddelandet.

Med &kde;3, kan alarmdemonen också användas av andra program, inklusive Korganizer.

Alarmdemonen kör i bakgrunden, utan något användargränssnitt. Den kan styras som beskrivs nedan.

#### Starta, återställa och stoppa alarmdemonen

Alarmdemonen startas normalt vid inloggning till &kde;-sessionen (om du inte använde tjänsthanterarens dialogruta för att stänga av automatisk start), och kör hela tiden till utloggning. Om den av någon anledning inte kör, sker ingen bevakning av alarm och &kalarm; visar inga alarm.

##### Att starta alarmdemonen

För att starta alarmdemonen kan du antingen köra &kalarm; med det förvalda grafiska läget (dvs. utan några kommandoradsväljare), aktivera alarm i menyn för &kalarm;s ikon i systembrickan, återställa demonen som beskrivs nedan, starta den med tjänsthanterarens dialogruta (se Styra alarmdemonen med tjänsthanteraren) eller köra alarmdemonen direkt från kommandoraden:

    % kalarmd

##### Återställa alarmdemonen

Det är också möjligt att återställa alarmdemonen utan att stoppa den. En återställning gör att alarmdemonen läser om listan på schemalagda meddelanden från kalenderfilen och initierar om data relaterad till &kalarm;.

Varför skulle du vilja återställa alarmdemonen? Det är inte en särskilt trolig händelse, men om &kalarm; av någon anledning inte kunde köra när alarmdemonen bad det om att aktivera ett alarm, så aktiveras aldrig det alarmet om inte alarmdemonen antingen återställs eller startas om. Att återställa är att föredra framför att stoppa alarmdemonen och starta om den, eftersom att återställa demonen inte påverkar något annat program som använder alarmdemonen.

Att återställa startar alarmdemonen om den inte kör för närvarande.

För att återställa alarmdemonen, använd antingen menykommandot Åtgärder Förnya alarm, eller skriv in följande kommando:

    % kalarm --reset

##### Att stoppa alarmdemonen

Att stoppa alarmdemonen förhindrar all fortsatt bevakning av schemalagda alarmmeddelanden till demonen startas om.

Att stoppa den påverkar funktionen för alla andra program som också använder alarmdemonen. Fundera på att återställa demonen istället.

För att stoppa alarmdemonen, använd antingen tjänsthanterarens dialogruta (se Styra alarmdemonen med tjänsthanteraren) eller skriv in följande kommando:

    % kalarm --stop

#### Styra alarmdemonen med tjänsthanteraren

Tjänsthanterarens dialogruta låter dig anpassa och styra alarmdemonen. Du kan:

- Anpassa om den körs automatiskt vid inloggning.

  Om varken alarmdemonen eller &kalarm; är inställda för att köra vid inloggning, sker ingen bevakning av alarm och &kalarm; visar inga alarm.

- Stoppa och starta alarmdemonen.

  När alarmdemonen startas eller stoppas, påverkar det alla andra program som använder alarmdemonen.

Tjänsthanterarens dialogruta kan antingen kommas åt via menyalternativet Inställningar Styr alarmdemonen..., eller via &kde;:s Inställningscentral.

## Anpassa &kalarm;

För att ställa in &kalarm;s användning, välj Inställningar Anpassa &kalarm;... . Då visas inställningsdialogrutan.

### Allmänt

Sidan Allmänt låter dig styra &kalarm;s övergripande beteende.

- Rutan Körläge: De här alternativen styr &kalarm;s ikon i systembrickan, och ger också viss kontroll över &kalarm;s användning av systemresurser, genom att ange om det ska köras hela tiden eller inte. Om systemprestanda är viktig, kan det vara önskvärt att köra det vid behov utan att visa ikonen i systembrickan. Att köra det hela tiden i systembrickan använder mer systemresurser, men ger fördelen att en indikering att alarm är aktiverade kan visas och att programmet är mer lättillgängligt. Att köra &kalarm; vid behov påverkar inte körning av alarm, eftersom det är alarmdemonen och inte &kalarm; som bevakar alarmlistan och utlöser alarm.

  - Kör hela tiden i systembrickan: &kalarm; kör hela tiden, och ikonen i systembrickan visas alltid medan det kör. Om ikonen i systembrickan stängs, stängs alla huvudfönster i &kalarm;, och om inga meddelandefönster är synliga, avslutas programmet. Tillgängliga alternativ i det här läget är:

    - Automatisk start vid inloggning: Det här startar &kalarm; vid inloggning till en &kde;-session, vilket försäkrar att &kalarm; alltid kör, om du inte avslutar det för hand.

    - Inaktivera alarm när programmet inte är startat: Att markera det här alternativet gör att alarm inaktiveras så fort &kalarm;s ikon i systembrickan inte är synlig.

      - Varna innan avslutning: Om alarm stängs av då &kalarm; inte kör, och det här alternativet är markerat, blir du tillfrågad om att bekräftelse om du försöker avsluta &kalarm; med alternativet Avsluta i systembrickans ikon. Det förhindrar avstängning av alarm av misstag. Av säkerhetsskäl aktiveras det här alternativet automatiskt igen, så fort du byter körläge.

    Om ingen &kde; systembricka finns i det här läget, kör &kalarm; hela tiden i bakgrunden, och alarm är alltid aktiverade.

  - Kör bara vid behov: &kalarm; körs bara när ett alarm inträffar, om du kör det för hand, eller medan ikonen i systembrickan visas. I det här läget kan ikonen i systembrickan fortfarande visas, men stängs ikonen i systembrickan påverkar det inte något av &kalarm;s fönster.

    - Starta ikon i systembrickan automatiskt vid inloggning: Det här visar &kalarm;s ikon i systembrickan vid inloggning. &kalarm; kör till ikonen i systembrickan stängs.

- Dagens början för alarm som bara gäller datum: Ange tiden då dagen börjar för att kunna visa alarm som bara gäller ett datum, dvs. de där alternativet När som helst valdes. På datumet då de inträffar, visas sådana alarm vid det tidigast möjliga tillfälle under 24 timmar från tiden då dagen börjar.

- Om du ställer in årliga upprepningar för 29:e februari, ange hur de ska hanteras år som inte är skottår, genom att välja något av följande alternativ:

  - 28:e februari: alarmet inträffar den 29:e februari under skottår, och 28:e februari andra år.

  - 1:a mars: alarmet inträffar den 29:e februari under skottår, och 1:a mars andra år.

  - Upprepa inte: alarmet inträffar den 29:e februari under skottår, men visas inte andra år.

  Ändras det här alternativet gör det inte att nästa schemalagda tid för befintliga alarm beräknas igen. Det påverkar bara nya alarm, eller befintliga alarm efter de har utlösts nästa gång.

- Bekräfta borttagning av alarm: Ange om du ska bli tillfrågad om bekräftelse varje gång du tar bort ett alarm.

- Rutan Utgångna alarm: De här alternativen styr lagring av utgångna alarm.

  - Behåll alarm efter de gått ut: Markera det här alternativet för att lagra utgångna alarm. Avmarkera det för att inte behålla någon information om alarm när de väl har gått ut.

  - Kasta utgångna alarm efter: Anger antal dagar som utgångna alarm lagras efter de senast inträffat.

  - Rensa utgångna alarm: Den här knappen kastar alla utgångna alarm som för närvarande finns lagrade. Detta har ingen verkan för alarm som senare går ut. De fortsätter att lagras enligt inställda alternativ.

### E-post

Sidan E-post låter dig välja alternativ för sändning och adressering av e-postalarm:

- E-postprogram: Anger e-postprogrammet som ska användas för att skicka e-postalarm:

  - Kmail: När ett e-postalarm inträffar, läggs e-post till i &kmail;s `utkorg`, under förutsättning att &kmail; kör vid tillfället. Om det inte kör, visas ett &kmail; brevfönster där e-postinformationen är ifylld, så att du kan skicka brevet för hand.

  - Sendmail: När ett e-postalarm inträffar, skickas e-post automatiskt med sendmail. Det här alternativet fungerar bara om systemet är inställt för att använda sendmail eller ett program som fungerar som sendmail till exempel postfix eller qmail.

- Från e-postadress anger din e-postadress som ska användas som avsändarens adress i e-postalarm. Välj Använd adress från Inställningscentralen för att använda e-postadressen som är inställd i &kde;:s Inställningscentral.

- Dold kopia e-postadress anger din e-postadress som ska användas för att skicka dolda kopior av e-postalarm till dig själv när alternativet Kopiera e-post till mig själv är markerat. Om dolda kopior ska skickas till ditt konto på datorn som &kalarm; kör på, kan du bara skriva in ditt inloggningsnamn här. Välj Använd adress från Inställningscentralen för att använda e-postadressen som är inställd i &kde;:s Inställningscentral.

- Meddela när e-post läggs i kö: Markera alternativet för att visa ett meddelande så fort ett e-postalarm köar e-post för att skicka till en annan dator. Det kan vara användbart, om du till exempel har en uppringd förbindelse, så att du då kan försäkra dig om att du gör vad som än behövs för att verkligen skicka e-post.

### Visa

Sidan Visa låter dig styra några aspekter rörande &kalarm;s utseende.

- Rutan Alarmlista: De här alternativen styr vilken information som visas i alarmlistan från början när &kalarm; startas. (När &kalarm; väl har startat, använd menyn Visa för att ändra vad som visas.)

  - Visa alarmtid: Markera det här alternativet för att visa datum och tid då varje alarm är schemalagt nästa gång.

  - Visa tid till alarm: Markera alternativet för att visa hur lång tid som återstår innan varje alarms nästa schemalagda aktivering. Tiden visas i dagar (om nödvändigt), timmar och minuter.

- Rutan Verktygstips i systembrickan: De här alternativen styr vilken information som visas i verktygstipsen som visas när muspekaren hålls över &kalarm;s ikon i systembrickan.

  - Visa alarm för följande 24 timmar: Om markerad, visas en sammanfattning av de första alarm som går ut under följande 24 timmar.

  - Maximalt antal alarm att visa: Avmarkera det här alternativet för visa alla alarm för de följande 24 timmarna. Markera det för att ange det maximala antalet larm som kommer att visas.

  - Visa alarmtid: Markera det här alternativet för att visa tiden då varje alarm är schemalagt.

  - Visa tid till alarm: Markera alternativet för att visa hur lång tid som är kvar till varje alarms nästa schemalagda aktivering. Tiden visas i timmar och minuter.

    - Prefix: Ange en symbol eller text att visa framför hur lång tid som är kvar till alarmet, för att skilja den från tiden då alarmet är schemalagt.

- Fokuserade meddelandefönster: Det här alternativet styr om alarmmeddelanden är fokuserade eller inte, dvs. om de tar tangentbordsfokus när de visas. Se avsnittet Alarmmeddelandefönster för detaljerad information.

- Visa utgångna alarm: Markera det här alternativet för att visa utgångna alarm i alarmlistan när &kalarm; startar. (När &kalarm; väl startat, använd Visa Visa utgångna alarm, för att gömma vad som visas.)

- Uppdateringsintervall för ikon i systembrickan: Ställer in frekvensen som &kalarm;s ikon i systembrickan uppdateras för att visa om alarm bevakas för närvarande. Det här omfattar en kontroll av att alarmdemonen kör.

### Utseende

Sektionen Utseende låter dig ställa in förvalt utseende för alarmmeddelanden.

- Välj förvalt teckensnitt och bakgrundsfärg att använda för visning av alarmmeddelanden.

- Redigera färgvalslistan som visas när du klickar på kombinationsrutan för bakgrundsfärg:

  - Lägg till färg: Visar en färgvalsdialogruta som låter dig välja en färg att lägga till i listan.

  - Ta bort färg: Tar bort färgen som för närvarande visas i kombinationsrutan Bakgrundsfärg från listan. Det egna färgvärdet kan inte tas bort från listan, och när det visas är knappen inaktiverad.

### Redigera

Sidan Redigera låter dig ange förvalda värden för alternativ i alarmredigeringsdialogrutan:

- Ställ in textfärgen som ska användas för att visa utgångna alarm i alarmlistan.

- Ange förvalda värden för kryssrutorna Hoppa över om sent, Bekräfta meddelande.och Kopiera e-post till mig själv.

- Ange ljudsignal som förvalt värde för alternativet Ljud.

- Ange förvald typ för upprepade meddelanden.

- Ange förvald period för upprepade meddelanden.

## Utvecklingsguide för &kalarm;

&kalarm; tillhandahåller ett gränssnitt som låter andra program begära följande funktioner:

- schemalägg ett nytt alarm

- aktivera eller avbryt ett redan schemalagt alarm

- avbryt ett redan schemalagt alarm

- aktivera ett redan schemalagt alarm

Var och en av de ovannämnda funktionerna implementeras både som ett &DCOP;-anrop och via kommandoraden. &DCOP;-anrop är att föredra om &kalarm; redan kör.

### &DCOP;-gränssnitt

cancelEvent

#### cancelEvent

avbryt ett redan schemalagt alarm.

    void cancelEvent(const QString& kalenderfil, const QString& händelse-ID)

##### Parametrar

`kalenderfil`

  Anger webbadressen för kalenderfilen som innehåller händelsen som ska avbrytas.

`händelse-ID`

  Anger ett unikt ID för händelsen som ska avbrytas, som är lagrad i kalenderfil.

##### Beskrivning

`cancelEvent()` är ett &DCOP;-anrop för att avbryta det angivna alarmet. &kalarm; tar bort alarmet från kalenderfilen utan att visa eller köra det.

Väljaren kalenderfil används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.

Det gamla namnet på den här funktionen, `cancelMessage`, har behållits för kompatibilitet, men alla nya program ska använda `cancelEvent`.

triggerEvent

#### triggerEvent

aktivera ett redan schemalagt alarm.

    void triggerEvent(const QString& kalenderfil, const QString& händelse-ID)

##### Parametrar

`kalenderfil`

  Anger webbadressen för kalenderfilen som innehåller händelsen som ska aktiveras.

`händelse-ID`

  Anger ett unikt ID för händelsen som ska aktiveras, som är lagrad i kalenderfil.

##### Beskrivning

`triggerEvent()` är ett &DCOP;-anrop för att aktivera omedelbar visning eller körning av det angivna alarmet (oberoende av vilken tid det är schemalagt). &kalarm; hämtar alarmet från kalenderfilen och visar det eller kör det.

Om alarmet redan ska aktiveras, tar &kalarm; sedan bort alla schemalagda händelser för alarmet fram till nuvarande tid, och om inga upprepningar av alarmet fortfarande finns kvar, så tas alarmet bort från kalenderfilen. Om alarmet inte ska aktiveras ännu, så lämnas dess schemalagda händelser oförändrade.

Väljaren kalenderfil används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.

Det gamla namnet på den här funktionen, `displayMessage`, har behållits för kompatibilitet, men alla nya program ska använda `triggerEvent`.

handleEvent

#### handleEvent

aktivera eller avbryt ett redan schemalagt alarm.

    void handleEvent(const QString& kalenderfil, const QString& händelse-ID)

##### Parametrar

`kalenderfil`

  Anger webbadressen för kalenderfilen som innehåller händelsen som ska visas/köras eller avbrytas.

`händelse-ID`

  Anger ett unikt ID för händelsen som ska visas/köras eller avbrytas, som är lagrad i kalenderfil.

##### Beskrivning

`handleEvent()` är ett &DCOP;-anrop för att visa/köra eller avbryta det angivna alarmet. &kalarm; hämtar alarmet från kalenderfilen och avgör vilken åtgärd som ska utföras beroende på när alarmet ska aktiveras.

- Om alarmet ännu inte ska aktiveras, händer ingenting.

- Om alarmet ska aktiveras, beter det sig som följer. Om flaggan för att avbryta sena alarm är satt och alarmet är sent, dvs. den schemalagda tiden för att visa det var tidigare än en minut, visar eller kör &kalarm; inte alarmet, annars visar eller kör &kalarm; alarmet. Om inga upprepningar av alarmet fortfarande är schemalagda, tar &kalarm; sedan bort alarmet från kalenderfilen.

Väljaren kalenderfil används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.

scheduleMessage

#### scheduleMessage

schemalägg ett nytt alarm.

    bool scheduleMessage(const QString& meddelande, const QDateTime& datum_tid, const QColor& bg, const QColor& fg, const QFont& teckensnitt, int flaggor, const QString& ljudadress, int påminnelse, const QString& upprepning)

    bool scheduleMessage(const QString& meddelande, const QDateTime& datum_tid, const QColor& bg, const QColor& fg, const QFont& teckensnitt, int flaggor, const QString& ljudadress, int påminnelse, const QString& upprepning)

    bool scheduleMessage(const QString& meddelande, const QDateTime& datum_tid, const QColor& bg, const QColor& fg, int flaggor, const QString& ljudadress, int påminnelse, int enkel_upprepningstyp, int intervall, int antal_upprepningar)

    bool scheduleMessage(const QString& meddelande, const QDateTime& datum_tid, const QColor& bg, const QColor& fg, int flaggor, const QString& ljudadress, int påminnelse, int enkel_upprepningstyp, int intervall, const QDateTime& sluttid)

##### Parametrar

`meddelande`

  Anger texten för meddelandet som ska schemaläggas.

`datum_tid`

  Anger det schemalagda datumet och tiden då meddelandet ska visas.

`bg`

  Anger bakgrundsfärgen för att visa meddelandet.

`fg`

  Anger förgrundsfärgen för att visa meddelandet.

`teckensnitt`

  Anger teckensnittet för att visa meddelandet.

`flaggor`

  Anger logiskt eller av de önskade flaggorna för alarmmeddelandet. Flaggbitarna är definierade i klassen KAlarmEvent i `alarmevent.h`

`ljudadress`

  Anger namn eller webbadressen för en ljudfil vars innehåll ska spelas när meddelandet visas.

`påminnelse`

  Anger antal minuter i förväg innan huvudalarmet och varje upprepning (om det finns någon) som påminnelsen ska visas. Ange 0 om ingen påminnelse krävs.

`upprepning`

  Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av RFC2445. Till exempel skulle FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.

`enkel_upprepningstyp`

  Anger alarmets upprepningstyp. De tillåtna värdena är MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De definieras i klassen KAlarmEvent i `alarmevent.h`.

`intervall`

  Anger antalet perioder (minuter/dagar/veckor/månader/år) mellan upprepningar av alarmmeddelandet.

`antal_upprepningar`

  Anger antalet gånger som alarmmeddelandet ska visas. Ange -1 för att upprepa alarmet för evigt.

##### Beskrivning

`scheduleMessage()` är ett &DCOP;-anrop för att schemalägga det angivna alarmmeddelandet för visning vid det angivna datumet och tiden. Det har flera former. De två mest generella formerna tillåter att en godtycklig upprepning anges. Använd dem också för alarm som inte upprepas. De övriga formerna tillhandahåller bekväm åtkomst till en begränsad mängd upprepningstyper, den ena anger ett upprepningsantal och den andra en sluttid, båda amvänder standardteckensnittet.

Om den schemalagda tiden (inklusive eventuella upprepningar) redan har gått ut, visar &kalarm; omedelbart meddelandet, eller ignorerar begäran om flaggan LATE_CANCEL är satt. Om den schemalagda tiden (eller en upprepning) är i framtiden, lägger &kalarm; till alarmmeddelandet i kalenderfilen för att visas senare.

Använd en kodsekvens som liknar den följande för att ange data för parametrarna i &DCOP;-anropet till `scheduleMessage()` för ett alarm som inte upprepas, eller för att alarm som upprepas regelbundet med iCalendar-syntax för att ange upprepningen:

    QString message, audioFile, recurrence;
    QDateTime dateTime;
    QColor bgColor, fgColor;
    Q_UINT32 flags;
    Q_INT32 reminder;
    . . .
    QByteArray data;
    QDataStream arg(data, IO_WriteOnly);
    arg << message;
    arg.writeRawBytes((char*)&dateTime, sizeof(QDateTime));
    arg.writeRawBytes((char*)&bgColour, sizeof(QColor));
    arg.writeRawBytes((char*)&fgColour, sizeof(QColor));
    arg << flags << audioFile << reminder << recurrence;

Använd en kodsekvens som liknar den följande för att ange data för parametrarna i &DCOP;-anropet till `scheduleMessage()` för ett alarm som upprepas regelbundet utan att använda iCalendar-syntax:

    QString message, audioFile;
    QDateTime dateTime;
    QColor bgColor, fgColor;
    Q_UINT32 flags;
    Q_INT32 reminder, repeatType, repeatCount, repeatInterval;
    . . .
    QByteArray data;
    QDataStream arg(data, IO_WriteOnly);
    arg << message;
    arg.writeRawBytes((char*)&dateTime, sizeof(QDateTime));
    arg.writeRawBytes((char*)&bgColour, sizeof(QColor));
    arg.writeRawBytes((char*)&fgColour, sizeof(QColor));
    arg << flags << audioFile << reminder << repeatType << repeatCount << repeatInterval;

scheduleFile

#### scheduleFile

schemalägg ett nytt alarm som visar innehållet i en text- eller bildfil.

    bool scheduleFile(const QString& webbadress, const QDateTime& datum_tid, const QColor& bg, int flaggor, const QString& ljudadress, int påminnelse, const QString& upprepning)

    bool scheduleFile(const QString& webbadress, const QDateTime& datum_tid, const QColor& bg, int flaggor, const QString& ljudadress, int påminnelse, int enkel_upprepningstyp, int intervall, int antal_upprepningar)

    bool scheduleFile(const QString& webbadress, const QDateTime& datum_tid, const QColor& bg, int flaggor, const QString& ljudadress, int påminnelse, int enkel_upprepningstyp, int intervall, const QDateTime& sluttid)

##### Parametrar

`webbadress`

  Anger namn eller webbadressen för text- eller bildfilen vars innehåll ska visas i meddelandet som schemaläggs.

`datum_tid`

  Anger det schemalagda datumet och tiden då filen ska visas.

`bg`

  Anger bakgrundsfärgen för att visa filen.

`flaggor`

  Anger logiskt eller av de önskade flaggorna för alarmmeddelandet. Flaggbitarna är definierade i klassen KAlarmEvent i `alarmevent.h`

`ljudadress`

  Anger namn eller webbadressen för en ljudfil vars innehåll ska spelas när meddelandet visas.

`påminnelse`

  Anger antal minuter i förväg innan huvudalarmet och varje upprepning (om det finns någon) som påminnelsen ska visas. Ange 0 om ingen påminnelse krävs.

`upprepning`

  Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av RFC2445. Till exempel skulle FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.

`enkel_upprepningstyp`

  Anger alarmets upprepningstyp. De tillåtna värdena är MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De definieras i klassen KAlarmEvent i `alarmevent.h`.

`intervall`

  Anger antal perioder (minuter/dagar/veckor/månader/år) mellan upprepningar av alarmet.

`antal_upprepningar`

  Anger antalet gånger som filen ska visas. Ange -1 för att upprepa alarmet för evigt.

##### Beskrivning

`scheduleFile()` är ett &DCOP;-anrop för att schemalägga en angiven text- eller bildfil för visning vid det angivna datumet och tiden. Utom att ange ett filnamn eller webbadress, är användningen identisk med `scheduleMessage` - se beskrivningen av den funktionen för ytterligare detaljer.

scheduleCommand

#### scheduleCommand

schemalägg ett nytt alarm som kör ett skalkommando.

    bool scheduleCommand(const QString& commandorad, const QDateTime& datum_tid, int flaggor, const QString& upprepning)

    bool scheduleCommand(const QString& kommandorad, const QDateTime* datum_tid, int flaggor, int enkel_upprepningstyp, int intervall, int antal_upprepningar)

    bool scheduleCommand(const QString& kommandorad, const QDateTime* datum_tid, int flaggor, int enkel_upprepningstyp, int intervall, const QDateTime& sluttid)

##### Parametrar

`kommandorad`

  Anger skalkommandot vars körning ska schemaläggas.

`datum_tid`

  Anger det schemalagda datumet och tiden då kommandot ska köras.

`flaggor`

  Anger logiskt eller av de önskade flaggorna för alarmmeddelandet. Flaggbitarna är definierade i klassen KAlarmEvent i `alarmevent.h`, utom att flaggan BEEP ignoreras.

`upprepning`

  Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av RFC2445. Till exempel skulle FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.

`enkel_upprepningstyp`

  Anger alarmets upprepningstyp. De tillåtna värdena är MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De definieras i klassen KAlarmEvent i `alarmevent.h`.

`intervall`

  Anger antal perioder (minuter/dagar/veckor/månader/år) mellan upprepningar av alarmet.

`antal_upprepningar`

  Anger antalet gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt.

##### Beskrivning

`scheduleCommand()` är ett &DCOP;-anrop för att schemalägga en angiven skalkommandorad för körning vid det angivna datumet och tiden. Utom att ange en kommandorad och utelämna meddelandets färg och ljudfil, är användningen identisk med `scheduleMessage` - se beskrivningen av den funktionen för ytterligare detaljer.

scheduleEmail

#### scheduleEmail

schemalägg ett nytt alarm som skickar e-post.

    bool scheduleEmail(const QString& adresser, const QString& rubrik, const QString& meddelande, const QString& bilagor, const QDateTime& datum_tid, int flaggor, const QString& upprepning)

    bool scheduleEmail(const QString& adresser, const QString& rubrik, const QString& meddelande, const QString& bilagor, const QDateTime& datum_tid, int flaggor, int enkel_upprepningstyp, int intervall, int antal_upprepningar)

    bool scheduleEmail(const QString& adresser, const QString& rubrik, const QString& meddelande, const QString& bilagor, const QDateTime& datum_tid, int flaggor, int enkel_upprepningstyp, int intervall, const QDateTime& sluttid)

##### Parametrar

`adresser`

  Anger mottagarens e-postadress. Ange flera adresser genom att skilja dem åt med kommatecken.

`rubrik`

  Anger e-postens rubrikrad.

`meddelande`

  Anger e-postens meddelandetext.

`bilagor`

  Anger webbadresser för filer som ska biläggas e-posten. Avdela flera webbadresser med kommatecken.

`datum_tid`

  Anger det schemalagda datumet och tiden då e-post ska skickas.

`flaggor`

  Anger logiskt eller av de önskade flaggorna för alarmmeddelandet. Flaggbitarna är definierade i klassen KAlarmEvent i `alarmevent.h`

`upprepning`

  Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av RFC2445. Till exempel skulle FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.

`enkel_upprepningstyp`

  Anger alarmets upprepningstyp. De tillåtna värdena är MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De definieras i klassen KAlarmEvent i `alarmevent.h`.

`intervall`

  Anger antal perioder (minuter/dagar/veckor/månader/år) mellan upprepningar av alarmet.

`antal_upprepningar`

  Anger antalet gånger som e-post ska skickas. Ange -1 för att upprepa alarmet för evigt.

##### Beskrivning

`scheduleEmail()` är ett &DCOP;-anrop för att schemalägga att skicka e-post vid det angivna datumet och tiden. Utom att ange en e-postrubrik och innehåll, och utelämna meddelandets färg och ljudfil, är användningen identisk med `scheduleMessage` - se beskrivningen av den funktionen för ytterligare detaljer.

### Kommandoradsgränssnitt

Kommandoradsväljare tillhandahålls för att göra det möjligt för andra program (som alarmdemonen) att starta &kalarm; om det inte redan kör, för att visa eller avbryta schemalagda meddelanden, eller schemalägga nya meddelanden. Orsaken att kommandoradsväljare används för detta syfte är att om &kalarm; startades utan kommandoradsväljare och &DCOP;-anrop sedan skickades, skulle det starta i det förvalda grafiska läget, vilket helt klart inte är önskvärt för en begäran mellan program.

Program bör först kontrollera om &kalarm; redan kör. Om detta är fallet, bör de istället använda &DCOP;-anrop för att begära de här åtgärderna.

Kommandoradsväljarna för att schemalägga ett nytt alarmmeddelande beskrivs i kapitlet Att använda &kalarm;. Alternativen för att visa och avbryta schemalagda meddelanden är följande:

Normala användare kan också, om de så önskar, använda de här kommandoradsväljarna (med antagandet att de kan ange den nödvändiga väljarinformationen).

Alternativ | Beskrivning
--- | ---
`--calendarURL webbadress` | Använd kalenderfilen med angiven webbadress. Det här alternativet används bara för integritetskontroll: Om webbadressen inte anger &kalarm;s nuvarande förvalda kalenderfil, så ignoreras begäran.
`--cancelEvent händelse-ID` | Avbryt händelsen med med angivet händelse-ID.
`--triggerEvent händelse-ID` | Aktivera händelsen med angivet händelse-ID. Åtgärden som utförs är samma som för triggerEvent() &DCOP;-anropet.
`--handleEvent händelse-ID` | Aktivera eller avbryt händelsen med angivet händelse-ID. &kalarm; avgör vilken åtgärd som behövs på samma sätt som för handleEvent() &DCOP;-anropet.

`--cancelEvent`, `--triggerEvent` och `--handleEvent` är ömsesidigt uteslutande. `--calendarURL` är valfri, men kan bara användas med en av de andra tre väljarna.

Några exempel:

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

## Vanliga frågor

&reporting.bugs; &updating.documentation;

Vilka konfigurationsfiler använder &kalarm;?

Filen `$KDEHOME/share/config/kalarmrc` innehåller &kalarm;s inställningar.

Kalenderfilen som lagrar dina schemalagda alarmmeddelanden heter `$KDEHOME/share/apps/kalarm/calendar.ics`, om inte en annan kalenderfil anges i inställningsfilen med posten `Calendar` i avdelningen `General`.

Om du byter kalenderfil in inställningsfilen, måste du också redigera alarmdemonens konfigurationsfil `clients` för att ta bort referensen till den gamla kalenderfilen. Det här ska göras när alarmdemonen inte kör, för att undvika att din ändring skrivs över.

Kalenderfilen som lagrar dina utgångna alarmmeddelanden heter `$KDEHOME/share/apps/kalarm/expired.ics`, om inte en annan kalenderfil anges i inställningsfilen.

Detaljinformation om alarm som för närvarande visas, lagras i kalenderfilen `$KDEHOME/share/apps/kalarm/displaying.ics`.

Vilka konfigurationsfiler använder alarmdemonen?

Filen `$KDEHOME/share/config/kalarmdrc` innehåller alarmdemonens inställningar.

Filen `$KDEHOME/share/apps/kalarmd/clients` innehåller värden för klientprogram som tidigare har registrerats hos alarmdemonen, och deras kalenderfiler.

Vad är programnamnen för &kalarm; och alarmdemonen?

&kalarm;s programnamn är kalarm och alarmdemonens programnamn är kalarmd. Dessutom, men bara i &kde;-versioner innan 3.1, finns det ett litet program som heter kalarmautostart, vars funktion är att starta &kalarm;s ikon i systembrickan vid inloggning.

## Tack till och licens

&kalarm;

Program copyright 2001, 2002, 2003 David Jarvie software@astrojar.org.uk

Upphovsmän till alarmdemonen:

- Preston Brown pbrown@kde.org

- David Jarvie software@astrojar.org.uk

- Cornelius Schumacher schumacher@kde.org

Dokumentation copyright 2001, 2002, 2003 David Jarvie software@astrojar.org.uk

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

Tack till upphovsmannen för programmet KAlarm för &kde; 1, Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, som vänligen gick med på att det här &kde;2/&kde;3 programmet fick använda namnet &kalarm;.

&underFDL; &underGPL;

## Installation

### Hur man skaffar &kalarm;

&install.intro.documentation;

&kalarm; är tillgängligt för &kde;2 och som ett fristående paket för &kde;3 från http://www.astrojar.org.uk/linux/kalarm.html.

### Krav

&kalarm; kräver att de vanliga &kde;-biblioteken är installerade (`kdelibs`-paketet). För att kompilera från källkod, behöver du också &Qt; och `kdelibs` utvecklingspaket. X11-utvecklingspaketet, om det finns, används för att förbättra &kalarm;s möjlighet att fungera i &kde; utan en systembricka.

&kalarm; använder ungefär 12 Mibyte och alarmdemonen använder ungefär 2,5 Mibyte minne för att köra, men detta kan variera beroende på plattform och inställningar.

Du hittar en lista på ändringar i filen `ChangeLog`, eller på http://www.astrojar.org.uk/linux/kalarm.html.

### Kompilering och installation

Om du inte kan hitta ett lämpligt förkompilerat binärpaket, måste du kompilera &kalarm; själv från källkodsfiler. Hämta källkodspaketet `kdepim-x.x.tar.gz` eller `kalarm-x.x.tar.gz` (eller liknande), beroende på om du vill installera &package; eller bara &kalarm;. Packa upp det i en ny katalog med ett kommando som liknar ``tar` `xvfj paket.tar.bz2`` och gå till katalogen som har skapats.

&install.compile.documentation;

Om du har mer än en version av &kde; installerad (t.ex &kde;2 och &kde;3), kan &kalarm; möjligen installeras i fel &kde;-katalog. Om det behövs kan du ange &kde;-katalogen som en parameter till ``./configure`` . Om du till exempel har installerat &kde; i `/opt/kde2`:

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

### Anpassning

Ingen särskild anpassning krävs för att ställa in &kalarm; för att köra på &kde;-skrivbordet. Så fort du har kört &kalarm; första gången, startas alarmdemonen varje gång du loggar in, för att bevaka schemalagda alarm.

För att köra &kalarm; på ett annat skrivbord än &kde;, är det viktigaste kravet att försäkra sig om att alarmdemonen körs automatiskt så fort du loggar in. Mer detaljerade instruktioner finns i filen `INSTALL` som distribueras med &kalarm;.

&documentation.index;