<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalarm;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Brazilian-Portuguese "INCLUDE"
><!-- change language only here -->
]>

<!-- The language must NOT be changed here. -->

<book id="kalarm" lang="&language;">

<bookinfo id="kalarminfo">
<title
>Manual do &kalarm;</title>

<authorgroup>
<author
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
> <address
>&David.Jarvie.mail;</address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
>&David.Jarvie.mail;</address
></affiliation>
<contrib
>Desenvolvimento</contrib>
</othercredit>

<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year
><year
>2004</year
><year
>2005</year
><year
>2006</year
><year
>2007</year
><year
>2008</year
><year
>2009</year
><year
>2010</year
><year
>2011</year
><year
>2012</year
><year
>2013</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>28/05/2013</date>
<releaseinfo
>2.10.03 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>O &kalarm; é um agendador de mensagens de alarme pessoais, comandos e mensagens eletrônicas para o &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarme</keyword>
<keyword
>lembrete</keyword>
<keyword
>agendador</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Introdução</title>

<para
>O &kalarm; permite que você agende a exibição de mensagens de alarme pessoais, a reprodução de arquivos de som, a execução de comandos e o envio de mensagens eletrônicas.</para>

<para
>No seu modo gráfico padrão, o &kalarm; mostra a lista de alarmes pendentes, apresentando as suas horas e os seus detalhes. Você pode criar novos alarmes ou selecionar alarmes existentes para modificar ou remover. Poderá ainda, opcionalmente, ver os alarmes que expiraram.</para>

<para
>Ao configurar um alarme, você poderá escolher se ele deverá ser repetido e se o mesmo deverá ser cancelado se não puder ser ativado na hora agendada. Nos alarmes visíveis, você poderá inserir o texto da mensagem de alarme, indicar um arquivo de texto ou de imagem a mostrar ou indicar um comando para ser executado, cujo resultado será apresentado. Você poderá também escolher a cor da mensagem de alarme, se deverá ser tocado um som ou falado o texto do alarme.</para>

<para
>Os alarmes também podem ser agendados a partir da linha de comando, ou através de chamadas &DBus; de programas.</para>

<para
>Quando uma mensagem de alarme atinge a sua hora, é mostrada em cada uma das telas do &kde; para garantir que você a veja. 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 novamente mais tarde. Um exemplo de uma mensagem de alarme:</para>

<screenshot>
<screeninfo
>Captura de tela da janela de mensagem do &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Mensagem de alarme</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Quando o alarme tem atribuído um comando para executar ou uma mensagem eletrônica para enviar, o &kalarm; não mostra nada.</para>

<para
>O &kalarm; mostra normalmente um ícone na área de notificação, ainda que ele possa ficar oculto, se desejar.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Usando o &kalarm;</title>

<para
>Quando é executado sem parâmetros na linha de comando, o &kalarm; inicia no modo gráfico e mostra a lista atual de alarmes pendentes.</para>

<tip
><para
>Todas as caixas de contagem 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 clica nas caixas de contagem.</para>

<mediaobject>
<imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</tip>

<sect1 id="alarm-types">
<title
>Tipos de Alarme</title>

<para
>As funções básicas, disponíveis nos diferentes tipos de alarmes que o &kalarm; oferece, são:</para>

<itemizedlist>
<listitem>
<para
>Os alarmes visíveis apresentam uma mensagem de texto escrita por você, o conteúdo de um arquivo de texto ou de imagem, ou ainda o resultado textual de um comando que é executado quando o alarme for disparado. Além de mostrar um destes itens, poderão também reproduzir arquivos de áudio, sintetizar o seu texto ou emitir um simples apito. Você poderá também indicar os comandos a executar antes e depois da mensagem de alarme ser apresentada.</para>
</listitem>

<listitem>
<para
>Os comandos de alarme executam um comando ou um programa indicado por você. Não é apresentado nada, a menos que ocorra algum erro.</para>
</listitem>

<listitem>
<para
>Os alarmes por e-mail enviam um e-mail. Nada é apresentado, a menos que ocorra algum erro.</para>
</listitem>

<listitem>
<para
>Os alarmes de áudio tocam um arquivo de som. Nada é apresentado, a menos que ocorra algum erro.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Tratamento de Erros</title>

<para
>Se ocorrer algum erro ao disparar um alarme, será apresentada uma mensagem de erro (a menos que você tenha dito explicitamente para não mostrar esse tipo de mensagens de novo).</para>

<para
>Se ocorreu um erro de execução da última vez que um alarme de comando foi disparado, é apresentado um ponto de exclamação branco sobre fundo vermelho, na coluna da cor da mensagem. Os detalhes do erro são apresentados numa dica, caso posicione o cursor sobre essa linha na lista de alarmes. As mesmas indicações de erros são apresentadas para os alarmes visíveis, caso ocorra um erro de execução para um comando pré- ou pós-alarme, caso sejam definidos na janela de Ações Especiais, excetuando o fato de que a coluna da cor não muda para um fundo vermelho.</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Lista de Alarmes</title>

<para
>A janela principal do &kalarm; mostra a lista atual de alarmes pendentes, mostrando as suas horas, intervalos de repetição e textos de mensagens, os nomes dos arquivos a apresentar, os comandos a executar ou os assuntos das mensagens de e-mail. (Para um alarme recorrente ou um alarme com um lembrete, a hora apresentada é a sua próxima hora agendada). Um ícone que se encontra à esquerda de cada texto/arquivo/comando/assunto de e-mail do alarme indica o seu tipo.</para>

<screenshot>
<screeninfo
>Captura de tela da janela principal do &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Janela principal</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Para um alarme repetitivo, a lista mostra a sua próxima hora de ativação e o seu intervalo básico de repetição (&eg; <quote
>1 Dia</quote
> para uma repetição diária, <quote
>3 Semanas</quote
> para uma repetição disparada na Segunda e na Quarta na terceira semana e o <quote
>Login</quote
> para um alarme que se repete depois do login).</para>

<para
>Se ocorreu um erro de execução da última vez que foi disparado um alarme de comando, ou da última vez que foi executado um comando pré- ou pós-alarme, será apresentada uma indicação do erro na coluna da cor, como se encontra descrito acima no <link linkend="errors"
>Tratamento de Erros</link
>.</para>

<sect2 id="listappear">
<title
>Alterar a Aparência da Lista de Alarmes</title>

<para
>Os alarmes poderão ser ordenados por data/hora, intervalo de repetição, cor ou texto clicando-se na barra de título da coluna apropriada. Para inverter o critério de ordenação, clique no título da coluna novamente.</para>

<para
>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 ocultar a coluna da hora do alarme, selecione <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Mostrar Horas dos Alarmes</guimenuitem
></menuchoice
>. Para mostrar ou ocultar a coluna com o tempo que falta até disparar os alarmes, selecione a opção <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Mostrar a Tempo Até Os Alarmes</guimenuitem
></menuchoice
>. Pelo menos uma destas colunas é sempre visível.</para>

<para
>Se você usar diversos calendários de alarmes, poderá colorir os alarmes com diferentes cores para distinguir o recurso a que pertencem, selecionando uma cor de fundo diferente para cada recurso (veja <link linkend="using-calendars"
>Usando calendários</link
>).</para>

</sect2>

<sect2 id="expired">
<title
>Alarmes Arquivados</title>

<para
>Por padrã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.). Você poderá controlar se o &kalarm; guarda os alarmes expirados, e durante quanto tempo, na <link linkend="preferences-storage"
>janela de Configuração</link
>.</para>

<para
>Os alarmes arquivados poderão ser mostrados na lista de alarmes se selecionar a opção <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Mostrar os Alarmes Arquivados</guimenuitem
></menuchoice
>. Para ocultá-los novamente, desligue a opção <menuchoice
><guimenu
>Ver</guimenu
><guimenuitem
>Mostrar os Alarmes Arquivados</guimenuitem
></menuchoice
>.</para>

</sect2>

<sect2 id="search">
<title
>Procurar na Lista de Alarmes</title>

<para
>Você poderá procurar na lista de alarmes para descobrir os alarmes que contêm um determinado texto de procura. Para invocar isto, selecione a opção <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Procurar...</guimenuitem
></menuchoice
>. Na janela de procura, selecione os tipos de alarmes que deseja procurar. Para continuar a procurar por mais alarmes correspondentes, use a opção <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Procurar o Próximo</guimenuitem
></menuchoice
> ou <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Procurar o Anterior</guimenuitem
> </menuchoice
>.</para>

<para
>A procura é efetuada da seguinte forma:</para>

<itemizedlist>
<listitem>
<para
>Alarmes de texto: é pesquisado o texto da mensagem.</para>
</listitem>

<listitem>
<para
>Alarmes de arquivos: é pesquisado o local/&URL; do arquivo.</para>
</listitem>

<listitem>
<para
>Alarmes de comando: é pesquisada a linha de comando ou o programa.</para>
</listitem>

<listitem>
<para
>Alarmes de e-mail: além do assunto e do corpo da mensagem de e-mail, são pesquisados os destinatários e os URLs dos anexos.</para>
</listitem>

<listitem>
<para
>Alarmes de áudio: é pesquisado o local/&URL; do arquivo.</para>
</listitem>
</itemizedlist>

<note
><para
>Somente os alarmes que aparecem atualmente na lista de alarmes é que poderão ser selecionados para a pesquisa. Como tal, se desejar procurar nos alarmes expirados, terá primeiro de exibi-los como foi descrito na seção acima.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Criar e Manipular Alarmes</title>

<sect2>
<title
>Criar um Novo Alarme</title>

<para
>Para criar um novo alarme, faça uma das seguintes ações, selecionando depois o tipo do alarme na lista que aparece. Isto mostra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> através da qual irá configurar o alarme.</para>

<itemizedlist>
<listitem>
<para
>Selecione <menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Novo</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Clique com o botão <mousebutton
>direito</mousebutton
> no ícone da área de notificação e escolha <menuchoice
><guimenuitem
>Novo Alarme</guimenuitem
></menuchoice
> no menu de contexto.</para>
</listitem>

<listitem>
<para
>Clique com o &RMB; na lista de alarmes e escolha <menuchoice
><guimenuitem
>Novo</guimenuitem
></menuchoice
> no menu de contexto.</para>
</listitem>
</itemizedlist>

<para
>Em alternativa, você poderá criar alarmes novos pré-configurados a partir de várias fontes:</para>

<itemizedlist>
<listitem>
<para
>Para basear o seu novo alarme num modelo previamente definido, siga as instruções na seção de <link linkend="templates"
>Modelos de Alarmes</link
>.</para>
</listitem>

<listitem>
<para
>Para basear o seu alarme num existente, escolha o alarme existente e selecione a opção <menuchoice
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Copiar</guimenuitem
></menuchoice
>. Isto abre a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> já preenchida com uma cópia dos detalhes do alarme selecionado.</para>
</listitem>

<listitem>
<para
>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 área de notificação. Então selecione a opção <guilabel
>Exibir alarme</guilabel
>. Isto abre a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> com a mensagem de e-mail completa (com o remetente, o destinatário, &etc;) como texto do alarme.</para>
</listitem>

<listitem>
<para
>Para criar um novo alarme 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 área de notificação. Depois, selecione a opção <guilabel
>Enviar por e-mail o alarme</guilabel
>. Isto abre a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> com a mensagem de e-mail completa (com o remetente, o destinatário, etc.) como texto do alarme.</para>
</listitem>

<listitem>
<para
>Para criar um novo alarme que mostre um resumo de um item por-fazer existente, arraste esse item do &korganizer; ou de outro aplicativo para a janela principal do &kalarm; ou para o seu ícone na área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
>janela para Editar alarme</link
> com o conteúdo do item por-fazer como texto do alarme.</para>
</listitem>

<listitem>
<para
>Para criar um novo comando de alarme, arraste o texto de um script iniciando com <quote
>#!</quote
> na janela principal do &kalarm; ou no área de notificação. Depois selecione a opção <guilabel
>Alarme de comando</guilabel
>. Isto abre a <link linkend="alarm-edit-dlg"
>janela para Editar alarme</link
> pré-configurada com o texto do script.</para>
</listitem>

<listitem>
<para
>Para criar um alarme de visualização de um arquivo, arraste um texto ou o &URL; da imagem para a janela principal do &kalarm; ou para o ícone da área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
>janela para Editar alarme</link
> e configura o nome do arquivo.</para>
</listitem>

<listitem>
<para
>Para criar um alarme de áudio, arraste um &URL; do mesmo para a janela principal do &kalarm; ou para o ícone da área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
>janela para Editar alarme</link
> e configura o nome do arquivo.</para>
</listitem>

<listitem>
<para
>Para criar um alarme de mensagem de texto, arraste qualquer trecho de texto para a janela principal do &kalarm; ou para o ícone da área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
>janela para Editar alarme</link
> pré-configurada com o texto do alarme.</para>
</listitem>

<listitem>
<para
>Você poderá criar automaticamente alarmes para os aniversários das pessoas que estejam no &kaddressbook;, como é descrito em <link linkend="birthdays"
>Importar os Aniversários do &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Modificar um Alarme Existente</title>

<para
>Para modificar um alarme pendente já existente (os alarmes expirados não poderão ser corrigidos), faça uma das seguintes coisas:</para>

<itemizedlist>
<listitem>
<para
>Clique duas vezes no seu item na lista de alarmes.</para>
</listitem>

<listitem>
<para
>Selecione-o, clicando no item respectivo na lista de alarme. Depois selecione a opção <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Editar</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Clique com o &RMB; no seu item da lista de alarmes e escolha a opção <menuchoice
><guimenuitem
>Editar</guimenuitem
></menuchoice
> no menu de contexto.</para>
</listitem>
</itemizedlist>

<para
>Isto mostra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>.</para>

</sect2>

<sect2>
<title
>Apagar/Reativar um alarme</title>

<para
>Para remover um alarme existente, selecione um ou mais clicando em suas entradas na lista de alarmes. Então execute uma das seguintes ações:</para>

<itemizedlist>
<listitem>
<para
>Selecione <menuchoice
><guimenu
>Editar</guimenu
> <guimenuitem
>Apagar</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Clique com o botão <mousebutton
>direito</mousebutton
> nos itens desejados na lista de alarmes e escolha a opção <menuchoice
><guimenuitem
>Apagar</guimenuitem
></menuchoice
> do menu de contexto.</para>
</listitem>
<listitem>
<para
>Para excluí-los sem qualquer mensagem de confirmação, digite &Shift;-<keycap
>Delete</keycap
>.</para>
</listitem>
</itemizedlist>

<para
>Quando você remove um alarme ativo, ele é guardado como um alarme expirado, desde que já tenha sido disparado pelo menos uma vez antes de ser removido, e desde que os alarmes expirados sejam sempre guardados. (Use a <link linkend="preferences-storage"
>janela de Configuração</link
> para controlar se e durante quanto tempo os alarmes expirados serão guardados). Quando remover um alarme expirado ou um alarme ativo que ainda não tenha sido disparado, ele é removido de forma permanente.</para>

<para
>Você poderá reativar um alarme removido na lista de alarmes expirados, desde que ainda não tenha expirado. Para fazer isso, mostre primeiro os alarmes expirados, tal como está descrito em <link linkend="expired"
>Alarmes Arquivados</link
>. Depois:</para>

<itemizedlist>
<listitem>
<para
>Selecione um ou mais alarmes expirados, clicando nos respectivos itens na lista de alarmes. Depois, escolha a opção <menuchoice
> <guimenu
>Ações</guimenu
><guimenuitem
>Reativar</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
>Clique com o botão <mousebutton
>direito</mousebutton
> nos itens desejados na lista de alarmes e escolha a opção <menuchoice
><guimenuitem
>Reativar</guimenuitem
></menuchoice
> do menu de contexto.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Ativar/Desativar um Alarme</title>

<para
>Veja a <link linkend="enable-disable"
>Ativação/Desativação dos Alarmes</link
> para saber como ativar e desativar os alarmes, quer individualmente quer como um todo.</para>

</sect2>

<sect2>
<title
>Configurar um alarme para acordar da suspensão</title>

<para
>Veja em <link linkend="wake-suspend"
>Acordar da suspensão</link
> como configurar um alarme para reativar o seu sistema a partir da suspensão ou hibernação.</para>

</sect2>

<sect2>
<title
>Aceitar um Alarme</title>

<para
>Veja a seção da <link linkend="message-window"
>Janela da Mensagem do Alarme</link
> para ver como aceitar os alarmes.</para>

</sect2>

<sect2 id="templates">
<title
>Modelos de Alarme</title>

<para
>Se você deseja configurar com frequência alarmes semelhantes, você poderá criar um modelo de alarme para evitar ter que introduzir todos os detalhes do zero toda vez. Um modelo poderá conter todos os detalhes que um alarme possa conter, a partir da hora de início.</para>

<para
>Por exemplo, você poderá configurar um alarme para o relembrá-lo 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;), excetuando a data e hora. Depois, para criar o alarme, tudo o que teria de fazer seria clicar neste modelo na <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> e inserir então a data e hora.</para>

<para
>Para criar um alarme com base num modelo, abra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>, pré-definida com os detalhes do modelo:</para>

<itemizedlist>
<listitem>
<para
>Selecione a opção <menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Novo</guimenuitem
> <guimenuitem
>Novo alarme a partir de modelo</guimenuitem
> </menuchoice
>, selecionando depois o modelo desejado.</para>
</listitem>

<listitem>
<para
>Clique com o botão <mousebutton
>direito</mousebutton
> do mouse no ícone da área de notificação e escolha a opção <menuchoice
><guimenuitem
>Novo alarme a partir de modelo</guimenuitem
></menuchoice
> no menu de contexto. Depois, selecione o modelo desejado.</para>
</listitem>

<listitem>
<para
>Abra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> da forma normal e clique no botão <guibutton
>Carregar um Modelo...</guibutton
> para selecionar um modelo a ser usado.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Configurar os Modelos</title>

<para
>Você poderá criar, modificar ou remover modelos com o diálogo de Modelos de Alarmes ou poderá ainda criar um novo modelo de alarme com base num alarme existente.</para>

<para
>Para criar um novo modelo de alarme, execute uma das seguintes operações:</para>

<itemizedlist>
<listitem>
<para
>Exiba a janela de Modelos de Alarmes, selecionando a opção do menu <menuchoice
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Modelos...</guimenuitem
> </menuchoice
> clicando no botão <guibutton
>Novo</guibutton
>, escolhendo depois o tipo de alarme na lista que aparece. Isto irá mostrar uma janela de Edição do Modelo em branco.</para>
</listitem>

<listitem>
<para
>Exiba a janela de Modelos de Alarmes, selecionando a opção do menu <menuchoice
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Modelos...</guimenuitem
> </menuchoice
>, selecione um modelo existente e clique em <guibutton
>Copiar</guibutton
>. Isto abre a janela de Edição do Modelo já preenchida com uma cópia dos detalhes do modelo selecionado.</para>
</listitem>

<listitem>
<para
>Selecione um alarme na lista e escolha a opção <menuchoice
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Criar um Modelo...</guimenuitem
> </menuchoice
>. Isto abre a janela de Edição do Modelo já preenchida com uma cópia dos detalhes do alarme selecionado.</para>
</listitem>
</itemizedlist>

<para
>Para modificar um modelo existente, abra a janela de Modelos de Alarmes, selecionando a opção <menuchoice
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Modelos...</guimenuitem
> </menuchoice
> e clique em <guibutton
>Editar</guibutton
>. Isto irá mostrar a janela de Edição do Modelo, a qual é descrita abaixo.</para>

<para
>Para remover os modelos existentes, exiba o diálogo de Modelos de Alarmes, selecionando a opção <menuchoice
> <guimenu
>Arquivo</guimenu
><guimenuitem
>Modelos...</guimenuitem
> </menuchoice
>, selecione um ou mais modelos e clique em <guibutton
>Remover</guibutton
>. É apresentada uma mensagem de confirmação para evitar remoções acidentais.</para>

</sect3>

<sect3>
<title
>Janela de Edição do Modelo</title>

<para
>A janela de Edição do Modelo é semelhante à <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>. Só os seguintes controles são diferentes:</para>

<itemizedlist>
<listitem>
<para
>Insira o nome do modelo no campo <guilabel
>Nome do modelo</guilabel
>. É o nome do modelo que é apresentado nas listas de seleção de modelos, por isso é melhor escolher um nome que o lembre da sua função. Cada nome de modelo deverá ser único.</para>
</listitem>

<listitem>
<para
>No grupo <guilabel
>Hora</guilabel
>, selecione uma das seguintes opções:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Hora padrão</guilabel
> se não quiser indicar nenhuma hora para ativação. Os alarmes baseados neste modelo irão usar a hora de ativação padrão para os alarmes novos.</para>
</listitem>

<listitem>
<para
>Assinale a <guilabel
>Hora</guilabel
> para indicar a hora em que o alarme será disparado.</para>
</listitem>

<listitem>
<para
>Assinale <guilabel
>Apenas a data</guilabel
> para indicar que o alarme só deverá ter uma data, sem nenhuma hora.</para>
</listitem>

<listitem>
<para
>Assinale o <guilabel
>Tempo a partir de agora</guilabel
> para indicar quanto tempo (em horas e minutos) deve passar, após a criação do alarme, até que o alarme possa ser disparado.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>No grupo da <guilabel
>Regra de Recorrência</guilabel
> da página <guilabel
>Recorrência</guilabel
>, não é necessário escolher nenhum dia ou mês para as recorrências semanais ou anuais, respectivamente.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Calendários de Alarme</title>

<para
>Se você só usar um computador e trabalhar de forma independente, poderá não lhe interessar onde o &kalarm; guarda os seus alarmes. Porém, se você precisar acessar aos alarmes em mais de um computador ou de uma localização no seu computador local, você poderá definir <quote
>calendários de alarmes</quote
> para dizer ao &kalarm; para usar outros calendários adicionais por padrão ou por substituição.</para>

<para
>Você poderá ver e manipular os calendários através da lista de calendários, que poderá ser apresentada ao lado da lista de alarmes, na janela principal do &kalarm;. Os alarmes de todos os calendários aparecem mesclados na lista de alarmes. Quando gravar um alarme novo, você poderá definir uma opção de configuração para determinar se ele será gravado automaticamente no calendário padrão ou se você deve ser questionado para escolher um calendário. Quando editar um alarme existente, ele é salvo novamente no seu calendário de alarmes original.</para>

<screenshot>
<screeninfo
>Captura de tela da janela principal do &kalarm; mostrando a lista de calendários</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>A janela principal mostrando a lista de calendários</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Tipos e Opções do Calendário</title>

<para
>Os recursos dos alarmes são categorizados por tipo de alarme e de armazenamento. Eles poderão ser desativados, colocados apenas para leitura ou colocados como padrão para o seu tipo de alarme.</para>

<variablelist>
<varlistentry>
<term
>Tipo de alarme</term>
<listitem>
<para
>Os três tipos de entidades de alarmes &ndash; alarmes ativos, alarmes arquivados ou expirados e modelos de alarmes &ndash; são gravados em calendários de alarmes separados. Assim, o &kalarm; possui três calendários padrão, um para cada tipo (veja as <link linkend="faq"
>Perguntas e Respostas</link
> para mais detalhes), os quais você poderá alterar se desejar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Tipo de armazenamento</term>
<listitem>
<para
>O &kalarm; lida com três tipos de armazenamento dos calendários de alarmes:</para>

<itemizedlist>
<listitem
><para
>Arquivo local: Os alarmes são guardados num único arquivo local, no formato iCalendar. O &kalarm; usa os calendários de arquivos locais por padrão (veja as <link linkend="faq"
>Perguntas e Respostas</link
> para mais detalhes). Os <quote
>arquivos locais</quote
>, além dos arquivos no computador local, poderão incluir os calendários na rede local, desde que a sua localização possa ser representada por um caminho que comece por <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Pasta local: Os alarmes são gravados numa pasta local, sendo cada um dos alarmes gravado num arquivo iCalendar separado, dentro da pasta. Este método de armazenamento tem a vantagem de, no caso de corrupção do arquivo, você só irá perder um alarme, em vez de perder todo o calendário.</para>
</listitem>

<listitem
><para
>Arquivo remoto: Os alarmes são gravados num único arquivo remoto, no formato iCalendar. Este método de armazenamento permite-lhe acessar aos seus dados de alarmes de forma remota, independentemente do local onde esteja ou então ativa os calendários dos alarmes, de modo a serem vistos por outras pessoas. Ao usar os arquivos remotos, o &kalarm; funciona com uma 'cache' local dos dados.</para>

<warning
><para
>Se um determinado calendário de alarmes remoto estiver compartilhado entre os usuários, as alterações feitas por uma pessoa poderão não ser disponibilizadas automaticamente para outro usuário, ou então poderá ocorrer um atraso de tempo antes do outro usuário vê-las. Assim, um usuário poderá fazer uma alteração que será substituída por outro usuário, sem as outras pessoas notarem as alterações. A razão técnica para isto acontecer é que uma alteração feita pela pessoa A só ficará disponível para a pessoa B, após a cópia em 'cache' do A ter sido gravada para o arquivo remota, até que a cópia local da pessoa B seja atualizada. Se e quando o calendário é gravado, depende dos parâmetros de configuração do calendário que cada usuário terá definido para esse calendário de alarmes.</para>

<para
>As formas de evitar este problema incluem o ajuste dos parâmetros de configuração da gravação e atualização do calendário, bem como a adoção de uma política em que os usuários, com exceção do dono do calendário, possam abrir os dados apenas para leitura.</para
></warning>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estado de ativado/desativado</term>
<listitem>
<para
>A desativação de um calendário tem o mesmo efeito que a sua remoção, com a diferença que ele ainda aparece na lista de calendários, para uma simples reativação. Quando estiver desativado, os seus alarmes são ignorados e não aparecem na lista de alarmes ou na lista de modelos. Quando estiver reativado, os seus alarmes voltam a aparecer e, se for um calendário de alarmes ativo, os mesmos serão ativados.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estado apenas para leitura</term>
<listitem>
<para
>Os alarmes de um calendário apenas para leitura não poderão ser modificados ou adicionados. Assim, você não poderá editar os seus alarmes ou salvar alarmes novos nele. Do mesmo modo, não é possível adiar os seus alarmes uma vez que, ao fazê-lo, a hora do adiamento teria de ser gravada no alarme. Depois dos seus alarmes terem sido disparados, eles não são removidos do calendários e arquivados, somente quando você ou outro usuário tiver acessado ao calendário no modo de leitura/escrita.</para>

<para
>Você poderá configurar o estado de 'apenas para leitura' de um calendário na janela de configuração do mesmo. Contudo, alguns calendários não poderão ser modificados, por várias razões:</para>

<itemizedlist>
<listitem
><para
>Se um calendário tiver sido criado por outro aplicativo, seria inseguro permitir ao &kalarm; atualizá-lo, uma vez que as diferenças no formato de dados poderiam inutilizá-lo para o aplicativo que o criou.</para>
</listitem>

<listitem
><para
>Se o calendário tiver sido criado por uma versão posterior do &kalarm;, os dados poderão se perder, se a sua versão do &kalarm; atualizá-los.</para>
</listitem>

<listitem
><para
>Se o calendário tiver sido criado por uma versão anterior do &kalarm;, os dados poderão se perder ou corromper pela versão anterior do &kalarm;, se a sua versão do &kalarm; atualizá-lo. Você será questionado se deseja converter o formato, para poder salvá-lo, tendo em mente os problemas potenciais de compatibilidade, se a versão anterior do &kalarm; necessitar acessá-los de novo.</para>
</listitem>

<listitem
><para
>Se você não tiver permissões para escrever no arquivo ou pasta do calendário.</para>
</listitem>
</itemizedlist>

<para
>Se você precisar de acesso de escrita para os alarmes num calendário que não possa atribuir essas permissões, você poderá copiar os seus alarmes, importando-os para um calendário com permissões de escrita, usando a opção do menu de contexto <menuchoice
><guimenuitem
>Importar...</guimenuitem
></menuchoice
> do último calendário (veja em <link linkend="import"
>Importar os Alarmes dos Calendários Externos</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estado padrão do calendário</term>
<listitem>
<para
>O usuário poderá, opcionalmente, pré-definir um calendário para cada tipo de alarme. Os alarmes novos são salvos automaticamente no calendário padrão, para o tipo de alarme apropriado, a menos que você tenha selecionado a opção de perguntar para os alarmes e modelos na <link linkend="preferences-storage"
>janela de Configuração</link
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="using-calendars">
<title
>Usar os Calendários</title>

<para
>Você poderá ver e manipular os calendários na lista de calendários, que poderá aparecer ou ser oculta com a opção <menuchoice
> <guimenu
>Ver</guimenu
><guimenuitem
>Mostrar os Calendários</guimenuitem
> </menuchoice
>. Quando usar a lista de calendários, selecione primeiro o tipo de alarme com a lista que está por cima desta. Depois, clique num dos botões abaixo da lista ou clique com o botão <mousebutton
>direito</mousebutton
> no calendário apropriado da lista, escolhendo em seguida um item do menu de contexto. As ações disponíveis são:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Adicionar...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Adiciona um calendário do tipo selecionado à lista. Será pedido para selecionar um tipo para o armazenamento, seguindo-se assim a janela de configuração do calendário, onde você poderá indicar a localização do calendário, bem como as suas características. Se não existir nenhum calendário de alarmes no local indicado, será criado um novo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Remover</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Remove o calendário selecionado da lista. O calendário em si é deixado intacto; simplesmente desaparece da lista, podendo ser instanciado novamente na lista, se desejar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Editar...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Edita o calendário selecionado. Isto mostra a janela de configuração do calendário selecionado.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Recarregar</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Recarrega o calendário selecionado. O calendário é lido novamente do seu local de armazenamento, garantindo que não existe nenhuma discrepância entre o que o &kalarm; mostra e o estado atual do calendário. Se o calendário for compartilhado com outros usuários, as alterações que eles façam serão vistas em seguida pelo &kalarm;.</para>

<warning
><para
>Se você recarregar um calendário remoto, as alterações que faça desde a última gravação serão perdidas. Do mesmo modo, os alarmes que tiverem expirado desde a última gravação poderão ser disparados novamente.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Salvar</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Salva as alterações no calendário selecionado. O calendário é atualizado com as alterações de alarmes que tiverem ocorrido desde a última vez que o calendário foi gravado ou atualizado. Isto só é útil para os calendários remotos, uma vez que os calendários locais são salvos automaticamente, após cada uma das alterações. Você poderá configurar quando e como deseja salvar automaticamente um calendário remoto, usando a sua janela de configuração (com a opção do menu de contexto <menuchoice
><guimenuitem
>Editar...</guimenuitem
></menuchoice
>).</para>

<warning
><para
>Se você salvar um calendário remoto que seja compartilhado com outros usuários, todas as alterações que eles tenham feito, desde a última vez que você carregou o calendário (automaticamente ou manualmente), serão perdidas.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importar...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importa os alarmes de um arquivo de calendário externo para o calendário selecionado. Isto está descrito na seção <link linkend="import"
>Importar os Alarmes de Calendários Externos</link
>. Esta opção não está disponível para os calendários desativados ou apenas para leitura.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Exportar...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Exporta todos os alarmes do calendário selecionado para um arquivo de calendário externo. Isto está descrito na seção <link linkend="export"
>Exportar os Alarmes para Calendários Externos</link
>. Esta opção não está disponível para os calendários desativados.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Mostrar detalhes</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Mostra os detalhes sobre o calendário selecionado. Isto mostra a localização do calendário, bem como o tipo de armazenamento e a informação do estado. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Usar como Padrão</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Torna padrão o calendário selecionado para o tipo de calendário selecionado. Esta opção não está disponível para os calendários desativados ou apenas para leitura.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Definir cor...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Selecione uma cor de fundo para realçar os alarmes deste calendário na lista de alarmes. Isto permite-lhe ver imediatamente os alarmes que pertencem a um determinado calendário.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Limpar cor</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Limpa o realce de cores para os alarmes deste calendário na lista de alarmes.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Importar Alarmes de Calendários Externos</title>

<para
>Você poderá importar os alarmes a partir de outros arquivos de calendários para o &kalarm;. A função de importação verifica o arquivo de calendário selecionado, à 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. Existem duas formas de importar os alarmes:</para>

<itemizedlist>
<listitem>
<para
>Selecione a opção <menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Importar Alarmes...</guimenuitem
></menuchoice
> para importar os alarmes de vários tipos (alarmes ativos, arquivados e modelos de alarmes) do calendário.</para>

<para
>Se você tiver configurado os <link linkend="calendars"
>calendários de alarmes</link
>, os alarmes de cada serão adicionados ao calendário padrão apropriado, ou será questionado pelo calendário, se você tiver selecionado a opção de pergunta nos alarmes e modelos novos, na <link linkend="preferences-storage"
>janela de Configuração</link
>.</para>
</listitem>

<listitem>
<para
>Clique com o botão <mousebutton
>direito</mousebutton
> num calendário da lista e escolha a opção <menuchoice
><guimenuitem
>Importar...</guimenuitem
></menuchoice
> do menu de contexto. Isto importa os alarmes do tipo atualmente selecionado para esse calendário. Por exemplo, se o tipo de calendário selecionado for os modelos de alarmes, serão importados os modelos de alarmes (e não os alarmes ativos ou arquivados).</para>
</listitem>
</itemizedlist>

<warning
><para
>Se você importar os alarmes a partir de arquivos de calendários criados por aplicativos que não o &kalarm;, eles poderão ser alterados pelo processo de importação &ndash; as horas dos alarmes poderão inclusive mudar. Isto depende das convenções de armazenamento de dados usadas pelo outro aplicativo, e é inevitável desconhecer as diferenças dessas convenções face ao que o &kalarm; espera. Verifique sempre os alarmes importados, à espera de alterações inesperadas, e ajuste-os se necessário.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Exportar Alarmes para Calendários Externos</title>

<para
>Você poderá exportar os alarmes do &kalarm; para outros arquivos de calendário, usando os alarmes atualmente selecionados na lista de alarmes ou todos os alarmes de um determinado calendário. Os métodos para fazer isso são indicados abaixo. Seja qual for o método, você tanto poderá criar um arquivo de calendário novo como adicionar os alarmes exportados a um arquivo existente. Para adicionar os alarmes, assinale a opção <guilabel
>Adicionar a um arquivo existente</guilabel
> na janela de seleção dos arquivos; caso contrário, todos os arquivos existentes serão substituídos.</para>

<itemizedlist>
<listitem>
<para
>Para exportar os alarmes atualmente selecionados na lista, clique com o botão <mousebutton
>direito</mousebutton
> na seleção e escolha <menuchoice
><guimenuitem
>Exportar...</guimenuitem
></menuchoice
> no menu de contexto, ou use então a opção <menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Exportar os Alarmes Selecionados...</guimenuitem
></menuchoice
> no menu principal.</para>
</listitem>

<listitem>
<para
>Para exportar todos os alarmes de um calendário, clique com o botão <mousebutton
>direito</mousebutton
> num calendário da lista, e escolha <menuchoice
><guimenuitem
>Exportar...</guimenuitem
></menuchoice
> no menu de contexto.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Importar Aniversários do &kaddressbook;</title>

<para
>Você poderá configurar os alarmes para os aniversários que estão registrados no &kaddressbook;, através da opção <menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Importar Aniversários...</guimenuitem
></menuchoice
>. Isto exibe um diálogo que lhe permitirá escolher os aniversários para os quais deseja criar alarmes.</para>

<itemizedlist>
<listitem>
<para
>No grupo <guilabel
>Texto do Alarme</guilabel
>, você 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 <guilabel
>Prefixo</guilabel
> seguido do nome da pessoa e do texto do <guilabel
>Sufixo</guilabel
>. Não é adicionado nenhum espaço, por isso lembre-se de incluir os espaços necessários no <guilabel
>Prefixo</guilabel
> e no <guilabel
>Sufixo</guilabel
>.</para>

<note
><para
>Se você alterar o texto do alarme, a lista de seleção dos aniversários será avaliada novamente.</para
></note>
</listitem>

<listitem>
<para
>Na lista <guilabel
>Selecionar Aniversários</guilabel
>, selecione 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 atualmente no grupo do <guilabel
>Texto do Alarme</guilabel
>.</para>
</listitem>

<listitem>
<para
>Os controles restantes são os mesmos dos exibidos para os alarmes de <guilabel
>Texto</guilabel
> na <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>.</para>
</listitem>
</itemizedlist>

<para
>Se você tiver configurado os <link linkend="calendars"
>calendários de alarmes</link
>, os alarmes serão adicionados ao calendário padrão apropriado, ou você será questionado pelo calendário, se tiver selecionado a opção de pergunta nos alarmes e modelos novos, na <link linkend="preferences-storage"
>janela de Configuração</link
>.</para>

</sect2>

<sect2 id="undo">
<title
>Desfazer / Refazer</title>

<para
>Você poderá desfazer e refazer as alterações mais recentes que tenha feito durante a sessão atual do &kalarm;. A maioria das ações poderá ser anulada, incluindo a criação, edição e remoção dos alarmes e modelos de alarmes, assim como a reativaçã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>

<para
>Para anular a última modificação, selecione a opção <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Desfazer</guimenuitem
></menuchoice
>. Para repetir a última alteração que foi anulada, selecione a opção <menuchoice
> <guimenu
>Editar</guimenu
><guimenuitem
>Refazer</guimenuitem
> </menuchoice
>.</para>

<para
>Para anular uma modificação que não a última, clique no botão <guibutton
>Desfazer</guibutton
> na barra de ferramentas e mantenha o botão pressionado. Irá aparecer uma lista das ações, na qual poderá escolher a que deseja anular. Se você não ver a ação que está procurando, lembre-se que poderá necessitar desfazer as alterações mais recentes em primeiro lugar, das quais a modificação desejada depende. Por exemplo, se você tiver editado um alarme e depois removido o mesmo, você não poderá anular a edição até que anule, em primeiro lugar, a remoção.</para>

<para
>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 <guibutton
>Refazer</guibutton
>.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>A janela de Edição do Alarme</title>

<para
>A janela de Edição do Alarme permite-lhe ver e editar um alarme. Quando usar pela primeira vez o &kalarm;, é apresentada uma versão simplificada da janela, com apenas um reduzido número de opções visíveis. Para ver todas as opções, clique no botão <guibutton
>Mais Opções</guibutton
>; para reverter para a janela simplificada, clique no botão <guibutton
>Menos Opções</guibutton
>. O &kalarm; recorda sempre a sua última escolha apresentada, sempre que a janela de Edição do Alarme voltar a ser apresentada.</para>

<para
>Você pode configurar os valores padrão de muitas das configurações na janela de edição de alarme usando a <link linkend="preferences-edit"
>página de Editar da janela de configuração</link
>.</para>

<screenshot>
<screeninfo
>Imagem da janela simplificada de Edição do Alarme</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>A janela simplificada de Edição do Alarme para um alarme visível</phrase>
</textobject>
<caption
><para
>A janela simplificada de Edição do Alarme para um alarme visível</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Imagem da janela de Edição do Alarme com todas as opções</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>A janela de Edição de Alarmes para um alarme visível com todas as opções</phrase>
</textobject>
<caption
><para
>A janela de Edição de Alarmes para um alarme visível com todas as opções</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Ação do Alarme</title>

<para
>Os controles no grupo <guilabel
>Ação</guilabel
> poderão variar de acordo com o tipo de alarme a ser editado.</para>

<sect3>
<title
>Alarmes Visíveis</title>

<para
>Os alarmes visíveis mostram uma janela quando o alarme dispara. Selecione o método usado para gerar o conteúdo da janela de alarme, usando a lista no topo:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Texto</guilabel
> para inserir o texto da mensagem de alarme (o qual poderá conter várias linhas) no campo de texto.</para>
</listitem>

<listitem>
<para
><guilabel
>Conteúdo do arquivo</guilabel
> para inserir o nome ou o &URL; de um arquivo 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 seleção de arquivos. A opção <guilabel
>Falar</guilabel
> não está disponível para este tipo de alarme.</para>
</listitem>

<listitem>
<para
><guilabel
>Resultado do comando</guilabel
> para especificar que o texto da mensagem de alarme será gerado por um comando que é executado quando o alarme disparar. Veja abaixo em <link linkend="command-alarm"
>Alarmes por Comando</link
> para saber mais detalhes sobre como inserir o comando ou o programa a executar.</para>
</listitem>
</itemizedlist>

<para
>Os controles disponíveis para os alarmes visíveis são:</para>

<itemizedlist>
<listitem>
<para
>A opção <guilabel
>Som</guilabel
> permite-lhe selecionar se deseja disparar um alarme sonoro quando a mensagem de alarme for apresentada. Escolha:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Nenhum</guilabel
> para mostrar o alarme silenciosamente.</para>
</listitem>

<listitem>
<para
><guilabel
>Apitar</guilabel
> para soar uma campainha.</para>
</listitem>

<listitem>
<para
><guilabel
>Falar</guilabel
> para que a mensagem de alarme seja sintetizada, assim como é apresentada. Esta opção só estará disponível se você tiver o &jovie; (do pacote 'kdeaccessibility') instalado e configurado, em conjunto com um sintetizador de fala compatível, &eg; o <application
>Festival</application
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Arquivo de som</guilabel
> para tocar um arquivo de áudio. Use o botão à direita para mostrar a janela do Arquivo de Som, que lhe permite selecionar o arquivo a reproduzir e definir as opções do volume e de repetição. Se passar o mouse por cima do botão, irá aparecer uma dica que lhe indica o arquivo de áudio atualmente selecionado.</para>

<para
>Na janela do Arquivo de Som:</para>

<itemizedlist>
<listitem>
<para
>Insira a localização do arquivo de som, ou então use o botão ao lado do campo de edição para mostrar uma janela de seleção de arquivos. Você poderá ouvir o arquivo selecionado clicando no botão de reprodução à esquerda do campo de edição. Esse botão irá então mudar de função para lhe permitir parar a reprodução quando já tiver ouvido o suficiente.</para>
</listitem>

<listitem>
<para
>Assinale o <guilabel
>Repetir</guilabel
> 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.)</para>
</listitem>

<listitem>
<para
>Assinale o <guilabel
>Volume</guilabel
> e ajuste a barra deslizante se quiser ajustar o volume com que o arquivo de áudio é tocado.</para>
</listitem>

<listitem>
<para
>Se desejar, você poderá desvanescer o volume. Isto significa que o arquivo 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á inserido no <guilabel
>Volume</guilabel
> acima. Para ativar a variação gradual, assinale a opção <guilabel
>Desvanescer</guilabel
> e escolha o período no qual isso acontece no campo <guilabel
>Tempo de desvanecimento</guilabel
> e ajuste a barra do <guilabel
>Volume inicial</guilabel
>.</para>
</listitem>
</itemizedlist>

<tip
><para
>Você poderá usar o botão <guibutton
>Testar</guibutton
> para testar os níveis de som selecionados.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Use o botão do <guibutton
>Fonte &amp; Cor...</guibutton
> para selecionar um tipo de fonte ou uma cor de texto ou de fundo para a mensagem de alarme. Na janela para <guilabel
>Escolher o Tipo de Fonte e Cor do Alarme</guilabel
>, assinale a opção <guilabel
>Usar a fonte padrão</guilabel
> para mostrar a mensagem com o tipo de letra que estiver configurado por padrão no momento em que a mensagem for apresentada. (A fonte padrão pode ser configurada na <link linkend="preferences-edit"
>janela de Configuração</link
>.) Para selecionar um tipo de fonte específico para a mensagem, desligue a opção <guilabel
>Usar a fonte padrão</guilabel
>.</para>

<para
>As cores selecionadas são apresentadas no campo de texto da mensagem de alarme.</para>
</listitem>

<listitem>
<para
>Use o botão <guibutton
>Ações Especiais...</guibutton
> para especificar os comandos a executar antes ou depois da apresentação do alarme. No diálogo das <guilabel
>Ações Especiais de Alarme</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>No campo de <guilabel
>Ação pré-alarme</guilabel
>, insira um comando a executar antes de mostrar o alarme. Lembre-se que o &kalarm; espera que o comando termine antes de mostrar o alarme.</para>

<para
>Uma ação pré-alarme só é executada uma vez quando a mensagem de alarme é apresentada inicialmente, incluindo quando uma mensagem de chamada de atenção é substituída pela mensagem de alarme verdadeira. <emphasis
>Não</emphasis
> é executada em nenhuma das seguintes circunstâncias:</para>

<itemizedlist>
<listitem
><para
>Quando é apresentada um lembrete.</para
></listitem>
<listitem
><para
>Quando a mensagem volta a ser apresentada após adiar o alarme, a menos que <guilabel
>Executar para alarmes adiados</guilabel
> esteja selecionado.</para
></listitem>
<listitem
><para
>Quando a mensagem foi apresentada na hora em que você se deslogou e é restaurada quando você se logar.</para
></listitem>
<listitem
><para
>Quando um alarme recorrente é disparado, mas a mensagem de alarme (ou a mensagem de um alarme adiado) de uma ocorrência anterior do alarme ainda estiver visível; em outras palavras, quando a ocorrência anterior do alarme ainda não tiver sido confirmada.</para
></listitem>
</itemizedlist>

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

<itemizedlist>
<listitem
><para
>Assinale a opção <guilabel
>Cancelar o alarme em caso de erro</guilabel
> para cancelar o alarme, caso o comando de pré-alarme devolva um estado de erro. Isto irá evitar que a mensagem de erro seja apresentada, bem como que qualquer ação pós-alarme seja executada.</para
></listitem>

<listitem
><para
>Normalmente, se o comando pré-alarme devolver um erro, aparece uma mensagem de alarme e aparece uma indicação do erro na lista de alarmes. Estas notificações de erros poderão ser evitadas se assinalar a opção <guilabel
>Não notificar os erros</guilabel
>.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>No campo da <guilabel
>Ação pós-alarme</guilabel
>, insira um comando de console a ser executado sempre que o alarme for aceito (quer ao clicar em <guibutton
>Fechar</guibutton
> quer usando o botão para fechar na barra de título da janela). <emphasis
>Não</emphasis
> é executada em nenhuma das seguintes circunstâncias:</para>

<itemizedlist>
<listitem
><para
>Quando um lembrete é fechado.</para
></listitem>
<listitem
><para
>Quando você adiar o alarme, exceto quando o alarme adiado for finalmente aceito.</para
></listitem>
<listitem
><para
>Quando a mensagem de alarme for fechada por ter saído da sessão.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Veja a descrição dos <link linkend="command-alarm"
>Alarmes de comando</link
> abaixo para saber os detalhes com que os comandos são executados.</para>

</listitem>
</itemizedlist>
</sect3>

<sect3 id="command-alarm">
<title
>Alarmes de comando</title>

<para
>Os alarmes por comandos executam um comando sem mostrar qualquer mensagem de alarme.</para>

<note
><para
>Este tipo de alarme não está disponível se o &kde; estiver rodando em modo quiosque.</para
></note>

<para
>Quando o comando é executado, a variável de ambiente <envar
>KALARM_UID</envar
> contém o UID do evento para o alarme. Lembre-se que, quando o comando é executado com o botão <guibutton
>Tentar</guibutton
> da janela de edição do alarme, o <envar
>KALARM_UID</envar
> estará em branco se for um alarme novo, ou se o alarme tiver sido modificado na janela, uma vez que o alarme só adquire um UID quando for gravado no calendário do alarme.</para>

<para
>Os controles disponíveis para os alarmes de comando são:</para>

<itemizedlist>
<listitem>
<para
>A opção <guilabel
>Inserir um programa</guilabel
> permite-lhe escolher se deseja inserir um comando de console ou um programa.</para>

<para
>Se esta opção estiver desligada, você poderá inserir uma instrução da linha de comando de modo a executá-la. O comando é passado para a linha de comando padrão (definida pela variável de ambiente <envar
>SHELL</envar
>) e pode incluir quaisquer opções, parâmetros, comandos via 'pipes', &etc;, sendo tudo permitido numa única linha de comando.</para>

<para
>Se esta opção for assinalada, você poderá introduzir o texto de um programa a executar. Lembre-se de incluir uma primeira linha do tipo <literal
>#!/bin/bash</literal
> para garantir que o interpretador de comandos correto é invocado.</para>
</listitem>

<listitem>
<para
>Use o grupo do <guilabel
>Resultado do Comando</guilabel
> para indicar o que deseja fazer com o resultado para o terminal que o comando produza enquanto for executado.</para>

<itemizedlist>
<listitem>
<para
>Assinale a opção <guilabel
>Executar numa janela de terminal</guilabel
> para fazer com que o comando seja executado numa janela de terminal. Você poderá escolher o tipo de janela de terminal que será usada na <link linkend="preferences-general"
>janela de Configuração</link
>.</para>
</listitem>

<listitem>
<para
>Assinale a opção <guilabel
>Registrar num arquivo</guilabel
> para gravar o resultado do comando num arquivo. O resultado, antecedido de um cabeçalho que mostra a hora em que o comando foi agendado para rodar, será adicionada ao conteúdo existente no arquivo. Indique o nome do arquivo no campo de texto ou use o botão ao lado do campo de texto para mostrar uma janela de seleção de arquivos.</para>
</listitem>

<listitem>
<para
>Assinale a opção <guilabel
>Esquecer</guilabel
> para ignorar o resultado do comando.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>Alarmes por E-Mail</title>

<para
>Os alarmes por e-mail enviam um e-mail sem mostrar qualquer mensagem de alarme.</para>

<para
>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á selecionar os destinatários da mensagem. Os anexos poderão ser adicionados com o botão <guibutton
>Adicionar...</guibutton
>. Lembre-se que os arquivos anexados precisam existir quando o alarme for disparado; não é gravada nenhuma cópia no momento em que o alarme é configurado. Para remover um anexo, selecione-o na lista e clique no botão <guibutton
>Remover</guibutton
>.</para>

<para
>Configure as seguintes opções:</para>

<itemizedlist>
<listitem>
<para
>A lista <guilabel
>De</guilabel
> permite-lhe selecionar 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 <guilabel
>De</guilabel
> na <link linkend="preferences-email"
>janela de Configuração</link
> estiver configurado para <guilabel
>Usar as identidades do &kmail;</guilabel
>. Caso contrário, o seu endereço de e-mail estará pré-definido na <link linkend="preferences-email"
>janela de Configuração</link
>, tornando esta opção inútil.</para>
</listitem>

<listitem>
<para
>Assinale a opção <guilabel
>Copiar o e-mail para o próprio</guilabel
> para enviar uma cópia implícita da mensagem para si próprio quando o alarme for disparado. O endereço de e-mail para o qual será enviada a cópia pode ser definido na <link linkend="preferences-email"
>janela de Configuração</link
>, sendo o valor padrão o seu endereço de e-mail, tal como está definido na Configuração do Sistema do &kde;.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Alarmes de Áudio</title>

<para
>Os alarmes de áudio tocam um arquivo de áudio sem mostrar qualquer mensagem de alarme.</para>

<para
>Configure as seguintes opções:</para>

<itemizedlist>
<listitem>
<para
>Indique a localização do arquivo de som, ou então use o botão ao lado do campo de texto, de modo a mostrar uma janela de seleção de arquivos.</para>
</listitem>

<listitem>
<para
>Assinale a opção <guilabel
>Repetir</guilabel
> para repetir de forma contínua o arquivo de áudio, até que a opção <guilabel
>Parar a Reprodução</guilabel
> seja selecionada. Para parar a reprodução do arquivo, selecione a opção do menu <menuchoice
><guimenu
>Ações</guimenu
> <guimenuitem
>Parar a Reprodução</guimenuitem
></menuchoice
> ou clique com o botão <mousebutton
>direito</mousebutton
> do mouse no ícone da área de notificação e selecione a opção <menuchoice
><guimenuitem
>Parar a Reprodução</guimenuitem
></menuchoice
> no menu de contexto. Se o desejar, você poderá definir uma tecla de atalho para esta ação.</para>
</listitem>

<listitem>
<para
>Assinale o <guilabel
>Volume</guilabel
> e ajuste a barra deslizante se quiser ajustar o volume com que o arquivo de áudio é tocado.</para>
</listitem>

<listitem>
<para
>Se desejar, você poderá desvanescer o volume. Isto significa que o arquivo 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á inserido no <guilabel
>Volume</guilabel
> acima. Para ativar a variação gradual, assinale a opção <guilabel
>Desvanescer</guilabel
> e escolha o período no qual isso acontece no campo <guilabel
>Tempo de desvanecimento</guilabel
> e ajuste a barra do <guilabel
>Volume inicial</guilabel
>.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Adiamento</title>

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

</sect2>

<sect2>
<title
>Hora</title>

<para
>No grupo da <guilabel
>Hora</guilabel
>, selecione</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Na data/hora</guilabel
> se quiser inserir a data e hora em que o alarme será disparado. Assinale a opção <guilabel
>A qualquer hora</guilabel
> para indicar apenas a data em que o alarme deverá ser disparado: nesse caso, o alarme será apresentado na primeira oportunidade ou após a hora configurada para o início do dia, para a data indicada. (O <link linkend="preferences-general"
>Configurar o &kalarm;</link
> descreve como configurar a hora do início do dia.)</para>

<para
>Para um alarme não-repetitivo, a data/hora indicada aqui indicar deverá ocorrer no futuro ou, se você só indicar uma data, terá de ser hoje ou depois. Para um alarme repetitivo, não existem estas restrições uma vez que a data/hora de início será ajustada automaticamente para a primeira repetição que aconteça após a hora atual.</para>
</listitem>

<listitem>
<para
><guilabel
>Tempo a partir de agora</guilabel
> para indicar quanto tempo ficará à espera (em horas e minutos) até que o alarme seja disparado.</para>
</listitem>
</itemizedlist>

<para
>Se desejar, selecione o fuso horário a aplicar no alarme. Este fuso horário é usado por todas as datas e horas relacionadas com este alarme, incluindo as datas e horas de repetição e de exceção. Normalmente, você deverá deixar os controles de fuso horário sem alteração, a menos que tenha uma boa razão para alterá-los.</para>

<para
>Os controles do fuso horário só são apresentados quando o fuso horário selecionado é diferente do pré-definido na <link linkend="preferences-time"
>janela de Configuração</link
> ou se clicar no botão <guibutton
>Fuso horário...</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>Na lista, selecione o fuso horário que este alarme irá usar. Ao criar um alarme novo, isto é configurado inicialmente com o fuso horário selecionado na <link linkend="preferences-general"
>janela de Configuração</link
>, o qual será o seu fuso horário, a menos que o tenha alterado.</para>
</listitem>

<listitem>
<para
>Assinale a opção <guilabel
>Ignorar o fuso horário</guilabel
> se quiser usar a hora do computador do local (no computador em que o &kalarm; esteja rodando), ignorando os fusos horários.</para>

<warning
><para
>Recomenda-se que não use esta opção se o alarme tiver uma repetição definida em horas e minutos; se o fizer, o alarme poderá ocorrer em horas inesperadas, depois das mudanças de horário de verão.</para
></warning>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Lembrete</title>

<para
>Para um alarme visível, assinale a <guilabel
>Lembrete</guilabel
> se quiser mostrar um lembrete antes ou depois do alarme principal e de cada uma das suas repetições (se existirem). Insira com que antecedência ou posteridade deseja, usando os controles de edição abaixo da opção propriamente dita. Lembre-se de que, se o alarme se repetir, o período do lembrete está normalmente limitado a menos que o período de repetição ou sub-repetição.</para>

<note
><para
>Os lembretes não são apresentados para as sub-repetições dentro de uma recorrência. Os lembretes só aparecem para cada recorrência principal do alarme.</para
></note>

<para
>Se o alarme se repetir, assinale a opção <guilabel
>Lembrete apenas para a primeira recorrência</guilabel
> se desejar apenas um lembrete antes da primeira repetição do alarme. Se estiver assinalada, e se for um lembrete de antecipação, o período do lembrete não estará limitado a ser menor que o intervalo de repetição ou sub-repetição.</para>


</sect2>

<sect2>
<title
>Cancelamento</title>

<para
>As opções de cancelamento posterior determinam como um alarme é tratado após a sua hora agendada:</para>

<itemizedlist>
<listitem>
<para
>A opção <guilabel
>Cancelar se atrasado</guilabel
> indica o que acontece se o alarme não puder ser disparado à hora agendada.</para>

<para
>Assinale esta opção para cancelar o alarme, se não puder ser disparado dentro de um determinado período de tempo após a hora exata. O período de tempo é selecionado com as opções que aparecem, logo que você assinala a opção. Por exemplo, se indicar um período de 1 hora, o alarme será disparado à primeira oportunidade até uma hora após a hora exata mas, se não conseguir fazê-lo nesse período, será cancelado.</para>

<note
><para
>O atraso nos alarmes apenas de datas, &ie; aqueles para os quais a opção <guilabel
>A qualquer hora</guilabel
> estiver selecionada, é calculado a partir da hora do início do dia da data agendada para o alarme.</para
></note>

<para
>Deixe a opção desligada para disparar o alarme na primeira oportunidade, com início na hora agendada, independentemente de quão atrasada estiver.</para>

<note
><para
>Um alarme só poderá ser disparado enquanto você estiver logado e tanto o X como o &kalarm; estiverem em execução.</para
></note>
</listitem>

<listitem>
<para
>Assinale a opção <guilabel
>Fechar automaticamente a janela após este período</guilabel
> se quiser que a janela do alarme seja fechada automaticamente, se ainda estiver aberta quando passar o tempo até ao cancelamento posterior do alarme.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Recorrência</title>

<para
>Indique quando e como o alarme deverá ser repetido com a página de <guilabel
>Recorrência</guilabel
>.</para>

<note
><para
>A característica básica de repetição do alarme é mostrada por conveniência na página de <guilabel
>Recorrência</guilabel
>. O intervalo de repetição, tal como está configurado na página de <guilabel
>Recorrência</guilabel
>, é mostrado em primeiro lugar, seguido do intervalo de todas as sub-repetições, configurado com o botão de <guibutton
>Sub-repetição</guibutton
>.</para
></note>

<para
>No grupo da <guilabel
>Regra de Recorrência</guilabel
>, indique o tipo de recorrência ou o período de tempo da seguinte forma:</para>

<itemizedlist>
<listitem
><para
>Para disparar o alarme somente uma vez, selecione <guilabel
>Sem recorrência</guilabel
>.</para
></listitem>

<listitem
><para
>Selecione <guilabel
>No login</guilabel
> para disparar o alarme sempre que você se logue, até à sua hora final agendada. Depois, na sua hora final, será disparado uma última vez. (Lembre-se que um alarme repetido no login será também disparado cada vez que você ativar o alarme ou reiniciar o &kalarm;.)</para
></listitem>

<listitem>
<para
>Para que o alarme se repita em intervalos regulares, selecione um dos tipos de períodos e insira depois no campo <guilabel
>Recorrência a cada</guilabel
> quantos períodos de tempo deverão passar entre cada repetição. Por exemplo, para repetir em cada quinzena, você poderá selecionar <guilabel
>Diariamente</guilabel
> e indicar um valor igual a 14 ou selecione <guilabel
>Semanalmente</guilabel
> e introduza um valor igual a 2. Dependendo do tipo de período de tempo selecionado, você poderá ter outras opções:</para>

<itemizedlist>
<listitem>
<para
>Para uma recorrência semanal, assinale cada dia da semana em que deseja ativar o alarme.</para>
</listitem>

<listitem>
<para
>Para uma recorrência mensal, você poderá tanto indicar uma data fixa como uma posição (&eg; a segunda terça-feira).</para>
</listitem>

<listitem>
<para
>Para uma recorrência anual, tanto poderá escolher um dia fixo do mês ou uma posição dentro de um mês (&eg; o último Sábado de Maio). Assinale cada mês do ano em que deseja ativar o alarme.</para>

<para
>Se você tiver configurado repetições anuais para o 29 de Fevereiro, indique como elas serão tratadas nos anos não-bissextos, selecionando a opção apropriada em <guilabel
>Alarme do 29 de Fevereiro nos anos não-bissextos</guilabel
>:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Nada</guilabel
>: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos, mas será suprimido nos outros anos.</para>
</listitem>

<listitem
><para
><guilabel
>28 de fevereiro</guilabel
>: o alarme irá ocorrer a 29 de fevereiro nos anos bissextos e a 28 de fevereiro nos outros anos.</para>
</listitem>

<listitem
><para
><guilabel
>1 de março</guilabel
>: o alarme irá ocorrer a 29 de fevereiro nos anos bissextos e a 1 de março nos outros anos.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>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.</para
></tip>

</listitem>
</itemizedlist>

<para
>No grupo do <guilabel
>Fim da Recorrência</guilabel
>, configure a amplitude temporal de recorrência global da seguinte forma:</para>

<itemizedlist>
<listitem
><para
>Selecione <guilabel
>Sem fim</guilabel
> para continuar as repetições indefinidamente.</para
></listitem>

<listitem
><para
>Selecione <guilabel
>Acabar ao fim de</guilabel
> para indicar o número total de ocorrências do alarme.</para
></listitem>

<listitem
><para
>Selecione <guilabel
>Acabar em</guilabel
> para indicar a data/hora até à qual o alarme será repetido. Lembre-se que isto usa o mesmo fuso horário que a hora inicial do alarme.</para>

<note
><para
>A data/hora do fim determina quando será a última recorrência principal, mas não limitas as sub-repetições. Se estas estiverem configuradas, irão disparar normalmente após a última recorrência principal, independentemente da data/hora final.</para
></note>
</listitem>
</itemizedlist>

<para
>O grupo <guilabel
>Exceções</guilabel
> permite-lhe excluir certas datas/horas da recorrência que tiver configurado. Lembre-se que estes controles não aparecem na versão simplificada da janela de Edição do Alarme: para vê-los, clique em <guibutton
>Mais Opções</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>A lista de exceções (&ie;, as datas/horas excluídas) é mostrada à esquerda. Para adicionar uma nova exceção, insira uma data à direita e clique em <guibutton
>Adicionar</guibutton
>. Para alterar uma exceção, selecione-a na lista, insira a nova data à direita e clique em <guibutton
>Modificar</guibutton
>. Para remover uma exceção, selecione-a na lista e clique em <guibutton
>Remover</guibutton
>.</para>
</listitem>

<listitem>
<para
>Você poderá restringir um alarme para não ocorrer nos feriados, se assinalar a opção <guilabel
>Excluir os feriados</guilabel
>. Isto não altera a forma como o alarme é agendado; simplesmente elimina o alarme sempre que este estiver agendado para disparar após o horário de trabalho. O horário de trabalho é definido na <link linkend="preferences-time"
>janela de Configuração</link
>.</para>
</listitem>

<listitem>
<para
>Você poderá restringir um alarme para ocorrer apenas durante o horário de trabalho, se assinalar a opção <guilabel
>Só durante o horário de trabalho</guilabel
>. Isto não altera a forma como o alarme é agendado; simplesmente elimina o alarme sempre que este estiver agendado para disparar após o horário de trabalho. O horário de trabalho é definida na <link linkend="preferences-time"
>janela de Configuração</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Sub-repetição</title>

<para
>Você poderá também usar o botão de <guibutton
>Sub-repetição</guibutton
> 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 recorrência principal, em vez de ser disparado uma vez, será disparado repetidamente, de acordo com a sua indicação de sub-repetição. 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, você poderia usar uma recorrência semanal às quintas-feiras às 12:00 e usar a janela de sub-repetição para indicar um intervalo de 1 hora e uma quantidade igual a 6 ou uma duração de 6 horas.</para>

<para
>Na janela de Sub-Repetição que aparece quando você clica no botão <guibutton
>Sub-Repetição</guibutton
>, assinale a opção <guilabel
>Repetir a cada</guilabel
> para configurar uma repetição ou desligue-a para remover as repetições. Se a opção <guilabel
>Repetir a cada </guilabel
> estiver assinalada, configure a repetição da seguinte forma:</para>

<itemizedlist>
<listitem
><para
>Insira o intervalo de tempo entre as repetições nas opções ao lado de <guilabel
>Repetir a cada</guilabel
>. Selecione as unidades de tempo desejadas (&eg; <guilabel
>dias</guilabel
>) e insira então o número de unidades.</para>
</listitem>

<listitem
><para
>Especifique o número de repetições ou a sua duração:</para>

<itemizedlist>
<listitem
><para
>Selecione o <guilabel
>Número de vezes</guilabel
> para indicar o número de repetições que o alarme deverá ter, incluindo a sua ocorrência inicial. Assim, por exemplo, para que o alarme ocorra 4 vezes em cada ocorrência principal, &ie; 3 vezes adicionais, deverá indicar 3 aqui.</para>
</listitem>

<listitem
><para
>Selecione a <guilabel
>Duração</guilabel
> para indicar o período total durante o qual o alarme poderá repetir-se. Não precisa ser um múltiplo exato do intervalo de repetição; ele será arredondado automaticamente ao clicar em <guibutton
>OK</guibutton
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Para evitar a sobreposição de sub-repetições para o mesmo alarme, a duração de uma sub-repetição está restringida a ser menor que o maior intervalo entre recorrências principais. Sempre que o alarme repetir, como estiver definido na recorrência principal, todas as sub-repetições ativas que iniciaram na recorrência anterior são automaticamente canceladas.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Outros Controles</title>

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

<para
>Selecione a opção <guilabel
>Mostrar no &korganizer;</guilabel
> para adicionar o alarme ao calendário ativo do &korganizer;, onde ele irá aparecer como um evento sem alarme. Esta opção permite-lhe registrar os alarmes no &korganizer;, tirando ainda partido das funções do &kalarm;.</para>

<note
><para
>Se você 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á afetado.</para
></note>

<para
>Clique no botão <guibutton
>Carregar um Modelo</guibutton
> para selecionar um modelo com o qual preencher a janela, tal como descrito em <link linkend="create-edit"
>Criar e Manipular Alarmes</link
>. </para>

<para
>Clique no botão <guibutton
>Testar</guibutton
> para exibir o alarme e verificar se funciona corretamente. O alarme é executado da mesma forma como se tivesse sido agendado da forma normal. No caso de um alarme de áudio, pressione o botão <guibutton
>Testar</guibutton
> uma segunda vez para interromper a reprodução do arquivo de som.</para>

<para
>Clique no botão <guibutton
>OK</guibutton
> quando todos os detalhes estiverem corretos para adicionar o alarme à lista agendada. Lembre-se que, ao editar um alarme existente, o botão <guibutton
>OK</guibutton
> fica desativado enquanto não fizer nenhuma alteração.</para>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Janela de Mensagem de Alarme</title>

<para
>Quando uma mensagem de alarme chega à sua hora, é mostrada em todos as telas do &kde; e não pode ser coberta pelas janelas normais, para garantir que você a veja. A janela da mensagem mostra a hora para a qual o alarme foi agendado, para que você possa ver quando aparecer se estava ausente nessa hora. (Para as mensagens de lembrete, todavia, a data/hora mostrada é a do alarme principal ou da sua repetição, não é a hora do lembrete, e o seu título é <quote
>Lembrete</quote
>.)</para>

<para
>As mensagens de alarmes ficam visíveis até que você as confirme, a menos que a opção <guilabel
>Fechar automaticamente a janela após o período de cancelamento</guilabel
> esteja assinalada no <link linkend="alarm-edit-dlg"
>diálogo de Edição de Alarmes</link
>. No caso de um alarme recorrente, se permanecer alguma janela de mensagem de uma ocorrência anterior do alarme, a janela existente simplesmente aparece quando o alarme se repetir. Isto evita ter que confirmar várias cópias da mesma mensagem no caso de não desejar ou não conseguir confirmar uma mensagem na hora em que ela aparecer.</para>

<para
>A janela da mensagem de alarme contém as opções que a seguir, desde que aplicadas ao alarme apresentado:</para>

<itemizedlist>
<listitem>
<para
>Confirmar o alarme clicando o botão <guibutton
>Fechar</guibutton
>. Isto fecha a janela (depois de um pedido de confirmação, se você selecionou a opção <guilabel
>Confirmar a recepção</guilabel
>).</para>
</listitem>

<listitem>
<para
>Edite o alarme, clicando no botão <guibutton
>Editar...</guibutton
>. Isto mostra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>.</para>
</listitem>

<listitem>
<para
>Mostrar as opções para adiar o alarme para mais tarde, clicando no botão <guibutton
>Adiar...</guibutton
>. Depois selecione a opção <guilabel
>Adiar para a data/hora</guilabel
> de modo a inserir a data e hora em que a mensagem deverá ser mostrada de novo ou selecione o <guilabel
>Adiar durante o intervalo de tempo</guilabel
> para inserir em que tempo a partir de agora (em horas e minutos) é que a mensagem deverá ser mostrada de novo. Depois, clique em <guibutton
>OK</guibutton
> para remeter a mensagem de alarme mais tarde e fechar a sua janela.</para>

<note
><para
>A hora para a qual é adiado um alarme deverá ser anterior à sua próxima ocorrência agendada ou até o próxima lembrete de antecipação. Por essa razão, o botão <guibutton
>Adiar...</guibutton
> na janela da mensagem de alarme e o botão de <guibutton
>OK</guibutton
> na janela de adiamento, ficam desativados um minuto antes da próxima ocorrência ou lembrete de antecipação.</para>
<para
>Lembre-se que, se estiver configurado um lembrete <emphasis
>após</emphasis
> o alarme, você <emphasis
>pode</emphasis
> adiar o alarme para depois da sua hora do lembrete. Nesse caso, o lembrete será suprimido.</para
></note>

<note
><para
>O botão <guibutton
>Adiar...</guibutton
> não está disponível para os alarmes que são apresentados após o login, devido ao fato da opção <guilabel
>Repetir após login</guilabel
> ter sido selecionada.</para
></note>
</listitem>

<listitem>
<para
>Pare de tocar o arquivo de som do alarme, clicando no botão que mostra o símbolo para <quote
>parar de tocar</quote
>.</para>
</listitem>

<listitem>
<para
>Se a mensagem do alarme foi criada ao arrastar um e-mail do &kmail;, você poderá acessar diretamente ao &kmail;, clicando no botão que mostra o ícone do &kmail;. Isto irá selecionar e realçar a mensagem de e-mail na lista de pastas do &kmail;.</para>

<warning
><para
>Se os índices do &kmail; forem gerados novamente, a ligação à mensagem de e-mail do &kmail; será perdida.</para
></warning>
</listitem>

<listitem>
<para
>O botão que mostra o ícone do <guiicon
>&kalarm;</guiicon
> oferece uma forma conveniente de ativar o &kalarm;.</para>
</listitem>
</itemizedlist>

<para
>Você também poderá escolher, na <link linkend="preferences-view"
>janela de Configuração</link
>, quais dos dois diferentes modos a usar nas janelas de mensagens de alarme:</para>

<itemizedlist>
<listitem>
<para
>Como uma janela normal. Neste modo, o foco do teclado é feito pela janela da mensagem de alarme logo que ela aparece, por isso, se estiver digitando alguma coisa na hora, os seus eventos de teclado serão desviados para ela em vez de ser para o seu aplicativo original.</para>
</listitem>

<listitem>
<para
>Como uma janela não-modal. Neste modo, não há captura do teclado quando aparecer a janela da mensagem de alarme, assim não irá interferir com a sua escrita. Contudo, neste modo, a janela não tem barra de título, assim você não poderá movê-la ou redimensioná-la.</para>
</listitem>
</itemizedlist>

<note
><para
>Quando for apresentado um alarme acima de um aplicativo em tela cheia, ele aparece como uma janela não-modal, independentemente desta opção de configuração. Isto deve-se a uma limitação do sistema de janelas.</para
></note>

<sect2>
<title
>Posicionamento das Janelas de Mensagens</title>

<para
>Você poderá escolher, na <link linkend="preferences-view"
>janela de Configuração</link
>, qual dos dois esquemas usar para posicionar as janelas de mensagens de alarmes:</para>

<itemizedlist>
<listitem>
<para
>As janelas aparecem o mais longe possível da posição atual do cursor. Isto minimiza o incômodo ao seu trabalho e minimiza também a possibilidade de aceitar sem querer o alarme.</para>
</listitem>

<listitem>
<para
>As janelas aparecem no centro da tela. Para reduzir a chance de aceitar por acidente o alarme, os botões na janela aparecem desativados inicialmente, só ficando ativos ao fim de algum tempo (configurável).</para>
</listitem>
</itemizedlist>

<para
>Se você tiver várias janelas ou mensagens de alarmes visíveis, você poderá espalhá-las pela tela, de modo a ficarem todas visíveis, ou então agrupá-las todas em conjunto no canto superior esquerdo do seu ambiente, através da opção do menu <menuchoice
> <guimenu
>Ver</guimenu
><guimenuitem
>Espalhar as Janelas</guimenuitem
> </menuchoice
>. Se desejar, poderá configurar uma tecla de atalho global para esta ação.</para>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Operação na área de notificação</title>

<para
>O &kalarm; poderá ser executado como um ícone na área de notificação. Este ícone oferece tanto uma indicação do estado como o controle do monitoramento dos alarmes. Uma janela normal do &kalarm; indica que os alarmes estão sendo monitorados, enquanto que um ícone em cinza indica que os alarmes não estão sendo monitorados. Se alguns dos alarmes individuais estiverem desativados, irá aparecer uma pequena cruz sobre o ícone.</para>

<para
>O ícone do &kalarm; na área de notificação fica automaticamente oculto, por padrão, sempre que não existirem alarmes nas próximas 24 horas. Você pode mudar o limite para este ocultamente automático, ou sempre exibir o ícone na área de notificação, usando a <link linkend="preferences-view"
>janela de Configuração</link
>. Para mostrar o ícone quando ele estiver oculto automaticamente, clique na seta na área de notificação para revelar os ícones ocultos.</para>

<para
>Se você passar o cursor do mouse por cima do ícone da área de notificação, aparece um resumo das primeiras mensagens de alarmes que irão ser ativadas nas próximas 24 horas como uma dica. Você poderá desligar essa funcionalidade ou configurar o número de alarmes a exibir e o seu formato na <link linkend="preferences-view"
>janela de Configuração</link
>.</para>

<para
>Clique com o &LMB; no ícone da área de notificação para ocultar ou mostrar a janela principal do &kalarm;.</para>

<para
>Clique com o &RMB; no ícone da área de notificação para mostrar o seu menu de contexto:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Habilitar alarmes</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Ativa ou desativa a monitoração dos alarmes.</action
></para>
<para
>Veja a <link linkend="enable-disable"
>Ativação/Desativação dos Alarmes</link
> para mais detalhes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Novo Alarme</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Depois, você poderá selecionar o tipo de alarme na lista que aparece, que abre a janela de Edição de Alarmes para criar um novo alarme.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Parar a Reprodução</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Interrompe a reprodução do arquivo de áudio atualmente em curso.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Espalhar as janelas</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Espalha as janelas de mensagens de alarmes e erros pela tela, ou então volta a agrupá-las de novo.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Configurar o &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Mostra a janela de Configuração do &kalarm;.</action
></para>
<para
>A janela de Configuração está descrita em <link linkend="preferences"
>Configurar o &kalarm;</link
>. Ela inclui as opções relacionadas com o ícone da área de notificação para o &kalarm;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Restaurar / Minimizar</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Restaura ou minimiza a janela principal do &kalarm;.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Sair</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Fecha o ícone da área de notificação e as janelas principais do &kalarm;.</action
></para>
<para
>Sai do &kalarm; quando não estiverem apresentadas janelas de mensagens de alarme.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>Mostrando o &kalarm; na área de notificação</title>

<para
>Você deverá estar rodando o ambiente de trabalho &kde; ou outro gerenciador de janelas adequado para mostrar o &kalarm; na área de notificação.</para>

<para
>Selecione <menuchoice
><guimenu
>Exibir</guimenu
> <guimenuitem
>Mostrar na área de notificação</guimenuitem
></menuchoice
> para exibir o &kalarm; na área de notificação, de acordo com as preferências definidas na aba <link linkend="preferences-view"
>Exibir</link
> da caixa de diálogo de Configuração.</para>

<para
>Para remover o &kalarm; da área de notificação, desligue a opção <menuchoice
> <guimenu
>Ver</guimenu
><guimenuitem
>Mostrar na área de notificação</guimenuitem
> </menuchoice
>.</para>

<para
>Para selecionar se o &kalarm; deverá aparecer ou não, após a inicialização, na área de notificação, use a página <link linkend="preferences-view"
>Ver</link
> da janela de Configuração.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Atualizar os Alarmes</title>

<para
>No caso pouco provável de algum alarme não ter sido disparado quando deveria ter sido, você poderá atualizar a lista de alarmes e disparar os alarmes que estão faltando, selecionado a opção <menuchoice
> <guimenu
>Ações</guimenu
><guimenuitem
>Atualizar os Alarmes</guimenuitem
> </menuchoice
>. Isto fará com que o &kalarm; carregue novamente todos os arquivos e calendários de alarmes.</para>

<para
>Você pode recarregar um calendário específico e atualizar seus alarmes na lista de alarmes executando um clique <mousebutton
>Direito</mousebutton
> no calendário desejado na lista e usando a opção do menu de contexto <menuchoice
><guimenuitem
>Recarregar</guimenuitem
></menuchoice
>. Veja mais detalhes em <link linkend="calendars"
>Calendários de Alarmes</link
>.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Ativar/Desativar os Alarmes</title>

<para
>Os alarmes poderão ser ativados ou desativados como um todo ou individualmente:</para>

<itemizedlist>
<listitem>
<para
>O <quote
>Monitoramento de alarmes</quote
> aplica-se aos alarmes como um todo. Quando o monitoramento de alarmes está desativado, nenhum alarme será acionado. Quando o monitoramento de alarmes estiver ativado (a situação normal), todos os alarmes que não tenham sido desativados individualmente serão acionados nas horas apropriadas.</para>

<para
>Quando a monitoração dos alarmes estiver ativa novamente, os alarmes que deveriam ter sido disparados durante a sua desativação serão agora ativados (a menos que alguma opção de cancelamento posterior o impeça). Em outras palavras, a desativação da monitoração dos alarmes tem o mesmo efeito que parar o &kalarm; &ndash; os alarmes são adiados até à sua nova ativação.</para>
</listitem>

<listitem>
<para
>Os alarmes poderão ser ativados ou desativados individualmente, independentemente do estado de monitoração dos alarmes. Assim, o estado de ativado/desativado dos alarmes individuais ficará inalterado se desativar e voltar a ativar a monitoração dos alarmes. Ao contrário da monitoração dos alarmes, que poderá potencialmente ser desativada devido ao fato do &kalarm; não estar rodando ou não estar funcionando, os alarmes individuais só poderão ser desativados, se usar os comandos do menu para fazer isso.</para>

<para
>Quando um alarme for reativado individualmente, ele não será disparado agora, no caso de ter ficado fora de prazo durante a sua desativação. Em outras palavras, a desativação de um alarme individual cancela todas as suas ocorrências até ser ativado novamente.</para>

<para
>O estado de ativado/desativado individual de um alarme é indicado pela sua cor na lista de alarmes (a cor é configurável na página <link linkend="preferences-view"
>Ver</link
> da janela de Configuração).</para>
</listitem>
</itemizedlist>

<para
>Para um alarme disparar, ele precisa estar ativo individualmente, assim como a monitoração terá que estar ativa.</para>

<sect2>
<title
>Ativar a Monitoração de Alarmes</title>

<para
>Para a monitoração dos alarmes ocorrer, o &kalarm; deverá estar em execução. Uma vez executado o &kalarm;, ele iniciará sempre que você iniciar uma sessão, a menos que o desative posteriormente na página <link linkend="preferences-general"
>Geral</link
> da janela de Configuração.</para>

<para
>Se a monitoração de alarmes estiver atualmente desativada, faça uma das seguintes ações para ativar os alarmes:</para>

<itemizedlist>
<listitem>
<para
>Selecione <menuchoice
><guimenu
>Ações</guimenu
> <guimenuitem
>Ativar Alarmes</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Clique com o &RMB; no ícone da área de notificação e escolha a opção <menuchoice
><guimenuitem
>Ativar os Alarmes</guimenuitem
></menuchoice
> no menu de contexto.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Desativar a Monitoração de Alarmes</title>

<para
>Você poderá desativar a nível temporário a monitoração dos alarmes que impede o &kalarm; de mostrar os outros alarmes até que volte a ativá-los, ou &ndash; assumindo que o &kalarm; esteja configurado para ser iniciado após o login &ndash; até à próxima vez que se logar.</para>

<itemizedlist>
<listitem>
<para
>Selecione <menuchoice
><guimenu
>Ações</guimenu
> <guimenuitem
>Ativar os Alarmes</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Clique com o botão <mousebutton
>direito</mousebutton
> no ícone da área de notificação e selecione a opção <menuchoice
><guimenuitem
>Ativar os Alarmes</guimenuitem
></menuchoice
> no menu de contexto.</para>
</listitem>

<listitem>
<para
>Execute o &kalarm; com a opção da linha de comando <option
>--disable-all</option
>.</para>
</listitem>

<listitem>
<para
>Pare o &kalarm;, como se encontra descrito em <link linkend="quitting"
>Sair do &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Os alarmes poderão ser desativados de forma permanente se optar que o &kalarm; não deva ser iniciado na inicialização da sessão, usando a página <link linkend="preferences-general"
>Geral</link
> da janela de Configuração.</para>

</sect2>

<sect2>
<title
>Ativar/Desativar os Alarmes Individualmente</title>

<para
>Para ativar os alarmes individuais que estejam desativados no momento, faça uma das seguintes ações:</para>

<itemizedlist>
<listitem>
<para
>Selecione um ou mais alarmes, clicando nos itens respectivos na lista de alarmes. Depois, escolha a opção <menuchoice
> <guimenu
>Ações</guimenu
><guimenuitem
>Ativar</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Clique com o &RMB; nos itens desejados na lista de alarmes e escolha a opção <menuchoice
><guimenuitem
>Ativar</guimenuitem
></menuchoice
> do menu de contexto.</para>
</listitem>
</itemizedlist>

<para
>Para desativar os alarmes individuais que estejam desativados no momento, faça uma das seguintes ações:</para>

<itemizedlist>
<listitem>
<para
>Selecione um ou mais alarmes, carregando nos itens respectivos na lista de alarmes. Depois, escolha a opção <menuchoice
> <guimenu
>Ações</guimenu
><guimenuitem
>Desativar</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Clique com o &RMB; nos itens desejados na lista de alarmes e escolha a opção <menuchoice
><guimenuitem
>Desativar</guimenuitem
></menuchoice
> do menu de contexto.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Acordar da suspensão</title>

<para
>É possível configurar um alarme selecionado para acordar o seu sistema do estado de hibernação ou suspensão quando o alarme for disparado, para que a ação do alarme possa ocorrer mesmo que o sistema tenha sido desligado. Esta função é controlada por uma janela acessada através da seleção da opção <menuchoice
><guimenu
>Ações</guimenu
> <guimenuitem
>Acordar da suspensão</guimenuitem
></menuchoice
>. A janela permite definir o alarme para Acordar da suspensão, assim como cancelá-lo ou realçá-lo.</para>

<para
>O uso desta função necessita de privilégios de administração. Será pedida a senha do administrador quando configurar ou cancelar um alarme para acordar da suspensão.</para>

<note
><para
>Esta funcionalidade não é suportada em alguns computadores, especialmente os mais antigos, e alguns só suportam a definição de um tempo de ativação nas próximas 24 horas. Poderão também existir algumas restrições sobre o modo de suspensão que a função irá usar. Você deve testar alguns alarmes, para verificar as capacidades do seu sistema, antes de usar a função efetivamente.</para
></note>

<warning
><para
>O seu computador só poderá agendar um único alarme deste tipo de cada vez. Se usar esta função com o &kalarm;, deverá certificar-se de que não entra em conflito com nenhuma outra aplicação que também use a funcionalidade para acordar da suspensão. Sempre que uma aplicação agendar ou limpar alarmes deste tipo, serão cancelados os alarmes anteriores, sejam eles definidos pelo &kalarm; ou por outra aplicação.</para
></warning>

<para
>A janela para Acordar da suspensão é usada em conjunto com a lista de alarmes na janela principal do &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Usar o alarme selecionado</guibutton
>: isto configura o alarme atualmente selecionado na lista para ser o alarme atual para Acordar da suspensão. Todos os alarmes deste tipo são cancelados, como foi explicado acima. O botão só fica ativo se estiver selecionado apenas um alarme.</para>
</listitem>

<listitem>
<para
><guibutton
>Cancelar a ativação da suspensão</guibutton
>: isto cancela qualquer alarme para Acordar da suspensão existente (quer seja definido pelo &kalarm; quer por outra aplicação qualquer - ver acima). Lembre-se que isto só cancela a função de ativação associada ao alarme; o alarme em si não é removido e irá continuar a funcionar da normalmente.</para>
</listitem>

<listitem>
<para
><guibutton
>Mostrar o alarme atual</guibutton
>: este realça o alarme atual para Acordar da suspensão na lista de alarmes, para que possa ser identificado. O botão fica desativado se nenhum alarme deste tipo estiver configurado.</para>
</listitem>

<listitem>
<para
>O <guilabel
>Número de minutos antes de o alarme acordar da suspensão</guilabel
> controla a possibilidade de, se desejar, o sistema ter algum tempo para restaurar-se por completo antes do alarme ser disparado, para que o mesmo possa funcionar na hora correta.</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="quitting">
<title
>Sair do &kalarm;</title>

<para
>Saia do &kalarm; com a opção <menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Sair</guimenuitem
></menuchoice
> ou o item do menu de contexto do ícone da área de notificação <menuchoice
><guimenuitem
>Sair</guimenuitem
></menuchoice
>. Em alternativa, se o ícone da área de notificação não estiver vazio, feche todas as janelas do &kalarm;.</para>

</sect1>
</chapter>

<chapter id="preferences">
<title
>Configurando o &kalarm;</title>

<para
>Para configurar a operação do &kalarm; de acordo com o seu sistema e com as suas Configuração pessoais, selecione a opção <menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar o &kalarm;...</guimenuitem
></menuchoice
>. Isto mostra a janela de Configuração.</para>

<sect1 id="preferences-general">
<title
>Geral</title>

<para
>A seção <guilabel
>Geral</guilabel
> permite-lhe controlar o comportamento global do &kalarm;:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Iniciar no login</guilabel
>: inicia automaticamente o &kalarm; na inicialização da sessão do &kde;, após o login, para garantir que o &kalarm; esteja sempre em execução, a menos que o termine manualmente.</para>

<warning
><para
>Esta opção deve sempre estar habilitada a menos que você não pretenda mais usar o &kalarm;.</para
></warning>

<note
><para
>Esta opção fica automaticamente selecionada novamente, sempre que o &kalarm; é executado. Por isso, se você tiver desligado esta opção e quiser a evitar que o &kalarm; se execute na inicialização, terá que desligar esta opção de novo, cada vez que executar o &kalarm;.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Avisar antes de sair</guilabel
>: Quando os alarmes forem desativados enquanto o &kalarm; não estiver rodando, a seleção desta opção pede-lhe uma confirmação se tentar terminar o &kalarm; com a opção do ícone da área de notificação <menuchoice
><guimenu
>Sair</guimenu
></menuchoice
>. Isto evita que os alarmes sejam desativados acidentalmente. Por razões de segurança, esta opção é reativada automaticamente sempre que mudar de modo de execução.</para>
</listitem>

<listitem
><para
><guilabel
>Confirmar as remoções dos alarmes</guilabel
>: Especifique se será questionado para confirmar cada vez que desejar remover um alarme.</para>
</listitem>

<listitem
><para
><guilabel
>Intervalo de tempo de adiamento padrão</guilabel
>: Insira o intervalo de tempo padrão, em horas e minutos, a mostrar inicialmente quando for apresentada a janela para Adiar o Alarme. Lembre-se que, se um alarme tiver sido anteriormente adiado, o intervalo que é apresentado inicialmente nessa janela será igual ao intervalo adiado que foi usado no último adiamento.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal para os Comandos de Alarme</guilabel
>: Aqui poderá selecionar o tipo de janela de terminal que será usado para os alarmes de comandos a serem executados numa janela de terminal. Alguns dos aplicativos de janelas de terminais estão pré-configurados, &eg; o <application
>xterm</application
>, o &konsole;, ainda que só sejam visíveis os que estiverem instalados aqui. Você poderá ver as opções atuais do comando que são usadas por cada aplicativo, mostrando a ajuda de contexto para a sua opção respectiva.</para>

<para
>Se quiser usar outro aplicativo ou quiser usar um dos que se encontram listados, só que com opções do comando diferentes, selecione <guilabel
>Outro</guilabel
> e insira o comando para invocar a janela do terminal. Por padrão, o texto do comando do alarme será adicionado ao que inserir. Em alternativa, você poderá indicar onde o texto do comando do alarme será introduzido, usando um dos seguintes códigos:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>O texto do comando do alarme será substituído.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>O texto do comando do alarme será substituído, com um <literal
>sleep</literal
> adicionado.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Um arquivo de comando temporário, contendo o texto do comando do alarme, será criado, sendo substituído o comando para executar o arquivo.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Um arquivo de comando temporário, contendo o texto do comando do alarme, será criado com um <literal
>sleep</literal
> adicionado, sendo substituído o comando para executar o arquivo.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Quando o alarme do comando for disparado, o seu texto de comando será rodeado de aspas antes de ser introduzido no comando da janela de terminal.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Data e Hora</title>

<para
>A seção <guilabel
>Data e Hora</guilabel
> permite-lhe escolher as opções relacionadas com a data e hora:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Fuso horário</guilabel
>: Selecione o seu fuso horário. O &kalarm; usa este fuso horário em todas os alarmes, exceto quando substituí-los nos alarmes individuais.</para>
</listitem>

<listitem
><para
><guilabel
>Região dos feriados</guilabel
>: Selecione quais os feriados do país ou região usar. Isto afeta os alarmes recorrentes, para os quais está selecionada a opção de exclusão dos feriados.</para>
</listitem>

<listitem
><para
><guilabel
>Início do dia para os alarmes por data</guilabel
>: Define a hora do início do dia para o caso da ativação dos alarmes apenas por data, &ie; os que têm a opção <guilabel
>A qualquer hora</guilabel
> selecionada. Quando chegar a data exata, estes alarmes serão ativados na primeira oportunidade que for possível durante as 24 horas, a ter início na hora do início do dia.</para>
</listitem>

<listitem
><para
>Grupo do <guilabel
>Horário de Trabalho</guilabel
>: Estas opções permitem-lhe definir o seu horário de trabalho, que é necessário quando a opção <guilabel
>Apenas durante o horário de trabalho</guilabel
> for selecionada para uma recorrência na <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>.</para>

<itemizedlist>
<listitem
><para
>Assinale todos os dias de trabalho.</para>
</listitem>

<listitem
><para
><guilabel
>Hora inicial do dia</guilabel
>: indique a hora que começa a trabalhar todos os dias.</para>
</listitem>

<listitem
><para
><guilabel
>Hora final do dia</guilabel
>: indique a hora que termina o trabalho todos os dias.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Duração do evento do KOrganizer</guilabel
>: Indique a duração do evento a definir no &korganizer; para os alarmes que são copiados para o &korganizer;. A duração padrão corresponde a zero.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Armazenamento</title>

<para
>A seção <guilabel
>Armazenamento</guilabel
> permite-lhe escolher as opções para salvar e arquivar os alarmes:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Novos Alarmes &amp; Modelos</guilabel
>: Indique o calendário onde gravar os alarmes e modelos novos, ao usar calendários com vários alarmes:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Guardar no calendário padrão</guilabel
>: Os alarmes e modelos novos são adicionados automaticamente ao calendário padrão, sem pedir qualquer confirmação.</para>
</listitem>

<listitem>
<para
><guilabel
>Perguntar o calendário onde gravar</guilabel
>: Quando criar um alarme ou modelo novo, e existir mais de um calendário com possibilidade de gravação, será questionado para escolher o calendário onde salvá-lo. Lembre-se que, quando os alarmes forem salvos ao expirarem, eles são sempre salvos no calendário padrão de arquivo, sem qualquer questionamento.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Grupo dos <guilabel
>Alarmes Arquivados</guilabel
>: Estas opções controlam o armazenamento dos alarmes arquivados no recurso padrão para os alarmes arquivados.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Manter os alarmes depois de expirarem</guilabel
>: Selecione esta opção para armazenar os alarmes expirados e removidos. Desligue-a para não guardar nenhum registro dos alarmes, logo que estes deixem de estar ativos. Lembre-se que os alarmes removidos só são guardados se tiverem sido disparados anteriormente. Se você remover um alarme antes dele ser disparado, ele será descartado.</para>
</listitem>

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

<listitem
><para
><guibutton
>Limpar os alarmes arquivados</guibutton
>: Este botão limpa todos os alarmes arquivados que estejam armazenados no calendário padrão para alarmes arquivados (Os outros calendários são deixados inalterados, no caso de estarem compartilhados com outras pessoas). Isto não tem efeito nos alarmes que irão expirar posteriormente; eles continuarão a ser guardados de acordo com as opções selecionadas.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>E-mail</title>

<para
>A seção <guilabel
>E-mail</guilabel
> permite-lhe escolher as opções para enviar e endereçar os alarmes por e-mail:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Cliente de e-mail</guilabel
>: Indique o cliente de e-mail que será usado para enviar os alarmes por e-mail:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Quando um alarme de e-mail é ativado, o e-mail é enviado utilizando o &kmail; (que é iniciado primeiro, se for necessário) como se segue:</para>

<itemizedlist>
<listitem
><para
>Se o &kmail; for da versão 1.7 ou posterior, a mensagem é enviada automaticamente.</para>
</listitem>

<listitem
><para
>Se o &kmail; for de uma versão anterior, a mensagem é adicionada à pasta <filename
>A enviar</filename
> do &kmail; para ser transmitida posteriormente.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Quando é disparado 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 <application
>postfix</application
> ou o <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Copiar mensagens enviadas para a pasta de itens enviados do &kmail;</guilabel
>: Selecione esta opção se, toda vez que um alarme de e-mail for disparado, você deseja que uma cópia da mensagem transmitida seja guardada na pasta de <filename
>itens enviados</filename
> do &kmail;.</para>

<note
><para
>Esta opção não está disponível quando o &kmail; está selecionado como cliente de e-mail, uma vez que o &kmail; automaticamente faz isto.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Avisar quando os e-mails remotos estiverem na fila</guilabel
>: Selecione 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 chamada telefônica ou se a mensagem fica em espera na pasta do &kmail; <filename
>caixa de saída</filename
>, de modo que possa garantir que você faça tudo o que é necessário para enviar de fato a mensagem.</para>
</listitem>

<listitem>
<para
>Selecione seu endereço eletrônico a ser usado como endereço de remetente nos alarmes de e-mail:</para>

<itemizedlist>
<listitem
><para
>Selecione <guilabel
>De</guilabel
> para inserir um endereço de e-mail.</para>
</listitem>

<listitem
><para
>Selecione a opção <guilabel
>Usar o endereço das Configurações do Sistema</guilabel
> para usar o endereço de e-mail configurado na Configuração do Sistema do &kde;.</para>
</listitem>

<listitem
><para
>Selecione a opção <guilabel
>Usar identidades do &kmail;</guilabel
> para ser capaz de escolher na hora em que você configura um alarme de e-mail qual identidade de e-mail do &kmail; usar. A identidade padrão do &kmail; será usada para alarmes que já foram configurados antes de você selecionar esta opção.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Selecione seu endereço de e-mail a ser usado para enviar cópias de alarmes de e-mail para você mesmo quando a opção <guilabel
>Copiar e-mail para você mesmo</guilabel
> estiver selecionada:</para>

<itemizedlist>
<listitem
><para
>Selecione <guilabel
>Cco</guilabel
> para inserir um endereço de e-mail. Se as cópias estão sendo enviadas para sua conta no computador que o &kalarm; está rodando, você pode simplesmente inserir seu nome de usuário aqui.</para>
</listitem>

<listitem
><para
>Selecione a opção <guilabel
>Usar o endereço das Configurações do Sistema</guilabel
> para usar o endereço de e-mail configurado na Configuração do Sistema do &kde;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Ver</title>

<para
>A seção <guilabel
>Ver</guilabel
> permite-lhe controlar alguns aspectos da aparência do &kalarm;. Na página <guilabel
>Geral</guilabel
>:</para>
<itemizedlist>

<listitem>
<para
><guilabel
>Mostrar na área de notificação</guilabel
>: Quando selecionada, o ícone é exibido enquanto o &kalarm; estiver em execução, de acordo com a opção selecionada:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Exibir sempre</guilabel
>: O ícone é sempre exibido na área de notificação.</para>
</listitem>

<listitem>
<para
><guilabel
>Ocultar automaticamente se não tiver alarmes ativos</guilabel
>: O ícone é oculto da área de notificação se não existirem alarmes ativos.</para>
</listitem>

<listitem>
<para
><guilabel
>Ocultar automaticamente se não existirem alarmes dentre de um período de tempo</guilabel
>: O ícone é oculto da área de notificação se nenhum alarme estiver definido dentro de um período de tempo, a partir de agora.</para>
</listitem>
</itemizedlist>

<para
>Quando o ícone da área de notificação é oculto automaticamente, você pode torná-lo visível da mesma maneira que a área de notificação permite a exibição de ícones ocultos.</para>

<para
>Quando <guilabel
>Mostrar na área de notificação</guilabel
> está selecionado, ao fechar o ícone da área de notificação todas as janelas principais do &kalarm; serão fechadas e, se nenhuma janela de mensagem estiver visível, o aplicativo será fechado.</para>
</listitem>

<listitem>
<para
>Grupo da <guilabel
>Dica da área de notificação</guilabel
>: Estas opções controlam a informação que é apresentada na dica que aparece, sempre que o cursor do mouse pára em cima do ícone da área de notificação do &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Mostrar os alarmes das próximas 24 horas</guilabel
>: Quando estiver selecionada a opção, é mostrado um resumo dos primeiros alarmes que irão ser disparados nas próximas 24 horas.</para>
</listitem>

<listitem>
<para
><guilabel
>Número máximo de alarmes a mostrar</guilabel
>: Desligue esta opção para mostrar todos os alarmes das próximas 24 horas. Selecione-a para definir o número máximo de alarmes que serão exibidos.</para>
</listitem>

<listitem>
<para
><guilabel
>Mostrar a hora do alarme</guilabel
>: Selecione esta opção para mostrar a hora para a qual cada alarme está agendado.</para>
</listitem>

<listitem>
<para
><guilabel
>Mostrar a hora até ao alarme</guilabel
>: Selecione 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.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Prefixo</guilabel
>: Especifica 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.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>O grupo da <guilabel
>Lista de Alarmes</guilabel
> permite a seleção das cores usadas na lista de alarmes da janela principal do &kalarm;, de modo a mostrar os alarmes desativados e arquivados.</para>
</listitem>
</itemizedlist>

<para
>A página <guilabel
>Janelas de Alarmes</guilabel
> contém opções que controlam a aparência das janelas de mensagens de alarme.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Posicionar as janelas longe do cursor do mouse</guilabel
>: Selecione esta opção para mostrar as janelas de mensagens de alarme o mais longe possível da posição atual do cursor. Isto diminui a chance de aceitar sem querer um alarme, clicando de forma não-intencional num botão, logo que apareça a janela do alarme.</para>
</listitem>

<listitem>
<para
><guilabel
>Centrar as janelas, atrasar a ativação dos botões da janela</guilabel
>: Selecione esta opção para mostrar as janelas das mensagens dos alarmes no centro da tela. Para reduzir a chance de aceitar sem querer um alarme, os botões da janela aparecem desativados inicialmente. O atraso em segundos antes da sua ativação é definido na opção <guilabel
>Atraso de ativação do botão (segundos)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>As janelas de mensagens possuem uma barra de título e capturam o teclado</guilabel
>: Esta opção controla se as janelas das mensagens de alarmes são modais ou não, &ie; se capturam os eventos do teclado logo que aparecem. Veja a seção da <link linkend="message-window"
>Janela das Mensagens de Alarme</link
> para mais detalhes.</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-edit">
<title
>Editar</title>

<para
>A seção <guilabel
>Editar</guilabel
> permite-lhe escolher os valores padrão para as opções na <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>:</para>

<itemizedlist>
<listitem
><para
>A página <guilabel
>Geral</guilabel
> contém opções que se aplicam a todos os tipos de alarmes.</para>

<itemizedlist>
<listitem
><para
>Configura os estados padrão para as opções <guilabel
>Mostrar no KOrganizer</guilabel
> ou <guilabel
>Cancelar se atrasado</guilabel
>.</para>
</listitem>

<listitem
><para
>Mudar o tipo de recorrência padrão.</para>
</listitem>

<listitem
><para
>Selecione o tratamento padrão, nos anos não-bissextos, das recorrências anuais agendadas para 29 de Fevereiro.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>A página de <guilabel
>Tipos de Alarmes</guilabel
> contém opções que se aplicam a tipos específicos de alarmes.</para>

<itemizedlist>
<listitem>
<para
>Para os alarmes visíveis:</para>

<itemizedlist>
<listitem
><para
>Configura os estados padrão para as opções <guilabel
>Fechar automaticamente a janela ao fim deste tempo</guilabel
> e <guilabel
>Confirmar a recepção</guilabel
>.</para>
</listitem>

<listitem
><para
>Configura as unidades dos períodos padrões dos lembretes.</para>
</listitem>

<listitem
><para
>Configura as ações padrões de apresentação especiais dos alarmes.</para>
</listitem>

<listitem
><para
>Configura as opções padrão do som. Lembre-se que poderá ser indicado um arquivo de som padrão, mesmo que o tipo de som não esteja como <guilabel
>Arquivo de som</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Para os alarmes de comando:</para>

<itemizedlist>
<listitem
><para
>Configura os estados padrão para as opções <guilabel
>Indicar um programa</guilabel
> ou <guilabel
>Executar numa janela de terminal</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Para os alarmes de e-mail:</para>

<itemizedlist>
<listitem
><para
>Configura o estado padrão para a opção <guilabel
>Copiar o e-mail para o próprio</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>A página <guilabel
>Fonte &amp; Cor</guilabel
> permite-lhe definir a aparência padrão das mensagens de alarmes. Selecione o tipo de fonte padrão e as cores principal e de fundo.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Operação com a Linha de Comando</title>

<para
>Quando são fornecidos parâmetros na linha de comando, o &kalarm; não mostra a lista de alarmes agendados, tal como foi descrito acima em <link linkend="using-kalarm"
>Usando o &kalarm;</link
>. As opções da linha de comando específicas do &kalarm; poderão ser usadas para efetuar as seguintes operações:</para>

<itemizedlist>
<listitem
><para
>agendar um novo alarme</para>
</listitem>
<listitem
><para
>controlar o modo de apresentação do &kalarm;</para>
</listitem>
<listitem
><para
>obter ajuda</para>
</listitem>
</itemizedlist>

<para
>As opções adicionais da linha de comando são oferecidas em primeiro lugar para permitir aos outros programas interagirem com o &kalarm;. Elas estão descritas no capítulo do <link linkend="cmdline-interface"
>Guia do Programador do &kalarm;</link
>.</para>

<para
>A linha de comando só poderá conter as opções que se apliquem a uma operação do &kalarm;. Se quiser efetuar várias operações, terá que invocar o &kalarm; várias vezes com um conjunto único de opções a cada vez.</para>

<sect1 id="cmdline-schedule">
<title
>Agendar um Novo Alarme</title>

<para
>As seguintes opções são usadas para agendar um novo alarme:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opção</entry>
  <entry
>Descrição</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Pede uma confirmação quando a mensagem de alarme for recebida.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Insira o nome ou o &URL; de um arquivo que deverá ser anexado à mensagem de e-mail. Esta opção poderá ser repetida tantas vezes quantas necessárias. O <option
>--mail</option
> terá de ser fornecido com esta opção.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Fecha automaticamente a janela do alarme depois de ter expirado o período do <option
>--late-cancel</option
>. O <option
>--late-cancel</option
> deverá ser indicado com esta opção.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Toca uma campainha audível quando a mensagem for apresentada. O <option
>--speak</option
>, o <option
>--play</option
> e o <option
>--play-repeat</option
> não poderão ser indicados com esta opção.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Envia uma cópia invisível para si próprio. O <option
>--mail</option
> necessita ser indicado com esta opção.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>cor</replaceable
></option
></entry>
  <entry
>Indica a cor de fundo da mensagem com o nome da cor no &Qt; ou com o código hexadecimal 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>cor</replaceable
></option
></entry>
  <entry
>Indica a cor do texto da mensagem com o nome da cor no &Qt; ou com o código hexadecimal 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Desativa o alarme. Não irá disparar até que seja ativado manualmente.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Desativa o monitoramento do alarme. Isto impede que todos os alarmes sejam acionados até que os reative ou que reinicie o &kalarm;, &eg; no início da próxima sessão. O <option
>--triggerEvent</option
> não pode ser indicado com esta opção.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>linha de comando</replaceable
></option
></entry>
  <entry
>Indica um comando a executar. Se for fornecida, esta opção deverá ser a última opção da linha de comando do &kalarm;. Todos os parâmetros subsequentes e as opções são interpretados como formando a linha de comando a executar. O <option
>--file</option
>, o <option
>--exec-display</option
> e o <option
>--mail</option
> não podem ser indicados com esta opção. O <option
>--ack-confirm</option
>, o <option
>--beep</option
>, o <option
>--color</option
> e o <option
>--colorfg</option
> são ignorados com esta opção.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>linha de comando</replaceable
></option
></entry>
  <entry
>Indica um comando a executar. Se for fornecida, esta opção deverá ser a última opção da linha de comando do &kalarm;. Todos os parâmetros subsequentes e as opções são interpretados como formando a linha de comando a executar. O <option
>--exec</option
>, o <option
>--file</option
> e o <option
>--mail</option
> não podem ser indicados com esta opção.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Indica o nome ou a &URL; de um arquivo de texto ou de imagem cujo conteúdo irá formar a mensagem de alarme. O <option
>--exec</option
>, o <option
>--exec-display</option
> e o <option
>--mail</option
> não poderão ser indicados e a <replaceable
>mensagem</replaceable
> não deverá estar presente com esta mensagem.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>A linha do assunto da mensagem de e-mail. O <option
>--mail</option
> deverá ser indicado com esta opção.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>período</replaceable
></option
></entry>
  <entry
>Indica o intervalo entre repetições do alarme. As horas/minutos são indicados no formato <replaceable
>nHnM</replaceable
>, em que o <replaceable
>n</replaceable
> é um número, &eg; 3H30M. Os outros períodos de tempo são indicado no formato <replaceable
>nX</replaceable
>, em que o <replaceable
>n</replaceable
> é um número e o <replaceable
>X</replaceable
> é uma das seguintes letras: Y ('years' - anos), M ('months' - meses), W ('weeks' - semanas), D ('days' - dias). É obrigatório se o <option
>--repeat</option
> ou o <option
>--until</option
> forem indicados. Se o <option
>--recurrence</option
> for passado, o Y (anos) e o M (meses) não são permitidos.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Mostra o alarme como um evento no calendário ativo do &korganizer;.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>período</replaceable
></option
></entry>
  <entry
>Cancela o alarme se não puder ser disparado no <replaceable
>período</replaceable
> após a hora atual. As horas/minutos são indicados no formato <replaceable
>nHnM</replaceable
>, em que o <replaceable
>n</replaceable
> é um número, &eg; 3H30M. Os outros períodos de tempo são indicado no formato <replaceable
>nX</replaceable
>, em que o <replaceable
>n</replaceable
> é um número e o <replaceable
>X</replaceable
> é uma das seguintes letras: W ('weeks' - semanas), D ('days' - dias). O valor padrão do <replaceable
>período</replaceable
> é 1 minuto.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Dispara o alarme sempre que você se loga. O <option
>--interval</option
>, o <option
>--repeat</option
> e o <option
>--until</option
> não podem ser fornecidos com esta opção.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>endereço</replaceable
></option
></entry>
  <entry
>Envia uma mensagem de e-mail para o endereço indicado. Esta opção pode ser repetida tantas vezes quantas necessárias. O <option
>--exec</option
>, o <option
>--exec-display</option
> e o <option
>--file</option
> não podem ser indicados com esta opção. O <option
>--ack-confirm</option
>, o <option
>--beep</option
>, o <option
>--color</option
> e o <option
>--colorfg</option
> são ignorados com esta opção.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Indica o nome ou a &URL; de um arquivo de áudio a ser tocado uma vez, quer como um alarme por áudio ou quando a mensagem de alarme for apresentada. O <option
>--play-repeat</option
>, o <option
>--beep</option
> e o <option
>--speak</option
> não podem ser indicados com esta opção.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Indica o nome ou a &URL; de um arquivo de áudio a ser tocado repetidamente,enquanto não for clicado o botão <guilabel
>Parar a reprodução</guilabel
> ou a mensagem de alarme estiver visível. O <option
>--play</option
>, o <option
>--beep</option
> e o <option
>--speak</option
> não podem ser indicados com esta opção.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>especificação</replaceable
></option
></entry>
  <entry
>Indica o alarme a repetir. Especifique a repetição com a sintaxe do iCalendar (definida na <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), &eg; <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. O <option
>--until</option
> não pode ser indicado com esta opção.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>contagem</replaceable
></option
></entry>
  <entry
>Define o número de vezes que o alarme deverá ser disparado ou, se for indicada uma repetição com a opção <option
>--recurrence</option
>, o número de vezes que o alarme deverá ser disparado cada vez que o <option
>--recurrence</option
> o ativa (&ie; uma repetição dentro de uma recorrência). Se o <option
>--recurrence</option
> não estiver presente, indique -1 para repetir o alarme indefinidamente. O <option
>--interval</option
> deverá ser, e o <option
>--until</option
> não, fornecido com esta opção.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>período</replaceable
></option
></entry>
  <entry
>Mostra um alarme de lembrete no período de tempo antes ou depois do alarme principal e de cada uma das suas repetições (se houverem). O <replaceable
>período</replaceable
> é indicado no mesmo formato que no <option
>--late-cancel</option
>. Por padrão, o lembrete irá ocorrer antes do alarme. Para indicar um lembrete após o alarme, anteceda o <replaceable
>período</replaceable
> com o prefixo <replaceable
>+</replaceable
>, &eg; +3D. Esta opção não pode ser usada com o <option
>--exec</option
>, o <option
>--mail</option
> ou o <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>período</replaceable
></option
></entry>
  <entry
>Mostra um alarme de lembrete apenas uma vez, no período de tempo antes ou depois da primeira ocorrência do alarme. Nenhum lembrete será exibido antes ou após as ocorrências seguintes (se houver). O <replaceable
>período</replaceable
> é indicado no mesmo formato que em <option
>--reminder</option
>. Esta opção não poderá ser indicada com a <option
>--exec</option
>, <option
>--mail</option
> ou a <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Fala a mensagem quando ela for apresentada. Esta opção necessita que o &jovie; esteja instalado e configurado com um sintetizador de fala compatível. O <option
>--beep</option
>, o <option
>--play</option
> e o <option
>--play-repeat</option
> não poderão ser indicados com esta opção.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>assunto</replaceable
></option
></entry>
  <entry
>A linha do assunto da mensagem de e-mail. O <option
>--mail</option
> deverá ser indicada com esta opção.</entry>
</row>
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>data/hora</replaceable
></option
></entry>
  <entry
>Dispara o alarme na data ou na data/hora indicadas. Indique uma data sem hora no formato <replaceable
>aaaa-mm-dd [FH]</replaceable
>; por outro lado, indique uma data e hora com <replaceable
>[[[aaaa-]mm-]dd-]hh:mm [FH]</replaceable
> Se não tiver sido escolhido nenhum fuso horário, assume-se o fuso horário do sistema local. Se estiver presente um indicador de fuso-horário <replaceable
>FH</replaceable
>, poderá ser o nome de um fuso horário de sistema (&eg; <userinput
>Europa/Londres</userinput
>), <userinput
>UTC</userinput
> - representando o fuso horário UTC ou <userinput
>Clock</userinput
> para usar o relógio do computador local e ignorar os fusos-horários.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>porcentagem</replaceable
></option
></entry>
  <entry
>Define o volume do áudio para tocar o arquivo de áudio. Esta opção só poderá ser usada quando o <option
>--play</option
> ou o <option
>--play-repeat</option
> forem também usados.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>data/hora</replaceable
></option
></entry>
  <entry
>Repete o alarme até à data ou data/hora indicadas. Indique a data ou data/hora com a mesma sintaxe usada no <option
>--time</option
>. Lembre-se que, se for usada a opção <option
>--time</option
>, o fuso horário será retirado a partir do seu valor e não será incluída nenhum fuso horário no valor <option
>--until</option
>. O <option
>--interval</option
> deverá ser usado, enquanto que o <option
>--repeat</option
> e o <option
>--recurrence</option
> não poderão ser usados, com esta opção.</entry>
</row>
<row>
  <entry
><replaceable
>mensagem</replaceable
></entry>
  <entry
>O texto da mensagem a mostrar ou, se o <option
>--mail</option
> for indicado, o corpo da mensagem de e-mail.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Tanto deverá ser usado um texto de mensagem, o <option
>--file</option
>, o <option
>--exec</option
>, o <option
>--exec-display</option
>, o <option
>--play</option
> ou o <option
>--play-repeat</option
>; exceto nos casos acima indicados, todas as opções são opcionais.</para>

<para
>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:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Lembre-se de\nPARAR"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Lembre-se de \nPARAR"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Outras opções</title>

<para
>As opções a seguir são usadas para executar várias funções, incluindo mostrar a <link linkend="alarm-edit-dlg"
>janela para Editar alarmes</link
>.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opção</entry>
  <entry
>Descrição</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>idEvento</replaceable
></option
></entry>
  <entry
>Mostra a janela de Edição de Alarmes para editar o alarme com o identificador indicado.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Mostra a janela de Edição de Alarmes para editar um novo alarme de áudio.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Mostra a janela de Edição de Alarmes para editar um novo alarme por comando.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Mostra a janela de Edição de Alarmes para editar um novo alarme visível.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Mostra a janela de Edição de Alarmes para editar um novo alarme por e-mail.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>nomeModelo</replaceable
></option
></entry>
  <entry
>Mostra a janela de Edição do Alarme, pré-definida com o modelo de alarme com o nome indicado, para editar um novo alarme.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Apresenta uma lista com os alarmes agendados no <filename
>stdout</filename
>. A lista mostra breves detalhes sobre cada alarme pendente: o seu identificador de recurso (se estiver usando o Akonadi), o UID, a hora do próximo agendamento e o texto ou o arquivo da mensagem.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Mostra o &kalarm; como um ícone na área de notificação.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Desabilitar o monitoramento de todos os alarmes.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="cmdline-help">
<title
>Opções de Ajuda</title>

<para
>As seguintes opções de ajuda são comuns a todos os programas do &kde;:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opção</entry>
  <entry
>Descrição</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Mostra um texto breve de ajuda das opções.</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Mostra várias opções genéricas usadas pelo &Qt;.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Mostra várias opções genéricas usadas pelo &kde;.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Mostra todas as opções.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Mostra os nomes e endereços de e-mail dos autores do &kalarm;.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--version</option
></entry>
  <entry
>Mostra as versões usadas da biblioteca &Qt;, do &kde; e do &kalarm;.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Mostra informações sobre a licença.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

<chapter id="developers">
<title
>Guia de Programador do &kalarm;</title>

<para
>O &kalarm; oferece uma interface para permitir aos outros aplicativos solicitarem as seguintes funções:</para>

<itemizedlist>
<listitem
><para
>agendar um novo alarme</para
></listitem>
<listitem
><para
>cancelar um alarme já agendado</para
></listitem>
<listitem
><para
>disparar um alarme já agendado</para
></listitem>
<listitem
><para
>mostra a janela de Edição do Alarme</para
></listitem>
<listitem
><para
>lista de alarmes agendados</para
></listitem>
</itemizedlist>

<para
>Cada uma das funções acima está implementada através de uma chamada de &DBus; e através da linha de comando. As chamadas do &DBus; deverão ser usadas de preferência se o &kalarm; já estiver em execução.</para>

<sect1 id="dbus-interface">
<title
>Interface &DBus;</title>

<para
>As chamadas de &DBus; descritas neste documento estão todas implementadas no local de &DBus; <constant
>/kalarm</constant
> do &kalarm;. A interface está definida nos arquivos <filename
>org.kde.kalarm.kalarm.xml</filename
> e <filename
>kalarmiface.h</filename
>.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>cancela um alarme já agendado.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>idEvento</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>idEvento</parameter
></term>
<listitem>
<para
>Indica o identificador único do evento a cancelar.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>O <function
>cancelEvent()</function
> é uma chamada de &DBus; para cancelar o alarme indicado. O &kalarm; apaga o alarme do calendário sem mostrá-lo ou executá-lo.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>dispara um alarme já agendado.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>idEvento</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>idEvento</parameter
></term>
<listitem>
<para
>Indica o identificador único do evento a ser disparado.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>O <function
>triggerEvent()</function
> é uma chamada de &DBus; para disparar o alarme indicado (independentemente da hora para que foi agendado). O &kalarm; obtém o alarme do arquivo de calendário e depois mostra-o ou executa-o.</para>

<para
>Se o alarme já tiver sido disparado, o &kalarm; irá então remover todas as ocorrências agendadas do alarme até à hora atual e, se não existirem mais repetições do alarme, ele é removido do calendário. Se ainda não chegou a sua hora, as suas ocorrências agendadas são deixadas sem alterações.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>agenda uma nova mensagem de alarme.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>mensagem</replaceable
>,
                     const QString&amp; <replaceable
>dataHora</replaceable
>,
                     int <replaceable
>cancelarSeAtrasado</replaceable
>,
                     unsigned <replaceable
>opcoes</replaceable
>, 
                     const QString&amp; <replaceable
>corFundo</replaceable
>, 
                     const QString&amp; <replaceable
>corTexto</replaceable
>, 
                     const QString&amp; <replaceable
>tipoLetra</replaceable
>, 
                     const QString&amp; <replaceable
>urlAudio</replaceable
>, 
                     int <replaceable
>Lembrete</replaceable
>, 
                     const QString&amp; <replaceable
>recorrencia</replaceable
>,
                     int <replaceable
>intervaloSubRepeticoes</replaceable
>, 
                     int <replaceable
>numeroSubRepeticoes</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>mensagem</replaceable
>, 
                     const QString&amp; <replaceable
>dataHora</replaceable
>, 
                     int <replaceable
>cancelarSeAtrasado</replaceable
>,
                     unsigned <replaceable
>opcoes</replaceable
>, 
                     const QString&amp; <replaceable
>corFundo</replaceable
>, 
                     const QString&amp; <replaceable
>corTexto</replaceable
>, 
                     const QString&amp; <replaceable
>fonte</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>lembrete</replaceable
>, 
                     int <replaceable
>tipoRecorrencia</replaceable
>, 
                     int <replaceable
>intervaloRecorrencia</replaceable
>, 
                     int <replaceable
>numeroRecorrencia</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>mensagem</replaceable
>, 
                     const QString&amp; <replaceable
>dataHora</replaceable
>, 
                     int <replaceable
>cancelarSeAtrasado</replaceable
>, 
                     unsigned <replaceable
>opções</replaceable
>, 
                     const QString&amp; <replaceable
>corFundo</replaceable
>, 
                     const QString&amp; <replaceable
>corTexto</replaceable
>, 
                     const QString&amp; <replaceable
>fonte</replaceable
>, 
                     const QString&amp; <replaceable
>audioURL</replaceable
>, 
                     int <replaceable
>lembrete</replaceable
>, 
                     int <replaceable
>tipoRecorrencia</replaceable
>, 
                     int <replaceable
>intervaloRecorrencia</replaceable
>, 
                     const QString&amp; <replaceable
>dataFim</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>mensagem</parameter
></term>
<listitem>
<para
>Define o texto da mensagem a ser agendada ou, se as <parameter
>opções</parameter
> tiverem o bit <userinput
>DISPLAY_COMMAND</userinput
> ativo, indica a linha de comando a executar para gerar o texto da mensagem.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dataHoraInicial</parameter
></term>
<listitem>
<para
>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 <quote
>AAAA-MM-DD [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
>AAAA-MM-DDTHH:MM[:SS] [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <quote
>HH:MM[:SS] [Relógio]</quote
> (tal como é devolvido pelo <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>

<para
>Se não tiver sido escolhido nenhum fuso horário, assume-se o fuso horário do sistema local. Se estiver presente um indicador de fuso horário <replaceable
>FH</replaceable
>, poderá ser o nome de um fuso horário de sistema (&eg; <userinput
>Europa/Londres</userinput
>), <userinput
>UTC</userinput
> - representando o fuso horário UTC ou <userinput
>Clock</userinput
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Faz com que o alarme seja cancelado se não puder ser disparado dentro do número de minutos indicado após a hora agendada para o alarme. Se o valor for igual a 0, o alarme não será cancelado, independentemente de quão atrasado estiver.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opções</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> do <filename
>kalarmiface.h</filename
>. Repare que nem todos os bits de opções se aplicam aos alarmes de mensagens.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fundo</parameter
></term>
<listitem>
<para
>Indica a cor de fundo usada para mostrar a mensagem. O texto poderá estar no formato <quote
>#RRGGBB</quote
> (tal como é devolvido pelo <methodname
>QColor::name()</methodname
>) 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 aceitos pelo <methodname
>QColor::setNamedColor()</methodname
>, como o nome de uma cor na base de dados de cores do X (&eg; <quote
>red</quote
> ou <quote
>steelblue</quote
>). Ponha o texto vazio para indicar a cor de fundo padrão atual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>texto</parameter
></term>
<listitem>
<para
>Define a cor do texto para mostrar a mensagem. O formato do texto é o mesmo que o do <parameter
>bgColor</parameter
> ou, em alternativa, poderá ser vazio para usar a cor de texto padrão.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fonte</parameter
></term>
<listitem>
<para
>Define a fonte usada para mostrar a mensagem. O formato do texto é o devolvido pelo <methodname
>QFont::toString()</methodname
>. Coloque o texto vazio para usar a fonte padrão para as mensagens, no momento em que a mensagem for apresentada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>urlAudio</parameter
></term>
<listitem>
<para
>Indica o arquivo de áudio a ser tocado quando for mostrada a mensagem. Configure o valor como nulo se não for para tocar nenhum arquivo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>minutosLembrete</parameter
></term>
<listitem>
<para
>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 lembrete. Indique um valor negativo para um lembrete a ser apresentado após o alarme principal. Indique 0 se não for necessário nenhum lembrete.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está definida no <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Por exemplo, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Estes estão definidos na classe <classname
>KAlarmIface</classname
> no <filename
>kalarmiface.h</filename
>. 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 <parameter
>dataHoraInicial</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervaloRecorrencia</parameter
></term>
<listitem>
<para
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
>tipoRecorrencia</parameter
>) entre repetições do alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroRecorrencias</parameter
></term>
<listitem>
<para
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>intervaloSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrer qualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Descrição</title>
<para
>O <function
>scheduleMessage()</function
> é uma chamada de &DBus; para agendar a mensagem de alarme fornecida para a data e hora indicadas. Possui várias formas possíveis. As forma mais geral permite a indicação de uma recorrência arbitrária para ser indicada &ndash; 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.</para>

<para
>Se a hora agendada (incluindo as repetições) já tiver passado, o &kalarm; mostra imediatamente a mensagem (a menos que o parâmetro <parameter
>cancelarSeAtrasado</parameter
> 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 arquivo do calendário para mostrar posteriormente.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>agendar um novo alarme que mostra o conteúdo de um arquivo de texto ou de imagem.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>dataHora</replaceable
>,
                  int <replaceable
>cancelarSeAtrasado</replaceable
>,
                  unsigned <replaceable
>opcoes</replaceable
>,
                  const QString&amp; <replaceable
>corFundo</replaceable
>,
                  const QString&amp; <replaceable
>urlAudio</replaceable
>,
                  int <replaceable
>minutosLembrete</replaceable
>,
                  const QString&amp; <replaceable
>recorrencia</replaceable
>,
                  int <replaceable
>intervaloSubRepeticoes</replaceable
>, 
                  int <replaceable
>numerSubRepeticoes</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>datahoraInicial</replaceable
>,
                  int <replaceable
>cancelarAtrasado</replaceable
>,
                  unsigned <replaceable
>opções</replaceable
>,
                  const QString&amp; <replaceable
>corFundo</replaceable
>,
                  const QString&amp; <replaceable
>urlAudio</replaceable
>,
                  int <replaceable
>minLembrete</replaceable
>,
                  int <replaceable
>tipoRecorrência</replaceable
>,
                  int <replaceable
>intvRecorrência</replaceable
>,
                  int <replaceable
>contRecorrência</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>datahoraInicial</replaceable
>,
                  int <replaceable
>cancelarAtrasado</replaceable
>,
                  unsigned <replaceable
>opções</replaceable
>,
                  const QString&amp; <replaceable
>corFundo</replaceable
>,
                  const QString&amp; <replaceable
>urlAudio</replaceable
>,
                  int <replaceable
>minLembrete</replaceable
>,
                  int <replaceable
>tipoRecorrência</replaceable
>,
                  int <replaceable
>intervaloRecorrência</replaceable
>,
                  const QString&amp; <replaceable
>datahoraFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
>Indica o arquivo de texto ou imagem cujo conteúdo seja apresentado na mensagem a ser agendada.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dataHoraInicial</parameter
></term>
<listitem>
<para
>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 <quote
>AAAA-MM-DD [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
>AAAA-MM-DDTHH:MM[:SS] [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <quote
>HH:MM[:SS] [Relógio]</quote
> (tal como é devolvido pelo <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>

<para
>Se não tiver sido escolhido nenhum fuso horário, assume-se o fuso horário do sistema local. Se estiver presente um indicador de fuso horário <replaceable
>FH</replaceable
>, poderá ser o nome de um fuso horário de sistema (&eg; <userinput
>Europa/Londres</userinput
>), <userinput
>UTC</userinput
> - representando o fuso horário UTC ou <userinput
>Clock</userinput
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Faz com que o alarme seja cancelado se não puder ser disparado dentro do número de minutos indicado após a hora agendada para o alarme. Se o valor for igual a 0, o alarme não será cancelado, independentemente de quão atrasado estiver.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opções</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> do <filename
>kalarmiface.h</filename
>. Repare que nem todos os bits de aplicam aos alarmes de arquivos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fundo</parameter
></term>
<listitem>
<para
>Indica a cor de fundo usada para mostrar o arquivo. O texto poderá estar no formato <quote
>#RRGGBB</quote
> (tal como é devolvido pelo <methodname
>QColor::name()</methodname
>) 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 aceitos pelo <methodname
>QColor::setNamedColor()</methodname
>, com o nome de uma cor na base de dados de cores do X (&eg; <quote
>red</quote
> ou <quote
>steelblue</quote
>). Ponha o texto vazio para indicar a cor de fundo padrão atual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>urlAudio</parameter
></term>
<listitem>
<para
>Indica o arquivo de áudio a ser tocado quando for mostrada a mensagem. Configure o valor como nulo se não for para tocar nenhum arquivo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>minutosLembrete</parameter
></term>
<listitem>
<para
>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 lembrete. Indique um valor negativo para um lembrete a ser apresentado após o alarme principal. Indique 0 se não for necessário nenhum lembrete.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está definida no <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Por exemplo, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Estes estão definidos na classe <classname
>KAlarmIface</classname
> no <filename
>kalarmiface.h</filename
>. 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 <parameter
>dataHoraInicial</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervaloRecorrencia</parameter
></term>
<listitem>
<para
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
>tipoRecorrencia</parameter
>) entre repetições do alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroRecorrencias</parameter
></term>
<listitem>
<para
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>intervaloSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrer qualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O <function
>scheduleFile()</function
> é uma chamada de &DBus; para agendar o arquivo de texto ou de imagem para a data e hora indicadas. Além de indicar o nome ou &URL; de um arquivo e omitir a cor do texto, a sua utilização é idêntica à do <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - veja a descrição dessa função para mais detalhes.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>agenda um novo alarme que executa um determinado comando.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>linhaComandos</replaceable
>,
                     const QString&amp; <replaceable
>dataHora</replaceable
>,
                     int <replaceable
>cancelarSeAtrasado</replaceable
>,
                     unsigned <replaceable
>opcoes</replaceable
>,
                     const QString&amp; <replaceable
>recorrencia</replaceable
>,
                     int <replaceable
>intervaloSubRepeticoes</replaceable
>, 
                     int <replaceable
>numeroSubRepeticoes</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>linhaComando</replaceable
>,
                     const QString&amp; <replaceable
>datahoraInicial</replaceable
>,
                     int <replaceable
>cancelarAtrasado</replaceable
>,
                     unsigned <replaceable
>opções</replaceable
>,
                     int <replaceable
>tipoRecorrência</replaceable
>,
                     int <replaceable
>intervaloRecorrência</replaceable
>,
                     int <replaceable
>contagemRecorrência</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>linhaComando</replaceable
>,
                     const QString&amp; <replaceable
>datahoraInicial</replaceable
>,
                     int <replaceable
>cancelarAtrasado</replaceable
>,
                     unsigned <replaceable
>opções</replaceable
>,
                     int <replaceable
>tipoRecorrência</replaceable
>,
                     int <replaceable
>intervaloRecorrência</replaceable
>,
                     const QString&amp; <replaceable
>datahoraFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>Linha de comando</parameter
></term>
<listitem>
<para
>Indica o comando cuja execução será agendada. O parâmetro <parameter
>opções</parameter
> indica se este parâmetro contém uma linha de comando ou o nome de um programa.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dataHoraInicial</parameter
></term>
<listitem>
<para
>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 <quote
>AAAA-MM-DD [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
>AAAA-MM-DDTHH:MM[:SS] [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <quote
>HH:MM[:SS] [Relógio]</quote
> (tal como é devolvido pelo <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>

<para
>Se não tiver sido escolhido nenhum fuso horário, assume-se o fuso horário do sistema local. Se estiver presente um indicador de fuso horário <replaceable
>FH</replaceable
>, poderá ser o nome de um fuso horário de sistema (&eg; <userinput
>Europa/Londres</userinput
>), <userinput
>UTC</userinput
> - representando o fuso horário UTC ou <userinput
>Clock</userinput
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Faz com que o alarme seja cancelado se não puder ser disparado dentro do número de minutos indicado após a hora agendada para o alarme. Se o valor for igual a 0, o alarme não será cancelado, independentemente de quão atrasado estiver.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opções</parameter
></term>
<listitem>
<para
>Indica o operador lógico 'OU' das opções desejadas para o alarme. Os bits das opções são os que estão definidos na classe <classname
>KAlarmIface</classname
> do <filename
>kalarmiface.h</filename
>. Lembre-se de que nem todos os bits se aplicam aos alarmes de comando.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está definida no <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Por exemplo, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Estes estão definidos na classe <classname
>KAlarmIface</classname
> no <filename
>kalarmiface.h</filename
>. 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 <parameter
>dataHoraInicial</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervaloRecorrencia</parameter
></term>
<listitem>
<para
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
>tipoRecorrencia</parameter
>) entre repetições do alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroRecorrencias</parameter
></term>
<listitem>
<para
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>intervaloSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrer qualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O <function
>scheduleCommand()</function
> é uma chamada de &DBus; para agendar o comando do console para ser executado na data e hora indicadas. Além de indicar uma linha de comando e de omitir a cor do texto e o parâmetro do arquivo de áudio, a sua utilização é idêntica à do <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - veja a descrição dessa função para mais detalhes.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>agenda um novo alarme que envia uma mensagem de e-mail.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>idRemetente</replaceable
>,
                   const QString&amp; <replaceable
>enderecos</replaceable
>,
                   const QString&amp; <replaceable
>assunto</replaceable
>,
                   const QString&amp; <replaceable
>mensagem</replaceable
>,
                   const QString&amp; <replaceable
>anexos</replaceable
>,
                   const QString&amp; <replaceable
>dataHora</replaceable
>,
                   int <replaceable
>cancelarSeAtrasado</replaceable
>,
                   unsigned <replaceable
>opcoes</replaceable
>,
                   const QString&amp; <replaceable
>recorrencia</replaceable
>,
                   int <replaceable
>intervaloSubRepeticoes</replaceable
>, 
                   int <replaceable
>numeroSubRepeticoes</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>endereços</replaceable
>,
                   const QString&amp; <replaceable
>assunto</replaceable
>,
                   const QString&amp; <replaceable
>mensagem</replaceable
>,
                   const QString&amp; <replaceable
>anexos</replaceable
>,
                   const QString&amp; <replaceable
>datahoraInicial</replaceable
>,
                   int <replaceable
>cancelarAtrasado</replaceable
>,
                   unsigned <replaceable
>opções</replaceable
>,
                   int <replaceable
>tipoRecorrência</replaceable
>,
                   int <replaceable
>intervaloRecorrência</replaceable
>,
                   int <replaceable
>contagemRecorrência</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>fromID</replaceable
>,
                   const QString&amp; <replaceable
>endereços</replaceable
>,
                   const QString&amp; <replaceable
>assunto</replaceable
>,
                   const QString&amp; <replaceable
>mensagem</replaceable
>,
                   const QString&amp; <replaceable
>anexos</replaceable
>,
                   const QString&amp; <replaceable
>datahoraInicial</replaceable
>,
                   int <replaceable
>cancelarAtrasado</replaceable
>, 
                   unsigned <replaceable
>opções</replaceable
>,
                   int <replaceable
>tipoRecorrência</replaceable
>,
                   int <replaceable
>intervaloRecorrência</replaceable
>,
                   const QString&amp; <replaceable
>horaFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>De</parameter
></term>
<listitem>
<para
>A identidade do &kmail; a ser usada como remetente do e-mail. Se estiver vazio, o endereço do remetente do e-mail será o configurado nas <link linkend="preferences-email"
>preferências de e-mail</link
> do &kalarm;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>endereços</parameter
></term>
<listitem>
<para
>Uma lista separada por vírgulas de endereços de e-mail dos destinatários.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>assunto</parameter
></term>
<listitem>
<para
>Indica a linha de assunto da mensagem de e-mail.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>mensagem</parameter
></term>
<listitem>
<para
>Indica o conteúdo da mensagem do e-mail.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>anexos</parameter
></term>
<listitem>
<para
>Uma lista, separada por vírgulas, dos &URL;s dos arquivos a enviar como anexos da mensagem de e-mail.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dataHoraInicial</parameter
></term>
<listitem>
<para
>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 <quote
>AAAA-MM-DD [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
>AAAA-MM-DDTHH:MM[:SS] [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <quote
>HH:MM[:SS] [Relógio]</quote
> (tal como é devolvido pelo <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>

<para
>Se não tiver sido escolhido nenhum fuso horário, assume-se o fuso horário do sistema local. Se estiver presente um indicador de fuso horário <replaceable
>FH</replaceable
>, poderá ser o nome de um fuso horário de sistema (&eg; <userinput
>Europa/Londres</userinput
>), <userinput
>UTC</userinput
> - representando o fuso horário UTC ou <userinput
>Clock</userinput
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Faz com que o alarme seja cancelado se não puder ser disparado dentro do número de minutos indicado após a hora agendada para o alarme. Se o valor for igual a 0, o alarme não será cancelado, independentemente de quão atrasado estiver.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opções</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> do <filename
>kalarmiface.h</filename
>. Repare que nem todos os bits se aplicam aos alarmes por e-mail.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está definida no <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Por exemplo, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Estes estão definidos na classe <classname
>KAlarmIface</classname
> no <filename
>kalarmiface.h</filename
>. 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 <parameter
>dataHoraInicial</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervaloRecorrencia</parameter
></term>
<listitem>
<para
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
>tipoRecorrencia</parameter
>) entre repetições do alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroRecorrencias</parameter
></term>
<listitem>
<para
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>intervaloSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrer qualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O <function
>scheduleEmail()</function
> é uma chamada de &DBus; para agendar o envio da mensagem de e-mail na data e hora indicadas. 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 arquivo de áudio, a sua utilização é idêntica à do <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - veja a descrição dessa função para mais detalhes.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>agenda um novo alarme que executa um determinado comando.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>urlAudio</replaceable
>,
                   int <replaceable
>percentagemVolume</replaceable
>,
                   const QString&amp; <replaceable
>dataHoraInicio</replaceable
>,
                   int <replaceable
>cancelarAtrasado</replaceable
>,
                   unsigned <replaceable
>opções</replaceable
>,
                   const QString&amp; <replaceable
>recorrencia</replaceable
>,
                   int <replaceable
>intervaloSubRepeticoes</replaceable
>, 
                   int <replaceable
>numeroSubRepeticoes</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>urlAudio</replaceable
>,
                   int <replaceable
>percentagemVolume</replaceable
>,
                   const QString&amp; <replaceable
>dataHoraInicio</replaceable
>,
                   int <replaceable
>cancelarAtrasado</replaceable
>,
                   unsigned <replaceable
>opções</replaceable
>,
                   int <replaceable
>tipoRecorrencia</replaceable
>,
                   int <replaceable
>intevaloRecorrencia</replaceable
>,
                   int <replaceable
>numeroRecorrencias</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>urlAudio</replaceable
>,
                   int <replaceable
>percentagemVolume</replaceable
>,
                   const QString&amp; <replaceable
>dataHoraInicio</replaceable
>,
                   int <replaceable
>cancelarAtrasado</replaceable
>,
                   unsigned <replaceable
>opções</replaceable
>,
                   int <replaceable
>tipoRecorrencia</replaceable
>,
                   int <replaceable
>intevaloRecorrencia</replaceable
>,
                   const QString&amp; <replaceable
>dataHoraFim</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>urlAudio</parameter
></term>
<listitem>
<para
>Indica o arquivo de áudio a ser reproduzido.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>percentagemVolume</parameter
></term>
<listitem>
<para
>Define o nível de volume a usar como sendo uma percentagem do volume total. Indique -1 para usar o volume padrão.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dataHoraInicial</parameter
></term>
<listitem>
<para
>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 <quote
>AAAA-MM-DD [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
>AAAA-MM-DDTHH:MM[:SS] [TZ]</quote
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <quote
>HH:MM[:SS] [Relógio]</quote
> (tal como é devolvido pelo <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>

<para
>Se não tiver sido escolhido nenhum fuso horário, assume-se o fuso horário do sistema local. Se estiver presente um indicador de fuso horário <replaceable
>FH</replaceable
>, poderá ser o nome de um fuso horário de sistema (&eg; <userinput
>Europa/Londres</userinput
>), <userinput
>UTC</userinput
> - representando o fuso horário UTC ou <userinput
>Clock</userinput
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lateCancel</parameter
></term>
<listitem>
<para
>Faz com que o alarme seja cancelado se não puder ser disparado dentro do número de minutos indicado após a hora agendada para o alarme. Se o valor for igual a 0, o alarme não será cancelado, independentemente de quão atrasado estiver.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>opções</parameter
></term>
<listitem>
<para
>Indica o operador lógico 'OU' das opções desejadas para o alarme. Os bits das opções são os que estão definidos na classe <classname
>KAlarmIface</classname
> do <filename
>kalarmiface.h</filename
>. Lembre-se de que nem todos os bits se aplicam aos alarmes de comando.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica uma recorrência normal para o alarme, usando a sintaxe do iCalendar que está definida no <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Por exemplo, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recorrência</parameter
></term>
<listitem>
<para
>Indica o tipo de repetição do alarme. Os valores permitidos são MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Estes estão definidos na classe <classname
>KAlarmIface</classname
> no <filename
>kalarmiface.h</filename
>. 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 <parameter
>dataHoraInicial</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>intervaloRecorrencia</parameter
></term>
<listitem>
<para
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
>tipoRecorrencia</parameter
>) entre repetições do alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroRecorrencias</parameter
></term>
<listitem>
<para
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
</listitem>
</varlistentry>

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

<varlistentry>
<term
><parameter
>intervaloSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de minutos entre as sub-repetições do alarme. Indique 0 para não ocorrer qualquer sub-repetição. É ignorado se não for indicada qualquer recorrência.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>numeroSubRepeticoes</parameter
></term>
<listitem>
<para
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O <function
>scheduleAudio()</function
> é uma chamada de &DBus; para agendar o arquivo de áudio indicado a ser reproduzido na data e hora indicadas. Além de indicar o volume e de omitir a cor do texto e o parâmetro do arquivo de áudio, a sua utilização é idêntica à do <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - veja a descrição dessa função para mais detalhes.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>edit</refname>
<refpurpose
>Mostra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> para editar um alarme.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>idEvento</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>idEvento</parameter
></term>
<listitem>
<para
>Indica o identificador único do evento a editar.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Valor devolvido</title>
<para
><returnvalue
>false</returnvalue
>, se o alarme indicado não for encontrado ou for apenas para leitura, caso contrário <returnvalue
>true</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>A <function
>edit()</function
> é uma chamada de &DBus; para mostrar a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
>, para editar o alarme indicado.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Isto mostra a <link linkend="alarm-edit-dlg"
>janela de Edição do Alarme</link
> para editar um novo alarme.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>tipo</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>nomeModelo</replaceable
>)
</synopsis>

<refsect2>
<title
>Parâmetros</title>
<variablelist>
<varlistentry>
<term
><parameter
>tipo</parameter
></term>
<listitem>
<para
>Indica o tipo de alarme. Os valores permitidos são o DISPLAY, COMMAND, EMAIL, AUDIO. Eles estão definidos na classe <classname
>KAlarmIface</classname
> do <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>nomeModelo</parameter
></term>
<listitem>
<para
>Indica o nome de um modelo de alarme no qual basear o novo alarme.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Valor devolvido</title>
<para
><returnvalue
>false</returnvalue
>, se o <parameter
>tipo</parameter
> tiver um valor inválido ou se não existir um modelo com o nome <parameter
>nomeModelo</parameter
>; caso contrário, devolve <returnvalue
>true</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>A <function
>editNew()</function
> é uma chamada de &DBus; para mostrar a <link linkend="alarm-edit-dlg"
>janela de Edição de Alarmes</link
> para poder editar um novo alarme. Se for indicado um tipo de alarme como parâmetro, irá aparecer uma janela em branco. Em alternativa, se o nome de um modelo de alarmes for indicado como parâmetro a janela é preenchida com os detalhes do modelo.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>list</refentrytitle>
</refmeta>
<refnamediv>
<refname
>list</refname>
<refpurpose
>Devolve uma lista com os alarmes agendados.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Valor devolvido</title>
<para
>Uma lista de alarmes, separados por mudanças de linha, cada um no formato <returnvalue
><replaceable
>id_recurso</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>hora</replaceable
> <replaceable
>texto</replaceable
></returnvalue
> (se estiver usando o Akonadi) ou <returnvalue
><replaceable
>UID</replaceable
> <replaceable
>hora</replaceable
> <replaceable
>texto</replaceable
></returnvalue
> (se estiver usando o KResources).</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>

<para
>O <function
>list()</function
> é uma chamada de &DBus; para devolver um texto que contém um resumo dos alarmes agendados. A lista apresenta breves detalhes sobre cada alarme pendente: o seu identificador de recurso (se estiver usando o Akonadi), o UID, a hora do próximo agendamento e o texto ou arquivo da mensagem.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Interface da Linha de Comando</title>

<para
>As opções da linha de comando são disponibilizadas para permitir aos outros programas iniciarem o &kalarm; se não estiver já rodando, para que possam disparar ou cancelar os alarmes agendados ou ainda para agendar alarmes novos. A razão para usar as opções da linha de comando para este fim é que, se o &kalarm; fosse iniciado sem nenhuns parâmetros da linha de comando e lhe fossem então enviados pedidos de &DBus;, ele iria iniciar no seu modo gráfico padrão, o que é claramente indesejável para um pedido entre programas.</para>

<note
><para
>Os programas deverão verificar primeiro se o &kalarm; já está rodando; se estiver, então deverão usar chamadas de &DBus; para efetuar essas operações.</para
></note>

<para
>As opções da linha de comando para agendar um alarme novo são as descritas no capítulo sobre a <link linkend="cmdline-operation"
>Operação com a Linha de Comando</link
>. As opções para disparar e cancelar os alarmes agendados são as seguintes:</para>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opção</entry>
  <entry
>Descrição</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>idEvento</replaceable
></option
></entry>
  <entry
>Cancela o alarme com o ID de evento indicado. O <option
>--triggerEvent</option
> não pode ser indicado com esta opção.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>idEvento</replaceable
></option
></entry>
  <entry
>Dispara o alarme com o identificador de evento indicado. A ação tomada é a mesma da chamada de &DBus; <link linkend="triggerEvent"
>triggerEvent()</link
>. O <option
>--cancelEvent</option
> não pode ser indicado com esta opção.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Exemplos:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299.793</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Perguntas e respostas</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Que arquivos de configuração o &kalarm; utiliza?</para>
</question>
<answer>
<para
>O arquivo <filename
>$KDEHOME/share/config/kalarmrc</filename
> contém as suas preferências do &kalarm;.</para>
<para
>O arquivo <filename
>$KDEHOME/share/config/kresources/alarms/stdrc</filename
> contém a configuração do seu calendário de alarme.</para>

<para
>(a $<envar
>KDEHOME</envar
> é normalmente a <filename class="directory"
>&tilde;/.kde</filename
> ou algo semelhante.)</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Onde o &kalarm; grava os seus alarmes?</para>
</question>
<answer>

<para
>Os nomes dos arquivos de calendários que o &kalarm; cria, da primeira vez que é executado, são os seguintes (se bem que podem ser substituídos por itens da seção <parameter
>General</parameter
> do arquivo de preferências do &kalarm;):</para>

<itemizedlist>
<listitem>
<para
>O <filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
> contém os alarmes ativos (substituído pelo item <parameter
>Calendar</parameter
>).</para>
</listitem>

<listitem>
<para
>O arquivo do calendário que guarda os seus alarmes expirados é o <filename
>$KDEHOME/share/apps/kalarm/expired.ics</filename
> (pode ser substituído pelo item em <parameter
>ExpiredCalendar</parameter
>).</para>
</listitem>

<listitem>
<para
>O <filename
>$KDEHOME/share/apps/kalarm/template.ics</filename
> contém os modelos de alarmes (substituído pelo item <parameter
>TemplateCalendar</parameter
>).</para>
</listitem>
</itemizedlist>

<para
>Você poderá descobrir os arquivos de calendários que estão sendo atualmente usados, vendo os detalhes de cada calendário na lista de calendários de alarmes. Os nomes dos arquivos são gravados no arquivo de configuração do calendário de alarme.</para>

<para
>Os detalhes dos alarmes que estão visíveis atualmente são guardados no arquivo de calendário <filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Em que formato os alarmes são guardados?</para>
</question>
<answer>
<para
>Os arquivos de calendário onde o &kalarm; guarda os seus alarmes são arquivos de texto, cujo formato está definido pelo documento <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. Este é o formato-padrão que é usado em todos os aplicativos do 'kdepim'. O &kalarm; usa certas propriedades fora da norma no componente do Alarme, em relação ao RFC2445. Estas propriedades estão documentadas no arquivo <filename
>DESIGN.html</filename
> que é distribuído com o &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>O que é o programa <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
>O <application
>kalarmautostart</application
> é um pequeno programa auxiliar, cuja função é iniciar automaticamente o &kalarm; no início da sessão.</para>

<para
>O &kalarm; é restaurado normalmente pelo gerenciador de sessões no início de uma sessão (para mostrar de novo as suas janelas no mesmo estado em que estavam antes de encerrar a sessão anterior). Se ele não estava em execução quando encerrou a sessão, não será iniciado pelo gerenciador de sessões, pelo que terá que ser iniciado automaticamente. O problema é que, quando um aplicativo inicia automaticamente e é gerenciado pelo gerenciador de sessões, não há garantia do que irá ocorrer primeiro. Se a inicialização automática aparecer primeiro, irá impedir que o gerenciador de sessões restaure o estado do aplicativo.</para>

<para
>Para evitar este problema, o <application
>kalarmautostart</application
> é iniciado automaticamente no início da sessão, em vez do &kalarm;. Tudo o que ele faz é esperar durante algum tempo (para garantir que o gerenciador de sessões tenha tempo para a sua tarefa) antes de iniciar o &kalarm;, no ponto em que ele termina.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Créditos e licença</title>

<para
>&kalarm; </para>
<para
>Programa com 'copyright' 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 de &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Documentação com 'copyright' 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 de &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Tradução de Marcus Gama <email
>marcus.gama@gmail.com</email
></para
> 
&underFDL; &underGPL; <para
>Os agradecimentos vão para o autor do aplicativo KAlarm do &kde;1, o Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, que permitiu gentilmente o uso do &kalarm; neste aplicativo do &kde;2/&kde;3. </para>

</chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-kalarm">
<title
>Como Obter o &kalarm;</title>
&install.intro.documentation; <para
>O &kalarm; está também disponível como pacote autônomo para o &kde; 2, &kde; 3 e &kde; 4 em <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
> </para>

</sect1>

<sect1 id="requirements">
<title
>Requisitos</title>

<para
>O &kalarm; precisa das bibliotecas normais do &kde; instaladas (o pacote <filename
>kdelibs</filename
> e <filename
>kdepimlibs</filename
>), além do pacote <filename
>kdebase/runtime</filename
>. Para compilar o código-fonte, você também precisa dos pacotes de desenvolvimento do &Qt; e dos outros pacotes de bibliotecas relevantes.</para>

<para
>Os seguintes pacotes opcionais melhoram o &kalarm; na sua execução, se estiverem instalados:</para>

<itemizedlist>
<listitem
><para
>&jovie; (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.</para>
</listitem>
</itemizedlist>

<para
>Você poderá encontrar uma lista das alterações no arquivo <filename
>Changelog</filename
> ou em <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Compilação e instalação</title>

<para
>Se não conseguir encontrar um pacote binário adequado, irá necessitar de compilar você mesmo o &kalarm; a partir dos arquivos de código. Obtenha o pacote do código-fonte <filename
>kdepim-x.x.tar.bz2</filename
> ou o <filename
>kalarm-x.x.tar.bz2</filename
> (ou algo do gênero), dependendo se deseja instalar o &package; ou apenas o &kalarm;. Descomprima-o numa nova pasta com um comando do tipo <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>pacote.tar.bz2</replaceable
></option
></userinput
> e entre na pasta que foi criada.</para>
&install.compile.documentation; <warning
><para
>Se você instalar o &kalarm; em uma pasta diferente da que o &kde; está instalado, ele não rodará corretamente a menos que você torne esta localização conhecida para o &kde;. Para fazer isto, você deve prefixar a variável de ambiente <envar
>KDEDIRS</envar
> com a localização do &kalarm;, toda vez que for iniciar o &kde;.</para>

<para
>Por exemplo, se o &kde; estiver instalado em <literal
>/opt/kde</literal
>, <envar
>KDEDIRS</envar
> deve normalmente estar configurado para <literal
>/etc/opt/kde:/opt/kde</literal
>. Se você instalar o &kalarm; em <literal
>/usr/local</literal
>, você deve configurar o <envar
>KDEDIRS</envar
> para <literal
>/usr/local:/etc/opt/kde:/opt/kde</literal
> antes de iniciar o &kde;.</para
></warning>

<para
>A versão autônoma do &kalarm; tem uma opção de configuração especial que lhe permite selecionar quais os idiomas da documentação instalar, indicando um código do idioma ou uma lista de códigos de idiomas como parâmetro do <command
>./configure</command
>. Por padrão, é instalada a documentação em todas os idiomas disponíveis. Está disponível uma lista com os idiomas da documentação incluídas no pacote, em conjunto com os seus códigos, no arquivo <filename
>DOC-LANGUAGES</filename
>. Lembre-se que isto não fará efeito na escolha das traduções das interfaces do usuário que são instaladas. Por exemplo, para instalar apenas a documentação em Francês e Português Brasileiro:</para>

<para
><userinput
><command
>./configure</command
> --enable-doc-language=<replaceable
>"fr pt_BR"</replaceable
></userinput
></para>

<para
>Observe que esta opção não tem efeito em qual tradução de interface com o usuário será instalada.</para>

</sect1>

<sect1 id="configuration">
<title
>Configuração</title>

<para
>Não é necessária nenhuma configuração especial para configurar o &kalarm; para rodar no ambiente de trabalho do &kde;. Logo que tenha rodado o &kalarm; pela primeira vez, ele irá iniciar sempre que você iniciar uma sessão, para poder monitorar os alarmes agendados.</para>

<para
>Para rodar o &kalarm; num ambiente de trabalho não-&kde;, o requisito principal é garantir que o &kalarm; é executado automaticamente sempre que você iniciar uma sessão. Você poderá obter instruções mais detalhadas no arquivo <filename
>INSTALL</filename
> que é distribuído com o &kalarm;.</para>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->

