O Manual do KAlarm

David JarvieDesenvolvimento: David Jarvie

Tradução: José Pires

O Manual do KAlarm

2

Conteúdo

1 Introdução 6

2 Utilizar o KAlarm 82.1 Tipos de Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.1.1 Tratamento de Erros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82.2 Lista de Alarmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.2.1 Alterar a Aparência da Lista de Alarmes . . . . . . . . . . . . . . . . . . . . 9

2.2.2 Alarmes Arquivados . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.2.3 Procurar na Lista de Alarmes . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.3 Criar e Manipular Alarmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.3.1 Criar um Novo Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102.3.2 Modificar um Alarme Existente . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3.3 Apagar/Reactivar um alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.3.4 Activar/Desactivar um Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.3.5 Configurar um Alarme para Acordar da Suspensão . . . . . . . . . . . . . . 12

2.3.6 Aceitar um Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.3.7 Modelos de Alarmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.3.7.1 Configurar os Modelos . . . . . . . . . . . . . . . . . . . . . . . . . 13

2.3.7.2 Janela de Edição do Modelo . . . . . . . . . . . . . . . . . . . . . . 13

2.3.8 Calendários de Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.3.8.1 Tipos e Opções do Calendário . . . . . . . . . . . . . . . . . . . . . 14

2.3.8.2 Usar os Calendários . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.3.9 Importar Alarmes de Calendários Externos . . . . . . . . . . . . . . . . . . . 16

2.3.10 Exportar Alarmes para Calendários Externos . . . . . . . . . . . . . . . . . . 17

2.3.11 Importar Aniversários do KAddressBook . . . . . . . . . . . . . . . . . . . . 17

2.3.12 Desfazer / Refazer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2.4 A janela de Edição do Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

2.4.1 Acção do Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

2.4.1.1 Alarmes Visíveis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.4.1.2 Alarmes de Comandos . . . . . . . . . . . . . . . . . . . . . . . . . 212.4.1.3 Alarmes por E-Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

2.4.1.4 Alarmes de Áudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

O Manual do KAlarm

2.4.2 Adiamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.4.3 Hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.4.4 Chamada de Atenção . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.4.5 Cancelamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.4.6 Recorrência . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

2.4.6.1 Sub-Repetição . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

2.4.7 Outros Controlos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262.5 Janela de Mensagem de Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

2.5.1 Posicionamento das Janelas de Mensagens . . . . . . . . . . . . . . . . . . . 28

2.6 Operação na Bandeja do Sistema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

2.6.1 Mostrar o KAlarm na Bandeja do Sistema . . . . . . . . . . . . . . . . . . . . 29

2.7 Actualizar os Alarmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.8 Activar/Desactivar os Alarmes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

2.8.1 Activar a Monitorização de Alarmes . . . . . . . . . . . . . . . . . . . . . . . 302.8.2 Desactivar a Monitorização de Alarmes . . . . . . . . . . . . . . . . . . . . . 302.8.3 Activar/Desactivar os Alarmes Individualmente . . . . . . . . . . . . . . . 31

2.9 Acordar da Suspensão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

2.10 Sair do KAlarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

3 Configurar o KAlarm 333.1 Geral . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.2 Data & Hora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343.3 Armazenamento . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.4 E-mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.5 Ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363.6 Editar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

4 Operação com a Linha de Comandos 384.1 Escalonar um Novo Alarme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384.2 Outras Opções . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

5 Guia de Programador do KAlarm 445.1 A Interface de D-Bus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

5.1.1 cancelEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445.1.2 triggerEvent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

5.1.3 scheduleMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

5.1.4 scheduleFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475.1.5 scheduleCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495.1.6 scheduleEmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515.1.7 scheduleAudio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535.1.8 edit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545.1.9 editNew . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555.1.10 list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

5.2 Interface da Linha de Comando . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

6 Perguntas e Respostas 58

7 Créditos e Licença 60

4

Resumo

O KAlarm é um escalonador pessoal de alarmes, comandos e mensagens de e-mail do KDE.

O Manual do KAlarm

Capítulo 1

Introdução

O KAlarm permite-lhe escalonar a visualização das mensagens de alarme pessoais, a reproduçãode ficheiros de som, a execução de comandos e o envio de e-mails.

No seu modo gráfico predefinido, o KAlarm mostra a lista de alarmes pendentes, apresentandoas suas horas e os seus detalhes. O utilizador pode criar novos alarmes ou seleccionar alarmesexistentes para modificar ou remover. Poderá ainda, opcionalmente, ver os alarmes que expira-ram.Ao configurar um alarme, poderá escolher se este se deverá repetir e se o mesmo deverá sercancelado se não puder ser activado na hora agendada. Nos alarmes visíveis, poderá escrever otexto da mensagem de alarme, indicar um ficheiro de texto ou de imagem a mostrar ou indicarum comando para ser executado, cujo resultado será apresentado. Poderá também escolher acor da mensagem de alarme, se esta se deve repetir, se deverá tocar um som ou falar o texto doalarme.Os alarmes também podem ser escalonados a partir da linha de comandos, ou através de chama-das D-Bus de programas.

Quando uma mensagem de alarme atinge a sua hora, é mostrada em cada um dos ecrãs paragarantir que você a vê. A janela da mensagem mostra a hora para a qual o alarme foi agendado.Tem normalmente uma opção de adiamento para lhe perguntar se o alarme deverá ser mostradode novo mais tarde. Um exemplo de uma mensagem de alarme:

6

O Manual do KAlarm

Quando o alarme tem atribuído um comando para executar ou uma mensagem de e-mail paraenviar, o KAlarm não mostra nada.

O KAlarm mostra normalmente um ícone na bandeja do sistema, ainda que este possa ser escon-dido, se o desejar.

7

O Manual do KAlarm

Capítulo 2

Utilizar o KAlarm

Quando é executado sem parâmetros na linha de comandos, o KAlarm começa no modo gráficoe mostra a lista actual de alarmes pendentes.

DICATodos os campos incrementais do KAlarm têm uma funcionalidade de aceleração. Para que a mu-dança de valores use incrementos mais elevados, mantenha a tecla Shift pressionada, enquantocarrega nos campos incrementais.

2.1 Tipos de Alarme

As funções básicas, disponíveis nos diferentes tipos de alarmes que o KAlarm oferece, são:

• Os alarmes visíveis apresentam uma mensagem de texto escrita por si ou então o conteúdode um ficheiro de texto ou de imagem, ou ainda o resultado textual de um comando que éexecutado quando o alarme for desencadeado. Para além de mostrar um destes itens, pode-rão também reproduzir ficheiros de áudio, sintetizar o seu texto ou emitir um simples apito.Poderá também indicar os comandos a executar antes e depois da mensagem de alarme serapresentada.

• Os comandos de alarme executam um comando ou um programa indicado por si. Não éapresentado nada, a menos que ocorra algum erro.

• Os alarmes por e-mail enviam um e-mail. Nada é apresentado, a menos que ocorra algumerro.

• Os alarmes de áudio tocam um ficheiro de som. Nada é apresentado, a menos que ocorraalgum erro.

2.1.1 Tratamento de Erros

Se ocorrer algum erro ao despoletar um alarme, será apresentada uma mensagem de erro (amenos que tenha dito explicitamente para não mostrar esse tipo de mensagens de novo).

Se ocorreu um erro de execução da última vez que um alarme de comandos foi despoletado, éapresentado um ponto de exclamação branco sobre fundo vermelho, na coluna da cor da mensa-gem. Os detalhes do erro são apresentados numa dica, caso posicione o cursor sobre essa linha

8

O Manual do KAlarm

na lista de alarmes. As mesmas indicações de erros são apresentadas para os alarmes visíveis,caso ocorra um erro de execução para um comando pré- ou pós-alarme, caso sejam definidos najanela de Acções Especiais, exceptuando o facto que a coluna da cor não muda para um fundovermelho.

2.2 Lista de Alarmes

A janela principal do KAlarm mostra a lista actual de alarmes pendentes, mostrando as suashoras, intervalos de repetição e textos de mensagens, os nomes dos ficheiros a apresentar, oscomandos a executar ou os assuntos das mensagens de e-mail. (Para um alarme recorrente ouum alarme com uma chamada de atenção, a hora apresentada é a sua próxima hora agendada).Um ícone que se encontra à esquerda de cada texto/ficheiro/comando/assunto de e-mail doalarme indica o seu tipo.

Para um alarme repetitivo, a lista mostra a sua próxima hora de activação e o seu intervalo básicode repetição (isto é ‘1 Dia’ para uma repetição diária, ‘3 Semanas’ para uma repetição que sedespoleta na Segunda e na Quarta na terceira semana e o ‘Autenticação’ para um alarme que serepete depois da autenticação).

Se ocorreu um erro de execução da última vez que foi desencadeado um alarme de comando,ou da última vez que foi executado um comando pré- ou pós-alarme, será apresentada umaindicação do erro na coluna da cor, como se encontra descrito acima no Tratamento de Erros.

2.2.1 Alterar a Aparência da Lista de Alarmes

Os alarmes poderão ser ordenados por data/hora, intervalo de repetição, cor ou texto se carregarna barra de título da coluna apropriada. Para inverter o critério de ordenação, carregue no títuloda coluna de novo.Você poderá, opcionalmente, mostrar o tempo restante até que cada alarme dispare, em conjuntocom ou em vez da hora agendada do alarme. Para mostrar ou esconder a coluna da hora doalarme, seleccione Ver → Mostrar as Horas dos Alarmes. Para mostrar ou esconder a colunacom o tempo que falta até disparar os alarmes, seleccione a opção Ver → Mostrar a Hora Até AosAlarmes. Pelo menos uma destas colunas é sempre visível.

Se usar diversos calendários de alarmes, poderá colorir os alarmes com diferentes cores para dis-tinguir o recurso a que pertencem, seleccionando uma cor de fundo diferente para cada recurso(ver em Usar os Calendários).

2.2.2 Alarmes Arquivados

Por omissão, o KAlarm guarda os alarmes durante um período limitado, logo que tenham expi-rado ou tenham sido removidos. (Mas repare que os alarmes que você apagar só são guardados

9

O Manual do KAlarm

se já tiverem sido disparados pelo menos uma vez.). Poderá controlar se o KAlarm guarda osalarmes expirados, e durante quanto tempo, na janela de Configuração.

Os alarmes arquivados poderão ser mostrados na lista de alarmes se seleccionar a opção Ver→ Mostrar os Alarmes Arquivados. Para os esconder de novo, desligue a opção Ver → Mostraros Alarmes Arquivados.

2.2.3 Procurar na Lista de Alarmes

Poderá procurar na lista de alarmes para descobrir os alarmes que contêm um determinado textode procura. Para invocar isto, seleccione a opção Editar → Procurar.... Na janela de procura,seleccione os tipos de alarmes que deseja procurar. Para continuar a procurar por mais alarmescorrespondentes, use a opção Editar → Procurar o Próximo ou Editar → Procurar o Anterior.

A procura é efectuada da seguinte forma:

• Alarmes de texto: é pesquisado o texto da mensagem.

• Alarmes de ficheiros: é pesquisado o local/URL do ficheiro.

• Alarmes de comandos: é pesquisada a linha de comandos ou o programa respectivo.

• Alarmes de e-mail: para além do assunto e do corpo da mensagem de e-mail, são pesquisadosos destinatários e os URLs dos anexos.

• Alarmes de áudio: é pesquisado o local/URL do ficheiro.

NOTASó os alarmes que aparecem de momento na lista de alarmes é que poderão ser seleccionados paraa pesquisa. Como tal, se desejar procurar nos alarmes expirados, terá primeiro de os mostrar comofoi descrito na secção acima.

2.3 Criar e Manipular Alarmes

2.3.1 Criar um Novo Alarme

Para criar um alarme novo, faça uma das seguintes acções, seleccionando depois o tipo do alarmena lista que aparece. Isto mostra a janela de Edição do Alarme através da qual irá configurar oalarme.

• Seleccione Ficheiro → Novo.

• Carregue com o botão direito no ícone da bandeja do sistema e escolha Novo Alarme no menude contexto.

• Carregue com o botão direito do rato na lista de alarmes e escolha Novo no menu de contexto.

Em alternativa, poderá criar alarmes novos pré-configurados a partir de várias fontes:

• Para basear o seu novo alarme num modelo previamente definido, siga as instruções na secçãode Modelos de Alarmes.

• Para basear o seu alarme num existente, escolha o alarme existente e seleccione a opção Fi-cheiro → Copiar. Isto abre a janela de Edição do Alarme já preenchida com uma cópia dosdetalhes do alarme seleccionado.

10

O Manual do KAlarm

• Para criar um alarme novo que mostre uma mensagem de e-mail existente, arraste a mensagemdo KMail para a janela principal do KAlarm ou para o seu ícone na bandeja do sistema. Depois,seleccione a opção Alarme Visível. Isto abre a janela de Edição do Alarme com a mensagemde e-mail completa (com o remetente, o destinatário, etc.) como texto do alarme.

• Para criar um alarme novo que mostre uma mensagem de e-mail existente, arraste a mensagemdo KMail para a janela principal do KAlarm ou para o seu ícone na bandeja do sistema. Depois,seleccione a opção Alarme de E-Mail. Isto abre a janela de Edição do Alarme com a mensagemde e-mail completa (com o remetente, o destinatário, etc.) como texto do alarme.

• Para criar um alarme novo que mostre um resumo de um item por-fazer existente, arraste esseitem do KOrganizer ou de outra aplicação para a janela principal do KAlarm ou para o seuícone na bandeja do sistema. Isto abre a janela de Edição do Alarme com o conteúdo do itempor-fazer como texto do alarme.

• Para criar um alarme novo de comandos, arraste o texto de um programa que comece por‘#!’ para a janela principal do KAlarm ou para o seu ícone na bandeja do sistema. Depois,seleccione a opção Alarme de Comando. Isto abre a janela de Edição do Alarme com o textodo programa.

• Para criar um alarme de visualização de um ficheiro, arraste um URL do mesmo para a janelaprincipal do KAlarm ou para o ícone da bandeja do sistema. Isto abre a janela de Edição doAlarme e configura o nome do ficheiro.

• Para criar um alarme de áudio, arraste um URL do mesmo para a janela principal do KAlarmou para o ícone da bandeja do sistema. Isto abre a janela de Edição do Alarme e configura onome do ficheiro.

• Para criar um alarme de mensagem de texto, arraste qualquer texto para a janela principal doKAlarm ou para o seu ícone na bandeja do sistema. Depois, seleccione a opção Alarme Visível.Isto abre a janela de Edição do Alarme com o texto do alarme.

• Você poderá criar automaticamente alarmes para os aniversários das pessoas que estejam noKAddressBook, como é descrito em Importar os Aniversários do KAddressBook.

2.3.2 Modificar um Alarme Existente

Para modificar um alarme pendente já existente (os alarmes expirados não poderão ser corrigi-dos), faça uma das seguintes coisas:

• Carregue duas vezes no seu item na lista de alarmes.

• Seleccione-o, carregando no item respectivo na lista de alarme. Depois seleccione a opçãoEditar → Editar.

• Carregue com o botão direito do rato no seu item da lista de alarmes e escolha a opção Editarno menu de contexto.

Isto mostra a janela de Edição do Alarme.

2.3.3 Apagar/Reactivar um alarme

Para apagar os alarmes existentes, seleccione um ou mais, carregando nos seus itens na lista dealarmes. Depois, faça uma das seguintes coisas:

• Seleccione Editar → Apagar.

• Carregue com o botão direito nos itens desejados na lista de alarmes e escolha a opção Apagardo menu de contexto.

11

O Manual do KAlarm

• Para os apagar sem qualquer mensagem de confirmação, carregue em Shift-Delete.

Quando você remove um alarme activo, este é guardado como um alarme expirado, desde que játenha disparado pelo menos uma vez antes de ser removido, e desde que os alarmes expiradossejam guardados de todo. (Use a janela de Configuração para controlar se e durante quantotempo os alarmes expirados serão guardados). Quando remover um alarme expirado ou umalarme activo que ainda não tenha disparado, este é removido de forma permanente.

Poderá reactivar um alarme removido na lista de alarmes expirados, desde que ainda não tenhaexpirado. Para o fazer, mostre primeiro os alarmes expirados, tal como está descrito em AlarmesArquivados. Depois:

• Seleccione um ou mais alarmes expirados, carregando nos itens respectivos na lista de alarmes.Depois, escolha a opção Acções → Reactivar.

• Carregue com o botão direito nos itens desejados na lista de alarmes e escolha a opção Reacti-var do menu de contexto.

2.3.4 Activar/Desactivar um Alarme

Veja a Activação/Desactivação dos Alarmes para saber como activar e desactivar os alarmes,quer individualmente quer como um todo.

2.3.5 Configurar um Alarme para Acordar da Suspensão

Veja em Acordar da Suspensão como configurar um alarme para reactivar o seu sistema a partirda suspensão ou hibernação.

2.3.6 Aceitar um Alarme

Veja a secção da Janela da Mensagem do Alarme para ver como aceitar os alarmes.

2.3.7 Modelos de Alarmes

Se deseja configurar com frequência alarmes semelhantes, poderá criar um modelo de alarmespara evitar ter de introduzir todos os detalhes do zero de cada vez. Um modelo poderá contertodos os detalhes que um alarme possa conter, à parte da hora de início.

Por exemplo, poderá querer configurar um alarme para o relembrar de um programa de televisãocuja hora varia de semana para semana. O modelo iria conter todos os detalhes do alarme (otexto da mensagem, se deverá tocar um som, etc.), exceptuando a data e hora. Depois, para criaro alarme, tudo o que teria de fazer seria carregar na janela de Edição do Alarme esse modelo eintroduzir então a data e hora.Para criar um alarme com base num modelo, abra a janela de Edição do Alarme, predefinida comos detalhes do modelo:

• Seleccione a opção Ficheiro → Novo → Novo a Partir de Modelo, seleccionando depois o mo-delo desejado.

• Carregue com o botão direito do rato no ícone da bandeja do sistema e escolha a opção NovoAlarme → Novo Alarme de Modelo no menu de contexto. Depois, seleccione o modelo dese-jado.

• Abra a janela de Edição do Alarme da forma normal e carregue no botão Carregar um Mo-delo... para seleccionar um modelo com o qual predefinir a janela.

12

O Manual do KAlarm

2.3.7.1 Configurar os Modelos

O utilizador poderá criar, modificar ou remover modelos com a janela de Modelos de Alarmesou poderá ainda criar um novo modelo de alarme com base num alarme existente.

Para criar um novo modelo de alarme, faço uma das seguintes operações:

• Mostre a janela de Modelos de Alarmes, seleccionando a opção do menu Ficheiro →Modelos... e carregando no botão Novo, escolhendo depois o tipo de alarme na lista queaparece. Isto irá mostrar uma janela de Edição do Modelo em branco.

• Mostre a janela de Modelos de Alarmes, seleccionando a opção do menu Ficheiro →Modelos..., seleccione um modelo existente e carregue em Copiar. Isto abre a janela de Ediçãodo Modelo já preenchida com uma cópia dos detalhes do modelo seleccionado.

• Seleccione um alarme na lista e escolha a opção Ficheiro → Criar um Modelo.... Isto abre ajanela de Edição do Modelo já preenchida com uma cópia dos detalhes do alarme seleccionado.

Para modificar um modelo existente, mostre a janela de Modelos de Alarmes, seleccionando aopção Ficheiro → Modelos... e carregando em Editar. Isto irá mostrar a janela de Edição doModelo, a qual é descrita em baixo.

Para remover os modelos existentes, mostre a janela de Modelos de Alarmes, seleccionando aopção Ficheiro → Modelos..., seleccione um ou mais modelos e carregue em Remover. É apre-sentada uma mensagem de confirmação para evitar remoções acidentais.

2.3.7.2 Janela de Edição do Modelo

A janela de Edição do Modelo é semelhante à janela de Edição do Alarme. Só os seguintes con-trolos são diferentes:

• Indique o nome do modelo no campo Nome do modelo. É o nome do modelo que é apresen-tado nas listas de selecção de modelos, por isso é melhor escolher um nome que o relembre dasua função. Cada nome do modelo deverá ser único.

• No grupo Hora, seleccione uma das seguintes opções:

– Tempo por omissão se não quiser indicar nenhuma hora para activação. Os alarmes basea-dos neste modelo irão usar a hora de activação por omissão para os alarmes novos.

– Assinale a Hora para indicar uma hora em que o alarme será despoletado.– Assinale Apenas a data para indicar que o alarme só deverá ter uma data, sem nenhuma

hora.– Assinale o Tempo a partir de agora para indicar quanto tempo (em horas e minutos) pode

passar, após a criação do alarme, enquanto o alarme possa ser despoletado.

• No grupo da Regra de Recorrência da página Recorrência, não é necessário escolher nenhumdia ou mês para as recorrências semanais ou anuais, respectivamente.

2.3.8 Calendários de Alarme

Se só usar um computador e trabalhar de forma independente, poderá não lhe interessar ondeé que o KAlarm guarda os seus alarmes. Porém, se precisar de aceder aos alarmes em mais deum computador ou de uma localização no seu computador local, poderá definir ‘calendáriosde alarmes’ para dizer ao KAlarm para usar outros calendários adicionais por omissão ou porsubstituição.

Poderá ver e manipular os calendários através da lista de calendários, que poderá ser apresentadaao lado da lista de alarmes, na janela principal do KAlarm. Os alarmes de todos os calendários

13

O Manual do KAlarm

aparecem reunidos em conjunto na lista de alarmes. Quando gravar um alarme novo, poderádefinir uma opção de configuração para determinar se será gravado automaticamente no calen-dário predefinido ou se você será questionado para escolher um calendário. Quando editar umalarme existente, o mesmo é gravado de novo no seu calendário de alarmes original.

2.3.8.1 Tipos e Opções do Calendário

Os calendários dos alarmes são categorizados por tipo de alarme e de armazenamento. Estespoderão ser desactivados, colocados apenas para leitura ou colocados como predefinidos para oseu tipo de alarme.

Tipo de alarme

Os três tipos de entidades de alarmes – alarmes activos, alarmes arquivados ou expiradose modelos de alarmes – são gravados em calendários de alarmes separados. Como tal, oKAlarm tem três calendários predefinidos, um para cada tipo (veja as Perguntas e Respostaspara mais detalhes), os quais poderá alterar se o desejar.

Tipo de armazenamento

O KAlarm lida com dois tipos de armazenamento dos calendários de alarmes:

• Ficheiro local: Os alarmes são guardados num único ficheiro local, no formato iCalen-dar. O KAlarm usa os calendários de ficheiros locais por omissão (veja as Perguntas eRespostas para mais detalhes). Os ‘ficheiros locais’, para além dos ficheiros no computa-dor local, poderão incluir os calendários na rede local, desde que a sua localização possaser representada por um caminho que comece por / .

• Pasta local: Os alarmes são gravados numa pasta local, sendo cada um dos alarmes gra-vado num ficheiro iCalendar separado, dentro da pasta. Este método de armazenamentotem a vantagem de, no caso de corrupção do ficheiro, só irá perder um alarme, em vezde perder o calendário completo.

Estado de activado/desactivadoA desactivação de um calendário tem o mesmo efeito que a sua remoção, com a diferençaque aparece à mesma na lista de calendários, para uma simples reactivação. Quando estiverdesactivado, os seus alarmes são ignorados e não aparecem na lista de alarmes ou na listade modelos. Quando estiver reactivado, os seus alarmes voltam a aparecer e, se for umcalendário de alarmes activo, os mesmos serão activados.

Estado apenas para leitura

Os alarmes de um calendário apenas para leitura não poderão ser modificados ou adiciona-dos. Como tal, não poderá editar os seus alarmes ou gravar alarmes novos nele. Do mesmomodo, não é possível adiar os seus alarmes dado que, ao fazê-lo, a hora do adiamento teria

14

O Manual do KAlarm

de ser gravada no alarme. Depois de os seus alarmes tiverem sido despoletados, estes nãosão removidos do calendários e arquivados, somente quando você ou outro utilizador tiveracedido ao calendário no modo de leitura/escrita.Poderá configurar o estado de ’apenas para leitura’ de um calendário na janela de confi-guração do mesmo. Contudo, alguns calendários não poderão ser modificados, por váriasrazões:

• Se um calendário tiver sido criado por outra aplicação, seria inseguro permitir ao KAlarmactualizá-lo, dado que as diferenças no formato de dados podê-lo-iam inutilizar pelaaplicação que o criou.

• Se o calendário tiver sido criado por uma versão posterior do KAlarm, os dados poder-se-ão perder, se a sua versão do KAlarm os actualizar.

• Se o calendário tiver sido criado por uma versão anterior do KAlarm, os dados poder-se-ão perder ou corromper pela versão anterior do KAlarm, se a sua versão do KAlarma actualizar. Será questionado se deseja converter o formato, para poder gravá-lo, tendoem mente os problemas potenciais de compatibilidade, se a versão anterior do KAlarmnecessitar de aceder a eles de novo.

• Se não tiver permissões para gravar no ficheiro ou pasta do calendário.

Se precisar de acesso de escrita para os alarmes num calendário que não possa atribuiressas permissões, você poderá copiar os seus alarmes, importando-os para um calendáriocom permissões de escrita, usando a opção do menu de contexto Importar... do últimocalendário (veja em Importar os Alarmes dos Calendários Externos).

Estado predefinido do calendário

O utilizador poderá predefinir um calendário para cada tipo de alarme, a título opcional.Os alarmes novos são gravados automaticamente no calendário predefinido, para o tipo dealarme apropriado, a menos que tenha seleccionado a opção de pergunta para os alarmes emodelos na janela de Configuração.

2.3.8.2 Usar os Calendários

Poderá ver e manipular os calendários na lista de calendários, a qual poderá aparecer ou serescondidas com a opção Ver → Mostrar os Calendários. Quando usar a lista de calendários,seleccione primeiro o tipo de alarme com a lista que está por cima desta. Depois, carregue numdos botões por baixo da lista ou carregue com o botão direito no calendário apropriado da lista,escolhendo de seguida um item do menu de contexto. As acções disponíveis são:

Adicionar...Adiciona um calendário do tipo seleccionado à lista. Ser-lhe-á pedido para escolher umtipo para o armazenamento, pelo que se segue a janela de configuração do calendário, ondepoderá indicar a localização do calendário, bem como as suas características. Se não existirnenhum calendário de alarmes no local indicado, será criado um novo.

RemoverRemove o calendário seleccionado da lista. O calendário em si é deixado intacto; simples-mente desaparece da lista, podendo ser instanciado de novo na lista, se o desejar.

Editar...Edita o calendário seleccionado. Isto mostra a janela de configuração do calendário selecci-onado.

ActualizarVolta a carregar o calendário seleccionado. O calendário é lido de novo do seu local dearmazenamento, garantindo que não existe nenhuma discrepância entre o que o KAlarmmostra e o estado actual do calendário. Se o calendário for partilhado com outros utiliza-dores, as alterações que eles façam serão vistas de seguida pelo KAlarm.

15

O Manual do KAlarm

ATENÇÃOSe voltar a carregar um calendário remoto, as alterações que faça desde a última gravaçãoserão perdidas. Do mesmo modo, os alarmes que tiverem expirado desde a última gravaçãopoderão ser despoletados de novo.

Importar...

Importa os alarmes de um ficheiro de calendário externo para o calendário seleccionado.Isto está descrito na secção Importar os Alarmes de Calendários Externos. Esta opção nãoestá disponível para os calendários desactivados ou apenas para leitura.

Exportar...

Exporta todos os alarmes do calendário seleccionado para um ficheiro de calendário ex-terno. Isto está descrito na secção Exportar os Alarmes para Calendários Externos. Estaopção não está disponível para os calendários desactivados.

Mostrar os DetalhesMostra os detalhes sobre o calendário seleccionado. Isto mostra a localização do calendário,bem como o tipo de armazenamento e a informação do estado.

Usar como PredefinidoTorna predefinido o calendário seleccionado para o tipo de calendário seleccionado. Estaopção não está disponível para os calendários desactivado ou apenas para leitura.

Mudar a Cor...Seleccione uma cor de fundo para realçar os alarmes deste calendário na lista de alarmes.Isto permite-lhe ver imediatamente os alarmes que pertencem a um determinado calendá-rio.

Limpar a Cor

Limpa o realce de cores para os alarmes deste calendário na lista de alarmes. A opção sóaparece depois de a opção Mudar a Cor ser usada neste calendário.

2.3.9 Importar Alarmes de Calendários Externos

Poderá importar os alarmes a partir de outros ficheiros de calendários para o KAlarm. A funçãode importação verifica o ficheiro de calendário seleccionado, à procura de eventos que conte-nham alarmes, copiando-os (com novos identificadores únicos) para o calendário do KAlarm. Oseventos sem alarmes, bem como os outros tipos de itens do calendário, serão ignorados. Existemduas formas de importar os alarmes:

• Seleccione a opção Ficheiro → Importar Alarmes... para importar os alarmes de vários tipos(alarmes activos, arquivados e modelos de alarmes) do calendário.Se tiver configurado os calendários de alarmes, os alarmes de cada serão adicionados ao ca-lendário predefinido apropriado, ou será questionado pelo calendário, se tiver seleccionado aopção de pergunta nos alarmes e modelos novos, na janela de Configuração.

• Carregue com o botão direito num calendário da lista e escolha a opção Importar... do menu decontexto. Isto importa os alarmes do tipo seleccionado de momento para esse calendário. Porexemplo, se o tipo de calendário seleccionado for os modelos de alarmes, serão importados osmodelos de alarmes (e não os alarmes activos ou arquivados).

16

O Manual do KAlarm

ATENÇÃOSe importar os alarmes a partir de ficheiros de calendários criados por aplicações que não o KAlarm,estes poderão ser alterados pelo processo de importação – as horas dos alarmes poderão inclusivemudar. Isto depende das convenções de armazenamento de dados usadas pela outra aplicação, e éinevitável desconhecer as diferenças dessas convenções face ao que o KAlarm está à espera. Verifi-que sempre os alarmes importados, à espera de alterações inesperadas, e ajuste-os se necessário.

2.3.10 Exportar Alarmes para Calendários Externos

Poderá exportar os alarmes do KAlarm para outros ficheiros de calendário, usando os alarmesseleccionados de momento na lista de alarmes ou todos os alarmes de um dado calendário. Osmétodos para o fazer são indicados abaixo. Seja qual for o método, tanto poderá criar um ficheirode calendário novo como adicionar os alarmes exportados a um ficheiro existente. Para adicionaros alarmes, assinale a opção Adicionar a um ficheiro existente na janela de selecção dos ficheiros;caso contrário, todos os ficheiros existentes serão substituídos.

• Para exportar os alarmes seleccionados de momento na lista, carregue com o botão direito naselecção e escolha Exportar... no menu de contexto, ou use então a opção Ficheiro → Exportaros Alarmes Seleccionados... no menu principal.

• Para exportar todos os alarmes de um calendário, carregue com o botão direito num calendárioda lista, e escolha Exportar... no menu de contexto.

2.3.11 Importar Aniversários do KAddressBook

O utilizador poderá configurar os alarmes para os aniversários que estão registados no KAddres-sBook, através da opção Ficheiro → Importar os Aniversários.... Isto mostra uma janela que lhepermitirá escolher os aniversários para os quais deseja criar alarmes.

• No grupo Texto do Alarme, poderá configurar o texto a mostrar nas mensagens de alarmesdos aniversários. O texto da mensagem é criado através da combinação do texto do Prefixoseguido do nome da pessoa e do texto do Sufixo. Não são adicionados nenhuns espaços, porisso lembre-se de incluir os espaços necessários no Prefixo e no Sufixo.

NOTASe alterar o texto do alarme, a lista de selecção dos aniversários será avaliada de novo.

• Na lista Seleccione os Aniversários, seleccione as datas de aniversários para as quais desejacriar alarmes. Lembre-se que a lista só mostra os itens no KAddressBook que contêm umaniversário e que não têm já um alarme no formato definido de momento no grupo do Textodo Alarme.

• Os controlos restantes são os mesmos que para os alarmes de Texto na janela de Edição doAlarme.

Se tiver configurado os calendários de alarmes, os alarmes de cada serão adicionados ao calen-dário predefinido apropriado, ou será questionado pelo calendário, se tiver seleccionado a opçãode pergunta nos alarmes e modelos novos, na janela de Configuração.

17

O Manual do KAlarm

2.3.12 Desfazer / Refazer

Poderá desfazer e refazer as alterações mais recentes que tenha feito durante a sessão actual doKAlarm. A maioria das acções poderá ser anulada, incluindo a criação, edição e remoção dosalarmes e modelos de alarmes, assim como a reactivação dos alarmes. Para evitar a utilização ex-cessiva de recursos pelo histórico do Desfazer, o número de alterações armazenadas está limitadoàs últimas 12.Para anular a última modificação, seleccione a opção Editar → Desfazer. Para voltar a repetir aúltima alteração que foi anulada, seleccione a opção Editar → Refazer.

Para anular uma modificação que não a última, carregue no botão Desfazer na barra de ferramen-tas e mantenha o botão pressionado. Irá aparecer uma lista das acções, na qual poderá escolhera que deseja anular. Se não ver a acção que está à procura, lembre-se que poderá necessitar dedesfazer as alterações mais recentes em primeiro lugar, da qual a modificação desejada depende.Por exemplo, se tiver editado um alarme e depois removido o mesmo, não poderá anular a ediçãoaté que anule, em primeiro lugar, a remoção.

A repetição de uma modificação que não a última pode ser feita da mesma forma, usando o botãoda barra de ferramentas para Refazer.

2.4 A janela de Edição do Alarme

A janela de Edição do Alarme permite-lhe ver e editar um alarme. Quando usar pela primeira vezo KAlarm, é apresentada uma versão simplificada da janela, com apenas um número pequenode opções visíveis. Para ver todas as opções, carregue no botão Mais Opções; para reverter paraa janela simplificada, carregue no botão Menos Opções. O KAlarm recorda sempre a sua últimaescolha apresentada, sempre que a janela de Edição do Alarme voltar a ser apresentada.

Pode configurar os valores predefinidos de muitas das opções na janela de Edição do Alarmecom a página Editar da janela de configuração.

A janela simplificada de Edição do Alarme para um alarme visível

18

O Manual do KAlarm

A janela de Edição de Alarmes para um alarme visível com todas as opções

2.4.1 Acção do Alarme

Os controlos no grupo Acção poderão variar de acordo com o tipo de alarme a ser editado.

2.4.1.1 Alarmes Visíveis

Os alarmes visíveis mostram uma janela quando o alarme despoleta. Seleccione o método usadopara gerar o conteúdo da janela de alarme, usando a lista no topo:

• Texto para indicar o texto da mensagem de alarme (o qual poderá conter várias linhas) nocampo de texto.

• Conteúdo do ficheiro para indicar o nome ou o URL de um ficheiro de texto ou de imagemcujo conteúdo seja mostrado na janela da mensagem. Use o botão ao lado do campo de ediçãopara aparecer uma janela de selecção de ficheiros. A opção Falar não está disponível para estetipo de alarme.

• Resultado do comando para indicar que o texto da mensagem de alarme será gerado por umcomando que é executado quando o alarme disparar. Veja abaixo em Alarmes por Comandopara saber mais detalhes como introduzir o comando ou o programa a executar.

Os controlos disponíveis para os alarmes visíveis são:

• A opção Som permite-lhe seleccionar se deseja despoletar um alarme audível quando a men-sagem de alarme for apresentada. Escolha:

– Nenhum para mostrar o alarme em silêncio.– Apitar para soar uma campainha.

19

O Manual do KAlarm

– Ficheiro de som para tocar um ficheiro de áudio. Use o botão à direita para mostrar a janelado Ficheiro de Som, que lhe permite seleccionar o ficheiro a reproduzir e definir as opçõesdo volume e de repetição. Se passar o rato por cima do botão, irá aparecer uma dica que lheindica o ficheiro de áudio seleccionado de momento.Na janela do Ficheiro de Som:

* Indique a localização do ficheiro de som, ou então use o botão ao lado do campo de ediçãopara mostrar uma janela de selecção de ficheiros. Poderá ouvir o ficheiro seleccionadose carregar no botão de reprodução à esquerda do campo de edição. Esse botão irá entãomudar de função para lhe permitir parar a reprodução quando já tiver ouvido o suficiente.

* Assinale o Repetir para que o som seja repetido continuamente durante o tempo em queo alarme é mostrado. (A janela da mensagem de alarme contém um botão para parar detocar o som, no caso de precisar de silêncio mas deseje manter o alarme visível).

* Assinale o Volume e ajuste a barra deslizante se quiser ajustar o volume com que o ficheirode áudio é tocado.

* Se o desejar, poderá desvanescer o volume. Isto significa que o ficheiro de som começa aser reproduzido com um determinado volume e vai mudando gradualmente para o vo-lume final, dentro de um determinado intervalo de tempo específico. O volume final é oque será introduzido no Volume acima. Para activar a variação gradual, assinale a opçãoDesvanescer e escolha o período no qual isso acontece no campo Tempo de desvaneci-mento e ajuste a barra do Volume inicial.

DICAPoderá usar o botão Tentar para testar os níveis de som seleccionados.

• Use o botão do Tipo de Letra & Cor... para seleccionar um tipo de letra ou uma cor de textoou de fundo para a mensagem de alarme. Na janela para Escolher o Tipo de Letra e Cor doAlarme, assinale a opção Usar o tipo de letra predefinido para mostrar a mensagem com o tipode letra que estiver configurado por omissão na altura em que a mensagem for apresentada. (Otipo de letra por omissão pode ser configurado na janela de Configuração.) Para escolher umtipo de letra específico para a mensagem, desligue a opção Usar o tipo de letra predefinido.As cores seleccionadas são apresentadas no campo de texto da mensagem de alarme.

• Use o botão Acções Especiais... para indicar os comandos a executar antes ou depois da apre-sentação do alarme. Na janela das Acções Especiais de Alarme:

– No campo de Acção de pré-alarme, indique um comando a executar antes de mostrar oalarme. Lembre-se que o KAlarm espera que o comando termine antes de mostrar o alarme.Uma acção pré-alarme só é executada uma vez quando a mensagem de alarme é apresen-tada inicialmente, incluindo quando uma mensagem de chamada de atenção é substituídapela mensagem de alarme verdadeira. Não é executada em nenhuma das seguintes circuns-tâncias:* Quando é apresentada uma mensagem de chamada de atenção.

* Quando a mensagem volta a ser apresentada após adiar o alarme, a menos que a opçãoExecutar para os alarmes adiados esteja assinalada.

* Quando a mensagem foi apresentada à hora em que você se desligou e é reposta quandovocê se ligar.

* Quando um alarme recorrente é despoletado, mas a mensagem de alarme (ou a mensagemde um alarme adiado) de uma ocorrência anterior do alarme ainda estiver visível; poroutras palavras, quando a ocorrência anterior do alarme ainda não tiver sido confirmada.

A acção pré-alarme pode ser usada para controlar se deseja mostrar a mensagem do alarme:

* Assinale a opção Cancelar o alarme em caso de erro para cancelar o alarme, caso o co-mando de pré-alarme devolva um estado de erro. Isto irá evitar que a mensagem de erroseja apresentada, assim como executar qualquer acção pós-alarme.

* Normalmente, se o comando pré-alarme devolver um erro, aparece uma mensagem dealarme e aparece uma indicação do erro na lista de alarmes. Estas notificações de errospoderão ser evitadas se assinalar a opção Não notificar os erros.

20

O Manual do KAlarm

– No campo da Acção pós-alarme, indique um comando da consola a executar sempre que oalarme for aceite (quer ao carregar em Fechar quer usando o botão para fechar na barra detítulo da janela). Não é executada em nenhuma das seguintes circunstâncias:

* Quando uma mensagem de chamada de atenção é fechada.

* Quando adiar o alarme, excepto quando o alarme adiado for finalmente aceite.

* Quando a mensagem de alarme for fechada por ter saído da sessão.

Veja a descrição dos alarmes de Comandos em baixo para saber os detalhes com que os co-mandos são executados.

2.4.1.2 Alarmes de Comandos

Os alarmes por comandos executam um comando sem mostrar qualquer mensagem de alarme.

NOTAEste tipo de alarme não está disponível se o KDE estiver a correr em modo quiosque.

Quando o comando é executado, a variávle de ambiente KALARM_UID contém o UID do eventopara o alarme. Lembre-se que, quando o comando é executado com o botão Tentar da janela deedição do alarme, o KALARM_UID estará em branco se for um alarme novo, ou se o alarme tiver sidomodificado na janela, dado que o alarme só adquire um UID quando for gravado no calendáriodo alarme.Os controlos disponíveis para os alarmes de comandos são:

• A opção Introduzir um programa permite-lhe escolher se deseja introduzir um comando deconsola ou um programa.Se esta opção estiver desligada, poderá introduzir uma instrução da linha de comandos demodo a executá-la. O comando é passado para a linha de comandos por omissão (definidapela variável de ambiente SHELL) e pode incluir quaisquer opções, parâmetros, comandos via’pipes’, etc., sendo tudo permitido numa única linha de comandos.Se esta opção for assinalada, poderá introduzir o texto de um programa a executar. Lembre-se de incluir uma primeira linha do tipo #!/bin/bash para garantir que o interpretador decomandos correcto é invocado.

• Use o grupo do Resultado do Comando para indicar o que deseja fazer com o resultado parao terminal que o comando produza enquanto for executado.

– Assinale a opção Executar numa janela de terminal para fazer com que o comando sejaexecutado numa janela de terminal. Poderá escolher o tipo de janela de terminal que seráusada na janela de Configuração.

– Assinale a opção Registar num ficheiro para gravar o resultado do comando num ficheiro.O resultado, antecedido de um cabeçalho que mostra a hora em que o comando foi agendadopara correr, será adicionada ao conteúdo existente no ficheiro. Indique o nome do ficheirono campo de texto ou use o botão ao lado do campo de texto para mostrar uma janela deselecção de ficheiros.

– Assinale a opção Esquecer para ignorar o resultado do comando.

2.4.1.3 Alarmes por E-Mail

Os alarmes por e-mail enviam um e-mail sem mostrar qualquer mensagem de alarme.

Preencha os endereços dos destinatários, a linha do assunto da mensagem e o corpo da mesmanos três campos de texto. Use o botão ao lado do campo dos endereçados para mostrar o seu livro

21

O Manual do KAlarm

de endereços do KDE, no qual poderá seleccionar os destinatários da mensagem. Os anexos po-derão ser adicionados com o botão Adicionar.... Lembre-se que os ficheiros anexados precisam deexistir quando o alarme for disparado; não é gravada nenhuma cópia na altura em que o alarmeé configurado. Para remover um anexo, seleccione-o na lista e carregue no botão Remover.

Escolha as seguintes opções:

• A lista De permite-lhe seleccionar a identidade do KMail a usar como endereço de e-mailpara enviar a mensagem. Esta opção só aparece se o seu endereço de e-mail De na janela deConfiguração estiver configurada para Usar as identidades do KMail. Caso contrário, o seuendereço de e-mail estará predefinido na janela de Configuração, tornando esta opção inútil.

• Assinale a opção Copiar o e-mail para o próprio para enviar uma cópia implícita da mensa-gem para si próprio quando o alarme for despoletado. O endereço de e-mail para o qual seráenviada a cópia pode ser definido na janela de Configuração.

2.4.1.4 Alarmes de Áudio

Os alarmes de áudio tocam um ficheiro de áudio sem mostrar qualquer mensagem de alarme.

Escolha as seguintes opções:

• Indique a localização do ficheiro de som, ou então use o botão ao lado do campo de texto, demodo a mostrar uma janela de selecção de ficheiros.

• Assinale a opção Repetir para repetir de forma contínua o ficheiro de áudio, até que a opçãoParar a Reprodução seja seleccionada. Para parar a reprodução do ficheiro, seleccione a opçãodo menu Acções → Parar a Reprodução ou carregue com o botão direito do rato no ícone dabandeja e seleccione a opção Parar a Reprodução no menu de contexto. Se o desejar, poderádefinir uma tecla de atalho para esta acção.

• Assinale o Volume e ajuste a barra deslizante se quiser ajustar o volume com que o ficheiro deáudio é tocado.

• Se o desejar, poderá desvanescer o volume. Isto significa que o ficheiro de som começa aser reproduzido com um determinado volume e vai mudando gradualmente para o volumefinal, dentro de um determinado intervalo de tempo específico. O volume final é o que seráintroduzido no Volume acima. Para activar a variação gradual, assinale a opção Desvanescere escolha o período no qual isso acontece no campo Tempo de desvanecimento e ajuste a barrado Volume inicial.

2.4.2 Adiamento

Se o alarme for recorrente e se foi adiado depois de ter sido mostrado pela última vez, o grupoAlarme Adiado mostra a hora para a qual o alarme foi adiado. O Modificar... mostra uma janelaque lhe permite alterar a hora do adiamento ou cancelá-lo.

2.4.3 Hora

No grupo da Hora, seleccione

• Na data/hora se quiser introduzir a data e hora em que o alarme será disparado. Assinale aopção A qualquer hora para indicar apenas a data em que o alarme deverá ser despoletado:nesse caso, o alarme será apresentado na primeira oportunidade ou após a hora configuradapara o início do dia, para a data indicada. (O Configurar o KAlarm descreve como configurara hora do início do dia.)

22

O Manual do KAlarm

Para um alarme não-repetitivo, a data/hora que aqui indicar dever-se-á passar no futuro ou,se só indicar uma data, terá de ser hoje ou depois. Para um alarme repetitivo, não existemestas restrições dado que a data/hora de início será ajustada automaticamente para a primeirarepetição que aconteça a seguir à hora actual.

• Tempo a partir de agora para indicar quanto tempo ficará à espera (em horas e minutos) atéque o alarme seja despoletado.

Escolha o fuso-horário a aplicar no alarme. Este fuso-horário é usado por todas as datas e horasrelacionadas com este alarme, incluindo as datas e horas de repetição e de excepção. Normal-mente, deverá deixar os controlos de fuso-horário sem alteração, a menos que tenha uma boarazão para os alterar.

Os controlos do fuso-horário só são apresentados quando o fuso-horário seleccionado é diferentedo predefinido na janela de Configuração ou se carregar no botão Fuso-Horário....

• Na lista respectiva, escolha o fuso-horário que este alarme irá usar. Ao criar um alarme novo,este é configurado inicialmente com o fuso-horário seleccionado na janela de Configuração, oqual será o seu fuso-horário, a menos que o tenha alterado.

• Assinale a opção Ignorar o fuso-horário se quiser usar a hora do computador do local (nocomputador em que o KAlarm esteja a correr), ignorando os fusos-horários.

ATENÇÃORecomenda-se que não use esta opção se o alarme tiver uma repetição definida em horas e mi-nutos; se o fizer, o alarme poderá ocorrer em horas inesperados, depois das mudanças de horasazonais.

2.4.4 Chamada de Atenção

Para um alarme visível, assinale a Chamada de Atenção se quiser mostrar uma chamada deatenção antes do alarme principal e de cada uma das suas repetições (se existirem). Indiquecom que antecedência ou posteridade deseja, usando os controlos de edição por baixo da opçãopropriamente dita. Lembre-se que, se o alarme se repetir, o período da chamada de atenção estánormalmente limitado a menos que o período de repetição ou sub-repetição.

NOTAAs chamadas de atenção não são apresentadas para as sub-repetições dentro de uma recorrência.As chamadas de atenção só aparecem antes de cada recorrência principal do alarme.

Se o alarme se repetir, assinale a opção Chamada de atenção apenas para a primeira recorrênciase desejar apenas uma chamada de atenção antes da primeira repetição do alarme. Se estiverassinalada, e se for uma chamada de atenção de avanço, o período da chamada de atenção nãoestará limitado a ser menor que o intervalo de repetição ou sub-repetição.

2.4.5 Cancelamento

As opções de cancelamento posterior determinam a forma como um alarme é tratado depois dasua hora agendada:

• A opção Cancelar se atrasado indica o que acontece se o alarme não puder ser disparado àhora agendada.Assinale esta opção para cancelar o alarme, se não conseguir ser despoletado dentro de umdeterminado período de tempo após a hora agendada. O período de tempo é seleccionado com

23

O Manual do KAlarm

os campos que aparecem quando você assinalar a opção. Por exemplo, se indicar um períodode tempo de 1 hora, o alarme será despoletado à primeira oportunidade que ocorrer até 1 horaapós a hora exacta mas, se não conseguir ser disparado nesse período, a sua activação serácancelada.

NOTAO atraso dos alarmes apenas para datas, isto é os que tenham a opção A qualquer hora selecci-onada, é calculado a partir da hora de início-do-dia na data agendada para o alarme.

Deixe a opção desligada para despoletar o alarme à primeira oportunidade, a partir da horaagendada e independentemente do seu atraso.

NOTAUm alarme só poderá ser desencadeado enquanto você estiver ligado e tanto o X como o KAlarmestiverem em execução.

• Assinale a opção Fechar automaticamente a janela ao fim deste tempo se quiser que a ja-nela do alarme seja fechada automaticamente se continuar visível, na altura em que a hora decancelamento tardio expirar.

2.4.6 Recorrência

Indique quando e como o alarme deverá ser repetido com a página de Recorrência.

NOTAA característica básica de repetição do alarme é mostrada por conveniência na página de Recorrên-cia. O intervalo de repetição, tal como está configurado na página de Recorrência, é mostrado emprimeiro lugar, seguido do intervalo de todas as sub-repetições, configurado com o botão de Sub-Repetição.

No grupo da Regra de Recorrência, indique o tipo de recorrência ou o período de tempo daseguinte forma:

• Para disparar o alarme somente uma vez, seleccione Sem recorrência.

• Seleccione Na autenticação para despoletar o alarme sempre que você se ligue, até à sua horafinal agendada. Depois, na sua hora final, será despoletado uma última vez. (Lembre-se queum alarme repetido na autenticação será também despoletado de cada vez que você activar osalarme ou reiniciar o KAlarm.)

• Para que o alarme se repita em intervalos regulares, seleccione um dos tipos de períodos eindique depois no campo Recorrência a cada quantos períodos de tempo deverão passar entrecada repetição. Por exemplo, para repetir em cada quinzena, poderá seleccionar Diariamentee indicar um valor igual a 14 ou seleccione Semanalmente e introduza um valor igual a 2.Dependendo do tipo de período de tempo seleccionado, poderá ter outras opções:

– Para uma recorrência semanal, assinale cada dia da semana em que deseja activar o alarme.– Para uma recorrência mensal, poderá tanto indicar uma data fixa como uma posição (isto é

a segunda Terça-Feira).– Para uma recorrência anual, tanto poderá escolher um dia fixo do mês ou uma posição den-

tro de um mês (isto é o último Sábado de Maio). Assinale cada mês do ano em que desejaactivar o alarme.Se você tiver configurado repetições anuais para o 29 de Fevereiro, indique como é que estasserão tratadas nos anos não-bissextos, seleccionando a opção apropriada em Alarme do 29de Fevereiro nos anos não-bissextos:

24

O Manual do KAlarm

* Nada: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos, mas será suprimido nosoutros anos.

* 28 de Fevereiro: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos e a 28 de Feve-reiro nos outros anos.

* 1 de Março: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos e a 1 de Março nosoutros anos.

DICAPara configurar um alarme diário para ocorrer apenas nos dias da semana, use uma recorrênciasemanal e assinale todos os dias da semana.

No grupo do Fim da Recorrência, configure a amplitude temporal de recorrência global da se-guinte forma:

• Seleccione Sem fim para continuar as repetições indefinidamente.

• Seleccione Acabar ao fim de para indicar o número total de ocorrências do alarme.

• Seleccione Acabar em para indicar a data/hora até à qual o alarme será repetido. Lembre-seque isto usa o mesmo fuso-horário que a hora inicial do alarme.

NOTAA data/hora do fim determina quando será a última recorrência principal, mas não limitas as sub-repetições. Se estas estiverem configuradas, irão despoletar normalmente após a última recorrên-cia principal, independentemente da data/hora final.

O grupo Excepções permite-lhe excluir certas datas/horas da recorrência que tiver configu-rado. Lembre-se que estes controlos não aparecem na versão simplificada da janela de Ediçãodo Alarme: para as ver, carregue em Mais Opções.

• A lista de excepções (isto é, as datas/horas excluídas) é mostrada à esquerda. Para adicionaruma nova excepção, introduza uma data à direita e carregue em Adicionar. Para alterar umaexcepção, seleccione-a na lista, indique a nova data à direita e carregue em Modificar. Pararemover uma excepção, seleccione-a na lista e carregue em Remover.

• Poderá restringir um alarme para não ocorrer nos feriados, se assinalar a opção Excluir osferiados. Isto não altera a forma como o alarme é agendado; simplesmente elimina o alarmesempre que este estiver agendado para despoletar após o horário de trabalho. O horário detrabalho é definida na janela de Configuração.

• Poderá restringir um alarme para ocorrer apenas durante o horário de trabalho, se assinalara opção Só durante o horário de trabalho. Isto não altera a forma como o alarme é agen-dado; simplesmente elimina o alarme sempre que este estiver agendado para despoletar apóso horário de trabalho. O horário de trabalho é definida na janela de Configuração.

2.4.6.1 Sub-Repetição

Poderá também usar o botão de Sub-Repetição para configurar uma repetição dentro de outrarepetição. Neste caso, sempre que chegar a hora de um alarme, tal como foi indicado na páginade Recorrência, em vez de ser despoletado uma vez, será disparado repetidamente, de acordocom a sua indicação de repetição simples. Por exemplo, para configurar um alarme que se repitaa todas as horas, desde o meio-dia até às 6 da tarde de todas as Quintas-Feiras, poderia usar apágina de Recorrência para configurar uma repetição semanal às Quintas ao meio-dia e usar ajanela de Repetição Simples para indicar um intervalo de 1 hora e uma quantidade igual a 7 ouuma duração de 6 horas.Na janela de Sub-Repetição que aparece quando carregar no botão Sub-Repetição, assinale aopção Repetir a cada para configurar uma repetição ou desligue-a para remover as repetições.Se a opção Repetir a cada estiver assinalada, configure a repetição da seguinte forma:

25

O Manual do KAlarm

• Indique o intervalo de tempo entre as repetições nas opções ao lado de Repetir a cada. Selec-cione as unidades de tempo desejadas (isto é dias) e indique depois o número de unidades.

• Indique depois a quantidade de repetições ou a sua duração:

– Seleccione o Número de vezes para indicar o número de repetições que o alarme deverá ter,incluindo a sua ocorrência inicial. Como tal, por exemplo, para que o alarme ocorra 4 vezesem cada ocorrência principal, isto é 3 vezes adicionais, deverá indicar 3 aqui.

– Seleccione a Duração para indicar o período de tempo total, durante o qual o alarme deveráser repetido. Este não precisa de ser um múltiplo exacto do intervalo de repetição; este seráarredondado automaticamente quando você carregar em OK.

NOTAPara evitar a sobreposição de sub-repetições para o mesmo alarme, a duração de uma sub-repetiçãoestá restringida a ser menor que o maior intervalo entre recorrências principais. Sempre que o alarmerepetir, como estiver definido na recorrência principal, todas as sub-repetições activas que iniciaramna recorrência anterior são automaticamente canceladas.

2.4.7 Outros Controlos

Para os alarmes visíveis, a opção Confirmar a recepção permite-lhe indicar se será notificadoda confirmação quando fechar a janela da mensagem de alarme. Isto poderá ser usado comosalvação para uma confirmação acidental dos alarmes.

Seleccione a opção Mostrar no KOrganizer para adicionar o alarme ao calendário activo do KOr-ganizer, onde ele irá aparecer como um evento sem alarme. Esta opção permite-lhe registar osalarmes no KOrganizer, tirando à mesma partido das funções do KAlarm.

NOTASe quiser modificar ou remover posteriormente o alarme no KAlarm, o evento do KOrganizer serámodificado ou removido por consequência. Contudo, se modificar o evento no KOrganizer, o alarmeno KAlarm não será afectado.

Carregue no botão Carregar um Modelo para seleccionar um modelo com o qual preencher ajanela, tal como descrito em Criar e Manipular Alarmes.

Carregue no botão Testar para exibir o alarme e verificar se funciona correctamente. O alarmeé executado da mesma forma como se tivesse sido agendado da forma normal. No caso de umalarme de áudio, carregue no botão Testar uma segunda vez para parar de tocar o ficheiro desom.Carregue no botão OK quando todos os detalhes estiverem correctos para adicionar o alarmeà lista agendada. Lembre-se que, ao editar um alarme existente, o botão OK fica desactivadoenquanto não fizer nenhuma alteração.

2.5 Janela de Mensagem de Alarme

Quando uma mensagem de alarme chega à sua hora, é mostrada em todos os ecrãs e não pode sercoberta pelas janelas normais, para garantir que você a vê. A janela da mensagem mostra a horapara a qual o alarme foi agendado, para que você possa ver quando apareceu se estava ausentenessa hora. (Para as mensagens das chamadas de atenção, todavia, a data/hora mostrada é a doalarme principal ou da sua repetição, não é a hora da mensagem da chamada de atenção, e o seutítulo é ‘Chamada de Atenção’).

26

O Manual do KAlarm

As janelas de mensagens de alarme permanecem visíveis até que as reconheça, a menos que aopção Fechar automaticamente a janela depois do período de cancelamento tardio esteja assi-nalada na janela de edição de alarmes. No caso de um alarme repetitivo, se permanecer algumajanela aberta e não reconhecida de alguma ocorrência anterior do alarme, a janela existente sim-plesmente é realçada quando o alarme repetir. Isto evita que tenha de reconhecer várias cópiasda mesma mensagem, no caso de não desejar, ou ser incapaz de, reconhecer uma mensagem nahora em que aparece.

A janela da mensagem de alarme contém as opções que se seguem, desde que aplicadas ao alarmeapresentado:

• Confirmar o alarme ao carregar no botão Fechar. Isto fecha a janela (depois de um pedido deconfirmação, se seleccionou a opção Confirmar a recepção).

• Edite o alarme, carregando no botão Editar.... Isto mostra a janela de Edição do Alarme.

• Mostrar as opções para adiar o alarme para mais tarde, carregando no botão Adiar.... Depoisseleccione a opção Adiar para a data/hora de modo a indicar a data e hora em que a mensagemdeverá ser mostrada de novo ou seleccione o Adiar durante o intervalo de tempo para indicarem que tempo a partir de agora (em horas e minutos) é que a mensagem deverá ser mostradade novo. Depois, carregue em OK para remeter a mensagem de alarme para mais tarde efechar a sua janela.

NOTAA hora para a qual é adiado um alarme deverá ser anterior à sua próxima ocorrência escalonadaou até à próxima chamada de atenção. Por essa razão, o botão Adiar... na janela da mensagem dealarme e o botão de OK na janela de adiamento, ficam desactivados um minuto antes da próximaocorrência ou chamada de atenção.Lembre-se que, se estiver configurada uma chamada de atenção após o alarme, você pode adiaro alarme para depois da sua hora da chamada de atenção. Nesse caso, a mesma será suprimida.

NOTAO botão Adiar... não está disponível para os alarmes que são apresentados após a autenticação,devido ao facto de a opção Repetir após a autenticação ter sido seleccionada.

• Pare de tocar o ficheiro de som do alarme, carregando no botão que mostra o símbolo para‘parar de tocar’.

• Se a mensagem do alarme foi criada ao arrastar um e-mail do KMail, poderá aceder direc-tamente ao KMail, carregando no botão que mostra o ícone do KMail. Isto irá seleccionar erealçar a mensagem de e-mail na lista de pastas do KMail.

ATENÇÃOSe os índices do KMail forem gerados de novo, a ligação à mensagem de e-mail do KMail seráperdida.

• O botão que mostra o ícone do KAlarm oferece uma forma conveniente de activar o KAlarm.

Também poderá escolher, na janela de Configuração, quais dos dois diferentes modos a usar nasjanelas de mensagens de alarme:

• Como uma janela normal. Neste modo, a captura do teclado é feita pela janela da mensagem dealarme logo que aparecer, por isso, se estiver a escrever alguma coisa na hora, os seus eventosde teclado serão desviados para ele em vez de ser para a sua aplicação original.

27

O Manual do KAlarm

• Como uma janela não-modal. Neste modo, não há captura do teclado quando aparecer a janelada mensagem de alarme, como tal não irá interferir com a sua escrita. Contudo, neste modo, ajanela não tem barra de título, como tal não a poderá mover ou redimensionar.

NOTAQuando for apresentado um alarme por cima de uma aplicação do ecrã completo, esta aparece comouma janela não-modal, independentemente desta opção de configuração. Isto deve-se a uma limita-ção do sistema de janelas.

2.5.1 Posicionamento das Janelas de Mensagens

Poderá escolher, na janela de Configuração, qual dos dois esquemas a usar para posicionar asjanelas de mensagens de alarmes:

• As janelas aparecem o mais longe possível da posição actual do cursor. Isto minimiza o incó-modo ao seu trabalho e minimiza também a possibilidade de aceitar sem querer o alarme.

• As janelas aparecem no centro do ecrã. Para reduzir as hipóteses de aceitar por acidente oalarme, os botões na janela aparecem desactivados inicialmente, só ficando activos ao fim dealgum tempo (configurável).

Se tiver diversas janelas ou mensagens de alarmes visíveis, podê-las-á espalhar pelo ecrã, demodo a ficarem todas visíveis, ou então agrupá-las todas em conjunto no canto superior esquerdodo ecrã, através da opção do menu Ver → Espalhar as Janelas. Se o desejar, poderá configuraruma tecla de atalho global para esta acção.

2.6 Operação na Bandeja do Sistema

O KAlarm poderá ser executado como um ícone na bandeja do sistema. Este ícone oferece tantouma indicação do estado como o controlo da monitorização dos alarmes. Uma janela normaldo KAlarm indica que os alarmes estão a ser monitorizados, enquanto que um ícone cinzentoindica que os alarmes não estão a ser monitorizados. Se alguns dos alarmes individuais estiveremdesactivados, irá aparecer uma pequena cruz sobre o ícone.

O ícone da bandeja do KAlarm está automaticamente escondido sempre que não existirem alar-mes a activar nas próximas 24 horas. Poderá alterar o limite de invisibilidade ou mostrar sempreo ícone, usando a janela de configuração. Para mostrar o ícone quando tiver sido escondidoautomaticamente, carregue na seta da bandeja do sistema para revelar os ícones escondidos.

Se você passar o cursor do rato por cima do ícone da bandeja do sistema, aparece um resumodas primeiras mensagens de alarmes que irão ser activados nas próximas 24 horas como umadica. Poderá desligar essa funcionalidade ou configurar o número de alarmes a mostrar e o seuformato na janela de Configuração.

Carregue com o botão esquerdo do rato no ícone da bandeja do sistema para esconder ou mostrara janela principal do KAlarm.

Carregue com o botão direito do rato no ícone da bandeja do sistema para mostrar o seu menude contexto:

Activar os AlarmesActiva ou desactiva a monitorização dos alarmes.Veja a Activação/Desactivação dos Alarmes para mais detalhes.

28

O Manual do KAlarm

Novo AlarmeDepois, poderá seleccionar o tipo de alarme na lista que aparece, que abre a janela de Ediçãode Alarmes para criar um novo alarme.

Parar a Reprodução

Interrompe a reprodução do ficheiro de áudio actualmente em curso.

Espalhar as Janelas

Espalha as janelas de mensagens de alarmes e erros pelo ecrã, ou então volta a agrupá-lasde novo.

Configurar o KAlarm...

Mostra a janela de Configuração do KAlarm.A janela de Configuração está descrita em Configurar o KAlarm. Ela inclui as opções rela-cionadas com o ícone da bandeja do sistema para o KAlarm.

Restaurar / MinimizarRestaura ou minimiza a janela principal do KAlarm.

SairFecha o ícone de bandeja do sistema e as janelas principais do KAlarm.Sai do KAlarm quando não estiverem apresentadas janelas de mensagens de alarme.

2.6.1 Mostrar o KAlarm na Bandeja do Sistema

Deverá estar a correr o ambiente de trabalho Plasma ou outro gestor de janelas adequado paramostrar o KAlarm na bandeja do sistema.

Seleccione Ver → Mostrar na Bandeja do Sistema para mostrar o KAlarm na bandeja do sistema,de acordo com as preferências definidas na página Ver da janela de configuração.

Para remover o KAlarm da bandeja de sistema, desligue a opção Ver → Mostrar na Bandeja doSistema.Para escolher se o KAlarm deverá aparecer ou não, após o arranque, na bandeja do sistema, usea página Ver da janela de Configuração.

2.7 Actualizar os Alarmes

No caso pouco provável de algum alarme não ter sido desencadeado quando o deveria ter sido,poderá actualizar a lista de alarmes e despoletar os alarmes em falta, seleccionado a opção Acções→ Actualizar os Alarmes. Isto fará com que o KAlarm carregue de novo todos os ficheiros ecalendários de calendários.Se precisar de acesso de escrita para os alarmes num calendário que não possa atribuir essas per-missões, você poderá copiar os seus alarmes, importando-os para um calendário com permissõesde escrita, usando a opção do menu de contexto Recarregar. Veja mais detalhes em Calendáriosde Alarmes.

2.8 Activar/Desactivar os Alarmes

Os alarmes poderão ser activados e desactivados por inteiro ou individualmente:

29

O Manual do KAlarm

• A ‘Monitorização de alarmes’ aplica-se aos alarmes como um todo. Quando a monitoriza-ção de alarmes está desactivada, o KAlarm deixa de verificar os alarmes e, como tal, não irádespoletar quaisquer alarmes. Quando a monitorização de alarmes estiver activa (a situaçãonormal), todos os alarmes que não tenham sido desactivados individualmente irão disparar àshoras apropriadas.Quando a monitorização dos alarmes estiver activa de novo, os alarmes que deveriam ter sidodespoletados durante a sua desactivação serão agora activados (a menos que alguma opçãode cancelamento posterior o impeça). Por outras palavras, a desactivação da monitorizaçãodos alarmes tem o mesmo efeito que parar o KAlarm – os alarmes são adiados até à sua novaactivação.

• Os alarmes poderão ser activados ou desactivados individualmente, independentemente doestado de monitorização dos alarmes. Como tal, o estado de activado/desactivado dos alarmesindividuais ficará inalterado se desactivar e voltar a activar a monitorização dos alarmes. Aocontrário da monitorização dos alarmes, que poderá potencialmente ser desactivada devido aofacto do KAlarm não estar a correr ou não estar a funcionar, os alarmes individuais só poderãoser desactivados, se usar os comandos do menu para o fazer.Quando um alarme for reactivado individualmente, não será despoletado agora, no caso deter ficado fora de prazo durante a sua desactivação. Por outras palavras, a desactivação de umalarme individual cancela todas as suas ocorrências até ser activado de novo.O estado de activado/desactivado individual de um alarme é indicado pela sua cor na lista dealarmes (a cor é configurável na página Ver da janela de Configuração).

Para um alarme disparar, deverá estar activo individualmente, assim como a monitorização doalarme deverá estar activa.

2.8.1 Activar a Monitorização de Alarmes

Para a monitorização dos alarmes ocorrer, o KAlarm deverá estar em execução. Assim que exe-cutar o KAlarm, ele iniciar-se-á sempre que você iniciar uma sessão, a menos que o desactiveposteriormente na página Geral da janela de Configuração.

Se a monitorização de alarmes estiver desactivada de momento, faça uma das seguintes acçõespara activar os alarmes:

• Seleccione Acções → Activar Alarmes.

• Carregue com o botão direito do rato no ícone da bandeja do sistema e escolha a opção Activaros Alarmes no menu de contexto.

2.8.2 Desactivar a Monitorização de Alarmes

Poderá desactivar a nível temporário a monitorização dos alarmes que impede o KAlarm de mos-trar os outros alarmes até que volte a activá-los, ou – assumindo que o KAlarm esteja configuradopara ser iniciado após a autenticação – até à próxima vez que se autenticar.

• Seleccione Acções → Activar os Alarmes.

• Carregue com o botão direito no ícone da bandeja do sistema e escolha a opção Activar osAlarmes no menu de contexto.

• Execute o KAlarm com a opção da linha de comandos --disable-all.

• Pare o KAlarm, como se encontra descrito em Sair do KAlarm.

Os alarmes poderão ser desactivados de forma permanente se optar que o KAlarm não deva seriniciado no arranque da sessão, usando a página Geral da janela de Configuração.

30

O Manual do KAlarm

2.8.3 Activar/Desactivar os Alarmes Individualmente

Para activar individualmente os alarmes que estejam desactivados de momento, faça uma dasseguintes acções:

• Seleccione um ou mais alarmes, carregando nos itens respectivos na lista de alarmes. Depois,escolha a opção Acções → Activar.

• Carregue com o botão direito do rato nos itens desejados na lista de alarmes e escolha a opçãoActivar do menu de contexto.

Para desactivar os alarmes individuais que estejam activos de momento, faça uma das seguintesacções:

• Seleccione um ou mais alarmes, carregando nos itens respectivos na lista de alarmes. Depois,escolha a opção Acções → Desactivar.

• Carregue com o botão direito do rato nos itens desejados na lista de alarmes e escolha a opçãoDesactivar do menu de contexto.

2.9 Acordar da Suspensão

É possível configurar um alarme seleccionado para acordar o seu sistema do estado de hibernaçãoou suspensão quando o alarme for activado, para que a acção do alarme possa ocorrer mesmoque o sistema tenha sido desligado. Esta função é controlada por uma janela acedida atravésda selecção da opção Acções → Acordar da Suspensão. A janela permite definir o alarme paraAcordar da Suspensão, assim como cancelá-lo ou realçá-lo.

A utilização desta função necessita de privilégios de administração. Ser-lhe-á pedida a senha doadministrador quando configurar ou cancelar um alarme para acordar da suspensão.

NOTAEsta funcionalidade não é suportada em alguns computadores, especialmente os mais antigos, ealguns só suportam a definição de um tempo de activação nas próximas 24 horas. Poderão tambémexistir algumas restrições sobre o modo de suspensão que a função irá usar. Deverá pensar em testaralguns alarmes, para verificar as capacidades do seu sistema, antes de usar a função efectivamente.

ATENÇÃOO seu computador só poderá agendar um único alarme deste tipo de cada vez. Se usar esta funçãocom o KAlarm, dever-se-á certificar que não entra em conflito com nenhuma outra aplicação quetambém use a funcionalidade para acordar da suspensão. Sempre que uma aplicação agendar oulimpar alarmes deste tipo, serão cancelados os alarmes anteriores, sejam eles definidos pelo KAlarmou por outra aplicação.

A janela para Acordar da Suspensão é usada em conjunto com a lista de alarmes na janela prin-cipal do KAlarm.

• Usar o alarme seleccionado: isto configura o alarme actualmente seleccionado na lista paraser o alarme actual para Acordar da Suspensão. Todos os alarmes deste tipo são cancelados,como está explicado em cima. O botão só fica activo se estiver seleccionado apenas um alarme.

31

O Manual do KAlarm

• Cancelar a activação da suspensão: isto cancela qualquer alarme para Acordar da Suspensãoexistente (quer seja definido pelo KAlarm quer por outra aplicação qualquer - ver acima).Lembre-se que este só cancela a função de activação associada ao alarme; o alarme em si não éremovido e irá continuar a funcionar da forma normal.

• Mostrar o alarme actual: este realça o alarme actual para Acordar da Suspensão na lista dealarmes, para que possa ser identificado. O botão fica desactivado se não estiver configuradonenhum alarme deste tipo.

• O Número de minutos antes de o alarme acordar da suspensão controla a possibilidade de,se o desejar, o sistema ter tempo para se repor por completo antes de o alarme ser despoletado,para que o mesmo possa funcionar na hora correcta.

2.10 Sair do KAlarm

Saia do KAlarm com a opção Ficheiro → Sair ou o item do menu de contexto do ícone da bandejado sistema Sair. Em alternativa, se o ícone da bandeja não estiver vazio, feche todas as janelas doKAlarm.

32

O Manual do KAlarm

Capítulo 3

Configurar o KAlarm

Para configurar a operação do KAlarm de acordo com o seu sistema e com as suas Configuraçãopessoais, seleccione a opção Configuração → Configurar o KAlarm.... Isto mostra a janela deConfiguração.

3.1 Geral

A secção Geral permite-lhe controlar o comportamento global do KAlarm:

• Arrancar no início da sessão: inicia automaticamente o KAlarm no arranque da sessão, apósa autenticação, para garantir que o KAlarm corre a toda a hora, a menos que o termine manu-almente.

ATENÇÃOEsta opção deverá ser sempre assinalada, a menos que pretenda desactivar a utilização do KA-larm.

NOTAEsta opção fica automaticamente seleccionada de novo, sempre que o KAlarm é executado. Porisso, se tiver desligado esta opção e quiser a evitar que o KAlarm se execute no início, terá dedesligar esta opção de novo, de cada vez que executar o KAlarm.

• Avisar antes de sair: Quando os alarmes forem desactivados enquanto o KAlarm não estivera correr, a selecção desta opção pede-lhe uma confirmação se tentar terminar o KAlarm coma opção do ícone da bandeja do sistema Sair. Isto evita que os alarmes sejam desactivadosacidentalmente. Por razões de segurança, esta opção é reactivada automaticamente sempreque mudar de modo de execução.

• Confirmar as remoções dos alarmes: Indique se será questionado para confirmar de cada vezque deseja remover um alarme.

• Intervalo de tempo de adiamento por omissão: Indique o intervalo de tempo por omissão, emhoras e minutos, a mostrar inicialmente quando for apresentada a janela para Adiar o Alarme.Lembre-se que, se um alarme tiver sido anteriormente adiado, o intervalo que é apresentadoinicialmente nessa janela será igual ao intervalo adiado que foi usado no último adiamento.

33

O Manual do KAlarm

• Terminal para os Comandos de Alarme: Aqui poderá seleccionar o tipo de janela de terminalque será usado para os alarmes de comandos a serem executados numa janela de terminal. Al-gumas das aplicações de janelas de terminais estão pré-configuradas, isto é o xterm, o Konsole,ainda que só sejam visíveis os que estiverem instalados aqui. Poderá ver as opções actuais docomando que são usadas por cada aplicação, mostrando a ajuda de contexto para a sua opçãorespectiva.Se quiser usar outra aplicação ou quiser usar uma das que se encontram listadas, só que comopções do comando diferentes, seleccione Outro e indique o comando para invocar a janelado terminal. Por omissão, o texto do comando do alarme será adicionado ao que indicar. Emalternativa, poderá indicar onde é que o texto do comando do alarme será introduzido, usandoum dos seguintes códigos:

%cO texto do comando do alarme será substituído.

%wO texto do comando do alarme será substituído, com um sleep adicionado.

%CUm ficheiro de comando temporário, contendo o texto do comando do alarme, será cri-ado, sendo substituído o comando para executar o ficheiro.

%WUm ficheiro de comando temporário, contendo o texto do comando do alarme, será cri-ado com um sleep adicionado, sendo substituído o comando para executar o ficheiro.

%to nome do KAlarm na língua actual será substituído.

Quando o alarme do comando for despoletado, o seu texto de comando será rodeado de aspasantes de ser introduzido no comando da janela de terminal.

3.2 Data & Hora

A secção Data & Hora permite-lhe escolher as opções relacionadas com a data e hora:

• Fuso-horário: Seleccione o seu fuso-horário. O KAlarm usa este fuso-horário em todo o lado,excepto quando o substituir nos alarmes individuais.

• Região dos feriados: Seleccione quais os feriados do país ou região a usar. Isto afecta osalarmes recorrentes, para os quais está seleccionada a opção de exclusão dos feriados.

• Início do dia para os alarmes por data: Define a hora do início do dia para o caso da activaçãodos alarmes apenas por data, isto é os que têm a opção A qualquer hora seleccionada. Quandochegar a data exacta, estes alarmes serão activados na primeira oportunidade que for possíveldurante as 24 horas, a ter início na hora do início do dia.

• Grupo do Horário de Trabalho: Estas opções permitem-lhe definir o seu horário de trabalho, oque é necessário quando a opção Apenas durante o horário de trabalho for seleccionada parauma recorrência na janela de Edição do Alarme.

– Assinale todos os dias de trabalho.– Hora inicial do dia: indique a hora para a qual começa a trabalhar todos os dias.– Hora final do dia: indique a hora em que termina o trabalho todos os dias.

• Duração do evento do KOrganizer: Indique a duração do evento a definir no KOrganizer paraos alarmes que são copiados para o KOrganizer. A duração por omissão corresponde a zero.

34

O Manual do KAlarm

3.3 Armazenamento

A secção Armazenamento permite-lhe escolher as opções para gravar e arquivar os alarmes:

• Novos Alarmes & Modelos: Indique o calendário onde gravar os alarmes e modelos novos,ao usar calendários com vários alarmes:

– Guardar no calendário predefinido: Os alarmes e modelos novos são adicionados automa-ticamente ao calendário predefinido, sem pedir qualquer confirmação.

– Perguntar o calendário onde gravar: Quando criar um alarme ou modelo novo, e existirmais que um calendário com possibilidades de gravação, será questionado para escolher ocalendário onde o gravar. Lembre-se que, quando os alarmes forem gravados ao expirarem,eles são sempre gravados no alarme predefinido de arquivo, sem qualquer questão.

• Grupo dos Alarmes Arquivados: Estas opções controlam o armazenamento dos alarmes ar-quivados no calendário predefinido para os alarmes arquivados.

– Manter os alarmes depois de expirarem: Seleccione esta opção para armazenar os alarmesexpirados e removidos. Desligue-a para não guardar nenhum registo dos alarmes, logo queestes deixem de estar activos. Lembre-se que os alarmes removidos só são guardados se tive-rem sido despoletados anteriormente. Se remover um alarme antes de este ser despoletado,será descartado.

– Descartar os alarmes arquivados ao fim de: Indique o número de dias para guardar osalarmes arquivados e removidos, após os quais eles serão removidos de forma permanente.

– Limpar os alarmes arquivados: Este botão limpa todos os alarmes arquivados que estejamarmazenados no calendário predefinido para alarmes arquivados (Os outros calendários sãodeixados inalterados, no caso de estarem partilhados com outras pessoas). Isto não faz efeitonos alarmes que irão expirar a seguir; eles continuarão a ser guardados de acordo com asopções seleccionadas.

3.4 E-mail

A secção E-mail permite-lhe escolher as opções para enviar e endereçar os alarmes por e-mail:

• Cliente de e-mail: Indique o cliente de e-mail que será usado para enviar os alarmes por e-mail:– KMail: Quando um alarme de e-mail é activado, o e-mail é enviado automaticamente, utili-

zando o KMail (que é iniciado primeiro, se for necessário).– Sendmail: Quando é despoletado um alarme por e-mail, a mensagem é enviada automati-

camente com o sendmail®. Esta opção só irá funcionar se o seu sistema estiver configuradopara usar o sendmail® ou um agente de transporte de e-mail compatível com o sendmail®,como o postfix ou o qmail.

• Copiar os e-mails enviados para a pasta de enviados do KMail: Seleccione esta opção se,de cada vez que um alarme por e-mail for despoletado, quiser que uma cópia da mensagemtransmitida seja guardada na pasta enviado do KMail.

NOTAEsta opção não está disponível quando o KMail está seleccionado como o cliente de e-mail, dadoque o KMail faz isto automaticamente.

• Notificar quando os e-mails remotos ficam em espera: Seleccione esta opção para mostraruma notificação, sempre que um alarme por e-mail deixa uma mensagem em espera para serenviada para um sistema remoto. Isto pode ser útil se, por exemplo, você tiver uma ligaçãotelefónica ou se a mensagem fica em espera na pasta do KMail A enviar, de modo que possagarantir que faz tudo o que é necessário para enviar de facto a mensagem.

35

O Manual do KAlarm

• Seleccione o seu endereço de e-mail a usar como endereço do remetente nas mensagens dealarme:

– Seleccione De para indicar um endereço de e-mail.– Seleccione a opção Usar as identidades do KMail para poder escolher, na altura em que

configurar um alarme por e-mail, qual das identidades de e-mail que o KMail irá usar. Aidentidade por omissão do KMail será usada para os alarmes que já foram configurados,antes de seleccionar esta opção.

• Seleccione o seu endereço de e-mail a usar para enviar as cópias invisíveis dos alarmes pore-mail para si próprio, quando a opção Copiar o e-mail para o próprio estiver seleccionada:

– Seleccione o Bcc para indicar um endereço de e-mail. Se as cópias invisíveis deverão serenviadas para a sua conta, no computador em que o KAlarm está a correr, poderá simples-mente indicar o seu nome de utilizador aqui.

3.5 Ver

A secção Ver permite-lhe controlar alguns aspectos da aparência do KAlarm. Na página Geral:

• Mostrar na bandeja do sistema: Quando estiver seleccionado, o ícone da bandeja do sistemaé sempre apresentado enquanto o KAlarm estiver a correr, sujeito à opção seleccionada:

– Mostrar sempre: O ícone da bandeja está sempre visível.– Esconder automaticamente se não existirem alarmes activos: O ícone da bandeja está es-

condido se não existirem alarmes activos.– Esconder automaticamente se nenhum alarme expirar no período de tempo: O ícone da

bandeja é escondido se nenhum alarme for activado dentro do período de tempo indicado,a partir de agora.

Quando o ícone da bandeja está escondido automaticamente, podê-lo-á tornar visível de novocom a opção da bandeja para mostrar os ícones escondidos.Quando a opção Mostrar na bandeja do sistema estiver seleccionada, ao fechar o ícone dabandeja do sistema, fecha todas as janelas principais do KAlarm se não estiver nenhuma janelade mensagem visível, sai da aplicação.

• Grupo da Dica da Bandeja do Sistema: Estas opções controlam a informação que é apresen-tada na dica que aparece, sempre que o cursor do rato pára em cima do ícone da bandeja dosistema do KAlarm.

– Mostrar os alarmes das próximas 24 horas: Quando estiver seleccionada a opção, é mos-trado um resumo dos primeiros alarmes que irão ser despoletados nas próximas 24 horas.

– Número máximo de alarmes a mostrar: Desligue esta opção para mostrar todos os alarmesdas próximas 24 horas. Seleccione-a para definir o número máximo de alarmes que serãoenumerados.

– Mostrar a hora do alarme: Seleccione esta opção para mostrar a hora para a qual cada alarmeestá agendado.

– Mostrar a hora até ao alarme: Seleccione esta opção para mostrar o período de tempo quefalta até à próxima ocorrência de cada alarme. O período de tempo é definido em horas eminutos.* Prefixo: Indique um símbolo ou texto a mostrar à frente do período de tempo até ao

alarme, para o distinguir da hora para a qual foi agendado o alarme.

• O grupo da Lista de Alarmes permite a selecção das cores usadas na lista de alarmes da janelaprincipal do KAlarm, de modo a mostrar os alarmes desactivados e arquivados.

A página Janelas de Alarmes contém opções que controlam a aparência das janelas de mensa-gens de alarme.

36

O Manual do KAlarm

• Posicionar as janelas longe do cursor do rato: Seleccione esta opção para mostrar as janelasde mensagens de alarme o mais longe possível da posição actual do cursor. Isto minimiza ahipótese de aceitar sem querer um alarme, carregando de forma não-intencional num botão,logo que apareça a janela do alarme.

• Centrar as janelas, atrasar a activação dos botões da janela: Seleccione esta opção para mos-trar as janelas das mensagens dos alarmes no centro do ecrã. Para reduzir a hipótese de aceitarsem querer um alarme, os botões da janela aparecem desactivados inicialmente. O atraso emsegundos antes da sua activação é definido na opção Atraso de activação do botão (segundos).

• As janelas de mensagens têm uma barra de título e capturam o teclado: Esta opção controlase as janelas das mensagens de alarmes são modais ou não, isto é se capturam os eventosdo teclado logo que aparecem. Veja a secção da Janela das Mensagens de Alarme para maisdetalhes.

3.6 Editar

A secção Editar permite-lhe escolher os valores por omissão para as opções na janela de Ediçãodo Alarme:

• A página Geral contém opções que se aplicam a todos os tipos de alarmes.

– Configura os estados por omissão para as opções Mostrar no KOrganizer ou Cancelar seatrasado.

– Mudar o tipo de recorrência predefinido.– Seleccione o tratamento por omissão, nos anos não-bissextos, das recorrências anuais agen-

dadas para 29 de Fevereiro.

• A página de Tipos de Alarmes contém opções que se aplicam a tipos específicos de alarmes.

– Para os alarmes visíveis:* Configura os estados por omissão para as opções Fechar automaticamente a janela ao fim

deste tempo e Confirmar a recepção.

* Configura as unidades dos períodos das chamadas de atenção por omissão.

* Configura as acções de apresentação especiais dos alarmes por omissão.

* Configura as opções por omissão do som. Lembre-se que poderá ser indicado um ficheirode som por omissão, mesmo que o tipo de som não esteja como Ficheiro de som.

– Para os alarmes de comandos:* Configura os estados por omissão para as opções Indicar um programa ou Executar numa

janela de terminal.– Para os alarmes de e-mail:

* Configura o estado predefinido para a opção Copiar o e-mail para o próprio.

• A página Tipo de Letra & Cor permite-lhe definir a aparência por omissão das mensagens dealarmes. Seleccione o tipo de letra por omissão e as cores principal e de fundo.

37

O Manual do KAlarm

Capítulo 4

Operação com a Linha de Comandos

Quando são fornecidos parâmetros na linha de comandos, o KAlarm não mostra a lista de alar-mes agendados, tal como foi descrito acima em Usar o KAlarm. As opções da linha de comandosespecíficas do KAlarm poderão ser usadas para efectuar as seguintes operações:

• escalonar um novo alarme

• controlar o modo de apresentação do KAlarm

• obter ajuda

As opções adicionais da linha de comandos são oferecidas em primeiro lugar para permitir aosoutros programas interagirem com o KAlarm. Elas estão descritas no capítulo do Guia do Pro-gramador do KAlarm.

A linha de comandos só poderá conter as opções que se apliquem a uma operação do KAlarm. Sequiser efectuar várias operações, terá de invocar o KAlarm várias vezes com um conjunto únicode opções de cada vez.

4.1 Escalonar um Novo Alarme

As seguintes opções são utilizar para escalonar um novo alarme:

Opção Descrição

-a, --ack-confirm Pede uma confirmação quando amensagem de alarme for recebida.

-A, --attach URL

Indica o nome ou o URL de um ficheiro quedeverá ser anexado à mensagem de e-mail.Esta opção poderá ser repetida tantas vezesquantas as necessárias. O --mail terá de serfornecido com esta opção.

--auto-close

Fecha automaticamente a janela do alarme,depois de terminar o período indicado coma opção --late-cancel. A opção--late-cancel deverá ser indicada comesta opção.

-b, --beep

Toca uma campainha audível quando amensagem for apresentada. O --speak, o--play e o --play-repeat não poderão serindicados com esta opção.

38

O Manual do KAlarm

--bccEnvia uma cópia invisível para si próprio.O --mail necessita ser indicado com estaopção.

-c, --color, --colour corIndica a cor de fundo da mensagem com onome da cor no Qt™ ou com o códigohexadecimal 0xRRGGBB.

-C, --colorfg, --colourfg corIndica a cor do texto da mensagem com onome da cor no Qt™ ou com o códigohexadecimal 0xRRGGBB.

-d, --disable Desactiva o alarme. Não irá disparar atéque tenha sido activado manualmente.

--disable-all

Desactiva a monitorização do alarme. Istoimpede que todos os alarmes sejamdespoletados até que os reactive ou quereinicie o KAlarm, isto é no início dapróxima sessão. O --triggerEvent nãopode ser indicado com esta opção.

-e, --exec linha de comandos

Indica um comando a executar. Se forfornecida, esta opção deverá ser a últimaopção da linha de comandos do KAlarm.Todos os parâmetros subsequentes e asopções são interpretados como formando alinha de comandos a executar. O --file, o--exec-display e o --mail não podem serindicados com esta opção. O--ack-confirm, o --beep, o --color e o--colorfg são ignorados com esta opção.

-E, --exec-display linha de comandos

Indica um comando a executar. Se forfornecida, esta opção deverá ser a últimaopção da linha de comandos do KAlarm.Todos os parâmetros subsequentes e asopções são interpretados como formando alinha de comandos a executar. O --exec, o--file e o --mail não podem ser indicadoscom esta opção.

-f, --file URL

Indica o nome ou o URL de um ficheiro detexto ou de imagem cujo conteúdo iráformar a mensagem de alarme. O --exec, o--exec-display e o --mail não poderão serindicados e a mensagem não deverá estarpresente com esta mensagem.

-F, --from-id IDUsa a identidade do KMail indicada comoremetente da mensagem de e-mail. O--mail deverá ser indicado com esta opção.

39

O Manual do KAlarm

-i, --interval período

Indica o intervalo entre repetições doalarme. As horas/minutos são indicados noformato nHnM , em que o n é um número,isto é 3H30M. Os outros períodos de temposão indicado no formato nX, em que o n éum número e o X é uma das seguintesletras: Y (’years’ - anos), M (’months’ -meses), W (’weeks’ - semanas), D (’days’ -dias). Se a opção --recurrence for tambémindicada, o Y (anos) e M (meses) não sãopermitidos. A opção é obrigatória se forusada a --until ou a --repeat.

-k, --korganizer Mostra o alarme como um evento nocalendário activo do KOrganizer.

-l, --late-cancel período

Cancela o alarme se não puder serdespoletado no período após a hora actual.As horas/minutos são indicados noformato nHnM , em que o n é um número,isto é 3H30M. Os outros períodos de temposão indicado no formato nX, em que o n éum número e o X é uma das seguintesletras: W (’weeks’ - semanas), D (’days’ -dias). O valor por omissão do período é 1minuto.

-L, --login

Dispara o alarme sempre que você se liga,após a autenticação. O --interval, o--repeat e o --until não podem serfornecidos com esta opção.

-m, --mail endereço

Envia uma mensagem de e-mail para oendereço indicado. Esta opção pode serrepetida tantas vezes quantas asnecessárias. O --exec, o --exec-display eo --file não podem ser indicados com estaopção. O --ack-confirm, o --beep, o--color e o --colorfg são ignorados comesta opção.

-p, --play URL

Indica o nome ou o URL de um ficheiro deáudio a ser tocado uma vez, quer como umalarme por áudio ou quando a mensagemde alarme for apresentada. O--play-repeat, o --beep e o --speak nãopodem ser indicados com esta opção.

-P, --play-repeat URL

Indica o nome ou o URL de um ficheiro deáudio a ser tocado repetidamente,enquantonão for carregado o botão Parar aReprodução ou a mensagem de alarmeestiver visível. O --play, o --beep e o--speak não podem ser indicados com estaopção.

40

O Manual do KAlarm

--recurrence especificação

Indica o alarme a repetir. Especifique arepetição com a sintaxe do iCalendar(definida no RFC2445), isto é‘FREQ=MONTHLY;COUNT=4;INTERVA-L=3;BYDAY=-1MO’. O --until não podeser indicado com esta opção.

-r, --repeat contagem

Indica o número de vezes que o alarmedeverá ser despoletado ou, se for indicadauma recorrência com a opção--recurrence, o número de vezes que oalarme deverá ser despoletado de cada vezque o --recurrence o activar (isto é umarepetição dentro de uma recorrência). Se aopção --recurrence não estiver presente,indique -1 para repetir o alarmeindefinidamente. O --interval deverá serindicado, ainda que o --until não o possaser, com esta opção.

-R, --reminder período

Mostra um alarme de chamada de atençãono período de tempo antes ou depois doalarme principal e de cada uma das suasrepetições (se houverem). O período éindicado no mesmo formato que no--late-cancel. Por omissão, a chamada deatenção irá ocorrer antes do alarme. Paraindicar uma chamada de atenção após oalarme, anteceda o período com o prefixo+, isto é +3D. Esta opção não pode serusada com o --exec, o --mail ou o--reminder-once.

--reminder-once período

Mostra um alarme de chamada de atençãoapenas uma vez, no período de tempo antesou depois da primeira ocorrência doalarme. O período é indicado no mesmoformato que em --reminder. Esta opçãonão poderá ser indicada com a --exec,--mail ou a --reminder.

-s, --speak

Fala a mensagem quando esta forapresentada. Esta opção necessita de ter oJovie instalado e configurado com umsintetizador de fala compatível. O --beep, o--play e o --play-repeat não poderão serindicados com esta opção.

-S, --subject assuntoA linha do assunto da mensagem de e-mail.O --mail deverá ser indicado com estaopção.

41

O Manual do KAlarm

-t, --time data/hora

Despoleta o alarme na data ou nadata/hora indicadas. Indique uma datasem hora no formato aaaa-mm-dd [FH];por outro lado, indique uma data e horacom [[[aaaa-]mm-]dd-]hh:mm [FH] Senão tiver sido escolhido nenhumfuso-horário, assume-se o fuso-horário dosistema local. Se estiver presente umindicador de fuso-horário FH , poderá ser onome de um fuso-horário de sistema (isto éEuropa/Londres), UTC - representando ofuso-horário UTC ou Clock para usar orelógio do computador local e ignorar osfusos-horários.

--triggerEvent idEventoDespoletar o alarme com o identificadorindicado.

-v, --volume percentagem

Define o volume do áudio para tocar oficheiro de áudio. Esta opção só poderá serusada quando o --play ou o --play-repeatforem também usados.

-u, --until data/hora

Repete o alarme até à data ou data/horaindicadas. Indique a data ou data/horacom a mesma sintaxe usada no --time.Lembre-se que, se for usada a opção--time, o fuso-horário será retirado a partirdo seu valor e não será incluída nenhumfuso-horário no valor --until. O--interval deverá ser usado, enquanto queo --repeat e o --recurrence não poderãoser usados, com esta opção.

mensagem

O texto da mensagem a mostrar ou, se o--mail for indicado, o corpo da mensagemde e-mail.

Tanto deverá ser usado um texto de mensagem, o --file, o --exec, o --exec-display, o --playou o --play-repeat; excepto nos casos acima indicados, todas as opções são opcionais.

Aqui estão dois exemplos alternativos que mostram uma mensagem em várias linhas com umfundo vermelho às 22 horas, no dia 27 deste mês:

% kalarm -c red -t 27-22:00 "Lembre -se de\nPARAR"% kalarm -c 0xFF0000 -t 27-22:00 "Lembre -se de \nPARAR"

4.2 Outras Opções

As opções seguintes são usadas para mostrar a janela de Edição de Alarmes.

Opção Descrição

--edit idEventoMostra a janela de Edição de Alarmes paraeditar o alarme com o identificadorindicado.

42

O Manual do KAlarm

--edit-new-audioMostra a janela de Edição de Alarmes paraeditar um novo alarme de áudio.

--edit-new-commandMostra a janela de Edição de Alarmes paraeditar um novo alarme por comando.

--edit-new-displayMostra a janela de Edição de Alarmes paraeditar um novo alarme visível.

--edit-new-emailMostra a janela de Edição de Alarmes paraeditar um novo alarme por e-mail.

--edit-new-preset nomeModelo

Mostra a janela de Edição do Alarme,predefinida com o modelo de alarme com onome indicado, para editar um alarmenovo.

--list

Apresenta uma lista com os alarmesagendados no stdout. A lista mostra brevesdetalhes sobre cada alarme pendente: o seuidentificador de recurso (se usar oAkonadi), o UID, a hora da próximaocorrência e o texto ou o ficheiro damensagem.

--trayMostra o KAlarm como um ícone nabandeja do sistema.

--disable-allDesactiva a monitorização de todos osalarmes.

Ver também:

kf5options(7)qt5options(7)

43

O Manual do KAlarm

Capítulo 5

Guia de Programador do KAlarm

O KAlarm oferece uma interface para permitir às outras aplicações pedirem as seguintes funções:

• escalonar um novo alarme

• cancelar um alarme já agendado

• disparar um alarme já agendado

• mostra a janela de Edição do Alarme

• apresentar os alarmes agendados

Cada uma das funções acima está implementada através de uma chamada de D-Bus e através dalinha de comandos. As chamadas do D-Bus deverão ser usadas de preferência se o KAlarm jáestiver em execução.

5.1 A Interface de D-Bus

As chamadas de D-Bus descritas neste documento estão todas implementadas no local de D-Bus /kalarm do KAlarm. A interface está definida nos ficheiros org.kde.kalarm.kalarm.xml ekalarmiface.h.

5.1.1 cancelEvent

Nome

cancelEvent – cancela um alarme já agendado.

Synopsis

void cancelEvent(const QString& idEvento)

Parâmetros

idEvento

Indica o identificador único do evento a cancelar.

44

O Manual do KAlarm

Descrição

O cancelEvent() é uma chamada de D-Bus para cancelar o alarme indicado. O KAlarm apaga oalarme do calendário sem o mostrar ou executar.

5.1.2 triggerEvent

Nome

triggerEvent – despoleta um alarme já escalonado.

Synopsis

void triggerEvent(const QString& idEvento)

Parâmetros

idEvento

Indica o identificador único do evento a ser despoletado.

Descrição

O triggerEvent() é uma chamada de D-Bus para disparar o alarme indicado (independente-mente da hora para que foi agendado). O KAlarm obtém o alarme do ficheiro de calendário edepois mostra-o ou executa-o.

Se o alarme já tiver sido disparado, o KAlarm irá então remover todas as ocorrências agendadasdo alarme até à hora actual e, se não existirem mais repetições do alarme, este é removido docalendário. Se ainda não chegou a sua hora, as suas ocorrências agendadas são deixadas semalterações.

5.1.3 scheduleMessage

Nome

scheduleMessage – escalonar uma nova mensagem de alarme.

Synopsis

bool scheduleMessage(const QString& mensagem, const QString& dataHora, int cancelarSeAtrasado, unsigned opcoes, const QString& corFundo, const QString& corTexto, const QString& tipoLetra, const KURL& urlAudio, int chamadaAtencao, constQString& recorrencia, int intervaloSubRepeticoes, int numeroSubRepeticoes)

bool scheduleMessage(const QString& mensagem, const QDateTime& dataHora, constQColor& fundo, const QColor& texto, int cancelarSeAtrasado, unsigned opções,const QString& urlAudio, int chamadaAtencao, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)

bool scheduleMessage(const QString& mensagem, const QDateTime& dataHora, constQColor& fundo, const QColor& texto, int cancelarSeAtrasado, unsigned opções,const QString& urlAudio, int chamadaAtencao, int tipoRepeticaoSimples, int intervalo, const QDateTime& dataFim)

45

O Manual do KAlarm

Parâmetros

mensagem

Define o texto da mensagem a ser agendada ou, se as opções tiverem o bit DISPLAY_COMMAND activo, indica a linha de comandos a executar para gerar o texto da mensagem.

dataHoraInicial

Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para umalarme apenas de data, o texto deverá estar no formato ‘AAAA-MM-DD [TZ]’ (tal como édevolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o textodeverá estar no formato ‘AAA-MM-DDTHH:MM[:SS] [TZ]’ (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em ‘HH:MM[:SS] [Relógio]’ (tal como é devolvidopelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a datade hoje. Lembre-se que o valor dos segundos é ignorado.Se não tiver sido escolhido nenhum fuso-horário, assume-se o fuso-horário do sistema local.Se estiver presente um indicador de fuso-horário FH , poderá ser o nome de um fuso-horáriode sistema (isto é Europa/Londres), UTC - representando o fuso-horário UTC ou Clockpara usar o relógio do computador local e ignorar os fusos-horários.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indi-cado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarmenão será cancelado, independentemente do atraso com que é disparado.

opções

Indica o OU lógico das opções desejadas para o alarme. Os ’bits’ das opções são os queestão definidos na classe KAlarmIface no ficheiro kalarmiface.h. Repare que nem todos os’bits’ de opções se aplicam aos alarmes de mensagens.

fundo

Indica a cor de fundo usada para mostrar a mensagem. O texto poderá estar no formato‘#RRGGBB’ (tal como é devolvido pelo QColor::name()) onde o RR, GG and BB são valoresde dois algarismos em hexadecimal para o vermelho, verde e azul. Em alternativa, o textopoderá ser qualquer um dos outros formatos aceites pelo QColor::setNamedColor(), comoo nome de uma cor na base de dados de cores do X (isto é ‘red’ ou ‘steelblue’). Ponha otexto vazio para indicar a cor de fundo por omissão actual.

texto

Indica a cor do texto usada para mostrar a mensagem. O formato do texto é o mesmo quepara o fundo; em alternativa, poderá pôr o texto nulo para indicar a cor de texto actual-mente por omissão.

tipoLetra

Indica o tipo de letra a usar para mostrar a mensagem. O formato do texto é o devolvidopelo QFont::toString(). Configure o texto como nulo, para usar o tipo de letra de mensa-gens actual, na altura em que é mostrada a mensagem.

urlAudio

Indica o ficheiro de áudio a ser tocado quando for mostrada a mensagem. Configure o valorcomo nulo se não for para tocar nenhum ficheiro.

minutosChamadaAtencao

Indica o número de minutos de avanço em relação ao alarme principal e a cada uma dassuas repetições (se existirem) no qual será mostrado um alarme de chamada de atenção.Indique um valor negativo para uma chamada de atenção ser apresentada após o alarmeprincipal. Indique 0 se não for necessária nenhuma chamada de atenção.

46

O Manual do KAlarm

recorrência

Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está de-finida no RFC2445. Por exemplo, ‘FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO’ deverá indicar 4 repetições trimestrais na última Segunda-Feira do mês). Para umalarme não repetitivo, indique uma cadeia de caracteres vazia.

tipoRecorrencia

Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEE-KLY, MONTHLY, YEARLY. Estes estão definidos na classe KAlarmIface no kalarmiface.h.As repetições mensais são no dia do tipo de mês, assim como as repetições anuais são àdata do tipo de ano, com a data extraída, em ambos os casos, a partir do parâmetro dataHoraInicial.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido noparâmetro tipoRecorrencia) entre repetições do alarme.

numeroRepeticoes

Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarmeindefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluiruma hora, este parâmetro deverá também incluir uma hora; se o dataHoraInicial conterapenas uma data, este parâmetro também deverá apenas conter uma data. Não deveráconter um indicador de fuso-horário; é usado o mesmo fuso-horário do dataHoraInicialpara interpretar o valor deste parâmetro.

intervaloSubRepeticoes

Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrerqualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.

numeroSubRepeticoes

Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.

Descrição

O scheduleMessage() é uma chamada de D-Bus para agendar a mensagem de alarme forne-cida para a data e hora indicadas. Tem várias formas possíveis. As forma mais geral permite aindicação de uma recorrência arbitrária para ser indicada – use também estas para os alarmesnão-repetitivos. As outras formas oferecem um acesso conveniente a um conjunto restrito de ti-pos de recorrências de alarmes, uma para uma quantidade de repetições e a outra até uma horade fim.Se a hora agendada (incluindo as repetições) já tiver passado, o KAlarm mostra imediatamentea mensagem (a menos que o parâmetro cancelarSeAtrasado indique que já é muito tarde paramostrar o alarme onde, nesse caso, ignora o pedido). Se a hora agendada (ou a da repetição)for no futuro, o KAlarm adiciona a mensagem de alarme ao ficheiro do calendário para mostrarposteriormente.

5.1.4 scheduleFile

Nome

scheduleFile – agendar um novo alarme que mostra o conteúdo de um ficheiro de texto ou deimagem.

47

O Manual do KAlarm

Synopsis

bool scheduleFile(const KURL& URL, const QString& dataHora, int cancelarSeAtrasado, unsigned opcoes, const QString& corFundo, const KURL& urlAudio, int minutosChamadaAtencao, const QString& recorrencia, int intervaloSubRepeticoes, intnumerSubRepeticoes)

bool scheduleFile(const QString& URL, const QDateTime& dataHora, const QColor&fundo, int cancelarSeAtrasado, unsigned opcoes, const QString& urlAudio, intminutosChamadaAtencao, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)

bool scheduleFile(const QString& URL, const QDateTime& dataHora, const QColor&fundo, int cancelarSeAtrasado, unsigned opcoes, const QString& urlAudio, int minutosChamadaAtencao, int tipoRepeticaoSimples, int intervalo, const QDateTime&dataFim)

Parâmetros

URL

Indica o ficheiro de texto ou imagem cujo conteúdo seja apresentado na mensagem a seragendada.

dataHoraInicial

Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para umalarme apenas de data, o texto deverá estar no formato ‘AAAA-MM-DD [TZ]’ (tal como édevolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o textodeverá estar no formato ‘AAA-MM-DDTHH:MM[:SS] [TZ]’ (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em ‘HH:MM[:SS] [Relógio]’ (tal como é devolvidopelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a datade hoje. Lembre-se que o valor dos segundos é ignorado.Se não tiver sido escolhido nenhum fuso-horário, assume-se o fuso-horário do sistema local.Se estiver presente um indicador de fuso-horário FH , poderá ser o nome de um fuso-horáriode sistema (isto é Europa/Londres), UTC - representando o fuso-horário UTC ou Clockpara usar o relógio do computador local e ignorar os fusos-horários.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indi-cado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarmenão será cancelado, independentemente do atraso com que é disparado.

opções

Indica o OU lógico das opções desejadas para o alarme. Os ’bits’ das opções são os queestão definidos na classe KAlarmIface do kalarmiface.h. Repare que nem todos os ’bits’de opções se aplicam aos alarmes de ficheiros.

fundo

Indica a cor de fundo usada para mostrar o ficheiro. O texto poderá estar no formato‘#RRGGBB’ (tal como é devolvido pelo QColor::name()) onde o RR, GG and BB são va-lores de dois algarismos em hexadecimal para o vermelho, verde e azul. Em alternativa, otexto poderá ser qualquer um dos formatos aceites pelo QColor::setNamedColor(), com onome de uma cor na base de dados de cores do X (isto é ‘red’ ou ‘steelblue’). Ponha o textovazio para indicar a cor de fundo por omissão actual.

urlAudio

Indica o ficheiro de áudio a ser tocado quando for mostrada a mensagem. Configure o valorcomo nulo se não for para tocar nenhum ficheiro.

48

O Manual do KAlarm

minutosChamadaAtencao

Indica o número de minutos de avanço em relação ao alarme principal e a cada uma dassuas repetições (se existirem) no qual será mostrado um alarme de chamada de atenção.Indique um valor negativo para uma chamada de atenção ser apresentada após o alarmeprincipal. Indique 0 se não for necessária nenhuma chamada de atenção.

recorrência

Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está de-finida no RFC2445. Por exemplo, ‘FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO’ deverá indicar 4 repetições trimestrais na última Segunda-Feira do mês). Para umalarme não repetitivo, indique uma cadeia de caracteres vazia.

tipoRecorrencia

Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEE-KLY, MONTHLY, YEARLY. Estes estão definidos na classe KAlarmIface no kalarmiface.h.As repetições mensais são no dia do tipo de mês, assim como as repetições anuais são àdata do tipo de ano, com a data extraída, em ambos os casos, a partir do parâmetro dataHoraInicial.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido noparâmetro tipoRecorrencia) entre repetições do alarme.

numeroRepeticoes

Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarmeindefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluiruma hora, este parâmetro deverá também incluir uma hora; se o dataHoraInicial conterapenas uma data, este parâmetro também deverá apenas conter uma data. Não deveráconter um indicador de fuso-horário; é usado o mesmo fuso-horário do dataHoraInicialpara interpretar o valor deste parâmetro.

intervaloSubRepeticoes

Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrerqualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.

numeroSubRepeticoes

Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.

Descrição

O scheduleFile() é uma chamada de D-Bus para agendar o ficheiro de texto ou de imagem paraa data e hora indicadas. Para além de indicar o nome ou URL de um ficheiro e omitir a cor dotexto, a sua utilização é idêntica à do scheduleMessage - veja a descrição dessa função para maisdetalhes.

5.1.5 scheduleCommand

Nome

scheduleCommand – agenda um novo alarme que executa um determinado comando.

49

O Manual do KAlarm

Synopsis

bool scheduleCommand(const QString& linhaComandos, const QString& dataHora, intcancelarSeAtrasado, unsigned opcoes, const QString& recorrencia, int intervaloSubRepeticoes, int numeroSubRepeticoes)

bool scheduleCommand(const QString& linhaComandos, const QDateTime& dataHora, intcancelarSeAtrasado, unsigned opcoes, int tipoRepeticaoSimples, int intervalo,int numeroRepeticoes)

bool scheduleCommand(const QString& linhaComandos, const QDateTime& dataHora, intcancelarSeAtrasado, unsigned opcoes, int tipoRepeticaoSimples, int intervalo,const QDateTime& dataFim)

Parâmetros

commandLine

Indica o comando cuja execução será agendada. O parâmetro opções indica se este parâ-metro contém uma linha de comandos ou o nome de um programa.

dataHoraInicial

Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para umalarme apenas de data, o texto deverá estar no formato ‘AAAA-MM-DD [TZ]’ (tal como édevolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o textodeverá estar no formato ‘AAA-MM-DDTHH:MM[:SS] [TZ]’ (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em ‘HH:MM[:SS] [Relógio]’ (tal como é devolvidopelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a datade hoje. Lembre-se que o valor dos segundos é ignorado.Se não tiver sido escolhido nenhum fuso-horário, assume-se o fuso-horário do sistema local.Se estiver presente um indicador de fuso-horário FH , poderá ser o nome de um fuso-horáriode sistema (isto é Europa/Londres), UTC - representando o fuso-horário UTC ou Clockpara usar o relógio do computador local e ignorar os fusos-horários.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indi-cado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarmenão será cancelado, independentemente do atraso com que é disparado.

opções

Indica o OU lógico das opções desejadas para o alarme. Os ’bits’ das opções são os queestão definidos na classe KAlarmIface do kalarmiface.h. Repare que nem todos os ’bits’de opções se aplicam aos alarmes de comandos.

recorrência

Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está de-finida no RFC2445. Por exemplo, ‘FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO’ deverá indicar 4 repetições trimestrais na última Segunda-Feira do mês). Para umalarme não repetitivo, indique uma cadeia de caracteres vazia.

tipoRecorrencia

Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEE-KLY, MONTHLY, YEARLY. Estes estão definidos na classe KAlarmIface no kalarmiface.h.As repetições mensais são no dia do tipo de mês, assim como as repetições anuais são àdata do tipo de ano, com a data extraída, em ambos os casos, a partir do parâmetro dataHoraInicial.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido noparâmetro tipoRecorrencia) entre repetições do alarme.

50

O Manual do KAlarm

numeroRepeticoes

Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarmeindefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluiruma hora, este parâmetro deverá também incluir uma hora; se o dataHoraInicial conterapenas uma data, este parâmetro também deverá apenas conter uma data. Não deveráconter um indicador de fuso-horário; é usado o mesmo fuso-horário do dataHoraInicialpara interpretar o valor deste parâmetro.

intervaloSubRepeticoes

Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrerqualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.

numeroSubRepeticoes

Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.

Descrição

O scheduleCommand() é uma chamada de D-Bus para agendar o comando da consola para serexecutado na data e hora indicadas. Para além de indicar uma linha de comandos e de omitir acor do texto e o parâmetro do ficheiro de áudio, a sua utilização é idêntica à do scheduleMessage- veja a descrição dessa função para mais detalhes.

5.1.6 scheduleEmail

Nome

scheduleEmail – agenda um novo alarme que envia uma mensagem de e-mail.

Synopsis

bool scheduleEmail(const QString& idRemetente, const QString& enderecos, constQString& assunto, const QString& mensagem, const QString& anexos, const QString&dataHora, int cancelarSeAtrasado, unsigned opcoes, const QString& recorrencia,int intervaloSubRepeticoes, int numeroSubRepeticoes)

bool scheduleEmail(const QString& idRemetente, const QString& enderecos,const QString& assunto, const QString& mensagem, const QString& anexos, constQDateTime& dataHora, int cancelarSeAtrasado, unsigned opcoes, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)

bool scheduleEmail(const QString& idRemetente, const QString& enderecos,const QString& assunto, const QString& mensagem, const QString& anexos, constQDateTime& dataHora, int cancelarSeAtrasado, unsigned opcoes, int tipoRepeticaoSimples, int intervalo, const QDateTime& dataFim)

Parâmetros

idRemetente

A identidade do KMail a usar como remetente para o e-mail. Se estiver vazio, será usadoo endereço de e-mail do remetente que esteja configurado nas preferências de e-mail doKAlarm.

enderecos

Uma lista, separada por vírgulas, dos endereços de e-mail dos destinatários.

51

O Manual do KAlarm

assunto

Indica a linha de assunto da mensagem de e-mail.

mensagem

Indica o conteúdo da mensagem do e-mail.

anexos

Uma lista, separada por vírgulas, dos URLs dos ficheiros a enviar como anexos da mensa-gem de e-mail.

dataHoraInicial

Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para umalarme apenas de data, o texto deverá estar no formato ‘AAAA-MM-DD [TZ]’ (tal como édevolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o textodeverá estar no formato ‘AAA-MM-DDTHH:MM[:SS] [TZ]’ (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em ‘HH:MM[:SS] [Relógio]’ (tal como é devolvidopelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a datade hoje. Lembre-se que o valor dos segundos é ignorado.Se não tiver sido escolhido nenhum fuso-horário, assume-se o fuso-horário do sistema local.Se estiver presente um indicador de fuso-horário FH , poderá ser o nome de um fuso-horáriode sistema (isto é Europa/Londres), UTC - representando o fuso-horário UTC ou Clockpara usar o relógio do computador local e ignorar os fusos-horários.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indi-cado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarmenão será cancelado, independentemente do atraso com que é disparado.

opções

Indica o OU lógico das opções desejadas para o alarme. Os ’bits’ das opções são os queestão definidos na classe KAlarmIface do kalarmiface.h. Repare que nem todos os ’bits’de opções se aplicam a alarmes por e-mail.

recorrência

Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está de-finida no RFC2445. Por exemplo, ‘FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO’ deverá indicar 4 repetições trimestrais na última Segunda-Feira do mês). Para umalarme não repetitivo, indique uma cadeia de caracteres vazia.

tipoRecorrencia

Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEE-KLY, MONTHLY, YEARLY. Estes estão definidos na classe KAlarmIface no kalarmiface.h.As repetições mensais são no dia do tipo de mês, assim como as repetições anuais são àdata do tipo de ano, com a data extraída, em ambos os casos, a partir do parâmetro dataHoraInicial.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido noparâmetro tipoRecorrencia) entre repetições do alarme.

numeroRepeticoes

Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarmeindefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluiruma hora, este parâmetro deverá também incluir uma hora; se o dataHoraInicial conterapenas uma data, este parâmetro também deverá apenas conter uma data. Não deveráconter um indicador de fuso-horário; é usado o mesmo fuso-horário do dataHoraInicialpara interpretar o valor deste parâmetro.

52

O Manual do KAlarm

intervaloSubRepeticoes

Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrerqualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.

numeroSubRepeticoes

Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.

Descrição

O scheduleEmail() é uma chamada de D-Bus para agendar o envio da mensagem de e-mail nadata e hora indicadas. Para além de indicar o cabeçalho e o conteúdo da mensagem de e-maile de omitir a cor do texto e o parâmetro do ficheiro de áudio, a sua utilização é idêntica à doscheduleMessage - veja a descrição dessa função para mais detalhes.

5.1.7 scheduleAudio

Nome

scheduleAudio – agenda um novo alarme que executa um determinado comando.

Synopsis

bool scheduleAudio(const QString& urlAudio, int percentagemVolume, const QString&dataHoraInicio, int cancelarAtrasado, unsigned opções, const QString& recorrencia, int intervaloSubRepeticoes, int numeroSubRepeticoes)

bool scheduleAudio(const QString& urlAudio, int percentagemVolume, const QString&dataHoraInicio, int cancelarAtrasado, unsigned opções, int tipoRecorrencia, intintevaloRecorrencia, int numeroRecorrencias)

bool scheduleAudio(const QString& urlAudio, int percentagemVolume, const QString&dataHoraInicio, int cancelarAtrasado, unsigned opções, int tipoRecorrencia, intintevaloRecorrencia, const QString& dataHoraFim)

Parâmetros

urlAudio

Indica o ficheiro de áudio a ser reproduzido.

percentagemVolume

Define o nível de volume a usar como sendo uma percentagem do volume total. Indique -1para usar o volume por omissão.

dataHoraInicial

Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para umalarme apenas de data, o texto deverá estar no formato ‘AAAA-MM-DD [TZ]’ (tal como édevolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o textodeverá estar no formato ‘AAA-MM-DDTHH:MM[:SS] [TZ]’ (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em ‘HH:MM[:SS] [Relógio]’ (tal como é devolvidopelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a datade hoje. Lembre-se que o valor dos segundos é ignorado.Se não tiver sido escolhido nenhum fuso-horário, assume-se o fuso-horário do sistema local.Se estiver presente um indicador de fuso-horário FH , poderá ser o nome de um fuso-horáriode sistema (isto é Europa/Londres), UTC - representando o fuso-horário UTC ou Clockpara usar o relógio do computador local e ignorar os fusos-horários.

53

O Manual do KAlarm

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indi-cado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarmenão será cancelado, independentemente do atraso com que é disparado.

opções

Indica o OU lógico das opções desejadas para o alarme. Os ’bits’ das opções são os queestão definidos na classe KAlarmIface do kalarmiface.h. Repare que nem todos os ’bits’de opções se aplicam aos alarmes de comandos.

recorrência

Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está de-finida no RFC2445. Por exemplo, ‘FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO’ deverá indicar 4 repetições trimestrais na última Segunda-Feira do mês). Para umalarme não repetitivo, indique uma cadeia de caracteres vazia.

tipoRecorrencia

Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEE-KLY, MONTHLY, YEARLY. Estes estão definidos na classe KAlarmIface no kalarmiface.h.As repetições mensais são no dia do tipo de mês, assim como as repetições anuais são àdata do tipo de ano, com a data extraída, em ambos os casos, a partir do parâmetro dataHoraInicial.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido noparâmetro tipoRecorrencia) entre repetições do alarme.

numeroRepeticoes

Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarmeindefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluiruma hora, este parâmetro deverá também incluir uma hora; se o dataHoraInicial conterapenas uma data, este parâmetro também deverá apenas conter uma data. Não deveráconter um indicador de fuso-horário; é usado o mesmo fuso-horário do dataHoraInicialpara interpretar o valor deste parâmetro.

intervaloSubRepeticoes

Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrerqualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.

numeroSubRepeticoes

Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.

Descrição

O scheduleAudio() é uma chamada de D-Bus para agendar o ficheiro de áudio indicado a serreproduzido na data e hora indicadas. Para além de indicar o volume e de omitir a cor do textoe o parâmetro do ficheiro de áudio, a sua utilização é idêntica à do scheduleMessage - veja adescrição dessa função para mais detalhes.

5.1.8 edit

Nome

edit – Mostra a janela de Edição do Alarme para editar um alarme.

54

O Manual do KAlarm

Synopsis

bool edit(const QString& idEvento)

Parâmetros

idEvento

Indica o identificador único do evento a editar.

Valor devolvido

false, se o alarme indicado não for encontrado ou for apenas para leitura, caso contrário true.

Descrição

A edit() é uma chamada de D-Bus para mostrar a janela de Edição do Alarme, para editar oalarme indicado.

5.1.9 editNew

Nome

editNew – Isto mostra a janela de Edição do Alarme para editar um alarme novo.

Synopsis

bool editNew(int tipo)

bool editNew(const QString& nomeModelo)

Parâmetros

tipo

Indica o tipo de alarme. Os valores permitidos são o DISPLAY, COMMAND, EMAIL, AU-DIO. Estes estão definidos na classe KAlarmIface do kalarmiface.h.

nomeModelo

Indica o nome de um modelo de alarme no qual basear o novo alarme.

Valor devolvido

false, se o tipo tiver um valor inválido ou se não existir um modelo com o nome nomeModelo;caso contrário, devolve true.

Descrição

A editNew() é uma chamada de D-Bus para mostrar a janela de Edição de Alarmes para po-der editar um alarme novo. Se for indicado um tipo de alarme como parâmetro, irá apareceruma janela em branco. Em alternativa, se o nome de um modelo de alarmes for indicado comoparâmetro a janela é preenchida com os detalhes do modelo.

55

O Manual do KAlarm

5.1.10 list

Nome

list – Devolve uma lista com os alarmes agendados.

Synopsis

QString list()

Valor devolvido

Uma lista de alarmes, separados por mudanças de linha, cada um no formato id_recurso:UIDhora texto

Descrição

O list() é uma chamada de D-Bus para devolver um texto que contém um resumo dos alarmesagendados. A lista apresenta breves detalhes sobre cada alarme pendente: o seu identificadorde recurso (se usar o Akonadi), o UID, a hora da próxima ocorrência e o texto ou ficheiro damensagem.

5.2 Interface da Linha de Comando

As opções da linha de comandos são disponibilizadas para permitir aos outros programas ini-ciarem o KAlarm se não estiver já a correr, para que possam despoletar ou cancelar os alarmesagendados ou ainda para agendar alarmes novos. A razão para usar as opções da linha de co-mandos para este fim é que, se o KAlarm fosse arrancado sem nenhuns parâmetros da linha decomandos e lhe fossem então enviados pedidos de D-Bus, ele iria iniciar no seu modo gráfico poromissão, o que é claramente indesejável para um pedido entre programas.

NOTAOs programas deverão verificar primeiro se o KAlarm já está a correr; se estiver, então aí deverãousar chamadas de D-Bus para efectuar essas operações.

As opções da linha de comandos para agendar um alarme novo são as descritas no capítulo sobrea Operação com a Linha de Comandos. As opções para disparar e cancelar os alarmes agendadossão as seguintes:

NOTAOs 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 idEventoCancela o alarme com o ID de eventoindicado. O --triggerEvent não pode serindicado com esta opção.

--triggerEvent idEvento

Dispara o alarme com o identificador deevento indicado. A acção tomada é amesma da chamada deD-BustriggerEvent(). O --cancelEvent nãopode ser indicado com esta opção.

56

O Manual do KAlarm

Exemplos:

% kalarm --triggerEvent KAlarm -387486299.702% kalarm --cancelEvent KAlarm -388886299.793

57

O Manual do KAlarm

Capítulo 6

Perguntas e Respostas

1. Que ficheiros de configuração é que o KAlarm utiliza?O kalarmrc na pasta qtpaths --paths GenericConfigLocation contém as preferências doseu KAlarm.

2. Onde é que o KAlarm grava os seus alarmes?Os nomes dos ficheiros de calendários que o KAlarm cria, da primeira vez que é executado,são os seguintes:

• O kalarm/calendar.ics, na pasta qtpaths --paths GenericDataLocation. contém os alar-mes activos.

• O kalarm/expired.ics, na pasta qtpaths --paths GenericDataLocation. contém os alar-mes arquivados.

• O kalarm/template.ics, na pasta qtpaths --paths GenericDataLocation. contém os mo-delos de alarmes.

Poderá descobrir os ficheiros de calendários que estão a ser usados de momento, vendo osdetalhes de cada calendário na lista de calendários de alarmes. Os nomes dos ficheiros sãogravados no ficheiro de configuração do calendário de alarme.Os detalhes dos alarmes que estão visíveis de momento são guardados no ficheiro de ca-lendário kalarm/displaying.ics na pasta qtpaths --paths GenericDataLocation.

3. Em que formato estão guardados os alarmes?Os ficheiros de calendário em que o KAlarm guarda os seus alarmes são ficheiros de texto,cujo formato está definido pelo documento RFC2445 - Internet Calendaring and SchedulingCore Object Specification (iCalendar). Este é o formato-padrão que é usado em todas asaplicações do ’kdepim’. O KAlarm usa certas propriedades fora da norma no componentedo Alarme, em relação ao RFC2445. Estas estão documentadas no ficheiro DESIGN.html queé distribuído com o KAlarm.

4. O que é o programa kalarmautostart?O kalarmautostart é um pequeno programa auxiliar, cuja função é iniciar automaticamenteo KAlarm no início da sessão.O KAlarm é reposto normalmente pelo gestor de sessões no início de uma sessão (para mos-trar de novo as suas janelas no mesmo estado em que estavam antes de encerrar a sessãoanterior). Se não estava em execução quando encerrou a sessão, não será iniciado pelo ges-tor de sessões, pelo que terá de ser iniciado automaticamente. O problema é que, quandouma aplicação inicia automaticamente e é gerida pelo gestor de sessões, não há garantia doque irá ocorrer primeiro. Se o arranque automático aparecer primeiro, irá impedir que ogestor de sessões reponha o estado da aplicação.Para evitar este problema, o kalarmautostart é iniciado automaticamente no início da ses-são, em vez do KAlarm. Tudo o que este faz é esperar durante algum tempo (para garantir

58

O Manual do KAlarm

que o gestor de sessões tem tempo para a sua tarefa) antes de iniciar o KAlarm, onde nessaaltura termina.

5. Como é que uso o KAlarm num ambiente de trabalho que não o Plasma?Para correr o KAlarm num ambiente de trabalho não-Plasma, o requisito principal é garan-tir que o KAlarm é corrido automaticamente sempre que você iniciar uma sessão. Poderáobter instruções mais detalhadas no ficheiro INSTALL que é distribuído com o KAlarm.

59

O Manual do KAlarm

Capítulo 7

Créditos e Licença

KAlarmPrograma com ’copyright’ 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 de DavidJarvie djarvie@kde.org

Documentação com ’copyright’ 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 deDavid Jarvie djarvie@kde.org

Tradução de José Nuno Pires zepires@gmail.com

A documentação está licenciada ao abrigo da GNU Free Documentation License.

Este programa está licenciado ao abrigo da GNU General Public License.

Os agradecimentos vão para o autor da aplicação KAlarm do KDE 1, o Stefan Nikolausstefan.nikolaus@stuco.uni-oldenburg.de, que permitiu gentilmente o uso do KAlarm nesta apli-cação do KDE 2 e suas versões posteriores.

60