Interface da Linha de Comandos
As opções da linha de comandos são disponibilizadas para permitir aos outros programas (como o servidor de alarmes) iniciarem o KAlarm se não estiver já a correr, para que possam despoletar ou cancelar os alarmes agendados ou ainda para agendar alarmes novos. A razão para usar as opções da linha de comandos para este fim é que, se o KAlarm fosse arrancado sem nenhuns parâmetros da linha de comandos e lhe fossem então enviados pedidos de DCOP, ele iria iniciar no seu modo gráfico por omissão, o que é claramente indesejável para um pedido entre programas.
Os programas deverão verificar primeiro se o KAlarm já está a correr; se estiver, então aí deverão usar chamadas de DCOP para efectuar essas operações.
As opções da linha de comandos para agendar um alarme novo são as descritas no capítulo sobre a Operação com a Linha de Comandos. As opções para disparar e cancelar os alarmes agendados são as seguintes:
Os utilizadores normais poderão também, se o desejarem, usar estas opções da linha de comandos (assumindo que podem passar a informação dos parâmetros necessários).
| Opção | Descrição |
|---|---|
--cancelEvent | Cancela o alarme com o identificador de evento indicado. |
--triggerEvent | Dispara o evento com o identificador indicado. A acção tomada é a mesma da chamada de DCOP triggerEvent(). |
--handleEvent | Dispara ou cancela o evento com o identificador indicado. O KAlarm determina a acção a tomar da mesma forma que é usada na chamada de DCOP handleEvent(). |
O --cancelEvent, o --triggerEvent e o --handleEvent são mutuamente exclusivos.
Exemplos:
%kalarm--triggerEventKAlarm-387486299.702%kalarm--cancelEventKAlarm-388886299.793
