# El manual de &kalarm;

## Introducción

&kalarm; es un gestor de mensajes de alarma, comandos y correo-e para &kde;. Le permite configurar los mensajes personales de alarma para que se muestren en la pantalla a la hora que indique o que configure comandos para ejecutar o correos-e para mandar a una hora determinada.

En su modo gráfico predeterminado, &kalarm; muestra la lista de alarmas pendientes, mostrando sus horas y detalles. Puede crear alarmas nuevas o puede seleccionar las alarmas existentes para modificarlas o borrarlas. Opcionalmente, también puede ver las alarmas cumplidas.

Al configurar o modificar una alarma, puede teclear el texto del mensaje de alarma, indicar un archivo de texto o de imagen para mostrar, indicar un comando para ejecutar o introducir un correo-e para enviar. También puede seleccionar el color del mensaje de alarma, si se debe repetir, si reproducir un sonido y si la alarma se debe cancelar en caso de que no se pueda disparar a la hora planificada.

Las alarmas también se pueden planificar desde la línea de comandos o vía llamadas &DCOP; a programas.

Cuando un mensaje de alarma vence, se muestra en cada escritorio de &kde; para asegurarse de que no se le pasa. La ventana del mensaje muestra la hora a la que se ha planificado la alarma. Normalmente tiene una opción para pedir que la alarma se repita más tarde. Un ejemplo de un mensaje de alarma:

Captura de pantalla de la ventana del mensaje de &kalarm; Mensaje de alarma

Cuando la alarma especifica la ejecución de un comando o un correo electrónico para enviar, &kalarm; no muestra ninguna salida.

&kalarm; puede correr en dos modos: continuo (el predeterminado), en el que corre en la bandeja del sistema de &kde;, o bajo demanda, en el que corre cuando es necesario (con la opción de mostrar un icono independiente en la bandeja del sistema).

Este documento hace varias referencias al demonio de alarma. Ésta es una aplicación que corre en segundo plano, comprobando las alarmas pendientes y diciéndole a &kalarm; que las muestre una vez que se hayan cumplido.

## Usando &kalarm;

### Modo gráfico

Cuando corre sin comandos de la línea de parámetros, &kalarm; comienza en modo gráfico y muestra la lista actual de alarmas pendientes.

Cuando &kalarm; comienza en modo gráfico, comprueba si el demonio de alarma está corriendo. Si aún no está en funcionamiento, &kalarm; lo inicia.

Todos los cuadros de valores de &kalarm; tienen la posibilidad de una aceleración. Para hacer que el valor se incremente en pasos más grandes, mantenga pulsada la tecla Shift mientras hace clic en los botones de la flecha.

#### Lista de alarmas

La ventana principal de &kalarm; muestra la lista actual de alarmas pendientes, mostrando sus horas, intervalos de repetición, colores y textos de mensaje, nombres de archivos para mostrar, comandos para ejecutar o asuntos de correos-e. (Para una alarma que se repite o una alarma con un recordatorio, la hora muestra su próxima hora planificada). Un icono a la izquierda de cada texto de alarma/archivo/comando/asunto de correo-e indica el tipo de alarma.

Capturas de pantalla de la ventana principal de &kalarm; Ventana principal

Para una alarma que se repite, la lista muestra su próxima hora de ocurrencia y su intervalo básico de repetición (⪚ 1 día para una repetición diaria, 3 semanas para una repetición que sucede los lunes y los miércoles cada tres semanas, Ingreso para una alarma que se repite a cada ingreso en el sistema).

Las alarmas se pueden ordenar por fecha/hora, intervalo de repetición, color o texto, haciendo clic sobre la barra de título de la columna adecuada. Para invertir el orden, vuelva a hacer clic sobre la barra de título.

De forma opcional, puede mostrar el tiempo que falta para que cumpla cada alarma, junto con, o en lugar de, la hora planificada de la alarma. Para mostrar u ocultar la columna de hora de la alarma, seleccione Ver Mostrar horas de alarmas. Para mostrar u ocultar la columna de hora de la alarma, seleccione Ver Mostrar hora para las alarmas. Siempre se muestra al menos una columna.

Las alarmas cumplidas se pueden mostrar en la lista de alarmas seleccionando Ver Mostrar las alarmas cumplidas. Para volver a ocultarlas, repita la acción.

#### Añadiendo una alarma nueva

Para añadir una alarma nueva, haga una de las siguientes acciones. Ambas muestran el cuadro de diálogo de edición de alarmas como se describe más abajo.

- Seleccione Acciones Nuevo.

- Clic derecho sobre el icono de la bandeja del sistema y elija Nuevo en el menú de contexto.

- Doble clic sobre el espacio vacío debajo de la última entrada en la lista de alarmas.

- Clic derecho sobre el espacio vacío bajo la última entrada de la lista de alarma y seleccione Nueva en el menú de contexto.

También puede crear alarmas nuevas preconfiguradas desde varios sitios:

- Para basar su alarma nueva en una existente, resalte la alarma existente en la lista y seleccione Acciones Copiar. Esto abre el cuadro de diálogo de edición de alarmas ya relleno con una copia de todos los detalles de la alarma seleccionada.

- Para crear una alarma nueva que muestre un mensaje de correo existente, arrastre el correo desde &kmail; a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Se abrirá el cuadro de diálogo de edición de alarmas con el texto completo del correo electrónico (incluyendo remitente, destinatario, etc.) como texto de la alarma.

- Al arrastrar cualquier trozo de texto sobre la ventana principal de &kalarm; o sobre el icono de la bandeja del sistema, se abrirá el cuadro de diálogo de edición de alarmas y se pondrá el texto como texto de la alarma.

- Para crear una alarma que muestre archivos, arrastre una URL de archivo a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Esto abrirá el cuadro de diálogo de edición de alarmas y pondrá allí el nombre del archivo.

- Puede crear automáticamente alarmas para gente que esté en &kaddressbook; tal y como se describe en Importar cumpleaños desde &kaddressbook;.

#### Modificando una alarma existente

Para modificar una alarma pendiente que exista (las alarmas que hayan cumplido no se pueden recuperar), haga una de las siguientes cosas:

- Doble clic sobre su entrada en la lista de alarmas.

- Selecciónelo haciendo clic sobre su entrada en la lista de alarmas. Luego seleccione Acciones Modificar.

- Clic derecho click on its entry in the alarm list and sobre su entrada sobre la lista de alarmas y elija Modificar desde el menú contextual.

Esto muestra el cuadro de diálogo de edición de alarmas:

Captura de pantalla del cuadro de diálogo de edición de alarmas Cuadro de diálogo de edición de alarmas

En el cuadro Acción, seleccione el tipo de alarma:

- Texto para introducir el texto del mensaje de alarma (que puede incluir saltos de línea) en el cuadro de edición de texto. Fije las siguientes opciones:

  - La marca de verificación Confirmar asentimiento le permite especificar si se le ha de pedir confirmación cuando cierre la ventana de mensaje de alarma. Esto se puede usar como salvaguarda en caso de reconocimiento accidental de alarmas.

  - Marque el cuadro de verificación Sonido si quiere que haya un sonido audible cuando se muestre el mensaje de alarma. Por defecto, suena un «bip»; use el botón de la derecha para seleccionar un archivo de audio para reproducir. Para volver al «bip», haga clic de nuevo sobre el botón. Para ver cuál es su opción actual del sonido, coloque el ratón sobre el botón hasta que aparezca un consejo.

  - Marque el cuadro de verificación Recordatorio si quiere mostrar un recordatorio antes de la alarma principal y de cada una de sus repeticiones (si las hubiera). Introduzca la anterioridad usando los controles de edición junto al cuadro de verificación.

  - Seleccione el color de fondo para la ventana del mensaje de alarma (la lista de selección de colores la puede configurar en el cuadro de diálogo Preferencias).

  - Use el botón Tipografía y color... para seleccionar una tipografía para el mensaje de alarma. En el cuadro de diálogo Seleccionar tipografía y color de alarma, marque Usar tipografía predeterminada para mostrar el mensaje con la tipografía configurada como la hosra predeterminada para mostrar el mensaje. (La tipografía predeterminada se puede configurar en el cuadro de diálogo «Preferencias»). Para seleccionar una tipografía específica para el mensaje, desmarque Usar tipografía predeterminada.

- Archivo para introducir el nombre o &URL; de un archivo de texto cuyos contenidos se vayan a mostrar en el mensaje de alarma. Use el botón que está junto al cuadro de texto para mostrar un cuadro de diálogo de selección de archivo. Fije las opciones superiores como para alarmas de texto.

- Comando para introducir una línea de comando de la shell para ser ejecutada. El comando se pasa directamente a la shell predeterminada (definida por la variable de entorno `SHELL`), y puede incluir cualquier opción, parámetros, comandos con tuberías, etc. que se pueda incluir en una sola línea de comando.

  Esta opción no está disponible si &kde; está corriendo en modo kiosk.

- Correo-e para introducir un mensaje de correo electrónico para enviar, la línea del asunto y el cuerpo del mensaje en los tres campos de edición. Use el botón que está junto al cuadro de edición de la dirección para mostrar la libreta de direcciones d e&kde;, desde la que puede seleccionar los destinatarios del correo. Se pueden añadir archivos adjuntos usando el botón Añadir.... Tenga en cuenta que los archivos adjuntos deben existir cuando se produzca la alarma; no se almacena ninguna copia de los archivos cuando se configura la alarma. Para borrar un archivo adjunto, resáltelo en la lista desplegable y haga clic sobre el botón Borrar.

  La dirección del correo que recibirá la copia se puede configurar en el cuadro de diálogo Preferencias. La predeterminada es la que tiene configurada en el Centro de control de &kde;.

  Fije la siguiente opción:

  - Marque el cuadro de verificación Copia del correo a sí mismo para mandarse a sí mismo una copia oculta del correo cuando se lance la alarma. La dirección del correo que recibirá la copia se puede configurar en el cuadro de diálogo Preferencias. La predefinida es la que tiene configurada en el Centro de control de &kde;.

Si la alarma se repite y se restrasó la última vez que fue mostrara, el grupo de opciones Alarma retrasada muestra la hora a la que se retrasó la alarma. Cambiar... muestra un cuadro de diálogo que le permite cambiar la hora de la alarma retrasada o cancelarla.

En el grupo de opciones Hora, seleccione

- En fecha/hora para introducir la fecha y hora en la que se debe producir la alarma. Marque el cuadro de verificación A cualquier hora si quiere especificar sólo una fecha para la alarma: en este caso, la alarma se mostrará en la primera ocasión que se tenga de hacerlo tras la hora de comienzo del día planificado de la alarma. (Configurar &kalarm; describe cómo configurar la hora de comienzo del día).

  Para una alarma que no se repite, la fecha/hora de la alarma que tiene que introducir debe pertenecer al futuro, o si es de sólo fecha, debe ser el día de la fecha o posterior. Para una alarma que se repite, no hay tales restricciones, porque la fecha/hora de comienzo se ajustará automáticamente a la primera repetición que ocurra tras la hora del momento.

- Tiempo desde ahora para introducir cuánto tiempo (en horas y minutos) desde este momento debe transcurrir para mostrar la alarma planificada.

Las características básicas de repetición de la alarma se muestran para su comodidad en la pestaña Alarma. Especifique si y cómo se debe repetir la alarma en la pestaña Recurrencia:

- En el grupo de opciones Reglas de repetición, fije el tipo de repetición o el período de la forma siguiente:

  - Para lanzar la alarma sólo una vez, elija Sin repetición.

  - Seleccione Al ingresar para lanzar la alarma cuando ingrese hasta la hora de finalización planificada. Tras la hora de finalización planificada, la alarma se mostrará una última vez. (Tenga en cuenta que una alarma que se repite al ingresar también se lanza cada vez que active las alarmas o reinicie o reconfigure el demonio de alarma.)

  - Para hacer que la alarma se repita en intervalos regulares, elija uno de los tipos de períodos temporales y luego introduzca en el cuadro Repetir cada cuántos períodos de tiempo deben transcurrir entre las repeticiones. Por ejemplo, para repetir cada 14 días puede seleccionar Diario e introducir un valor de 14 o seleccionar Semanal e introducir un valor de 2. Según el tipo de período de tiempo seleccionado, puede tener más opciones:

    - Para una repetición diaria, marque cada día de la semana en el que desee que se produzca la alarma.

    - Para una repetición mensual, puede seleccionar si se produce en una fecha fija o en una posición (⪚ el segundo martes).

    - Para una repetición anual, puede seleccionar una fecha fija del año o una posición del mes (⪚ el último sábado de mayo). Marque cada mes del año en el que quiera que se produzca la alarma.

    Para indicar que una alarma diaria suceda únticamente en ciertos días de la semana, use una repetición semanal y marque cada día en cuestión.

- En el grupo de opciones Fin de la repetición, fije la hora de fin de la recurrencia de la siguiente forma:

  - Seleccione Sin fin para seguir repitiendo indefinidamente.

  - Seleccione Acabar tras para especificar el número total de ocurrencias de la alarma.

  - Seleccione Acabar en para especificar la fecha/hora hasta la que se debe repetir la alarma.

- Si quiere excluir ciertas fechas/horas de la repetición que quiera configurar, especifíquelas en el cuadro Excepciones. La lista de excepciones (&ie; las fechas y horas excluídas) se muestra a la izquierda. Para añadir una excepción nueva, indique una fecha en la derecha y pulse Añadir. Para cambiar una excepción, resáltela en la lista, introduzca la fecha nueva en la derecha y pulse Cambiar. Para eliminar una excepción, resáltela en la lista y pulse Eliminar.

La marca de verificación Cancelar si es tarde determina lo que ocurre si la alarma no se puede lanzar a la hora planificada. Marque este cuadro para cancelar la alarma si no se puede lanzar en el minuto siguiente de la hora correcta. Deje sin marcar el cuadro para lanzar la alarma en la primera oportunidad que se tenga, comenzando a la hora planificada. Las alarmas de fecha, &ie; aquéllas para las que está marcada la opción A cualquier hora, se cancelarán si no se pueden mostrar 24 horas después de la hora de comienzo del día de la fecha planificada.

Una alarma sólo se puede lanzar mientras esté como usuario del sistema y la aplicación demonio de alarma esté corriendo.

Pulse el botón Aceptar cuando todos los detalles sean correctos, para añadir la alarma a la lista de alarmas planificadas.

#### Borrar una alarma

Para borrar una alarma existente, haga una de las siguientes cosas:

- Selecciónela haciendo clie sobre su entrada en la lista de alarmas. Luego elija Acciones Borrar .

- Clic derecho sobre su entrada en la lista de alarmas y elija Borrar en el menú de contexto.

#### Ver una alarma

Para ver una alarma existente sin poder modificarla, haga una de las siguientes acciones:

- Selecciónelo haciendo clic sobre su entrada en la lista de alarmas. Luego, seleccione Acciones Ver .

- Clic derecho sobre su entrada en la lista de alarmas y seleccione Ver desde el menú de contexto.

Esto muestra el cuadro de diálogo de edición de la alarma en modo de sólo lectura.

#### Asentir una alarma

Vea Ventana de mensaje de alarma para saber cómo asentir las alarmas.

#### Importar cumpleaños desde &kaddressbook;

Puede configurar alarmas para cumpleaños guardados en &kaddressbook;, usando Archivo Importar cumpleaños.... Esto muestra un cuadro de diálogo que le permita seleccionar para qué cumpleaños crear alarmas.

- En el grupo de opciones Texto de alarma, puede configurar el texto para mostrar en los mensajes de alarma de los cumpleaños. El texto del mensaje se crea combinando el texto de Prefijo seguido del nombre de la persona y del texto de Sufijo. No se añaden espacios, por tanto recuerde incluir los espacios necesarios en Prefijo y Sufijo.

  Si cambia el texto de la alarma, la lista de selección del cumpleaños se volverá a evaluar.

- En la lista Seleccionar cumpleaños, seleccione los cumpleaños para el que quiera crear las alarmas. Tenga en cuenta que las listas muestran sólo aquellas variables de &kaddressbook; que contengan un cumpleaños y que no contengan ya una alarma de cumpleaños en un formato definido actualmente en el grupo de opciones Texto de alarma.

- Los restantes controles son los mismos para las alarmas de Texto del Cuadro de diálogo de edición de alarmas.

#### Mostrar &kalarm; en la bandeja del sistema

Debe estar corriendo el escritorio &kde; para mostrar &kalarm; en la bandeja del sistema. Si &kalarm; está corriendo en modo continuo, el icono de la bandeja del sistema se muestra siempre. Estas instrucciones se aplican sólo al modo bajo demanda. (Vea Configurar &kalarm; para una descripción de los modos de ejecución).

Para mostrar &kalarm; en la bandeja del sistema de &kde;, seleccione Ver Mostrar en la bandeja del sistema .

Para quitar &kalarm; de la bandeja del sistema de &kde;, haga una de las siguientes cosas:

- Seleccione Ver Ocultar de la bandeja del sistema.

- Clic derecho sobre el icono de la bandeja del sistema y elija Salir desde el menú de contexto.

El uso del icono de la bandeja del sistema se describe abajo.

#### Activar/desactivar la monitorización de la alarma

##### Activar la monitorización de la alarma

Primero, si &kalarm; corre en modo continuo y ha seleccionado Desactivar las alarmas cuando no esté corriendo en el diálogo Preferencias, debe asegurarse de que &kalarm; esté corriendo para que ocurra la monitorización de la alarma.

Si la monitorización de la alarma está desactivada actualmente, haga una de las siguientes cosas:

- Seleccione Acciones Activar alarmas.

- Clic derecho sobre el icono de la bandeja del sistema y elija Activar alarmas del menú de contexto.

El demonio de alarma se inicia si es necesiario y las alarmas se pueden monitorizar hasta que venzan.

Iniciar el demonio de alarma afectará a cualquier otra aplicación que use el demonio de alarma.

##### Desactivar la monitorización de alarmas

Hay varias formas de desactivar la monitorización de alarmas, que evita que &kalarm; vuelva a mostrar más alarmas hasta que vuelva a activar las alarmas, o asumir que el demonio de alarma se configura para que comience al ingresar - hasta la próxima vez que ingrese.

Para desactivar alarmas sin detener el demonio de alarma (y por tanto sin afectar a cualquier otra aplicación que use el demonio de alarma), haga una de las siguientes cosas:

- Seleccione Acciones Alarmas activadas.

- Clic derecho sobre el icono de la bandeja del sistema y elija Alarmas activadas desde el menú de contexto.

- Si el modo de ejecución de &kalarm; es el continuo y ha seleccionado Desactivar las alarmas mientras no esté corriendo en el cuadro de diálogo de Preferencias, sale de &kalarm;.

Para desactivar las alarmas deteniendo el demonio de alarma:

- Seleccione Preferencias Controlar el demonio de alarma.... Esto muestra el cuadro de diálogo del gestor de servicios, que le permite detener el demonio de alarma.

Esto afectará a cualquier otra aplicación que use el demonio de alarma.

#### Refrescar alarmas

Si en el evento en el que hay alarmas no se lanza cuando debería haberlo hecho, puede refrescar la lista de alarmas y lanzar cualquier alarma perdida seleccionando Acciones Refrescar alarmas .

&kalarm; vuelve a lanzar las alarmas perdidas volviendo a fijar el demonio de alarma, lo que se discute en la sección Demonio de alarma.

#### Controlar el demonio de alarma

Para controlar el demonio de alarma, seleccione Preferencias Controlar demonio de alarma.... Esto muestra el cuadro de diálogo Gestor de servicios, que le permite detener o comenzar el demonio de alarma y configurarlo para que se lance automáticamente al ingresar. Vea Controlar el demonio de alarma con el Gestor de servicios para más detalles.

#### Salir del programa

Sale de &kalarm; cerrando todas sus ventanas y el icono de la bandeja del sistema, o si está corriendo en modo continuo, cerrando todas las ventanas de mensajes y seleccionandoSalir en el menú de contexto de la bandeja del sistema.

Archivo Salir cierra sólo la ventana afectada. El efecto del elemento Salir del menú de contexto de la bandeja del sistema depende del modo de ejecución: en el modo bajo demanda oculta el icono de la bandeja del sistema, mientras que en modo continuo sale del programa.

Si ha deseleccionado Desactivar alarmas mientras no esté corriendo en el cuadro de diálogo de Preferencias, salir de &kalarm; no tiene efecto sobre el demonio de alarma que ya está activo sigue monitorizando las alarmas planificadas y pide que se muestren cuando hayan cumplido.

### Ventana del mensaje de alarma

Cuando un mensaje de alarma cumple, se muestra en cada escritorio de &kde; y no puede ser cubierta por ventanas normales, para asegurarse de que la ve. La ventana del mensaje muestra la hora para la que se planificó la alarma, porque puede ver cuándo surgió si estaba lejos del ordenador a esa hora. (Para mensajes de recordatorios, sin embargo, la fecha/hora mostrada es aquella prevista para la alarma principal o su repetición, no la hora del mensaje del recordatorio, y el título de la ventana es Recordatorio).

En caso de una alarma repetida, si hay una ventana de mensaje no asentida, permanece desde una ocurrencia anterior de la alarma, la ventana existente se muestra simplemente cuando la alarma se repite. Esto evita tener que asentir múltiples copias del mismo mensaje o ser incapaz de asentir un mensaje a la vez que aparece.

Cuando se muestra una ventana de mensaje de alarma, haga algo de lo siguiente:

- Asentirla haciendo clic sobre el botón Cerrar. Esto cierra la ventana (tras solicitar confirmación si solicitó Confirmar asentimiento).

- Mostrar las opciones para retrasar la alarma haciendo clic sobre el botón Retrasar.... Luego elija Retrasar a fecha/hora para introducir la fecha y hora a la que se debe volver a mostrar el mensaje, o seleccione Retrasar un intervalo de tiempo para introducir el retraso a partir de ese momento (en horas y minutos) con el que se debe volver a mostrar el mensaje. Luego haga clic sobre Retrasar para retrasar el mensaje de alarma.

  El tiempo que se retrasa la alarma debe transcurrir antes de su próxima repetición o próximo recordatorio planificado.

  El botón Retrasar... no está disponibles para alarmas que se muestran al ingresar porque se ha seleccionado la opción Repetir al ingresar.

El botón que muestra el icono &kalarm; proporciona una forma correcta de activar &kalarm;. Hacer clic en él no tiene efecto sobre la ventana del mensaje.

La ventana del mensaje de alarma se puede mostrar de dos modos distintos, según sus preferencias. Puede elegir el modo en el cuadro de diálogo Preferencias.

- Como una ventana normal. En este modo, el foco del teclado se toma de la ventana de mensajes de alarma cuando aparece, para que se desvíen sus pulsaciones de teclado allí en lugar de a su aplicación original.

- Como una ventana no modal. En este modo, el foco del teclado no se ve afectado cuando aparece la ventana del mensaje, de tal forma que no interferirá en su tecleo. Sin embargo, en este modo la ventana no tiene barra de título, con lo que no puede moverla.

### Icono de la bandeja del sistema

&kalarm; puede estar corriendo como icono en la bandeja del sistema de &kde;. Este icono le permite una activación de &kalarm; con un solo clic y proporciona tanto control como indicación de estado de la monitorización de alarmas. Un icono normal de &kalarm; indica qué alarmas están siendo monitorizadas, mientras que una cruz roja a través del icono indica qué alarmas no están siendo monitorizadas.

Si pasa el cursor del ratón sobre el icono de la bandeja del sistema, se mostrará en forma de consejo un resumen de los primeros mensajes de alarma que vencen en las próximas 24 horas. Puede desactivar esta característica, o configurar el número de alarmas que va a mostrar y su formato en el cuadro de diálogo «Preferencias».

Clic izquierdo sobre el icono de la bandeja del sistema para mostrar u ocultar la ventana principal de &kalarm;.

Clic derecho sobre el icono de la bandeja del sistema para mostrar su menú de contexto:

Activar las alarmas

- Activa la monitorización de las alarmas.

  Vea Activando/desactivando la monitorización de alarmas para más detalles.

Alarmas activas

- Desactiva la monitorización de las alarmas.

  Vea Activando/desactivando la monitorización de alarmas para más detalles.

Nueva alarma...

- Abre el cuadro de diálogo de edición de alarmas para crear una alarma.

  El cuadro de diálogo de edición de alarmas se describe en Modificar una alarma existente.

Configurar &kalarm;...

- Muestra el cuadro de diálogo de preferencias de &kalarm;.

  El cuadro de diálogo de preferencias se describe en Configurar &kalarm;. Incluye opciones referentes al icono de &kalarm; en la bandeja del sistema.

Demonio de control de alarma...

- Muestra el cuadro de diálogo del gestor de servicios que le permite controlar el demonio de alarma.

  Vea Controlando el demonio de alarma con el gestor de servicios para más detalles.

Restaurar / Minimizar

- Restaura o minimiza la ventana principal de &kalarm;.

  Esta opción sólo está disponible si el modo de ejecución es continuo. (Vea Configurar &kalarm; para tener acceso a una descripción de los modos de ejecución).

Salir

- Cierra el icono de la bandeja del sistema de &kalarm;.

  Sólo en el modo de ejecución continuo, esto también cierra todas las ventanas principales de &kalarm;. No tiene efecto sobre la monitorización de alarmas del demonio de alarma, si ha deseleccionado Desactivar las alarmas mientras no esté corriendo en el cuadro de diálogo de Preferencias.

### Operación de la línea de comandos

Cuando se suministran los parámetros de la línea de comando, &kalarm; no muestra la lista de las alarmas planificadas tal y como se describen en el Modo gráfico arriba. Las opciones de la línea de comandos específicas de &kalarm; se pueden usar para realizar las siguientes operaciones:

- planificar una alarma nueva

- controlar el demonio de alarma

- controlar el modo de visualización de &kalarm;

- obtener ayuda

Las opciones de la línea de comando adicionales se proporcionan principalmente para permitir que otros programas se comuniquen con &kalarm;. Se describen en el capítulo Guía del desarrollador de &kalarm;.

La línea de comando sólo puede contener opciones aplicables a una operación de &kalarm;. Si quiere realizar múltiples operaciones, debe invocar a &kalarm; muchas veces con una sola serie de opciones cada vez.

#### Planificar una alarma nueva

Se usan las siguientes opciones para planificar una alarma nueva:

Opción | Descripción
`-a`, `--ack-confirm` | Pedir confirmación cuando el mensaje de alarma se reconoce.
`-A`, `--attach `URL`` | Especificar el nombre o &URL; de un archivo que se va a añadir al correo electrónico. Esta opción se puede repetir tantas veces como sea necesario. Se debe especificar `--mail` con esta opción.
`-b`, `--beep` | Hace un «bip» audible cuando se muestra el mensaje. `--sound` no debe estar presente si se especificó esta opción.
`--bcc` | Con copia oculta del correo a sí mismo. `--mail` se debe especificar con esta opción.
`-c`, `--color`, `--colour `color`` | Fija el color de fondo del mensaje para el nombre del color de &Qt; especificado o el código hexadecimal 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg `color`` | Fija el color de fondo del mensaje para el nombre del color de &Qt; especificado o el código hexadecimal 0xRRGGBB.
`-e`, `--exec `lineadecomando`` | Especifique un comando de la shell para ejecutar. Si lo especificó, esta opción debe ser la última opción de &kalarm; en la línea de comando de &kalarm;. Todos los parámetros y opciones siguentes se intrepretan como parte de la línea de comando a ejecutar `--file` y `--mail` se pueden especificar con esta opción.`--ack-confirm`, `--beep` y `--color` se ignoran con esta opción.
`-f`, `--file `URL`` | Especifique el nombre o &URL; de un archivo de texto cuyo contenido va a formar el mensaje de alarma. `--exec` y `--mail` no se pueden especificar, y `mensaje` no puede estar presente con esta opción.
`-i`, `--interval `periodo`` | Fije los intervalos entre las repeticiones de la alarma. Las horas y minutos se especifican en en el formato `nHnM`, en las que `n` es un número, ⪚ 3H30M. Otros períodos de tiempo se especifican con el formato `nX`, donde `n` es un número y `X` es una de las siguientes letras: Y(años), M (meses), W (semanas), D (días). Es obligatorio especificar las opciones `--repeat` o `--until`. `--recurrence` no se puede especificar con esta opción.
`-l`, `--late-cancel` | Cancela la alarma si no puede ser mostrada a tiempo.
`-L`, `--login` | Activa la alarma cada vez que ingrese. Ni `--interval` ni `--repeat` ni `--until` se puden especificar con esta opción.
`-m`, `--mail `direccion`` | Envía un correo a las direcciones especificadas. Esta opción se puede repetir tantas veces como sea necesario. Ni `--exec` ni `--file` se pueden especificar con esta opción. `--ack-confirm`, `--beep`, `--color` y `--colorfg`se ignoran con esta opción.
`--recurrence `spec`` | Fija la alarma para que se repita. Especifique la repetición usando la sintaxis de iCalendar (definidos en RFC2445), ⪚ FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. Ni `--repeat` ni `--interval` ni `--until` se pueden especificar con esta opción.
`-r`, `--repeat `contador`` | Fijar el número de veces que se debe disparar la alarma. Especifique -1 para repetir indefinidamente la alarma. `--interval` debe estar, y ni `--until` ni `--recurrence` se pueden especificar junto a esta opción.
`-R`, `--reminder `periodo`` | Muestra un recordatorio de alarma la cantidad de tiempo dada antes de la alarma principal y cada una de sus repeticiones (si es que las hay). Se especifican horas y minutos con el formato `nHnM`, donde `n` es un número , ⪚ 3H30M. Se especifican otros períodos de tiempo con el formto `nX`, donde `n` es un número y `X` es una de las siguientes letras: W (semanas), D (días). Esta opción no se puede especificar ni con `--exec` ni con `--mail`.
`-s`, `--sound `URL`` | Especifique el nombre o &URL; de un archivo de audio para reproducirlo cuando se muestre el mensaje de alarma. `--beep` no debe estar presente si se especifica esta opción.
`-S`, `--subject `asunto`` | La línea del asunto del correo electrónico. `--mail` se debe especificar con esta opción.
`-t`, `--time `fecha/hora`` | Dispara las alarmas en la fecha o fecha y hora especificada. Especifique una fecha sin una hora con el formato `aaaa-mm-dd`; especifique una fecha y una hora con `[[[aaaa-]mm-]dd-]hh:mm` (cuando se omite, los campos de fecha toman los valores para hoy).
`-u`, `--until `fecha/hora`` | Repite la alarma hasta la fecha o fecha y hora especificada. Especifique una fecha sin hora con el mismo formato que en `--time`. `--interval` debe estar presente, y ni `--repeat` ni `--recurrence` se pueden especificar con esta opción.
`mensaje` | Texto del mensaje para mostrar, o si `--mail` está especificado, el cuerpo del mensaje del correo.

Se debe especificar un mensaje de texto o `--file` o `--exec`. Salvo en los casos citados anteriormente, todas las opciones son optativas.

Dos ejemplos más sobre qué muestra un mensaje de múltiples líneas con un fondo rojo a las 10 p.m. el día 27 de este mes:

    % kalarm -c rojo -t 27-22:00 "Recuerde\nPARAR"
    % kalarm -c 0xFF0000 -t 27-22:00 "Recuerde\nSTOP"

#### Otras opciones

Se usan las siguientes opciones para reiniciar o detener el demonio de alarma o para controlar el modo de visualización de &kalarm;.

Vea la sección Demonio de alarma para encontrar una discusión sobre reiniciar y detener el demonio de alarma.

Opción | Descripción
`--reset` | Reinicia el demonio de alarma.
`--stop` | Detiene el demonio de alarma.
`--tray` | Muestra &kalarm; como un icono de la bandeja del sistema de &kde;.

Por ejemplo, para reiniciar el demonio de alarma:

    % kalarm --reset

#### Opciones de ayuda

Las siguientes opciones de ayuda son iguales en todos los programas de &kde;:

Opción | Descripción
`--help` | Muestra un pequeño texto de ayuda con las opciones.
`--help-qt` | Muestra numerosas opciones específicas de &Qt;.
`--help-kde` | Muestra numerosas opciones genéricas de &kde;.
`--help-all` | Muestra todas las opciones.
`--author` | Muestra los nombres y las direcciones de correo de los autores de &kalarm;.
`-v`, `--version` | Muestra las versiones actuales de las bibliotecas &Qt;, &kde; y &kalarm;.
`--license` | Muestra la información de la licencia.

### Demonio de alarma

El demonio de alarma, &kalarmd;, monitoriza el archivo de calendario de &kalarm; en busca de alarma cumplidas. Cuando determina que una alarma ha cumplido, le dice a &kalarm; que la muestre o la ejecute o la cancele si ya es tarde y no se seleccionó la opción de mostrar esa alarma si ya es tarde.

En &kde;3, el demonio de alarma también lo pueden usar otras aplicaciones, incluso Korganizer.

El demonio de alarma corre en segundo plano, sin interfaz de usuario. Se puede controlar de cualquiera de las formas descritas abajo.

#### Comenzar, reconfigurar y detener el demonio de alarma

El demonio de alarma normalmente comienza al inicio de la sesión de &kde; (a no ser que utilice el cuadro de diálogo de gestión de servicios para desactivar el inicio automático), y corre hasta que se produce la salida de la sesión. Si por cualquier razón no está corriendo, no se comprobarán las alarmas y &kalarm; no mostrará ni ejecutará ninguna alarma.

##### Comenzar el demonio de alarma

Para iniciar el demonio de alarma puede, o bien lanzar &kalarm; en su modo gráfico predeterminado (&ie; sin parámetros en la línea de comandos), activar las alarmas usando el menú del icono de la bandeja del sistema de &kalarm; y reiniciar el demonio tal y como se describe abajo, iniciándolo por medio del cuadro de diálogo del Gestor de servicios (vea Controlel el demonio de alarma con el Gestor de servicios), o bien puede lanzar el demonio de alarma directamente desde la línea de comandos:

    % kalarmd

##### Reconfigurar el demonio de alarma

También es posible reconfigurar el demonio de alarma sin detenerlo. La reconfiguración causa que el demonio de alarma vuelva a leer la lista de los mensajes planificados del archivo de calendario y vuelva a iniciar los datos relativos a &kalarm;.

¿Por qué puede querer reconfigurar el demonio de alarma? No es un caso muy frecuente, pero si por cualquier razón &kalarm; no pudiera funcionar cuando se le indicó al demonio de alarma, esa alarma no volverá a mostrarse ni se ejecutará hasta que el demonio de alarma sea reconfigurado o reiniciado. Es preferible reconfigurar y no deterner el demonio de alarma y reiniciarlo, porque reconfigurar el demonio no afectará a ninguna otra aplicación que use el demonio de alarma.

Al reconfigurar se inicia el demonio de alarma si es que no está corriendo actualmente.

Para reconfigurar el demonio de alarma, use o bien la opción del menú Acciones Refrescar alarmas , o bien teclee el siguiente comando:

    % kalarm --reset

##### Detener el demonio de alarma

Detener el demonio de alarma evitará cualquier futura comprobación sobre los mensajes de alarma planificados hasta que el demonio de alarma vuelva a reiniciarse.

Detenerlo afectará al funcionamiento de cualquier otra aplicación que también use el demonio de alarma. Considere reconfigurar el demonio en vez de esto.

Para detener el demonio de alarma, use o bien el cuadro de diálogo del Gestor de servicios (vea Controlar el demonio de alarma con el gestor de servicios), o teclee el siguiente comando:

    % kalarm --stop

#### Controlar el demonio de alarma con el Gestor de servicios

El cuadro de diálogo del Gestor de servicios le permite configurar y controlar el demonio de alarma. Puede:

- Configurar si se lanza automáticamente al ingresar.

  Si ni el demonio de alarma ni &kalarm; están configurados para ser lanzados al ingresar, no ocurrirán las comprobaciones de alarmas y &kalarm; no mostrará ni ejecutará las alarmas.

- Detener e iniciar el demonio de alarma.

  Iniciar o detener el demonio de alarma afectará a cualquier otra aplicación que use el demonio de alarma.

Puede acceder al cuadro de diálogo del gestor de servicios bien via la opción Preferencias Demonio de control de alarma... del menú, o vía el Centro de control de &kde;.

## Configurar &kalarm;

Para fijar las opciones predefinidas para &kalarm; en su sistema, seleccione Preferencias Configurar &kalarm;.... Esto muestra el cuadro de diálogo de la configuración.

### General

La sección General le permite controlar algunos aspectos relativos al comportamiento de &kalarm;:

- Grupo de opciones Modo de ejecución: Estas opciones controlan el icono de la bandeja del sistema de &kalarm;, y también permite algún control sobre el uso de los recursos del sistema de &kalarm; y si corre continuamente o no. Si su objetivo es el rendimiento del sistema, es preferible que corra bajo demanda sin mostrar el icono de la bandeja del sistema; correr continuamente en la bandeja del sistema usa más recursos pero se consiguen los beneficios de mostrar una indicación de alarma activada y hacer más accesible la aplicación. Hacer que &kalarm; corra bajo demanda no afecta a la ejecución de las alarmas, porque es el demonio de alarma y no &kalarm; el que monitoriza la lista de alarmas y las lanza.

  - Corre continuamente en la bandeja del sistema: &kalarm; corre continuamente y el icono de la bandeja del sistema se muestra siempre mientras esté funcionando. En este modo, cerrar el icono de la bandeja del sistema cierra todas las ventanas principales de &kalarm;, y si no hay ninguna ventana de mensajes visible,sale de la aplicación. Las opciones disponibles para este modo son:

    - Iniciar automáticamente al ingresar: Esto inicia &kalarm; al ingresar en su sesión de &kde;, asegurando que &kalarm; corra todo el tiempo hasta que lo quite manualmente.

    - Desactivar las alarmas cuando no esté corriendo: Marcar esta opción tiene el efecto de que las alarmas se desactivarán si el icono de la bandeja del sistema de &kalarm; no es visible.

      - Avisar antes de salir: Cuando las alarmas están desactivadas mientras &kalarm; no esté corriendo, al marcar esta opción se le pide confirmación si intenta terminar &kalarm; usando la opción Salir del icono de la bandeja del sistema. Esto evita la desactivación adicional de las alarmas. Por seguridad, esta opción se activa automáticamente por defecto si cambia el modo de ejecución.

    En este modo, si no hay bandeja del sistema de &kde;, corre continuamente en segundo plano y las alarmas están siempre activadas.

  - Correr sólo bajo demanda: &kalarm; corre sólo cuando se dispara una alarma, si lo lanza manualmente o mientras se muestre el icono de la bandeja del sistema. En este modo, el icono de la bandeja del sistema aún se puede mostrar, pero cerrar el icono de la bandeja del sistema no tiene efecto en ninguna ventana de &kalarm;.

    - Comenzar automáticamente el icono de la bandeja del sistema al ingresar: Esto muestra el icono de la bandeja del sistema de &kalarm; al ingresar. &kalarm; correrá hasta que se cierre el icono de la bandeja del sistema.

- Comienzo del día par las alarmas de sólo fecha: Fija la hora de comienzo del día para disparar alarmas de sólo fecha, &ie; aquéllas para las que se haya seleccionado la opción A cualquier hora. En la fecha de vencimiento, tales alarmas se mostrarán en la primera ocasión durante las 24 horas siguientes a partir de la hora de comienzo del día.

- Si configura repeticiones anuales para el 29 de febrero, especifique cómo se deben gestionar estas repeticiones en los años que no sean bisiestos. Seleccione una de las siguientes opciones:

  - 28 de febrero: la alarma sucederá el 29 de febrero en los años bisiestos, y el 28 de febrero en los años no bisiestos.

  - 1 de marzo: la alarma sucederá el 29 de febrero en los años bisiestos y el 1 de marzo en los años no bisiestos.

  - No repetir: la alarma sucederá el 20 de febrero en los años bisiestos, pero se suprimirá en los años no bisiestos.

  El cambio de estas opciones no provocará que se vuelvan a evaluar las alarmas existentes. Sólo afectará a las alarmas nuevas o a las alarmas existente, pero en su próxima activación.

- Confirmar borrados de alarma: Especifique si se debe pedir confirmación cada vez que borre una alarma.

- Grupo de opciones Alarmas cumplidas: Estas opciones controlan el almacenamiento de las alarmas cumplidas.

  - Mantener las alarmas tras cumplir: Marque esta opción para almacenar las alamrmas cumplidas. Desmárquela para no mantener el registro de las alarmas una vez que hayan cumplido.

  - Descartar las alarmas cumplidas tras: Fije el número de días para almacenar las alarmas cumplidas tras su última activación.

  - Borrar las alarmas cumplidas: Este botón descarta todas las alarmas cumplidas almacenadas. Esto no tiene efecto sobre las alarmas que se cumplan subsecuentemente; seguirán estando almacenadas según las opciones seleccionadas.

### Correo-e

La sección Correo-e le permite elegir opciones para el envío y el direcionamiento de las alarmas de correo-e:

- Cliente de correo: Especifique el cliente de correo para ser utilizado al enviar las alarmas:

  - KMail: Cuando sucede una alarma de correo, el mensaje se añade a la carpeta `saliente` suponiendo que &kmail; está corriendo todo el tiempo. Si no está corriendo, se mostrará una ventana del editor de &kmail; rellena con los detalles del correo, para permitirle enviar el mensaje de correo electrónico manualmente.

  - Sendmail: Cuando sucede una alarma de correo-e, el correo se envía automáticamente usando sendmail. Esta opción sólo funcionará si su sistema está configurado para usar sendmail o un agente de transporte de correo compatible con sendmail, como postfix o qmail.

- La dirección de correo-e De indica su dirección de correo-e, que se usará como la dirección del remitente en las alarmas de correo-e. Elija Usar las direcciones del Centro de control para usar la dirección de correo-e que está configurada en el Centro de control de &kde;.

- La dirección de correo-e Bcc indica su dirección de correo-e, que se usará para enviarse a sí mismo copias ocultas de las alarmas de correo-e cuando se haya seleccionado la opción Copia del correo-e a sí mismo. Si se tienen que enviar copias ocultas a su cuenta en el computador en el que está corriendo &kalarm;, simplemente puede introducir su nombre de ingreso de usuario. Elija Usar la dirección del Centro de control para usar la dirección de correo-e que esté configurado en el Centro de control de &kde;.

- Notificar cuando los correos remotos entren en cola: Seleccione esta opción para mostrar una notificación cada vez que una alarma ponga en la cola de correo un mensaje para enviar a un sistema remoto. Esto puede ser útil si, por ejemplo, tiene una conexión por módem, para asegurarse de que se necesita transmitir realmente el correo.

### Ver

La sección Ver le permite controlar algunos aspectos de la apariencia de &kalarm;:

- Grupo de opciones Lista de alarmas: Estas opciones controlan qué información se muestra inicialmente en la lista de alarmas cuando se inicia &kalarm;. (Una vez que &kalarm; se haya iniciado, use el menú Ver para cambiar lo que se muestra).

  - Mostrar la hora de la alarma: Seleccione esta opción para mostrar la fecha y la hora a la que está planificada la próxima ocurrencia de cada alarma.

  - Mostrar la hora de la alarma: Elija esta opción para mostrar el espacio de tiempo que falta antes de la próxima ocurrencia planificada de la alarma. El espacio de tiempo se muestra en días (si procede), horas y minutos.

- Grupo de opciones Consejo de la bandeja del sistema: Estas opciones controlan qué información se muestra en el consejo que aparece cuando se pasa el cursor sobre el icono de &kalarm; en la bandeja del sistema.

  - Mostrar las alarmas de las próximas 24 horas: Al estar seleccionado se muestra un resumen de las primeras alarmas en ocurrir en las próximas 24 horas.

  - Máximo número de alarmas que mostrar: Desmarque esta opción para mostrar todas las alarmas de las próximas 24 horas. Selecciónela para fijar el máximo número de alarmas que se deban mostrar.

  - Mostrar la hora de la alarma: Seleccione esta opción para mostrar la hora a la que está planificada cada alarma.

  - Mostrar tiempo hasta la alarma: Seleccione esta opción para mostrar el tiempo restante para que ocurra la siguiente alarma planificada. Este tiempo se muestra en horas y minutos.

    - Prefijo: Especifica un símbolo o texto que se mostrará delante del tiempo restante para la alarma, para distinguirlo de la hora a la que está planificada la alarma.

- Ventanas de mensajes modales: Esta opción controla si las ventanas de los mensajes de alarma son modales o no, &ie; si retienen el foco del teclado cuando aparecen. Vea la sección Ventana de mensaje de alarma para más detalles.

- Mostrar las alarmas cumplidas: Seleccione esta opción para mostrar inicialmente las alarmas cumplidas en la lista de alarmas cuando se inicia &kalarm;. (Una vez que se ha iniciado &kalarm;, use la opción Ver Mostrar las alarmas cumplidas del menú para modificar lo que se muestra).

- Intervalo de actualización de la bandeja del sistema: Fija la frecuencia con la que se debe actualizar el icono de la bandeja del sistema de &kalarm; para reflejar las alarmas que están siendo monitorizadas en la actualidad. Esto implica comprobar si el demonio de alarma está corriendo.

### Apariencia

La sección Apariencia le permite elegir la apariencia predeterminada de los mensajes de alarma:

- Seleccione la tipografía y color de fondo predeterminados que se van a usar para mostrar los mensajes de alarma.

- Edita la lista de selección de colores que se muestra al hacer clic sobre el cuadro de selección del color de fondo:

  - Nuevo color: Muestra un cuadro de diálogo de selección de colores que le permite elegir un color para que se añada a la lista.

  - Borrar color: Elimina el color que se está mostrando en ese momento en la lista de selección de colores Color de fondo. El elemento «Color personalizado» no se puede eliminar de la lista y cuando se muestra, este botón está desactivado.

### Editar

La sección Editar le permite elegir los valores predefinidos para las opciones del cuadro de diálogo de edición:

- Fije el color de texto que se usará para mostrar las alarmas cumplidas en la lista de alarmas.

- Fija los estados de alarma predefinidos para los cuadros de verificación Cancelar si ya es tarde, Confirmar asentimiento y Copia del correo a sí mismo.

- Fijar el «bip» como predeterminado para la opción Sonido.

- Fijar el tipo de repetición predeterminado.

- Fijar las unidades predeterminadas del periodo.

## Guía del desarrollador de &kalarm;

&kalarm; proporciona un interfaz para permitir que otras aplicaciones soliciten las siguientes funciones:

- planificar una alarma nueva

- lanza o cancela una alarma ya planificada

- cancela una alarma ya planificada

- lanza una alarma ya planificada

Cada una de las funciones anteriores se implementan tanto como llamadas &DCOP; como con la línea de comando. Las llamadas a &DCOP; se deberían usar como preferencias si &kalarm; ya está corriendo.

### Interfaz &DCOP;

cancelEvent

cancelEvent

cancela una alarma ya planificada.

    void cancelEvent(const QString& calendarFile, const QString& eventID)

##### Parámetros

`calendarFile`

- Especifica el &URL; del archivo de calendario que contiene el evento que va a ser cancelado.

`eventID`

- Especifica el id. único del evento que se va a cancelar, tal y como está guardado en `calendarFile`.

##### Descripción

`cancelEvent()` es una llamada &DCOP; para cancelar la alarma especificada. &kalarm; borra la alarma del archivo de calendario sin mostrarlo ni ejecutarlo.

El parámetro `calendarFile` sólo se usa para la comprobación de la integridad: si la &URL; no especifica el archivo de calendario predeterminado de &kalarm;, la petición se ignorará.

El nombre anterior para esta función, `cancelMessage`, se ha mantenido por cuestiones de compatibilidad, pero todas las aplicaciones nuevas deberían usar `cancelEvent`.

triggerEvent

triggerEvent

lanza una alarma ya planificada.

    void triggerEvent(const QString& archivoCalendar, const QString& IDevento)

##### Parámetros

`calendarFile`

- Especifica el &URL; del archivo de calendario que contiene el evento que se va a lanzar.

`eventID`

- Estecifica el ID único del evento que se va a lanzar, tal y como está almacenado en `archivoCalendar`.

##### Descripción

`triggerEvent()` es una llamada &DCOP; para provocar la visualización o ejecución inmediata de la alarma especificada (sin importar a qué hora esté planificada). &kalarm; recupera la alarma del archivo de calendario y luego la muestra o la ejecuta.

Si la alarma es una alarma cumplida, &kalarm; borrará todas las ocurrencias planificadas de la alarma hasta la hora actual, y si no hay repeticiones de la alarma, la alarma se borrará del archivo de calendario. Si la alarma aún no ha cumplido, sus ocurrencias planificadas se dejarán sin cambios.

El parámetro `calendarFile` sólo se usa para la comprobación de la integridad: si la &URL; no especifica el archivo de calendario predeterminado de &kalarm;, la petición se ignorará.

El nombre anterior para esta función, `displayMessage`, se ha mantenido por cuestiones de compatibilidad, pero todas las aplicaciones nuevas deberían usar `triggerEvent`.

handleEvent

handleEvent

lanza o cancela una alarma ya planificada.

    void handleEvent(const QString& archivoCalendar, const QString& IDevento)

##### Parámetros

`calendarFile`

- Especifica el &URL; del archivo de calendario que contiene el evento que se va a mostrar/ejecutar o cancelar.

`eventID`

- Especifica el id. único del evento que se va a mostrar/ejecutar o cancelar, tal y como está almacenado en `archivoCalendar`.

##### Descripción

`handleEvent()` es una llamada &DCOP; para mostrar/ejecutar o cancelar la alarma especificada. &kalarm; recupera la alarma del archivo de calendario y luego determina qué acción llevar a cabo según el vencimiento de la alarma.

- Si la alarma aún no ha cumplido, no pasa nada.

- Si la alarma ha cumplido, actúa de la siguiente manera: Si se ha puesto la bandera de cancelar si es tarde y la alarma llega tarde, &ie; la hora de lanzamiento planificada era hace más de un minuto, &kalarm; no muestr ni ejecuta la alarma; en otro caso, &kalarm; muestra o ejecuta la alarma. Si no quedan repeticiones planificadas de la alarma, &kalarm; borra la alarma del archivo de calendario.

El parámetro `calendarFile` sólo se usa para la comprobación de la integridad: si la &URL; no especifica el archivo de calendario predeterminado de &kalarm;, la petición se ignorará.

scheduleMessage

scheduleMessage

planifica un nuevo mensaje de alarma.

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, const QFont& tipografia, int banderas, const QString& audioURL, int recordatorio, const QString& repeticion)

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, const QFont& tipografia, int banderas, const QString& audioURL, int recordatorio, const QString& repeticion)

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& audioURL, int recordatorio, int tipoRepeticionSimple, int intervalo, int contadorRepeticiones)

    bool scheduleMessage(const QString& mensaje, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& audioURL, int recordatorio, int tipoRepeticionSimple, int intervalo, const QDateTime& horaFin)

##### Parámetros

`mensaje`

- Especifica el texto del mensaje que se va a planificar.

`fechaHora`

- Especifica la fecha y la hora planificadas a las que se debe mostrar el mensaje.

`bg`

- Especifica el color de fondo para mostrar el mensaje.

`fg`

- Especifica el color de primer plano para mostrar el mensaje.

`tipografia`

- Especifica la tipografía para mostrar el mensaje.

`banderas`

- Especifica el O lógico de las banderas del mensaje de alarma seleccionado. Los bits de la bandera son los que se definen en la clase KAlarmEvent en `alarmevent.h`

`audioURL`

- Especifica el nombre o &URL; de un archivo de audio para que se reproduzca cuando se muestre el mensaje.

`recordatorio`

- Especifica el número de minutos antes de la alarma principal y de cada una de sus repeticiones (si es que las hay) que se debe mostrar un recordatorio de la alarma. Especifique 0 si no quiere recordatorio.

`repeticion`

- Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`tipoRepeticionSimple`

- Especifica el tipo de repetición para la alarma. Los valores admitidos son MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. (Respectivamente, cada minuto, diario, semanal, día del mes, día del año) . Se definen en la clase KAlarmEvent en `alarmevent.h`.

`intervalo`

- Especifica el número de períodos (minutos/días/semanas/meses/años) entre las repeticiones del mensaje de alarma.

`contadorRepeticiones`

- Especifica el número de veces que se debe mostrar el mensaje de alarma. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleMessage()` es una llamada &DCOP; para planificar que se muestre el mensaje de alarma planificado en la fecha y hora indicada. Hay varias formas. Las dos más habituales permiten especificar una repetición arbitraria - úsela también para alarmas sin repetición. También puede especificar un parámetro de tipografía, o ninguno para usar la tipografía predeterminada de &kalarm;. Las otras formas proporcionan un acceso conveniente para para fijar tipos de alarmas con repetición, o especificar un contador de repeticiones, o una hora de fin; todos estos tipos usan la tipografía predefinida.

Si la hora planificada (incluyendo cualquier repetición), ya ha pasado,&kalarm; mestra el mensaje inmediatamente o, si el bit de bandera LATE_CANCEL flag está puesto, ignora la petición. Si la hora planificada (o una repetición) ocurre en el futuro, &kalarm; añade el mensaje de alarma al archivo de calendario para mostrarlo más tarde.

Use una secuencia de código similar a la siguiente para configurar los datos de los parámetros para la llamada &DCOP; a `scheduleMessage()` para una alarma sin repetición, o para una alarma que se repite regularmente usando la sintaxis de iCalendar para especificar su repetición:

    QString message, audioFile, recurrence;
    QDateTime dateTime;
    QColor bgColor, fgColor;
    Q_UINT32 flags;
    Q_INT32 reminder;
    . . .
    QByteArray data;
    QDataStream arg(data, IO_WriteOnly);
    arg << message;
    arg.writeRawBytes((char*)&dateTime, sizeof(QDateTime));
    arg.writeRawBytes((char*)&bgColor, sizeof(QColor));
    arg.writeRawBytes((char*)&fgColor, sizeof(QColor));
    arg << flags << audioFile << reminder << recurrence;

Use una secuencia de código similar a la siguiente para configurar los datos de los parámetros para una llamada &DCOP; a `scheduleMessage()` para una alarma que se repite a intervalos regulares sin usar la sintaxis de iCalendar:

    QString message, audioFile;
    QDateTime dateTime;
    QColor bgColor, fgColor;
    Q_UINT32 flags;
    Q_INT32 reminder, repeatType, repeatCount, repeatInterval;
    . . .
    QByteArray data;
    QDataStream arg(data, IO_WriteOnly);
    arg << message;
    arg.writeRawBytes((char*)&dateTime, sizeof(QDateTime));
    arg.writeRawBytes((char*)&bgColor, sizeof(QColor));
    arg.writeRawBytes((char*)&fgColor, sizeof(QColor));
    arg << flags << audioFile << reminder << repeatType << repeatCount << repeatInterval;

scheduleFile

scheduleFile

planifica una alarma nueva que muestra los contenidos de un archivo de texto o de imagen.

    bool scheduleFile(const QString& URL, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& audioURL, int recordatorio, const QString& repeticion)

    bool scheduleFile(const QString& URL, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& audioURL, int recordatorio, int tipoRepeticionSimple, int intervalo, int contadorRepeticiones)

    bool scheduleFile(const QString& URL, const QDateTime& fechaHora, const QColor& bg, int banderas, const QString& audioURL, int recordatorio, int tipoRepeticionSimple, int intervalo, const QDateTime& horaFin)

##### Parámetros

`URL`

- Especifica el nombre o &URL; de un archivo de texto o de imagen cuyo contenido se va a mostrar en el mensaje planificado.

`fechaHora`

- Especifica la fecha y hora planificadas a las que se debe mostrar el archivo.

`bg`

- Especifica el color de fondo para mostar el archivo.

`banderas`

- Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los definidos en la clase KAlarmEvent en `alarmevent.h`

`audioURL`

- Especifica el nombre o &URL; de un archivo de audio para que se reproduzca cuando se muestre el mensaje.

`recordatorio`

- Especifica el número de minutos antes de la alarma principal y de cada una de sus repeticiones (si es que las hay) que se debe mostrar un recordatorio de la alarma. Especifique 0 si no quiere recordatorio.

`repeticion`

- Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`tipoRepeticionSimple`

- Especifica el tipo de repetición para la alarma. Los valores admitidos son MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. (Respectivamente, cada minuto, diario, semanal, día del mes, día del año) . Se definen en la clase KAlarmEvent en `alarmevent.h`.

`intervalo`

- Especifica el número de períodos (minutos/días/semanas/meses/años) entre las repeticiones de las alarmas.

`contadorRepeticiones`

- Especifica el número de veces que se debe mostrar el archivo. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleFile()` es una llamada &DCOP; para planificar la visualización del archivo de texto a la fecha y hora planificadas. Aparte de especificar un nombre de archivo o &URL;, su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para más detalles.

scheduleCommand

scheduleCommand

planifica una alarma nueva que ejecuta un comando de la shell.

    bool scheduleCommand(const QString& lineaComando, const QDateTime& fechaHora, int banderas, const QString& repeticion)

    bool scheduleCommand(const QString& lineaComando, const QDateTime& fechaHora, int banderas, int tipoRepeticionSimple, int intervalo, int contadorRepeticiones)

    bool scheduleCommand(const QString& lineaComando, const QDateTime& fechaHora, int banderas, int tipoRepeticionSimple, int intervalo, const QDateTime& horaFin)

##### Parámetros

`lineaComando`

- Especifica la línea de comando de la shell cuya ejecución de la shell se va a planificar.

`fechaHora`

- Especifica la fecha y hora planificadas de la alarma a las que se ejecutará el comando.

`banderas`

- Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los que se definen en la clase KAlarmEvent en `alarmevent.h`, salvo que la bandera BEEP se ignora.

`repeticion`

- Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`tipoRepeticionSimple`

- Especifica el tipo de repetición para la alarma. Los valores admitidos son MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. (Respectivamente, cada minuto, diario, semanal, día del mes, día del año) . Se definen en la clase KAlarmEvent en `alarmevent.h`.

`intervalo`

- Especifica el número de períodos (minutos/días/semanas/meses/años) entre las repeticiones de las alarmas.

`contadorRepeticiones`

- Especifica el número de veces que se debe repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleCommand()` es una llamada &DCOP; para planificar la ejecución de la línea de comando de la shell especificada y omitir los parámetros de color del mensaje y archivo de audio. Su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para más detalles.

scheduleEmail

scheduleEmail

planifica una alarma nueva que manda un correo electrónico.

    bool scheduleEmail(const QString& direcciones, const QString& asunto, const QString& mensaje, const QString& adjuntos, const QDateTime& fechaHora, int banderas, const QString& repeticion)

    bool scheduleEmail(const QString& direcciones, const QString& asunto, const QString& mensaje, const QString& adjuntos, const QDateTime& fechaHora, int banderas, int tipoRepeticionSimple, int intervalo, int contadorRepeticion)

    bool scheduleEmail(const QString& direcciones, const QString& asunto, const QString& mensaje, const QString& adjuntos, const QDateTime& fechaHora, int banderas, int tipoRepeticionSimple, int intervalo, const QDateTime& horaFin)

##### Parámetros

`direcciones`

- Especifica las direcciones de correo electrónico de los destinatarios. Especifique múltiples direcciones separándolas por comas.

`asunto`

- Especifica la línea del asunto del correo.

`mensaje`

- Especifica el cuerpo del mensaje del correo.

`adjuntos`

- Especifica el &URL; de los archivos para ser adjuntados al correo. Separe múltiples &URL;s por comas.

`fechaHora`

- Especifica la fecha y hora planificadas a las que se deba enviar el correo.

`banderas`

- Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los definidos en la clase KAlarmEvent en `alarmevent.h`

`repeticion`

- Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`tipoRepeticionSimple`

- Especifica el tipo de repetición para la alarma. Los valores admitidos son MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. (Respectivamente, cada minuto, diario, semanal, día del mes, día del año) . Se definen en la clase KAlarmEvent en `alarmevent.h`.

`intervalo`

- Especifica el número de períodos (minutos/días/semanas/meses/años) entre las repeticiones de las alarmas.

`contadorRepeticiones`

- Especifica el número de veces que se debe enviar el correo. Especifique -1 para repetir la alarma indefinidamente.

##### Descripción

`scheduleEmail()` es una llamada &DCOP; para planificar el envío del correo-e a una fecha y hora planificada. Además de especificar la cabecera del correo-e y el contenido y omitir los parámetros de color del mensaje y archivo de audio, su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para más detalles.

### Interfaz de la línea de comandos

Las opciones de la línea de comando se proporcionan para hacer posible que otros programas (como el demonio de alarma) lancen &kalarm;, si es que no está corriendo ya, para lanzar o cancelar las alarmas planificadas, o para planificar alarmas nuevas. La razón para usar estas opciones de la línea de comando para este propósito es que si &kalarm; se iniciara sin ningún parámetro en la línea de comandos y luego enviaba peticiones &DCOP;, se iniciaría en modo gráfico predeterminado, lo que no es muy deseable para peticiones internas del programa.

Los programas deberían comprobar primero si &kalarm; ya está corriendo; si es así, deberían intentar usar llamadas &DCOP; para solicitar estas operaciones.

Las opciones de la línea de comando que se usan para planificar una alarma nueva se describen en el capítulo Usar &kalarm;. Las opciones para lanzar y cancelar alarmas planificadas son las siguientes:

Los usuarios normales también deberían usar si quieren estas opciones de la línea de comando (asumiendo que puedan proporcionar la información necesaria de los parámetros).

Opción | Descripción
`--calendarURL `url`` | Usa el archivo de calendario con la &URL; especificada. Esta opción sólo se usa para comprobaciones de integridad: si el &URL; no especifica el archivo de calendario predeterminado de &kalarm;, la petición se ignorará.
`--cancelEvent `IDevento`` | Cancela el evento con el ID de evento especificado.
`--triggerEvent `IDevento`` | Lanza el evento con el ID de evento especificado. La acción realizada es la misma que en la llamada &DCOP; triggerEvent().
`--handleEvent `IDevento`` | Lanza o cancela el evento con un ID de evento especificado. &kalarm; determina qué acción llevar a cabo de la misma manera que para la llamada &DCOP; handleEvent().

`--cancelEvent`, `--triggerEvent` y `--handleEvent` son mutuamente exclusivas. `--calendarURL` es opcional, pero sólo se puede usar con una de las otras tres opciones.

Ejemplos:

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

## Preguntas y respuestas

&reporting.bugs; &updating.documentation;

¿Qué archivos de configuración usa &kalarm;?

El archivo `$KDEHOME/share/config/kalarmrc` mantiene sus &kalarm; preferencias.

El archivo de calendario que guarda sus alarmas pendientes es `$KDEHOME/share/apps/kalarm/calendar.ics`, a no ser que haya especificado un archivo de calendario diferente en el archivo de preferencias mediante una entrada `Calendario` en la sección `General`.

Si cambia este archivo de calendario en el archivo de preferencias, debería editar también la configuración del archivo `clients` del demonio de alarma para borrar la referencia al archivo de calendario anterior. Esto se debería hacer mientras el demonio de alarma no esté corriendo, para evitar que se sobreescriban sus cambios.

El archivo de calendario que guarda sus alarmas cumplidas es `$KDEHOME/share/apps/kalarm/expired.ics`, a no ser que haya especificado un archivo de calendario especificado en el archivo de preferencias.

Los detalles de las alarmas que se están mostrando actualmente se guardan en el archivo de calendario `$KDEHOME/share/apps/kalarm/displaying.ics`.

¿Qué archivos de configuración usa el demonio de alarma?

El archivo `$KDEHOME/share/config/kalarmdrc` mantiene las preferencias de su demonio de alarma.

El archivo `$KDEHOME/share/apps/kalarmd/clients` mantiene los detalles de las aplicaciones cliente que se hayan registrado previamente con el demonio de alarma y sus archivos de calendario.

¿Cuáles son los nombres de las aplicaciones &kalarm; y el demonio de alarma?

El nombre de la aplicación de &kalarm; es kalarm, y el nombre de la aplicación del demonio de alarma es kalarmd. Además, en las versiones de &kde; anteriores a la 3.1, había una pequeña aplicación llamada kalarmautostart, cuya función es iniciar el icono de la bandeja del sistema de &kalarm; al ingresar.

## Créditos y licencia

&kalarm;

Copyright del programa 2001, 2002, 2003 David Jarvie software@astrojar.org.uk

Autores del demonio de alarma:

- Preston Brown pbrown@kde.org

- David Jarvie software@astrojar.org.uk

- Cornelius Schumacher schumacher@kde.org

Copyright de la documentación 2001, 2002, 2003 David Jarvie software@astrojar.org.uk

Juan Manuel García Molinajuanma@superiodico.net

Gracias al autor de la aplicación KAlarm de &kde;1, Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, que accedió amablemente a permitir el uso del nombre &kalarm; para esta aplicación de &kde;2/&kde;3.

&underFDL; &underGPL;

## Instalación

### Cómo obtener &kalarm;

&install.intro.documentation;

&kalarm; está disponible para &kde;2 y como un paquete individual para &kde;3 en http://www.astrojar.org.uk/linux/kalarm.html

### Requisitos

&kalarm; precisa que las bibliotecas estándar de &kde; estén instaladas (el paquete `kdelibs`). Para compilar desde los fuentes, también necesitará los paquetes de desarrollo de &Qt; y `kdelibs`. El paquete de desarrollo de X11, si está presente, se usa para mejorar la capacidad de &kalarm; para funcionar bajo &kde; sin una bandeja del sistema.

&kalarm; usa sobre 12 MB y el demonio de alarma use sobre 2.5 MB de memoria para funcionar, pero esto puede variar según su plataforma y configuración.

Puede encontrar una lista de cambios en el archivo `ChangeLog`, o en http://www.astrojar.org.uk/linux/kalarm.html.

### Compilación e instalación

Si no puede obtener un paquete binario precompilado adecuado, tendrá que compilar &kalarm; desde los archivos fuente. Obtenga el archivo del paquete fuente `kdepim-x.x.tar.bz2` o `kalarm-x.x.tar.bz2` (o similar), según quiera instalar el &package; o simplemente &kalarm;. Desempaquételo en un directorio nuevo usando un comando parecido a ``tar` `xvfj `paquete.tar.bz2```, y vaya a la carpeta que se ha creado.

&install.compile.documentation;

Si tiene más de una versión de &kde; instalada (por ejemplo, &kde;2 y &kde;3), puede ser posible que instale &kalarm; en la carpeta equivocada de &kde;. Si fuera necesario, puede pasar la carpeta de &kde; como parámetro a ``./configure``. Por ejemplo, si su &kde; está instalado en `/opt/kde2`:

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

### Configuración

No se necesita una configuración especial para configurar &kalarm; para que funcione con el escritorio &kde;. Una vez que haya lanzado &kalarm; por vez primera, el demonio de alarma comenzará cada vez que ingrese, para monitorizar las alarmas planificadas.

Para lanzar &kalarm; en un escritorio que no sea &kde;, el principal requisito es asegurar que el demonio de alarma es lanzado automáticamente cuando ingresa. Hay instrucciones más detalladas en el archivo `INSTALL` que se distribuye con &kalarm;.

&documentation.index;