Kommandoradsväljare
Innehållsförteckning
När kommandoradsväljare anges, visar inte KAlarm listan med schemalagda alarm som beskrivs ovan under Använda KAlarm. Speciella kommandoradsväljare för KAlarm kan användas för att utföra följande operationer:
schemalägg ett nytt alarm
styr KAlarms 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.
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 | Ange namnet eller webbadressen för en fil som ska bifogas e-post. Väljaren kan upprepas efter behov. --mail måste anges tillsammans med den här väljaren. |
--auto-close | Stäng automatiskt alarmfönstret efter perioden --late-cancel har gått ut. --late-cancel måste anges med den här välljaren. |
-b, --beep | Avge ett hörbart ljud när meddelandet visas. --speak, --play och --play-repeat kan inte anges med den här väljaren. |
--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 | Visa meddelandet med bakgrundsfärgen enligt det angivna Qt™-färgnamnet eller hexadecimala koden 0xRRGGBB. |
-C, --colorfg, --colourfg | Visa meddelandet med förgrundsfärgen enligt det angivna Qt™-färgnamnet eller hexadecimala koden 0xRRGGBB. |
-d, --disable | Stäng av alarmet. Det visas inte förrän det har aktiverats manuellt. |
-e, --exec | Anger ett skalkommando som ska köras. Om angiven, så måste den här väljaren vara den sista väljaren på KAlarms 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. |
-E, --exec-display | Anger ett skalkommando som ska köras för att skapa alarmmeddelandets text. Om angiven, så måste den här väljaren vara den sista väljaren på KAlarms kommandorad. Alla efterföljande kommandoradsväljare tolkas som om de utgör kommandoraden som ska köras. --exec, --file och --mail kan inte anges tillsammans med den här väljaren. |
-f, --file | Ange namnet eller webbadressen för en text- eller bildfil vars innehåll ska användas som alarmmeddelande. --exec, --exec-display och --mail kan inte anges, och meddelande får inte finnas med den här väljaren. |
-F, --from-id | Använd angiven KMail-identitet som avsändare av brevet. --mail måste anges med den här väljaren. |
-i, --interval | 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). Om --recurrence också anges, tillåts inte Y (år) och M (månader). Krävs om --repeat eller --until anges. |
-k, --korganizer | Visa alarmet som en händelse i KOrganizers aktiva kalender. |
-l, --late-cancel | Avbryt alarmet om det inte kan visas inom angiven period efter den riktiga tiden. Perioden period anges med samma format som beskrivs för --reminder. Standardvärde för period är en minut. |
-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 | Skicka e-post till angiven adress. Alternativet kan upprepas om nödvändigt. --exec, --exec-display 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. |
-p, --play | Ange namnet eller webbadressen för en ljudfil som ska spelas en gång, antingen som ett ljudalarm eller när alarmmeddelandet visas. --play-repeat, --beep och --speak kan inte anges med den här väljaren. |
-P, --play-repeat | Ange namnet eller webbadressen för en ljudfil som ska spelas upprepade gånger, antingen till Stoppa uppspelning används, eller medan alarmmeddelandet visas. --play, --beep och --speak kan inte anges med den här väljaren. |
--recurrence | 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”. --until kan inte anges tillsammans med den här väljaren. |
-r, --repeat | Ställer in antal gånger alarmet ska visas, eller om en upprepning anges med --recurrence, antal gånger alarmet ska visas varje gång --recurrence aktiverar det (dvs. en repetition inom en upprepning). Om --recurrence inte finns med, kan -1 anges för att repetera alarmet i oändlighet. --interval måste, och --until kan inte, anges tillsammans med den här väljaren. |
-R, --reminder | 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: W (veckor) eller D (dagar). Den här väljaren kan inte anges med --exec,--mail eller --reminder-once. |
--reminder-once | Visa ett påminnelsealarm en gång den angivna tidsrymden innan den första upprepningen av alarmet. Ingen påminnelse visas innan efterföljande upprepningar (om det finns några). Väljaren kan inte anges med --exec, --mail eller --reminder. |
-s, --speak | Läs upp meddelandet när det visas. Alternativet kräver att KTTSD är installerad och inställd, tillsammans med en fungerade talsyntes. --beep, --play och --play-repeat kan inte anges med den här väljaren. |
-S, --subject | E-postens rubrik. --mail måste anges med den här väljaren. |
-t, --time | Visa alarmet det datum eller det datum och den tid som anges. Ange ett datum utan tid med formatet åååå-mm-dd [TZ]. Ange ett datum och en tid med [[[åååå-]mm-]dd-]tt:mm [TZ] (när det utelämnas får datumkomponenterna dagens datum). Om ingen tidszon anges, används systemets lokala tidszon. Om en tidszonangivelse “TZ” finns med, kan det vara namnet på en systemtidszon (t.ex. “Europe/London”), “UTC” som representerar tidszonen UTC, eller “Clock” för att använda den lokala datorns klocka och ignorera tidszoner. |
-v, --volume | Ställ in ljudvolym för att spela ljudfilen. Väljaren kan bara anges när --play eller --play-repeat anges. |
-u, --until | Upprepa alarmet till det datum eller datum/tid som anges. Ange ett datum eller ett datum och en tid med samma format som för --time. Observera att om --time anges, hämtas tidszonen från dess värde, och någon tidszon kan inte ingå i värdet för --until. --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, --exec, --exec-display, --play eller --play-repeat måste anges. Utom enligt vad som anges ovan är alla väljare valfria.
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-cred-t27-22:00"Kom ihåg att \nSTOPPA"%kalarm-c0xFF0000-t27-22:00"Kom ihåg att\nSTOPPA"
