Kommandolinjegrænseflade |
forrige | Udviklingsguide for KAlarm | næste |
Kommandolinjeflag er der for at gøre det muligt for andre programmer (såsom alarmdæmonen) at starte KAlarm hvis den ikke allerede kører, til at vise eller annullere skemalagte beskeder, eller skemalægge nye beskeder. Grunden til at kommandolinjeflag bruges til dette formål er at hvis KAlarm startedes uden kommandolinjeflag og DCOP-kald siden blev sendt, så ville det starte i den forvalgte grafiske tilstand, hvilket helt klart ikke er ønskværdigt for en forespørgsel mellem programmer.
Programmer bør først kontrollere om KAlarm allerede kører. Hvis dette er tilfældet, bør de i stedet bruge DCOP-kald til at bede om disse handlinger.
Kommandolinjeflagene til at skemalægge en ny alarmbesked beskrives i kapitlet Kommandolinjeoperation. Valgmulighederne for at udløse og annullere skemalagte alarmer er følgende:
Normale brugere kan også, hvis de ønsker det, bruge disse kommandolinjeflag (under antagelse af at de kan angive den nødvendige parameterinformation).
Tilvalg | Beskrivelse |
---|---|
--calendarURL | Brug kalenderfilen med angiven URL. Dette bruges kun til integritetskontrol: Hvis URL'en ikke angiver KAlarms nuværende standardkalenderfil, så ignoreres forespørgslen. |
--cancelEvent | Annullér begivenheden med med den angivne begivenheds-ID. |
--triggerEvent | Udløs begivenheden med den angivne begivenheds-ID. Handlingen som udføres er den samme som for triggerEvent() DCOP-kaldet. |
--handleEvent | Udløs eller annullér begivenheden med den angivne begivenheds-ID. KAlarm afgør hvilken handling der behøves på samme måde som for handleEvent() DCOP-kaldet. |
--cancelEvent
, --triggerEvent
og --handleEvent
er gensidigt udelukkende. --calendarURL
er valgfri, men kan kun bruges med et af de andre tre flag.
Nogle eksempler:
%
kalarm
--triggerEvent
KAlarm-387486299.702
--calendarURL
file:/home/zaphod/hydra.ics
%
kalarm
--cancelEvent
KAlarm-388886299.793
forrige | hjem | næste |
scheduleEmail | op | Spørgsmål og svar |