O Manual do KAlarm
O Manual do KAlarm
Próximo

O Manual do KAlarm

David Jarvie

Desenvolvimento: David Jarvie
Tradução: José Pires
Revisão 1.04.07 (2006-12-06)

É dada permissão para copiar, distribuir e/ou modificar este documento ao abrigo da GNU Free Documentation License, Versão 1.1 ou de uma versão mais recente publicada pela Free Software Foundation; sem Secções Invariantes, sem Textos de Capa Frontal, e sem Textos de Capa Traseira. Uma cópia desta licença está incluida na secção intitulada "GNU Free Documentation License".

O KAlarm é um escalonador pessoal de alarmes, comandos e e-mail para o KDE.


Capítulo 1. Introdução
Introdução
Anterior
Próximo

Capítulo 1. Introdução

O KAlarm permite-lhe escalonar a visualização das mensagens de alarme pessoais, a reprodução de 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, apresentando as suas horas e os seus detalhes. O utilizador pode criar novos alarmes ou seleccionar alarmes existentes para modificar ou remover. Poderá ainda, opcionalmente, ver os alarmes que expiraram.

Ao configurar ou modificar um alarme, poderá tanto escrever o texto da mensagem de alarme, indicar um ficheiro de texto ou de imagem a mostrar, indicar um comando para ser executado ou introduzir uma mensagem de e-mail para ser enviada. Poderá também escolher a cor da mensagem de alarme, se esta se deve repetir, se deverá tocar um som ou falar o texto do alarme e se o alarme poderá ser cancelado, se não puder ser despoletado à hora determinada.

Os alarmes também podem ser escalonados a partir da linha de comandos, ou através de chamadas DCOP de programas.

Quando uma mensagem de alarme atinge a sua hora, é mostrada em cada um dos ecrãs do KDE para garantir 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 mostrado de novo mais tarde. Um exemplo de uma mensagem de alarme:


Mensagem de alarme

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

O KAlarm pode correr num de dois modos: “contínuo” (por omissão), onde ele corre na bandeja de sistema, ou “a-pedido”, onde se executa quando for pretendido (com a opção de mostrar um ícone da bandeja de sistema independente).

Este documento faz várias referências ao servidor de alarme. Esta é uma aplicação que corre em segundo plano, verificando os alarmes pendentes e dizendo ao KAlarm para mostrá-los quando chegar a hora.

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 2. Utilizar o KAlarm
Utilizar o KAlarm
Anterior
Próximo

Capítulo 2. Utilizar o KAlarm

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

Quando o KAlarm se inicia no modo gráfico, verifica se o servidor de alarme está a correr. Se não estiver, o KAlarm inicia-o.

Dica

Todos os campos incrementais do KAlarm têm uma funcionalidade de aceleração. Para que a mudança de valores use incrementos mais elevados, mantenha a tecla Shift pressionada, enquanto carrega nos campos incrementais.



Lista de alarmes

A janela principal do KAlarm mostra a lista actual de alarmes pendentes, mostrando as suas horas, intervalos de repetição e textos de mensagens, os nomes dos ficheiros a apresentar, os comandos a executar ou os assuntos das mensagens de e-mail. (Para um alarme recorrente ou um 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 do alarme indica o seu tipo.


Janela principal

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

Os alarmes poderão ser ordenados por data/hora, intervalo de repetição, cor ou texto se carregar na barra de título da coluna apropriada. Para inverter o critério de ordenação, carregue no título da coluna de novo.

Você poderá, opcionalmente, mostrar o tempo restante até que cada alarme dispare, em conjunto com ou em vez da hora agendada do alarme. Para mostrar ou esconder a coluna da hora do alarme, seleccione Ver->Mostrar as Horas dos Alarmes. Para mostrar ou esconder a coluna com o tempo que falta até disparar os alarmes, seleccione a opção Ver->Mostrar a Hora Até Aos Alarmes. Pelo menos uma destas colunas é sempre visível. Poderá usar a janela de preferências para mudar as colunas predefinidas a mostrar.

Alarmes expirados

Por omissão, o KAlarm guarda os alarmes durante um período limitado, logo que tenham expirado ou tenham sido removidos. (Mas repare que os alarmes que você apagar só são guardados se já tiverem sido disparados pelo menos uma vez.). Poderá controlar se o KAlarm guarda os alarmes expirados, e durante quanto tempo, na janela de Preferências.

Os alarmes expirados poderão ser mostrados na lista de alarmes se seleccionar a opção Ver->Mostrar os Alarmes Expirados. Para os esconder de novo, repita a acção. Poderá usar a janela de preferências para mostrar os alarmes expirados por omissão.

Procurar na lista de alarmes

Poderá procurar na lista de alarmes para descobrir os alarmes que contêm um determinado texto de 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 alarmes correspondentes, 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 pesquisados os destinatários e os URLs dos anexos.

Nota

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

Criar e manipular alarmes
Criar e manipular alarmes

Criar e manipular alarmes

Criar um novo alarme

Para criar um alarme novo, faça uma das seguintes acções. Isto mostra a janela de edição do alarme através da qual irá configurar o alarme.

  • Seleccione Acções->Novo.

  • Carregue com o botão direito do rato no ícone da bandeja do sistema e escolha Novo no menu de contexto.

  • Carregue com o botão do Meio do rato no ícone da bandeja do sistema.

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

  • Faça duplo-click no espaço vazio por baixo do último item da lista de alarmes.

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ção de modelos de alarmes.

  • Para basear o seu alarme num existente, escolha o alarme existente e seleccione a opção Acções->Copiar. Isto abre a janela de edição do alarme já preenchida com uma cópia dos detalhes do alarme seleccionado.

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

  • Se arrastar um pedaço de texto para a janela principal do KAlarm ou para o ícone da bandeja de sistema irá abrir a janela de edição do alarme e configura o texto do alarme.

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

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

Modificar um alarme existente

Para modificar um alarme pendente já existente (os alarmes expirados não poderão ser corrigidos), 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ção Acções->Editar.

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

Isto mostra a janela de edição do alarme.

Apagar/reactivar um alarme

Para apagar um alarme, faça uma das seguintes operações:

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

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

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 expirados sejam guardados de todo. (Use a janela de preferências para controlar se e durante quanto tempo os alarmes expirados serão guardados). Quando remover um alarme expirado ou um alarme 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 tenha expirado. Para o fazer, mostre primeiro os alarmes expirados, tal como está descrito em Alarmes expirados. 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 do rato nos itens desejados na lista de alarmes e escolha a opção Reactivar do menu de contexto.

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.

Ver um alarme

Para ver um alarme existente sem a possibilidade de o edit, faça uma das seguintes acções:

  • Seleccione-o, carregando no item respectivo na lista de alarme. Depois seleccione a opção Acções->Ver.

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

Isto mostra a janela de edição do alarme num modo apenas para leitura.

Aceitar um alarme

Veja a secção da janela da mensagem do alarme para ver como aceitar os alarmes.

Modelos de alarme

Se deseja configurar com frequência alarmes semelhantes, poderá criar um modelo de alarmes para evitar ter de introduzir todos os detalhes do zero de cada vez. Um modelo poderá conter todos 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ão cuja hora varia de semana para semana. O modelo iria conter todos os detalhes do alarme (o texto da mensagem, se deverá tocar um som, etc.), exceptuando a data e hora. Depois, para criar o alarme, tudo o que teria de fazer seria carregar na janela de edição do alarme esse modelo e introduzir então a data e hora.

Para criar um alarme com base num modelo, abra a janela de edição do alarme, predefinida com os detalhes do modelo:

  • Seleccione a opção Acções->Novo a Partir de Modelo, seleccionando depois o modelo desejado.

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

  • Abra a janela de edição de alarmes da forma normal e carregue no botão Carregar um Modelo... para seleccionar um modelo com o qual predefinir a janela.

Configurar os modelos

O utilizador poderá criar, modificar ou remover modelos com a janela de Modelos de Alarmes ou 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. 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ção do modelo já preenchida com uma cópia dos detalhes do modelo seleccionado.

  • Seleccione um alarme na lista e escolha a opção Acções->Criar um modelo. Isto abre a janela de edição dos modelos já preenchida com uma cópia dos detalhes do alarme seleccionado.

Para modificar um modelo existente, mostre a janela de Modelos de Alarmes, seleccionando a opção Ficheiro->Modelos... e carregando em Editar. Isto irá mostrar a janela de edição do modelo, a qual é descrita em baixo.

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

Janela de edição de modelo

A janela de edição de modelos é semelhante à janela de edição de alarmes. Só os seguintes controlos são diferentes:

  • Indique o nome do modelo no campo Nome do modelo. É o nome do modelo que é apresentado nas listas de selecção de modelos, por isso é melhor escolher um nome que o relembre da sua 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 baseados neste modelo irão usar a hora de activação por omissão para os alarmes novos.

    • Hora se desejar indicar uma hora em que o alarme será despoletado.

    • A qualquer hora para indicar que o alarme só deverá ter uma data, sem nenhuma hora.

    • 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 nenhum dia ou mês para as recorrências semanais ou anuais, respectivamente.

Importar alarmes de calendários externos

Poderá importar os alarmes a partir de outros ficheiros de calendários para o KAlarm, com a opção Ficheiro->Importar os Alarmes.... A função de importação verifica o ficheiro de calendário seleccionado, à procura de eventos que contenham alarmes, copiando-os (com novos identificadores únicos) para o calendário do KAlarm. Os eventos sem alarmes, bem como os outros tipos de itens do calendário, serão ignorados.

Atenção

Se 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 inclusive mudar. 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. Verifique sempre os alarmes importados, à espera de alterações inesperadas, e ajuste-os se necessário.

Importar aniversários do KAddressBook

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

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

    Nota

    Se 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 deseja criar alarmes. Lembre-se que a lista só mostra os itens no KAddressBook que contêm um aniversário e que não têm já um alarme no formato definido de momento no grupo do Texto do Alarme.

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

Desfazer / refazer

Poderá desfazer e refazer as alterações mais recentes que tenha feito durante a sessão actual do KAlarm. A maioria das acções poderá ser anulada, incluindo a criação, edição e remoção dos alarmes e modelos de alarmes, assim como a reactivação dos alarmes. Para evitar a utilização excessiva 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 ferramentas e mantenha o botão pressionado. Irá aparecer uma lista das acções, na qual poderá escolher a que deseja anular. Se não ver a acção que está à procura, lembre-se que poderá necessitar de desfazer 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ção até 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ão da barra de ferramentas para Refazer.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

A janela de edição do alarme
A janela de edição do alarme

A janela de edição do alarme

A janela de edição do alarme permite-lhe ver e editar um alarme.


Janela de edição do alarme

Acção do alarme

No grupo Acção, seleccione o tipo de alarme:

  • Texto para indicar o texto da mensagem de alarme (o qual poderá conter várias linhas) no campo de texto. Defina as seguintes opções:

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

      • Nenhum para mostrar o alarme em silêncio.

      • Apitar para soar uma campainha.

      • Falar para que a mensagem de alarme seja sintetizada, assim como é apresentada. Esta opção só estará disponível se tiver o KTTSD (do pacote 'kdeaccessibility') instalado e configurado, em conjunto com um sintetizador de fala compatível, isto é o Festival.

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

        Nota

        O KAlarm usa o servidor de som aRts para a repetição e o controlo do volume. Se o KAlarm tiver sido compilado sem suporte para o aRts, as opções de repetição e do volume não estarão disponíveis e aparecerá apenas um selector simples do ficheiro de som, em vez da janela completa do Ficheiro de Som.

        Na janela do Ficheiro de Som:

        • Indique o local ou URL do ficheiro de som, ou use o botão ao lado do campo de edição para mostrar uma janela de selecção de ficheiros.

        • Assinale o Repetir para que o som seja repetido continuamente durante o tempo em que o alarme é mostrado. (A janela da mensagem de alarme contém um botão para parar de tocar 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 ficheiro de áudio é tocado.

        • Se o desejar, poderá desvanescer o volume. Isto significa que o ficheiro de som começa a ser reproduzido com um determinado volume e vai mudando gradualmente para o volume final, 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 Desvanescer e escolha o período no qual isso acontece no campo Tempo de desvanecimento e ajuste a barra do Volume inicial.

        Nota

        Sempre que possível, o KMix é usado para acertar o volume. Isto garante que o volume a que o alarme é tocado não é afectado por quaisquer alterações no nível de volume do computador. Se o KMix não estiver a correr (ou se for anterior ao KDE 3.1), o volume é configurado em relação ao nível de volume actual em que o alarme é despoletado. Por isso, nesse caso, o volume a que o alarme é reproduzido irá variar, dependendo das alterações que hajam no nível de som do computador.

        Dica

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

    • Seleccione a cor de fundo para a janela da mensagem do alarme. (A lista de selecção de cores poderá ser configurada na janela de Preferências.)

    • Use o botão do Tipo de Letra & Cor... para seleccionar um tipo de letra ou uma cor de texto ou de fundo para a mensagem de alarme. Na janela para Escolher o Tipo de Letra e Cor do Alarme, assinale a opção Usar o tipo de letra predefinido para mostrar a mensagem com o tipo de letra que estiver configurado por omissão na altura em que a mensagem for apresentada. (O tipo de letra por omissão pode ser configurado na Janela de preferências.) Para escolher um tipo de letra específico para a mensagem, desligue a opção Usar o tipo de letra predefinido.

    • Use o botão Acções Especiais... para indicar os comandos a executar antes ou depois da apresentaçã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 o alarme. Lembre-se que o KAlarm espera que o comando termine antes de mostrar o alarme.

      • No campo de Acção de pós-alarme, indique um comando a executar quando a janela do alarme é fechada.

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

      Lembre-se que as acções especiais não são executadas se o alarme foi apresentado à hora em que você se desligou e são repostas quando você se ligar.

  • Ficheiro para indicar o nome ou o URL de um ficheiro de texto ou de imagem cujo conteúdo seja mostrado na janela da mensagem. Use o botão ao lado do campo de edição para aparecer uma janela de selecção de ficheiros. Define as opções usadas para os alarmes de texto acima, mas repare que a opção Falar não está disponível.

  • Comando para indicar um comando a executar.

    Nota

    Esta opção não está disponível ser o KDE estiver a correr em modo quiosque.

    • A opção Introduzir um programa permite-lhe escolher se deseja introduzir um comando de consola ou um 'script'.

      Se esta opção estiver desligada, poderá introduzir uma instrução da linha de comandos de modo a executá-la. O comando é passado para a linha de comandos por omissão (definida pela 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 de comandos correcto é invocado.

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

      • Assinale a opção Executar numa janela de terminal para fazer com que o comando seja executado numa janela de terminal. Poderá escolher o tipo de janela de terminal que será usada na janela de preferências.

      • 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 agendado para correr, será adicionada ao conteúdo existente no ficheiro. Indique o nome do ficheiro no campo de texto ou use o botão ao lado do campo de texto para mostrar uma janela de selecção de ficheiros.

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

  • E-mail para indicar uma mensagem de e-mail para enviar. Preencha os endereços dos destinatários, a linha do assunto da mensagem e o corpo da mesma nos três campos de texto. Use o botão ao lado do campo dos endereçados para mostrar o seu livro de endereços do KDE, no qual poderá seleccionar os destinatários da mensagem. Os anexos poderão ser adicionados com o botão Adicionar.... Lembre-se que os ficheiros anexados precisam de existir 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-mail para enviar a mensagem. Esta opção só aparece se o seu endereço de e-mail De na janela de preferências estiver configurada para Usar as identidades do KMail. Caso contrário, o seu endereço de e-mail estará predefinido na janela de preferências, 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 mensagem 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 Preferências, sendo o valor por omissão o seu endereço de e-mail, tal como está definido no Centro de Controlo do KDE.

Adiamento

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

Hora

No grupo da Hora, seleccione

  • À data/hora para indicar a data e a hora em que o alarme deverá ser despoletado. Assinale a opção A qualquer hora se quiser indicar apenas uma data para o alarme: neste caso, o alarme será despoletado na primeira oportunidade a partir da hora do início do dia, na data indicada. (O Configurar o KAlarm descreve como configurar a hora do início do dia).

    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 existem estas restrições dado que a data/hora de início será ajustada automaticamente para a primeira repetiçã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.

Chamada de Atenção

Para um alarme visível, assinale a Chamada de Atenção se quiser mostrar uma chamada de atenção antes do alarme principal e de cada uma das suas repetições (se existirem). Indique com que antecedência deseja, usando os controlos de edição por baixo da opção propriamente dita.

Nota

Só poderá mostrar uma chamada de atenção antes de cada repetição de um alarme se as repetições estiver configuradas na página de Recorrência. Se o botão de Repetição Simples for usado em alternativa, será mostrada uma chamada de atenção somente antes da primeira ocorrência.

Se o alarme se repetir, assinale a opção Chamada de atenção apenas para a primeira recorrência se desejar apenas uma chamada de atenção antes da primeira repetição do alarme. Se não estiver assinalada, o período da chamada de atenção está limitado a ser menor que o intervalo de repetição.

Cancelamento

As opções de cancelamento posterior determinam a forma como um alarme é tratado depois da sua 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 um determinado período de tempo após a hora agendada. O período de tempo é seleccionado com os campos que aparecem quando você assinalar a opção. Por exemplo, se indicar um período de tempo de 1 hora, o alarme será despoletado à primeira oportunidade que ocorrer até 1 hora após a hora exacta mas, se não conseguir ser disparado nesse período, a sua activação será cancelada.

    Nota

    O atraso dos alarmes apenas para datas, isto é os que tenham a opção A qualquer hora seleccionada, é 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 hora agendada e independentemente do seu atraso.

    Nota

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

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

Recorrência

Indique se ou como o alarme deverá ser repetido, se usar o botão de Repetição Simples e a página de Recorrência. A página Recorrência permite a maior flexibilidade na configuração de uma repetição mas, para as repetições simples que consigam ser descritas como um número de repetições com um intervalo fixo entre elas, o botão de Repetição Simples oferece uma janela mais simples.

Nota

As chamadas de atenção são tratadas de forma diferente, dependendo do método que é usado para configurar um alarme repetitivo. Se usar o botão de Repetição Simples, só será mostrada uma chamada de atenção antes da primeira ocorrência do alarme, enquanto se usar a página de Recorrência, irá aparecer uma chamada de atenção antes de cada repetição.

Poderá também usar o botão de Repetição Simples em conjunto com a página de Recorrência, para configurar uma repetição dentro de outra repetição. Neste caso, sempre que chegar a hora de um alarme, tal como foi indicado na página de Recorrência, em vez de ser despoletado uma vez, será disparado repetidamente, de acordo com a sua indicação de repetição simples. Por exemplo, para configurar um alarme que se repita a todas as horas, desde o meio-dia até às 6 da tarde de todas as Quintas-Feiras, poderia usar a página de Recorrência para configurar uma repetição semanal às Quintas ao meio-dia e usar a janela de Repetição Simples para indicar um intervalo de 1 hora e uma quantidade igual a 7 ou uma duração de 6 horas.

A característica básica de repetição do alarme é mostrada por conveniência na página do Alarme, para além do botão de Repetição Simples. O intervalo de repetição, tal como está configurado na página de Recorrência, é mostrado em primeiro lugar, seguido do intervalo de repetição configurado com o botão de Repetição Simples.

Janela de Repetição Simples

Assinale a opçã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:

  • Indique o intervalo de tempo entre as repetições nas opções ao lado de Repetir a cada. Seleccione 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 veses 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 mais 3 vezes depois do seu primeiro disparo, deverá indicar 4 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.

Nota

A duração de uma repetição simples é restringida se for usada em conjunto com uma repetição configurada na página Recorrência. Neste caso, de cada vez que o alarme repetir, tal como for indicado na página de Recorrência, todas as repetições simples activas, que tenham começado na repetição anterior, serão automaticamente canceladas. Isto evita que se sobreponham as repetições simples para o mesmo alarme. A duração da repetição simples está restrita, desta forma, a ser menor que o maior intervalo entre repetições.

Página de Recorrência

No grupo da Regra de Recorrência, indique o tipo de recorrência ou o período de tempo da seguinte 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 hora final agendada. Depois, na sua hora final, será despoletado uma última vez. (Lembre-se que um alarme repetido na autenticação será também despoletado de cada vez que você activar os alarme ou reiniciar o servidor de alarme.)

  • Para que o alarme se repita em intervalos regulares, seleccione um dos tipos de períodos e indique depois no campo Recorrência a cada quantos períodos de tempo deverão passar entre cada repetição. Por exemplo, para repetir em cada quinzena, poderá seleccionar Diariamente e 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 dentro de um mês (isto é o último Sábado de Maio). Assinale cada mês do ano em que deseja activar o alarme.

    Dica

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

No grupo do Fim da Recorrência, configure a amplitude temporal de recorrência global da seguinte 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.

Se desejar excluir certas datas/horas da repetição que tenha configurado, indique-as no grupo Excepções. A lista de excepções (isto é, as datas/horas excluídas) é mostrada à esquerda. Para adicionar uma nova excepção, introduza uma data à direita e carregue em Adicionar. Para alterar uma excepção, seleccione-a na lista, indique a nova data à direita e carregue em Modificar. Para remover uma excepção, seleccione-a na lista e carregue em Remover.

Outros controlos

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

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

Nota

Se 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 alarme no KAlarm não será afectado.

Carregue no botão Carregar um Modelo para seleccionar um modelo com o qual preencher a janela, 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.

Carregue no botão OK quando todos os detalhes estiverem correctos para adicionar o alarme à lista agendada.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Janela de mensagem de alarme
Janela de mensagem de alarme

Janela de mensagem de alarme

Quando uma mensagem de alarme chega à sua hora, é mostrada em todos os ecrãs do KDE e não pode ser coberta pelas janelas normais, para garantir que você a vê. A janela da mensagem mostra a hora para a qual o alarme foi agendado, para que você possa ver quando apareceu se estava ausente nessa hora. (Para as mensagens das chamadas de atenção, todavia, a data/hora mostrada é a do alarme principal ou da sua repetição, não é a hora da mensagem da chamada de atenção, e o seu título é “Chamada de Atenção”).

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

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

  • Confirmar o alarme ao carregar no botão Fechar. Isto fecha a janela (depois de um pedido de confirmaçã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.... Depois seleccione a opção Adiar para a data/hora de modo a indicar a data e hora em que a mensagem deverá ser mostrada de novo ou seleccione o Adiar durante o intervalo de tempo para indicar em que tempo a partir de agora (em horas e minutos) é que a mensagem deverá ser mostrada de novo. Depois, carregue em Adiar para remeter a mensagem de alarme para mais tarde e fechar a sua janela.

    Nota

    A hora para a qual é adiado um alarme deverá ser anterior à sua próxima ocorrência escalonada ou até à próxima chamada de atenção. Por essa razão, o botão Adiar... na janela da mensagem de alarme e o botão de OK na janela de adiamento, ficam desactivados um minuto antes da próxima ocorrência ou chamada de atenção.

    Nota

    O 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 directamente ao KMail, carregando no botão que mostra o ícone do KMail. Isto irá seleccionar e realçar a mensagem de e-mail na lista de pastas do KMail.

    Atenção

    Se 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.

A janela da mensagem de alarme pode ser mostrada de dois modos diferentes, dependendo das suas preferências. Poderá escolher o modo na janela de Preferências.

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

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Operação na bandeja do sistema
Operação na bandeja do sistema

Operação na bandeja do sistema

O KAlarm poderá ser executado como um ícone na bandeja do sistema. Este ícone permite a activação com um 'click' do KAlarm e oferece tanto uma indicação do estado e o controlo da monitorização dos alarmes. Uma janela normal do KAlarm indica que os alarmes estão a ser monitorizados, enquanto que um ícone cinzento indica que os alarmes não estão a ser monitorizados.

Se você passar o cursor do rato por cima do ícone da bandeja do sistema, aparece um resumo das primeiras mensagens de alarmes que irão ser activados nas próximas 24 horas como uma dica. Poderá desligar essa funcionalidade ou configurar o número de alarmes a mostrar e o seu formato na janela de preferências.

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

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

Activar os Alarmes

Activa a monitorização dos alarmes. Esta opção só aparece se os alarmes estiverem desactivados de momento.

Veja a Activação/desactivação dos alarmes para mais detalhes.

Desactivar os Alarmes

Desactiva a monitorização dos alarmes. Esta opção só aparece se os alarmes estiverem activados de momento.

Veja a Activação/desactivação dos alarmes para mais detalhes.

Novo Alarme...

Abre a janela de edição de alarmes para criar um novo alarme.

Novo Alarme a Partir de Modelo

Mostra a lista de modelos de alarmes num menu. Quando seleccionar um deles, a janela de edição de alarmes irá aparecer, preenchida previamente com os detalhes desse modelo.

Configurar o KAlarm...

Mostra a janela de preferências do KAlarm.

A janela de preferências está descrita em Configurar o KAlarm. Ela inclui as opções relacionadas com o ícone da bandeja do sistema para o KAlarm.

Restaurar / Minimizar

Restaura ou minimiza a janela principal do KAlarm.

Esta opção só está disponível se o modo de execução for o “contínuo”. (Veja a secção Configurar o KAlarm para uma descrição dos modos de execução.)

Sair

Fecha o ícone de bandeja do sistema do KAlarm.

Somente no modo de execução “contínuo”, também fecha todas as janelas principais do KAlarm. Não faz efeito na monitorização dos alarmes pelo servidor de alarmes, se tiver desligado a opção Desactivar os alarmes quando inactivo na janela de preferências.

Mostrar o KAlarm na bandeja do sistema

Você precisa de estar a correr o ambiente de trabalho do KDE para mostrar o KAlarm na bandeja do sistema. Se o KAlarm estiver a correr no modo “contínuo”, o ícone da bandeja do sistema fica sempre visível. Estas instruções só se aplicam no modo “a-pedido”. (Veja o Configurar o KAlarm para uma descrição dos modos de execução.)

Para mostrar o KAlarm na bandeja de sistema, seleccione Ver->Mostrar na Bandeja do Sistema.

Para remover o KAlarm da bandeja do sistema, faça uma das seguintes operações:

  • Seleccione Ver->Esconder da Bandeja do Sistema.

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Actualizar os alarmes
Actualizar os alarmes

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.

O KAlarm volta a despoletar os alarmes em falta, reinicializando o servidor de alarmes, o qual é discutido na secção do Servidor de alarmes.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Activar/desactivar os alarmes
Activar/desactivar os alarmes

Activar/desactivar os alarmes

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

  • A “Monitorização de alarmes” aplica-se aos alarmes como um todo. Quando a monitorização de alarmes está desactivada, o servidor de alarmes deixa de verificar os alarmes e, como tal, não irá despoletar quaisquer alarmes. Quando a monitorização de alarmes estiver activa (a situação normal), todos os alarmes que não tenham sido desactivados individualmente irão disparar às horas apropriadas.

  • Os alarmes poderão ser activados ou desactivados individualmente, independentemente do estado de monitorização dos alarmes. Como tal, o estado de activado/desactivado dos alarmes individuais ficará inalterado se desactivar e voltar a activar a monitorização dos alarmes. Ao contrário da monitorização dos alarmes, que poderá potencialmente ser desactivada devido ao facto do KAlarm não estar a correr ou o servidor de alarmes não estar a funcionar, os alarmes individuais só poderão ser desactivados, se usar os comandos do menu para o fazer.

    O estado de activado/desactivado individual de um alarme é indicado pela sua cor na lista de alarmes (a cor é configurável na página de Tipo de Letra & Cor da janela de Preferências).

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

Activar a monitorização de alarmes

Se o modo de execução do KAlarm for o “contínuo” e se você tiver seleccionado a opção Desactivar os alarmes quando inactivo na janela de preferências, é preciso garantir que o KAlarm está a correr para que a monitorização dos alarmes tome lugar.

Aí, se a monitorização de alarmes estiver desactivada de momento, faça uma das seguintes acções para 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 Activar os Alarmes no menu de contexto.

O servidor de alarmes é iniciado se necessário e os alarmes são monitorizados até quando chegar a sua hora.

Desactivar a monitorização de alarmes

Existem várias formas de desactivar a monitorização dos alarmes que impede o KAlarm de mostrar os outros alarmes até que volte a activá-los, ou – assumindo que o servidor de alarmes esteja configurado para ser iniciado após a autenticação – até à próxima vez que se autenticar.

Para desactivar os alarmes, sem parar o servidor de alarmes, faça uma das seguintes acções:

  • Seleccione Acções->Desactivar Alarmes.

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

  • Se o modo de execução do KAlarm for o “contínuo” e se tiver seleccionado a opção Desactivar os alarmes quando inactivo na janela de preferências, saia do KAlarm.

Para desactivar os alarmes, parando o servidor de alarmes:

  • Seleccione a opção Configuração->Controlar o Servidor de Alarmes.... Isto mostra a janela do Gestor de Serviços que lhe permite parar o servidor de alarmes.

Activar/desactivar os alarmes individualmente

Para activar individualmente os alarmes que estejam desactivados de momento, faça uma das seguintes 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ção Activar do menu de contexto.

Para desactivar os alarmes individuais que estejam activos de momento, faça uma das seguintes acçõ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ção Desactivar do menu de contexto.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Sair do programa
Sair do programa

Sair do programa

Saia do KAlarm, fechando todas as suas janelas e o ícone da bandeja do sistema ou, se estiver a correr no modo “contínuo”, fechando todas as janelas de mensagens e seleccionando a opção Ficheiro->Sair ou o Sair do menu de contexto do ícone da bandeja de sistema.

O efeito da opção Ficheiro->Sair ou do item do menu de contexto do ícone da bandeja do sistema Sair depende do modo de execução: no modo “a-pedido” ele esconde o ícone da bandeja do sistema, enquanto que no modo “contínuo”, sai do programa.

Dica

Se você tiver desligado a opção Desactivar os alarmes quando inactivo na janela de preferências, a saída do KAlarm não tem efeito no servidor de alarmes que, se já estiver activo, irá continuar a monitorizar os alarmes agendados e pedir a sua apresentação quando chegar a sua hora.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 3. Configurar o KAlarm
Configurar o KAlarm
Anterior
Próximo

Capítulo 3. Configurar o KAlarm

Para configurar a operação do KAlarm de acordo com o seu sistema e com as suas preferências pessoais, seleccione a opção Configuração->Configurar o KAlarm.... Isto mostra a janela de configuração.

Geral

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

  • O grupo do Modo de Execução: Estas opções controlam o ícone da bandeja de sistema do KAlarm e permitem também algum controlo sobre o uso dos recursos do sistema por parte do KAlarm, indicando se deve ou não executá-lo continuamente. Se a performance do sistema for relevante, a execução a-pedido sem mostrar o ícone da bandeja do sistema poderá ser desejável; se o correr continuamente na bandeja do sistema irá usar mais recursos do sistema mas dá-lhe o benefício de mostrar uma indicação activada pelo alarme e torna a aplicação mais acessível. A execução do KAlarm a pedido não afecta a execução dos alarmes, dado que é o servidor de alarmes e não o KAlarm que monitorizam a lista de alarmes e os disparam.

    • Correr apenas a pedido: o KAlarm só é executado quando um alarme for despoletado, se o correr manualmente ou enquanto o seu ícone na bandeja do sistema estiver visível. Neste modo, o ícone da bandeja do sistema pode à mesma estar visível, mas se fechar esse ícone não fará efeito em nenhuma janela do KAlarm.

    • Correr continuamente na bandeja do sistema: o KAlarm corre continuamente e o ícone da bandeja do sistema é sempre apresentado enquanto estiver a correr. Neste modo, se fechar o ícone da bandeja do sistema fecha todas as janelas principais do KAlarm e, se não estiver nenhuma janela de mensagem visível, sai da aplicação. As opções disponíveis para este modo são:

      • Desactivar os alarmes quando inactivo: Se seleccionar esta opção, fará com que os alarmes sejam desactivados sempre que o ícone da bandeja do sistema do KAlarm não esteja visível.

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

    • Arrancar no início da sessão: No modo contínuo, isto inicia o KAlarm no arranque da sessão do KDE, após a autenticação, para garantir que o KAlarm corre a toda a hora, a menos que o termine manualmente.

    • Auto-iniciar o ícone da bandeja ao ligar-se: No modo a pedido, isto mostra o ícone do KAlarm na bandeja do sistema após a autenticação. O KAlarm irá correr até que este ícone seja fechado.

    • Iniciar a monitorização do alarme no arranque: Isto inicia a monitorização do alarme no arranque da sessão do KDE, ao iniciar o servidor de alarmes. Lembre-se que, para que os alarmes sejam activados, também necessita de seleccionar as opções apropriadas no grupo do Modo de Execução.

      Atenção

      Esta opção deverá ser sempre assinalada, a menos que pretenda desactivar a utilização do KAlarm.

      Nota

      Esta opção fica automaticamente seleccionada de novo, sempre que o KAlarm é executado. Por isso, se tiver desligado esta opção e quiser a evitar que o servidor de alarmes se execute no início, terá de desligar esta opção de novo, de cada vez que executar o KAlarm.

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

  • Se você tiver configurado repetições anuais para o 29 de Fevereiro, indique como é que estas serão tratadas nos anos não-bissextos, seleccionando uma das seguintes opções:

    • 28 de Fevereiro: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos e a 28 de Fevereiro nos outros anos.

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

    • Não repetir: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos, mas será suprimido nos outros anos.

    Nota

    A alteração desta opção não irá provocar a repetição da avaliação da próxima ocorrência dos alarmes existentes. Só irá afectar os alarmes novos ou os alarmes existentes, depois de terem sido despoletados uma outra vez.

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

  • Grupo dos Alarmes Expirados: Estas opções controlam o armazenamento dos alarmes expirados.

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

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

    • Limpar os alarmes expirados: Este botão limpa todos os alarmes expirados que estejam armazenados. Isto não faz efeito nos alarmes que irão expirar a seguir; eles continuarão a ser guardados de acordo com as opções seleccionadas.

  • Terminal para os Comandos de Alarme: Aqui poderá seleccionar o tipo de janela de terminal que será usado para os alarmes de comandos a serem executados numa janela de terminal. Algumas 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 do comando que são usadas por cada aplicação, mostrando a ajuda de contexto para a sua opção respectiva.

    Se quiser usar outra aplicação ou quiser usar uma das que se encontram listadas, só que com opções do comando diferentes, seleccione Outro e indique o comando para invocar a janela do terminal. Por omissão, o texto do comando do alarme será adicionado ao que indicar. Em alternativa, poderá indicar onde é que o texto do comando do alarme será introduzido, usando um dos seguintes códigos:

    %c

    O texto do comando do alarme será substituído.

    %w

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

    %C

    Um ficheiro de comando temporário, contendo o texto do comando do alarme, será criado, sendo substituído o comando para executar o ficheiro.

    %W

    Um ficheiro de comando temporário, contendo o texto do comando do alarme, será criado com um sleep adicionado, sendo substituído o comando para executar o ficheiro.

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

E-mail
E-mail

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 utilizando o KMail (que é iniciado primeiro, se for necessário) como se segue:

      • Se o KMail for da versão 1.7 ou posterior, a mensagem é enviada automaticamente.

      • Se o KMail for de uma versão anterior, a mensagem é adicionada à pasta A enviar do KMail para ser transmitida posteriormente.

    • Sendmail: Quando é despoletado um alarme por e-mail, a mensagem é enviada automaticamente com o sendmail. Esta opção só irá funcionar se o seu sistema estiver configurado para 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 mensagem transmitida seja guardada na pasta enviado do KMail.

    Nota

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

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

    • Seleccione De para indicar um endereço de e-mail.

    • Seleccione a opção Usar o endereço do Centro de Controlo para usar o endereço de e-mail configurado no Centro de Controlo do KDE.

    • 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. A identidade 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 por e-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 ser enviadas para a sua conta, no computador em que o KAlarm está a correr, poderá simplesmente indicar o seu nome de utilizador aqui.

    • Seleccione a opção Usar o endereço do Centro de Controlo para usar o endereço de e-mail configurado no Centro de Controlo do KDE.

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Ver
Ver

Ver

A secção Ver permite-lhe controlar alguns aspectos da aparência do KAlarm:

  • Grupo da Lista de Alarmes: Estas opções controlam a informação que é mostrada inicialmente na lista de alarmes, quando o KAlarm é iniciado. (Logo que o KAlarm tenha iniciado, use o menu Ver para alterar os dados apresentados.)

    • Mostrar a hora do alarme: Seleccione esta opção para mostrar a data e a hora em que cada alarme será despoletado a seguir.

    • Mostrar a hora final do alarme: Seleccione esta opção para mostrar a quantidade de tempo que resta até que haja uma próxima ocorrência do alarme. O período de tempo é mostrado em dias (se for aplicável), horas e minutos.

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

    • Mostrar os alarmes das próximas 24 horas: Quando estiver seleccionada a opção, é mostrado 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 alarmes das próximas 24 horas. Seleccione-a para definir o número máximo de alarmes que serão enumerados.

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

    • Mostrar a hora até ao alarme: Seleccione esta opção para mostrar o período de tempo que falta até à próxima ocorrência de cada alarme. O período de tempo é definido em horas e minutos.

      • 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.

  • As janelas de mensagens têm uma barra de título e capturam o teclado: Esta opção controla se as janelas das mensagens de alarmes são modais ou não, isto é se capturam os eventos do teclado logo que aparecem. Veja a secção da Janela das mensagens de alarme para mais detalhes.

  • Mostrar os alarmes expirados: Seleccione esta opção para mostrar inicialmente os alarmes expirados na lista de alarmes, quando o KAlarm for iniciado. (Logo que o KAlarm tenha arrancado, veja a opção do menu Ver->Mostrar os Alarmes Expirados para alterar o que é apresentado.)

  • Intervalo de actualização do ícone da bandeja: Defina a frequência com que o ícone do KAlarm na bandeja do sistema é actualizado para reflectir se os alarmes são monitorizados de momento. Isto envolve a verificação se o servidor de alarmes está a correr.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Tipo de Letra e Cor
Tipo de Letra e Cor

Tipo de Letra e Cor

A secção do Tipo de Letra & Cor permite-lhe definir a aparência por omissão das mensagens de alarmes e as cores a serem usadas na lista de alarmes:

  • Seleccione o tipo de letra e cor de fundo por omissão a usar para a apresentação das mensagens de alarme.

  • Edite a lista de selecção de cores que é apresentada quando carregar na lista de cores de fundo:

    • Adicionar uma cor...: Mostra uma janela de selecção de cores que lhe permite escolher uma cor para adicionar à lista.

    • Remover a cor: Remove a cor que é apresentada de momento na lista da Cor de fundo da lista. O item da Cor personalizada não pode ser removido da lista e, quando é apresentado, fica desactivado.

  • Seleccione a cor a usar na lista de alarmes para mostrar os alarmes desactivados.

  • Seleccione a cor a usar na lista de alarmes para mostrar os alarmes expirados.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Editar
Editar

Editar

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

Para os alarmes visíveis:

  • Configura os estados por omissão para as opções Cancelar se atrasado, Fechar automaticamente a janela ao fim deste tempo, 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 ficheiro de 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.

Para todos os tipos de alarmes:

  • Mudar o tipo de recorrência predefinido.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 4. Operação com a linha de comandos
Operação com a linha de comandos
Anterior
Próximo

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 alarmes agendados, tal como foi descrito acima em Usar o KAlarm. As opções da linha de comandos específicas do KAlarm poderão ser usadas para efectuar as seguintes operações:

  • escalonar um novo alarme

  • controlar o servidor de alarmes

  • 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 aos outros programas interagirem com o KAlarm. Elas estão descritas no capítulo do Guia do Programador do KAlarm.

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

Escalonar um novo alarme

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

OpçãoDescrição
-a, --ack-confirmPede uma confirmação quando a mensagem de alarme for recebida.
-A, --attach URLIndica o nome ou o URL de um ficheiro que deverá ser anexado à mensagem de e-mail. Esta opção poderá ser repetida tantas vezes quantas as necessárias. O --mail terá de ser fornecido com esta opção.
--auto-closeFecha automaticamente a janela do alarme, depois de terminar o período indicado com a opção --late-cancel. A opção --late-cancel deverá ser indicada com esta opção.
-b, --beepToca uma campainha audível quando a mensagem for apresentada. O --speak, o --play e o --play-repeat não poderão ser indicados com esta opção.
--bccEnvia uma cópia invisível para si próprio. O --mail necessita ser indicado com esta opção.
-c, --color, --colour corIndica a cor de fundo da mensagem com o nome da cor no Qt™ ou com o código hexadecimal 0xRRGGBB.
-C, --colorfg, --colourfg corIndica a cor do texto da mensagem com o nome da cor no Qt™ ou com o código hexadecimal 0xRRGGBB.
-d, --disableDesactiva o alarme. Não irá disparar até que tenha sido activado manualmente.
-e, --exec linha de comandosIndica um comando a executar. Se for fornecida, esta opção deverá ser a última opção da linha de comandos do KAlarm. Todos os parâmetros subsequentes e as opções são interpretados como formando a linha de comandos a executar. O --file e o --mail não podem ser indicados com esta opção. O --ack-confirm, o --beep, o --color e o --colorfg são ignorados com esta opção.
-f, --file URLIndica o nome ou o URL de um ficheiro de texto ou de imagem cujo conteúdo irá formar a mensagem de alarme. O --exec e o --mail não poderão ser indicados e a mensagem não deverá estar presente com esta mensagem.
-F, --from-id IDUsa a identidade do KMail indicada como remetente da mensagem de e-mail. O --mail deverá ser indicado com esta opção.
-i, --interval períodoIndica o intervalo entre repetições do alarme. As horas/minutos são indicados no formato nHnM, em que o n é um número, isto é 3H30M. Os outros períodos de tempo são indicado no formato nX, em que o n é um número e o X é uma das seguintes letras: Y ('years' - anos), M ('months' - meses), W ('weeks' - semanas), D ('days' - dias). Se a opção --recurrence for também indicada, o Y (anos) e M (meses) não são permitidos. A opção é obrigatória se for usada a --until ou a --repeat.
-k, --korganizerMostra o alarme como um evento no calendário activo do KOrganizer.
-l, --late-cancel períodoCancela o alarme se não puder ser despoletado dentro do período indicado, a seguir à hora exacta. O período é indicado no mesmo formato que está descrito para a opção --reminder. O valor por omissão do período é 1 minuto.
-L, --loginDispara o alarme sempre que você se liga, após a autenticação. O --interval, o --repeat e o --until não podem ser fornecidos com esta opção.
-m, --mail endereçoEnvia uma mensagem de e-mail para o endereço indicado. Esta opção pode ser repetida tantas vezes quantas as necessárias. O --exec e o --file não podem ser indicados com esta opção. O --ack-confirm, o --beep, o --color e o --colorfg são ignorados com esta opção.
-p, --play URLIndica o nome ou o URL de um ficheiro de áudio a ser tocado logo que a mensagem de alarme seja apresentada. O --play-repeat, o --beep e o --speak não podem ser indicados com esta opção.
-P, --play-repeat URLIndica o nome ou o URL de um ficheiro de áudio a ser tocado repetidamente enquanto a mensagem de alarme estiver visível. O --play, o --beep e o --speak não podem ser indicados com esta opção.
--recurrence especificaçãoIndica o alarme a repetir. Especifique a repetição com a sintaxe do iCalendar (definida no RFC2445), isto é “FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO”. O --until não pode ser indicado com esta opção.
-r, --repeat contagemIndica o número de vezes que o alarme deverá ser despoletado ou, se for indicada uma recorrência com a opção --recurrence, o número de vezes que o alarme deverá ser despoletado de cada vez que o --recurrence o activar (isto é uma repetição dentro de uma recorrência). Se a opção --recurrence não estiver presente, indique -1 para repetir o alarme indefinidamente. O --interval deverá ser indicado, ainda que o --until não o possa ser, com esta opção.
-R, --reminder períodoMostra um alarme de chamada de atenção no período de tempo antes do alarme principal e de cada uma das suas repetições (se houverem). As horas/minutos são indicados no formato nHnM, em que o n é um número, isto é 3H30M. Os outros períodos de tempo são indicado no formato nX, em que o n é um número e o X é uma das seguintes letras: W ('weeks' - semanas), D ('days' - dias). Esta opção não pode ser usada com o --exec, o --mail ou o --reminder-once.
--reminder-once períodoMostra um alarme de chamada de atenção apenas uma vez, logo que o período de tempo indicado antes da primeira ocorrência do alarme tenha sido atingido. Não será mostrada qualquer chamada de atenção antes das recorrências subsequentes (se existirem). Esta opção não poderá ser indicada com a --exec, --mail ou a --reminder.
-s, --speakFala a mensagem quando esta for apresentada. Esta opção necessita de ter o KTTSD instalado e configurado com um sintetizador de fala compatível. O --beep, o --play e o --play-repeat não poderão ser indicados com esta opção.
-S, --subject assuntoA linha do assunto da mensagem de e-mail. O --mail deverá ser indicado com esta opção.
-t, --time data/horaDispara o alarme na data ou data/hora indicadas. Indique uma data sem hora no formato aaaa-mm-dd; indique uma data e hora no formato [[[aaaa-]mm-]dd-]hh:mm (sempre que forem omitidos, os campos da data usam os valores do dia de hoje).
-v, --volume percentagemDefine o volume do áudio para tocar o ficheiro de áudio. Esta opção só poderá ser usada quando o --play ou o --play-repeat forem também usados.
-u, --until data/horaRepete o alarme até à data ou data/hora indicadas. Indique uma data sem hora no mesmo formato que é usado no --time. O --interval deverá ser usado, enquanto que o --repeat e o --recurrence não poderão ser usados, com esta opção.
mensagemO texto da mensagem a mostrar ou, se o --mail for indicado, o corpo da mensagem de e-mail.

Tanto deverá ser usado um texto de mensagem, o --file ou o --exec; 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 um fundo 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"
Outras opções
Outras opções

Outras opções

As opções seguintes são usadas para inicializar de novo ou parar o servidor de alarmes, para mostrar a janela de edição de alarmes ou para controlar o modo de apresentação do KAlarm.

Veja a secção do Servidor de alarmes para uma discussão sobre como reiniciar e parar o servidor de alarmes.

OpçãoDescrição
--edit idEventoMostra a janela de edição de alarmes para editar o alarme com o identificador indicado.
-n, --edit-newMostra a janela de edição de alarmes para editar um novo alarme.
--edit-new-preset nomeModeloMostra a janela de edição do alarme, predefinida com o modelo de alarme com o nome indicado, para editar um alarme novo.
--resetReinicializa o servidor de alarmes.
--stopPára o servidor de alarmes.
--trayMostra o KAlarm como um ícone na bandeja do sistema.

Por exemplo, para reinicializar o servidor de alarmes:

% kalarm --reset


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Opções de ajuda
Opções de ajuda

Opções de ajuda

As seguintes opções de ajuda são comuns a todos os programas do KDE:

OpçãoDescrição
--helpMostra um texto breve de ajuda das opções.
--help-qtMostra várias opções genéricas usadas pelo Qt™.
--help-kdeMostra várias opções genéricas usadas pelo KDE.
--help-allMostra todas as opções.
--authorMostra os nomes e endereços de e-mail dos autores do KAlarm.
-v, --versionMostra as versões usadas da biblioteca Qt™, do KDE e do KAlarm.
--licenseMostra informações acerca da licença.


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 5. Servidor de alarmes
Servidor de alarmes
Anterior
Próximo

Capítulo 5. Servidor de alarmes

O servidor de alarmes, o KAlarmd, vigia o ficheiro do calendário do KAlarm à procura dos alarmes cuja hora esteja prestes a chegar. Quando ele concluir que chegou a hora de despoletar um dado alarme, indica ao KAlarm para o mostrar ou executar ou para o cancelar, se já passou a sua hora e se este não estiver configurado para tocar após a sua hora.

O servidor de alarmes corre em segundo plano, sem nenhuma interface de utilizador. Poderá ser controlado da forma que é descrita em baixo.

Iniciar, reinicializar e parar o servidor de alarmes

O servidor de alarmes é normalmente iniciado no arranque da sessão do KDE (a menos que desactive o arranque automático na janela de preferências e pare então de usar o KAlarm) e corre continuamente até que você encerre a sessão. Se por alguma razão não estiver a correr, a monitorização dos alarmes não irá ocorrer e o KAlarm não irá mostrar ou executar nenhuns alarmes.

Iniciar o servidor de alarmes

Para iniciar o servidor de alarmes, poderá tanto correr o KAlarm no seu modo gráfico por omissão (isto é sem usar nenhuns parâmetros da linha de comandos que não o --tray), activar os alarmes com o menu do ícone da bandeja do sistema do KAlarm, reinicializar o servidor tal como é descrito em baixo ou poderá iniciar o servidor de alarmes directamente a partir da linha de comandos:

% kalarmd

Reinicializar o servidor de alarmes

Também é possível reinicializar o servidor de alarmes sem o parar. A reinicialização faz com que o servidor de alarmes leia de novo a lista das mensagens agendadas do ficheiro de calendário e reinicialize os dados relacionados com o KAlarm.

Porque é que poderá querer reinicializar o servidor de alarmes? Não é uma ocorrência muito provável mas, se por alguma razão, o KAlarm não foi capaz de se executar quando o servidor de alarmes lhe indicou para disparar um alarme, este nunca será mostrado ou executado até que o servidor de alarmes seja reinicializado ou reiniciado.

Dica

A reinicialização arranca o servidor de alarmes se não estiver já em execução.

Para inicializar de novo o servidor de alarmes, tanto pode usar a opção do menu Acções->Refrescar os Alarmes ou indicar o seguinte comando:

% kalarm --reset

Parar o servidor de alarmes

Se parar o servidor de alarmes irá impedir as monitorizações posteriores das mensagens de alarmes agendadas, até que o servidor seja reiniciado.

Para parar o servidor de alarmes, escreva o seguinte comando:

% kalarm --stop
Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 6. Guia de Programador do KAlarm
Guia de Programador do KAlarm
Anterior
Próximo

Capítulo 6. 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

  • despoletar ou cancelar um alarme já agendado

  • cancelar um alarme já agendado

  • disparar um alarme já agendado

  • mostra a janela de edição do alarme

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

Interface DCOP

As chamadas de DCOP descritas neste documento estão todas implementadas no objecto de DCOP request do KAlarm. A interface está definida no ficheiro kalarmiface.h.

Nota

No KAlarm versão 1.2, a interface de DCOP foi completamente revista para permitir uma chamada mais simples das funções e para estar numa melhor conformidade com a configuração normal do KDE para o DCOP. A interface de DCOP antiga continua a estar disponível por razões de compatibilidade, mas poderá ser removida no futuro.

cancelEvent
cancelEvent

Nome

cancelEvent — cancela um alarme já agendado.

Sinopse

void cancelEvent(const QString& ficheiroCalendario, const QString& idEvento)

Parâmetros

ficheiroCalendario

Indica o URL (não o local) do ficheiro de calendário que contém o evento a ser cancelado.

idEvento

Indica o identificador único do evento a ser cancelado, tal como está armazenado no ficheiroCalendario.

Descrição

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

Nota

O parâmetro ficheiroCalendario só é usado para a verificação da integridade: se o URL não se referir ao ficheiro de calendário por omissão do KAlarm, o pedido será ignorado.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

triggerEvent
triggerEvent

Nome

triggerEvent — despoleta um alarme já escalonado.

Sinopse

void triggerEvent(const QString& ficheiroCalendario, const QString& idEvento)

Parâmetros

ficheiroCalendario

Indica o URL (não o local) do ficheiro de calendário que contém o evento a ser disparado.

idEvento

Indica o identificador único do evento a ser despoletado, tal como está armazenado no ficheiroCalendario.

Descrição

O triggerEvent() é uma chamada de DCOP para disparar o alarme indicado (independentemente da hora para que foi agendado). O KAlarm obtém o alarme do ficheiro de calendário e depois mostra-o ou executa-o.

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

Nota

O parâmetro ficheiroCalendario só é usado para a verificação da integridade: se o URL não se referir ao ficheiro de calendário por omissão do KAlarm, o pedido será ignorado.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

handleEvent
handleEvent

Nome

handleEvent — despoleta ou cancela um alarme já escalonado.

Sinopse

void handleEvent(const QString& ficheiroCalendario, const QString& idEvento)

Parâmetros

ficheiroCalendario

Indica o URL (não o local) do ficheiro de calendário que contém o evento a ser apresentado/executado ou cancelado.

idEvento

Indica o identificador único do evento a ser apresentado/executado ou cancelado, tal como está armazenado no ficheiroCalendario.

Descrição

O handleEvent() é uma chamada de DCOP para apresentar/executar ou cancelar o alarme indicado. O KAlarm obtém o alarme do ficheiro de calendário e depois determina a acção a tomar, dependendo se o alarme já foi disparado ou não.

  • Se ainda não chegou a hora do alarme, não acontece nada.

  • Se chegou a hora do alarme, ele actua da seguinte forma. Se a opção de cancelamento em caso de atraso estiver activa e o alarme estiver atrasado, isto é a hora agendada para o alarme já passou há mais de um minuto, o KAlarm não mostra nem executa o alarme; caso contrário, o KAlarm mostra ou executa o alarme. Se não existirem mais repetições do alarme agendadas, o KAlarm remove então o alarme do ficheiro de calendário.

Nota

O parâmetro ficheiroCalendario só é usado para a verificação da integridade: se o URL não se referir ao ficheiro de calendário por omissão do KAlarm, o pedido será ignorado.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

scheduleMessage
scheduleMessage

Nome

scheduleMessage — escalonar uma nova mensagem de alarme.

Sinopse

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

Parâmetros

mensagem

Indica o texto da mensagem a agendar.

dataHora

Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para um alarme apenas de data, o texto deverá estar no formato “AAAA-MM-DD” (tal como é devolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o texto deverá estar no formato “AAA-MM-DDTHH:MM[:SS]” (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em “HH:MM[:SS]” (tal como é devolvido pelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indicado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarme nã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 que estã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 valores de dois algarismos em hexadecimal para o vermelho, verde e azul. Em alternativa, o texto poderá ser qualquer um dos outros formatos aceites pelo QColor::setNamedColor(), como o nome de uma cor na base de dados de cores do X (isto é “red” ou “steelblue”). Ponha o texto 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 que para o fundo; em alternativa, poderá pôr o texto nulo para indicar a cor de texto actualmente por omissão.

tipoLetra

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

urlAudio

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

chamadaAtencao

Indica o número de minutos de avanço em relação ao alarme principal e a cada uma das suas repetições (se existirem) no qual será mostrado um alarme de chamada de atenção. 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á definida 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 um alarme 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, WEEKLY, 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 dataHora.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido no parâ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 alarme indefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluir uma hora, este parâmetro deverá também incluir uma hora; se o dataHora conter apenas uma data, este parâmetro também deverá apenas conter uma data.

intervaloRepeticaoSimples

Indica o número de minutos entre repetições simples do alarme. Indique 0 para não ocorrer qualquer repetição simples.

numeroRepeticoesSimples

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

Descrição

O scheduleMessage() é uma chamada de DCOP para agendar a mensagem de alarme fornecida para a data e hora indicadas. Tem várias formas possíveis. As forma mais geral permite a indicação de uma recorrência arbitrária para ser indicada – use também estas para os alarmes não-repetitivos. As outras formas oferecem um acesso conveniente a um conjunto restrito de tipos de recorrências de alarmes, uma para uma quantidade de repetições e a outra até uma hora de fim.

Se a hora agendada (incluindo as repetições) já tiver passado, o KAlarm mostra imediatamente a mensagem (a menos que o parâmetro cancelarSeAtrasado indique que já é muito tarde para mostrar 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 mostrar posteriormente.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

scheduleFile
scheduleFile

Nome

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

Sinopse

bool scheduleFile(const QString& URL, const QDateTime& dataHora, const QColor& fundo, int cancelarSeAtrasado, int opcoes, const QString& urlAudio, int chamadaAtencao, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)
bool scheduleFile(const QString& URL, const QDateTime& dataHora, const QColor& fundo, int cancelarSeAtrasado, int opcoes, const QString& urlAudio, int chamadaAtencao, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)
bool scheduleFile(const QString& URL, const QDateTime& dataHora, const QColor& fundo, int cancelarSeAtrasado, int opcoes, const QString& urlAudio, int chamadaAtencao, 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 ser agendada.

dataHora

Indica a hora agendada, ou data e hora, a que o ficheiro deverá ser mostrado. Para um alarme apenas de data, o texto deverá estar no formato “AAAA-MM-DD” (tal como é devolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o texto deverá estar no formato “AAA-MM-DDTHH:MM[:SS]” (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em “HH:MM[:SS]” (tal como é devolvido pelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indicado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarme nã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 que estã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 valores de dois algarismos em hexadecimal para o vermelho, verde e azul. Em alternativa, o texto poderá ser qualquer um dos formatos aceites pelo QColor::setNamedColor(), com o nome de uma cor na base de dados de cores do X (isto é “red” ou “steelblue”). Ponha o texto vazio 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 valor como nulo se não for para tocar nenhum ficheiro.

chamadaAtencao

Indica o número de minutos de avanço em relação ao alarme principal e a cada uma das suas repetições (se existirem) no qual será mostrado um alarme de chamada de atenção. 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á definida 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 um alarme 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, WEEKLY, 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 dataHora.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido no parâ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 alarme indefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluir uma hora, este parâmetro deverá também incluir uma hora; se o dataHora conter apenas uma data, este parâmetro também deverá apenas conter uma data.

intervaloRepeticaoSimples

Indica o número de minutos entre repetições simples do alarme. Indique 0 para não ocorrer qualquer repetição simples.

numeroRepeticoesSimples

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

Descrição

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



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

scheduleCommand
scheduleCommand

Nome

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

Sinopse

bool scheduleCommand(const QString& linhaComandos, const QDateTime& dataHora, int cancelarSeAtrasado, int opcoes, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)
bool scheduleCommand(const QString& linhaComandos, const QDateTime& dataHora, int cancelarSeAtrasado, int opcoes, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)
bool scheduleCommand(const QString& linhaComandos, const QDateTime& dataHora, int cancelarSeAtrasado, int 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.

dataHora

Indica a hora agendada, ou data e hora, a que o comando deverá ser executado. Para um alarme apenas de data, o texto deverá estar no formato “AAAA-MM-DD” (tal como é devolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o texto deverá estar no formato “AAA-MM-DDTHH:MM[:SS]” (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em “HH:MM[:SS]” (tal como é devolvido pelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indicado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarme nã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 que estã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á definida 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 um alarme 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, WEEKLY, 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 dataHora.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido no parâ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 alarme indefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluir uma hora, este parâmetro deverá também incluir uma hora; se o dataHora conter apenas uma data, este parâmetro também deverá apenas conter uma data.

intervaloRepeticaoSimples

Indica o número de minutos entre repetições simples do alarme. Indique 0 para não ocorrer qualquer repetição simples.

numeroRepeticoesSimples

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

Descrição

O scheduleCommand() é uma chamada de DCOP para agendar o comando da consola para ser executado na data e hora indicadas. Para além de indicar uma linha de comandos e de omitir a cor 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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

scheduleEmail
scheduleEmail

Nome

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

Sinopse

bool scheduleEmail(const QString& idRemetente, const QString& enderecos, const QString& assunto, const QString& mensagem, const QString& anexos, const QDateTime& dataHora, int cancelarSeAtrasado, int opcoes, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)
bool scheduleEmail(const QString& idRemetente, const QString& enderecos, const QString& assunto, const QString& mensagem, const QString& anexos, const QDateTime& dataHora, int cancelarSeAtrasado, int opcoes, int tipoRepeticaoSimples, int intervalo, int numeroRepeticoes)
bool scheduleEmail(const QString& idRemetente, const QString& enderecos, const QString& assunto, const QString& mensagem, const QString& anexos, const QDateTime& dataHora, int cancelarSeAtrasado, int 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á usado o endereço de e-mail do remetente que esteja configurado nas preferências de e-mail do KAlarm.

enderecos

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

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 mensagem de e-mail.

dataHora

Indica a hora agendada, ou data e hora, a que a mensagem de e-mail deverá ser enviada. Para um alarme apenas de data, o texto deverá estar no formato “AAAA-MM-DD” (tal como é devolvido pelo QDate::toString(Qt::ISODate)). Para um alarme com data e hora, o texto deverá estar no formato “AAA-MM-DDTHH:MM[:SS]” (tal como é devolvido pelo QDateTime::toString(Qt::ISODate)) ou em “HH:MM[:SS]” (tal como é devolvido pelo QTime::toString(Qt::ISODate)). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.

cancelarSeAtrasado

Faz com que o alarme seja cancelado, se não puder ser disparado dentro do período indicado em minutos, após a hora agendada para o alarme. Se o valor for igual a 0, o alarme nã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 que estã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á definida 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 um alarme 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, WEEKLY, 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 dataHora.

intervaloRecorrencia

Indica o número de períodos (minutos/dias/semanas/meses/anos, como é definido no parâ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 alarme indefinidamente.

dataHoraFim

Indica a data ou data/hora de fim para as repetições do alarme. Se o dataHora incluir uma hora, este parâmetro deverá também incluir uma hora; se o dataHora conter apenas uma data, este parâmetro também deverá apenas conter uma data.

intervaloRepeticaoSimples

Indica o número de minutos entre repetições simples do alarme. Indique 0 para não ocorrer qualquer repetição simples.

numeroRepeticoesSimples

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

Descrição

O scheduleEmail() é uma chamada de DCOP para agendar o envio da mensagem de e-mail na data e hora indicadas. Para além de indicar o cabeçalho e o conteúdo da mensagem de e-mail e de omitir a cor 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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

edit
edit

Nome

edit — Mostra a janela de edição do alarme para editar um alarme.

Sinopse

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 DCOP para mostrar a janela de edição do alarme, para editar o alarme indicado.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

editNew
editNew

Nome

editNew — Isto mostra a janela de edição do alarme para editar um alarme novo.

Sinopse

bool editNew(const QString& nomeModelo)

Parâmetros

nomeModelo

Indica o nome de um modelo de alarme no qual basear o novo alarme, ou vazio se não deverá ser usado qualquer modelo.

Valor devolvido

false, se o nomeModelo não estiver em branco, mas o modelo com esse nome não existir, caso contrário true.

Descrição

A editNew() é uma chamada de DCOP para mostrar a janela de edição de alarmes para poder editar um alarme novo. Se for indicado o nome de um modelo de alarme como parâmetro, a janela é preenchida com os detalhes do modelo. Se o modelo indicado não for encontrado, a janela de edição de alarmes fica visível à mesma mas (obviamente) não fica preenchida com os dados de nenhum modelo.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Interface de linha de comando
Interface de linha de comando

Interface de linha de comando

As opções da linha de comandos são disponibilizadas para permitir aos outros programas (como o servidor de alarmes) iniciarem o KAlarm se não estiver já a correr, para que possam despoletar ou cancelar os alarmes agendados ou ainda para agendar alarmes novos. A razão para usar as opções da linha de comandos para este fim é que, se o KAlarm fosse arrancado sem nenhuns parâmetros da linha de comandos e lhe fossem então enviados pedidos de DCOP, ele iria iniciar no seu modo gráfico por omissão, o que é claramente indesejável para um pedido entre programas.

Nota

Os programas deverão verificar primeiro se o KAlarm já está a correr; se estiver, então aí deverão usar chamadas de DCOP para efectuar essas operações.

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

Nota

Os utilizadores normais poderão também, se o desejarem, usar estas opções da linha de comandos (assumindo que podem passar a informação dos parâmetros necessários).

OpçãoDescrição
--calendarURL urlUsa o ficheiro do calendário com o URL indicado. Esta opção só é usada para a verificação de integridade: se o URL não fizer referência ao ficheiro de calendário por omissão do KAlarm, o pedido será ignorado.
--cancelEvent idEventoCancela o alarme com o identificador de evento indicado.
--triggerEvent idEventoDispara o alarme com o identificador de evento indicado. A acção tomada é a mesma da chamada de DCOP triggerEvent().
--handleEvent idEventoDispara ou cancela o alarme com o identificador de evento indicado. O KAlarm determina a acção a tomar da mesma forma que é usada na chamada de DCOP handleEvent().

O --cancelEvent, o --triggerEvent e o --handleEvent são mutuamente exclusivos. O --calendarURL é opcional, mas só pode ser usado com uma das três opções referidas.

Exemplos:

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


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 7. Perguntas e Respostas
Perguntas e Respostas
Anterior
Próximo

Capítulo 7. Perguntas e Respostas

Este documento pode ter sido actualizado desde a sua instalação. Você poderá encontrar a última versão em http://docs.kde.org/current/kdepim/.

7.1. O que é o servidor de alarmes?
7.2. Que ficheiros de configuração é que o KAlarm utiliza?
7.3. Quais os ficheiros de configuração que o servidor de alarmes usa?
7.4. Em que formato estão guardados os alarmes?
7.5. Quais são os nomes das aplicações KAlarm e do servidor de alarmes?
7.1.

O que é o servidor de alarmes?

O servidor de alarmes é uma aplicação que corre em segundo plano, monitorizando os alarmes e indicando ao KAlarm para os despoletar quando chegar a sua hora.

7.2.

Que ficheiros de configuração é que o KAlarm utiliza?

O ficheiro $KDEHOME/share/config/kalarmrc contém as suas referências ao KAlarm.

O ficheiro do calendário que guarda os seus alarmes pendentes é o $KDEHOME/share/apps/kalarm/calendar.ics, a menos que seja indicado um ficheiro diferente no ficheiro de preferências com o item Calendar na secção General.

O ficheiro do calendário que guarda os seus alarmes expirados é o $KDEHOME/share/apps/kalarm/expired.ics, a menos que seja indicado um ficheiro diferente no ficheiro de preferências com o item ExpiredCalendar na secção General.

O ficheiro do calendário que guarda os seus modelos de alarmes é o $KDEHOME/share/apps/kalarm/template.ics, a menos que seja indicado um ficheiro diferente no ficheiro de preferências com o item TemplateCalendar na secção General.

Os detalhes dos alarmes que estão visíveis de momento são guardados no ficheiro de calendário $KDEHOME/share/apps/kalarm/displaying.ics.

7.3.

Quais os ficheiros de configuração que o servidor de alarmes usa?

O ficheiro $KDEHOME/share/config/kalarmdrc guarda as suas preferências do servidor de alarmes, em conjunto com os detalhes da aplicação cliente KAlarm.

7.4.

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 Scheduling Core Object Specification (iCalendar). Este é o formato-padrão que é usado em todas as aplicações do 'kdepim'. O KAlarm usa certas propriedades fora da norma no componente do Alarme, em relação ao RFC2445: X-KDE-KALARM-TYPE, X-KDE-KALARM-FONTCOLOR, X-KDE-KALARM-VOLUME, X-KDE-KALARM-SPEAK, X-KDE-KALARM-KMAILID.

7.5.

Quais são os nomes das aplicações KAlarm e do servidor de alarmes?

O nome da aplicação KAlarm é kalarm e o nome da aplicação do servidor de alarmes é kalarmd.

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Capítulo 8. Créditos e Licença
Créditos e Licença
Anterior
Próximo

Capítulo 8. Créditos e Licença

KAlarm

Programa copyright 2001, 2002, 2003, 2004, 2005, 2006 David Jarvie

Autores do servidor de alarmes:

  • Preston Brown

  • David Jarvie

  • Cornelius Schumacher

Documentação copyright 2001, 2002, 2003, 2004, 2005, 2006 David Jarvie

Tradução de José Nuno Pires

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 Nikolaus , que permitiu gentilmente o uso do KAlarm nesta aplicação do KDE 2 / KDE 3.

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Apêndice A. Instalação
Instalação
Anterior
Próximo

Apêndice A. Instalação

Como obter o KAlarm

O KAlarm faz parte do projecto do KDE http://www.kde.org/.

O KAlarm pode ser encontrado no pacote kdepim em ftp://ftp.kde.org/pub/kde/, o servidor principal do projecto do KDE.

O KAlarm está disponível para o KDE 2 e como pacote autónomo para o KDE 3 em http://www.astrojar.org.uk/linux/kalarm.html

Requisitos
Requisitos

Requisitos

O KAlarm precisa das bibliotecas normais do KDE instaladas (o pacote kdelibs). Para compilar o código-fonte, também precisa dos pacotes de desenvolvimento do Qt™ e das kdelibs. O pacote de desenvolvimento do X11, se estiver presente, é usado para aumentar a possibilidade de o KAlarm funcionar no KDE sem uma bandeja do sistema.

Os seguintes pacotes opcionais melhoram o KAlarm na sua execução, se estiverem instalados:

  • KMix (do pacote 'kdemultimedia'): se estiver instalado, permite ao KAlarm define o volume de som absoluto ao tocar os ficheiros de áudio.

  • KTTSD (do pacote 'kdeaccessibility'): se estiver instalado e configurado, em conjunto com um sintetizador de fala compatível, permite ao KAlarm falar as mensagens de alarme quando forem apresentadas.

O KAlarm usa cerca de 12 Mb e o servidor de alarmes usa aproximadamente 2,5 Mb de memória para correr, mas isto poderá variar de acordo com a sua plataforma e configuração.

Poderá encontrar uma lista das alterações no ficheiro ChangeLog ou em http://www.astrojar.org.uk/linux/kalarm.html.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Compilação e instalação
Compilação e instalação

Compilação e instalação

Se não conseguir encontrar um pacote binário adequado, irá necessitar de compilar você mesmo o KAlarm a partir dos ficheiros de código. Obtenha o pacote do código-fonte kdepim-x.x.tar.bz2 ou o kalarm-x.x.tar.bz2 (ou algo do género), depende se deseja instalar o kdepim ou apenas o KAlarm. Descomprima-o numa nova pasta com um comando do tipo tar xvfj pacote.tar.bz2 e entre na pasta que foi criada.

Para poder compilar e instalar o KAlarm no seu sistema escreva o seguinte na pasta de base da distribuição do KAlarm:

% ./configure
% make
% make install

Dado que o KAlarm usa o autoconf e o automake não deve ter quaisquer problemas a compilá-lo. Se tiver, comunique-os para as listas do KDE.

Nota

Se tiver mais do que uma versão do KDE instalada (isto é, o KDE 2 e o KDE 3), isso poderá fazer com que o KAlarm seja instalado na pasta errada do KDE. Se necessário, poderá indicar a pasta do KDE como um parâmetro do ./configure. Por exemplo, se o seu KDE estiver instalado em /opt/kde2:

./configure --prefix=/opt/kde2

Atenção

Se instalar o KAlarm numa pasta diferente da onde o KDE está instalado, este não irá executar correctamente, a menos que torne a sua localização conhecida para o KDE. Para o fazer, deve anteceder a variável de ambiente KDEDIRS com a localização do KAlarm, de cada vez que inicie o KDE.

Por exemplo, se o KDE for instalado em /opt/kde, o KDEDIRS poderá estar normalmente configurado como /etc/opt/kde:/opt/kde. Se instalar o KAlarm em /usr/local, poderá ter de configurar a variável KDEDIRS como /usr/local:/etc/opt/kde:/opt/kde, antes de iniciar o KDE.

A versão autónoma do KAlarm tem uma opção de configuração especial que lhe permite seleccionar quais as línguas da documentação a instalar, indicando um código da língua ou uma lista de códigos de línguas como parâmetro do ./configure. Por omissão, é instalada a documentação em todas as línguas disponíveis. Está disponível uma lista com as línguas da documentação incluídas no pacote, em conjunto com os seus códigos, no ficheiro DOC-LANGUAGES. Por exemplo, para instalar apenas a documentação em Francês e Inglês Britânico:

./configure --enable-doc-language="fr en_GB"

Lembre-se que esta opção não fará efeito nas traduções da interface de utilizador que estiverem instaladas.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Configuração
Configuração

Configuração

Não é necessária nenhuma configuração em especial para configurar o KAlarm para correr no ambiente de trabalho do KDE. Logo que tenha corrido o KAlarm pela primeira vez, o servidor de alarmes irá iniciar sempre que você iniciar uma sessão, para poder monitorizar os alarmes agendados.

Para correr o KAlarm num ambiente de trabalho não-KDE, o requisito principal é garantir que o servidor de alarmes é corrido automaticamente sempre que você iniciar uma sessão. Poderá obter instruções mais detalhadas no ficheiro INSTALL que é distribuído com o KAlarm.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Anterior
Próximo
Início


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Próximo
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team