# Manual de &kalarm;

David
Jarvie

    &David.Jarvie.mail;

David
Jarvie

    &David.Jarvie.mail;

Desenvolvedor
Xosé
Calvo

Tradutor do proxecto Trasno
2001
2002
2003
2004
2005
2006
2007
2008
2009
&David.Jarvie;
&FDLNotice;
2009-11-28
2.04.00

&kalarm; é un programador de mensaxes persoais de alarma, comandos e correos electrónicos para &kde;.

KDE
kdepim
kalarm
alarma
lembranza
programador

## Introdución

&kalarm; permite programar que se mostren mensaxes persoais de alarma, se reproduzan ficheiros de son, se executen comandos e se envíen mensaxes de correo electrónico.

No seu modo gráfico por omisión, &kalarm; mostra unha listaxe de alarmas pendentes, xunto co momento para o que están programadas e os detalles. Pódense crear alarmas novas ou modificar e eliminar as alarmas existentes. Tamén se poden ver as alarmas caducadas.

Ao configurar unha alarma, pódese escoller que se repita e se cancela se non se pode activar no momento para o que estaba programada. Para mostrar as alarmas, pódese escribir unha mensaxe de texto, especificar un ficheiro de texto ou de imaxe que se vaia mostrar ou especificar un comando cuxa saída sexa o que se mostre. Pódese escoller tamén a cor da mensaxe de alarma e se se quere reproducir un son ou ler a mensaxe.

Alarms may also be scheduled from the command line, or via D-Bus calls from programs.

Cando lle toque aparecer a unha mensaxe de alarma, mostrarase en todos os escritorios de &kde; para asegurar que se vexa. A xanela coa mensaxe mostrar a hora para a que se programar a alarma. Normalmente ten unha opción de diferido para que se mostre de novo máis tarde. Eis un exemplo dunha mensaxe de alarma:

Captura da xanela de mensaxes de &kalarm;
Mensaxe de alarma

Cando a alarma especifica que se execute un comando ou que se envíe unha mensaxe de correo, &kalarm; non mostra nada.

Normalmente, &kalarm; mostra unha icona na bandexa do sistema, ainda que se pode agochar, se se quere.

## Usar &kalarm;

Cando se executa sen parámetros de liña de comandos, &kalarm; iníciase en modo gráfico e mostra a listaxe actual de alarmas.

Todos os controis numéricos de &kalarm; permiten aceleralos. Para que o valor mude a maior velocidade, manteña a tecla &Shift; premida ao tempo que usa as frechas dos controis.

### Alarm Types

The basic functions available from the different alarm types which KAlarm provides are:

- Display alarms display either a text message which you type in, or the contents of a text or image file, or the textual output from a command which is run when the alarm triggers. In addition to displaying one of these items, they can also play audio files, have their text spoken, or emit a simple beep. You can also specify commands to be executed before and after the alarm message is displayed.

- Command alarms execute either a command or a shell script which you can type in. Nothing is displayed unless an error occurs.

- Email alarms send a email. Nothing is displayed unless an error occurs.

- Audio alarms play an audio file. Nothing is displayed unless an error occurs.

#### Error Handling

If an error occurs when an alarm triggers, an error message will be displayed (unless you have previously specified not to show that type of message again).

If an execution error occurred the last time a command alarm triggered, a white on red exclamation mark is shown in the message color column. Details of the error are displayed in a tooltip if you position the cursor over that line in the alarm list. The same error indications are shown for display alarms if an execution error occurred for a pre- or post-alarm command specified in the Special Actions dialog, except that the color column is not changed to a red background.

### Listaxe de Alarmas

The main &kalarm; window displays the current list of pending alarms, showing their times, repetition intervals, colors, and message texts, names of files to play or display, commands to execute or email subjects. (For a recurring alarm, the time shown is its next scheduled trigger time. For an alarm with a reminder, the time shown is the time of the alarm proper, not the reminder time.) An icon at the left of each alarm text/file/command/email subject indicates the type of alarm.

Captura da xanela principal de &kalarm;
Xanela principal

Para unha alarma que se repita, a listaxe mostra o vindeiro momento no que se activará e o tempo de repetición báxico (p.ex. 1 Día para repetición diaria, 3 Semanaspara unha repetición que se active os luns e mércores de cada tres semanas, No inicio para unha alarma que se repita cada vez que se inicie o sistema).

If an execution error occurred the last time a command alarm triggered, or the last time a display alarm's pre- or post-alarm command was executed, an error indication is shown in the color column, as described in Error Handling above.

#### Changing the Alarm List Appearance

Pódense ordenar as alarmas por data/hora, intervalo de repetición, cor, tipo ou texto premendo na barra do título da columna correspondente. Para inverter a orde hai que premer de novo na barra do título.

Opcionalmente, pódese mostrar o tempo que falta até que se active cada alarma xunto con, ou no canto da hora para a que estaba programada. Para mostrar ou agochar a columna coa hora da alarma, escolla Vista Amosar as Horas das Alarmas. Para mostrar ou agochar a columna co tempo que falta, seleccione Vista Amosar Tempo que Falta. Sempre se mostra unha destas columnas.

If you use multiple alarm calendars, you can color code alarms according to which calendar they belong to, by selecting a different background color for each calendar.

#### Alarmas arquivadas

By default, &kalarm; archives alarms for a limited period once they have expired or been deleted. (But note that alarms which you delete are stored only if they have already triggered at least once.) You can control whether &kalarm; archives expired alarms, and for how long, in the Configuration dialog.

Archived alarms may be shown in the alarm list by selecting View Show Archived Alarms. To hide them again, deselect View Show Archived Alarms.

#### Procurar na lista de alarmas

You can search through the alarm list to find alarms containing a search text. To invoke this, select Edit Find.... In the search dialog, select the alarm types which you wish to search. To continue searching for more alarms which match, use Edit Find Next or Edit Find Previous .

A pesquisa realízase deste xeito:

- Alarmas con mensaxe de texto: procúrase o texto da mensaxe.

- Alarmas que mostran un ficheiro: procúrase o camiño ao ficheiro ou o URL.

- Alarmas con comando: procúrase a liña co comando ou o guión.

- Alarmas con correo electrónico: procúranse, ademais do asunto e o corpo da mensaxe, os destinatarios e os URLs dos arquivos anexos.

- Audio alarms: the file path/&URL; is searched.

Só se poden seleccionar para as pesquisas as alarmas que se mostren actualmente na listaxe de alarmas. Polo tanto, para procurar nas alarmas arquivadas hainas que mostrar primeiro tal e como se describe na sección anterior.

### Crear e manipular alarmas

#### Crear unha alarma nova

Para crear unha nova alarma, siga unha das instrucións seguintes e a continuación escolla o tipo de alarma da listaxe que aparece. Isto fai que aparece o diálogo de edición de alarmas, co que se pode configurar a alarma.

- Select File New.

- Right click on the system tray icon and choose New Alarm from the context menu.

- Prema co botón dereito do rato na listaxe de alarmas e escolla Nova no menú de contexto.

Alternativamente, pódense crear alarmas novas preconfiguradas a partir de varias fontes:

- Para basear a nova alarma nun modelo de alarmas, siga as instrucións da sección Modelos de alarma.

- To base your new alarm on an existing one, highlight the existing alarm in the list and select File Copy. This opens the Alarm Edit dialog already filled in with a copy of the selected alarm's details.

- Para crear unha alarma nova que mostre unha mensaxe de correo pre-existente, arrastre a mensaxe desde &kmail; para a xanela principal ou a icona da bandexa de sistema de &kalarm;. Isto abre o diálogo de edición de alarmas coa mensaxe de correo completa (incluído o remitente, destinatario, &etc;) como texto da alarma.

- Para crear unha alarma nova con mensaxe de correo para enviar unha copia dunha mensaxe de correo pre-existente, arrastre a mensaxe desde &kmail; para a xanela principal ou oa icona da bandexa do sistema de &kalarm;. A continuación seleccione a opción Correo. O diálogo de edición de alarmas xa se configura coa mensaxe completa, excepto o remitente.

- To create a new alarm which displays a summary of an existing to-do, drag the to-do from &korganizer; or other application onto &kalarm;'s main window or system tray icon. This opens the Alarm Edit dialog with the to-do contents as the alarm text.

- Cando se arrastra calquer texto para a xanela principal ou a icona da bandexa do sistema de &kalarm;, ábrese o diálogo de edición de alarmas e configúrase o texto da alarma.

- To create a file display alarm, drag a text or image file &URL; onto &kalarm;'s main window or system tray icon. This opens the Alarm Edit dialog and sets the file name.

- To create an audio alarm, drag an audio file &URL; onto &kalarm;'s main window or system tray icon. This opens the Alarm Edit dialog and sets the file name.

- Pódense crear automaticamente alarmas de cumpreanos para as persoas que teña no &kaddressbook;, tal e como se describe en Importar cumpreanos de &kaddressbook;.

#### Modificar unha alarma existente

Para modificar unha alarma pendente xa existente (as alarmas caducadas non se moden alterar), faga unha destas cousas:

- Faga dobre clic na súa entrada na listaxe de alarmas.

- Select it by clicking on its entry in the alarm list. Then choose Edit Edit.

- Prema co botón dereito do rato na entrada da listaxe de alarmas e escolla Editar do menú de contexto.

Con isto móstrase o diálogo de edición de alarmas.

#### Eliminar/reactivar unha alarma

To delete existing alarms, select one or more by clicking on their entries in the alarm list. Then do one of the following:

- Choose Edit Delete .

- Right click on the selected entries and choose Delete from the context menu.

- To delete them without a confirmation prompt, type &Shift;-Delete.

When you delete an active alarm, it is archived, provided that it has triggered at least once before being deleted, and provided that expired alarms are archived at all. (Use the Configuration dialog to control whether and for how long archived alarms are stored.) When you delete an archived alarm, or an active alarm which has not yet triggered, it is removed permanently.

Pódese reactivar unha alarma eliminada desde unha listaxe de alarmas arquivadas se ainda non caducou. para isto, mostre primeiro as alarmas arquivadas, como se describe en alarmas arquivadas. A continuación:

- Escolla unha ou máis alarmas arquivadas premendo nas súas entradas da listaxe de alarmas. Despois escolla Accións Reactivar.

- Prema co botón dereito do rato nas entradas desexadas da listaxe de alarmas arquivadas e escolla Reactivar do menú de contexto.

#### Activar/Desactivar unha alarma

Vexa activar e desactivar alarmas para saber como activar e desactivar alarmas, tanto unha a unha ou todas elas.

#### Confirmar unha alarma

Vexa fiestra de mensaxes de alarma para saber como confirmar que se viron as alarmas.

#### Modelos de alarma

Se ten que configurar con frecuencia alarmas semellantes, pode crear un modelo de alarma que lle evite ter que introducir todos os detalles desde cero de cada vez. Un modelo pode conter todos os detalles que poida conter unha alarma, aparte da data de inicio.

Como exemplo, pode que teña que crear unha alarma frecuentemente para que lle lembre un programa de televisión cuxa hora de emisión varíe de semana en semana. O modelo contería todos os detalles da alarma (texto da mensaxe, se reproducir un son, &etc;) excepto a hora e a data. Para crear a alarma, o único que hai que facer é abrir o diálogo de edición de alarmas con ese modelo e introducir a hora e a data.

Para crear unha alarma baseada nun modelo, abra o diálogo de edición de alarmas preconfigurado cos detalles do modelo:

- Select the File New From Template menu item, and then select the desired template.

- Prema co botón dereito do rato na icona da bandexa do sistema e escolla Nova Alarma Desde Modelo no menú de contexto. A continuación seleccione o modelo desexado.

- Abra o diálogo de edición de alarmas normalmente e calque no botón Cargar Modelo... para seleccionar un modelo co que preconfigurar o diálogo.

##### Configurar modelos

Pódense crear, modificar ou eliminar modelos co diálogo de modelos de alarma; tamén se pode crear un modelo novo para alarmas baseándose nunha alarma preexistente.

Para crear un modelo de alarma novo, faga unha destas cousas:

- Mostre o diálogo Modelos de Alarma seleccionando o elemento de menú Ficheiro Modelos... , premendo en Novo e escollendo o tipo de alarma da listaxe que aparece. Isto mostra un diálogo Editar Modelo en branco.

- Mostre o diálogo Modelos de Alarma seleccionando o elemento de menú Ficheiro Modelos... , seleccione un modelo existente da listaxe e prema en Copiar. Isto abre o diálogo Editar Modelos xa preenchido cunha copia dos detalles do modelo existente.

- Highlight an alarm in the alarm list and select File Create Template... . This opens the Template Edit dialog already filled in with a copy of the selected alarm's details.

Para modificar un modelo xa existente, mostre o diálogo Modelos de Alarma seleccionando o elemento do menú Ficheiro Modelos... e premendo Editar. Isto mostra o diálogo Editar Modelo que se describe máis abaixo.

Para eliminar modelos existentes, mostre o diálogo Modelos de Alarma seleccionando o elemento do menú Ficheiro Modelos..., seleccione un ou máis modelos e calque en Borrar. Háselle pedir confirmación para evitar eliminacións accidentais.

##### Diálogo de edición de modelos

O diálogo Editar Modelo é semellante ao diálogo de edición de alarmas. Os controles seguintes son diferentes:

- Introduza o nome do modelo en Nome do modelo . É o nome do modelo que se mostra nas listaxes de selección de modelos, así que o mellor é escoller un nome que lle lembre a súa función. O nome de cada modelo ha de ser único.

- No grupo de opcións Hora escolla:

  - Hora por omisión se non quere especificar ningunha hora de activación. As alarmas que se baseen neste modelo utilizarán inicialmente a hora de activación por omisión normal das alarmas novas.

  - Escolla Hora para introducir unha hora na que se activará a alarma.

  - Check Date only to specify that the alarm should only have a date, not a time.

  - Seleccione Tempo a partir de agora para introducir o tempo (en horas e minutos) en que se activará a alarma unha vez creada.

- No grupo de opcións Regra de Repetición na pestana Repetición non hai que seleccionar día nen mes para as repeticións semanais ou anuais, respectivamente.

#### Alarm Calendars

If you only use one computer and work independently, it may not matter to you where &kalarm; stores its alarms. But if you need to access alarms on more than one computer, or in more than one location on your local computer, you can define alarm calendars to tell &kalarm; to use other alarm calendars additional to, or in place of, its default ones.

You can view and manipulate calendars via the calendar list, which can be displayed alongside the alarm list in &kalarm;'s main window. Alarms from all alarm calendars are shown merged together in the alarm list. When you save a new alarm, you can set a configuration option to determine whether it is automatically saved into the default calendar, or whether you will be prompted to choose a calendar. When you edit an existing alarm, it is automatically saved back into its original alarm calendar.

Screenshot of the &kalarm; main window, showing the calendar list
Main window showing the calendar list

##### Calendar Types and Options

Alarm calendars are categorized by alarm type and storage type. They can be disabled, set read-only, or made the default calendar for their alarm type.

Tipo de alarma

  The three alarm entity types – active alarms, archived alarms and alarm templates – are stored in separate alarm calendars. &kalarm; therefore has three standard default calendars, one for each type (see Questions and Answers for details), which you can change if you wish.

Tipo de almacenamento

  &kalarm; handles three alarm calendar storage types:

  - Local file: Alarms are stored in a single local file in iCalendar format. &kalarm; uses local file calendars by default (see Questions and Answers for details). Local files, in addition to files on the local computer, can include alarm calendars on the local network as long as their location can be represented by a path name starting with `/`.

  - Directorio local: As alarmas almacénanse nun cartafol local e cada alarma vai nun ficheiro iCalendar separado dentro do cartafol. Este método de almacenamento ten a avantaxe de que, no caso de que se estrague un ficheiro, só se perdería unha alarma e non todo o calendario.

  - Ficheiro remoto: As alarmas almacénanse nun ficheiro remoto único no formato iCalendar. Este método de almacenamento permite acceder aos datas das alarmas de maneira remota sen importar onde se estea e permite que outra xente vexa os calendarios de alarmas. Ao empregar ficheiros remotos, &kalarm; traballa cunha copia local dos datos.

    If a remote alarm calendar is shared between users, changes made by one person may not be automatically made available to another user, or there could be a time delay before the other user sees it. So one user could make a change which is then overwritten by another user without either person noticing what has happened. The technical reason for this is that a change made by person A will only be available to person B after person A's cached copy has first been saved to the remote file, and then person B's cached copy of the remote file has been reloaded. When and if the calendar is saved and reloaded depends on the calendar configuration parameters which each user has set for that alarm calendar.

    Ways to avoid this problem include adjusting the calendar save and reload configuration parameters, or adopting a policy that users other than the alarm calendar's owner should open it in read-only mode.

Estado activado/desactivado

  Disabling a calendar has the same effect as removing it, except that it still appears in the calendar list for easy re-enabling. When disabled, its alarms are ignored and do not appear in the alarm list or list of templates. When it is re-enabled, its alarms are once again shown and, if it is an active alarm calendar, made active.

Estado de só lectura

  A read-only calendar's alarms cannot be changed or added to. So you cannot edit its alarms, or save new alarms to it. Also, it is not possible to defer its alarms, since to do so would need the deferral time to be saved into the alarm. After its alarms trigger, they are not removed from the calendar and archived until you or another user accesses the calendar in read-write mode.

  You can set the read-only status of a calendar in the calendar configuration dialog. However, some calendars cannot be made writeable, for various reasons:

  - If a calendar was created by another application, it would be unsafe to allow &kalarm; to update it, since differences in data format might make it unusable by the creating application.

  - If the calendar was created by a later version of &kalarm;, data might be lost if your version of &kalarm; updated it.

  - If the calendar was created by a previous version of &kalarm;, data could be lost or it could be made unusable for the previous &kalarm; version if your version of &kalarm; updated it. You will be prompted whether to convert its format so as to make it writeable, bearing in mind the potential compatibility problems if the previous &kalarm; version needs to access it again.

  - If you do not have permission to write to the calendar file or folder.

  If you need write access to alarms in a calendar which cannot be made writeable, you can copy its alarms by importing them into a writeable calendar using the latter calendar's Import... context menu option (see Importing Alarms from External Calendars).

Default calendar status

  One calendar of each alarm type can optionally be made the default calendar for that alarm type. New alarms are automatically saved to the default calendar for the appropriate alarm type, unless you have selected the prompt option for new alarms and templates in the Configuration dialog.

##### Using Calendars

You can view and manipulate calendars via the calendar list, which can be displayed or hidden by View Show Calendars . When using the calendar list, first select the alarm type using the combo box above the list. Then either click on one of the buttons below the list, or Right click on the appropriate calendar in the list and choose an item from the context menu. The actions available are:

Engadir...

  Add a calendar of the selected type to the list. You are asked to choose a storage type, following which the calendar configuration dialog is displayed, where you can enter the location of the calendar and its characteristics. If there is no existing alarm calendar in the specified location, a new one will be created.

Eliminar

  Remove the selected calendar from the list. The calendar itself is left intact; it is simply removed from the list, and may subsequently be reinstated in the list if desired.

Editar...

  Edit the selected calendar. This displays the configuration dialog for the selected calendar.

Cargar de novo

  Reload the selected calendar. The calendar is re-read from its storage location, ensuring that there is no discrepancy between what &kalarm; displays and the current state of the calendar. If the calendar is shared with other users, any changes which they have made will now be seen by &kalarm;.

  If you reload a remote calendar, any changes to alarms which you have made since the calendar was last saved will be lost. Also, any alarms which have expired since the last save may be retriggered.

Gardar

  Save any changes to the selected calendar. The calendar is updated with any alarm changes which have occurred since the last time the calendar was saved or reloaded. This is only useful for remote calendars, since local calendars are automatically saved after every change. You can configure when and how frequently a remote calendar should be automatically saved, using its configuration dialog (via the Edit... context menu option).

  If you save a remote calendar which is shared with other users, any changes which they have made since you last reloaded the calendar (automatically or manually) will be lost.

Importar...

  Import alarms from an external calendar file into the selected calendar. This is described in Importing Alarms from External Calendars. This option is not available for disabled or read-only calendars.

Export...

  Export all the alarms in the selected calendar to an external calendar file. This is described in Exporting Alarms to External Calendars. This option is not available for disabled calendars.

Mostrar Detalles

  Display details about the selected calendar. This shows the calendar's location, storage type and status information.

Usar como predefinido

  Make the selected calendar the default calendar for the selected calendar type. This option is not available for disabled or read-only calendars.

Estabelecer a cor...

  Select a background color for highlighting this calendar's alarms in the alarm list. This enables you to see at a glance which alarms belong to a particular calendar.

Limpar a cor

  Clear color highlighting for this calendar's alarms in the alarm list.

#### Importar alarmas desde calendarios externos.

Pódense importar alarmas desde outros ficheiros de calendario ao &kalarm;. A función de importación examina no ficheiro de calendario seleccionado os eventos que conteñan alarmas e cópiaos (cos seus IDs únicos novos) ao calendario do &kalarm;. Ignóranse os eventos sen alarmas e as entradas de calendario distintas dos eventos. Hai dous xeitos de importar alarmas:

- Utilice Ficheiro Importar Alarmas... para importar alarmas de todos os tipos (alarmas activas, alarmas arquivadas e modelos de alarmas) desde o calendario.

  If you have configured alarm calendars, alarms of each type will be added to the appropriate default calendar, or if you have selected the prompt option for new alarms and templates in the Configuration dialog, you will be prompted for the calendar to use.

- Right click on a calendar in the calendar list, and choose Import... from the context menu. This imports alarms of the currently selected type into that calendar. For example, if the selected calendar type is alarm templates, alarm templates (and not active alarms or archived alarms) will be imported.

Se importa alarmas desde ficheiros de calendario creadas por aplicacións distintas de &kalarm;, as alarmas modificaranse co proceso de importación – poden mudar mesmo as horas de activación. Isto depende das convencións de almacenamento de datas empregadas pola outra aplicación e é inevitábel se esas convencións difiren do que espera &kalarm;. Verifique sempre as alarmas importadas por se hai alteracións inesperadas e axústeas.

#### Exporting Alarms to External Calendars

You can export alarms from &kalarm; to other calendar files, either the alarms currently selected in the alarm list, or all the alarms from an alarm calendar. The methods to do this are given below. Whichever method is used, you can either create a new calendar file or append the exported alarms to an existing calendar file. To append the alarms, check Append to existing file in the file selection dialog; otherwise, any existing file is overwritten.

- To export the alarms currently selected in the alarm list, Right click on the selection and choose Export... from the context menu, or use File Export Selected Alarms... in the main menu.

- To export all the alarms from a calendar, Right click on a calendar in the calendar list, and choose Export... from the context menu.

#### Importar cumpreanos desde o &kaddressbook;

Pódense configurar alarmas para cumpreanos almacenados no &kaddressbook; mediante Ficheiro Importar Cumpreanos.... Móstrase un diálogo que permite seleccionar os cumpreanos para os que se queira crear alarmas.

- No grupo de opcións Alarma con Texto pódense configurar o texto que se ha de mostrar nas mensaxes de alarma de cumpreanos. O texto da mensaxe créase combinando o texto Prefixo seguido do nome da persoa seguido do texto Sufixo. Non se engaden espazos, así que ha de lembrarse de incluir os espazos que segan o Prefixo e os que precedan o Sufixo.

  Se muda o texto da alarma, a lista de selección de cumpreanos avaliarase de novo.

- Na lista Seleccionar Cumpreanos, seleccione os cumpreanos para os que queira crear alarmas. Teña en conta que a lista mostra só as entradas de &kaddressbook; que conteñan un cumpreanos e que non teñan xa unha alarma de cumpreanos no formato definido actualmente no grupo de opcións Texto con Alarma.

- Os controles restantes son os mesmo que para as alarmas de Texto do diálogo de edición de alarmas.

If you have configured alarm calendars, the alarms will be added to the default active alarm calendar, or if you have selected the prompt option for new alarms and templates in the Configuration dialog, you will be prompted for the calendar to use.

#### Desfacer / Refacer

Pode desfacer e facer de novo as modificacións máis recentes realizadas durante a sesión actual do &kalarm;. Pódense desfacer a maioría das accións, incluída a creación, edición e eliminación de alarmas e modelos de alarma e a reactivación de alarmas. Para evitar que se empreguen recursos excesivos no historial de desfacer, o número de modificacións que se almacenan está limitado a 12.

Para desfacer a modifiación máis recente, seleccione Editar Desfacer. Para desfacer a última alteración desfeita, seleccione Editar Refacer .

Para desfacer unha alteración distinta da máis recente, calque no botón Desfacer da barra de tarefas e manteña o botón do rato premido. Aparecerá unha listaxe de accións de entre as que pode escoller a que queira desfacer. Se non ve a acción que procura, lembre que pode ser que teña que desfacer antes máis cambios recentes dos que depende o cambio desexado. Por exemplo, se editou unha alarma e despois a eliminou, non pode desfacer a edición até ter desfeito antes a eliminación.

Volver a facer un cambio distinto do último pódese facer de xeito semellante mediante o botón da barra de ferramentas Refacer.

### O diálogo de edición de alarmas

The Alarm Edit dialog enables you to view and edit an alarm. When you first use &kalarm;, a simplified form of the dialog is displayed, with only a small number of options visible. To see all options, click the More Options button; to revert to the simplified dialog, click the Less Options button. &kalarm; always remembers your last display choice whenever the Alarm Edit dialog is redisplayed.

Screenshot of the simplified Alarm Edit dialog
Simplified Alarm Edit dialog for a display alarm

Simplified Alarm Edit dialog for a display alarm

Screenshot of the Alarm Edit dialog showing all options
Alarm Edit dialog for a display alarm, showing all options

Alarm Edit dialog for a display alarm, showing all options

#### Acción da alarma

Os controles do grupo de opcións Acción varían dependendo do tipo de alarma que se estea a editar.

##### Alarmas visuais

As alarmas visuais mostran unha xanela cando se activa a alarma. Seleccione o método empregado para xerar o contido da xanela da alarma na lista despregábel da parte superior:

- Mensaxe de texto para introducir un texto de mensaxe de alarma (que pode incluir puntos e aparte) na caixa de edición.

- Contidos de ficheiro para introducir o camiño ou &URL; dun ficheiro de texto ou de imaxe cuxos contidos se queren mostrar na mensaxe de alarma. Empregue o botón que está a carón da caixa de edición para mostrar un diálogo de selección de ficheiro. A opción Ler non está disponíbel para este tipo de alarma.

- Saída de comando para especificar que o texto da mensaxe xerarao automaticamente un comando que se executará cando se active a alarma. Vexa alarmas con comandos máis abaixo para detalles sobre como introducir o comando ou guión que se queira executar.

Os controles disponíbeis para as alarmas visuais son:

- A opción Son permite seleccionar se se quere que se reproduza un son cando se mostre a mensaxe da alarma. Escolla:

  - Ningún para que a alarma se mostre en silencio.

  - Badalada para que se escoite unha badalada.

  - Speak to have the alarm message spoken as well as being displayed. This option is only available if you have KTTSD (from the kdeaccessibility package) installed and configured, together with a compatible speech synthesizer, &eg; Festival.

  - Ficheiro de son para reproducir un ficheiro de audio. Empregue o botón da dereita para mostrar o diálogo Ficheiro de Son, que eprmite seleccionar un ficheiro para reproducir e axustar as opcións de volume e repetición. Se pasa o rato por riba do selector aparece unha xaneliña co ficheiro de audio seleccionado nese momento.

    No diálogo Ficheiro de Son:

    - Introduza o camiño ao ficheiro de son ou empregue o botón a carón da caixa de edición para mostrar un diálogo de selección de ficheiro. Pode escoitar o ficheiro seleccionando se preme no botón de reprodución que está á esquerda do campo de edición. Ese botón cambia de función para permitirlle deter a reprodución cando xa escoitase abondo.

    - Seleccione Repetir para que o ficheiro de audio se repita continuamente durante todo o tempo que se mostre a mensaxe (a xanela de mensaxe de alarma contén un botón para deter a reprodución do son se non a quere escoitar máis mais quere que ainda se vexa a alarma).

    - Seleccione Volume e axuste a barra deslizante para axustar o volume ao que se reproducirá o ficheiro de son.

    - Se quere, pode facer que o volume se esvaeza. Esvaecemento significa que se comece a reproducir o ficheiro de audio a un volume e que varíe gradualmente até o volume final durante un intervalo de tempo especificado. O volume final é o que se introduciu antes en Volume. Para permitir o esvaecemento, escolla Esvaecer e introduza o período de esvaecemento en segundos no campo Tempo de esvaecemento e axuste o control do Volume inicial.

    Pode empregar o botón Tentar para probar os niveis de son seleccionados.

- Use the Font & Color... button to select a font, and foreground and background colors, for the alarm message. In the Choose Alarm Font & Color dialog, check Use default font to display the message in whatever font is configured as the default at the time the message is displayed. To choose a specific font for the message, uncheck Use default font. (The default font and colors can be set in the Configuration dialog.)

  The selected colors are shown in the alarm message text entry field.

- Empregue o botón Accións Especiais... para especificar os comandos de consola que queira executar antes ou despois de mostrar a alarma. No diálogo Accións Especiais de Alarma:

  - No campo Acción previa á alarma introduza o comando de consola que queira executar antes de que se mostre a alarma. TEña en conta que &kalarm; agardará a que se complete o comando antes de mostrar a alarma.

    Unha acción previa á alarma só se executa unha vez cando se mostra inicialmente a mensaxe da alarma, incluso cando se substitúe un mensaxe de lembranza pola mensaxe real da alarma. Non se executa en ningunha das circunstancias seguintes:

    - Cando se mostra unha mensaxe de lembranza.

    - Cando se volve a mostrar a mensaxe despois de adiar a alarma.

    - Cando a mensaxe se estaba a mostrar e se apagou o ordenador e se reactiva ao prendelo de novo.

    - Cando se activa unha alarma recorrente mais ainda é visíbel a mensaxe de alarma (ou unha mensaxe de alarma adiada) dunha activación anterior; noutras palabras, cando a ocorrencia previa da alarma non se recoñeza.

  - No campo Acción posterior á alarma introduza o comando de consola que queira executar cando se recoñeza a alarma (tanto premendo Pechar como empregando o botón de fechar da barra de título da xanela). Non se executa en ningunha das circunstancias seguintes:

    - Cando se fecha unha mensaxe de lembranza.

    - Cando se adía a alarma, excepto cando a alarma adiada se recoñece.

    - Cando se fecha a mensaxe de alarma porque se apaga o equipo.

  Vexa Alarmas con comandos máis abaixo para detalles acerca de como se executan os comandos de consola.

##### Alarmas con comandos

As alarmas con comando executan un comando sen mostrar ningunha mensaxe de alarma.

Este tipo de alarma non está disponíbel se &kde; se está a executar en modo quiosque.

Os controles disponíbeis para as alarmas con comando son:

- A opción Introducir un guión permite escoller se se introduce unha liña de comando de consola ou un guión.

  Se non se selecciona esta opción, pódese introducir unha aliña de comando para executar. O comando pásase directamente á consola por omisión (definida pola variábel de contorno `SHELL`) e pode incluir todas as opcións, parámetros, comandos entubados, &etc; que permita a consola nun comando dunha soa liña.

  Se se selecciona esta opción pódese introducir o texto dun guión para que se execute. Lembre incluir unha primeira liña tipo `#!/bin/bash` para asegurarse de que se invoca o intérprete de comandos axeitado.

- Emprgue o grupo de opcións de Saída do Comando para especificar que é o que quere que se faga coa saída de terminal que produza o comando cando se execute.

  - Check Execute in terminal window to cause the command to be executed in a terminal window. You can choose which type of terminal window should be used in the Configuration dialog.

  - Escolla Rexistrar nun ficheiro para gardar a saída do comando nun ficheiro. A saída, precedida dun cabezallo que mostra a hora á que estaba programado que se executase o comando, irá seguida do contido do ficheiro. Introduza o nome do ficheiro na caixa de edición ou empregue o botón que está a carón a caixa de edición para mostrar un diálogo de selección de ficheiros.

  - Escolla Descartar para desbotar a saída do comando.

##### Alarmas con correo electrónico

As alarmas con correo electrónico envían unha mensaxe sen mostrar unha mensaxe de alarma.

Encha os enderezos dos destinatarios, a liña co asunto da mensaxe e o corpo da mensaxe nos tres campos de edición. Empregue o botón que está a carón da caixa de edición de destinatarios para que se mostre o caderno de enderezos do &kde; e poder seleccionar así os destinatarios. Pódense engadir ficheiros anexos mediante o botón Engadir.... Teña en conta que os ficheiros anexos han de existir cando se active a alarma; non se garda ningunha copia cando se configura a alarma. Para retirar un anexo, resálteo na lista despregábel e prema no botón Borrar.

Configure as opcións seguintes:

- The From combo box allows you to select which &kmail; identity to use as your email address for sending the email. This option only appears if your From email address in the Configuration dialog is set to Use &kmail; identities. Otherwise your email address is preset in the Configuration dialog, rendering this option inapplicable.

- Check Copy email to self to send a blind copy of the email to yourself when the alarm is triggered. The email address to which the copy will be sent may be set in the Configuration dialog, the default being your email address set in the &kde; System Settings.

##### Audio Alarms

Audio alarms play an audio file without displaying any alarm message.

Configure as opcións seguintes:

- Enter the sound file path, or use the button beside the edit box to display a file selection dialog.

- Check Repeat to continually repeat the audio file until the Stop Play option is selected. To stop playing the file, select the Actions Stop Play menu option, or Right click on the system tray icon and choose Stop Play from the context menu. If you wish, you can set up a global shortcut key for this action.

- Seleccione Volume e axuste a barra deslizante para axustar o volume ao que se reproducirá o ficheiro de son.

- Se quere, pode facer que o volume se esvaeza. Esvaecemento significa que se comece a reproducir o ficheiro de audio a un volume e que varíe gradualmente até o volume final durante un intervalo de tempo especificado. O volume final é o que se introduciu antes en Volume. Para permitir o esvaecemento, escolla Esvaecer e introduza o período de esvaecemento en segundos no campo Tempo de esvaecemento e axuste o control do Volume inicial.

#### Adiamento

Se a alarma é recorrente e foi adiada despois de mostrala a última vez, o grupo de opcións Alarma Adiada mostra o tempo que se adiou a alarma. Mudar... mostra un diálogo que permite alterar o tempo de adiamento ou cancelalo.

#### Hora

No grupo de opcións Tempo escolla

- Na data/hora para introducir a data e hora na que se ha de activar a alarma. Seleccione A calquera hora se quere especificar só unha data para a alarma: neste caso a alarma mostrarase na primeira oportunidade en ou despois da hora en que comeza o día na data especificada (Configurar &kalarm; describe como configurar o momento en que comeza o día).

  Se a alarma non se repite, a data/hora que introduza ha de estar no futuro; se só se introduce unha dat, ha de ser hoxe ou máis tarde. Para unha alarma que se repita non hai restricións, dado que da data/hora de inicio axustaranse automaticamente á primeira repetición que se produza após o momento actual.

- Tempo desde agora para introducir en canto tempo a partir de agora (en horas e minutos) se ha de activar a alarma.

If desired, choose a time zone to apply to the alarm. This time zone is used for all dates and times relating to this alarm, including recurrence and exception dates and times. Normally, you should leave the time zone controls unchanged unless you have a good reason to change them.

The time zone controls are displayed only when the selected time zone is different from the default time zone set in the Configuration dialog, or if you click the Time Zone... button.

- In the combo box, choose the time zone which this alarm is to use. When creating a new alarm, this is initially set to the time zone selected in the Configuration dialog, which will be your computer's time zone unless you have changed it.

- Escolla Ignorar o fuso horario se quere utilizar a hora local do computador (no computador no que se estea a executar o &kalarm; nese momento), ignorando as zonas horarias.

  Recoméndase non seleccionar esta opción se a repetición da alarma está especificada en horas e minutos; se o fai, a alarma pode activarse en momentos inesperados cando mude a hora na primavera e no outono.

#### Lembranza

For a display alarm, check Reminder if you want to display a reminder in advance of the main alarm and of each of its recurrences (if any). Enter how long in advance using the edit controls beside the check box.

Reminders are not displayed for sub-repetitions within a recurrence. Reminders are only shown before each main recurrence of the alarm.

If the alarm recurs, check Reminder for first recurrence only if you only want a reminder before the alarm's first recurrence. If this is not checked, the reminder period is limited to being less than the recurrence interval.

#### Cancelación

As opcións do periodo de cancelación determinan como se ha tratar unha alarma após o momento para o que estaba programada:

- A opción Cancelar se tarda determina o que acontece se a alarma non se pode activar no momento para o que estaba programada.

  Seleccione esta opción para cancelar a alarma se non se pode activar dentro dun periodo dado de tempo após o que debera ser. O periodo de tempo selecciónase usando os controles que aparecen cando se selecciona a opción. Por exemplo, se introduce un periodo de tempo de unha hora, a alarma activarase na primeira oportunidade até unha hora máis despois daquela para a que estaba programada, mais se non se pode activar antes de unha hora, cancélase a activación.

  A tardanza de alarmas só de data, &ie; aquelas para as que se seleccionou a opción A calquera hora calcúlase desde o momento de inicio do día da data para a que está programada a alarma.

  Non seleccione isto para que a alarma se activa na primeira oportunidade a partir do momento para o que estaba programada, independentemente do tarde que sexa.

  Un alarma só se pode activar estando o computador aceso e con tanto X como &kalarm; a se executaren.

- Seleccione Fechar a fiestra automaticamente despois deste tempo se quere que a xanela da alarma se feche automaticamente se ainda se está a mostrar cando caduque o tempo de cancelación tardía.

#### Recorrencia

Especifique se a alarma debería repetirse e como mediante a pestana Recorrencia.

As características básicas de repetición da alarma móstranse, para que sexa máis cómodo, no título da pestana Recorrencia. Móstrase primeiro o intervalo de repetición, seguido dos intervalos de sub-repetición configurados mediante o botón Sub-Repetición.

No grupo de opcións Regra de Recorrencia, configure o tipo de repetición ou periodo de tempo como sigue:

- Para que a alarma se active só unha vez, seleccione Sen repetición.

- Seleccione No inicio para que a alarma se active cando entre no sistema até o momento en que remate a súa programación. Despois, no momento de remate programado activarase unha última vez (teña en conta que unha alarma que se repita no inicio tamén se activará cada vez que reinicie &kalarm;).

- Para que unha alarma se repita a intervalos regulares, escolla un dos tipos de períodos temporais e introduza na caixa Repetir cada o número de periodos temporais que deben pasar entre as repeticións. Por exemplo, para que se repita cada quincena, pode seleccionar Diriamente e introducir o valor 14 ou seleccionar Semanalmente e introducir o valor 2. Dependendo do periodo temporal selecionado hai mesmo máis opcións:

  - Para repeticións semanais, escolla todos os días da semana nos que quere que se active a alarma.

  - Para repeticións mensais, pode seleccionar unha data fixa ou unha posición (&eg; o segundo martes).

  - Para repeticións anuais, pode seleccionar tanto unha data fixa do mes como unha posición nun mes (&eg; o derradeiro sábado de maio). Escolla cada mes do ano no que desexa que se active a alarma.

    If you set up a yearly recurrence for February 29th, you can specify how it is to be handled in non-leap years by selecting the appropriate February 29th alarm in non-leap years option:

    - None: the alarm will occur on February 29th in leap years, but will be suppressed in non-leap years.

    - 28 Feb: the alarm will occur on February 29th in leap years, and on February 28th in non-leap years.

    - 1 Mar: the alarm will occur on February 29th in leap years, and on March 1st in non-leap years.

  Para que unha alarma diaria só e active durante os días laborais, empregue unha repetición semanal e seleccione cada día laboral.

No grupo de opcións Remate da Recorrencia, configure a duración xeral da repetición como segue:

- Seleccione Non rematar para que as repeticións continúen indefinidamente.

- Seleccione Rematar despois de para especificar o número total de repeticións da alarma.

- Seleccione Rematar o para especificar a data/hora até que se repetirá a alarma. Teña en conta que isto emprega a mesma zona horaria que a hora de inicio da alarma.

  A data/hora final determina cando terá lugar a derradeira repetición, mais non limita as sub-repeticións. Se se configuran sub-repeticións, activaranse como habitualmente, despois da derradeira repetición, independentemente da data/hora.

The Exceptions group box allows you to exclude certain date/times from the recurrence which you have set up. Note that these controls are not shown in the simplified form of the Alarm Edit dialog: to see them, click More Options.

- The list of exceptions (&ie; excluded date/times) is shown on the left. To add a new exception, enter a date on the right and press Add. To change an exception, highlight it in the list, enter the new date on the right and press Change. To delete an exception, highlight it in the list and press Delete.

- You can restrict an alarm not to occur on holidays by checking Exclude holidays. This does not change the way the alarm is scheduled; it simply suppresses the alarm whenever it happens to trigger on a holiday. You can select your holiday country or region in the Configuration dialog.

- You can restrict an alarm to occur only during working time by checking Only during working hours. This does not change the way the alarm is scheduled; it simply suppresses the alarm whenever it happens to trigger outside working hours. Work days and working hours are set in the Configuration dialog.

##### Sub-Repetición

Pode empregar o botón Sub-Repetición para configurar unha repetición dentro dunha repetición. Neste caso, cada vez que teña que activarse a alarma, tal e como se especifica na repetición principal, no canto de activarse só unha vez, actívase repetidamente de acordo con como se especificou a sub-repetición. Por exemplo, para configurar unha alarma que se repita cada hora entre mediodía e as seis da tarde cada xoves, configúrase unha repetición semanal o xoves ás 12:00 e utilízase o diálogo de sub-repetición para especificar un intervalo de unha hora e, ora un total de 6, ora unha duración de 6 horas.

No diálogo de sub-repetición que se mostra ao premer no botón Sub-Repetición, prema Repetir cada para configurar repeticións, ou non o seleccione para eliminar a repetición. Se se selecciona Repetir cada, configure a repetición como segue:

- Introduza o intervalo de tempo entre repeticións nos controis que están a carón de Repetir cada. Seleccione as unidades temporais que queira (&eg; días) e a seguir introduza o número de unidades.

- Pode especificar tanto o total de repeticións como a duración:

  - Seleccione Número de veces para introducir o número de veces que se debería activar a alarma despois da repetición principal. Por exemplo, para que a alarma se repita catro veces en cada repetición, &ie; tres veces a maiores, introdúcese un 3 aquí.

  - Seleccione Duración para introducir o periodo total de tempo durante o que se ha de repetir a alarma. Non ten por que ser un múltiplo exacto do intervalo de repetición; redondearase automaticamente para baixo cando prema Aceptar.

Para evitar que se solapen as sub-repeticións dunha mesma alarma, restrínxese a duración dunha repetición a ser menor do que o intervalo maior entre as repeticións principais. Cada vez que se repite a alarma tal e como se especifica na repetición principal, cancélase calquer sub-repetición ainda activa que se iniciase na repetición anterior.

#### Outros controis

Para as alarmas visuais, a opción Confirmar recoñecemento permite especificar se lle pide confirmación ao usuario para fechar a xanela coa mensaxe da alarma. Isto pódese utilizar como salvagarda frente o recoñecemento accidental de alarmas.

Seleccione Amosar en &korganizer; para engadir a alarma ao calendario activo do &korganizer;, no que aparecerá como evento sen alarma. Esta opción permítelle seguir as alarmas en &korganizer; ao tempo que lle permite utilizar as funcións do &kalarm;.

Se posteriormente modifica ou elimina a alarma en &kalarm;, o evento de &korganizer; alterarase ou eliminarase consecuentemente. Mais se muda o evento en &korganizer;, a alarma de &kalarm; non se verá afectada.

Prema o botón Cargar Modelo para seleccionar un modelo co que preencher o diálogo, tal e como se describe en Crear e manipular alarmas.

Prema o botón Tentar para probar a alarma e comprobar que funciona correctamente. A alarma execútase como se estivese programada de maneira normal.

Press the OK button when all details are correct, to add the alarm to the scheduled list. Note that when editing an existing alarm, the OK button is disabled while no changes have been made.

### Fiestra de mensaxes de alarma

Cando se activa unha mensaxe de alarma, móstrase en todos os escritorios de &kde; e non a tapan as xanelas normais, para asegurarse así de que a ve. A xanela da mensaxe mostra a hora para a que se programara a alarma, de maneira que a poida ver se nese momento estaba ausente do computador. Se a hora para a que se programara a alarma está nun fuso horario distinto do que está configurado para o seu computador, tamén se mostrará a zona horaria (para as mensaxes de lembranza, a data/hora que se mostra é a da alarma principal ou da súa repetición, non a hora da mensaxe de lembranza, e o título da xanela é Lembranza).

As xanelas das mensaxes de alarma fican visíbeis até que vostede as recoñece, a non ser que se escollese Fechar a fiestra automaticamente despois deste tempo no diálogo de edición de alarmas. No caso dunha alarma repetitiva, a xanela existente simplemente aparece cando se repite a alarma. Isto evita ter que recoñecer varias copias da mesma mensaxe se vostede non quixer, ou non poder, recoñecer a mensaxe cando apareza.

A xanela da mensaxe de alarma fornece as opcións correspondentes á alarma que se mostra:

- Recoñecer a alarma premendo no botón Fechar. Isto fecha a xanela (despois de pedir confirmación, se se seleccionou Confirmar recoñecemento).

- Editar a alarma premendo o botón Editar.... Isto mostra o diálogo de edición de alarmas.

- Display options to defer the alarm until later by clicking the Defer... button. Then select Defer to date/time to enter the date and time when the message is to be redisplayed, or select Defer for time interval to enter how long after now (in hours and minutes) the message should be redisplayed. Then click OK to defer the alarm message and close its window.

  The time the alarm is deferred to must be earlier than its next scheduled occurrence or next reminder. For this reason, the Defer... button in the alarm message window and the OK button in the Deferral dialog are disabled one minute before the next occurrence or reminder.

  O botón Adiar... non está disponíbel para as alarmas que se mostran no inicio cando se selecciona Repetir no inicio.

- Para deter a reprodución do ficheiro de son da alarma, prema o botón co símbolo deter a reprodución.

- Se a mensaxe de alarma se creou arrastrando unha mensaxe desde o &kmail;, pódese acceder directamente á mensaxe en &kmail; premendo no botón que mostra a icona do &kmail;. Así, seleccionarase e resaltarase a mensaxe na listaxe de cartafoles do &kmail;.

  Se se rexeneran os índices do &kmail;, perderase a ligazón á mensaxe no &kmail;.

- O botón que mostra a icona do &kalarm; fornece un xeito cómodo de activar o &kalarm;.

You can choose in the Configuration dialog which of two different modes should be used to display alarm message windows:

- Como xanela normal. Neste modo, a xanela coa mensaxe de alarma toma o foco do teclado cando aparece, de xeito que, se se está a escribir, o que se escribe pasará para ela no canto de seguir ana aplicación orixinal.

- Como xanela non modal. Neste modo, cando aparece a xanela coa mensaxe de alarma, non se altera o foco do teclado, de xeito que non interfire co que se está a escribir. Porén, neste modo a xanela non ten barra de título nen moldura, polo que non se pode mover ou mudar de tamaño.

When an alarm is displayed on top of a full screen application, it is shown as a non-modal window regardless of this configuration setting. This is due to a limitation of the window system.

#### Positioning of Message Windows

You can choose in the Configuration dialog which of two schemes should be used to position alarm message windows:

- As xanelas móstranse tan lonxe como for posíbel do cursor actual do rato. Isto minimiza o entorpecemento do traballo e reduce a posibilidade de recoñecer a alarma por accidente.

- As xanelas móstranse no centro da pantalla. Para reducir as posibilidades de mostrar a recoñecer a alarma por accidente, os botóns da xanela desactívanse e só se activan após unha demora configurábel.

If you have several alarm message windows, or error messages, displayed, you can spread the windows out across the screen to make them all visible, or group them all together again in the top left corner of the screen, by means of the View Spread Windows menu option. If you wish, you can set up a global shortcut key for this action.

### Funcionamento da bandexa do sistema

&kalarm; by default displays an icon in the system tray. The icon provides both control and an alarm monitoring status indication. A normal &kalarm; icon indicates that alarms are being monitored, while a gray icon indicates that alarms are not being monitored. If some individual alarms are disabled, a small cross is overlaid on the icon.

If you hover the mouse cursor over the system tray icon, a summary of the first few message alarms due in the next 24 hours are displayed as a tooltip. You can switch this feature off, or configure the number of alarms to display and their format, in the Configuration dialog.

Prema co botón esquerdo do rato na icona da bandexa do sistema para alternar entre mostrar e agochar a xanela principal do &kalarm;.

Prema co botón esquerdo do rato na icona da bandexa do sistema para mostrar o seu menú de contexto:

Activar alarmas

  Enables or disables monitoring of alarms.

  Vexa activar e desabilitar alarmas para máis detalles.

Alarma nova

  Unha vez seleccionado o tipo de alarma da lista que aparece, ábrese o diálogo de edición de alarmas para crear unha alarma nova.

Alarma nova desde modelo

  Mostra a lista de modelos de alarma dun menú. Cando se selecciona un, ábrese o diálogo de edición de alarmas, enchido cos detalles dese modelo.

Stop Play

  Halts playback of the audio file currently playing.

Spread Windows

  Spreads alarm and error message windows across the screen, or groups them together again.

Configurar o &kalarm;...

  Displays the &kalarm; Configuration dialog.

  The Configuration dialog is described in Configuring &kalarm;. It includes options relating to the &kalarm; system tray icon.

Restaurar / Minimizar

  Restaura ou minimiza a xanela principal do &kalarm;.

Sair

  Fecha a icona da bandexa do sistema do &kalarm; e as xanelas principais.

  Sae de &kalarm; se non se mostra ningunha xanela de mensaxes de alarma.

#### Mostrar o &kalarm; na bandexa do sistema

Para que se mostre o &kalarm; na bandexa do sistema, ha de estarse a executar o escritorio &kde;, ou calquer outro xestor de xanelas axeitado.

Para que se mostre o &kalarm; na bandexa do sistema, seleccione Vista Mostrar na Bandexa do Sistema .

To remove &kalarm; from the system tray, deselect View Show in System Tray.

To choose whether or not &kalarm; will be shown at startup in the system tray, use the View tab of the Configuration dialog.

### Refrescar alarmas

If in the unlikely event that any alarm was not triggered when it should have been, you can refresh the alarm list and trigger any missed alarms by selecting Actions Refresh Alarms . This causes &kalarm; to reload all alarm calendars.

You can reload an individual calendar and refresh its alarms in the alarm list by Right clicking the calendar in the calendars list and selecting the Reload menu option. See Alarm Calendars for details.

### Activar e desactivar alarmas

Pódense activar e desactivar as alarmas enteiramente ou individualmente:

- A Vixilancia das alarmas aplícase ás alarmas como un todo. Se a vixilancia das alarmas non está activada, non se activa ningunha alarma. Se se activa a vixilancia das alarmas (a situación normal), todas as alarmas que non se desactivasen individualmente hanse activar cando lles corresponda.

  Cando se volve a activar a vixilancia das alarmas, actívanse as alarmas que se deberían ter activado mentres estaba desactivada (a non ser que unha acción de cancelación tardía o impida). Noutras palabras, desactivar a vixilancia das alarmas ten o mesmo efecto que deter &kalarm; – as alarmas adíanse até que se reactiva.

- Pódense activar e desactivar individualmente as alarmas, independentemente do estado de vixilancia da alarma. En consecuencia, o estado de activación/desactivación das alarmas individuais ficará sen alteracións desactivando e despois volvendo a activar a vixilancia das alarmas. Ao contrario da vixilancia das alarmas que podería potencialmente desactivarse debido a &kalarm;, non executar alarmas individuais só se pode desactivar se se utilizan para iso comandos de menú.

  Cando se reactiva unha alarma individualmente, non se activa se o debía facer cando estaba desactivada. Noutras palabras, desactivar unha alarma individual cancela todas as súas repeticións até que se reactiva.

  An alarm's individual enabled/disabled status is indicated by its color in the alarm list (the color being configurable in the View tab of the Configuration dialog).

Para que se active unha alarma, ha de ser activada individualmente e tamén a vixilancia das alarmas.

#### Desactivar a vixilancia das alarmas

For alarm monitoring to occur, &kalarm; must be running. Once you run &kalarm;, it will from then on start automatically whenever you log in unless you later disable it in the General tab of the Configuration dialog.

Se a vixilancia das alarmas está desactivada, faga unha das cousas seguintes para activar as alarmas:

- Seleccione Accións Activar Alarmas.

- Prema co botón dereito do rato na icona da bandexa do sistema e escolla Activar Alarmas no menú de contexto.

#### Desactivar a vixilancia das alarmas

Pódese desactivar temporalmente a vixilancia das alarmas, o que impide que &kalarm; comprobe as alarmas até que se volvan a activar ou – asumindo que o &kalarm; está configurado para que se execute no inicio – até a próxima vez que se entre no sistema.

- Unselect Actions Enable Alarms.

- Right click on the system tray icon and uncheck Enable Alarms from the context menu.

- Deteña &kalarm; como se describe en Sair do &kalarm;.

Alarms may be permanently disabled by preventing &kalarm; from being started at login using the General tab of the Configuration dialog.

#### Activar e desactivar as alarmas individuais

Para activar as alarmas individuais que están desactivadas actualmente, faga unha das cousas seguintes:

- Seleccione unha ou máis alarmas premendo nas súas entradas da listaxe de alarmas. A seguir, Accións Activar.

- Prema co botón dereito nas entradas desexadas da listaxe de alarmas e escolla Activar no menú de contexto.

Para desactivar alarmas individuais que están activadas actualmente faga unha das cousas seguintes:

- Seleccione unha ou máis alarmas premendo nas súas entradas da listaxe de alarmas. A seguir escolla Accións Desactivar.

- Prema co botón dereito nas entradas desexadas da listaxe de alarmas e escolla Desactivar no menú de contexto.

### Sair do &kalarm;

Saia do &kalarm; seleccionando Ficheiro Sair ou Sair no menú de contexto da icona da bandexa do sistema. Alternativamente, se a icona da bandexa do sistema non está visíbel, feche todas as xanelas do &kalarm;.

## Configurar o &kalarm;

To configure &kalarm;'s operation to suit your system and your personal preferences, select Settings Configure &kalarm;.... This displays the Configuration dialog.

### Xeral

A sección Xeral permite controla o comportamento xeral do &kalarm;:

- Executar automaticamente ao inicio: pódese iniciar o &kalarm; automaticamente cando principia a sesión, co cal un asegúrase de que o &kde; se está a executar sempre a non ser que se saia del manualmente.

  Esta opción debería estar sempre seleccionada, a non ser que queira deixar de empregar o &kalarm;.

  Esta opción vólvese a seleccionar automaticamente cando se executa o &kalarm;. De xeito que, se desactivou esta opción e quere que o &kalarm; non se siga executando no inicio, ten que desmarcar esta opción de novo cada vez que execute o &kalarm;.

- Advertir antes de pechar: Cando as alarmas están desactivadas mentres o &kalarm; non se está a executar, ao seleccionar esta opción háselle pedir confirmación se tenta rematar co &kalarm; mediante a opción Sair da icona da bandexa do sistema. Isto evita que se desactiven accidentalmente as alarmas. Para máis seguranza, esta opción selecciónase automaticamente por omisión cando se cambia de modo de execución.

- Confirmar os borrados das alarmas: Especificar se se lle ha pedir confirmación cada vez que se elimine unha alarma.

- Default defer time interval: Enter the default time interval, in hours and minutes, to show initially when the Defer Alarm dialog is displayed. Note that if an alarm has been deferred previously, the interval shown initially in the Defer Alarm dialog will be equal to the deferral interval used the last time that alarm was deferred.

- Terminal para Alarmas con Comandos: Aquí pódese seleccionar o tipo de xanela de terminal que se ha de usar para as alarmas con comandos que se executen nunha xanela de terminal. Algunhas das aplicacións de xanela de terminal máis frecuentes xa están preconfiguradas, &eg; xterm e &konsole;, ainda que só se mostrarán as que estean realmente instaladas no sistema. Pódense ver as opcións dos comandos reais que se utilizan para cada aplicación se se mostra a axuda de contexto desta opción.

  Se quere utilizar outra aplicación ou unha das que está na lista mais con diferentes opcións para os comandos, seleccione Outra e introduza o comando para chamar pola xanela do terminal. Por omisión, a cadea de comandos da alarma engadirase ao que especifique. Como alternativa, pódese especificar o sitio no que se ha inserir a cadea do comando da alarma mediante os códigos seguintes:

  %c

    Substituirase a cadea de comandos da alarma.

  %w

    Substituirase a cadea de comandos da alarma con `sleep` engadido.

  %C

    Crearase un ficheiro de comandos temporal que conteña a cadea de comandos da alarma e substituirase o comando que execute o ficheiro.

  %W

    Crearase un ficheiro de comandos temporal que conteña a cadea de comandos da alarma con `sleep` engadido e substituirase o comando que execute o ficheiro.

  Cando se activa a alarma con comando, citarase a cadea de comandos antes de inserila no comando da xanela de terminais.

### Hora e data

A sección Hora de Data permite configurar opcións relacionadas coa hora e a data:

- Fuso horario: Seleccione a súa zona horaria. &kalarm; emprega esta zona horaria para todo, excepto cando a substitúa para alarmas individuais.

- Holiday region: Select which country's or region's holidays to use. This affects recurring alarms for which the option to exclude holidays is selected.

- Inicio do día para alarmas só de data: Configure a hora á que comeza o día en relación á activación de alarmas só de data, &ie; aquelas para as que se seleccionou a opción Calquer hora. Na data na que se teñan que activar, esas alarmas aparecerán na primeira oportunidade durante as 24 horas a partir da hora de inicio do día.

- Opcións de Xornada Laboral: Estas opcións permiten definir o horario laboral, que é preciso cando se selecciona a opción Só durante o horario laboral para unha repetición no diálogo de edición de alarmas.

  - Seleccione todos os días que son laborais.

  - Hora de inicio diaria: introduza a hora á que comeza a traballar cada día.

  - Hora de remate diaria: introduza a hora á que remata de traballar cada día.

- KOrganizer event duration: Enter the event duration to set in KOrganizer for alarms which are copied to KOrganizer. The default duration is zero.

### Almacenamento

A sección Almacenamento permite escoller opcións para gardar e arquivar as alarmas:

- New Alarms & Templates: Specify which calendar to store new alarms and alarm templates in when using multiple alarm calendars:

  - Store in default calendar: New alarms and alarm templates are automatically added to the default alarm calendar without prompting for confirmation.

  - Prompt for which calendar to store in: When you create a new alarm or alarm template and there is more than one writeable alarm calendar, you will be prompted to choose which calendar to save it in. Note that when alarms are saved on expiry, they are always stored in the default archived alarm calendar without prompting.

- Archived Alarms group box: These options control the storage of archived alarms in the default archived alarm calendar.

  - Manter as alarmas despois de caducaren: Seleccione esta opción para arquivar as alarmas caducadas e eliminadas. Retírelle a selección para que non se manteña ningún rexistro das alarmas unha vez que deixen de estar activas. Teña en conta que as alarmas eliminadas só se arquivan se se activaron previamente. Se elimina unha alarma antes de que se active polo menos unha vez, descártase.

  - Descartar as alarmas caducadas despois de: Configure candos días se han almacenar no arquivo as alarmas caducadas e eliminadas (despois elimínanase por completo).

  - Clear archived alarms: This button discards all currently archived alarms from the default archived alarm calendar. (Other archived alarm calendars are left unchanged in case they are shared with other people.) This has no effect on alarms which subsequently expire or are deleted; they will continue to be archived according to the selected options.

### Correo electrónico

A sección Correo electrónico permite escoller opcións para enviar e indicarlles enderezos ás alarmas con correo electrónico:

- Cliente de correo electrónico: Especifica o cliente de correo electrónico que se ha empregar para enviar as alarmas con correo electrónico:

  - KMail: Cando se activa unha alarma con correo electrónico, a mensaxe envíase mediante &kmail; (que se inicia antes, de ser preciso) como segue:

    - Se o &kmail; é a versión 1.7 ou posterior, a mensaxe envíase automaticamente.

    - Se o &kmail; é dunha versión anterior, a mensaxe engádese á `caixa de saída` do &kmail; para que se envíe máis tarde.

  - Sendmail: When an email alarm is triggered, the email is sent automatically using &Sendmail;. This option will only work if your system is configured to use &Sendmail;, or a &Sendmail; compatible mail transport agent such as postfix or qmail.

- Copiar as mensaxes enviadas no cartafol "correo enviado" de &kmail;: Seleccione esta opción se quere que se almacene unha copia da mensaxe transmitida cada vez que se activa unha alarma con correo electrónico no cartafol `correo enviado` do &kmail;.

  Esta opción non está disponíbel cando o &kmail; está seleccionado como cliente de correo electrónico, xa que o &kmail; xa o fai automaticamente.

- Notificar cando se poñan na cola de envío os correos electrónicos remotos: Seleccione esta opción para mostrar unha notificación cada vez que unha alarma con correo pon unha mensaxe na fila para enviar a un sistema remoto. Pode resultar útil se, por exemplo, ten unha conexión de módem de marcar ou se a mensaxe se pon na fila do cartafol `saída` do &kmail; para asegurarse de que fai o que sexa preciso para que a mensaxe se transmita.

- Seleccione o enderezo de correo electrónico que quere empregar como enderezo do remitente nas alarmas con correo electrónico:

  - Seleccione De para introducir un enderezo de correo electrónico.

  - Seleccione Usar o enderezo do Centro de Control para que se empregue o enderezo de correo que se configurou no Centro de Control do &kde;.

  - Seleccione Usar identidades de &kmail; para poder escoller cal das identidades de correo do &kmail; se ha empregar no momento de configurar unha alarma con correo. Utilizarase a identidade por omisión do &kmail; para as alarmas que xa se configuraran antes de seleccionar esta opción.

- Seleccione o enderezo de correo que quere empregar para enviarse a si copias ocultas das alarmas con correo cando seleccione a opción Copiar correo electrónico para si mesmo:

  - Seleccione Bcc para introducir un enderezo de correo. Se as copias ocultas se han de enviar á súa conta no computador no que se está a executar o &kalarm;, abonda con introducir aquí o seu nome de usuario.

  - Seleccione Usar o enderezo do Centro de Control para que se empregue o enderezo de correo que se configurou no Centro de Control do &kde;.

### Visualización

The View section lets you control some aspects of &kalarm;'s appearance. In the General tab:

- Amosar na bandexa do sistema: Se se selecciona, móstrase a icona da bandexa do sistema cando o &kalarm; se está a executar. Neste modo, ao fechar a icona da bandexa do sistema féchanse as xanelas principais do &kalarm; e, se non hai xanelas de mensaxes visíbeis, sáese da aplicación.

- Opcións de Información na Bandexa do Sistema: Estas opcóns controlan que información se mostra nas mensaxes informativas que aparecen cando o cursos do rato pasa por riba da icona de &kalarm; na bandexa do sistema.

  - Amosar as alarmas das vindeiras 24 horas: Se se selecciona, móstrase un resumo das primeiras alarmas que se han activar nas próximas 24 horas.

  - Número máximo de alarmas que se amosan: Non seleccione isto para que se mostren todas as alarmas das vindeiras 24 horas. Seleccióneo para limitar o número máximo de alarmas que se mostran.

  - Amosar a hora da alarma: Seleccione esta opción para que apareza a hora para a que está programada cada alarma.

  - Amosar tempo até a alarma: Seleccione esta opcións para que apareza cando tempo falta para a próxima vez que se active cada alarma. A duración móstrase en horas e minutos.

    - Prefixo: Especifica un símbolo ou texto que aparece antes do tempo que falta para a alarma, para que así se distingua da hora para a que se programou a alarma.

- The Alarm List group box allows the selection of the colors used in the alarm list in &kalarm;'s main window, to show disabled and archived alarms.

The Alarm Windows tab contains options to control the appearance of alarm message windows.

- colocar as fiestras lonxe do cursor do rato: Seleccione esta opción para que as xanelas de mensaxe das alarmas aparezan tan lonxe como for posíbel da posición actual do cursor do rato. Isto reduce as posibilidades de que se recoñeza unha alarma por accidente ao premer nun botón xusto cando aparece a xanela da mensaxe.

- Centrar as fiestras, demorar a activación dos botóns da fiestra: Seleccione esta opcións para que as xanelas de mensaxe de alarma aparezan no centro da pantalla. Para reducir as posibilidades de que se recoñeza a alarma por accidente, os botóns da xanela desactívanse ao principio. A demora en segundos antes de que se activen configúrase en Demora na activación dos botóns (segundos).

- As fiestras de mensaxe teñen unha barra de título e obteñen o foco do teclado: Esta opción controla se as xanelas de mensaxe das alarmas son modais ou non, &ie; se obteñen o foco do teclado cando aparecen. Vexa a sección Xanela de mensaxes de alarma para máis detalles.

### Editar

A sección Editar permite escollar os valores por omisión das opcións do diálogo de edición de alarmas:

- The General tab contains options which apply to all alarm types.

  - Configure os estados por omisión das opcións Amosar en KOrganizer e Cancelar se tarda.

  - Configure o tipo de repetición por omisión.

  - Configure que se ha de facer nos anos non bisestos coas repeticións anuais programadas para o 29 de febreiro.

- The Alarm Types tab contains options which apply to specific types of alarm.

  - Das alarmas visuais:

    - Configure os estados predefinidos das opcións Fechar a fiestra automaticamente despois do tempo de cancelación e Confirmar recoñecemento.

    - Configure as unidades de tempo predefinidas para as lembranzas.

    - Configure as accións especiais predefinidas das alarmas visuais.

    - Configure as opcións de son predefinidas. Teña en conta que hai se pode especificar un ficheiro de son mesmo se o tipo de son non está configurado en Ficheiro de son.

  - Das alarmas con comandos:

    - Configure os estados por omisión das opcións Introducir un guión e Executar nunha fiestra de consola.

  - Das alarmas con correo electrónico:

    - Configure o estado por omisión da opción Copiar correo electrónico para si mesmo.

- The Font & Color tab lets you set the default appearance of alarm messages. Select their default font, and foreground and background colors.

## Funcionamento na liña de comandos

Cando se fornecen parámetros na liña de comandos, o &kalarm; non mostra a listaxe de alarmas programadas como se describiu antes en Usar o &kalarm;. Pódense utilizar opcións da liña de comandos específicas do &kalarm; para realizar as opcións seguinets:

- programar unha alarma nova

- controlar o modo de visualización do &kalarm;

- obter axuda

As opcións adicionais da liña de comandos fornécense principalmente para facilitar que outros programas se relacionen co &kalarm;. Descríbense no capítulo Guía do programador de &kalarm;.

A liña de comandos só pode conter opcións que se poidan aplicar a unha operación de &kalarm;. Se quere realizar varias operacións, ha de chamar por &kalarm; varias veces cun único conxunto de opcións de cada vez.

### Programar unha alarma nova

As opcións seguintes empréganse para programar unha alarma nova:

Opción | Descrición
--- | ---
`-a`, `--ack-confirm` | Pedir confirmación cando se recoñeza a mensaxe da alarma.
`-A`, `--attach URL` | Especificar o camiño ou &URL; dun ficheiro que hai que xuntar a unha mensaxe de correo. Esta opción pódese repetir cantas veces sexa preciso. Con esta opción hai que especificar `--mail`.
`--auto-close` | Fechar automaticamente a xanela da alarma así que cancele o perído `--late-cancel`. Con esta opción hai que especificar `--late-cancel`.
`-b`, `--beep` | Facer soar unha badalada audíbel cando se mostre a mensaxe. Con esta opción non se poden especificar `--speak`, `--play` nen `--play-repeat`.
`--bcc` | Enviar para si mesmo unha copia oculta da mensaxe. Con esta opción hai que especificar `--mail`.
`-c`, `--color`, `--colour cor` | Configurar a cor de fondo da mensaxe como o nome de cor &Qt; especificado ou o código hexadecimal 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg cor` | Configurar a cor do texto como o nome de cor &Qt; especificado ou o código hexadecimal 0xRRGGBB.
`-d`, `--disable` | Desactivar a alarma. Non se activará até que se permita manualmente.

`-e`, `--exec liña_de_comandos`

Especificar un comando de consola que se queira executar. Se se especifica, esta opción ha ser a derradeira opción de &kalarm; na liña de comandos de &kalarm;. Todos os parámetros e opcións dos comandos posteriores interprétanse como que forman a liña de comandos que hai que executar. Con esta opción non se poden especificar `--file` e `--exec-display` e `--mail`. Con esta opción ignóranse `--ack-confirm`, `--beep`, `--color` e `--colorfg`

`-E`, `--exec-display liña_de_comandos` | Specify a shell command to execute to generate the alarm message text. If specified, this option must be the last &kalarm; option in &kalarm;'s command line. All subsequent command parameters and options are interpreted as forming the command line to execute. `--exec`, `--file` and `--mail` cannot be specified with this option.
`-f`, `--file URL` | Especificar o camiño ou &URL; dun ficheiro de texto ou de imaxe cuxo contido constituirá a mensaxe de alarma. Non se poden especificar `--exec`, `--exec-display` nen `--mail` e con esta opción non pode estar presente mensaxe.
`-F`, `--from-id ID` | Utilizar a identificada especificada do &kmail; como remitente da mensaxe. Con esta opción hai que especificar `--mail`.

`-i`, `--interval periodo`

Configurar o intervalo entre repeticións da alarma. As horas/minutos especifícanse no formato nHnM, onde n é un número, &eg; 3H30M. Outros peridos de tempo especifícanse no formato nX, no que n é un número e X é unha das letras seguintes: Y (anos), M (meses), W (semanas), D (días). Non se permiten nen Y (anos) nen M (meses) se tamén se especifica `--recurrence`. É obrigatorio se se especifican `--repeat` ou `--until`

`-k`, `--korganizer` | Mostrar a alarma como un evento no calendario activo do &korganizer;.
`-l`, `--late-cancel periodo` | Cancel the alarm if it cannot be triggered within the specified period after the correct time. The period is specified in the same format as described for `--reminder`. The default value of period is 1 minute.
`-L`, `--login` | Activar a alarma cada vez que se inicie o sistema. Con esta opción non se poden especificar `--interval`, `--repeat` nen `--until`.
`-m`, `--mail enderezo` | Enviar unha mensaxe ao enderezo especificado. Pódese repetir esta opción cantas veces sexa preciso. Con esta opción non se poden especificar `--exec`, `--exec-display` nen `--file`. Con esta opción ignóranse `--ack-confirm`, `--beep`, `--color` e `--colorfg`
`-p`, `--play URL` | Specify the path or &URL; of an audio file to be played once, either as an audio alarm or when the alarm message is displayed. `--play-repeat`, `--beep` and `--speak` cannot be specified with this option.
`-P`, `--play-repeat URL` | Specify the path or &URL; of an audio file to be played repeatedly, either until Stop Play is used, or for as long as the alarm message is displayed. `--play`, `--beep` and `--speak` cannot be specified with this option.
`--recurrence espec` | Configurar a alarma para que se repita. Especificar a repetición empregando a sintaxe de iCalendar (definida en RFC2445, &eg; FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. Con esta opción non se pode especificar `--until`.

`-r`, `--repeat número`

Configurar o número de veces que se quere que ser repita a alarma ou, se se especifica a repetición con `--recurrence`, o número de veces que se quere que se activa cada vez que a activa `--recurrence` (&ie; unha repetición dentro dunha recorrencia). Se `--recurrence` non está presente, especifícase -1 para repetir a alarma indefinidamente. Con esta opción hai que especificar `--interval` e non se pode especificar `--until`.

`-R`, `--reminder periodo`

Output a reminder alarm the specified length of time before the main alarm and each of its recurrences (if any). Hours/minutes are specified in the format nHnM, where n is a number, &eg; 3H30M. Other time periods are specified in the format nX, where n is a number and X is one of the following letters: W (weeks), D (days). This option cannot be specified with `--exec`, `--mail` or `--reminder-once`.

`--reminder-once periodo` | Output a reminder alarm once, the specified length of time before the first recurrence of the alarm. No reminder will be displayed before subsequent recurrences (if any). This option cannot be specified with `--exec`, `--mail` or `--reminder`.
`-s`, `--speak` | Speak the message when it is displayed. This option requires KTTSD to be installed and configured, together with a compatible speech synthesizer. `--beep`, `--play` and `--play-repeat` cannot be specified with this option.
`-S`, `--subject asunto` | A liña co asunto da mensaxe de correo. Con esta opción hai que especificar `--mail`.

`-t`, `--time data/hora`

Activar a alarma na data ou na data e hora especificadas. Especificar unha data sen hora no formato aaaa-mm-dd [ZH]; especificar unha data e hora con [[[aaaa-]mm-]dd-]hh:mm [ZH] (se se omiten, os campos de data toman por omisión os valores de hoxe. Se non se especifica unha zona horaria, asúmese que é a zona horaria do sistema local. Se hai un especificador de zona horaria ZH presente, pode ser o nome dunha zona horaria do sistema (&eg; `Europe/London`), `UTC` (que representa a zona horaria UTC) ou `Reloxio` para empregar o reloxio do computador local e ignorar os fusos horarios.

`-v`, `--volume porcentaxe` | Configurar o volume de audio para reproducir o ficheiro de audio. Esta opción só se pode usar cando se especifican `--play` ou `--play-repeat`

`-u`, `--until data/hora`

Repetir a alarma até a data ou data e hora especificada. Especificar a data ou data/hora usando a mesma sintaxe que para `--time`. Teña en conta que se se especifica `--time`, a zona horaria tomarase do seu valor e non se pode incluir ningunha zona horaria no valor `--until`. Con esta opción hai que especificar `--interval` e non se poden especificar `--repeat` nen `--recurrence`.

mensaxe | Texto da mensaxe para mostrar ou, se se especifica `--mail`, o corpo da mensaxe de correo.

Either a message text, `--file`, `--exec`, `--exec-display`, `--play` or `--play-repeat` must be specified; except as noted above, all the options are optional.

Dous exemplos alternativos que mostran unha mensaxe de varias liñas cun fondo vermello ás 10 da noite o 27 deste mes son:

    % kalarm -c red -t 27-22:00 "Lembra\nSTOP"
    % kalarm -c 0xFF0000 -t 27-22:00 "Lembra\nSTOP"

### Outras opcións

As opcións seguintes empréganse para mostrar o diálogo do editor de alarmas ou para controlar o modo de visualización do &kalarm;.

Opción | Descrición
--- | ---
`--edit ID_do_evento` | Mostrar o diálogo de edición de alarmas para modificar a alarma que ten o ID de evento que se especifica.
`--edit-new-audio` | Display the Alarm Edit dialog, in order to edit a new audio alarm.
`--edit-new-command` | Mostrar o diálogo de edición de alarmas para editar unha alarma con comando nova.
`--edit-new-display` | Mostrar o diálogo de edición de alarmas para editar unha alarma visual nova.
`--edit-new-email` | Mostrar o diálogo de edición de alarmas para editar unha alarma con correo nova.
`--edit-new-preset nomeDoModelo` | Mostrar o diálogo de edición de alarmas, predefinica co modelo de alarma co nome que se especifica para editar unha alarma nova.
`--tray` | Mostrar o &kalarm; como icona na bandexa do sistema.

### Opcións de axuda

As opcións de axuda seguintes son comúns a todos os programas do &kde;:

Opción | Descrición
--- | ---
`--help` | Mostra un texto breve de axuda sobre as opcións.
`--help-qt` | Mostra numerosas opcións xenéricas específicas de &Qt;.
`--help-kde` | Mostra numerosas opcións xenéricas específicas do &kde;.
`--help-all` | Mostra todas as opcións.
`--author` | Mostra os nomes e enderezos de correo dos autores do &kalarm;.
`-v`, `--version` | Mostra as versións en execución da biblioteca de &Qt;, &kde; e &kalarm;.
`--license` | Mostra a información da licenza.

## Guía do programador de &kalarm;.

&kalarm; fornece unha interface que permite que outras apliccións lle soliciten as funcións seguintes:

- programar unha alarma nova

- cancelar unha alarma xa programada

- activar unha alarma xa programada

- mostrar o diálogo de edición de alarmas

Each of the above functions is implemented both by a D-Bus call and by the command line. D-Bus calls should be used in preference if &kalarm; is already running.

### D-Bus Interface

The D-Bus calls described in this document are all implemented in &kalarm;'s `/kalarm` D-Bus object path. The interface is defined in the files `org.kde.kalarm.kalarm.xml` and `kalarmiface.h`.

cancelEvent

#### cancelEvent

cancelar unha alarma xa programada.

    void cancelEvent(const QString& IDdoEvento)

##### Parámetros

`eventID`

  Especifica o ID único do evento que hai que cancelar.

##### Descrición

`cancelEvent()` is a D-Bus call to cancel the specified alarm. &kalarm; deletes the alarm from the calendar without displaying or executing it.

triggerEvent

#### triggerEvent

activar unha alarma xa programada.

    void triggerEvent(const QString& IDdoEvento)

##### Parámetros

`eventID`

  Esfecifica o ID único do evento que hai que activar.

##### Descrición

`triggerEvent()` is a D-Bus call to trigger the immediate display or execution of the specified alarm (regardless of what time it is scheduled for). &kalarm; retrieves the alarm from the calendar and then displays or executes it.

Se a alarma xa se activou, o &kalarm; elimina todas as repeticións programadas da alarma até o momento actual e, se non fican máis repeticións, elimina a alarma do calendario. Se ainda non lle tocou activarse, non se tocan as repeticións pogramadas.

scheduleMessage

#### scheduleMessage

programar unha mensaxe de alarma nova.

    bool scheduleMessage(const QString& mensaxe,
                         const QString& horaDataInicio,
                         int cancelaciónTardía,
                         unsigned bandeiras,
                         const QString& corFondo,
                         const QString& corTexto,
                         const QString& fonte,
                         const QString& URLAudio,
                         int minsLembranza,
                         const QString& repetición,
                         int intervaloSubRepet,
                         int totalSubRepet)

    bool scheduleMessage(const QString& mensaxe,
                         const QString& horaDataInicio,
                         int cancelaciónTardía,
                         unsigned bandeiras,
                         const QString& corFondo,
                         const QString& corTexto,
                         const QString& fonte,
                         const QString& URLAudio,
                         int minsLembranza,
                         int tipoRepet,
                         int intervaloRepet,
                         int totalRepet)

    bool scheduleMessage(const QString& message,
                         const QString& horaDataInicio,
                         int cancelaciónTardía,
                         unsigned bandeiras,
                         const QString& corFondo,
                         const QString& corTexto,
                         const QString& fonte,
                         const QString& URLAudio,
                         int minsLembranza,
                         int tipoRepet,
                         int IntervaloRepet,
                         const QString& horaDataFin)

##### Parámetros

`message`

  Especifica o texto da mensaxe que hai que programar ou, se `flags` ten configurado o bit `DISPLAY_COMMAND`, especifica a liña de comando que hai que executar para xerar o texto da mensaxe.

`horaDataInicio`

  Especifica a data, ou data e hora, programadas, na que hai que mostrar a mensaxe. Para unha alarma só de data, a cadea ha de ter o formato AAAA-MM-DD [ZH] (tal e como o devolve `QDate::toString(Qt::ISODate)`). Para unha alarma cunha data e unha hora, a cadea ha de ter o formato AAAA-MM-DDTHH:MM[:SS] [ZH] (tal e como o devolven `QDateTime::toString(Qt::ISODate)`) ou HH:MM[:SS] [Reloxio] (tal e como o devolve `QTime::toString(Qt::ISODate)`). Se non se especifica ningunha data, emprégase a de hoxe. Os valores en segundos ignóranse.

  Se non se especifica ningunha zona horaria, asúmese que é a zona horaria do sistema local. Se está presente un especificador de zona horaria ZH, pode ser o nome dunha zona horaria do sistema (&eg; `Europe/London`), no que `UTC` representa o fuso horario UTC ou `Clock` para empregar o reloxio do computador local e ignorar as zonas horarias.

`cancelaciónTardía`

  Fai que a alarma se cancela se non se pode activar antes do número de minutos especificado após a hora para a que estaba programada. Se o valor é 0, a alarma non se cancelará, sen importar canto tarde en se activar.

`bandeiras`

  Especifica o OR lóxico das bandeiras de alarma desexadas. Os bits de bandeira son os que se definen na clase `KAlarmIface` en `kalarmiface.h`. Téñase en conta que non se aplican todos os bits de bandeira ás alarmas con mensaxe.

`corFondo`

  Especifica a cor de fondo na que se ha mostrar a mensaxe. A cadea pode estar no formato #RRGGBB (tal e como o devolve `QColor::name()`), no que RR, GG e BB son valores hexadecimais de dous díxitos para o vermello, o verde e o azul. Como alternativa, a cadea pode estar en calquera dos outros formatos que acepta `QColor::setNamedColor()`, como un nome da base de datos de cores de X (&eg; red or steelblue). Configure a cadea como nada para especificar a cor de fondo por omisión actual.

`corTexto`

  Especifica a cor de primeiro plano na que se ha mostrar a mensaxe. O formato da cadea é o mesmo que para `bgColor`, e tamén se pode configurar a cadea como nada para especificar a cor de primeiro plano por omisión actual.

`fonte`

  Especifica a fonte coa que se ha mostrar a mensaxe. O formato da cadea é o que se obtén con `QFont::toString()`. Se se configura a cadea como nada, emprégase a fonte das mensaxes por omisión que haxa no momento no que se mostre a mensaxe.

`URLAudio`

  Especifica o ficheiro de audio que se ha reproducir cando se mostre a mensaxe. Se se configura o valor como nada, non se reproducirá ningunha mensaxe.

`minsLembranza`

  Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify 0 if no reminder is required.

`recorrencia`

  Especifica unha repetición regular da alarma, empregando a sintaxe iCalendar que se define en RFC2445. For exemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticións e intervalos de 3 meses no derradeiro luns do mes. Para unha alarma que non se repite, especifique unha cadea baleira.

`tipoRepet`

  Especifica o tipo de repetición da alarma. Os valores admisíbeis son MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Defínese na clase `KAlarmIface` en `kalarmiface.h`. As repeticións mensuais son do tipo día do mes e as repeticións anuais son do tipo data do ano; nos dous casos, a data tómase do parámetro `startDateTime`.

`intervaloRepet`

  Especifica o número de periodos (minutos/días/semanas/meses/anos, como se especifica con `tipoRepet`) entre as repeticións da alarma.

`totalRepet`

  Especifica o número de veces que hai que repetir a alarma. Especifique -1 para que a alarma se repita indefinidamente.

`horaDataFin`

  Especifica a data, ou data e hora, de remate das repeticións da alarma. Se `horaDataInicio` inclúe unha hora, este parámetro ha de incluir tamén unha hora; se `horaDatainicio` só contén unha data, este parámetro ha de conter só unha data. Non debe conter un especificador de fuso horario; emprégase a mesma zona horaria que para `horaDataInicio` para interpretar o valor deste parámetro.

`intervaloSubRepet`

  Especifica o número de minutos entre sub-repeticións da alarma. Especifique 0 para que non haxa sub-repeticións. Ignórase se non se especifica ningunha repetición.

`totalSubRepet`

  Especifica o número de sub-repeticións da alarma, incluída a activación inicial.

##### Descrición

`scheduleMessage()` is a D-Bus call to schedule the specified alarm message for display at the specified date and time. It has three forms. The most general form allows an arbitrary recurrence to be specified – use this also for non-repeating alarms. The other forms provide convenient access to a restricted set of alarm recurrence types, one specifying a repetition count and the other an end time.

If the scheduled time (including any repetitions) has already passed, &kalarm; immediately displays the message (unless the `lateCancel` value indicates that it is now too late to display the alarm, in which case &kalarm; ignores the request). If the scheduled time (or a repetition) is in the future, &kalarm; adds the alarm message to the default active alarm calendar for later display.

scheduleFile

#### scheduleFile

programar unha alarma nova que mostre o contido dun ficheiro de texto ou de imaxe.

    bool scheduleFile(const QString& URL,
                      const QString& horaDataInicia,
                      int cancelaciónTardía,
                      unsigned bandeiras,
                      const QString& corFondo,
                      const QString& URLAudio,
                      int minsLembranza,
                      const QString& repetición,
                      int intervaloSubRepet,
                      int totalSubRepet)

    bool scheduleFile(const QString& URL,
                      const QString& horaDataInicio,
                      int cancelaciónTardía,
                      unsigned bandeiras,
                      const QString& corFondo,
                      const QString& URLAudio,
                      int minsLembranza,
                      int tipoRepet,
                      int intervaloRepet,
                      int totalRepet)

    bool scheduleFile(const QString& URL,
                      const QString& horaDataInicio,
                      int cancelaciónTardía,
                      unsigned bandeiras,
                      const QString& corFondo,
                      const QString& URLAudio,
                      int minsLembranza,
                      int tipoRepet,
                      int intervaloRepet,
                      const QString& horaDataFin)

##### Parámetros

`URL`

  Especifica o ficheiro de texto ou de imaxe cuxo contido hai que mostrar na mensaxe que se programe.

`horaDataInicio`

  Especifica a data, ou data e hora, programadas, na que hai que mostrar a mensaxe. Para unha alarma só de data, a cadea ha de ter o formato AAAA-MM-DD [ZH] (tal e como o devolve `QDate::toString(Qt::ISODate)`). Para unha alarma cunha data e unha hora, a cadea ha de ter o formato AAAA-MM-DDTHH:MM[:SS] [ZH] (tal e como o devolven `QDateTime::toString(Qt::ISODate)`) ou HH:MM[:SS] [Reloxio] (tal e como o devolve `QTime::toString(Qt::ISODate)`). Se non se especifica ningunha data, emprégase a de hoxe. Os valores en segundos ignóranse.

  Se non se especifica ningunha zona horaria, asúmese que é a zona horaria do sistema local. Se está presente un especificador de zona horaria ZH, pode ser o nome dunha zona horaria do sistema (&eg; `Europe/London`), no que `UTC` representa o fuso horario UTC ou `Clock` para empregar o reloxio do computador local e ignorar as zonas horarias.

`cancelaciónTardía`

  Fai que a alarma se cancela se non se pode activar antes do número de minutos especificado após a hora para a que estaba programada. Se o valor é 0, a alarma non se cancelará, sen importar canto tarde en se activar.

`bandeiras`

  Especifica o OR lóxico das bandeiras de alarma desexadas. Os bits de bandeira son os que se definen na clase `KAlarmIface` de `kalarmiface.h`. Téñase en conta que non se poden aplicar todos os bits de bandeira ás alarmas con ficheiro.

`corFondo`

  Especifica a cor de fondo na que se ha mostrar o ficheiro. A cadea pode estar no formato #RRGGBB (tal e como o devolve `QColor::name()`), no que RR, GG e BB son valores hexadecimais de dous díxitos para o vermello, o verde e o azul. Como alternativa, a cadea pode estar en calquera dos outros formatos que acepta `QColor::setNamedColor()`, como un nome da base de datos de cores de X (&eg; red or steelblue). Configure a cadea como nada para especificar a cor de fondo por omisión actual.

`URLAudio`

  Especifica o ficheiro de audio que se ha reproducir cando se mostre a mensaxe. Se se configura o valor como nada, non se reproducirá ningunha mensaxe.

`minsLembranza`

  Specifies the number of minutes in advance of the main alarm and of each of its recurrences (if any) at which a reminder alarm should be displayed. Specify 0 if no reminder is required.

`recorrencia`

  Especifica unha repetición regular da alarma, empregando a sintaxe iCalendar que se define en RFC2445. For exemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticións e intervalos de 3 meses no derradeiro luns do mes. Para unha alarma que non se repite, especifique unha cadea baleira.

`tipoRepet`

  Especifica o tipo de repetición da alarma. Os valores admisíbeis son MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Defínese na clase `KAlarmIface` en `kalarmiface.h`. As repeticións mensuais son do tipo día do mes e as repeticións anuais son do tipo data do ano; nos dous casos, a data tómase do parámetro `startDateTime`.

`intervaloRepet`

  Especifica o número de periodos (minutos/días/semanas/meses/anos, como se especifica con `tipoRepet`) entre as repeticións da alarma.

`totalRepet`

  Especifica o número de veces que hai que repetir a alarma. Especifique -1 para que a alarma se repita indefinidamente.

`horaDataFin`

  Especifica a data, ou data e hora, de remate das repeticións da alarma. Se `horaDataInicio` inclúe unha hora, este parámetro ha de incluir tamén unha hora; se `horaDatainicio` só contén unha data, este parámetro ha de conter só unha data. Non debe conter un especificador de fuso horario; emprégase a mesma zona horaria que para `horaDataInicio` para interpretar o valor deste parámetro.

`intervaloSubRepet`

  Especifica o número de minutos entre sub-repeticións da alarma. Especifique 0 para que non haxa sub-repeticións. Ignórase se non se especifica ningunha repetición.

`totalSubRepet`

  Especifica o número de sub-repeticións da alarma, incluída a activación inicial.

##### Descrición

`scheduleFile()` is a D-Bus call to schedule the specified text or image file for display at the specified date and time. Apart from specifying a file path or &URL; and omitting the foreground color and font, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleCommand

#### scheduleCommand

programar unha alarma nova que execute un comando de consola.

    bool scheduleCommand(const QString& liñaDecomandos,
                         const QString& horaDataInicial,
                         int cancelaciónTardía,
                         unsigned bandeiras,
                         const QString& repetición,
                         int intervaloSubRepet,
                         int totalSubRepet)

    bool scheduleCommand(const QString& liñaDecomandos,
                         const QString& horaDataInicio,
                         int cancelaciónTardía,
                         unsigned bandeiras,
                         int tipoRepet,
                         int intervaloRepet,
                         int totalRepet)

    bool scheduleCommand(const QString& liñaDeComandos,
                         const QString& horaDataInicio,
                         int cancelaciónTardía,
                         unsigned bandeiras,
                         int tipoRepet,
                         int intervaloRepet,
                         const QString& horaDataFin)

##### Parámetros

`liñaDeComandos`

  Especifica o comando para o que hai que programar a execución. O parámetro `flags` indica see este parámetro contén unha liña de comandos de consola ou un guión de comandos.

`horaDataInicio`

  Especifica a data, ou data e hora, programadas, na que hai que mostrar a mensaxe. Para unha alarma só de data, a cadea ha de ter o formato AAAA-MM-DD [ZH] (tal e como o devolve `QDate::toString(Qt::ISODate)`). Para unha alarma cunha data e unha hora, a cadea ha de ter o formato AAAA-MM-DDTHH:MM[:SS] [ZH] (tal e como o devolven `QDateTime::toString(Qt::ISODate)`) ou HH:MM[:SS] [Reloxio] (tal e como o devolve `QTime::toString(Qt::ISODate)`). Se non se especifica ningunha data, emprégase a de hoxe. Os valores en segundos ignóranse.

  Se non se especifica ningunha zona horaria, asúmese que é a zona horaria do sistema local. Se está presente un especificador de zona horaria ZH, pode ser o nome dunha zona horaria do sistema (&eg; `Europe/London`), no que `UTC` representa o fuso horario UTC ou `Clock` para empregar o reloxio do computador local e ignorar as zonas horarias.

`cancelaciónTardía`

  Fai que a alarma se cancela se non se pode activar antes do número de minutos especificado após a hora para a que estaba programada. Se o valor é 0, a alarma non se cancelará, sen importar canto tarde en se activar.

`bandeiras`

  Especifica o OR lóxico das bandeiras de alarma desexadas. Os bits das bandeiras son os que se definen na clase `KAlarmIface` de `kalarmiface.h`. Téñase en conta que non se poden aplicar todos os bits de bandeira ás alarmas con comandos.

`recorrencia`

  Especifica unha repetición regular da alarma, empregando a sintaxe iCalendar que se define en RFC2445. For exemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticións e intervalos de 3 meses no derradeiro luns do mes. Para unha alarma que non se repite, especifique unha cadea baleira.

`tipoRepet`

  Especifica o tipo de repetición da alarma. Os valores admisíbeis son MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Defínese na clase `KAlarmIface` en `kalarmiface.h`. As repeticións mensuais son do tipo día do mes e as repeticións anuais son do tipo data do ano; nos dous casos, a data tómase do parámetro `startDateTime`.

`intervaloRepet`

  Especifica o número de periodos (minutos/días/semanas/meses/anos, como se especifica con `tipoRepet`) entre as repeticións da alarma.

`totalRepet`

  Especifica o número de veces que hai que repetir a alarma. Especifique -1 para que a alarma se repita indefinidamente.

`horaDataFin`

  Especifica a data, ou data e hora, de remate das repeticións da alarma. Se `horaDataInicio` inclúe unha hora, este parámetro ha de incluir tamén unha hora; se `horaDatainicio` só contén unha data, este parámetro ha de conter só unha data. Non debe conter un especificador de fuso horario; emprégase a mesma zona horaria que para `horaDataInicio` para interpretar o valor deste parámetro.

`intervaloSubRepet`

  Especifica o número de minutos entre sub-repeticións da alarma. Especifique 0 para que non haxa sub-repeticións. Ignórase se non se especifica ningunha repetición.

`totalSubRepet`

  Especifica o número de sub-repeticións da alarma, incluída a activación inicial.

##### Descrición

`scheduleCommand()` is a D-Bus call to schedule the specified shell command line, or command script, for execution at the specified date and time. Apart from specifying a command and omitting the message color, font and audio file parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleEmail

#### scheduleEmail

programar unha alarma nova que envía unha mensaxe de correo.

    bool scheduleEmail(const QString& IDDesde,
                       const QString& enderezo,
                       const QString& asunto,
                       const QString& mensaxe,
                       const QString& anexos,
                       const QString& horaDataInicio,
                       int cancelaciónTardía,
                       unsigned bandeiras,
                       const QString& repetición,
                       int intervaloSubRepet,
                       int totalSubRepet)

    bool scheduleEmail(const QString& IDDe,
                       const QString& enderezo,
                       const QString& asunto,
                       const QString& mensaxe,
                       const QString& anexos,
                       const QString& horaDataInicio,
                       int cancelaciónTardía,
                       unsigned bandeiras,
                       int tipoRepet,
                       int intervaloRepet,
                       int totalRepet)

    bool scheduleEmail(const QString& IDDe,
                       const QString& enderezo,
                       const QString& asunto,
                       const QString& mensaxe,
                       const QString& anexos,
                       const QString& horaDataInicio,
                       int cancelaciónTardía,
                       unsigned bandeiras,
                       int tipoRepet,
                       int intervaloRepet,
                       const QString& horaFin)

##### Parámetros

`IDDe`

  A identidade do &kmail; que se ha usar como remitente da mensaxe. Se está baleiro, o enderezo de correo do remitante que se empregue será o que estea configurado nas preferencias de correo do &kalarm;.

`enderezos`

  Unha lista separada por vírgulas de enderezos de correo dos destinatarios.

`asunto`

  Especifica a liña de asunto da mensaxe.

`message`

  Especifica o corpo da mensaxe de correo.

`anexos`

  Unha lista separada por vírgulas dos camiños ou &URL; dos ficheiros que se queren enviar como anexos de correo.

`horaDataInicio`

  Especifica a data, ou data e hora, programadas, na que hai que mostrar a mensaxe. Para unha alarma só de data, a cadea ha de ter o formato AAAA-MM-DD [ZH] (tal e como o devolve `QDate::toString(Qt::ISODate)`). Para unha alarma cunha data e unha hora, a cadea ha de ter o formato AAAA-MM-DDTHH:MM[:SS] [ZH] (tal e como o devolven `QDateTime::toString(Qt::ISODate)`) ou HH:MM[:SS] [Reloxio] (tal e como o devolve `QTime::toString(Qt::ISODate)`). Se non se especifica ningunha data, emprégase a de hoxe. Os valores en segundos ignóranse.

  Se non se especifica ningunha zona horaria, asúmese que é a zona horaria do sistema local. Se está presente un especificador de zona horaria ZH, pode ser o nome dunha zona horaria do sistema (&eg; `Europe/London`), no que `UTC` representa o fuso horario UTC ou `Clock` para empregar o reloxio do computador local e ignorar as zonas horarias.

`cancelaciónTardía`

  Fai que a alarma se cancela se non se pode activar antes do número de minutos especificado após a hora para a que estaba programada. Se o valor é 0, a alarma non se cancelará, sen importar canto tarde en se activar.

`bandeiras`

  Especifica o OR lóxico das bandeiras de alarma desexadas. Os bits das bandeiras son os que se definen na clase `KAlarmIface` de `kalarmiface.h`. Téñase en conta que non se poden aplicar todos os bits de bandeira ás alarmas con correo.

`recorrencia`

  Especifica unha repetición regular da alarma, empregando a sintaxe iCalendar que se define en RFC2445. For exemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticións e intervalos de 3 meses no derradeiro luns do mes. Para unha alarma que non se repite, especifique unha cadea baleira.

`tipoRepet`

  Especifica o tipo de repetición da alarma. Os valores admisíbeis son MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Defínese na clase `KAlarmIface` en `kalarmiface.h`. As repeticións mensuais son do tipo día do mes e as repeticións anuais son do tipo data do ano; nos dous casos, a data tómase do parámetro `startDateTime`.

`intervaloRepet`

  Especifica o número de periodos (minutos/días/semanas/meses/anos, como se especifica con `tipoRepet`) entre as repeticións da alarma.

`totalRepet`

  Especifica o número de veces que hai que repetir a alarma. Especifique -1 para que a alarma se repita indefinidamente.

`horaDataFin`

  Especifica a data, ou data e hora, de remate das repeticións da alarma. Se `horaDataInicio` inclúe unha hora, este parámetro ha de incluir tamén unha hora; se `horaDatainicio` só contén unha data, este parámetro ha de conter só unha data. Non debe conter un especificador de fuso horario; emprégase a mesma zona horaria que para `horaDataInicio` para interpretar o valor deste parámetro.

`intervaloSubRepet`

  Especifica o número de minutos entre sub-repeticións da alarma. Especifique 0 para que non haxa sub-repeticións. Ignórase se non se especifica ningunha repetición.

`totalSubRepet`

  Especifica o número de sub-repeticións da alarma, incluída a activación inicial.

##### Descrición

`scheduleEmail()` is a D-Bus call to schedule the specified email for sending at the specified date and time. Apart from specifying the email header and contents and omitting the message color, font and audio file parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

scheduleAudio

#### scheduleAudio

programar unha alarma nova que execute un comando de consola.

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       const QString& recurrence,
                       int subRepeatInterval,
                       int subRepeatCount)

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       const QString& endDateTime)

##### Parámetros

`URLAudio`

  Specifies the audio file which is to be played.

`volumePercent`

  Specifies the volume level to use, as a percentage of full volume. Specify -1 to use the default volume.

`horaDataInicio`

  Especifica a data, ou data e hora, programadas, na que hai que mostrar a mensaxe. Para unha alarma só de data, a cadea ha de ter o formato AAAA-MM-DD [ZH] (tal e como o devolve `QDate::toString(Qt::ISODate)`). Para unha alarma cunha data e unha hora, a cadea ha de ter o formato AAAA-MM-DDTHH:MM[:SS] [ZH] (tal e como o devolven `QDateTime::toString(Qt::ISODate)`) ou HH:MM[:SS] [Reloxio] (tal e como o devolve `QTime::toString(Qt::ISODate)`). Se non se especifica ningunha data, emprégase a de hoxe. Os valores en segundos ignóranse.

  Se non se especifica ningunha zona horaria, asúmese que é a zona horaria do sistema local. Se está presente un especificador de zona horaria ZH, pode ser o nome dunha zona horaria do sistema (&eg; `Europe/London`), no que `UTC` representa o fuso horario UTC ou `Clock` para empregar o reloxio do computador local e ignorar as zonas horarias.

`cancelaciónTardía`

  Fai que a alarma se cancela se non se pode activar antes do número de minutos especificado após a hora para a que estaba programada. Se o valor é 0, a alarma non se cancelará, sen importar canto tarde en se activar.

`bandeiras`

  Especifica o OR lóxico das bandeiras de alarma desexadas. Os bits das bandeiras son os que se definen na clase `KAlarmIface` de `kalarmiface.h`. Téñase en conta que non se poden aplicar todos os bits de bandeira ás alarmas con comandos.

`recorrencia`

  Especifica unha repetición regular da alarma, empregando a sintaxe iCalendar que se define en RFC2445. For exemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticións e intervalos de 3 meses no derradeiro luns do mes. Para unha alarma que non se repite, especifique unha cadea baleira.

`tipoRepet`

  Especifica o tipo de repetición da alarma. Os valores admisíbeis son MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Defínese na clase `KAlarmIface` en `kalarmiface.h`. As repeticións mensuais son do tipo día do mes e as repeticións anuais son do tipo data do ano; nos dous casos, a data tómase do parámetro `startDateTime`.

`intervaloRepet`

  Especifica o número de periodos (minutos/días/semanas/meses/anos, como se especifica con `tipoRepet`) entre as repeticións da alarma.

`totalRepet`

  Especifica o número de veces que hai que repetir a alarma. Especifique -1 para que a alarma se repita indefinidamente.

`horaDataFin`

  Especifica a data, ou data e hora, de remate das repeticións da alarma. Se `horaDataInicio` inclúe unha hora, este parámetro ha de incluir tamén unha hora; se `horaDatainicio` só contén unha data, este parámetro ha de conter só unha data. Non debe conter un especificador de fuso horario; emprégase a mesma zona horaria que para `horaDataInicio` para interpretar o valor deste parámetro.

`intervaloSubRepet`

  Especifica o número de minutos entre sub-repeticións da alarma. Especifique 0 para que non haxa sub-repeticións. Ignórase se non se especifica ningunha repetición.

`totalSubRepet`

  Especifica o número de sub-repeticións da alarma, incluída a activación inicial.

##### Descrición

`scheduleAudio()` is a D-Bus call to schedule the specified audio file to be played at the specified date and time. Apart from specifying a volume and omitting the message color and font parameters, its usage is identical to `scheduleMessage` - see the description of that function for further details.

edit

#### edit

Mostrar o diálogo de edición de alarmas para modificar unha alarma.

    bool edit(const QString& IDDoEvento)

##### Parámetros

`eventID`

  Especifica o ID único do evento que se vai modificar.

##### Valor de retorno

falso se non se puido atopar a alarma especificada ou se esta é só de lectura, verdadeiro de non ser este o caso.

##### Descrición

`edit()` is a D-Bus call to display the Alarm Edit dialog to edit the specified alarm.

editNew

#### editNew

Mostrar o diálogo de edición de alarmas para modificar unha alarma nova.

    bool editNew(int tipo)

    bool editNew(const QString& nomeDoModelo)

##### Parámetros

`tipo`

  Specifies the alarm type. The permissible values are DISPLAY, COMMAND, EMAIL, AUDIO. These are defined in class `KAlarmIface` in `kalarmiface.h`.

`nomeDoModelo`

  Especifica o nome dun modelo de alarma para que se basee nel a alarma nova.

##### Valor de retorno

falso se `type` non ten un valor válido ou se non se atopa ningún modelo chamado `nomeDoModelo`; verdadeiro de non ser este o caso.

##### Descrición

`editNew()` is a D-Bus call to display the Alarm Edit dialog to edit a new alarm. If an alarm type is specified as a parameter, a blank dialog is displayed. Alternatively, if an alarm template name is specified as a parameter, the dialog is preset with details from the template.

### Interface de Liña de Comandos

Command line options are provided to enable other programs to start up &kalarm; if it is not already running, in order to trigger or cancel scheduled alarms, or schedule new alarms. The reason for using command line options for this purpose is that if &kalarm; were started without any command line parameters and then sent D-Bus requests, it would start in its default graphical mode, which is clearly undesirable for an inter-program request.

Programs should first check whether &kalarm; is already running; if it is, they should instead use D-Bus calls to request these operations.

As opcións da liña de comandos para prograrmar unha alarma nova descríbense no capítulo Operación na liña de comandos. As opcións para activar e cancelar as alarmas programadas son as seguintes:

Os usuarios normais tamén poden, se queren, empregar estas opcións da liña de comandos (asumando que poidan fornecer a información sobre parámetros precisa).

Opción | Descrición
--- | ---
`--cancelEvent IDDoEnvento` | Cancelar a alarma co ID de evento especificado. Con esta opción non se pode especificar `--triggerEvent`.
`--triggerEvent IDDoEnvento` | Trigger the alarm with the specified event ID. The action taken is the same as for the triggerEvent() D-Bus call. `--cancelEvent` cannot be specified with this option.

Velaquí uns exemplos:

    % kalarm --triggerEvent &kalarm;-387486299.702
    % kalarm --cancelEvent &kalarm;-388886299.793

## Preguntas e respostas

&reporting.bugs; &updating.documentation;

Que ficheiros de configuración emprega o &kalarm;?

`$KDEHOME/share/config/kalarmrc` contén as preferencias do &kalarm;.

`$KDEHOME/share/config/kresources/alarms/stdrc` holds your alarm calendar configuration.

($`KDEHOME` is usually `~/.kde` or similar.)

Onde garda as alarmas o &kalarm;?

Os nomes dos ficheiros de calendario que o &kalarm; crear a primeira vez que se executa son os seguintes (ainda que estes pódense substituir coas entradas da sección `Xeral` do ficheiro de preferencias do &kalarm;):

- `$KDEHOME/share/apps/kalarm/calendar.ics` contén as alarmas activas (substituíbel pola entrada `Calendar`).

- `$KDEHOME/share/apps/kalarm/expired.ics` contén as alarmas arquivadas (substituíbeis pola entrada `ExpiredCalendar`).

- `$KDEHOME/share/apps/kalarm/template.ics` contén os modelos das alarmas (substituíbel pola entrada `TemplateCalendar`).

You can find out which calendar files are currently in use by viewing each calendar's details in the alarm calendars list. The file names are stored in the alarm calendar configuration file.

Os detalles das alarmas que se están a mostrar actualmente almacénanse no ficheiro de calendario `$KDEHOME/share/apps/kalarm/displaying.ics`.

En que formatos se almacenan as alarmas?

The calendar files in which &kalarm; stores its alarms are text files whose format is defined by the document RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). This is the standard format used by all kdepim applications. &kalarm; uses certain non-standard properties, in conformance with RFC2445. In the VEVENT component: `X-KDE-KALARM-FLAGS`, `X-KDE-KALARM-NEXTRECUR`, `X-KDE-KALARM-REPEAT`, `X-KDE-KALARM-ARCHIVE`, `X-KDE-KALARM-LOG`, and in the VALARM component: `X-KDE-KALARM-TYPE`, `X-KDE-KALARM-NEXTREPEAT`, `X-KDE-KALARM-FONTCOLOR`, `X-KDE-KALARM-VOLUME`, `X-KDE-KALARM-SPEAK`, `X-KDE-KALARM-EMAILID`.

Que é o programa kalarmautostart?

kalarmautostart é unh programixa auxiliar cuxa función é que se execute automaticamente &kalarm; no inicio.

No inicio, o xestor de sesións normalmente restaura &kalarm; (para volver a mostrar as xanelas no mesmo estado no que estaban cando se saíu a vez anterior). Mais se non se estaba a executar ao sair, o xestor de sesións non o vai iniciar e, polo tanto, haino que iniciar automaticamente. O problema é que cando unha aplicación é, á vez, xestionada pola sesión e auto-iniciada, non se pode garantizar que é o que vai acontecer primeiro. Se a auto-inicialización se produce primeiro, impedirá que o xestor de sesións restore o estado da aplicación.

Para evitar este problema, kalarmautostart iníciase automaticamente no inicio no canto de &kalarm;. O único que fai é esperar un bocadiño (para se asegurar de que o xestor de sesións ten tempo para facer o seu traballo) antes de iniciar o &kalarm; e entón féchase.

## Créditos e Licenza

&kalarm;

Program copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail;

Documentation copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail;

Tradución da documentación: Xosé Calvo - http://trasno.net/

&underFDL; &underGPL;

Grazas ao autor da aplicación KAlarm de &kde; 1, Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, quen amabelmente permitiu que esta aplicación empregase o nome &kalarm;, que estivo disponíbel a partir de &kde; 2.

## Instalación

### Como obter &kalarm;

&install.intro.documentation;

&kalarm; is available for &kde; 2 and as standalone packages for &kde; 3 and &kde; 4 from http://www.astrojar.org.uk/kalarm

### Requisitos

&kalarm; require que estean instaladas as bibliotecas normais de &kde; (os paquetes `kdelibs` e `kdepimlibs` packages), máis o paquete `kdebase/runtime` . Para compilar desde a fonte, tamén serán precisos os paquetes de desenvolvemento de bibliotecas relevantes e o paquete de desenvolvemento de &Qt;.

Os paquetes opcionais seguintes melloran o &kalarm; cando se executa se están instalados:

- KTTSD (from kdeaccessibility package): if installed and configured, together with a compatible speech synthesizer package, it allows &kalarm; to speak alarm messages when they are displayed.

&kalarm; uses about 12 Mb of memory to run, but this may vary depending on your platform and configuration.

You can find a list of changes in the `Changelog` file, or at http://www.astrojar.org.uk/kalarm.

### Compilación e instalación

Se non pode obter un paquete binario precompilado axeitado, terá que compilar &kalarm; vostede mesmo a partir dos ficheiros fonte. Obteña o ficheiro do paquete `kdepim-x.x.tar.bz2` or `kalarm-x.x.tar.bz2` (ou semellante), dependendo de se quere instalar &package; ou simplemente &kalarm;. Desempáqueo nun cartafol novo empregando un comando semellante a ``tar` `xvfj package.tar.bz2`` e pase para o cartafol que acaba de crear.

&install.compile.documentation;

If you have more than one version of &kde; installed (e.g. &kde; 2 and &kde; 3), this may possibly install &kalarm; into the wrong &kde; folder. If necessary, you can give the &kde; folder as a parameter to ``./configure`` . For example, if your &kde; is installed in `/opt/kde2`:

``./configure` --prefix=/opt/kde2`

Se instala o &kalarm; nun cartafol do cartafol no que está instalado o &kde;, non se executará correctamente a non ser que lle indique a &kde; a súa localización. Para facer isto, ha de facer preceder a variábel de contorno `KDEDIRS` coa localización de &kalarm; cada vez que inicie o &kde;.

Por exemplo, se &kde; está instalado en `/opt/kde`,pódese configurar `KDEDIRS` así:`/etc/opt/kde:/opt/kde`. Se se instala &kalarm; en `/usr/local`, haberá que configurar `KDEDIRS` como `/usr/local:/etc/opt/kde:/opt/kde` antes de iniciar &kde;.

A versión independente de &kalarm; ten unha opción de configuración especial que permite seleccionar en que idiomas se ha instalar a documentación ao especificar un código de lingua, ou unha listaxe de códigos de lingua, como parámetro do `./configure`. Por omisión, instálase a documentación en todas as linguas disponíbeis. Pódense atopar unha listaxe de linguas con documentación que se instalan co paquete, xunto cos seus códigos, no ficheiro `DOC-LANGUAGES`. Por exemplo, para instalar só a documentación en francés e en galego:

``./configure` --enable-doc-language="fr gl_ES"`

Teña en conta que esta opción non inflúe sobre as traducións da interface que se instalen.

### Configuración

Non se require ningunha configuración especial para configurar &kalarm; e que se execute no escritorio &kde;. Unha vez que se execute &kalarm; pola vez primeira, este iniciarase só cada vez que se entre no sistema para así poder vixiar as alarmas programadas.

Para executar o &kalarm; nun escritorio distinto ao &kde;, o requisito principal é asegurarse de que &kalarm; se executa automaticamente cada vez que se entra no sistema. Hai instrucións máis detalladas no ficheiro `INSTALL` que se distribúe co &kalarm;.

&documentation.index;