<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!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@kde.org</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
><year
>2016</year
><year
>2018</year
><year
>2019</year
><year
>2020</year
><year
>2021</year
><year
>2022</year
><year
>2023</year
><year
>2024</year
><year
>2025</year
><year
>2026</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>09/01/2026</date>
<releaseinfo
>3.13.0 (KDE Gear 26.04)</releaseinfo>

<abstract>
<para
>O &kalarm; é um agendador de mensagens de alarme pessoais, comandos e mensagens eletrônicas do &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
>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, se o sistema de janelas permitir, ela é exibida em cada uma das telas da área de trabalho 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
>Opcionalmente, uma mensagem de alarme pode ser exibida como uma notificação em vez de em uma janela.</para>

<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 alarme sonoro. 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, cores, nomes 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>

<para
>Observe que a coluna <guilabel
>Nome</guilabel
> só existe se o uso de nomes de alarme estiver habilitado na aba <link linkend="preferences-general"
>Geral</link
> da caixa de diálogo de configuração.</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, tipo, nome 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
>Opcionalmente, você pode mostrar o tempo restante até o vencimento de cada alarme, junto com, ou em vez de, o horário programado do alarme.</para>

<para
>Você pode selecionar quais colunas exibir ou ocultar clicando com o botão <mousebutton
>direito</mousebutton
> nos cabeçalhos das colunas e usando o menu de contexto para definir as colunas a serem exibidas. Observe, porém, que pelo menos uma das colunas <guilabel
>Nome</guilabel
> ou <guilabel
>Mensagem, Arquivo ou Comando</guilabel
>, e pelo menos uma das colunas <guilabel
>Hora</guilabel
> ou <guilabel
>Hora até</guilabel
>, são sempre exibidas.</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="datepicker">
<title
>Filtrar a lista de alarmes por data</title>

<para
>Você pode restringir a lista de alarmes para mostrar apenas os alarmes programados para ocorrer em uma data selecionada. Isso é feito por meio do seletor de data do alarme, que pode ser exibido ou ocultado em <menuchoice
><guimenu
>Exibir</guimenu
> <guimenuitem
>Mostrar seletor de data</guimenuitem
> </menuchoice
>. Selecione uma data clicando nela no seletor de data ou desmarque-a clicando nela novamente. O seletor de data exibe um único mês. Para exibir um mês diferente, use as setas de navegação no seletor de data ou a roda do mouse.</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 pré-definir a data do alarme na caixa de diálogo <link linkend="alarm-edit-dlg-time"
>Editar alarme</link
>, clique com o botão direito do mouse na data desejada no seletor de data do alarme (consulte <link linkend="datepicker"
>Filtrando a lista de alarmes por data</link
>) e selecione o tipo de alarme apropriado no menu de contexto.</para>
</listitem>

<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;. 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;. 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;. 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;. 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;. 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;. 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;. 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, ou ignorar temporariamente alarmes individuais.</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-display"
>Exibição 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 dois 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
>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 cópia local dos dados.</para>

<warning
><para
>O &kalarm; não monitora alterações em calendários de alarmes remotos, portanto, se alterações forem feitas por outra pessoa, o &kalarm; poderá sobrescrevê-las. Para evitar isso, recomenda-se adotar uma das seguintes políticas:</para>
<itemizedlist>
<listitem
><para
>Certifique-se de que apenas uma pessoa ou aplicativo acesse o calendário por vez.</para
></listitem>
<listitem
><para
>Todos os usuários, exceto o proprietário do calendário, devem configurar o calendário como somente leitura.</para
></listitem>
</itemizedlist>
<para
>Caso contrário, no mínimo, você deve recarregar o calendário antes de alterá-lo ou confiar em seu conteúdo, usando o método descrito em <link linkend="using-calendars"
>Usando calendários</link
>. Observe também que, se o calendário estiver configurado como leitura e gravação, o &kalarm; o sobrescreverá sempre que um alarme for acionado. </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
>Importar...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importa os alarmes de arquivos de calendário externos 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
>Limpar realce de cor para os alarmes deste calendário na lista de alarmes. A opção só aparece depois que <guimenuitem
>Definir cor</guimenuitem
> tiver sido usado neste calendário.</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ário 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) de arquivos de 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>

<note
><para
>Esta função só está disponível se o <link linkend="akonadi-plugin"
>Plugin do Akonadi</link
> do &kalarm; estiver instalado e ativado.</para>
</note>

<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
>Nome de alarme</title>

<para
>Você pode dar um nome ao alarme no campo <guilabel
>Nome do alarme</guilabel
>. Isso facilita a identificação do alarme. Você não precisa inserir um nome, e ele não precisa ser único.</para>

<para
>Observe que este campo só é exibido se o uso de nomes de alarme estiver ativado. Na aba <link linkend="preferences-general"
>Geral</link
> da caixa de diálogo de configuração.</para>

</sect2>

<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
>Alarme sonoro</guilabel
> para tocar uma campainha.</para>
</listitem>

<listitem>
<para
><guilabel
>Falar</guilabel
> para que a mensagem de alarme seja falada e também exibida. Esta opção só está disponível se o &kalarm; foi compilado com a fala ativada e você tem o módulo &Qt; Speech instalado e funcionando.</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á esmaecer 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
>Esmaecer</guilabel
> e escolha o período no qual isso acontece no campo <guilabel
>Tempo de esmaecimento</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
>A opção <guilabel
>Método de exibição</guilabel
> permite selecionar como o alarme será exibido. Escolha:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Janela</guilabel
> para exibir o alarme em uma janela. Esta opção permite que toda a gama de opções seja usada ao configurar o alarme.</para>
</listitem>

<listitem>
<para
><guilabel
>Notificação</guilabel
> para usar o sistema de notificação padrão para exibir a mensagem de alarme. Devido às limitações do sistema de notificação, as seguintes opções de configuração de alarme não podem ser usadas com notificações: definição de fonte e cor; definição de um arquivo de áudio para reproduzir quando o alarme for exibido; confirmação de reconhecimento do alarme; fechamento automático da tela após o término do tempo de cancelamento tardio.</para>
</listitem>
</itemizedlist>

<para
>Consulte a seção <link linkend="message-display"
>Exibição de mensagens de alarme</link
> para obter mais detalhes sobre como as mensagens de alarme são exibidas.</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
>Normalmente, se o comando 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>

<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. (Observe que o botão só é exibido se o <link linkend="akonadi-plugin"
>plugin Akonadi</link
> do &kalarm; estiver instalado e ativado.) 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 definido no &kmail;.</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á esmaecer 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
>Esmaecer</guilabel
> e escolha o período no qual isso acontece no campo <guilabel
>Tempo de esmaecimento</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 id="alarm-edit-dlg-time">
<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
>Selecione <guilabel
>Fuso horário do sistema</guilabel
> se desejar usar o fuso horário local do computador (qualquer computador em que o &kalarm; esteja sendo executado no momento).</para>
</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 id="alarm-edit-dlg-cancel">
<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 id="alarm-edit-dlg-recur">
<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 diária, verifique cada dia da semana em que o alarme poderá ser acionado. O alarme se repetirá na frequência especificada, mas sempre que for acionado em um dia da semana não selecionado, será suprimido.</para>
</listitem>

<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:</para>
<itemizedlist>
<listitem
><para
>Um dia fixo do mês ou o último dia do mês. Observe que, se você selecionar, por exemplo, o dia 31 do mês, o alarme não será acionado em nenhum mês com menos de 31 dias.</para>
</listitem>

<listitem
><para
>Uma posição no mês, &eg;, a segunda terça-feira ou a última sexta-feira do mês.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Para uma recorrência anual, você pode selecionar um dia fixo do mês ou uma posição no mês, conforme descrito para recorrências mensais. Marque 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>

<note
><para
>As sub-repetições só são acionadas após uma recorrência principal que realmente é acionada. Se uma recorrência principal for suprimida por uma data/hora de exceção ou por restringências de feriado ou horário de trabalho, as sub-repetições para essa instância da recorrência não serão acionadas.</para>

<para
>Sub-repetições individuais também serão suprimidas se ocorrerem em uma data/hora de exceção ou durante feriados ou restrições de horário de trabalho.</para
></note>

<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 id="alarm-edit-dlg-other">
<title
>Outros Controles</title>

<para
>Se a configuração do sistema permitir que vários alarmes despertem o sistema da suspensão, você pode selecionar <guilabel
>Despertar da suspensão</guilabel
> para despertar o sistema caso ele esteja suspenso quando o alarme disparar. Esta função não está disponível para alarmes que exibem apenas a data, pois o horário deles não é definido. Consulte <link linkend="wake-suspend"
>Despertar da suspensão</link
> para obter mais informações.</para>

<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
>Os alarmes de exibição são normalmente suspensos enquanto as notificações são inibidas para a área de trabalho e não são exibidos sobre aplicativos em tela cheia. Para ignorar essas restrições e sempre exibir o alarme, se possível, selecione a caixa de seleção <guilabel
>Nunca inibir alarme</guilabel
>. Observe que a capacidade de exibir mensagens sobre aplicativos em tela cheia pode depender do seu gerenciador de janelas e, atualmente, apenas o sistema de janelas X11 permite isso.</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-display">
<title
>Exibição da mensagem de alarme</title>

<para
>As mensagens de alarme podem ser exibidas em janelas ou como notificações, dependendo da opção escolhida na caixa de diálogo <link linkend="alarm-edit-dlg"
>Editar alarme</link
>. Essas duas opções de exibição são descritas abaixo.</para>

<para
>Se você desativar as notificações para a área de trabalho, a execução dos alarmes de exibição será suspensa até que as notificações sejam reativadas, exceto para os alarmes que você especificou, na <link linkend="alarm-edit-dlg-other"
>janela de Edição de alarmes</link
>, que nunca devem ser desativados. Observe que isso se aplica a todos os alarmes de exibição, independentemente de serem exibidos em janelas ou como notificações.</para>

<para
>Observe que em um sistema de tela única, o gerenciador de janelas pode inibir notificações enquanto qualquer aplicativo estiver em execução em tela cheia, o que suspenderá automaticamente a exibição de alarmes.</para>

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

<para
>As mensagens de alarme exibidas em janelas oferecem a funcionalidade mais completa.</para>

<para
>Quando uma mensagem de alarme chega à sua hora, ela é, se possível, mostrada em todos as telas da área de trabalho e não pode ser coberta pelas janelas normais, para garantir que você a veja. (Observe que apenas o sistema de janelas X11 oferece esse recurso atualmente.) 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 na <link linkend="alarm-edit-dlg-cancel"
>janela 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
>Para exibir as opções de adiar o alarme, clique no botão <guibutton
>Adiar...</guibutton
>. Em seguida, selecione <guilabel
>Adiar por</guilabel
> para inserir quanto tempo depois de agora a mensagem deve ser exibida novamente (o botão <guilabel
>Predefinir</guilabel
> permite selecionar em uma lista de intervalos de tempo comuns), ou selecione <guilabel
>Adiar até</guilabel
> para inserir a data e a hora em que a mensagem deve ser exibida novamente. Por fim, clique em <guibutton
>OK</guibutton
> para adiar a mensagem de alarme e fechar a 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;. Isso exibirá o e-mail e selecionará a pasta que contém o 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 exibe o ícone <guiicon
>&kalarm;</guiicon
> oferece uma maneira conveniente de ativar a janela principal do &kalarm;, com esse alarme destacado.</para>
</listitem>
</itemizedlist>

<para
>A forma como as janelas de mensagens de alarme são exibidas depende do sistema de janelas em uso.</para>

<itemizedlist>
<listitem>
<para
><application
>Sistema de janelas X11</application
></para>

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

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

</listitem>

<listitem>
<para
><application
>Sistema de janelas Wayland</application
></para>

<para
>O sistema de janelas Wayland não permite que os aplicativos controlem a posição ou decoração de suas janelas, portanto, as opções de exibição são muito mais limitadas.</para>

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

</sect2>

<sect2>
<title
>Notificações de mensagem de alarme</title>

<para
>As mensagens de alarme exibidas como notificações oferecem menos funcionalidades do que as exibidas nas janelas.</para>

<para
>Quando uma mensagem de alarme está programada, ela é exibida como uma notificação. A notificação mostra a hora para a qual o alarme foi programado. Se a hora programada do alarme estiver em um fuso horário diferente da configuração do seu computador local, o fuso horário também será exibido. (Para mensagens de lembrete, a data/hora exibida é a do alarme principal ou de sua recorrência, não a hora da mensagem de lembrete, e um cabeçalho "Lembrete" é exibido.)</para>

<para
>A notificação fecha automaticamente após um curto período de inatividade. (Observe que o tempo limite é comum a todos os aplicativos; ele pode ser alterado em &systemsettings;). Após o tempo limite de uma notificação, ela ainda pode ser visualizada no histórico de notificações até que você a remova ou faça logout. Como os aplicativos não têm como acessar o histórico de notificações, o &kalarm; não pode remover ou substituir notificações no histórico como faria com janelas de alarme. Portanto, o histórico pode conter várias notificações para o mesmo alarme, incluindo lembretes e recorrências.</para>

<para
>A notificação de mensagem de alarme oferece as seguintes opções. Observe que selecionar qualquer opção fechará imediatamente a notificação e impedirá que ela seja exibida no histórico de notificações. Observe também que essas opções estão disponíveis apenas enquanto a notificação estiver ativa, antes que ela expire. Se você acessar a notificação posteriormente no histórico de notificações, devido às limitações do sistema de notificações, a única interação disponível será removê-la do histórico.</para>

<itemizedlist>
<listitem>
<para
>Confirme o alarme clicando no botão <guibutton
>Fechar</guibutton
>. Isso fecha a notificação.</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
>Exiba as opções para adiar o alarme clicando no botão <guibutton
>Adiar</guibutton
>. Este botão só é exibido se for possível adiar o alarme. Consulte a descrição da opção de adiamento na seção <link linkend="message-window"
>Janela de Mensagem de Alarme</link
> para obter detalhes.</para>
</listitem>

<listitem>
<para
>Clicar na notificação em qualquer lugar que não seja um botão ativará a janela principal do &kalarm;, com esse alarme destacado.</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>

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

<para
>Por padrão, o &kalarm; exibe um ícone na bandeja do sistema. O ícone fornece controle e indicação do status de monitoramento de alarmes. Um ícone normal do &kalarm; indica que todos os alarmes estão sendo monitorados, enquanto dois ícones modificados diferentes indicam que alguns alarmes, ou todos os alarmes, não estão sendo monitorados. As modificações do ícone dependem do tema de ícones utilizado.</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 &plasma; 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>

<sect2>
<title
>Ignorando alarmes individuais</title>

<para
>Você pode optar por ignorar as próximas (1 a 10) ativações de um alarme. Isso desativa temporariamente o alarme até que esse número de recorrências ou sub-repetições tenha ocorrido sem ativação. O alarme voltará a disparar normalmente depois disso.</para>

<note
><para
>Não serão exibidos lembretes para ativações ignoradas.</para>
<para
>Ignorar o alarme não afeta nenhum adiamento pendente.</para
></note>

<para
>Para ignorar a(s) próxima(s) ativação(ões) de alarmes individuais, faça um dos seguintes procedimentos e, em seguida, insira o número de ativações que deseja ignorar:</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
>Ignorar</guimenuitem
> </menuchoice
>.</para>
</listitem>

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

<para
>Para cancelar o ignorar de alarmes individuais ignorados, faça um dos seguintes procedimentos:</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
>Cancelar ignorar</guimenuitem
> </menuchoice
>.</para>
</listitem>

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

</sect2>
</sect1>

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

<para
>Os alarmes podem ser configurados para ativar o computador da hibernação ou suspensão quando o alarme for acionado, permitindo que a ação do alarme ocorra mesmo quando o sistema estiver desligado. O mecanismo usado pelo &kalarm; para ativar o sistema e a interface do usuário para controlá-lo dependem do tipo de sistema e das permissões do usuário. Existem duas possibilidades:</para>

<sect2>
<title
>Temporizador do kernel Linux para despertar da suspensão</title>

<para
>Em sistemas Linux, se o usuário tiver a capacidade de temporizador de alarme do kernel (<literal
>cap_wake_alarm</literal
>), qualquer número de alarmes pode ser configurado para despertar do modo de suspensão. Nesse caso, o despertar do modo de suspensão é configurado para cada alarme individual na <link linkend="alarm-edit-dlg-other"
>janela de edição de alarme</link
> usando a opção <guilabel
>Despertar do modo de suspensão</guilabel
>.</para>

<para
>Você pode configurar quanto tempo antes do alarme o sistema deve sair do modo de suspensão, para garantir que o sistema tenha tempo de se restaurar completamente antes que o alarme seja acionado, na caixa de diálogo <link linkend="preferences-time"
>Configuração</link
>.</para>

</sect2>

<sect2>
<title
>RTC desperta da suspensão</title>

<para
>Em sistemas não-Linux, ou em sistemas Linux onde o usuário não possui a capacidade <literal
>cap_wake_alarm</literal
>, o alarme do relógio de tempo real (<acronym
>RTC</acronym
>) é utilizado. Isso só pode ser configurado para um alarme por vez. Nesse caso, uma caixa de diálogo especial para despertar da suspensão é usada para configurá-lo. A caixa de diálogo permite que o despertar da suspensão do alarme seja configurado, cancelado ou exibido. Para acessar a caixa de diálogo, selecione <menuchoice
><guimenu
>Ações</guimenu
> <guimenuitem
>Despertar da suspensão</guimenuitem
></menuchoice
>.</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>

</sect2>
</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
>Modo de execução</guilabel
>: Isso permite que você selecione se &kalarm; deve ser executado automaticamente, manualmente ou não.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Executar automaticamente</guilabel
>: Selecione esta opção para executar o &kalarm; automaticamente ao fazer login, garantindo que ele seja sempre executado. Esta opção deve ser selecionada para que o &kalarm; funcione normalmente e sempre dispare alarmes.</para>
</listitem>

<listitem>
<para
><guilabel
>Executar manualmente apenas</guilabel
>: Selecione esta opção se você quiser usar o &kalarm; apenas ocasionalmente. Ele não será executado automaticamente e você precisará executá-lo manualmente quando necessário. Depois de ser encerrado (ou após você sair da sua conta), ele não funcionará mais nem disparará alarmes até que você o execute manualmente novamente.</para>
</listitem>

<listitem>
<para
><guilabel
>Não executar</guilabel
>: Selecione esta opção se quiser parar de usar o &kalarm;. Ele não será mais iniciado ao fazer login e, após ser encerrado ou você fazer logout, não disparará mais alarmes.</para>

<para
>Observe que, se você executar o &kalarm; novamente após selecionar esta opção, o &kalarm; retomará o funcionamento normal e será executado automaticamente ao fazer login. Se você ainda não quiser usar o &kalarm; depois disso, precisará selecionar esta opção <guilabel
>Não executar</guilabel
> mais uma vez.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Avisar antes de sair</guilabel
>: O &kalarm; precisa estar em execução para que os alarmes sejam disparados. Selecione esta opção para que, se você tentar encerrar o &kalarm; usando a opção <menuchoice
><guimenu
>Sair</guimenu
></menuchoice
>, você seja avisado de que os alarmes serão desativados e seja solicitada a confirmação. Isso evita a desativação acidental dos alarmes. Por segurança, esta opção é reativada automaticamente por padrão sempre que você altera o modo de execução.</para>
</listitem>

<listitem
><para
><guilabel
>Habilitar nomes de alarmes</guilabel
>: Especifique se cada alarme pode receber um nome para ajudar na sua identificação. Isso determina se a coluna <guilabel
>Nome</guilabel
> será exibida na <link linkend="alarm-list"
>lista de alarmes</link
> e se o campo <guilabel
>Nome do alarme</guilabel
> aparecerá na <link linkend="alarm-edit-dlg"
>diálogo de edição de alarmes</link
>.</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>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>O nome do &kalarm; no idioma atual será substituído.</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>

<listitem>
<para
><guilabel
>Plugins</guilabel
>: Esta seção permite que você escolha quais dos plugins instalados do &kalarm; usar.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Backend de áudio</guilabel
>: Escolha qual sistema de áudio usar para reproduzir arquivos de som. Apenas os plugins de áudio instalados são listados; se nenhum estiver instalado, esta opção não será exibida.</para>
</listitem>

<listitem
><para
><guilabel
>Habilitar Akonadi</guilabel
>: Escolha se deseja usar o Akonadi para fornecer recursos que dependem dele. Consulte <link linkend="akonadi-plugin"
>Plugin Akonadi</link
> para obter detalhes. Observe que esta opção só é exibida se o plugin Akonadi estiver instalado.</para>
</listitem>
</itemizedlist>
</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
>Acordar da suspensão antes do alarme</guilabel
>: Insira o número de minutos antes do horário de disparo do alarme para que o sistema seja ativado, para alarmes configurados para acordar da suspensão. Isso permite garantir que o sistema tenha tempo para se restaurar completamente antes do alarme ser disparado, para que o alarme possa disparar no momento correto. Esta opção só é exibida se a configuração do sistema permitir que vários alarmes o ativem da suspensão. Consulte <link linkend="wake-suspend"
>Acordar da suspensão</link
> para obter mais informações.</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-recur"
>janela de Edição de 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>

<note
><para
>As opções dependentes de &kmail; só estão disponíveis se o <link linkend="akonadi-plugin"
>Plugin Akonadi </link
> do &kalarm; estiver instalado e ativado.</para>
</note>

<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 automaticamente utilizando o &kmail;.</para>
</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 mensagens enviadas 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
>mensagens enviadas</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 <guilabel
>Usar identidade KMail padrão</guilabel
> para usar seu endereço de e-mail padrão configurado no &kmail;.</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 <guilabel
>Usar identidade KMail padrão</guilabel
> para usar seu endereço de e-mail padrão configurado no &kmail;.</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. As opções disponíveis dependem do sistema de janelas em uso.</para>

<itemizedlist>
<listitem>
<para
><application
>Sistema de janelas X11</application
></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"
>Exibição das mensagens de alarme</link
> para mais detalhes.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><application
>Sistema de janelas Wayland</application
></para>

<itemizedlist>
<listitem>
<para
>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>
</itemizedlist>
</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
>Define o método padrão para exibir mensagens de alarme.</para>
</listitem>

<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 um alarme sonoro 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
>-n</option
>, <option
>--name <replaceable
>nome</replaceable
></option
></entry>
  <entry
>Especifica um nome para ajudar a identificar o alarme.</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Exibe o alarme como uma notificação, não em uma janela. <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> e <option
>--auto-close</option
> não podem ser especificados 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
>Leia a mensagem quando ela for exibida. Esta opção requer que o &kalarm; tenha sido compilado com a fala habilitada e que o módulo &Qt; Speech esteja instalado e funcionando. <option
>--beep</option
>, <option
>--play</option
> e <option
>--play-repeat</option
> não podem ser especificados 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>
<!-- test-set-time time (debug mode)-->
<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
>), ou <userinput
>UTC</userinput
> - representando o fuso horário UTC.</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
>Exibe a caixa de diálogo para editar alarme para editar o alarme com o ID de evento especificado. O ID do evento é o ID exclusivo do evento, opcionalmente prefixado pelo nome de configuração ou ID numérico do recurso que contém o evento, no formato <replaceable
>[ID do recurso:]UID do evento</replaceable
>.</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, 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>

<para
>Veja também:</para>
<simplelist>
<member
>kf6options(7)</member>
<member
>qt6options(7)</member>
</simplelist>

</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
>Especifica o ID exclusivo do evento a ser cancelado, opcionalmente prefixado pelo nome de configuração ou ID numérico do recurso que contém o evento, no formato <replaceable
>[ID do recurso:]UID do evento</replaceable
>.</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
>Especifica o ID exclusivo do evento a ser acionado, opcionalmente prefixado por o nome de configuração ou ID numérico do recurso que contém o evento, no formato <replaceable
>[ID do recurso:]UID do evento</replaceable
>.</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
>nome</replaceable
>,
                     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
>nome</replaceable
>, 
                     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
>nome</replaceable
>, 
                     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
>nome</parameter
></term>
<listitem>
<para
>Especifica um nome opcional para o alarme.</para>
</listitem>
</varlistentry>

<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 <replaceable
>AAAA-MM-DD [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <replaceable
>AAAA-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <replaceable
>HH:MM[:SS]</replaceable
> (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
>), ou <userinput
>UTC</userinput
> - representando o fuso horário UTC.</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 no banco 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
>nome</replaceable
>,
                  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
>nome</replaceable
>,
                  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
>nome</replaceable
>,
                  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
>nome</parameter
></term>
<listitem>
<para
>Especifica um nome opcional para o alarme.</para>
</listitem>
</varlistentry>

<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 <replaceable
>AAAA-MM-DD [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <replaceable
>AAAA-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <replaceable
>HH:MM[:SS]</replaceable
> (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
>), ou <userinput
>UTC</userinput
> - representando o fuso horário UTC.</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 no banco 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
>nome</replaceable
>,
                     const QString&amp; <replaceable
>linhaComando</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 scheduleCommand(const QString&amp; <replaceable
>nome</replaceable
>,
                     const QString&amp; <replaceable
>linhaComando</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 scheduleCommand(const QString&amp; <replaceable
>nome</replaceable
>,
                     const QString&amp; <replaceable
>linhaComando</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
>nome</parameter
></term>
<listitem>
<para
>Especifica um nome opcional para o alarme.</para>
</listitem>
</varlistentry>

<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 <replaceable
>AAAA-MM-DD [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <replaceable
>AAAA-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <replaceable
>HH:MM[:SS]</replaceable
> (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
>), ou <userinput
>UTC</userinput
> - representando o fuso horário UTC.</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
>nome</replaceable
>,
                   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
>nome</replaceable
>,
                   const QString&amp; <replaceable
>idRemetente</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
>nome</replaceable
>,
                   const QString&amp; <replaceable
>idRemetente</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
>nome</parameter
></term>
<listitem>
<para
>Especifica um nome opcional para o alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>idRemetente</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 <replaceable
>AAAA-MM-DD [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <replaceable
>AAAA-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <replaceable
>HH:MM[:SS]</replaceable
> (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
>), ou <userinput
>UTC</userinput
> - representando o fuso horário UTC.</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
>nome</replaceable
>,
                   const QString&amp; <replaceable
>urlAudio</replaceable
>,
                   int <replaceable
>porcentagemVolume</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
>nome</replaceable
>,
                   const QString&amp; <replaceable
>urlAudio</replaceable
>,
                   int <replaceable
>porcentagemVolume</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
>nome</replaceable
>,
                   const QString&amp; <replaceable
>urlAudio</replaceable
>,
                   int <replaceable
>porcentagemVolume</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
>nome</parameter
></term>
<listitem>
<para
>Especifica um nome opcional para o alarme.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>urlAudio</parameter
></term>
<listitem>
<para
>Indica o arquivo de áudio a ser reproduzido.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>porcentagemVolume</parameter
></term>
<listitem>
<para
>Define o nível de volume a usar como sendo uma porcentagem 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 <replaceable
>AAAA-MM-DD [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Para um alarme com data e hora, o texto deverá estar no formato <replaceable
>AAAA-MM-DDTHH:MM[:SS] [TZ]</replaceable
> (tal como é devolvido pelo <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) ou em <replaceable
>HH:MM[:SS]</replaceable
> (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
>), ou <userinput
>UTC</userinput
> - representando o fuso horário UTC.</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
>Especifica o ID exclusivo do evento a ser editado, opcionalmente prefixado pelo nome de configuração ou ID numérico do recurso que contém o evento, no formato <replaceable
>[ID do recurso:]UID do evento</replaceable
>.</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
></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, 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 especificado. O ID de evento é o ID exclusivo do evento, opcionalmente prefixado pelo ID do recurso que contém o evento, no formato <replaceable
>[resourceID:]eventUID</replaceable
>. A ação realizada é a mesma que para a chamada <link linkend="cancelEvent"
>cancelEvent()</link
> &DBus;. <option
>--triggerEvent</option
> não pode ser especificada com esta opção.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>idEvento</replaceable
></option
></entry>
  <entry
>Acione o alarme com o ID de evento especificado. O ID de evento é o ID exclusivo do evento, opcionalmente prefixado pelo ID do recurso que contém o evento, no formato <replaceable
>[IDrecurso:]UIDevento</replaceable
>. A ação realizada é a mesma que para a chamada <link linkend="triggerEvent"
>triggerEvent()</link
> &DBus;. <option
>--cancelEvent</option
> não pode ser especificada 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>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Que arquivos de configuração o &kalarm; utiliza?</para>
</question>
<answer>
<para
>A configuração do &kalarm; está armazenada nos seguintes arquivos na pasta <command
>qtpaths --paths GenericConfigLocation</command
> :</para>

<itemizedlist>
<listitem>
<simpara
>O <filename
>kalarmrc</filename
> mantém suas preferências do &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
>O <filename
>kalarmresources</filename
> contém a lista de calendários de alarmes atualmente usados ​​pelo &kalarm;.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

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

<para
>Quando o comando &kalarm; é executado pela primeira vez, ele cria os seguintes calendários de alarme na pasta <command
>qtpaths --paths GenericDataLocation</command
>:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
>, que armazena os alarmes ativas.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
>, que armazena os alarmes arquivados.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
>, que armazena os modelos de alarme.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
>, que é um arquivo de calendário especial para armazenar detalhes dos alarmes que estão sendo exibidos no momento, o que permite que o &kalarm; quando reiniciado, exiba novamente os alarmes que estavam sendo exibidos quando foi parado pela última vez.</simpara>
</listitem>
</itemizedlist>

<para
>Você pode substituir esses calendários posteriormente, exceto <filename
>displaying.ics</filename
>, ou criar calendários de alarme adicionais em qualquer local que você escolher. Você pode descobrir quais arquivos de calendário estão em uso no momento visualizando os detalhes de cada calendário na lista de calendários de alarme.</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-kalarmcalendar.html</filename
> que é distribuído com o &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Qual é a função do plugin Akonadi da &kalarm;?</para>
</question>
<answer>
<para
>O &kalarm; usa seu plugin Akonadi para fornecer todos os recursos que dependem do &akonadi; (o serviço de armazenamento entre desktops do &kde; &PIM;). Se este plugin não estiver instalado e ativado, o &kalarm; não terá os seguintes recursos: <itemizedlist>
<listitem>
<simpara
>Envio de emails via &kmail;, deixando &Sendmail; como a única opção para enviar emails (consulte <link linkend="preferences-email"
>Preferências de email</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Arrastar e soltar e e-mails.</simpara>
</listitem>
<listitem>
<simpara
>Seleção de endereços de e-mail do &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Importar aniversários do &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Migração de recursos do calendário de alarmes do &akonadi; na primeira execução de uma nova versão do &kalarm;.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Se o plugin estiver instalado, ele pode ser ativado ou desativado na aba <link linkend="preferences-general"
>Geral</link
> da caixa de diálogo de configuração.</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>

<qandaentry>
<question>
<para
>Como posso usar o &kalarm; em um ambiente de trabalho que não seja o &plasma;?</para>
</question>
<answer>
<para
>Para rodar o &kalarm; num ambiente de trabalho não-&plasma;, 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>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

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

<para
>&kalarm; </para>
<para
>Direitos autorais do programa 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Direitos autorais da documentação 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2016, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026 &David.Jarvie; &David.Jarvie.mail; </para>

<para
>Tradução de Marcus Gama <email
>marcus.gama@kde.org</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>

&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:
-->

