2
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
3
<!ENTITY kappname "&kalarm;">
4
<!ENTITY package "kdepim">
5
<!ENTITY % addindex "IGNORE">
6
<!ENTITY % Brazilian-Portuguese "INCLUDE"
7
><!-- change language only here -->
10
<!-- The language must NOT be changed here. -->
12
<book lang="&language;">
16
>Manual do &kalarm;</title>
26
>&David.Jarvie.mail;</address>
30
<othercredit role="developer"
37
>&David.Jarvie.mail;</address
40
>Desenvolvimento</contrib>
43
<othercredit role="translator"
51
>marcus.gama@gmail.com</email
84
>&David.Jarvie;</holder>
88
>&FDLNotice;</legalnotice>
90
<!-- Don't change format of date and version of the documentation -->
95
>2.07.00 (&kde; 4.7)</releaseinfo>
99
>O &kalarm; é um agendador de mensagens de alarme pessoais, comandos e mensagens eletrônicas para o &kde;.</para>
121
<chapter id="introduction">
126
>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>
129
>No seu modo gráfico padrão, o &kalarm; mostra a lista de alarmes pendentes, apresentando as suas horas e os seus detalhes. Você pode criar novos alarmes ou selecionar alarmes existentes para modificar ou remover. Poderá ainda, opcionalmente, ver os alarmes que expiraram.</para>
132
>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>
135
>Os alarmes também podem ser agendados a partir da linha de comando, ou através de chamadas &DBus; de programas.</para>
138
>Quando uma mensagem de alarme atinge a sua hora, é mostrada em cada uma das telas do &kde; para garantir que você a veja. A janela da mensagem mostra a hora para a qual o alarme foi agendado. Tem normalmente uma opção de adiamento para lhe perguntar se o alarme deverá ser mostrado novamente mais tarde. Um exemplo de uma mensagem de alarme:</para>
142
>Captura de tela da janela de mensagem do &kalarm;</screeninfo>
145
<imagedata fileref="alarmmessage.png" format="PNG"/>
149
>Mensagem de alarme</phrase>
155
>Quando o alarme tem atribuído um comando para executar ou uma mensagem eletrônica para enviar, o &kalarm; não mostra nada.</para>
158
>O &kalarm; mostra normalmente um ícone na área de notificação, ainda que ele possa ficar oculto, se desejar.</para>
162
<chapter id="using-kalarm">
164
>Usando o &kalarm;</title>
167
>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>
171
>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>
175
<imagedata fileref="spinbox.png" format="PNG"/>
180
<sect1 id="alarm-types">
182
>Tipos de Alarme</title>
185
>As funções básicas, disponíveis nos diferentes tipos de alarmes que o &kalarm; oferece, são:</para>
190
>Os alarmes visíveis apresentam uma mensagem de texto escrita por você, o conteúdo de um arquivo de texto ou de imagem, ou ainda o resultado textual de um comando que é executado quando o alarme for disparado. Além de mostrar um destes itens, poderão também reproduzir arquivos de áudio, sintetizar o seu texto ou emitir um simples apito. Você poderá também indicar os comandos a executar antes e depois da mensagem de alarme ser apresentada.</para>
195
>Os comandos de alarme executam um comando ou um programa indicado por você. Não é apresentado nada, a menos que ocorra algum erro.</para>
200
>Os alarmes por e-mail enviam um e-mail. Nada é apresentado, a menos que ocorra algum erro.</para>
205
>Os alarmes de áudio tocam um arquivo de som. Nada é apresentado, a menos que ocorra algum erro.</para>
211
>Tratamento de Erros</title>
214
>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>
217
>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>
222
<sect1 id="alarm-list">
224
>Lista de Alarmes</title>
227
>A janela principal do &kalarm; mostra a lista atual de alarmes pendentes, mostrando as suas horas, intervalos de repetição e textos de mensagens, os nomes dos arquivos a apresentar, os comandos a executar ou os assuntos das mensagens de e-mail. (Para um alarme recorrente ou um alarme com um lembrete, a hora apresentada é a sua próxima hora agendada). Um ícone que se encontra à esquerda de cada texto/arquivo/comando/assunto de e-mail do alarme indica o seu tipo.</para>
231
>Captura de tela da janela principal do &kalarm;</screeninfo>
234
<imagedata fileref="mainwindow.png" format="PNG"/>
238
>Janela principal</phrase>
244
>Para um alarme repetitivo, a lista mostra a sua próxima hora de ativação e o seu intervalo básico de repetição (⪚ <quote
246
> para uma repetição diária, <quote
248
> para uma repetição disparada na Segunda e na Quarta na terceira semana e o <quote
250
> para um alarme que se repete depois do login).</para>
253
>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"
254
>Tratamento de Erros</link
257
<sect2 id="listappear">
259
>Alterar a Aparência da Lista de Alarmes</title>
262
>Os alarmes poderão ser ordenados por data/hora, intervalo de repetição, cor ou texto clicando-se na barra de título da coluna apropriada. Para inverter o critério de ordenação, clique no título da coluna novamente.</para>
265
>Você poderá, opcionalmente, mostrar o tempo restante até que cada alarme dispare, em conjunto com ou em vez da hora agendada do alarme. Para mostrar ou ocultar a coluna da hora do alarme, selecione <menuchoice
269
>Mostrar Horas dos Alarmes</guimenuitem
271
>. Para mostrar ou ocultar a coluna com o tempo que falta até disparar os alarmes, selecione a opção <menuchoice
275
>Mostrar a Tempo Até Os Alarmes</guimenuitem
277
>. Pelo menos uma destas colunas é sempre visível.</para>
280
>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.</para>
286
>Alarmes Arquivados</title>
289
>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"
290
>janela de Configuração</link
294
>Os alarmes arquivados poderão ser mostrados na lista de alarmes se selecionar a opção <menuchoice
298
>Mostrar os Alarmes Arquivados</guimenuitem
300
>. Para ocultá-los novamente, desligue a opção <menuchoice
304
>Mostrar os Alarmes Arquivados</guimenuitem
312
>Procurar na Lista de Alarmes</title>
315
>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
319
>Procurar...</guimenuitem
321
>. 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
325
>Procurar o Próximo</guimenuitem
331
>Procurar o Anterior</guimenuitem
336
>A procura é efetuada da seguinte forma:</para>
341
>Alarmes de texto: é pesquisado o texto da mensagem.</para>
346
>Alarmes de arquivos: é pesquisado o local/&URL; do arquivo.</para>
351
>Alarmes de comandos: é pesquisada a linha de comando ou o programa.</para>
356
>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>
361
>Alarmes de áudio: é pesquisado o local/&URL; do arquivo.</para>
367
>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 exibí-los como foi descrito na seção acima.</para
372
<sect1 id="create-edit">
374
>Criar e Manipular Alarmes</title>
378
>Criar um Novo Alarme</title>
381
>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"
382
>janela de Edição do Alarme</link
383
> através da qual irá configurar o alarme.</para>
388
>Selecione <menuchoice
399
>Clique com o botão <mousebutton
400
>direito</mousebutton
401
> no ícone da área de notificação e escolha <menuchoice
403
>Novo Alarme</guimenuitem
405
> no menu de contexto.</para>
410
>Clique com o &RMB; na lista de alarmes e escolha <menuchoice
414
> no menu de contexto.</para>
419
>Em alternativa, você poderá criar alarmes novos pré-configurados a partir de várias fontes:</para>
424
>Para basear o seu novo alarme num modelo previamente definido, siga as instruções na seção de <link linkend="templates"
425
>Modelos de Alarmes</link
431
>Para basear o seu alarme num existente, escolha o alarme existente e selecione a opção <menuchoice
437
>. Isto abre a <link linkend="alarm-edit-dlg"
438
>janela de Edição do Alarme</link
439
> já preenchida com uma cópia dos detalhes do alarme selecionado.</para>
444
>Para criar um alarme novo que mostre uma mensagem de e-mail existente, arraste a mensagem do &kmail; para a janela principal do &kalarm; ou para o seu ícone na área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
445
>janela de Edição do Alarme</link
446
> com a mensagem de e-mail completa (com o remetente, o destinatário, &etc;) como texto do alarme.</para>
451
>Para criar um novo alarme que mostre uma mensagem de e-mail existente, arraste a mensagem do &kmail; para a janela principal do &kalarm; ou para o seu ícone na área de notificação. Depois, selecione a opção <guilabel
453
>. Isto abre a <link linkend="alarm-edit-dlg"
454
>janela de Edição do Alarme</link
455
> com a mensagem de e-mail completa (com o remetente, o destinatário, etc.) como texto do alarme.</para>
460
>Para criar um novo alarme que mostre um resumo de um item por-fazer existente, arraste esse item do &korganizer; ou de outro aplicativo para a janela principal do &kalarm; ou para o seu ícone na área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
461
>janela de Edição do Alarme</link
462
> com o conteúdo do item por-fazer como texto do alarme.</para>
467
>Arrastar um pedaço de texto para a janela principal do &kalarm; ou para o ícone da área de notificação irá abrir a <link linkend="alarm-edit-dlg"
468
>janela de Edição do Alarme</link
469
> e configurar o texto do alarme.</para>
474
>Para criar um alarme de visualização de um arquivo, arraste um texto ou o &URL; da imagem para a janela principal do &kalarm; ou para o ícone da área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
475
>janela de Edição do Alarme</link
476
> e configura o nome do arquivo.</para>
481
>Para criar um alarme de áudio, arraste um &URL; do mesmo para a janela principal do &kalarm; ou para o ícone da área de notificação. Isto abre a <link linkend="alarm-edit-dlg"
482
>janela de Edição do Alarme</link
483
> e configura o nome do arquivo.</para>
488
>Você poderá criar automaticamente alarmes para os aniversários das pessoas que estejam no &kaddressbook;, como é descrito em <link linkend="birthdays"
489
>Importar os Aniversários do &kaddressbook;</link
497
<sect2 id="edit-alarm">
499
>Modificar um Alarme Existente</title>
502
>Para modificar um alarme pendente já existente (os alarmes expirados não poderão ser corrigidos), faça uma das seguintes coisas:</para>
507
>Clique duas vezes no seu item na lista de alarmes.</para>
512
>Selecione-o, clicando no item respectivo na lista de alarme. Depois selecione a opção <menuchoice
523
>Clique com o &RMB; no seu item da lista de alarmes e escolha a opção <menuchoice
527
> no menu de contexto.</para>
532
>Isto mostra a <link linkend="alarm-edit-dlg"
533
>janela de Edição do Alarme</link
540
>Apagar/Reativar um alarme</title>
543
>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>
548
>Selecione <menuchoice
558
>Clique com o botão <mousebutton
559
>direito</mousebutton
560
> nos itens desejados na lista de alarmes e escolha a opção <menuchoice
564
> do menu de contexto.</para>
568
>Para excluí-los sem qualquer mensagem de confirmação, digite &Shift;-<keycap
575
>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"
576
>janela de Configuração</link
577
> 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>
580
>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"
581
>Alarmes Arquivados</link
587
>Selecione um ou mais alarmes expirados, clicando nos respectivos itens na lista de alarmes. Depois, escolha a opção <menuchoice
591
>Reativar</guimenuitem
597
>Clique com o botão <mousebutton
598
>direito</mousebutton
599
> nos itens desejados na lista de alarmes e escolha a opção <menuchoice
601
>Reativar</guimenuitem
603
> do menu de contexto.</para>
611
>Ativar/Desativar um Alarme</title>
614
>Veja a <link linkend="enable-disable"
615
>Ativação/Desativação dos Alarmes</link
616
> para saber como ativar e desativar os alarmes, quer individualmente quer como um todo.</para>
622
>Configurar um alarme para acordar da suspensão</title>
625
>Veja em <link linkend="wake-suspend"
626
>Acordar da suspensão</link
627
> como configurar um alarme para reativar o seu sistema a partir da suspensão ou hibernação.</para>
633
>Aceitar um Alarme</title>
636
>Veja a seção da <link linkend="message-window"
637
>Janela da Mensagem do Alarme</link
638
> para ver como aceitar os alarmes.</para>
642
<sect2 id="templates">
644
>Modelos de Alarme</title>
647
>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, à partir da hora de início.</para>
650
>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"
651
>janela de Edição do Alarme</link
652
> e inserir então a data e hora.</para>
655
>Para criar um alarme com base num modelo, abra a <link linkend="alarm-edit-dlg"
656
>janela de Edição do Alarme</link
657
>, pré-definida com os detalhes do modelo:</para>
662
>Selecione a opção <menuchoice
666
>Novo a Partir de Modelo</guimenuitem
668
>, selecionando depois o modelo desejado.</para>
673
>Clique com o botão <mousebutton
674
>direito</mousebutton
675
> do mouse no ícone da área de notificação e escolha a opção <menuchoice
677
>Novo Alarme de Modelo</guimenuitem
679
> no menu de contexto. Depois, selecione o modelo desejado.</para>
684
>Abra a <link linkend="alarm-edit-dlg"
685
>janela de Edição do Alarme</link
686
> da forma normal e clique no botão <guibutton
687
>Carregar um Modelo...</guibutton
688
> para selecionar um modelo a ser usado.</para>
694
>Configurar os Modelos</title>
697
>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>
700
>Para criar um novo modelo de alarme, execute uma das seguintes operações:</para>
705
>Exiba a janela de Modelos de Alarmes, selecionando a opção do menu <menuchoice
709
>Modelos...</guimenuitem
711
> clicando no botão <guibutton
713
>, escolhendo depois o tipo de alarme na lista que aparece. Isto irá mostrar uma janela de Edição do Modelo em branco.</para>
718
>Exiba a janela de Modelos de Alarmes, selecionando a opção do menu <menuchoice
722
>Modelos...</guimenuitem
724
>, selecione um modelo existente e clique em <guibutton
726
>. Isto abre a janela de Edição do Modelo já preenchida com uma cópia dos detalhes do modelo selecionado.</para>
731
>Selecione um alarme na lista e escolha a opção <menuchoice
735
>Criar um Modelo...</guimenuitem
737
>. Isto abre a janela de Edição do Modelo já preenchida com uma cópia dos detalhes do alarme selecionado.</para>
742
>Para modificar um modelo existente, abra a janela de Modelos de Alarmes, selecionando a opção <menuchoice
746
>Modelos...</guimenuitem
748
> e clique em <guibutton
750
>. Isto irá mostrar a janela de Edição do Modelo, a qual é descrita abaixo.</para>
753
>Para remover os modelos existentes, exiba o diálogo de Modelos de Alarmes, selecionando a opção <menuchoice
757
>Modelos...</guimenuitem
759
>, selecione um ou mais modelos e clique em <guibutton
761
>. É apresentada uma mensagem de confirmação para evitar remoções acidentais.</para>
767
>Janela de Edição do Modelo</title>
770
>A janela de Edição do Modelo é semelhante à <link linkend="alarm-edit-dlg"
771
>janela de Edição do Alarme</link
772
>. Só os seguintes controles são diferentes:</para>
777
>Insira o nome do modelo no campo <guilabel
778
>Nome do modelo</guilabel
779
>. É 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>
786
>, selecione uma das seguintes opções:</para>
792
>Hora padrão</guilabel
793
> 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>
798
>Assinale a <guilabel
800
> para indicar a hora em que o alarme será disparado.</para>
806
>Apenas a data</guilabel
807
> para indicar que o alarme só deverá ter uma data, sem nenhuma hora.</para>
812
>Assinale o <guilabel
813
>Tempo a partir de agora</guilabel
814
> 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>
821
>No grupo da <guilabel
822
>Regra de Recorrência</guilabel
823
> da página <guilabel
824
>Recorrência</guilabel
825
>, não é necessário escolher nenhum dia ou mês para as recorrências semanais ou anuais, respectivamente.</para>
833
<sect2 id="calendars">
835
>Calendários de Alarme</title>
838
>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
839
>calendários de alarmes</quote
840
> para dizer ao &kalarm; para usar outros calendários adicionais por padrão ou por substituição.</para>
843
>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>
847
>Captura de tela da janela principal do &kalarm; mostrando a lista de calendários</screeninfo>
850
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
854
>A janela principal mostrando a lista de calendários</phrase>
861
>Tipos e Opções do Calendário</title>
864
>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>
869
>Tipo de alarme</term>
872
>Os três tipos de entidades de alarmes – alarmes ativos, alarmes arquivados ou expirados e modelos de alarmes – 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"
873
>Perguntas e Respostas</link
874
> para mais detalhes), os quais você poderá alterar se desejar.</para>
880
>Tipo de armazenamento</term>
883
>O &kalarm; lida com três tipos de armazenamento dos calendários de alarmes:</para>
888
>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"
889
>Perguntas e Respostas</link
890
> para mais detalhes). Os <quote
891
>arquivos locais</quote
892
>, 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
899
>Pasta local: Os alarmes são gravados numa pasta local, sendo cada um dos alarmes gravado num arquivo iCalendar separado, dentro da pasta. Este método de armazenamento tem a vantagem de, no caso de corrupção do arquivo, você só irá perder um alarme, em vez de perder todo o calendário.</para>
904
>Arquivo remoto: Os alarmes são gravados num único arquivo remoto, no formato iCalendar. Este método de armazenamento permite-lhe acessar aos seus dados de alarmes de forma remota, independentemente do local onde esteja ou então ativa os calendários dos alarmes, de modo a serem vistos por outras pessoas. Ao usar os arquivos remotos, o &kalarm; funciona com uma 'cache' local dos dados.</para>
908
>Se um determinado calendário de alarmes remoto estiver compartilhado entre os usuários, as alterações feitas por uma pessoa poderão não ser disponibilizadas automaticamente para outro usuário, ou então poderá ocorrer um atraso de tempo antes do outro usuário vê-las. Assim, um usuário poderá fazer uma alteração que será substituída por outro usuário, sem as outras pessoas notarem as alterações. A razão técnica para isto acontecer é que uma alteração feita pela pessoa A só ficará disponível para a pessoa B, após a cópia em 'cache' do A ter sido gravada para o arquivo remota, até que a cópia local da pessoa B seja atualizada. Se e quando o calendário é gravado, depende dos parâmetros de configuração do calendário que cada usuário terá definido para esse calendário de alarmes.</para>
911
>As formas de evitar este problema incluem o ajuste dos parâmetros de configuração da gravação e atualização do calendário, bem como a adoção de uma política em que os usuários, com exceção do dono do calendário, possam abrir os dados apenas para leitura.</para
920
>Estado de ativado/desativado</term>
923
>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>
929
>Estado apenas para leitura</term>
932
>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>
935
>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>
940
>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>
945
>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>
950
>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>
955
>Se você não tiver permissões para escrever no arquivo ou pasta do calendário.</para>
960
>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
962
>Importar...</guimenuitem
964
> do último calendário (veja em <link linkend="import"
965
>Importar os Alarmes dos Calendários Externos</link
972
>Estado padrão do calendário</term>
975
>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"
976
>janela de Configuração</link
986
>Usar os Calendários</title>
989
>Você poderá ver e manipular os calendários na lista de calendários, que poderá aparecer ou ser oculta com a opção <menuchoice
993
>Mostrar os Calendários</guimenuitem
995
>. 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
996
>direito</mousebutton
997
> no calendário apropriado da lista, escolhendo em seguida um item do menu de contexto. As ações disponíveis são:</para>
1004
>Adicionar...</guimenuitem
1009
>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>
1017
>Remover</guimenuitem
1022
>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>
1030
>Editar...</guimenuitem
1035
>Edita o calendário selecionado. Isto mostra a janela de configuração do calendário selecionado.</para>
1043
>Recarregar</guimenuitem
1048
>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>
1052
>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
1061
>Salvar</guimenuitem
1066
>Salva as alterações no calendário selecionado. O calendário é atualizado com as alterações de alarmes que tiverem ocorrido desde a última vez que o calendário foi gravado ou atualizado. Isto só é útil para os calendários remotos, uma vez que os calendários locais são salvos automaticamente, após cada uma das alterações. Você poderá configurar quando e como deseja salvar automaticamente um calendário remoto, usando a sua janela de configuração (com a opção do menu de contexto <menuchoice
1068
>Editar...</guimenuitem
1074
>Se você salvar um calendário remoto que seja compartilhado com outros usuários, todas as alterações que eles tenham feito, desde a última vez que você carregou o calendário (automaticamente ou manualmente), serão perdidas.</para
1083
>Importar...</guimenuitem
1088
>Importa os alarmes de um arquivo de calendário externo para o calendário selecionado. Isto está descrito na seção <link linkend="import"
1089
>Importar os Alarmes de Calendários Externos</link
1090
>. Esta opção não está disponível para os calendários desativados ou apenas para leitura.</para>
1098
>Exportar...</guimenuitem
1103
>Exporta todos os alarmes do calendário selecionado para um arquivo de calendário externo. Isto está descrito na seção <link linkend="export"
1104
>Exportar os Alarmes para Calendários Externos</link
1105
>. Esta opção não está disponível para os calendários desativados.</para>
1113
>Mostrar detalhes</guimenuitem
1118
>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>
1126
>Usar como Padrão</guimenuitem
1131
>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>
1139
>Definir cor...</guimenuitem
1144
>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>
1152
>Limpar cor</guimenuitem
1157
>Limpa o realce de cores para os alarmes deste calendário na lista de alarmes.</para>
1168
>Importar Alarmes de Calendários Externos</title>
1171
>Você poderá importar os alarmes a partir de outros arquivos de calendários para o &kalarm;. A função de importação verifica o arquivo de calendário selecionado, à procura de eventos que contenham alarmes, copiando-os (com novos identificadores únicos) para o calendário do &kalarm;. Os eventos sem alarmes, bem como os outros tipos de itens do calendário, serão ignorados. Existem duas formas de importar os alarmes:</para>
1176
>Selecione a opção <menuchoice
1180
>Importar Alarmes...</guimenuitem
1182
> para importar os alarmes de vários tipos (alarmes ativos, arquivados e modelos de alarmes) do calendário.</para>
1185
>Se você tiver configurado os <link linkend="calendars"
1186
>calendários de alarmes</link
1187
>, 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"
1188
>janela de Configuração</link
1194
>Clique com o botão <mousebutton
1195
>direito</mousebutton
1196
> num calendário da lista e escolha a opção <menuchoice
1198
>Importar...</guimenuitem
1200
> 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>
1206
>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 – 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
1213
>Exportar Alarmes para Calendários Externos</title>
1216
>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
1217
>Adicionar a um arquivo existente</guilabel
1218
> na janela de seleção dos arquivos; caso contrário, todos os arquivos existentes serão substituídos.</para>
1223
>Para exportar os alarmes atualmente selecionados na lista, clique com o botão <mousebutton
1224
>direito</mousebutton
1225
> na seleção e escolha <menuchoice
1227
>Exportar...</guimenuitem
1229
> no menu de contexto, ou use então a opção <menuchoice
1233
>Exportar os Alarmes Selecionados...</guimenuitem
1235
> no menu principal.</para>
1240
>Para exportar todos os alarmes de um calendário, clique com o botão <mousebutton
1241
>direito</mousebutton
1242
> num calendário da lista, e escolha <menuchoice
1244
>Exportar...</guimenuitem
1246
> no menu de contexto.</para>
1252
<sect2 id="birthdays">
1254
>Importar Aniversários do &kaddressbook;</title>
1257
>Você poderá configurar os alarmes para os aniversários que estão registrados no &kaddressbook;, através da opção <menuchoice
1261
>Importar Aniversários...</guimenuitem
1263
>. Isto exibe um diálogo que lhe permitirá escolher os aniversários para os quais deseja criar alarmes.</para>
1269
>Texto do Alarme</guilabel
1270
>, 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
1272
> seguido do nome da pessoa e do texto do <guilabel
1274
>. Não é adicionado nenhum espaço, por isso lembre-se de incluir os espaços necessários no <guilabel
1282
>Se você alterar o texto do alarme, a lista de seleção dos aniversários será avaliada novamente.</para
1289
>Selecionar Aniversários</guilabel
1290
>, 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
1291
>Texto do Alarme</guilabel
1297
>Os controles restantes são os mesmos dos exibidos para os alarmes de <guilabel
1299
> na <link linkend="alarm-edit-dlg"
1300
>janela de Edição do Alarme</link
1306
>Se você tiver configurado os <link linkend="calendars"
1307
>calendários de alarmes</link
1308
>, 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"
1309
>janela de Configuração</link
1316
>Desfazer / Refazer</title>
1319
>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>
1322
>Para anular a última modificação, selecione a opção <menuchoice
1326
>Desfazer</guimenuitem
1328
>. Para repetir a última alteração que foi anulada, selecione a opção <menuchoice
1332
>Refazer</guimenuitem
1337
>Para anular uma modificação que não a última, clique no botão <guibutton
1338
>Desfazer</guibutton
1339
> 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>
1342
>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
1349
<sect1 id="alarm-edit-dlg">
1351
>A janela de Edição do Alarme</title>
1354
>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
1355
>Mais Opções</guibutton
1356
>; para reverter para a janela simplificada, clique no botão <guibutton
1357
>Menos Opções</guibutton
1358
>. O &kalarm; recorda sempre a sua última escolha apresentada, sempre que a janela de Edição do Alarme voltar a ser apresentada.</para>
1361
>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"
1362
>página de Editar da janela de configuração</link
1367
>Imagem da janela simplificada de Edição do Alarme</screeninfo>
1370
<imagedata fileref="editwindow-simple.png" format="PNG"/>
1374
>A janela simplificada de Edição do Alarme para um alarme visível</phrase>
1378
>A janela simplificada de Edição do Alarme para um alarme visível</para
1385
>Imagem da janela de Edição do Alarme com todas as opções</screeninfo>
1388
<imagedata fileref="editwindow.png" format="PNG"/>
1392
>A janela de Edição de Alarmes para um alarme visível com todas as opções</phrase>
1396
>A janela de Edição de Alarmes para um alarme visível com todas as opções</para
1403
>Ação do Alarme</title>
1406
>Os controles no grupo <guilabel
1408
> poderão variar de acordo com o tipo de alarme a ser editado.</para>
1412
>Alarmes Visíveis</title>
1415
>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>
1422
> para inserir o texto da mensagem de alarme (o qual poderá conter várias linhas) no campo de texto.</para>
1428
>Conteúdo do arquivo</guilabel
1429
> 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
1431
> não está disponível para este tipo de alarme.</para>
1437
>Resultado do comando</guilabel
1438
> 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"
1439
>Alarmes por Comando</link
1440
> para saber mais detalhes sobre como inserir o comando ou o programa a executar.</para>
1445
>Os controles disponíveis para os alarmes visíveis são:</para>
1452
> permite-lhe selecionar se deseja disparar um alarme sonoro quando a mensagem de alarme for apresentada. Escolha:</para>
1459
> para mostrar o alarme silenciosamente.</para>
1466
> para soar uma campainha.</para>
1473
> para que a mensagem de alarme seja sintetizada, assim como é apresentada. Esta opção só estará disponível se você tiver o &jovie; (do pacote 'kdeaccessibility') instalado e configurado, em conjunto com um sintetizador de fala compatível, ⪚ o <application
1474
>Festival</application
1481
>Arquivo de som</guilabel
1482
> 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>
1485
>Na janela do Arquivo de Som:</para>
1490
>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>
1495
>Assinale o <guilabel
1497
> 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>
1502
>Assinale o <guilabel
1504
> e ajuste a barra deslizante se quiser ajustar o volume com que o arquivo de áudio é tocado.</para>
1509
>Se desejar, você poderá desvanescer o volume. Isto significa que o arquivo de som começa a ser reproduzido com um determinado volume e vai mudando gradualmente para o volume final, dentro de um determinado intervalo de tempo específico. O volume final é o que será inserido no <guilabel
1511
> acima. Para ativar a variação gradual, assinale a opção <guilabel
1512
>Desvanescer</guilabel
1513
> e escolha o período no qual isso acontece no campo <guilabel
1514
>Tempo de desvanecimento</guilabel
1515
> e ajuste a barra do <guilabel
1516
>Volume inicial</guilabel
1523
>Você poderá usar o botão <guibutton
1525
> para testar os níveis de som selecionados.</para
1533
>Use o botão do <guibutton
1534
>Fonte & Cor...</guibutton
1535
> para selecionar um tipo de fonte ou uma cor de texto ou de fundo para a mensagem de alarme. Na janela para <guilabel
1536
>Escolher o Tipo de Fonte e Cor do Alarme</guilabel
1537
>, assinale a opção <guilabel
1538
>Usar a fonte padrão</guilabel
1539
> 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"
1540
>janela de Configuração</link
1541
>.) Para selecionar um tipo de fonte específico para a mensagem, desligue a opção <guilabel
1542
>Usar a fonte padrão</guilabel
1546
>As cores selecionadas são apresentadas no campo de texto da mensagem de alarme.</para>
1551
>Use o botão <guibutton
1552
>Ações Especiais...</guibutton
1553
> para especificar os comandos a executar antes ou depois da apresentação do alarme. No diálogo das <guilabel
1554
>Ações Especiais de Alarme</guilabel
1560
>No campo de <guilabel
1561
>Ação pré-alarme</guilabel
1562
>, 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>
1565
>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
1567
> é executada em nenhuma das seguintes circunstâncias:</para>
1572
>Quando é apresentada um lembrete.</para
1576
>Quando a mensagem volta a ser apresentada após adiar o alarme.</para
1580
>Quando a mensagem foi apresentada na hora em que você se deslogou e é restaurada quando você se logar.</para
1584
>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
1589
>A ação pré-alarme pode ser usada para controlar se deseja mostrar a mensagem do alarme:</para>
1594
>Assinale a opção <guilabel
1595
>Cancelar o alarme em caso de erro</guilabel
1596
> 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
1601
>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
1602
>Não notificar os erros</guilabel
1610
>No campo da <guilabel
1611
>Ação pós-alarme</guilabel
1612
>, insira um comando de console a ser executado sempre que o alarme for aceito (quer ao clicar em <guibutton
1614
> quer usando o botão para fechar na barra de título da janela). <emphasis
1616
> é executada em nenhuma das seguintes circunstâncias:</para>
1621
>Quando um lembrete é fechado.</para
1625
>Quando você adiar o alarme, exceto quando o alarme adiado for finalmente aceito.</para
1629
>Quando a mensagem de alarme for fechada por ter saído da sessão.</para
1636
>Veja a descrição dos <link linkend="command-alarm"
1637
>Alarmes de Comandos</link
1638
> abaixo para saber os detalhes com que os comandos são executados.</para>
1644
<sect3 id="command-alarm">
1646
>Alarmes de comando</title>
1649
>Os alarmes por comandos executam um comando sem mostrar qualquer mensagem de alarme.</para>
1653
>Este tipo de alarme não está disponível se o &kde; estiver rodando em modo quiosque.</para
1657
>Quando o comando é executado, a variável de ambiente <envar
1659
> contém o UID do evento para o alarme. Lembre-se que, quando o comando é executado com o botão <guibutton
1661
> da janela de edição do alarme, o <envar
1663
> 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>
1666
>Os controles disponíveis para os alarmes de comandos são:</para>
1672
>Inserir um programa</guilabel
1673
> permite-lhe escolher se deseja inserir um comando de console ou um programa.</para>
1676
>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
1678
>) e pode incluir quaisquer opções, parâmetros, comandos via 'pipes', &etc;, sendo tudo permitido numa única linha de comando.</para>
1681
>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
1682
>#!/bin/bash</literal
1683
> para garantir que o interpretador de comandos correto é invocado.</para>
1688
>Use o grupo do <guilabel
1689
>Resultado do Comando</guilabel
1690
> para indicar o que deseja fazer com o resultado para o terminal que o comando produza enquanto for executado.</para>
1695
>Assinale a opção <guilabel
1696
>Executar numa janela de terminal</guilabel
1697
> 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"
1698
>janela de Configuração</link
1704
>Assinale a opção <guilabel
1705
>Registrar num arquivo</guilabel
1706
> 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>
1711
>Assinale a opção <guilabel
1713
> para ignorar o resultado do comando.</para>
1722
>Alarmes por E-Mail</title>
1725
>Os alarmes por e-mail enviam um e-mail sem mostrar qualquer mensagem de alarme.</para>
1728
>Preencha os endereços dos destinatários, a linha do assunto da mensagem e o corpo da mesma nos três campos de texto. Use o botão ao lado do campo dos endereçados para mostrar o seu livro de endereços do &kde;, no qual poderá selecionar os destinatários da mensagem. Os anexos poderão ser adicionados com o botão <guibutton
1729
>Adicionar...</guibutton
1730
>. 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
1735
>Configure as seguintes opções:</para>
1742
> 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
1744
> na <link linkend="preferences-email"
1745
>janela de Configuração</link
1746
> estiver configurado para <guilabel
1747
>Usar as identidades do &kmail;</guilabel
1748
>. Caso contrário, o seu endereço de e-mail estará pré-definido na <link linkend="preferences-email"
1749
>janela de Configuração</link
1750
>, tornando esta opção inútil.</para>
1755
>Assinale a opção <guilabel
1756
>Copiar o e-mail para o próprio</guilabel
1757
> 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"
1758
>janela de Configuração</link
1759
>, sendo o valor padrão o seu endereço de e-mail, tal como está definido na Configuração do Sistema do &kde;.</para>
1767
>Alarmes de Áudio</title>
1770
>Os alarmes de áudio tocam um arquivo de áudio sem mostrar qualquer mensagem de alarme.</para>
1773
>Configure as seguintes opções:</para>
1778
>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>
1783
>Assinale a opção <guilabel
1785
> para repetir de forma contínua o arquivo de áudio, até que a opção <guilabel
1786
>Parar a Reprodução</guilabel
1787
> seja selecionada. Para parar a reprodução do arquivo, selecione a opção do menu <menuchoice
1791
>Parar a Reprodução</guimenuitem
1793
> ou clique com o botão <mousebutton
1794
>direito</mousebutton
1795
> do mouse no ícone da área de notificação e selecione a opção <menuchoice
1797
>Parar a Reprodução</guimenuitem
1799
> no menu de contexto. Se o desejar, você poderá definir uma tecla de atalho para esta ação.</para>
1804
>Assinale o <guilabel
1806
> e ajuste a barra deslizante se quiser ajustar o volume com que o arquivo de áudio é tocado.</para>
1811
>Se desejar, você poderá desvanescer o volume. Isto significa que o arquivo de som começa a ser reproduzido com um determinado volume e vai mudando gradualmente para o volume final, dentro de um determinado intervalo de tempo específico. O volume final é o que será inserido no <guilabel
1813
> acima. Para ativar a variação gradual, assinale a opção <guilabel
1814
>Desvanescer</guilabel
1815
> e escolha o período no qual isso acontece no campo <guilabel
1816
>Tempo de desvanecimento</guilabel
1817
> e ajuste a barra do <guilabel
1818
>Volume inicial</guilabel
1830
>Se o alarme for recorrente e se foi adiado depois de ter sido mostrado pela última vez, o grupo <guilabel
1831
>Alarme Adiado</guilabel
1832
> mostra a hora para a qual o alarme foi adiado. O <guibutton
1833
>Modificar...</guibutton
1834
> mostra um diálogo que lhe permite alterar a hora do adiamento ou cancelá-lo.</para>
1843
>No grupo da <guilabel
1851
>Na data/hora</guilabel
1852
> se quiser inserir a data e hora em que o alarme será disparado. Assinale a opção <guilabel
1853
>A qualquer hora</guilabel
1854
> 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"
1855
>Configurar o &kalarm;</link
1856
> descreve como configurar a hora do início do dia.)</para>
1859
>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>
1865
>Tempo a partir de agora</guilabel
1866
> para indicar quanto tempo ficará à espera (em horas e minutos) até que o alarme seja disparado.</para>
1871
>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>
1874
>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"
1875
>janela de Configuração</link
1876
> ou se clicar no botão <guibutton
1877
>Fuso horário...</guibutton
1883
>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"
1884
>janela de Configuração</link
1885
>, o qual será o seu fuso horário, a menos que o tenha alterado.</para>
1890
>Assinale a opção <guilabel
1891
>Ignorar o fuso horário</guilabel
1892
> se quiser usar a hora do computador do local (no computador em que o &kalarm; esteja rodando), ignorando os fusos horários.</para>
1896
>Recomenda-se que não use esta opção se o alarme tiver uma repetição definida em horas e minutos; se o fizer, o alarme poderá ocorrer em horas inesperadas, depois das mudanças de horário de verão.</para
1908
>Para um alarme visível, assinale a <guilabel
1910
> 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 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>
1914
>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
1918
>Se o alarme se repetir, assinale a opção <guilabel
1919
>Lembrete apenas para a primeira recorrência</guilabel
1920
> 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>
1927
>Cancelamento</title>
1930
>As opções de cancelamento posterior determinam como um alarme é tratado após a sua hora agendada:</para>
1936
>Cancelar se atrasado</guilabel
1937
> indica o que acontece se o alarme não puder ser disparado à hora agendada.</para>
1940
>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>
1944
>O atraso nos alarmes apenas de datas, &ie; aqueles para os quais a opção <guilabel
1945
>A qualquer hora</guilabel
1946
> estiver selecionada, é calculado a partir da hora do início do dia da data agendada para o alarme.</para
1950
>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>
1954
>Um alarme só poderá ser disparado enquanto você estiver logado e tanto o X como o &kalarm; estiverem em execução.</para
1960
>Assinale a opção <guilabel
1961
>Fechar automaticamente a janela após este período</guilabel
1962
> 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>
1970
>Recorrência</title>
1973
>Indique quando e como o alarme deverá ser repetido com a página de <guilabel
1974
>Recorrência</guilabel
1979
>A característica básica de repetição do alarme é mostrada por conveniência na página de <guilabel
1980
>Recorrência</guilabel
1981
>. O intervalo de repetição, tal como está configurado na página de <guilabel
1982
>Recorrência</guilabel
1983
>, é mostrado em primeiro lugar, seguido do intervalo de todas as sub-repetições, configurado com o botão de <guibutton
1984
>Sub-Repetição</guibutton
1989
>No grupo da <guilabel
1990
>Regra de Recorrência</guilabel
1991
>, indique o tipo de recorrência ou o período de tempo da seguinte forma:</para>
1996
>Para disparar o alarme somente uma vez, selecione <guilabel
1997
>Sem recorrência</guilabel
2003
>Selecione <guilabel
2005
> 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
2010
>Para que o alarme se repita em intervalos regulares, selecione um dos tipos de períodos e insira depois no campo <guilabel
2011
>Recorrência a cada</guilabel
2012
> quantos períodos de tempo deverão passar entre cada repetição. Por exemplo, para repetir em cada quinzena, você poderá selecionar <guilabel
2013
>Diariamente</guilabel
2014
> e indicar um valor igual a 14 ou selecione <guilabel
2015
>Semanalmente</guilabel
2016
> e introduza um valor igual a 2. Dependendo do tipo de período de tempo selecionado, você poderá ter outras opções:</para>
2021
>Para uma recorrência semanal, assinale cada dia da semana em que deseja ativar o alarme.</para>
2026
>Para uma recorrência mensal, você poderá tanto indicar uma data fixa como uma posição (⪚ a segunda terça-feira).</para>
2031
>Para uma recorrência anual, tanto poderá escolher um dia fixo do mês ou uma posição dentro de um mês (⪚ o último Sábado de Maio). Assinale cada mês do ano em que deseja ativar o alarme.</para>
2034
>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
2035
>Alarme do 29 de Fevereiro nos anos não-bissextos</guilabel
2043
>: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos, mas será suprimido nos outros anos.</para>
2049
>28 de Fevereiro</guilabel
2050
>: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos e a 28 de Fevereiro nos outros anos.</para>
2056
>1 de Março</guilabel
2057
>: o alarme irá ocorrer a 29 de Fevereiro nos anos bissextos e a 1 de Março nos outros anos.</para>
2065
>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
2072
>No grupo do <guilabel
2073
>Fim da Recorrência</guilabel
2074
>, configure a amplitude temporal de recorrência global da seguinte forma:</para>
2079
>Selecione <guilabel
2081
> para continuar as repetições indefinidamente.</para
2086
>Selecione <guilabel
2087
>Acabar ao fim de</guilabel
2088
> para indicar o número total de ocorrências do alarme.</para
2093
>Selecione <guilabel
2094
>Acabar em</guilabel
2095
> 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>
2099
>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
2107
> 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
2108
>Mais Opções</guibutton
2114
>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
2115
>Adicionar</guibutton
2116
>. Para alterar uma exceção, selecione-a na lista, insira a nova data à direita e clique em <guibutton
2117
>Modificar</guibutton
2118
>. Para remover uma exceção, selecione-a na lista e clique em <guibutton
2125
>Você poderá restringir um alarme para não ocorrer nos feriados, se assinalar a opção <guilabel
2126
>Excluir os feriados</guilabel
2127
>. 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"
2128
>janela de Configuração</link
2134
>Você poderá restringir um alarme para ocorrer apenas durante o horário de trabalho, se assinalar a opção <guilabel
2135
>Só durante o horário de trabalho</guilabel
2136
>. 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"
2137
>janela de Configuração</link
2144
>Sub-Repetição</title>
2147
>Você poderá também usar o botão de <guibutton
2148
>Sub-Repetição</guibutton
2149
> para configurar uma repetição dentro de outra repetição. Neste caso, sempre que chegar a hora de um alarme, tal como foi indicado na página de <guilabel
2150
>Recorrência</guilabel
2151
>, em vez de ser disparado uma vez, será disparado repetidamente, de acordo com a sua indicação de repetição simples. Por exemplo, para configurar um alarme que se repita a todas as horas, desde o meio-dia até às 6 da tarde de todas as quintas-feiras, você poderia usar a página de <guilabel
2152
>Recorrência</guilabel
2153
> para configurar uma repetição semanal às Quintas e ao meio-dia e usar a janela de Repetição Simples para indicar um intervalo de 1 hora e uma quantidade igual a 7 ou uma duração de 6 horas.</para>
2156
>Na janela de Sub-Repetição que aparece quando você clica no botão <guibutton
2157
>Sub-Repetição</guibutton
2158
>, assinale a opção <guilabel
2159
>Repetir a cada</guilabel
2160
> para configurar uma repetição ou desligue-a para remover as repetições. Se a opção <guilabel
2161
>Repetir a cada </guilabel
2162
> estiver assinalada, configure a repetição da seguinte forma:</para>
2167
>Insira o intervalo de tempo entre as repetições nas opções ao lado de <guilabel
2168
>Repetir a cada</guilabel
2169
>. Selecione as unidades de tempo desejadas (⪚ <guilabel
2171
>) e insira então o número de unidades.</para>
2176
>Especifique o número de repetições ou a sua duração:</para>
2181
>Selecione o <guilabel
2182
>Número de vezes</guilabel
2183
> 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>
2188
>Selecione a <guilabel
2190
> 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
2200
>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
2208
>Outros Controles</title>
2211
>Para os alarmes visíveis, a opção <guilabel
2212
>Confirmar a recepção</guilabel
2213
> 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>
2216
>Selecione a opção <guilabel
2217
>Mostrar no &korganizer;</guilabel
2218
> 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>
2222
>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
2226
>Clique no botão <guibutton
2227
>Carregar um Modelo</guibutton
2228
> para selecionar um modelo com o qual preencher a janela, tal como descrito em <link linkend="create-edit"
2229
>Criar e Manipular Alarmes</link
2233
>Clique no botão <guibutton
2235
> para exibir o alarme e verificar se funciona corretamente. O alarme é executado da mesma forma como se tivesse sido agendado da forma normal.</para>
2238
>Clique no botão <guibutton
2240
> quando todos os detalhes estiverem corretos para adicionar o alarme à lista agendada. Lembre-se que, ao editar um alarme existente, o botão <guibutton
2242
> fica desativado enquanto não fizer nenhuma alteração.</para>
2247
<sect1 id="message-window">
2249
>Janela de Mensagem de Alarme</title>
2252
>Quando uma mensagem de alarme chega à sua hora, é mostrada em todos as telas do &kde; e não pode ser coberta pelas janelas normais, para garantir que você a veja. A janela da mensagem mostra a hora para a qual o alarme foi agendado, para que você possa ver quando aparecer se estava ausente nessa hora. (Para as mensagens de lembrete, todavia, a data/hora mostrada é a do alarme principal ou da sua repetição, não é a hora do lembrete, e o seu título é <quote
2257
>As mensagens de alarmes ficam visíveis até que você as confirme, a menos que a opção <guilabel
2258
>Fechar automaticamente a janela após o período de cancelamento</guilabel
2259
> esteja assinalada no <link linkend="alarm-edit-dlg"
2260
>diálogo de Edição de Alarmes</link
2261
>. 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>
2264
>A janela da mensagem de alarme contém as opções que a seguir, desde que aplicadas ao alarme apresentado:</para>
2269
>Confirmar o alarme clicando o botão <guibutton
2271
>. Isto fecha a janela (depois de um pedido de confirmação, se você selecionou a opção <guilabel
2272
>Confirmar a recepção</guilabel
2278
>Edite o alarme, clicando no botão <guibutton
2279
>Editar...</guibutton
2280
>. Isto mostra a <link linkend="alarm-edit-dlg"
2281
>janela de Edição do Alarme</link
2287
>Mostrar as opções para adiar o alarme para mais tarde, clicando no botão <guibutton
2288
>Adiar...</guibutton
2289
>. Depois selecione a opção <guilabel
2290
>Adiar para a data/hora</guilabel
2291
> de modo a inserir a data e hora em que a mensagem deverá ser mostrada de novo ou selecione o <guilabel
2292
>Adiar durante o intervalo de tempo</guilabel
2293
> para inserir em que tempo a partir de agora (em horas e minutos) é que a mensagem deverá ser mostrada de novo. Depois, clique em <guibutton
2295
> para remeter a mensagem de alarme mais tarde e fechar a sua janela.</para>
2299
>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
2300
>Adiar...</guibutton
2301
> na janela da mensagem de alarme e o botão de <guibutton
2303
> na janela de adiamento, ficam desativados um minuto antes da próxima ocorrência ou lembrete de antecipação.</para>
2305
>Lembre-se que, se estiver configurado um lembrete <emphasis
2307
> o alarme, você <emphasis
2309
> adiar o alarme para depois da sua hora do lembrete. Nesse caso, o lembrete será suprimido.</para
2315
>Adiar...</guibutton
2316
> não está disponível para os alarmes que são apresentados após o login, devido ao fato da opção <guilabel
2317
>Repetir após login</guilabel
2318
> ter sido selecionada.</para
2324
>Pare de tocar o arquivo de som do alarme, clicando no botão que mostra o símbolo para <quote
2325
>parar de tocar</quote
2331
>Se a mensagem do alarme foi criada ao arrastar um e-mail do &kmail;, você poderá acessar diretamente ao &kmail;, clicando no botão que mostra o ícone do &kmail;. Isto irá selecionar e realçar a mensagem de e-mail na lista de pastas do &kmail;.</para>
2335
>Se os índices do &kmail; forem gerados novamente, a ligação à mensagem de e-mail do &kmail; será perdida.</para
2341
>O botão que mostra o ícone do <guiicon
2343
> oferece uma forma conveniente de ativar o &kalarm;.</para>
2348
>Você também poderá escolher, na <link linkend="preferences-view"
2349
>janela de Configuração</link
2350
>, quais dos dois diferentes modos a usar nas janelas de mensagens de alarme:</para>
2355
>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>
2360
>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>
2366
>Quando for apresentado um alarme acima de um aplicativo em tela cheia, ele aparece como uma janela não-modal, independentemente desta opção de configuração. Isto deve-se a uma limitação do sistema de janelas.</para
2371
>Posicionamento das Janelas de Mensagens</title>
2374
>Você poderá escolher, na <link linkend="preferences-view"
2375
>janela de Configuração</link
2376
>, qual dos dois esquemas usar para posicionar as janelas de mensagens de alarmes:</para>
2381
>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>
2386
>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>
2391
>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
2395
>Espalhar as Janelas</guimenuitem
2397
>. Se desejar, poderá configurar uma tecla de atalho global para esta ação.</para>
2402
<sect1 id="system-tray">
2404
>Operação na área de notificação</title>
2407
>O &kalarm; poderá ser executado como um ícone na área de notificação. Este ícone oferece tanto uma indicação do estado como o controle do monitoramentodos alarmes. Uma janela normal do &kalarm; indica que os alarmes estão sendo monitorados, enquanto que um ícone em cinza indica que os alarmes não estão sendo monitorados. Se alguns dos alarmes individuais estiverem desativados, irá aparecer uma pequena cruz sobre o ícone.</para>
2410
>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"
2411
>janela de Configuração</link
2415
>Clique com o &LMB; no ícone da área de notificação para ocultar ou mostrar a janela principal do &kalarm;.</para>
2418
>Clique com o &RMB; no ícone da área de notificação para mostrar o seu menu de contexto:</para>
2425
>Habilitar alarmes</guimenuitem
2431
>Ativa ou desativa a monitoração dos alarmes.</action
2434
>Veja a <link linkend="enable-disable"
2435
>Ativação/Desativação dos Alarmes</link
2436
> para mais detalhes.</para>
2444
>Novo Alarme</guimenuitem
2450
>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
2459
>Novo Alarme a Partir de Modelo</guimenuitem
2465
>Mostra a lista de modelos de alarmes em um menu. Quando selecionar um deles, a janela de Edição do Alarme irá aparecer, preenchida previamente com os detalhes desse modelo.</action
2474
>Parar a Reprodução</guimenuitem
2480
>Interrompe a reprodução do arquivo de áudio atualmente em curso.</action
2489
>Espalhar as janelas</guimenuitem
2495
>Espalha as janelas de mensagens de alarmes e erros pela tela, ou então volta a agrupá-las de novo.</action
2504
>Configurar o &kalarm;...</guimenuitem
2510
>Mostra a janela de Configuração do &kalarm;.</action
2513
>A janela de Configuração está descrita em <link linkend="preferences"
2514
>Configurar o &kalarm;</link
2515
>. Ela inclui as opções relacionadas com o ícone da área de notificação para o &kalarm;.</para>
2523
>Restaurar / Minimizar</guimenuitem
2529
>Restaura ou minimiza a janela principal do &kalarm;.</action
2544
>Fecha o ícone da área de notificação e as janelas principais do &kalarm;.</action
2547
>Sai do &kalarm; quando não estiverem apresentadas janelas de mensagens de alarme.</para>
2554
>Mostrando o &kalarm; na área de notificação</title>
2557
>Você deverá estar rodando o ambiente de trabalho &kde; ou outro gerenciador de janelas adequado para mostrar o &kalarm; na área de notificação.</para>
2560
>Para mostrar o &kalarm; na área de notificação, selecione <menuchoice
2564
>Mostrar na área de notificação</guimenuitem
2569
>Para remover o &kalarm; da área de notificação, desligue a opção <menuchoice
2573
>Mostrar na área de notificação</guimenuitem
2578
>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"
2580
> da janela de Configuração.</para>
2584
<sect1 id="refreshing">
2586
>Atualizar os Alarmes</title>
2589
>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
2593
>Atualizar os Alarmes</guimenuitem
2595
>. Isto fará com que o &kalarm; carregue novamente todos os arquivos e calendários de alarmes.</para>
2598
>Você pode recarregar um calendário específico e atualizar seus alarmes na lista de alarmes executando um clique <mousebutton
2599
>Direito</mousebutton
2600
> no calendário desejado na lista e usando a opção do menu de contexto <menuchoice
2602
>Recarregar</guimenuitem
2604
>. Veja mais detalhes em <link linkend="calendars"
2605
>Calendários de Alarmes</link
2610
<sect1 id="enable-disable">
2612
>Ativar/Desativar os Alarmes</title>
2615
>Os alarmes poderão ser ativados ou desativados como um todo ou individualmente:</para>
2621
>Monitoramento de alarmes</quote
2622
> aplica-se aos alarmes como um todo. Quando a monitoração de alarmes está desativada, o &kalarm; deixa de verificar os alarmes e, assim, não irá disparar quaisquer alarmes. Quando a monitoração de alarmes estiver ativa (a situação normal), todos os alarmes que não tenham sido desativados individualmente irão disparar nas horas apropriadas.</para>
2625
>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; – os alarmes são adiados até à sua nova ativação.</para>
2630
>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>
2633
>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>
2636
>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"
2638
> da janela de Configuração).</para>
2643
>Para um alarme disparar, ele precisa estar ativo individualmente, assim como a monitoração terá que estar ativa.</para>
2647
>Ativar a Monitoração de Alarmes</title>
2650
>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"
2652
> da janela de Configuração.</para>
2655
>Se a monitoração de alarmes estiver atualmente desativada, faça uma das seguintes ações para ativar os alarmes:</para>
2660
>Selecione <menuchoice
2664
>Ativar Alarmes</guimenuitem
2671
>Clique com o &RMB; no ícone da área de notificação e escolha a opção <menuchoice
2673
>Ativar os Alarmes</guimenuitem
2675
> no menu de contexto.</para>
2683
>Desativar a Monitoração de Alarmes</title>
2686
>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 – assumindo que o &kalarm; esteja configurado para ser iniciado após o login – até à próxima vez que se logar.</para>
2691
>Selecione <menuchoice
2695
>Ativar os Alarmes</guimenuitem
2702
>Clique com o botão <mousebutton
2703
>direito</mousebutton
2704
> no ícone da área de notificação e selecione a opção <menuchoice
2706
>Ativar os Alarmes</guimenuitem
2708
> no menu de contexto.</para>
2713
>Execute o &kalarm; com a opção da linha de comando <option
2714
>--disable-all</option
2720
>Pare o &kalarm;, como se encontra descrito em <link linkend="quitting"
2721
>Sair do &kalarm;</link
2727
>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"
2729
> da janela de Configuração.</para>
2735
>Ativar/Desativar os Alarmes Individualmente</title>
2738
>Para ativar os alarmes individuais que estejam desativados no momento, faça uma das seguintes ações:</para>
2743
>Selecione um ou mais alarmes, clicando nos itens respectivos na lista de alarmes. Depois, escolha a opção <menuchoice
2747
>Ativar</guimenuitem
2754
>Clique com o &RMB; nos itens desejados na lista de alarmes e escolha a opção <menuchoice
2756
>Ativar</guimenuitem
2758
> do menu de contexto.</para>
2763
>Para desativar os alarmes individuais que estejam desativados no momento, faça uma das seguintes ações:</para>
2768
>Selecione um ou mais alarmes, carregando nos itens respectivos na lista de alarmes. Depois, escolha a opção <menuchoice
2772
>Desativar</guimenuitem
2779
>Clique com o &RMB; nos itens desejados na lista de alarmes e escolha a opção <menuchoice
2781
>Desativar</guimenuitem
2783
> do menu de contexto.</para>
2790
<sect1 id="wake-suspend">
2792
>Acordar da suspensão</title>
2795
>É possível configurar um alarme selecionado para acordar o seu sistema do estado de hibernação ou suspensão quando o alarme for disparado, para que a ação do alarme possa ocorrer mesmo que o sistema tenha sido desligado. Esta função é controlada por uma janela acessada através da seleção da opção <menuchoice
2799
>Acordar da suspensão</guimenuitem
2801
>. A janela permite definir o alarme para Acordar da suspensão, assim como cancelá-lo ou realçá-lo.</para>
2804
>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>
2808
>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
2813
>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
2817
>A janela para Acordar da suspensão é usada em conjunto com a lista de alarmes na janela principal do &kalarm;.</para>
2823
>Usar o alarme selecionado</guibutton
2824
>: 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>
2830
>Cancelar a ativação da suspensão</guibutton
2831
>: 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>
2837
>Mostrar o alarme atual</guibutton
2838
>: 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>
2844
>Número de minutos antes de o alarme acordar da suspensão</guilabel
2845
> 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>
2851
<sect1 id="quitting">
2853
>Sair do &kalarm;</title>
2856
>Saia do &kalarm; com a opção <menuchoice
2862
> ou o item do menu de contexto do ícone da área de notificação <menuchoice
2866
>. Em alternativa, se o ícone da área de notificação não estiver vazio, feche todas as janelas do &kalarm;.</para>
2871
<chapter id="preferences">
2873
>Configurando o &kalarm;</title>
2876
>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
2878
>Configurações</guimenu
2880
>Configurar o &kalarm;...</guimenuitem
2882
>. Isto mostra a janela de Configuração.</para>
2884
<sect1 id="preferences-general">
2891
> permite-lhe controlar o comportamento global do &kalarm;:</para>
2897
>Iniciar no login</guilabel
2898
>: inicia automaticamente o &kalarm; na inicialização da sessão do &kde;, após o login, para garantir que o &kalarm; esteja sempre em execução, a menos que o termine manualmente.</para>
2902
>Esta opção deve sempre estar habilitada a menos que você não pretenda mais usar o &kalarm;.</para
2907
>Esta opção fica automaticamente selecionada novamente, sempre que o &kalarm; é executado. Por isso, se você tiver desligado esta opção e quiser a evitar que o &kalarm; se execute na inicialização, terá que desligar esta opção de novo, cada vez que executar o &kalarm;.</para
2914
>Avisar antes de sair</guilabel
2915
>: Quando os alarmes forem desativados enquanto o &kalarm; não estiver rodando, a seleção desta opção pede-lhe uma confirmação se tentar terminar o &kalarm; com a opção do ícone da área de notificação <menuchoice
2919
>. Isto evita que os alarmes sejam desativados acidentalmente. Por razões de segurança, esta opção é reativada automaticamente sempre que mudar de modo de execução.</para>
2925
>Confirmar as remoções dos alarmes</guilabel
2926
>: Especifique se será questionado para confirmar cada vez que desejar remover um alarme.</para>
2932
>Intervalo de tempo de adiamento padrão</guilabel
2933
>: 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>
2939
>Terminal para os Comandos de Alarme</guilabel
2940
>: 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, ⪚ o <application
2942
>, 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>
2945
>Se quiser usar outro aplicativo ou quiser usar um dos que se encontram listados, só que com opções do comando diferentes, selecione <guilabel
2947
> 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>
2955
>O texto do comando do alarme será substituído.</para>
2963
>O texto do comando do alarme será substituído, com um <literal
2965
> adicionado.</para>
2973
>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>
2981
>Um arquivo de comando temporário, contendo o texto do comando do alarme, será criado com um <literal
2983
> adicionado, sendo substituído o comando para executar o arquivo.</para>
2989
>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>
2995
<sect1 id="preferences-time">
2997
>Data e Hora</title>
3001
>Data e Hora</guilabel
3002
> permite-lhe escolher as opções relacionadas com a data e hora:</para>
3008
>Fuso horário</guilabel
3009
>: 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>
3015
>Região dos feriados</guilabel
3016
>: 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>
3022
>Início do dia para os alarmes por data</guilabel
3023
>: 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
3024
>A qualquer hora</guilabel
3025
> 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>
3031
>Horário de Trabalho</guilabel
3032
>: Estas opções permitem-lhe definir o seu horário de trabalho, que é necessário quando a opção <guilabel
3033
>Apenas durante o horário de trabalho</guilabel
3034
> for selecionada para uma recorrência na <link linkend="alarm-edit-dlg"
3035
>janela de Edição do Alarme</link
3041
>Assinale todos os dias de trabalho.</para>
3047
>Hora inicial do dia</guilabel
3048
>: indique a hora que começa a trabalhar todos os dias.</para>
3054
>Hora final do dia</guilabel
3055
>: indique a hora que termina o trabalho todos os dias.</para>
3063
>Duração do evento do KOrganizer</guilabel
3064
>: 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>
3070
<sect1 id="preferences-storage">
3072
>Armazenamento</title>
3076
>Armazenamento</guilabel
3077
> permite-lhe escolher as opções para salvar e arquivar os alarmes:</para>
3083
>Novos Alarmes & Modelos</guilabel
3084
>: Indique o calendário onde gravar os alarmes e modelos novos, ao usar calendários com vários alarmes:</para>
3090
>Guardar no calendário padrão</guilabel
3091
>: Os alarmes e modelos novos são adicionados automaticamente ao calendário padrão, sem pedir qualquer confirmação.</para>
3097
>Perguntar o calendário onde gravar</guilabel
3098
>: 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>
3105
>Grupo dos <guilabel
3106
>Alarmes Arquivados</guilabel
3107
>: Estas opções controlam o armazenamento dos alarmes arquivados no recurso padrão para os alarmes arquivados.</para>
3113
>Manter os alarmes depois de expirarem</guilabel
3114
>: 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>
3120
>Descartar os alarmes arquivados ao fim de</guilabel
3121
>: 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>
3127
>Limpar os alarmes arquivados</guibutton
3128
>: 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>
3136
<sect1 id="preferences-email">
3143
> permite-lhe escolher as opções para enviar e endereçar os alarmes por e-mail:</para>
3149
>Cliente de e-mail</guilabel
3150
>: Indique o cliente de e-mail que será usado para enviar os alarmes por e-mail:</para>
3157
>: Quando um alarme de e-mail é ativado, o e-mail é enviado utilizando o &kmail; (que é iniciado primeiro, se for necessário) como se segue:</para>
3162
>Se o &kmail; for da versão 1.7 ou posterior, a mensagem é enviada automaticamente.</para>
3167
>Se o &kmail; for de uma versão anterior, a mensagem é adicionada à pasta <filename
3169
> do &kmail; para ser transmitida posteriormente.</para>
3178
>: 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
3179
>postfix</application
3190
>Copiar mensagens enviadas para a pasta de itens enviados do &kmail;</guilabel
3191
>: 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
3192
>itens enviados</filename
3193
> do &kmail;.</para>
3197
>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
3204
>Notificar quando os e-mails remotos ficam em espera</guilabel
3205
>: 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 ligação telefônica ou se a mensagem fica em espera na pasta do &kmail; <filename
3206
>caixa de saída</filename
3207
>, de modo que possa garantir que você faça tudo o que é necessário para enviar de fato a mensagem.</para>
3212
>Selecione seu endereço eletrônico a ser usado como endereço de remetente nos alarmes de e-mail:</para>
3217
>Selecione <guilabel
3219
> para inserir um endereço de e-mail.</para>
3224
>Selecione a opção <guilabel
3225
>Usar o endereço das Configurações do Sistema</guilabel
3226
> para usar o endereço de e-mail configurado na Configuração do Sistema do &kde;.</para>
3231
>Selecione a opção <guilabel
3232
>Usar identidades do &kmail;</guilabel
3233
> 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>
3240
>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
3241
>Copiar e-mail para você mesmo</guilabel
3242
> estiver selecionada:</para>
3247
>Selecione <guilabel
3249
> 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>
3254
>Selecione a opção <guilabel
3255
>Usar o endereço das Configurações do Sistema</guilabel
3256
> para usar o endereço de e-mail configurado na Configuração do Sistema do &kde;.</para>
3263
<sect1 id="preferences-view">
3270
> permite-lhe controlar alguns aspectos da aparência do &kalarm;. Na página <guilabel
3278
>Rodar continuamente na área de notificação</guilabel
3279
>: o &kalarm; roda continuamente e o ícone da área de notificação é sempre apresentado enquanto ele estiver rodando. Neste modo, fechar o ícone da área de notificação fecha todas as janelas principais do &kalarm; e, se não tiver nenhuma janela de mensagem visível, sai do aplicativo. As opções disponíveis para este modo são:</para>
3285
>Dica da área de notificação</guilabel
3286
>: 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>
3292
>Mostrar os alarmes das próximas 24 horas</guilabel
3293
>: Quando estiver selecionada a opção, é mostrado um resumo dos primeiros alarmes que irão ser disparados nas próximas 24 horas.</para>
3299
>Número máximo de alarmes a mostrar</guilabel
3300
>: 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>
3306
>Mostrar a hora do alarme</guilabel
3307
>: Selecione esta opção para mostrar a hora para a qual cada alarme está agendado.</para>
3313
>Mostrar a hora até ao alarme</guilabel
3314
>: 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>
3321
>: 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>
3330
>O grupo da <guilabel
3331
>Lista de Alarmes</guilabel
3332
> 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>
3338
>Janelas de Alarmes</guilabel
3339
> contém opções que controlam a aparência das janelas de mensagens de alarme.</para>
3345
>Posicionar as janelas longe do cursor do mouse</guilabel
3346
>: 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>
3352
>Centrar as janelas, atrasar a ativação dos botões da janela</guilabel
3353
>: 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
3354
>Atraso de ativação do botão (segundos)</guilabel
3361
>As janelas de mensagens possuem uma barra de título e capturam o teclado</guilabel
3362
>: 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"
3363
>Janela das Mensagens de Alarme</link
3364
> para mais detalhes.</para>
3369
<sect1 id="preferences-edit">
3376
> permite-lhe escolher os valores padrão para as opções na <link linkend="alarm-edit-dlg"
3377
>janela de Edição do Alarme</link
3385
> contém opções que se aplicam a todos os tipos de alarmes.</para>
3390
>Configura os estados padrão para as opções <guilabel
3391
>Mostrar no KOrganizer</guilabel
3393
>Cancelar se atrasado</guilabel
3399
>Mudar o tipo de recorrência padrão.</para>
3404
>Selecione o tratamento padrão, nos anos não-bissextos, das recorrências anuais agendadas para 29 de Fevereiro.</para>
3411
>A página de <guilabel
3412
>Tipos de Alarmes</guilabel
3413
> contém opções que se aplicam a tipos específicos de alarmes.</para>
3418
>Para os alarmes visíveis:</para>
3423
>Configura os estados padrão para as opções <guilabel
3424
>Fechar automaticamente a janela ao fim deste tempo</guilabel
3426
>Confirmar a recepção</guilabel
3432
>Configura as unidades dos períodos padrões dos lembretes.</para>
3437
>Configura as ações padrões de apresentação especiais dos alarmes.</para>
3442
>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
3443
>Arquivo de som</guilabel
3451
>Para os alarmes de comandos:</para>
3456
>Configura os estados padrão para as opções <guilabel
3457
>Indicar um programa</guilabel
3459
>Executar numa janela de terminal</guilabel
3467
>Para os alarmes de e-mail:</para>
3472
>Configura o estado padrão para a opção <guilabel
3473
>Copiar o e-mail para o próprio</guilabel
3484
>Fonte & Cor</guilabel
3485
> 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>
3492
<chapter id="cmdline-operation">
3494
>Operação com a Linha de Comando</title>
3497
>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"
3498
>Usando o &kalarm;</link
3499
>. As opções da linha de comando específicas do &kalarm; poderão ser usadas para efetuar as seguintes operações:</para>
3504
>agendar um novo alarme</para>
3508
>controlar o modo de apresentação do &kalarm;</para>
3517
>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"
3518
>Guia do Programador do &kalarm;</link
3522
>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>
3524
<sect1 id="cmdline-schedule">
3526
>Agendar um Novo Alarme</title>
3529
>As seguintes opções são usadas para agendar um novo alarme:</para>
3547
>--ack-confirm</option
3550
>Pede uma confirmação quando a mensagem de alarme for recebida.</entry>
3557
>--attach <replaceable
3562
>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
3564
> terá de ser fornecido com esta opção.</entry>
3569
>--auto-close</option
3572
>Fecha automaticamente a janela do alarme depois de ter expirado o período do <option
3573
>--late-cancel</option
3575
>--late-cancel</option
3576
> deverá ser indicado com esta opção.</entry>
3586
>Toca uma campainha audível quando a mensagem for apresentada. O <option
3591
>--play-repeat</option
3592
> não poderão ser indicados com esta opção.</entry>
3600
>Envia uma cópia invisível para si próprio. O <option
3602
> necessita ser indicado com esta opção.</entry>
3611
>--colour <replaceable
3616
>Indica a cor de fundo da mensagem com o nome da cor no &Qt; ou com o código hexadecimal 0xRRGGBB.</entry>
3625
>--colourfg <replaceable
3630
>Indica a cor do texto da mensagem com o nome da cor no &Qt; ou com o código hexadecimal 0xRRGGBB.</entry>
3640
>Desativa o alarme. Não irá disparar até que seja ativado manualmente.</entry>
3645
>--disable-all</option
3648
>Desativa o monitoramento do alarme. Isto impede que todos os alarmes sejam acionados até que os reative ou que reinicie o &kalarm;, ⪚ no início da próxima sessão. O <option
3649
>--triggerEvent</option
3650
> não pode ser indicado com esta opção.</entry>
3657
>--exec <replaceable
3658
>linha de comando</replaceable
3662
>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
3665
>--exec-display</option
3668
> não podem ser indicados com esta opção. O <option
3669
>--ack-confirm</option
3676
> são ignorados com esta opção.</entry>
3683
>--exec-display <replaceable
3684
>linha de comando</replaceable
3688
>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
3694
> não podem ser indicados com esta opção.</entry>
3701
>--file <replaceable
3706
>Indica o nome ou o &URL; de um arquivo de texto ou de imagem cujo conteúdo irá formar a mensagem de alarme. O <option
3709
>--exec-display</option
3712
> não poderão ser indicados e a <replaceable
3713
>mensagem</replaceable
3714
> não deverá estar presente com esta mensagem.</entry>
3721
>--file <replaceable
3726
>A linha do assunto da mensagem de e-mail. O <option
3728
> deverá ser indicado com esta opção.</entry>
3735
>--interval <replaceable
3736
>período</replaceable
3740
>Indica o intervalo entre repetições do alarme. As horas/minutos são indicados no formato <replaceable
3742
>, em que o <replaceable
3744
> é um número, ⪚ 3H30M. Os outros períodos de tempo são indicado no formato <replaceable
3746
>, em que o <replaceable
3748
> é um número e o <replaceable
3750
> é uma das seguintes letras: Y ('years' - anos), M ('months' - meses), W ('weeks' - semanas), D ('days' - dias). É obrigatório se o <option
3754
> forem indicados. Se o <option
3755
>--recurrence</option
3756
> for passado, o Y (anos) e o M (meses) não são permitidos.</entry>
3763
>--korganizer</option
3766
>Mostra o alarme como um evento no calendário ativo do &korganizer;.</entry>
3773
>--late-cancel <replaceable
3774
>período</replaceable
3778
>Cancela o alarme se não puder ser disparado no <replaceable
3779
>período</replaceable
3780
> após a hora atual. As horas/minutos são indicados no formato <replaceable
3782
>, em que o <replaceable
3784
> é um número, ⪚ 3H30M. Os outros períodos de tempo são indicado no formato <replaceable
3786
>, em que o <replaceable
3788
> é um número e o <replaceable
3790
> é uma das seguintes letras: W ('weeks' - semanas), D ('days' - dias). O valor padrão do <replaceable
3791
>período</replaceable
3792
> é 1 minuto.</entry>
3802
>Dispara o alarme sempre que você se loga. O <option
3808
> não podem ser fornecidos com esta opção.</entry>
3815
>--mail <replaceable
3816
>endereço</replaceable
3820
>Envia uma mensagem de e-mail para o endereço indicado. Esta opção pode ser repetida tantas vezes quantas necessárias. O <option
3823
>--exec-display</option
3826
> não podem ser indicados com esta opção. O <option
3827
>--ack-confirm</option
3834
> são ignorados com esta opção.</entry>
3841
>--play <replaceable
3846
>Indica o nome ou o &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
3847
>--play-repeat</option
3852
> não podem ser indicados com esta opção.</entry>
3859
>--play-repeat <replaceable
3864
>Indica o nome ou o &URL; de um arquivo de áudio a ser tocado repetidamente,enquanto não for clicado o botão <guilabel
3865
>Parar a Reprodução</guilabel
3866
> ou a mensagem de alarme estiver visível. O <option
3872
> não podem ser indicados com esta opção.</entry>
3877
>--recurrence <replaceable
3878
>especificação</replaceable
3882
>Indica o alarme a repetir. Especifique a repetição com a sintaxe do iCalendar (definida no RFC2445), ⪚ <quote
3883
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
3886
> não pode ser indicado com esta opção.</entry>
3893
>--repeat <replaceable
3894
>contagem</replaceable
3898
>Define o número de vezes que o alarme deverá ser disparado ou, se for indicada uma repetição com a opção <option
3899
>--recurrence</option
3900
>, o número de vezes que o alarme deverá ser disparado cada vez que o <option
3901
>--recurrence</option
3902
> o ativa (&ie; uma repetição dentro de uma recorrência). Se o <option
3903
>--recurrence</option
3904
> não estiver presente, indique -1 para repetir o alarme indefinidamente. O <option
3906
> deverá ser, e o <option
3908
> não, fornecido com esta opção.</entry>
3915
>--reminder <replaceable
3916
>período</replaceable
3920
>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
3921
>período</replaceable
3922
> é indicado no mesmo formato que no <option
3923
>--late-cancel</option
3924
>. Por padrão, o lembrete irá ocorrer antes do alarme. Para indicar um lembrete após o alarme, anteceda o <replaceable
3925
>período</replaceable
3926
> com o prefixo <replaceable
3928
>, ⪚ +3D. Esta opção não pode ser usada com o <option
3933
>--reminder-once</option
3939
>--reminder-once <replaceable
3940
>período</replaceable
3944
>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
3945
>período</replaceable
3946
> é indicado no mesmo formato que em <option
3948
>. Esta opção não poderá ser indicada com a <option
3964
>Fala a mensagem quando ela for apresentada. Esta opção necessita que o &jovie; esteja instalado e configurado com um sintetizador de fala compatível. O <option
3969
>--play-repeat</option
3970
> não poderão ser indicados com esta opção.</entry>
3977
>--subject <replaceable
3978
>assunto</replaceable
3982
>A linha do assunto da mensagem de e-mail. O <option
3984
> deverá ser indicada com esta opção.</entry>
3991
>--time <replaceable
3992
>data/hora</replaceable
3996
>Dispara o alarme na data ou na data/hora indicadas. Indique uma data sem hora no formato <replaceable
3997
>aaaa-mm-dd [FH]</replaceable
3998
>; por outro lado, indique uma data e hora com <replaceable
3999
>[[[aaaa-]mm-]dd-]hh:mm [FH]</replaceable
4000
> 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
4002
>, poderá ser o nome de um fuso horário de sistema (⪚ <userinput
4003
>Europa/Londres</userinput
4006
> - representando o fuso horário UTC ou <userinput
4008
> para usar o relógio do computador local e ignorar os fusos-horários.</entry>
4015
>--volume <replaceable
4016
>porcentagem</replaceable
4020
>Define o volume do áudio para tocar o arquivo de áudio. Esta opção só poderá ser usada quando o <option
4023
>--play-repeat</option
4024
> forem também usados.</entry>
4031
>--until <replaceable
4032
>data/hora</replaceable
4036
>Repete o alarme até à data ou data/hora indicadas. Indique a data ou data/hora com a mesma sintaxe usada no <option
4038
>. Lembre-se que, se for usada a opção <option
4040
>, o fuso horário será retirado a partir do seu valor e não será incluída nenhum fuso horário no valor <option
4044
> deverá ser usado, enquanto que o <option
4047
>--recurrence</option
4048
> não poderão ser usados, com esta opção.</entry>
4053
>mensagem</replaceable
4056
>O texto da mensagem a mostrar ou, se o <option
4058
> for indicado, o corpo da mensagem de e-mail.</entry>
4065
>Tanto deverá ser usado um texto de mensagem, o <option
4070
>--exec-display</option
4074
>--play-repeat</option
4075
>; exceto nos casos acima indicados, todas as opções são opcionais.</para>
4078
>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>
4093
>27-22:00</replaceable
4097
>"Lembre-se de\nPARAR"</replaceable
4107
>0xFF0000</replaceable
4111
>27-22:00</replaceable
4115
>"Lembre-se de \nPARAR"</replaceable
4124
<sect1 id="cmdline-other">
4126
>Outras Opções</title>
4129
>As opções a seguir são usadas para mostrar a <link linkend="alarm-edit-dlg"
4130
>janela de Edição de Alarmes</link
4131
> ou para controlar o modo de apresentação do &kalarm;.</para>
4147
>--edit <replaceable
4148
>idEvento</replaceable
4152
>Mostra a janela de Edição de Alarmes para editar o alarme com o identificador indicado.</entry>
4157
>--edit-new-audio</option
4160
>Mostra a janela de Edição de Alarmes para editar um novo alarme de áudio.</entry>
4165
>--edit-new-command</option
4168
>Mostra a janela de Edição de Alarmes para editar um novo alarme por comando.</entry>
4173
>--edit-new-display</option
4176
>Mostra a janela de Edição de Alarmes para editar um novo alarme visível.</entry>
4181
>--edit-new-email</option
4184
>Mostra a janela de Edição de Alarmes para editar um novo alarme por e-mail.</entry>
4189
>--edit-new-preset <replaceable
4190
>nomeModelo</replaceable
4194
>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>
4202
>Mostra o &kalarm; como um ícone na área de notificação.</entry>
4210
<sect1 id="cmdline-help">
4212
>Opções de Ajuda</title>
4215
>As seguintes opções de ajuda são comuns a todos os programas do &kde;:</para>
4234
>Mostra um texto breve de ajuda das opções.</entry>
4242
>Mostra várias opções genéricas usadas pelo &Qt;.</entry>
4250
>Mostra várias opções genéricas usadas pelo &kde;.</entry>
4258
>Mostra todas as opções.</entry>
4266
>Mostra os nomes e endereços de e-mail dos autores do &kalarm;.</entry>
4276
>Mostra as versões usadas da biblioteca &Qt;, do &kde; e do &kalarm;.</entry>
4284
>Mostra informações sobre a licença.</entry>
4293
<chapter id="developers">
4295
>Guia de Programador do &kalarm;</title>
4298
>O &kalarm; oferece uma interface para permitir aos outros aplicativos solicitarem as seguintes funções:</para>
4303
>agendar um novo alarme</para
4307
>cancelar um alarme já agendado</para
4311
>disparar um alarme já agendado</para
4315
>mostra a janela de Edição do Alarme</para
4320
>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>
4322
<sect1 id="dbus-interface">
4324
>Interface &DBus;</title>
4327
>As chamadas de &DBus; descritas neste documento estão todas implementadas no local de &DBus; <constant
4329
> do &kalarm;. A interface está definida nos arquivos <filename
4330
>org.kde.kalarm.kalarm.xml</filename
4332
>kalarmiface.h</filename
4335
<refentry id="cancelEvent">
4338
>cancelEvent</refentrytitle>
4342
>cancelEvent</refname>
4344
>cancela um alarme já agendado.</refpurpose>
4348
>void cancelEvent(const QString& <replaceable
4349
>idEvento</replaceable
4360
>idEvento</parameter
4364
>Indica o identificador único do evento a cancelar.</para>
4377
>cancelEvent()</function
4378
> é uma chamada de &DBus; para cancelar o alarme indicado. O &kalarm; apaga o alarme do calendário sem mostrá-lo ou executá-lo.</para>
4383
<refentry id="triggerEvent">
4386
>triggerEvent</refentrytitle>
4390
>triggerEvent</refname>
4392
>dispara um alarme já agendado.</refpurpose>
4396
>void triggerEvent(const QString& <replaceable
4397
>idEvento</replaceable
4408
>idEvento</parameter
4412
>Indica o identificador único do evento a ser disparado.</para>
4425
>triggerEvent()</function
4426
> é 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>
4429
>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>
4434
<refentry id="scheduleMessage">
4437
>scheduleMessage</refentrytitle>
4441
>scheduleMessage</refname>
4443
>agenda uma nova mensagem de alarme.</refpurpose>
4447
>bool scheduleMessage(const QString& <replaceable
4448
>mensagem</replaceable
4450
const QString& <replaceable
4451
>dataHora</replaceable
4454
>cancelarSeAtrasado</replaceable
4456
unsigned <replaceable
4457
>opcoes</replaceable
4459
const QString& <replaceable
4460
>corFundo</replaceable
4462
const QString& <replaceable
4463
>corTexto</replaceable
4465
const QString& <replaceable
4466
>tipoLetra</replaceable
4468
const KURL& <replaceable
4469
>urlAudio</replaceable
4472
>Lembrete</replaceable
4474
const QString& <replaceable
4475
>recorrencia</replaceable
4478
>intervaloSubRepeticoes</replaceable
4481
>numeroSubRepeticoes</replaceable
4485
>bool scheduleMessage(const QString& <replaceable
4486
>mensagem</replaceable
4487
>, const QDateTime& <replaceable
4488
>dataHora</replaceable
4489
>, const QColor& <replaceable
4491
>, const QColor& <replaceable
4494
>cancelarSeAtrasado</replaceable
4495
>, unsigned <replaceable
4496
>opções</replaceable
4497
>, const QString& <replaceable
4498
>urlAudio</replaceable
4500
>Lembrete</replaceable
4502
>tipoRepeticaoSimples</replaceable
4504
>intervalo</replaceable
4506
>numeroRepeticoes</replaceable
4510
>bool scheduleMessage(const QString& <replaceable
4511
>mensagem</replaceable
4512
>, const QDateTime& <replaceable
4513
>dataHora</replaceable
4514
>, const QColor& <replaceable
4516
>, const QColor& <replaceable
4519
>cancelarSeAtrasado</replaceable
4520
>, unsigned <replaceable
4521
>opções</replaceable
4522
>, const QString& <replaceable
4523
>urlAudio</replaceable
4525
>Lembrete</replaceable
4527
>tipoRepeticaoSimples</replaceable
4529
>intervalo</replaceable
4530
>, const QDateTime& <replaceable
4531
>dataFim</replaceable
4542
>mensagem</parameter
4546
>Define o texto da mensagem a ser agendada ou, se as <parameter
4548
> tiverem o bit <userinput
4549
>DISPLAY_COMMAND</userinput
4550
> ativo, indica a linha de comando a executar para gerar o texto da mensagem.</para>
4557
>dataHoraInicial</parameter
4561
>Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para um alarme apenas de data, o texto deverá estar no formato <quote
4562
>AAAA-MM-DD [TZ]</quote
4563
> (tal como é devolvido pelo <methodname
4564
>QDate::toString(Qt::ISODate)</methodname
4565
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
4566
>AAA-MM-DDTHH:MM[:SS] [TZ]</quote
4567
> (tal como é devolvido pelo <methodname
4568
>QDateTime::toString(Qt::ISODate)</methodname
4570
>HH:MM[:SS] [Relógio]</quote
4571
> (tal como é devolvido pelo <methodname
4572
>QTime::toString(Qt::ISODate)</methodname
4573
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>
4576
>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
4578
>, poderá ser o nome de um fuso horário de sistema (⪚ <userinput
4579
>Europa/Londres</userinput
4582
> - representando o fuso horário UTC ou <userinput
4584
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
4591
>lateCancel</parameter
4595
>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>
4606
>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
4607
>KAlarmIface</classname
4609
>kalarmiface.h</filename
4610
>. Repare que nem todos os bits de opções se aplicam aos alarmes de mensagens.</para>
4621
>Indica a cor de fundo usada para mostrar a mensagem. O texto poderá estar no formato <quote
4623
> (tal como é devolvido pelo <methodname
4624
>QColor::name()</methodname
4625
>) 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
4626
>QColor::setNamedColor()</methodname
4627
>, como o nome de uma cor na base de dados de cores do X (⪚ <quote
4631
>). Ponha o texto vazio para indicar a cor de fundo padrão atual.</para>
4642
>Define a cor do texto para mostrar a mensagem. O formato do texto é o mesmo que o do <parameter
4644
> ou, em alternativa, poderá ser vazio para usar a cor de texto padrão.</para>
4655
>Define a fonte usada para mostrar a mensagem. O formato do texto é o devolvido pelo <methodname
4656
>QFont::toString()</methodname
4657
>. Coloque o texto vazio para usar a fonte padrão para as mensagens, no momento em que a mensagem for apresentada.</para>
4664
>urlAudio</parameter
4668
>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>
4675
>minutosLembrete</parameter
4679
>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>
4686
>recorrência</parameter
4690
>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"
4692
>. Por exemplo, <quote
4693
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
4694
> 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>
4701
>recorrência</parameter
4705
>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
4706
>KAlarmIface</classname
4708
>kalarmiface.h</filename
4709
>. 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
4710
>dataHoraInicial</parameter
4718
>intervaloRecorrencia</parameter
4722
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
4723
>tipoRecorrencia</parameter
4724
>) entre repetições do alarme.</para>
4731
>numeroRecorrencias</parameter
4735
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
4742
>dataHoraFim</parameter
4746
>Indica a data ou data/hora de fim para as repetições do alarme. Se o <parameter
4747
>dataHora</parameter
4748
> incluir uma hora, este parâmetro deverá também incluir uma hora; se o <parameter
4749
>dataHoraInicial</parameter
4750
> 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
4751
>dataHoraInicial</parameter
4752
> para interpretar o valor deste parâmetro.</para>
4759
>intervaloSubRepeticoes</parameter
4763
>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>
4770
>numeroSubRepeticoes</parameter
4774
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
4781
<refsect1 id="scheduleMessage-descrip">
4786
>scheduleMessage()</function
4787
> é 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 – 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>
4790
>Se a hora agendada (incluindo as repetições) já tiver passado, o &kalarm; mostra imediatamente a mensagem (a menos que o parâmetro <parameter
4791
>cancelarSeAtrasado</parameter
4792
> 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>
4796
<refentry id="scheduleFile">
4799
>scheduleFile</refentrytitle>
4803
>scheduleFile</refname>
4805
>agendar um novo alarme que mostra o conteúdo de um arquivo de texto ou de imagem.</refpurpose>
4809
>bool scheduleFile(const KURL& <replaceable
4812
const QString& <replaceable
4813
>dataHora</replaceable
4816
>cancelarSeAtrasado</replaceable
4818
unsigned <replaceable
4819
>opcoes</replaceable
4821
const QString& <replaceable
4822
>corFundo</replaceable
4824
const KURL& <replaceable
4825
>urlAudio</replaceable
4828
>minutosLembrete</replaceable
4830
const QString& <replaceable
4831
>recorrencia</replaceable
4834
>intervaloSubRepeticoes</replaceable
4837
>numerSubRepeticoes</replaceable
4841
>bool scheduleFile(const QString& <replaceable
4844
const QString& <replaceable
4845
>datahoraInicial</replaceable
4848
>cancelarAtrasado</replaceable
4850
unsigned <replaceable
4851
>opções</replaceable
4853
const QString& <replaceable
4854
>corFundo</replaceable
4856
const QString& <replaceable
4857
>urlAudio</replaceable
4860
>minLembrete</replaceable
4863
>tipoRecorrência</replaceable
4866
>intvRecorrência</replaceable
4869
>contRecorrência</replaceable
4873
>bool scheduleFile(const QString& <replaceable
4876
const QString& <replaceable
4877
>datahoraInicial</replaceable
4880
>cancelarAtrasado</replaceable
4882
unsigned <replaceable
4883
>opções</replaceable
4885
const QString& <replaceable
4886
>corFundo</replaceable
4888
const QString& <replaceable
4889
>urlAudio</replaceable
4892
>minLembrete</replaceable
4895
>tipoRecorrência</replaceable
4898
>intervaloRecorrência</replaceable
4900
const QString& <replaceable
4901
>datahoraFinal</replaceable
4916
>Indica o arquivo de texto ou imagem cujo conteúdo seja apresentado na mensagem a ser agendada.</para>
4923
>dataHoraInicial</parameter
4927
>Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para um alarme apenas de data, o texto deverá estar no formato <quote
4928
>AAAA-MM-DD [TZ]</quote
4929
> (tal como é devolvido pelo <methodname
4930
>QDate::toString(Qt::ISODate)</methodname
4931
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
4932
>AAA-MM-DDTHH:MM[:SS] [TZ]</quote
4933
> (tal como é devolvido pelo <methodname
4934
>QDateTime::toString(Qt::ISODate)</methodname
4936
>HH:MM[:SS] [Relógio]</quote
4937
> (tal como é devolvido pelo <methodname
4938
>QTime::toString(Qt::ISODate)</methodname
4939
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>
4942
>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
4944
>, poderá ser o nome de um fuso horário de sistema (⪚ <userinput
4945
>Europa/Londres</userinput
4948
> - representando o fuso horário UTC ou <userinput
4950
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
4957
>lateCancel</parameter
4961
>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>
4972
>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
4973
>KAlaramIface</classname
4975
>kalarmiface.h</filename
4976
>. Repare que nem todos os bits de aplicam aos alarmes de arquivos.</para>
4987
>Indica a cor de fundo usada para mostrar o arquivo. O texto poderá estar no formato <quote
4989
> (tal como é devolvido pelo <methodname
4990
>QColor::name()</methodname
4991
>) 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
4992
>QColor::setNamedColor()</methodname
4993
>, com o nome de uma cor na base de dados de cores do X (⪚ <quote
4997
>). Ponha o texto vazio para indicar a cor de fundo padrão atual.</para>
5004
>urlAudio</parameter
5008
>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>
5015
>minutosLembrete</parameter
5019
>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>
5026
>recorrência</parameter
5030
>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"
5032
>. Por exemplo, <quote
5033
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
5034
> 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>
5041
>recorrência</parameter
5045
>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
5046
>KAlarmIface</classname
5048
>kalarmiface.h</filename
5049
>. 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
5050
>dataHoraInicial</parameter
5058
>intervaloRecorrencia</parameter
5062
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
5063
>tipoRecorrencia</parameter
5064
>) entre repetições do alarme.</para>
5071
>numeroRecorrencias</parameter
5075
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
5082
>dataHoraFim</parameter
5086
>Indica a data ou data/hora de fim para as repetições do alarme. Se o <parameter
5087
>dataHora</parameter
5088
> incluir uma hora, este parâmetro deverá também incluir uma hora; se o <parameter
5089
>dataHoraInicial</parameter
5090
> 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
5091
>dataHoraInicial</parameter
5092
> para interpretar o valor deste parâmetro.</para>
5099
>intervaloSubRepeticoes</parameter
5103
>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>
5110
>numeroSubRepeticoes</parameter
5114
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
5126
>scheduleFile()</function
5127
> é 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"
5129
>scheduleMessage</function
5131
> - veja a descrição dessa função para mais detalhes.</para>
5136
<refentry id="scheduleCommand">
5139
>scheduleCommand</refentrytitle>
5143
>scheduleCommand</refname>
5145
>agenda um novo alarme que executa um determinado comando.</refpurpose>
5149
>bool scheduleCommand(const QString& <replaceable
5150
>linhaComandos</replaceable
5152
const QString& <replaceable
5153
>dataHora</replaceable
5156
>cancelarSeAtrasado</replaceable
5158
unsigned <replaceable
5159
>opcoes</replaceable
5161
const QString& <replaceable
5162
>recorrencia</replaceable
5165
>intervaloSubRepeticoes</replaceable
5168
>numeroSubRepeticoes</replaceable
5172
>bool scheduleCommand(const QString& <replaceable
5173
>linhaComando</replaceable
5175
const QString& <replaceable
5176
>datahoraInicial</replaceable
5179
>cancelarAtrasado</replaceable
5181
unsigned <replaceable
5182
>opções</replaceable
5185
>tipoRecorrência</replaceable
5188
>intervaloRecorrência</replaceable
5191
>contagemRecorrência</replaceable
5195
>bool scheduleCommand(const QString& <replaceable
5196
>linhaComando</replaceable
5198
const QString& <replaceable
5199
>datahoraInicial</replaceable
5202
>cancelarAtrasado</replaceable
5204
unsigned <replaceable
5205
>opções</replaceable
5208
>tipoRecorrência</replaceable
5211
>intervaloRecorrência</replaceable
5213
const QString& <replaceable
5214
>datahoraFinal</replaceable
5225
>Linha de comando</parameter
5229
>Indica o comando cuja execução será agendada. O parâmetro <parameter
5231
> indica se este parâmetro contém uma linha de comando ou o nome de um programa.</para>
5238
>dataHoraInicial</parameter
5242
>Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para um alarme apenas de data, o texto deverá estar no formato <quote
5243
>AAAA-MM-DD [TZ]</quote
5244
> (tal como é devolvido pelo <methodname
5245
>QDate::toString(Qt::ISODate)</methodname
5246
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
5247
>AAA-MM-DDTHH:MM[:SS] [TZ]</quote
5248
> (tal como é devolvido pelo <methodname
5249
>QDateTime::toString(Qt::ISODate)</methodname
5251
>HH:MM[:SS] [Relógio]</quote
5252
> (tal como é devolvido pelo <methodname
5253
>QTime::toString(Qt::ISODate)</methodname
5254
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>
5257
>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
5259
>, poderá ser o nome de um fuso horário de sistema (⪚ <userinput
5260
>Europa/Londres</userinput
5263
> - representando o fuso horário UTC ou <userinput
5265
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
5272
>lateCancel</parameter
5276
>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>
5287
>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
5288
>KAlarmIface</classname
5290
>kalarmiface.h</filename
5291
>. Repare que nem todos os bits se aplicam aos alarmes de comandos.</para>
5298
>recorrência</parameter
5302
>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"
5304
>. Por exemplo, <quote
5305
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
5306
> 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>
5313
>recorrência</parameter
5317
>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
5318
>KAlarmIface</classname
5320
>kalarmiface.h</filename
5321
>. 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
5322
>dataHoraInicial</parameter
5330
>intervaloRecorrencia</parameter
5334
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
5335
>tipoRecorrencia</parameter
5336
>) entre repetições do alarme.</para>
5343
>numeroRecorrencias</parameter
5347
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
5354
>dataHoraFim</parameter
5358
>Indica a data ou data/hora de fim para as repetições do alarme. Se o <parameter
5359
>dataHora</parameter
5360
> incluir uma hora, este parâmetro deverá também incluir uma hora; se o <parameter
5361
>dataHoraInicial</parameter
5362
> 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
5363
>dataHoraInicial</parameter
5364
> para interpretar o valor deste parâmetro.</para>
5371
>intervaloSubRepeticoes</parameter
5375
>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>
5382
>numeroSubRepeticoes</parameter
5386
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
5398
>scheduleCommand()</function
5399
> é 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"
5401
>scheduleMessage</function
5403
> - veja a descrição dessa função para mais detalhes.</para>
5408
<refentry id="scheduleEmail">
5411
>scheduleEmail</refentrytitle>
5415
>scheduleEmail</refname>
5417
>agenda um novo alarme que envia uma mensagem de e-mail.</refpurpose>
5421
>bool scheduleEmail(const QString& <replaceable
5422
>idRemetente</replaceable
5424
const QString& <replaceable
5425
>enderecos</replaceable
5427
const QString& <replaceable
5428
>assunto</replaceable
5430
const QString& <replaceable
5431
>mensagem</replaceable
5433
const QString& <replaceable
5434
>anexos</replaceable
5436
const QString& <replaceable
5437
>dataHora</replaceable
5440
>cancelarSeAtrasado</replaceable
5442
unsigned <replaceable
5443
>opcoes</replaceable
5445
const QString& <replaceable
5446
>recorrencia</replaceable
5449
>intervaloSubRepeticoes</replaceable
5452
>numeroSubRepeticoes</replaceable
5456
>bool scheduleEmail(const QString& <replaceable
5457
>fromID</replaceable
5459
const QString& <replaceable
5460
>endereços</replaceable
5462
const QString& <replaceable
5463
>assunto</replaceable
5465
const QString& <replaceable
5466
>mensagem</replaceable
5468
const QString& <replaceable
5469
>anexos</replaceable
5471
const QString& <replaceable
5472
>datahoraInicial</replaceable
5475
>cancelarAtrasado</replaceable
5477
unsigned <replaceable
5478
>opções</replaceable
5481
>tipoRecorrência</replaceable
5484
>intervaloRecorrência</replaceable
5487
>contagemRecorrência</replaceable
5491
>bool scheduleEmail(const QString& <replaceable
5492
>fromID</replaceable
5494
const QString& <replaceable
5495
>endereços</replaceable
5497
const QString& <replaceable
5498
>assunto</replaceable
5500
const QString& <replaceable
5501
>mensagem</replaceable
5503
const QString& <replaceable
5504
>anexos</replaceable
5506
const QString& <replaceable
5507
>datahoraInicial</replaceable
5510
>cancelarAtrasado</replaceable
5512
unsigned <replaceable
5513
>opções</replaceable
5516
>tipoRecorrência</replaceable
5519
>intervaloRecorrência</replaceable
5521
const QString& <replaceable
5522
>horaFinal</replaceable
5537
>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"
5538
>preferências de E-mail</link
5539
> do &kalarm;.</para>
5546
>endereços</parameter
5550
>Uma lista separada por vírgulas de endereços de e-mail dos destinatários.</para>
5561
>Indica a linha de assunto da mensagem de e-mail.</para>
5568
>mensagem</parameter
5572
>Indica o conteúdo da mensagem do e-mail.</para>
5583
>Uma lista, separada por vírgulas, dos &URL;s dos arquivos a enviar como anexos da mensagem de e-mail.</para>
5590
>dataHoraInicial</parameter
5594
>Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para um alarme apenas de data, o texto deverá estar no formato <quote
5595
>AAAA-MM-DD [TZ]</quote
5596
> (tal como é devolvido pelo <methodname
5597
>QDate::toString(Qt::ISODate)</methodname
5598
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
5599
>AAA-MM-DDTHH:MM[:SS] [TZ]</quote
5600
> (tal como é devolvido pelo <methodname
5601
>QDateTime::toString(Qt::ISODate)</methodname
5603
>HH:MM[:SS] [Relógio]</quote
5604
> (tal como é devolvido pelo <methodname
5605
>QTime::toString(Qt::ISODate)</methodname
5606
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>
5609
>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
5611
>, poderá ser o nome de um fuso horário de sistema (⪚ <userinput
5612
>Europa/Londres</userinput
5615
> - representando o fuso horário UTC ou <userinput
5617
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
5624
>lateCancel</parameter
5628
>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>
5639
>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
5640
>KAlarmIface</classname
5642
>kalarmiface.h</filename
5643
>. Repare que nem todos os bits se aplicam aos alarmes por e-mail.</para>
5650
>recorrência</parameter
5654
>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"
5656
>. Por exemplo, <quote
5657
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
5658
> 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>
5665
>recorrência</parameter
5669
>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
5670
>KAlarmIface</classname
5672
>kalarmiface.h</filename
5673
>. 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
5674
>dataHoraInicial</parameter
5682
>intervaloRecorrencia</parameter
5686
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
5687
>tipoRecorrencia</parameter
5688
>) entre repetições do alarme.</para>
5695
>numeroRecorrencias</parameter
5699
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
5706
>dataHoraFim</parameter
5710
>Indica a data ou data/hora de fim para as repetições do alarme. Se o <parameter
5711
>dataHora</parameter
5712
> incluir uma hora, este parâmetro deverá também incluir uma hora; se o <parameter
5713
>dataHoraInicial</parameter
5714
> 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
5715
>dataHoraInicial</parameter
5716
> para interpretar o valor deste parâmetro.</para>
5723
>intervaloSubRepeticoes</parameter
5727
>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>
5734
>numeroSubRepeticoes</parameter
5738
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
5750
>scheduleEmail()</function
5751
> é 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"
5753
>scheduleMessage</function
5755
> - veja a descrição dessa função para mais detalhes.</para>
5760
<refentry id="scheduleAudio">
5763
>scheduleAudio</refentrytitle>
5767
>scheduleAudio</refname>
5769
>agenda um novo alarme que executa um determinado comando.</refpurpose>
5773
>bool scheduleAudio(const QString& <replaceable
5774
>urlAudio</replaceable
5777
>percentagemVolume</replaceable
5779
const QString& <replaceable
5780
>dataHoraInicio</replaceable
5783
>cancelarAtrasado</replaceable
5785
unsigned <replaceable
5786
>opções</replaceable
5788
const QString& <replaceable
5789
>recorrencia</replaceable
5792
>intervaloSubRepeticoes</replaceable
5795
>numeroSubRepeticoes</replaceable
5799
>bool scheduleAudio(const QString& <replaceable
5800
>urlAudio</replaceable
5803
>percentagemVolume</replaceable
5805
const QString& <replaceable
5806
>dataHoraInicio</replaceable
5809
>cancelarAtrasado</replaceable
5811
unsigned <replaceable
5812
>opções</replaceable
5815
>tipoRecorrencia</replaceable
5818
>intevaloRecorrencia</replaceable
5821
>numeroRecorrencias</replaceable
5825
>bool scheduleAudio(const QString& <replaceable
5826
>urlAudio</replaceable
5829
>percentagemVolume</replaceable
5831
const QString& <replaceable
5832
>dataHoraInicio</replaceable
5835
>cancelarAtrasado</replaceable
5837
unsigned <replaceable
5838
>opções</replaceable
5841
>tipoRecorrencia</replaceable
5844
>intevaloRecorrencia</replaceable
5846
const QString& <replaceable
5847
>dataHoraFim</replaceable
5858
>urlAudio</parameter
5862
>Indica o arquivo de áudio a ser reproduzido.</para>
5869
>percentagemVolume</parameter
5873
>Define o nível de volume a usar como sendo uma percentagem do volume total. Indique -1 para usar o volume padrão.</para>
5880
>dataHoraInicial</parameter
5884
>Indica a hora agendada, ou data e hora, a que a mensagem deverá ser mostrada. Para um alarme apenas de data, o texto deverá estar no formato <quote
5885
>AAAA-MM-DD [TZ]</quote
5886
> (tal como é devolvido pelo <methodname
5887
>QDate::toString(Qt::ISODate)</methodname
5888
>). Para um alarme com data e hora, o texto deverá estar no formato <quote
5889
>AAA-MM-DDTHH:MM[:SS] [TZ]</quote
5890
> (tal como é devolvido pelo <methodname
5891
>QDateTime::toString(Qt::ISODate)</methodname
5893
>HH:MM[:SS] [Relógio]</quote
5894
> (tal como é devolvido pelo <methodname
5895
>QTime::toString(Qt::ISODate)</methodname
5896
>). Se não for indicada qualquer data, será usada a data de hoje. Lembre-se que o valor dos segundos é ignorado.</para>
5899
>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
5901
>, poderá ser o nome de um fuso horário de sistema (⪚ <userinput
5902
>Europa/Londres</userinput
5905
> - representando o fuso horário UTC ou <userinput
5907
> para usar o relógio do computador local e ignorar os fusos-horários.</para>
5914
>lateCancel</parameter
5918
>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>
5929
>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
5930
>KAlarmIface</classname
5932
>kalarmiface.h</filename
5933
>. Repare que nem todos os bits se aplicam aos alarmes de comandos.</para>
5940
>recorrência</parameter
5944
>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"
5946
>. Por exemplo, <quote
5947
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
5948
> 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>
5955
>recorrência</parameter
5959
>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
5960
>KAlarmIface</classname
5962
>kalarmiface.h</filename
5963
>. 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
5964
>dataHoraInicial</parameter
5972
>intervaloRecorrencia</parameter
5976
>Indica o número de períodos (minutos/dias/semanas/meses/anos, tal como é indicado no <parameter
5977
>tipoRecorrencia</parameter
5978
>) entre repetições do alarme.</para>
5985
>numeroRecorrencias</parameter
5989
>Indica o número de vezes que o alarme deverá ser repetido. Indique -1 para repetir o alarme indefinidamente.</para>
5996
>dataHoraFim</parameter
6000
>Indica a data ou data/hora de fim para as repetições do alarme. Se o <parameter
6001
>dataHora</parameter
6002
> incluir uma hora, este parâmetro deverá também incluir uma hora; se o <parameter
6003
>dataHoraInicial</parameter
6004
> 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
6005
>dataHoraInicial</parameter
6006
> para interpretar o valor deste parâmetro.</para>
6013
>intervaloSubRepeticoes</parameter
6017
>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>
6024
>numeroSubRepeticoes</parameter
6028
>Indica o número de sub-repetições do alarme, incluindo a ocorrência inicial.</para>
6040
>scheduleAudio()</function
6041
> é 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"
6043
>scheduleMessage</function
6045
> - veja a descrição dessa função para mais detalhes.</para>
6049
<refentry id="dbus_edit">
6052
>edit</refentrytitle>
6058
>Mostra a <link linkend="alarm-edit-dlg"
6059
>janela de Edição do Alarme</link
6060
> para editar um alarme.</refpurpose>
6064
>bool edit(const QString& <replaceable
6065
>idEvento</replaceable
6076
>idEvento</parameter
6080
>Indica o identificador único do evento a editar.</para>
6088
>Valor devolvido</title>
6092
>, se o alarme indicado não for encontrado ou for apenas para leitura, caso contrário <returnvalue
6105
> é uma chamada de &DBus; para mostrar a <link linkend="alarm-edit-dlg"
6106
>janela de Edição do Alarme</link
6107
>, para editar o alarme indicado.</para>
6112
<refentry id="dbus_editnew">
6115
>editNew</refentrytitle>
6121
>Isto mostra a <link linkend="alarm-edit-dlg"
6122
>janela de Edição do Alarme</link
6123
> para editar um novo alarme.</refpurpose>
6127
>bool editNew(int <replaceable
6132
>bool editNew(const QString& <replaceable
6133
>nomeModelo</replaceable
6148
>Indica o tipo de alarme. Os valores permitidos são o DISPLAY, COMMAND, EMAIL, AUDIO. Eles estão definidos na classe <classname
6149
>KAlarmIface</classname
6151
>kalarmiface.h</filename
6159
>nomeModelo</parameter
6163
>Indica o nome de um modelo de alarme no qual basear o novo alarme.</para>
6171
>Valor devolvido</title>
6177
> tiver um valor inválido ou se não existir um modelo com o nome <parameter
6178
>nomeModelo</parameter
6179
>; caso contrário, devolve <returnvalue
6191
>editNew()</function
6192
> é uma chamada de &DBus; para mostrar a <link linkend="alarm-edit-dlg"
6193
>janela de Edição de Alarmes</link
6194
> 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>
6201
<sect1 id="cmdline-interface">
6203
>Interface da Linha de Comando</title>
6206
>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>
6210
>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
6214
>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"
6215
>Operação com a Linha de Comando</link
6216
>. As opções para disparar e cancelar os alarmes agendados são as seguintes:</para>
6220
>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
6237
>--cancelEvent <replaceable
6238
>idEvento</replaceable
6242
>Cancela o alarme com o ID de evento indicado. O <option
6243
>--triggerEvent</option
6244
> não pode ser indicado com esta opção.</entry>
6249
>--triggerEvent <replaceable
6250
>idEvento</replaceable
6254
>Dispara o alarme com o identificador de evento indicado. A ação tomada é a mesma da chamada de &DBus; <link linkend="triggerEvent"
6255
>triggerEvent()</link
6257
>--cancelEvent</option
6258
> não pode ser indicado com esta opção.</entry>
6275
>--triggerEvent <replaceable
6276
>&kalarm;-387486299.702</replaceable
6285
>--cancelEvent <replaceable
6286
>&kalarm;-388886299.793</replaceable
6299
>Perguntas e Respostas</title>
6300
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
6304
>Que arquivos de configuração o &kalarm; utiliza?</para>
6308
>O arquivo <filename
6309
>$KDEHOME/share/config/kalarmrc</filename
6310
> contém as suas preferências do &kalarm;.</para>
6312
>O arquivo <filename
6313
>$KDEHOME/share/config/kresources/alarms/stdrc</filename
6314
> contém a configuração do seu calendário de alarme.</para>
6319
> é normalmente a <filename class="directory"
6320
>˜/.kde</filename
6321
> ou algo semelhante.)</para>
6328
>Onde o &kalarm; grava os seus alarmes?</para>
6333
>Os nomes dos arquivos de calendários que o &kalarm; cria, da primeira vez que é executado, são os seguintes (se bem que podem ser substituídos por itens da seção <parameter
6335
> do arquivo de preferências do &kalarm;):</para>
6341
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
6342
> contém os alarmes ativos (substituído pelo item <parameter
6343
>Calendar</parameter
6349
>O arquivo do calendário que guarda os seus alarmes expirados é o <filename
6350
>$KDEHOME/share/apps/kalarm/expired.ics</filename
6351
> (pode ser substituído pelo item em <parameter
6352
>ExpiredCalendar</parameter
6359
>$KDEHOME/share/apps/kalarm/template.ics</filename
6360
> contém os modelos de alarmes (substituído pelo item <parameter
6361
>TemplateCalendar</parameter
6367
>Você poderá descobrir os arquivos de calendários que estão sendo atualmente usados, vendo os detalhes de cada calendário na lista de calendários de alarmes. Os nomes dos arquivos são gravados no arquivo de configuração do calendário de alarme.</para>
6370
>Os detalhes dos alarmes que estão visíveias atualmente são guardados no arquivo de calendário <filename
6371
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
6379
>Em que formato os alarmes são guardados?</para>
6383
>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"
6384
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
6385
>. 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
6386
>DESIGN.html</filename
6387
> que é distribuído com o &kalarm;.</para>
6394
>O que é o programa <application
6395
>kalarmautostart</application
6401
>kalarmautostart</application
6402
> é um pequeno programa auxiliar, cuja função é iniciar automaticamente o &kalarm; no início da sessão.</para>
6405
>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>
6408
>Para evitar este problema, o <application
6409
>kalarmautostart</application
6410
> é 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>
6418
<chapter id="credits">
6421
>Créditos e licença</title>
6426
>Programa com 'copyright' 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 de &David.Jarvie; &David.Jarvie.mail; </para>
6429
>Documentação com 'copyright' 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 de &David.Jarvie; &David.Jarvie.mail; </para>
6432
>Tradução de Marcus Gama<email
6433
>marcus.gama@gmail.com</email
6436
&underFDL; &underGPL; <para
6437
>Os agradecimentos vão para o autor do aplicativo KAlarm do &kde;1, o Stefan Nikolaus <email
6438
>stefan.nikolaus@stuco.uni-oldenburg.de</email
6439
>, que permitiu gentilmente o uso do &kalarm; neste aplicativo do &kde;2/&kde;3. </para>
6443
<appendix id="installation">
6447
<sect1 id="getting-kalarm">
6449
>Como Obter o &kalarm;</title>
6450
&install.intro.documentation; <para
6451
>O &kalarm; está também disponível como pacote autônomo para o &kde; 2, &kde; 3 e &kde; 4 em <ulink url="http://www.astrojar.org.uk/kalarm"
6452
>http://www.astrojar.org.uk/kalarm</ulink
6457
<sect1 id="requirements">
6462
>O &kalarm; precisa das bibliotecas normais do &kde; instaladas (o pacote <filename
6465
>kdepimlibs</filename
6466
>), além do pacote <filename
6467
>kdebase/runtime</filename
6468
>. Para compilar o código-fonte, você também precisa dos pacotes de desenvolvimento do &Qt; e dos outros pacotes de bibliotecas relevantes.</para>
6471
>Os seguintes pacotes opcionais melhoram o &kalarm; na sua execução, se estiverem instalados:</para>
6476
>&jovie; (do pacote 'kdeaccessibility'): se estiver instalado e configurado, em conjunto com um sintetizador de fala compatível, permite ao &kalarm; falar as mensagens de alarme quando forem apresentadas.</para>
6481
>Você poderá encontrar uma lista das alterações no arquivo <filename
6482
>Changelog</filename
6483
> ou em <ulink url="http://www.astrojar.org.uk/kalarm"
6484
>http://www.astrojar.org.uk/kalarm</ulink
6488
<sect1 id="compilation">
6490
>Compilação e Instalação</title>
6493
>Se não conseguir encontrar um pacote binário adequado, irá necessitar de compilar você mesmo o &kalarm; a partir dos arquivos de código. Obtenha o pacote do código-fonte <filename
6494
>kdepim-x.x.tar.bz2</filename
6496
>kalarm-x.x.tar.bz2</filename
6497
> (ou algo do género), dependendo se deseja instalar o &package; ou apenas o &kalarm;. Descomprima-o numa nova pasta com um comando do tipo <userinput
6502
>pacote.tar.bz2</replaceable
6505
> e entre na pasta que foi criada.</para>
6506
&install.compile.documentation; <warning
6508
>Se você instalar o &kalarm; em uma pasta diferente da que o &kde; está instalado, ele não rodará corretamente a menos que você torne esta localização conhecida para o &kde;. Para fazer isto, você deve prefixar a variável de ambiente <envar
6510
> com a localização do &kalarm;, toda vez que for iniciar o &kde;.</para>
6513
>Por exemplo, se o &kde; estiver instalado em <literal
6517
> deve normalmente estar configurado para <literal
6518
>/etc/opt/kde:/opt/kde</literal
6519
>. Se você instalar o &kalarm; em <literal
6520
>/usr/local</literal
6521
>, você deve configurar o <envar
6524
>/usr/local:/etc/opt/kde:/opt/kde</literal
6525
> antes de iniciar o &kde;.</para
6529
>A versão autônoma do &kalarm; tem uma opção de configuração especial que lhe permite selecionar quais os idiomas da documentação instalar, indicando um código do idioma ou uma lista de códigos de idiomas como parâmetro do <command
6530
>./configure</command
6531
>. Por padrão, é instalada a documentação em todas os idiomas disponíveis. Está disponível uma lista com os idiomas da documentação incluídas no pacote, em conjunto com os seus códigos, no arquivo <filename
6532
>DOC-LANGUAGES</filename
6533
>. Lembre-se que isto não fará efeito na escolha das traduções das interfaces do usuário que são instaladas. Por exemplo, para instalar apenas a documentação em Francês e Português Brasileiro:</para>
6538
>./configure</command
6539
> --enable-doc-language=<replaceable
6540
>"fr pt_BR"</replaceable
6545
>Observe que esta opção não tem efeito em qual tradução de interface com o usuário será instalada.</para>
6549
<sect1 id="configuration">
6551
>Configuração</title>
6554
>Não é necessária nenhuma configuração especial para configurar o &kalarm; para rodar no ambiente de trabalho do &kde;. Logo que tenha rodado o &kalarm; pela primeira vez, ele irá iniciar sempre que você iniciar uma sessão, para poder monitorar os alarmes agendados.</para>
6557
>Para rodar o &kalarm; num ambiente de trabalho não-&kde;, o requisito principal é garantir que o &kalarm; é executado automaticamente sempre que você iniciar uma sessão. Você poderá obter instruções mais detalhadas no arquivo <filename
6559
> que é distribuído com o &kalarm;.</para>
6565
&documentation.index;
6570
sgml-minimize-attributes:nil
6571
sgml-general-insert-case:lower
6573
sgml-indent-data:nil