# Manual de &kalarm;

David Jarvie

    &David.Jarvie.mail;

David Jarvie

    &David.Jarvie.mail;

Desarrollador
Juan Manuel García Molina

    juanma@superiodico.net

Traductor
Javier Viñal Gutiérrez

    fjvinal@gmail.com

Traductor
2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2016 2018 2019 2020 2021 2022 2023 2024 2025 &David.Jarvie;
&FDLNotice;
2025-03-17
3.11.0 (KDE Gear 25.04)

&kalarm; es un gestor de mensajes de alarma, ordenes y planificador de correo de &kde;.

KDE kdepim kalarm alarma recordatorio planificador

## Introducción

&kalarm; le permite planificar la visualización de mensajes personales de alarma, la reproducción de archivos de sonido, la ejecución de órdenes y el envío de correos electrónicos.

&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 una alarma, puede elegir si debe repetirse y si la alarma debería cancelarse si no puede dispararse en el momento planificado. Para alarmas de visualización, puede teclear en un mensaje de texto, indicar un archivo de texto o de imagen para mostrar o indicar una orden cuya salida se visualizará. También puede seleccionar el color del mensaje de alarma, si se debe reproducir un sonido o leer el mensaje.

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

Cuando un mensaje de alarma vence, si el sistema de ventanas lo permite, se muestra en cada escritorio para asegurarse 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 de aplazamiento para pedir que la alarma se vuelva a mostrar más tarde. Un ejemplo de un mensaje de alarma:

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

Opcionalmente, un mensaje de alarma se puede mostrar como una notificación en lugar de en una ventana.

Cuando la alarma especifica una orden a ejecutar o el envío de un correo, &kalarm; no muestra nada.

&kalarm;, generalmente muestra un icono en la bandeja del sistema, aunque puede ocultarse si se desea.

## Usando &kalarm;

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

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 pulsa sobre los botones de la flecha.

### Tipos de alarma

Las funciones básicas disponibles desde los diferentes tipos de alarma que proporciona &kalarm; son:

- Mostrar las alarmas como un mensaje de texto que escriba, o el contenido de un archivo de texto o imagen, o la salida textual de una orden que se ejecuta cuando la alarma se desencadena. Además de mostrar cualquiera de estos elementos, puede reproducir archivos de audio, que su texto sea leído, o emitir un sencillo pitido. También se pueden especificar órdenes para que sean ejecutadas antes y después de que se muestre el mensaje de alarma.

- Las alarmas de órdenes ejecutan bien una orden o un guion de shell que usted puede teclear. Nada se visualiza, salvo que ocurra un error.

- Las alarmas de correo envían un correo. Nada se muestra, salvo que ocurra un error.

- Las alarmas de audio reproducen un archivo de audio. No se muestra nada, salvo que ocurra un error.

#### Manejo de errores

Si aparece un error cuando una alarma se desencadena, se mostrará un mensaje de error (salvo que haya especificado previamente no mostrar mensajes de error para ese tipo de mensaje de nuevo).

Si ocurrió un error de ejecución la última vez que se disparó una alarma de orden, se muestra una exclamación blanca sobre rojo en la columna de mensajes. Los detalles del error se visualizan en un consejo emergente si sitúa el cursor sobre esa línea en la lista de alarmas. Se muestran las mismas indicaciones de error para las alarmas de visualización si sucede un error de ejecución en una orden de pre o postalarma especificada en el diálogo de acciones especiales, excepto que el color del fondo de la columna no se cambia a rojo.

### Lista de alarmas

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

Tenga en cuenta que la columna Nombre solo existe si el uso de nombres de alarmas está activado en la pestaña General del diálogo de configuración.

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

Para una alarma que se repite, la lista muestra su próxima hora de activación y su intervalo básico de repetición (⪚ 1 día para una repetición diaria, 3 semanas para una repetición que se desencadena los lunes y los miércoles cada tres semanas, Inicio de sesión para una alarma que se repite en cada inicio de sesión).

Si ocurre un error de ejecución la última vez que una alarma de orden se dispara, o la última vez que una orden de pre o postalarma de una alarma de visualización se ejecuta, se muestra una indicación de error en el color de la columna, como se describe más arriba en Manejo de errores.

#### Cambiando la apariencia de la lista de alarmas

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

De forma opcional, puede mostrar el tiempo restante hasta que venza cada alarma junto (o en lugar de) la hora programada de la alarma.

Puede seleccionar las columnas a mostrar o a ocultar haciendo clic con el botón derecho en las cabeceras de las columnas y usar el menú de contexto para definir las columnas a mostrar. Pero debe tener en cuenta que al menos una de las columnas Nombre o Mensaje, archivo u orden, y al menos otra de las columnas Hora o Tiempo hasta se muestran siempre.

Si utiliza varios calendarios de alarma, puede colorear los códigos de alarma de acuerdo al calendario al que pertenecen, seleccionando un color de fondo distinto para cada calendario (consulte Uso de calendarios).

#### Alarmas archivadas

Por omisión, &kalarm; archiva las alarmas durante un periodo de tiempo una vez que se han cumplido o se han borrado (pero tenga en cuenta que las alarmas que elimina se archivan únicamente si se han producido al menos una vez). Puede controlar si &kalarm; debe almacenar o no las alarmas cumplidas y durante cuánto tiempo, en el Diálogo de configuración.

Las alarmas archivadas se pueden mostrar en la lista de alarmas seleccionando Ver Mostrar alarmas archivadas. Para volver a ocultarlas, seleccione Ver Ocultar alarmas archivadas.

#### Filtrar la lista de alarmas por fecha

Puede restringir la lista de alarmas para que muestre únicamente las alarmas programadas para una determinada fecha. Para ello, use el selector de fecha de alarmas, que se puede mostrar u ocultar mediante Ver Mostrar selector de fecha . Seleccione una fecha haciendo clic en ella en el selector de fecha o anule la selección haciendo clic en ella nuevamente. El selector de fecha solo muestra un mes. Para mostrar un mes diferente, use los controles de flecha del selector de fecha o la rueda del ratón.

#### Buscar en la lista de alarmas

Puede buscar a través de la lista de alarmas para encontrar las que contengan un texto en concreto. Para ello, seleccione Editar Buscar. En el diálogo de búsqueda, seleccione los tipos de alarma en los que quiera buscar. Para seguir buscando más alarmas que concuerden, use Editar Buscar siguiente o Editar Buscar anterior .

La búsqueda se realiza como sigue:

- Alarmas de mensajes de texto: se busca el mensaje de texto.

- Alarmas de visualización: se busca el &URL; o ruta del archivo.

- Alarmas de orden: se busca en la línea de órdenes o de guiones de órdenes.

- Alarmas de correo: además del asunto y del cuerpo del correo, se busca en los destinatarios y en los URL de los adjuntos.

- Alarmas de audio: se busca la &URL; o ruta del archivo.

Solo se pueden seleccionar para la búsqueda las alarmas de la lista. Por tanto, si quiere buscar en las alarmas archivadas, primero debe mostrarlas como está descrito en la sección anterior.

### Crear y manipular alarmas

#### Crear una alarma nueva

Para crear una alarma nueva, haga una de las siguientes acciones y después seleccione el tipo de alarma de la lista que aparece. Con ellas se muestra el Diálogo de edición de alarma con el que puede configurar la alarma.

- Seleccione Archivo Nuevo.

- Pulse Derecho sobre el icono de la bandeja del sistema y elija Nueva alarma en el menú de contexto.

- Pulse con el botón derecho sobre la lista de alarmas y elija Nuevo en el menú de contexto.

También puede crear alarmas nuevas preconfiguradas desde varias fuentes:

- Para preajustar la fecha de la alarma en el diálogo Editar alarma, pulse con el botón derecho en una fecha del selector de fecha de la alarma (consulte Filtrar la lista de alarmas por fecha) y seleccione el tipo de alarma apropiado en el menú de contexto.

- Para basar su alarma nueva en una plantilla de alarma, siga las instrucciones de la sección Plantillas de alarma.

- Para basar su alarma nueva en una existente, resalte la alarma existente en la lista y seleccione Archivo Copiar. Esto abre el 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;. A continuación, seleccione la opción Mostrar alarma. Esto abre el Diálogo de edición de alarmas con el texto completo del correo electrónico (incluyendo remitente, destinatario, etc.) como texto de la alarma.

- Para crear una alarma de correo nueva para enviar una copia de un mensaje de correo existente, arrastre el correo desde &kmail; a la ventana principal de &kalarm;. Luego, seleccione la opción Alarma de correo. El Diálogo de edición de alarma está inicializado con el mensaje de correo completo, salvo el remitente.

- Para crear una alarma nueva que muestre un resumen o una tarea pendiente existente, arrastre la tarea pendiente desde &korganizer; u otra aplicación a la ventana principal de &kalarm;. Se abre el Diálogo de edición de alarmas con el contenido de la tarea pendiente y el texto de la alarma.

- Para crear una nueva alarma de orden, arrastre el texto de un guion que comience por #! en la ventana principal &kalarm;. Luego, seleccione la opción Alarma de orden. Esto abre la predefinición Diálogo de edición de alarma con el texto del guion.

- Para crear una alarma que muestre archivos, arrastre una &URL; de archivo de texto o imagen a la ventana principal de &kalarm;. Esto abre el diálogo de edición de alarmas y pone allí el nombre del archivo.

- Para crear una alarma de audio, arrastre una &URL; de archivo de audio a la ventana principal de &kalarm;. Esto abre el diálogo de edición de alarmas y pone allí el nombre del archivo.

- Para crear un texto de mensaje de alarma, arrastre cualquier fragmento de texto en la ventana principal de &kalarm;. Si se le pregunta, seleccione la opción Mostrar alarma. Esto abre la predefinición Diálogo de edición de alarmas con el texto de la alarma.

- 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 expirado no se pueden recuperar), haga una de las siguientes cosas:

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

- Selecciónelo pulsando sobre su entrada en la lista de alarmas. Luego elija Editar Editar.

- Pulse con el botón derecho sobre su entrada en la lista de alarmas y elija Editar desde el menú contextual.

Esto muestra el Diálogo de edición de alarmas.

#### Eliminando/reactivando una alarma

Para borrar alarmas existentes, seleccione una o más pulsando sobre sus entradas en la lista de alarmas. Después haga algo de lo siguiente:

- Elija Editar Borrar.

- Pulse con el botón Derecho sobre las entradas seleccionadas y elija Borrar en el menú de contexto.

- Para borrarlas sin petición de confirmación, teclee &Shift;-Borrar.

Cuando borra una alarma activa, se archiva, supuesto que se haya disparado al menos una vez antes de ser borrada y supuesto que se archivan todas las alarmas cumplidas (use el Diálogo configuración para controlar si se deben archivar las alarmas y durante cuánto tiempo se almacenan). Cuando borre una alarma archivada o una alarma activa que no se haya disparado todavía, se elimina permanentemente.

Puede reactivar una alarma borrada en la lista de alarmas archivadas, suponiendo que todavía no haya expirado. Para ello, primero tiene que mostrar las alarmas archivadas, tal y como se describe en Alarmas archivadas. Luego:

- Seleccione una o más de las alarmas archivadas pulsando en sus entradas de la lista de alarmas. Luego elija Acciones Reactivar .

- Pulse con el botón derecho sobre las entradas archivadas que desee en la lista de alarmas archivadas y elija Reactivar en el menú de contexto.

#### Activando/desactivando una alarma

Vea Activando y desactivando las alarmas para saber cómo activar y desactivar alarmas, bien individualmente o en conjunto.

#### Establecer una alarma para despertar desde suspendido

Consulte Despertar desde suspendido para ver como configurar una alarma para despertar su sistema desde suspensión o hibernación.

#### Confirmar una alarma

Consulte Mostrar de mensaje de alarma para saber cómo reconocer las alarmas.

#### Plantillas de alarma

Si quiere configurar con frecuencia alarmas similares, puede crear una plantilla de alarma para evitar tener que introducir cada vez todos los detalles desde cero. Una plantilla puede tener todos los detalles que puede tener una alarma, aparte de la fecha de comienzo.

Como ejemplo, puede querer configurar una alarma regularmente para que le recuerde un programa de televisión cuya emisión varía de semana en semana. La plantilla debería tener todos los detalles de la alarma (mensaje de texto, si reproducir un sonido, &etc;), salvo la hora y la fecha. Ahora, para crear la alarma, todo lo que tiene que hacer es abrir Diálogo de edición de alarmas con esa plantilla y luego indicar la hora y la fecha.

Para crear una alarma basada en una plantilla, abra el Diálogo de edición de alarma, con las opciones predeterminadas de los detalles de la plantilla:

- Seleccione la opción Archivo Nuevo Nueva alarma desde plantilla del menú y luego elija la plantilla que desee.

- Pulse con el botón derecho sobre el icono de la bandeja del sistema y elija Nueva alarma Nueva alarma desde plantilla en el menú contextual. Luego seleccione la plantilla que desee.

- Abra el Diálogo de edición de alarma de la forma habitual y pulse en el botón Cargar plantilla… para seleccionar una plantilla con algunas opciones predeterminadas para el diálogo.

##### Configurando plantillas

Puede crear, modificar o borrar plantillas usando el diálogo de plantillas de alarma, o puede crear una plantilla de alarma nueva basada en una alarma existente.

Para crear un plantilla de alarma nueva, haga una de las siguientes acciones:

- Muestra el diálogo de las plantillas de alarma seleccionando la opción Archivo Plantillas… del menú y pulse sobre Nuevo y elija el tipo de alarma de la lista que aparece. Esto muestra un diálogo de edición con una plantilla vacía.

- Muestra el diálogo de plantillas de alarma seleccionando la opción Archivo Plantillas… del menú, seleccione una plantilla de la lista y pulse sobre Copiar. Esto abre el diálogo de edición ya relleno con una copia de los detalles de la plantilla existente.

- Resalte una alarma de la lista y seleccione Archivo Crear plantilla… . Se abrirá el cuadro de diálogo de edición de plantillas ya relleno con una copia de los detalles de la alarma seleccionada.

Para modificar una plantilla existente, muestre el diálogo de plantillas de alarma seleccionando la opción Archivo Plantillas… del menú y pulse sobre Editar. Se mostrará el diálogo de edición de plantillas que se describe más abajo.

Para eliminar las plantillas existentes, muestre el diálogo de plantillas de alarma seleccionando la opción Archivo Plantillas… del menú, seleccione una o más plantillas y pulse sobre Eliminar. Se solicitará confirmación para evitar los borrados accidentales.

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

El diálogo de edición de plantillas es similar al diálogo de edición de alarmas descrito en elDiálogo de edición de alarmas. Son diferentes los siguientes controles:

- Indique el nombre de la plantilla en Nombre de la plantilla. Es el nombre de la plantilla que se muestra en las listas de selección de plantillas, así que es mejor elegir un nombre que le recuerde su función. El nombre de la plantilla debe ser único.

- En el grupo de opciones Hora, seleccione una de:

  - Hora predeterminada si no quiere indicar ninguna hora de activación. Las alarmas que se basan en esta plantilla usarán inicialmente la hora de activación normal predeterminada para las alarmas nuevas.

  - Marque Hora para indicar una hora a la que la alarma se deba producir.

  - Marque Solo fecha para indicar que la alarma solo debe tener fecha, no hora.

  - Marque Tiempo desde ahora para introducir cuánto tiempo (en horas y minutos) después de crear la alarma se debe producir.

- En el grupo de opciones Reglas de repetición, en la pestaña Repetición, no necesita seleccionar ni día ni mes para la repetición semanal ni anual, respectivamente.

#### Alarmas de calendario

Si solo utiliza un equipo y trabaja de forma independiente, no importa el lugar en el que &kalarm; almacena sus alarmas. Pero si necesita acceder a las alarmas en más de un equipo, o en más de una ubicación de su equipo local, puede definir alarmas de calendario para decirle a &kalarm; que utilice otros calendarios de alarmas adicionales para, o en lugar de las predeterminadas.

Puede ver y manipular calendarios mediante la lista de calendarios, que se puede mostrar junto con la lista de alarmas de la ventana principal de &kalarm;. Se muestran combinadas las alarmas de todos los calendarios en la lista de alarmas. Cuando guarde una alarma nueva, puede definir una opción de configuración para determinar si se debe guardar automáticamente en el calendario predeterminado o si se le debe pedir que elija un calendario. Cuando edite una alarma existente, se guarda automáticamente en el recurso original de la alarma.

Captura de pantalla de la ventana principal de &kalarm; mostrando la lista de calendario
Ventana principal mostrando la lista de calendario

##### Tipos de calendario y opciones

Los calendarios de alarmas están organizados por tipo de alarma y por tipo de almacenamiento. Se pueden desactivar, definir como de solo lectura o convertir en el calendario predeterminado para su tipo de alarma.

Tipo de alarma

  Los tres tipos de entidades de alarma – alarmas activas, alarmas archivadas y plantillas de alarmas – se almacenan en calendarios de alarmas aparte. &kalarm; tiene tres tipos de calendario predeterminados estándar, uno para cada tipo (para más detalles, puede dirigirse a Preguntas y respuestas), que puede cambiar si lo desea.

Tipo de almacenamiento

  &kalarm; maneja dos tipos de almacenamiento de calendarios de alarmas:

  - Archivo local: Las alarmas se almacenan en un archivo local en formato iCalendar. &kalarm; utiliza calendarios de archivos locales de forma predeterminada (tiene más detalles en Preguntas y respuestas). Archivos locales, además de los archivos en el equipo local, pueden incluir calendarios de alarmas en la red local, así como sus ubicaciones se pueden representar por una ruta que comience con `/`.

  - Archivo remoto: Las alarmas se almacenan en un único archivo remoto en formato iCalendar. Este método de almacenamiento le permite acceder a los datos de alarmas de forma remota sin importar dónde se encuentre y también que otras personas vean los calendarios de las alarmas. Cuando usa archivos remotos, &kalarm; trabaja con una copia local de los datos.

    &kalarm; no supervisa los calendarios de alarmas remotos para detectar cambios, por lo que si alguien más realiza cambios, &kalarm; podría sobrescribirlos. Para evitar esta situación, se recomienda adoptar una de las siguientes políticas:

    - Garantizar que solo una persona o aplicación acceda al calendario a la vez.

    - Todos los usuarios excepto el propietario del calendario deben configurar el calendario como de solo lectura.

    En caso contrario, como mínimo, debería volver a cargar el calendario antes de modificarlo o fiarse de su contenido usando el método que se describe en Uso de calendarios. Tenga en cuenta también que si el calendario está configurado como de solo lectura, &kalarm; lo sobrescribirá cuando se genere una alarma.

Estado activado/desactivado

  La desactivación de un calendario tiene el mismo efecto que eliminarlo, salvo que aparece en la lista de calendarios para reactivarlo de forma sencilla. Cuando se desactiva, se ignoran sus alarmas y no aparecen en la lista de alarmas ni en la lista de plantillas. Cuando se reactivan, las alarmas se vuelven a mostrar una vez más y si es un recurso activo de alarmas, se activa.

Estado de solo lectura

  Las alarmas de un calendario de solo lectura no se pueden modificar ni añadir. Por lo tanto, no se pueden editar ni guardar nuevas alarmas. Tampoco se pueden aplazar las alarmas, ya que para ello sería necesario guardar el tiempo de aplazamiento en la alarma. Una vez que se activan las alarmas, no se eliminan del calendario ni se archivan hasta que se acceda al calendario en modo de lectura y escritura.

  Puede definir el estado de solo lectura de un calendario en el diálogo de configuración del calendario. Sin embargo, algunos calendarios no se pueden escribir, por varios motivos:

  - Si un calendario se ha creado con otra aplicación, no sería seguro permitir que &kalarm; lo actualizase, porque alguna diferencia en el formato de datos podría convertirlo en inutilizable para la aplicación original.

  - Si el calendario se creó con una versión posterior de &kalarm;, se podrían perder si su versión de &kalarm; lo actualizó.

  - Si el calendario lo creó con una versión anterior de &kalarm;, se pueden perder datos o pueden ser inutilizables para las versiones anteriores de &kalarm; si su versión de &kalarm; los actualizó. Se le pedirá que convierta el formato para que se pueda escribir en el archivo, admitiendo los potenciales problemas de compatibilidad si tiene que acceder desde una versión anterior de &kalarm;.

  - Si no tiene permiso para escribir el archivo o la carpeta de calendarios.

  Si necesita permiso de escritura para los datos de la alarma en un calendario que no puede escribir, puede copiar sus alarmas importándolas en un calendario en el que tenga permiso de escritura, usando la opción Importar… del menú contextual del calendario (más información en Importar alarmas de calendarios externos).

Estado del calendario predeterminado

  Opcionalmente, se puede definir el calendario predeterminado para cada tipo de alarma. Las alarmas nuevas se guardan automáticamente en el calendario predeterminado para el tipo de alarma predeterminado, a no ser que haya seleccionado la opción de preguntar por nuevas alarmas y plantillas en el diálogo Preferencias.

##### Usando calendarios

Puede ver y manipular los recursos mediante la lista de calendarios, que se pueden mostrar u ocultar mediante Ver Mostrar calendarios . Al usar la lista de calendarios, seleccione primero la lista de los tipos de alarmas usando la lista desplegable que hay encima de la lista. Luego, pulse sobre uno de los botones que hay bajo la lista o pulse con el botón Derecho sobre el calendario apropiado de la lista y elija un elemento del menú contextual. Las acciones disponibles son:

Añadir…

  Añade a la lista un calendario del tipo seleccionado. Se le pide que elija un tipo de almacenamiento, luego se muestra el diálogo de configuración del calendario y sus características. Si no hay ningún recurso de alarma en la ubicación especificada, se crea uno nuevo.

Eliminar

  Elimina de la lista el calendario seleccionado. El propio calendario se deja intacto. Simplemente se elimina de la lista y se puede volver a disponer en la lista si se desea.

Editar…

  Edita el calendario seleccionado. Muestra el diálogo de configuración para el calendario seleccionado.

Volver a cargar

  Vuelve a cargar el calendario seleccionado. El calendario se vuelve a leer de la ubicación en la que está almacenado, asegurándose de que no hay discrepancia entre las alarmas que muestra &kalarm; y el estado actual del calendario. Si el calendario se comparte con otros usuarios, los últimos cambios que se hayan realizado pueden no estar a la vista en &kalarm;.

  Si vuelve a cargar un calendario remoto, se pierden los cambios que haya hecho a las alarmas desde la última vez que guardó el calendario. Se vuelven a producir las alarmas que hayan caducado desde la última vez que se guardaron.

Importar…

  Importa las alarmas de archivos de calendario externos en el calendario seleccionado. Se describe en Importar alarmas de calendarios externos. Esta opción no está disponible para los recursos desactivados o de solo lectura.

Exportar…

  Exporta las alarmas del calendario seleccionado en un archivo de calendario externo. Se describe en Exportar alarmas a calendarios externos. Esta opción no está disponible para los calendarios desactivados.

Mostrar detalles

  Muestra los detalles del calendario seleccionado. Muestra la ubicación del calendario, el tipo de almacenamiento y la información del estado.

Usar como predeterminado

  Hace que el calendario seleccionado sea el calendario predeterminado para el tipo de calendario seleccionado. Esta opción no está disponible ni en los calendarios desactivados o los de solo lectura.

Establecer el color…

  Selecciona un color de fondo para destacar estas alarmas de calendario en la lista de alarmas. Esto le permite ver de un vistazo las alarmas que pertenecen a un calendario en concreto.

Borrar el color

  Limpiar el resaltado de color para esta alarma en la lista de alarmas. La opción solo aparece después de que Establecer color se haya usado en este calendario.

#### Importar alarmas de calendarios externos

Puede importar alarmas de otros archivos de calendario en &kalarm;. La función de importación explora los archivos de calendario seleccionados buscando eventos que contengan alarmas y copiarlos (con los id. únicos nuevos) en el calendario de &kalarm;. Los eventos sin alarmas y otros tipos de entradas de calendario se ignoran. Hay dos modos de importar alarmas:

- Use Archivo Importar alarmas… para importar las alarmas de todos los tipos (alarmas activas, alarmas archivadas y plantillas de alarmas) de los archivos de calendario.

  Si ha configurado alarmas de calendario, las alarmas de cada tipo se añadirán al calendario predeterminado adecuado, o si ha elegido la opción para qué se le pida esta información para las alarmas y para las plantillas nuevas en el Diálogo configuración se le preguntará qué calendario usar.

- Pulse con el botón Derecho sobre un calendario en la lista de calendarios y elija Importar… desde el menú de contexto. Esto importa alarmas del tipo seleccionado actualmente en ese calendario. Por ejemplo, si el tipo de calendario seleccionado es de plantillas de alarmas, se importarán plantillas de alarmas (y no alarmas activas o archivadas).

Si importa alarmas de archivos de calendario creados con una aplicación distinta de &kalarm;, las alarmas las cambia el proceso de importación, incluso las horas de los eventos pueden cambiar. Depende de las convenciones de almacenamiento de datos que utilicen las otras aplicaciones y no se pueden evitar si estas convenciones son diferentes a las que espera &kalarm;. Compruebe siempre si hay cambios no esperados en las alarmas importadas y ajústelas si fuese necesario.

#### Exportar alarmas a calendarios externos

Puede exportar alarmas de &kalarm; a otros archivos de calendarios, bien las alarmas seleccionadas actualmente en la lista de alarmas, o todas las alarmas de un calendario de alarmas. Los métodos para hacerlo se muestran más abajo. Cualquiera que sea el método que se utilice, puede bien crear un nuevo archivo de calendario o añadir las alarmas exportadas a uno existente. Para añadir las alarmas, marque Añadir a archivo existente en el diálogo de selección de archivos: de otro modo, se sobrescribe cualquier archivo que ya exista.

- Para exportar las alarmas seleccionadas actualmente en la lista de alarmas, pulse el botón Derecho sobre la selección y elija Exportar… del menú de contexto, o utilice Archivo Exportar las alarmas seleccionadas… en el menú principal.

- Para exportar las alarmas desde un calendario pulse con el botón, Derecho sobre un calendario en la lista de calendarios y elija Exportar… del menú de contexto.

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

Esta función solo está disponible si está instalado y activado el complemento Akonadi de &kalarm;.

Puede configurar alarmas para cumpleaños guardados en &kaddressbook;, usando Archivo Importar cumpleaños…. Esto muestra un 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 cualquier espacio final necesario 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 solo las entradas de &kaddressbook; que contengan un cumpleaños y que no contengan ya una alarma de cumpleaños en el formato definido actualmente en el grupo de opciones Texto de alarma.

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

Si ha configurado calendarios de alarma, las alarmas de cada tipo se añadirán al calendario predeterminado adecuado, o se le pedirá el recurso específico si ha elegido la opción para que se le pida esta información para las alarmas y para las plantillas nuevas en el Diálogo configuración.

#### Deshacer / rehacer

Puede deshacer y rehacer los cambios más recientes que haya hecho durante la sesión actual de &kalarm;. La mayor parte de las acciones se pueden deshacer, incluyendo la creación, edición y borrado de alarmas y de plantillas de alarmas y la reactivación de alarmas. Para evitar que se usen demasiados recursos en el histórico de deshacer, el número de cambios que se almacenan está limitado a los últimos 12.

Para deshacer el último cambio, seleccione Editar Deshacer. Para rehacer el último cambio que se ha deshecho, seleccione Editar Rehacer .

Para deshacer un cambio que no sea el último, pulse en el botón Deshacer de la barra de herramientas y mantenga pulsado el botón del ratón. Se muestra una lista de acciones en la que puede elegir el que quiera deshacer. Si no ve la acción que está buscando, recuerde que puede tener que deshacer antes cambios más recientes, de los que depende el cambio deseado. Por ejemplo, si edita una alarma y la elimina, no puede deshacer la edición hasta que no deshaga el borrado.

Puede rehacer un cambio distinto del último de modo similar, usando el botón Rehacer de la barra de herramientas.

### El diálogo de edición de alarma

El diálogo de edición de alarmas le permite ver y editar una alarma. Cuando utilice &kalarm; por primera vez, se muestra una forma simplificada del diálogo, con solo un pequeño número de opciones visible. Para ver todas las opciones, pulse el botón Más opciones, para revertir al diálogo simplificado pulse el botón Menos opciones. &kalarm; siempre recuerda su última elección cada vez que se vuelve a mostrar el diálogo de edición de alarmas.

Puede configurar los valores predeterminados de muchas de las preferencias en el diálogo de edición de alarmas utilizando la pestaña editar del diálogo de configuración.

Captura de pantalla del diálogo simplificado de edición de alarmas
Diálogo de edición simplificado para alarmas de visualización

Diálogo de edición simplificado para alarmas de visualización

Captura de pantalla del diálogo de edición de alarmas mostrando todas las opciones
Diálogo para una alarma de visualización mostrando todas las opciones

Diálogo de edición de alarmas para una alarma de visualización mostrando todas las opciones

#### Nombre de la alarma

Puede asignar un nombre a la alarma en el campo Nombre de la alarma. Esta es una forma práctica de identificar la alarma con mayor facilidad. No es obligatorio que introduzca un nombre y tampoco es necesario que sea único.

Tenga en cuenta que este campo solo se muestra si está activado el uso de nombres de alarmas en la pestaña General del diálogo de configuración.

#### Acción de la alarma

Los controles en el cuadro Acción, varían en función del tipo de alarma que se esté editando.

##### Mostrar alarmas

Mostrar alarmas muestra una ventana cuando la alarma se activa. Seleccione el método utilizado para generar el contenido de la ventana de alarma, usando la lista desplegable de la parte de arriba:

- Mensaje de texto para introducir el texto del mensaje de alarma (que puede incluir saltos de línea) en el cuadro de edición de texto.

- Contenido del archivo para introducir la ruta 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 diálogo de selección de archivo. La opción Hablar no está disponible para este tipo de alarma.

- Salida de la orden para especificar que el mensaje de texto de la alarma se generará por una orden que se ejecuta al activarse la alarma. Vea Alarmas de órdenes más bajo para los detalles sobre como introducir la orden o guion de órdenes a ejecutar.

Los controles disponibles para mostrar alarmas son:

- La opción Sonido le permite seleccionar si debe sonar una alarma audible cuando se muestra el mensaje de la alarma. Elija:

  - Ninguno para mostrar la alarma de forma silenciosa.

  - Pitido para que suene un «pitido».

  - Leer para que el mensaje de alarma se lea cuando se muestre en pantalla. Esta opción solo está disponible si &kalarm; se compiló con la función de voz activada y tiene instalado y en funcionamiento el módulo de voz de &Qt;.

  - Archivo de sonido para reproducir un archivo de audio. Use el botón de la derecha para mostrar el diálogo de archivo de sonido, que le permite seleccionar un archivo para que se reproduzca y definir el volumen y las opciones de repetición. Si pasa el ratón por encima del botón, un consejo emergente mostrará el archivo de audio que está seleccionado en ese momento.

    En el diálogo de archivo de sonido:

    - Indique la ruta del archivo de sonido, o use el botón que hay junto a la casilla de edición para mostrar un diálogo de selección de archivo. Puede escuchar el archivo seleccionado pulsando el botón reproducir a la izquierda del campo de edición. Ese botón entonces cambia su función para permitirle detener la reproducción cuando haya oído bastante.

    - Marque Repetir para repetir continuamente el archivo de audio mientras se esté mostrando la alarma. (La ventana del mensaje de alarma tiene un botón para detener la reproducción del sonido por si necesitara el silencio, pero quisiera mostrar la alarma).

    - Marque Volumen y ajuste el deslizador si quiere ajustar el volumen al que se reproduce el archivo de audio.

    - Si lo permite el motor de sonido que esté usando, puede atenuar el volumen. Es decir, que se comience a reproducir el archivo de sonido con un volumen y que se vaya cambiando gradualmente hasta el volumen final a lo largo de un intervalo de tiempo especificado. El volumen final es el que se introdujo en Volumen. Para activar la atenuación, marque Atenuar, introduzca el período en segundos en el campo Tiempo de atenuación y ajuste con el deslizador el Volumen inicial.

    Puede usar el botón Probar para comprobar los niveles del sonido seleccionado.

- Use el botón Tipo de letra y color… para seleccionar un tipo de letra y colores de primer plano y fondo para el mensaje de alarma. En el diálogo Seleccionar tipo de letra y color, marque Usar tipo de letra predeterminado para mostrar el mensaje con el tipo de letra configurado a la hora en la que se muestra el mensaje. Para elegir un tipo de letra específico para el mensaje, desmarque Usar tipo de letra predeterminado(El tipo de letra predeterminado y los colores se pueden configurar en el Diálogo preferencias).

  Los colores seleccionados se muestran en el campo de entrada de texto del mensaje de alarma.

- La opción Método de visualización le permite seleccionar cómo se visualiza la alarma. Puede elegir entre:

  - Ventana para mostrar la alarma en una ventana. Esta opción permite usar un amplio abanico de opciones para configurar la alarma.

  - Notificación para usar el sistema estándar de notificaciones para mostrar el mensaje de alarma. Debido a las limitaciones del sistema de notificaciones, no se pueden usar las siguientes opciones de configuración de alarmas en las notificaciones: definir del tipo de letra y de color; definir de un archivo de sonido para que se reproduzca cuando se muestra la alarma; confirmación del reconocimiento de la alarma; cierre automático del visor al expirar el tiempo de cancelación tardía.

  Consulte la sección Visualización del mensaje de la alarma para más detalle sobre cómo se muestran los mensajes de las alarmas.

- Use el botón Acciones especiales… para indicar qué órdenes de la shell se deben ejecutar antes o después de mostrar la alarma. En el diálogo Acciones especiales de alarma:

  - En el campo Acción previa a la alarma, introduzca una orden de la shell para que se ejecute antes de que se muestre la alarma. Tenga en cuenta que &kalarm; esperará hasta que se complete la orden antes de mostrar la alarma.

    Una acción de prealarma solo se ejecuta una vez cuando se muestra inicialmente el mensaje de alarma, incluyendo cuando un mensaje de recordatorio es remplazado por el mensaje de alarma actual. No se ejecuta en cualquiera de las siguientes circunstancias:

    - Cuando se muestra un mensaje de recordatorio.

    - Cuando se vuelve a mostrar el mensaje tras aplazar la alarma, salvo que Ejecutar para alarmas aplazadas esté marcado.

    - Cuando el mensaje se mostró cuando cerró la sesión y se restaura cuando vuelve a acceder.

    - Cuando se activa una alarma recurrente pero el mensaje de alarma (o un mensaje de alarma aplazado) de una ocurrencia anterior de la alarma aún está visible; en otras palabras, cuando la ocurrencia anterior de la alarma aún no ha sido reconocida.

    La acción de prealarma puede emplearse para controlar cuando mostrar el mensaje de alarma:

    - Marque Cancelar alarma en caso de error para cancelar la alarma si la orden de prealarma devuelve un código de error. Esto impedirá que se visualice el mensaje de alarma y que se ejecute cualquier acción postalarma.

    - Normalmente, si la orden de prealarma devuelve un error, se muestra un mensaje de error en las lista de alarmas. Estas notificaciones de error pueden evitarse marcando No notificar errores.

  - En el campo Acción postalarma, introduzca una orden de shell a ejecutar cuando se acepta la alarma (bien pulsando Cerrar o usando el botón cerrar en la barra de título de la ventana). No se ejecuta en cualquiera de las siguientes circunstancias:

    - Cuando se cierra un mensaje de recordatorio.

    - Cuando se aplaza la alarma, excepto cuando la alarma aplazada es finalmente reconocida.

    - Cuando se cierra un mensaje de alarma debido al cierre de sesión.

  Vea más abajo Alarmas de órdenes para más detalles sobre cómo se ejecutan las órdenes de shell.

##### Alarmas de órdenes

Las alarmas de orden ejecutan una orden sin mostrar ningún mensaje de alarma.

Este tipo de alarma no está disponible si &kde; se está ejecutando en modo kiosco.

Cuando se ejecuta la orden, la variable de entorno `KALARM_UID` contiene el UID del evento para la alarma. Tenga en cuenta que cuando la orden se ejecuta desde el botón Probar del diálogo de edición de alarmas,`KALARM_UID` estará en blanco si se trata de una nueva alarma o si la alarma se ha modificado en el diálogo, porque la alarma solo adquiere un UID cuanto está almacenada en el calendario de alarmas.

Los controles disponibles para alarmas de órdenes son:

- La casilla de verificación Introduzca un guion le permite elegir si se debe introducir una orden de la shell o un guion.

  Si esta opción no está marcada, puede introducir una orden de la shell para que se ejecute. La orden se pasa a través de la shell predeterminada (definida por la variable de entorno `SHELL`) y puede incluir cualquier opción, parámetros, órdenes con tuberías, &etc; que se pueda incluir en una sola línea de orden.

  Si esta opción está marcada, puede introducir el texto de un guion para que se ejecute. Recuerde incluir una primera línea del tipo `#!/bin/bash` para asegurar que se invoca el intérprete de órdenes adecuado.

- Si la orden devuelve un error, normalmente se muestra un mensaje y se añade una indicación de error en la lista de alarmas. El mensaje de notificación del error se puede evitar marcando la casilla No notificar errores.

- Use el grupo Salida de la orden para indicar lo que quiere que se haga con cualquier salida del terminal que produzca la orden cuando se ejecute.

  - Marque Ejecutar en una ventana del terminal para hacer que se ejecute la orden en la ventana del terminal. Puede elegir qué tipo de ventana del terminal se debe usar en el Diálogo de configuración.

  - Marque Registrar en archivo para guardar la salida de la orden en un archivo. La salida, que tendrá por prefijo una cabecera en la que se muestra la hora a la que se planificó la ejecución de la orden, se añadirá al contenido del archivo. Indique el nombre del archivo en la casilla de edición, o use el botón que hay junto a la casilla de edición para mostrar un diálogo de selección de archivos.

  - Marque Descartar para deshacerse de la salida de la orden.

##### Alarmas de correo

Las alarmas de correo envían un correo sin mostrar ningún mensaje de alarma.

Cumplimente las direcciones de los destinatarios, 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 de &kde;, desde la que puede seleccionar los destinatarios del correo. (Tenga en cuenta que este botón solo se muestra si el complemento de Akonadi está instalado y activado). Se pueden añadir 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 eliminar un adjunto, resáltelo en la lista desplegable y haga pulse sobre el botón Borrar.

Defina las siguientes opciones:

- La lista desplegable De le permite seleccionar qué identidad de &kmail; se debe usar como dirección de correo electrónico para enviar el correo. Esta opción solo aparece si en el campo De de la dirección de correo en el Diálogo configuración está marcado Usar las identidades de &kmail;. En caso contrario, su dirección de correo estará predeterminada en el Diálogo configuración, haciendo esta opción inaplicable.

- Marque Copia del correo a sí mismo para enviarse una copia oculta del correo cuando se lance la alarma. La dirección del correo que recibirá la copia se puede configurar en el Diálogo configuración, por omisión será su dirección de correo establecida en &kmail;.

##### Alarmas de audio

Las Alarma de audio reproducen un archivo de audio sin mostrar mensajes de alarma.

Defina las siguientes opciones:

- Introduzca la ruta del archivo de sonido, o utilice el botón junta a la caja de edición para mostrar un diálogo de selección de archivo.

- Compruebe Repetir para repetir continuamente al archivo de audio hasta que se seleccione la opción Parar reproducción. Para parar la reproducción del archivo seleccione la opción de menú Acciones Parar reproducción, o pulse con el botón Derecho en el icono de la bandeja del sistema y elija Detener reproducción del menú de contexto. Si lo desea, puede configurar un atajo de teclado global para esta acción.

- Marque Volumen y ajuste el deslizador si quiere ajustar el volumen al que se reproduce el archivo de audio.

- Si lo permite el motor de sonido que esté usando, puede atenuar el volumen. Es decir, que se comience a reproducir el archivo de sonido con un volumen y que se vaya cambiando gradualmente hasta el volumen final a lo largo de un intervalo de tiempo especificado. El volumen final es el que se introdujo en Volumen. Para activar la atenuación, marque Atenuar, introduzca el período en segundos en el campo Tiempo de atenuación y ajuste con el deslizador el Volumen inicial.

#### Aplazar

Si la alarma se repite y se aplazó la última vez que fue mostrada, el grupo de opciones Alarma aplazada muestra la hora a la que se aplazó la alarma. Cambiar… muestra un diálogo que le permite cambiar la hora de la alarma aplazada o cancelar el aplazamiento.

#### Hora

En el grupo de opciones Hora, seleccione una de

- En fecha/hora para introducir la fecha y hora en la que se debe producir la alarma. Marque A cualquier hora si quiere especificar solo 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 solo 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.

Si lo desea, elija una zona horaria a aplicar a la alarma. Esta zona horaria se utiliza para todas las fechas y horas relacionadas con esta alarma, incluyendo repetición y fechas y horas excepcionales. Normalmente, debería dejar los controles de zona horaria sin cambiar, salvo que tenga una buena razón para cambiarlos.

Los controles de zona horaria se muestran solo cuando la zona horaria seleccionada es distinta de la zona horaria predeterminada en Diálogo de configuración, o si pulsa sobre el botón Zona horaria….

- En la lista desplegable, elija la zona horaria que se usará para esta alarma. Cuando se cree una nueva alarma, esta es inicialmente ajustada a la zona horaria seleccionada en Diálogo de configuración, que será la zona horaria de su equipo, salvo que la haya cambiado.

- Seleccione Zona horaria del sistema si quiere utilizar la hora local de su equipo (en cualquier equipo en el que &kalarm; se encuentre ejecutando en ese momento).

#### Recordatorio

Para mostrar una alarma, marque Recordatorio si quiere mostrar un recordatorio bien antes o después de la alarma principal y de cada una de sus repeticiones (si las hubiera). Introduzca cuanto tiempo antes o después, usando los controles de edición junto a la casilla de verificación. Tenga en cuenta que si la alarma se repite, el periodo de recordatorio está limitado normalmente a ser menor que el intervalo de repetición o subrepetición.

Los recordatorios no se muestran para subrepeticiones dentro de una repetición. Los recordatorios solo se muestran para cada ocurrencia principal de la alarma.

Si la alarma se repite, marque Recordatorio solo para la primera repetición si solo quiere un recordatorio para la primera repetición de la alarma. Si está marcado y es un avance de recordatorio, el período del recordatorio no está sujeto al límite normal de ser menor que el intervalo de repetición o subrepetición.

#### Cancelación

Las opciones de cancelación tardía determinan cómo se trata la alarma después del tiempo planificado:

- La casilla de verificación Cancelar si es tarde determina qué ocurre si no se puede producir la alarma en su hora planificada.

  Marque esta casilla para cancelar la alarma si no se puede producir en el período de tiempo indicado después de la hora adecuada. El período se selecciona usando los controles que aparecen cuando marca esta casilla. Por ejemplo, si introduce un período de tiempo de 1 hora, la alarma se producirá en la primera oportunidad que haya una hora después del vencimiento, pero no se puede producir en la hora en la que se haya cancelado la activación.

  La tardanza en las alarmas de solo fecha, &ie; las que tienen seleccionada la opción Cualquier hora, se calcula desde la hora de comienzo del día de la fecha para la que se planificó la alarma.

  Deje sin marcar esta casilla para que la alarma se desencadene en la primera ocasión comenzando desde la hora planificada, sin importar cuánto tiempo ha transcurrido.

  Una alarma solo se puede lanzar mientras esté en sesión y tanto X como &kalarm; estén ejecutándose.

- Marque Cerrar la ventana automáticamente tras esta hora si quiere que la ventana de alarma se cierre automáticamente si aún se está mostrando cuando es la hora de cancelación tardía de la alarma.

#### Repetición

Especifique si o como debe repetirse la alarma usando la pestaña Repetición.

Las características básicas de repetición de la alarma se muestran para su comodidad en la pestaña repetición. El intervalo de la repetición se muestra, en primer lugar, seguido del intervalo de subrepetición, que se configura usando el botón Subrepetición.

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

- Para desencadenar la alarma solo una vez, elija Sin repetición.

- Seleccione Al iniciar sesión para desencadenar la alarma cuando inicie sesión hasta la hora de finalización planificada. Tras la hora de finalización planificada, la alarma se disparará una última vez. (Tenga en cuenta que una alarma que se repite al iniciar sesión también se desencadena cada vez que active las alarmas o reinicie &kalarm;).

- 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 dos semanas 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 desencadene 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 desencadene la alarma.

    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 seleccionando la opción apropiada enAlarma del 29 de febrero en años no bisiestos:

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

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

  Para indicar que una alarma diaria suceda únicamente 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 repetición de la siguiente forma:

- Seleccione Sin fin para seguir repitiendo indefinidamente.

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

- Seleccione Acabar en para especificar la fecha/hora hasta la que se debe repetir la alarma. Tenga en cuenta que esto utiliza la misma zona horaria que la hora de inicio de la alarma.

  La fecha/hora de finalización determina cuando será la última ocurrencia principal, pero no limita las subrepeticiones. Si están configuradas subrepeticiones, estas se activarán normalmente después de la última ocurrencia principal, independientemente de la fecha/hora de finalización.

El cuadro de grupo Excepciones le permite excluir ciertas fechas/horas de la repetición que ha configurado. Dese cuenta que esos controles no se muestran en el formulario simplificado del diálogo de edición de alarmas: para verlos, pulse sobre Más opciones.

- La lista de excepciones (&ie; las fechas y horas excluidas) 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 borrar una excepción, resáltela en la lista y pulse Eliminar.

- Puede restringir que una alarma no aparezca en vacaciones marcando Excluir vacaciones. Esto no cambia el modo en que se planifica la alarma; simplemente la suprime cuando se activa en vacaciones. Puede seleccionar su región o país de vacaciones en Diálogo de configuración.

- Puede restringir una alarma para que aparezca solo durante el horario de trabajo marcando Solo durante horas de trabajo. Esto no cambia el modo en que se planifica la alarma; simplemente suprime la alarma cuando se activa fuera del horario de trabajo. Los días y horas de trabajo se configuran en el Diálogo de configuración.

##### Subrepetición

Puede usar el botón Subrepetición para configurar una repetición dentro de una repetición. En este caso, cada vez a la que deba suceder la alarma como se especifica en la ocurrencia principal, en lugar de desencadenarse solo una vez, se activa repetidamente, según indicara en su especificación de la subrepetición. Por ejemplo, para configurar una alarma que se repite cada hora desde el mediodía hasta las 6 de la tarde en los jueves, debería configurar una repetición semanal, los jueves a las 12:00 y utilizar el diálogo de subrepetición para indicar un intervalo de 1 hora y, además, un contador de 6 o una duración de 6 horas.

En el diálogo de subrepetición que se muestra cuando pulsa el botón Subrepetición, marque Repetir cada para definir una repetición, o desmárquelo para eliminar la repetición. Si está marcada Repetir cada, configure la repetición de la forma siguiente:

- Indique los intervalos de tiempo que hay entre las repeticiones de los controles que hay junto a Repetir cada. Seleccione las unidades de tiempo que desee (⪚ días) y luego introduzca el número de unidades.

- Indique, o bien el número de repeticiones, o bien su duración:

  - Seleccione Número de veces para indicar cuántas veces se debe disparar la alarma después la aparición principal. Por ejemplo, para hacer que la alarma aparezca 4 veces para cada ocurrencia principal, &ie; 3 veces más, debería poner aquí un 3.

  - Seleccione Duración para indicar el período total de tiempo en el que se debe producir la alarma. Tiene que ser un múltiplo exacto del intervalo de repetición. Se redondeará automáticamente hacia abajo cuando pulse sobre Aceptar.

Para evitar la superposición de subrepeticiones para la misma alarma, la duración de una subrepetición esta restringida para ser menos que el intervalo más largo entre las ocurrencias principales. Cada vez que la alarma se repite tal como se especifica en la ocurrencia principal, cualquier subrepetición todavía activa iniciada por la ocurrencia previa se cancela automáticamente.

#### Otros controles

Si la configuración del sistema permite que varias alarmas activen el sistema desde una suspensión, puede seleccionar Despertar de suspensión para activar el sistema si se encuentra suspendido cuando se active la alarma. Esta función no está disponible para alarmas que solo tienen fecha porque su hora no está definida. Consulte Despertar de suspensión para obtener más información.

Para mostrar las alarmas, la casilla 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.

Seleccione Mostrar en &korganizer; para añadir la alarma al calendario activo de &korganizer;, donde aparecerá como un evento sin ninguna alarma. Esta opción le permite seguir la pista de las alarmas de &korganizer; cuando esté haciendo uso de las funciones de &kalarm;.

Si modifica o borra la alarma posteriormente en &kalarm;, el evento de &korganizer; se modificará o se borrará también. Pero si cambia el evento en &korganizer;, la alarma de &kalarm; no se verá afectada.

Pulse el botón Cargar plantilla para seleccionar una plantilla con la que programar el diálogo, como se describe en Crear y manipular alarmas.

Pulse el botón Probar para comprobar la alarma y verificar si funciona correctamente. La alarma se ejecutará como si se hubiera planificado de la forma habitual. En caso de alarma de audio, pulse el botón Intentar una segunda vez para parar la reproducción del archivo de sonido.

Pulse el botón Aceptar cuando todos los detalles sean correctos, para añadir la alarma a la lista de alarmas planificadas. Tenga en cuenta que cuando edite una alarma que exista, el botón Aceptar está desactivado si no ha habido cambios.

### Mostrar mensajes de alarma

Los mensajes de alarma se pueden mostrar en ventanas o como notificaciones, según la opción elegida en el diálogo Editar alarma. Estas dos opciones de visualización se describen a continuación.

Si inhibe las notificaciones para el escritorio, la ejecución de las alarmas visibles se suspenderá hasta que se vuelvan a activar las notificaciones. Tenga en cuenta que esto se aplica a todas las alarmas en pantalla, independientemente de si se muestran en ventanas o como notificaciones.

#### Ventana del mensaje de alarma

Los mensajes de alarma que se muestran en ventanas proporcionan la funcionalidad más completa.

Cuando una alarma vence, se muestra en todos los escritorios, si es posible, y no se puede cubrir con ventanas comunes para garantizar que la vea. (Tenga en cuenta que actualmente solo el sistema de ventanas X11 ofrece esta función). La ventana del mensaje muestra la hora a la que se programó la alarma, de modo que pueda ver cuándo se mostró si no estaba frente a su equipo en ese momento. Si la hora programada de la alarma está en una zona horaria diferente a la definida localmente en su equipo, también se mostrará su zona horaria. (Para los mensajes de recordatorio, la fecha y hora que se muestran son las de la alarma principal o las de su repetición, no las del mensaje de recordatorio, y el título de la ventana es «Recordatorio»).

Las ventanas del mensaje de alarma permanecen visibles hasta que se asienten, a no ser que se haya marcado Cerrar automáticamente tras la hora de cancelación tardía en el diálogo «Editar alarma». En el caso de una alarma que se repite, si permanece alguna ventana de mensaje no asentida de una repetición previa de la alarma, la ventana existente se muestra cuando se repita la alarma. Esto evita tener varias copias del mismo mensaje, cosa que pudiera no desear, o ser incapaz de asentir a un mensaje cuando aparezca.

La ventana del mensaje de alarma proporciona las siguientes opciones, que se pueden aplicar a las alarmas que se muestran:

- Asentir la alarma pulsando sobre el botón Cerrar. Esto cerrará la ventana (tras solicitar confirmación si seleccionó Confirmar asentimiento).

- Edite la alarma pulsando el botón Editar…. Esto muestra el Diálogo de edición de alarmas.

- Muestre las opciones para aplazar la alarma hasta más tarde pulsando el botón Aplazar…. A continuación, seleccione Aplazar durante para introducir el tiempo transcurrido desde el cual se debe volver a mostrar el mensaje (el botón Preajuste le permite seleccionar de una lista de intervalos de tiempo comunes), o seleccione Aplazar hasta para introducir la fecha y la hora en que se debe volver a mostrar el mensaje. A continuación, pulse Aceptar para aplazar el mensaje de alarma y cerrar su ventana.

  La hora a la que se aplace la alarma debe ser anterior a la próxima aparición o avance de recordatorio planificados. Por este motivo, el botón Aplazar… de la ventana de mensaje de alarma y el botón Aceptar del diálogo de aplazamiento se desactivan un minuto antes de que se produzca la próxima ocurrencia o avance de recordatorio.

  Tenga en cuenta que si un recordatorio se configura después de la alarma, puede aplazar la alarma pasada su hora de recordatorio. En este caso, el recordatorio se suprimirá.

  El botón Aplazar… no está disponible para alarmas que se muestran al iniciar sesión porque se ha seleccionado la opción Repetir al iniciar sesión.

- Detenga la reproducción del archivo de sonido de la alarma pulsando el botón que muestra el símbolo dejar de reproducir.

- Si el mensaje de alarma se creó arrastrando un mensaje de correo de &kmail;, puede acceder directamente a dicho mensaje en &kmail; haciendo clic en el botón que muestra el icono de &kmail;. Esto mostrará el mensaje de correo y seleccionará la carpeta que lo contiene en la lista de carpetas de &kmail;.

  Si se regeneran los índices de &kmail;, se pierde el enlace al correo en &kmail;.

- El botón que muestra el icono &kalarm; proporciona una forma correcta de activar la ventana principal de &kalarm;, con dicha alarma resaltada.

La forma de mostrar las ventanas de los mensajes de alarma depende del sistema de ventanas que se use.

- Sistema de ventanas X11

  Puede elegir en Diálogo de configuración cual de los dos modos diferentes deben usarse para mostrar ventanas con mensajes de alarma:

  - 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 ni marco, con lo que no puede moverla ni cambiarla de tamaño.

  Puede elegir en Diálogo de configuración cual de los dos esquemas deberían utilizarse para posicionar las ventanas de mensajes de alarma:

  - Las ventanas se visualizan tan lejos como sea posible de la posición actual del cursor del ratón. Esto minimiza la interrupción de su flujo de trabajo y minimiza la posibilidad de aceptar accidentalmente la alarma.

  - Las ventanas se visualizan en el centro de la pantalla. Para reducir el riesgo de aceptar la alarma accidentalmente, los botones de la ventana están desactivados inicialmente, activándose solo tras un retardo configurable.

  Si tiene varias ventanas de mensaje de alarma, o mensajes de error, puede expandir las ventanas sobre la pantalla para hacerlas visibles, o agruparlas todas juntas de nuevo en la esquina superior izquierda de la pantalla, por medio de la opción de menú Ver Expandir ventanas . Si lo desea, puede configurar un atajo de teclado para esta acción.

- Sistema de ventanas Wayland

  El sistema de ventanas Wayland no permite que las aplicaciones controlen la posición ni la decoración de sus ventanas, por lo que las opciones de visualización están mucho más limitadas.

  Para reducir el riesgo de aceptar la alarma accidentalmente, los botones de la ventana están desactivados inicialmente, activándose solo tras un retardo que se puede configurar.

#### Notificaciones de mensajes de alarma

Los mensajes de alarma que se muestran como notificaciones proporcionan menos funcionalidad que los que se muestran en ventanas.

Cuando se lanza un mensaje de alarma, se muestra como una notificación. Esta notificación muestra la hora a la que se programó. Si la hora de la alarma está en una zona horaria diferente a la configurada en su equipo, también se mostrará dicha zona. (Para los mensajes de recordatorio, la fecha y hora que se muestran son las de la alarma principal o las de su repetición, no la hora del mensaje, y se muestra el encabezado «Recordatorio»).

La notificación se cierra automáticamente tras un breve periodo de tiempo. (Tenga en cuenta que este periodo es común para todas las aplicaciones; se puede modificar en las &systemsettings;). Una vez transcurrido este periodo de tiempo, una notificación puede seguir viéndose en el historial de notificaciones hasta que se elimine o se cierre la sesión. Como las aplicaciones no pueden acceder al historial de notificaciones, &kalarm; no puede eliminar ni sustituir notificaciones en el historial como sí lo haría con las ventanas de alarma. Por lo tanto, el historial puede contener varias notificaciones para la misma alarma, incluyendo recordatorios y repeticiones.

La notificación de mensajes de alarma ofrece las siguientes opciones. Tenga en cuenta que al seleccionar cualquier opción, se cerrará inmediatamente la notificación y no se mostrará en el historial de notificaciones. Tenga en cuenta también que estas opciones solo están disponibles mientras la notificación está activa, antes de que se agote el tiempo de espera. Si posteriormente accede a la notificación en el historial de notificaciones, debido a las limitaciones del sistema de notificaciones, la única interacción disponible es eliminarla del historial.

- Reconocer la alarma pulsando el botón Cerrar. Esto cerrará la notificación.

- Edite la alarma pulsando el botón Editar. Esto muestra el Diálogo de edición de alarmas.

- Muestre las opciones para aplazar la alarma hasta más tarde pulsando el botón Aplazar. Este botón solo se muestra si se puede aplazar la alarma. Consulte la descripción de la opción de aplazamiento en la sección Ventana de mensajes de alarma para obtener más detalles.

- Si se pulsa sobre la notificación en cualquier lugar que no sea un botón, se activará la ventana principal de &kalarm;, con dicha alarma resaltada.

### Operación de la bandeja del sistema

&kalarm; muestra un icono en la bandeja del sistema de forma predeterminada. Este icono proporciona tanto control como indicación del estado de supervisión de las alarmas. Un icono normal de &kalarm; indica que se están supervisando todas las alarmas, mientras que dos iconos modificados indican que no se están supervisando algunas alarmas o ninguna de ellas. Las modificaciones de los iconos dependen del tema de iconos que se use.

El icono de la bandeja del sistema de &kalarm; se oculta automáticamente por omisión siempre que no hay alarmas que venzan en las próximas 24 horas. Puede cambiar el tiempo límite de autocultación o mostrar siempre el icono de la bandeja del sistema, usando el Diálogo de configuración. Para mostrar el icono cuando se ha ocultado automáticamente, pulse en la flecha de la bandeja del sistema para mostrar iconos ocultos.

Si pasa el cursor del ratón sobre el icono de la bandeja del sistema, se mostrará en forma de consejo emergente 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 Diálogo configuración.

Pulse con el botón Izquierdo sobre el icono de la bandeja del sistema para conmutar entre mostrar u ocultar la ventana principal de &kalarm;.

Pulse con el botón derecho sobre el icono de la bandeja del sistema para mostrar su menú de contexto:

Activar las alarmas

  Activa o desactiva la monitorización de las alarmas.

  Vea Activando y desactivando alarmas para más detalles.

Nueva alarma

  Después de que seleccione el tipo de alarma de la lista que aparece, abre el diálogo de edición de alarmas para crear una nueva alarma.

Detener reproducción

  Detiene la reproducción del archivo de audio reproducido en este momento.

Desplegar ventanas

  Hace brotar en la pantalla una ventana de alarma y mensaje de error, o los agrupa juntos de nuevo.

Configurar &kalarm;…

  Muestra el diálogo de configuración de &kalarm;.

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

Restaurar / Minimizar

  Restaura o minimiza la ventana principal de &kalarm;.

Salir

  Cierra el icono de la bandeja del sistema y las ventanas principales de &kalarm;.

  Cierra &kalarm; si no se muestra ninguna ventana de mensaje de alarma.

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

Debe estar ejecutando el escritorio &plasma; u otro gestor de ventanas adecuado para poder mostrar &kalarm; en la bandeja del sistema.

Seleccione Ver Mostrar en la bandeja del sistema para que &kalarm; se muestre en la bandeja del sistema de acuerdo con las preferencias establecidas en la pestaña Ver del diálogo de configuración.

Para quitar &kalarm; de la bandeja del sistema, deseleccione Ver Mostrar en la bandeja del sistema .

Para elegir si &kalarm; debe mostrarse o no al inicio en la bandeja del sistema, utilice la pestaña Ver en el diálogo de configuración.

### Refrescando alarmas

Si en el evento indeseado en el que una alarmas no se activó cuando debería haberlo hecho, puede refrescar la lista de alarmas y activar cualquier alarma perdida seleccionando Acciones Refrescar alarmas . Esto causa que &kalarm; vuelva a cargar todos los calendarios de alarma.

Puede volver a cargar un calendario individual y refrescar sus alarmas en la lista de alarmas pulsando con el botón Derecho sobre el calendario en la lista de calendarios y seleccionando la opción de menú Volver a cargar. Vea Calendarios de alarmas para más detalles.

### Activando y desactivando alarmas

Las alarmas se pueden activar y desactivar en conjunto o individualmente:

- La monitorización de alarmas se aplica a las alarmas en conjunto. Mientras se desactiva la monitorización de alarmas, no se desencadena ninguna alarma. Cuando la monitorización de alarmas está activada (la situación habitual), todas las alarmas que no estén desactivadas individualmente se dispararán a las horas adecuadas.

  Cuando se reactiva la monitorización de alarmas, las alarmas que se hayan disparado mientras estaba desactivada se disparan ahora (salvo que cualquier opción de cancelación posterior lo anule). En otras palabras, desactivar la monitorización de alarmas tiene el mismo efecto que detener &kalarm; las alarmas – se aplazan hasta que se reactiven.

- Las alarmas se pueden activar y desactivar individualmente, independientemente del estado de la monitorización de las alarmas. Así, el estado de activación y desactivación de las alarmas individuales permanece sin cambios aunque se desactive y reactive la monitorización de alarmas. A diferencia de la monitorización de alarmas que puede desactivarse potencialmente debido a que &kalarm; no se esté ejecutando, las alarmas individuales soló pueden desactivarse si utiliza órdenes de menú para hacerlo.

  Cuando una alarma se reactiva individualmente, no se dispara si se produjo cuando estaba desactivada. En otras palabras, desactivar una alarma individual cancela todas sus apariciones hasta que se reactiva.

  El estado activado/desactivado de una alarma individual se indica según el color de la lista de alarmas (el color se puede configurar en la pestaña Ver del diálogo de configuración).

Para que se desencadene una alarma, tiene que estar activada individualmente y también tiene que estar activa la monitorización de alarmas.

#### Activando la monitorización de alarmas

Para que suceda la monitorización de una alarma, se debe estar ejecutando &kalarm;. Una vez que ejecute &kalarm; este se iniciará automáticamente cada vez que inicie sesión, salvo que lo desactive más tarde en la pestaña General del diálogo de configuración.

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

- Seleccione Acciones Activar alarmas.

- Pulse con el botón derecho sobre el icono de la bandeja del sistema y elija Activar alarmas del menú de contexto.

#### Desactivando la monitorización de alarmas

Puede desactivar temporalmente 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 &kalarm; se configure para que comience al iniciar sesión – hasta la próxima vez que inicie sesión.

- Deseleccione Acciones Activar alarmas.

- Pulse con el botón Derecho en el icono de la bandeja del sistema y desmarque Activar alarmas desde el menú de contexto.

- Ejecute &kalarm; con la opción de línea de órdenes `--disable-all`.

- Detener &kalarm; como se describe en Saliendo de &kalarm;.

Las alarmas pueden desactivarse permanentemente evitando que &kalarm; se arranque en el inicio de sesión usando la pestaña General del diálogo de configuración.

#### Activando y desactivando las alarmas individuales

Para activar las alarmas individuales que están desactivadas en ese momento, haga una de las siguientes acciones:

- Seleccione una o más alarmas pulsando sobre sus entradas en la lista de alarmas. Luego elija Acciones Activar .

- Pulse con el botón derecho sobre las entradas que desee en la lista de alarmas y elija Activar en el menú de contexto.

Para desactivar las alarmas individuales que estén activadas en ese momento, haga una de las siguientes acciones:

- Seleccione una o más alarmas pulsando sobre sus entradas en la lista de alarmas. Luego elija Acciones Desactivar .

- Pulse con el botón derecho sobre las entradas que desee en la lista de alarmas y elija Desactivar en el menú de contexto.

### Despertar de suspendido

Puede configurar alarmas para despertar el equipo de la hibernación o de la suspensión cuando se activen, de modo que la acción de la alarma se pueda llevar a cabo incluso con el sistema apagado. El mecanismo que usa &kalarm; para reactivar el sistema, y la interfaz de usuario para controlarlo, depende del tipo de sistema y de los permisos del usuario. Existen dos posibilidades:

#### Despertar de suspensión del temporizador del kernel de Linux

En los sistemas Linux, si el usuario dispone de la capacidad de temporizador de alarmas del kernel (`cap_wake_alarm`), puede definir cualquier número de alarmas para salir del modo de suspensión. En este caso, se puede configurar la reactivación del equipo para cada alarma individual en el diálogo de edición de la alarma usando la opción Despertar de suspensión.

En el diálogo de configuración puede configurar el tiempo que debe transcurrir antes de que la alarma se active para salir de la suspensión, con el objeto de garantizar que el sistema tenga tiempo de restaurarse completamente antes de que se active la alarma.

#### Despertar de suspensión del reloj de tiempo real

En los sistemas que no sean Linux, o en los sistemas Linux en los que el usuario no disponga de la capacidad `cap_wake_alarm`, se usa la alarma del reloj de tiempo ral (RTC), que solo se puede configurar para una alarma a la vez. En este caso se usa un diálogo especial para salir del modo de suspensión, que permite definir, cancelar o mostrar la reactivación del equipo. Para acceder al este diálogo, seleccione la opción del menú Acciones Despertar del modo de suspensión.

El uso la función despertar desde suspendido necesita de privilegios administrativos. Se le pedirá la contraseña de root cuando establezca o suspenda una alarma de despertar desde suspendido.

Esperar desde suspendido no está implementado en algunos equipos, especialmente los más viejos, y algunos solo admiten establecer una alarma de despertar en las próximas 24 horas. Puede haber también restricciones sobre en que modo de suspensión la función despertará el equipo. Debería considerar configurar alarmas de prueba para comprobar las capacidades de su sistema antes de confiar en esta característica.

Su equipo solo puede programar una sola alarma de despertar desde suspendido a la vez. Si usa esta función con &kalarm;, debe asegurarse que no entra en conflicto con ninguna otra aplicación que también use despertar desde suspendido. Siempre que una aplicación planifica o borra despertar desde suspendido, esto cancela cualquier despertar desde suspendido establecido previamente, sin importar si se estableció por &kalarm; o por cualquier otra aplicación.

El diálogo de despertar desde suspendido se usa junto con la lista de alarmas en la ventana principal de &kalarm;.

- Usar alarma resaltada: establece la alarma actualmente resaltada en la lista de alarmas como alarma de despertar desde suspendido. Cualquier alarma programada de despertar desde suspendido se cancela, como se explicó con anterioridad. El botón se activa solo si está resaltada exactamente una alarma.

- Cancelar despertar desde suspendido: esto cancela cualquier alarma de despertar desde suspendido que exista (bien establecida por &kalarm; o por cualquier otra aplicación - consulte más arriba). Tenga en cuenta que esto solo cancela la función de despertar asociada con la alarma; la propia alarma no se borra y continuará funcionando normalmente.

- Mostrar alarma actual: esto resalta la actual alarma de despertar desde suspendido en la lista de alarmas, de modo que se pueda identificar. El botón está desactivado si no está configurada ninguna alarma de despertar desde suspendido.

- El control Número de minutos antes de la alarma de despertar desde suspendido le permite, si lo desea, asegurarse que el sistema dispone de tiempo para restaurarse completamente antes de que la alarma se active, de modo que la alarma pueda activarse a la hora correcta.

### Saliendo de &kalarm;

Salir de &kalarm; seleccionando Archivo Salir, o Salir en el menú de contexto del icono de la bandeja del sistema. Alternativamente, si el icono de la bandeja del sistema no está visible, ciñere la ventana de &kalarm;.

## Configurando &kalarm;

Para configurar el funcionamiento de &kalarm; para que se ajuste a su sistema y preferencias personales, seleccione Preferencias Configurar &kalarm;…. Esto muestra el diálogo de configuración.

### General

La sección General le permite controlar el comportamiento en general de &kalarm;:

- Modo de ejecución: Esto le permite seleccionar si &kalarm; debe ejecutarse automáticamente, de forma manual o no ejecutarse.

  - Ejecutar automáticamente: Seleccione esta opción para ejecutar &kalarm; de forma automática durante el inicio de la sesión para asegurarse de que siempre se ejecute. Debe seleccionar esta opción para que &kalarm; funcione de forma normal y muestre alarmas.

  - Ejecutar solo manualmente: Selecciones esta opción si solo necesita ejecutar &kalarm; de forma ocasional. No se arrancará de forma automática y tendrá que ejecutarlo a mano cuando sea necesario. Cuando salga del programa (o cuando cierre la sesión), dejará de funcionar y no se mostrará ninguna alarma hasta que vuelva a ejecutarlo.

  - No ejecutar: Seleccione esta opción si quiere dejar de usar &kalarm;. No se volverá a arrancar durante el inicio de sesión y, cuando salga de la aplicación o cierre la sesión, se dejarán de mostrar alarmas.

    Tenga presente que si vuelve a ejecutar &kalarm; posteriormente tras haber seleccionado esta opción, &kalarm; continuará funcionando de forma normal y se arrancará automáticamente durante el inicio de sesión. Si sigue queriendo dejar de usar &kalarm; tras esto, tendrá que volver a seleccionar la opción No ejecutar una vez más.

- Avisar antes de salir: &kalarm; debe estar ejecutándose para que se activen las alarmas. Seleccione esta opción para que, si intenta cerrar &kalarm; con la opción Salir, se le advierta de que las alarmas se desactivarán y se le solicite confirmación. Esto evita la desactivación accidental de las alarmas. Por seguridad, esta opción se reactiva automáticamente de forma predeterminada al cambiar el modo de ejecución.

- Activar nombres de alarma: Indicar si se puede asignar un nombre a cada alarma para facilitar su identificación. Esto determina si la columna Nombre se muestra en la lista de alarmas y si el campo Nombre de alarma aparecerá en el Diálogo de edición de alarmas.

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

- Intervalo de aplazamiento predeterminado: Introduzca el intervalo de tiempo predeterminado, en horas y minutos para mostrar inicialmente cuando se visualiza el diálogo de alarma aplazada. Tenga en cuenta que si se ha aplazado previamente una alarma, el intervalo que se muestra inicialmente en el diálogo de alarma aplazada será igual al intervalo de aplazamiento usado la última vez que se aplazó la alarma.

- Terminal para alarmas de órdenes: Aquí puede seleccionar qué tipo de ventana del terminal de debe usar para las alarmas de órdenes se ejecuten en una ventana del terminal. Algunas de las aplicaciones de terminal más utilizadas ya están preconfiguradas, ⪚ xterm, &konsole;, aunque solo se mostrarán las que estén instaladas en su sistema. Puede ver las opciones reales de la orden que se usa para cada aplicación si muestra la ayuda contextual para este botón de radio.

  Si quiere usar otra aplicación o quiere usar una de las que se listan, pero con unas opciones diferentes para la orden, puede seleccionar Otro e indicar la orden que tiene que invocar la ventana del terminal. De forma predeterminada, la cadena con la orden para lanzar la alarma se debe añadir a lo que indique. También puede querer especificar dónde se debe insertar la cadena de la orden de la alarma, usando los siguientes códigos:

  %c

    La cadena con la orden de la alarma que se debe sustituir.

  %w

    La cadena de la orden de la alarma que se debe sustituir a la que se le añade `sleep`.

  %C

    Un archivo de órdenes temporal, que contiene la cadena de la orden de alarma que se creará y la orden que se debe ejecutar el archivo que se sustituirá.

  %W

    Un archivo de órdenes temporal, que contiene la cadena con la orden de la alarma y que se creará con `sleep` añadido y la línea de órdenes que se ejecutará con el archivo que se va a sustituir.

  %t

    El nombre de &kalarm; en el idioma actual será sustituido.

  Cuando se produzca la alarma de órdenes, la cadena con la orden se pondrá entrecomillada antes de que se inserte en la línea de órdenes de la ventana del terminal.

- Complementos: esta sección le permite elegir los complementos instalados de &kalarm; que se van a usar.

  - Motor de sonido: Seleccione el sistema de sonido que se usará para reproducir archivos de sonido. Solo se muestran los complementos de sonido instalados; si no hay ninguno, esta opción no se muestra.

  - Activar Akonadi: Seleccione si desea usar &akonadi; para proporcionar funciones que dependen de él. Consulte Complemento de Akonadi para obtener más información. Tenga en cuenta que esta opción solo se muestra si el complemento de Akonadi está instalado.

### Fecha & hora

La sección Fecha & hora le permite elegir opciones relacionadas con la fecha y hora:

- Zona horaria: Seleccione su zona horaria. &kalarm; utiliza esta zona horaria siempre, excepto cuando la remplace para alarmas individuales.

- Región de vacaciones: Elija que país o región de vacaciones utilizar. Esto afecta a las alarmas de repetición para las que esté activa la opción de excluir vacaciones.

- Salir de la suspensión antes de la alarma: Introduzca el número de minutos anteriores a la hora de activación de la alarma para reactivar el sistema, en el caso de las alarmas configuradas para activarse desde suspensión. Esto le permite garantizar que el sistema tenga tiempo de restaurarse completamente antes de que se active la alarma, de modo que esta se active en el momento correcto. Esta opción solo se muestra si la configuración del sistema permite que múltiples alarmas activen el sistema desde la suspensión. Consulte Salir de la suspensión para obtener más información.

- Comienzo del día para las alarmas de solo fecha: Fija la hora de comienzo del día para disparar alarmas de solo fecha, &ie; aquellas 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.

- Cuadro de grupo Horario de trabajo: Estas opciones le permiten definir su horario de trabajo, lo que es necesario cuando se selecciona la opción Solo en horas de trabajo para una repetición en el diálogo Diálogo de edición de alarmas.

  - Comprobar cada día que sea un día de trabajo.

  - Hora de entrada diaria: introduzca la hora a la que comienza a trabajar cada día.

  - Hora de salida diaria: introduzca la hora a la que termina de trabajar cada día.

- Duración del evento de KOrganizer: Introduzca la duración del evento a establecer en &korganizer; para alarmas que se copian a &korganizer;. La duración predeterminada es cero.

### Almacenamiento

La sección Almacenamiento le permite elegir opciones para guardar y archivar alarmas:

- Nuevas alarmas & plantillas: Especifique en que calendario almacenar las nuevas alarmas y plantillas cuando se usen múltiples calendarios de alarmas:

  - Guardar en calendario predeterminado: las nuevas alarmas y plantillas de alarmas se añaden automáticamente al calendario de alarmas predeterminado sin pedir confirmación.

  - Preguntar en qué calendario almacenarlas: Cuando cree una nueva alarma o plantilla de alarma y hay más de un calendario de alarmas escribible, se le pedirá elegir en que calendario guardarlas. Tenga en cuenta que cuando las alarmas se guardan al expirar, siempre se guardan en el calendario predeterminado de alarmas archivadas sin preguntar.

- Cuadro de grupoAlarmas archivadas: Estas opciones controlan el almacenamiento de las alarmas archivadas en el calendario predeterminado de alarmas archivadas.

  - Mantener las alarmas tras expirar: Marque esta opción para archivar las alarmas expiradas y borradas. Quite la marca para no guardar el registro de las alarmas que dejan de estar activas. Tenga en cuenta que las alarmas eliminadas solo se archivan si se han activado previamente. Si elimina una alarma antes de que se active, esta se descarta.

  - Descartar las alarmas archivadas tras: Define el número de días para almacenar las alarmas expiradas y borradas en el archivo comprimido, después de lo cual se borran permanentemente.

  - Borrar las alarmas archivadas: este botón descarta todas las alarmas archivadas del calendario de alarmas archivadas predeterminado. (Otros calendarios de alarmas archivadas se mantienen sin cambios en caso de que se compartan con más gente). Esto no tiene efecto sobre las alarmas que expiren o sean borradas con posterioridad; seguirán estando archivadas según las opciones seleccionadas.

### Correo

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

Las funciones que dependen de &kmail; solo están disponibles si está instalado y activado el complemento Akonadi de &kalarm;.

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

  - KMail: Cuando se produce una alarma de correo, el mensaje se envía automáticamente usando &kmail;.

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

- Copiar los correos enviados a la carpeta de «correo-enviado» de &kmail;: Seleccione esta opción si, cada vez que se produce una alarma de correo electrónico, quiere que se almacene una copia del correo que se transmite en la carpeta de correo enviado `sent-items` de &kmail;.

  Esta opción no está disponible si &kmail; está seleccionado como cliente de correo electrónico, ya que es algo que &kmail; hace automáticamente.

- 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 o si el correo electrónico se pone en la cola de la carpeta de salida (`outbox`) de &kmail;, de forma que se tendrá que asegurar que hace lo necesario para transmitir realmente el correo.

- Seleccione la dirección de correo electrónico que se vaya a usar como remitente en las alarmas de correo electrónico:

  - Seleccione De para introducir una dirección de correo electrónico.

  - Seleccione Usar la identidad predeterminada de KMail para usar la dirección de correo predeterminada que tenga configurada en &kmail;.

  - Seleccione Usar las identidades de &kmail; para poder seleccionar durante la configuración una alarma de correo electrónico de las identidades de &kmail;. Se usará la identidad predeterminada de &kmail; para las alarmas que ya estuvieran configuradas entes de que seleccionara esta opción.

- Seleccione la dirección de correo electrónico que se deba usar para enviarse copias ocultas de las alarmas de correo electrónico cuando esté seleccionada la opción Copia del correo electrónico a sí mismo:

  - Seleccione Cco para indicar una dirección de correo electrónico. Si se van a enviar copias ocultas a la cuenta del equipo en el que se ejecuta &kalarm;, simplemente tiene que indicar aquí el nombre de usuario.

  - Seleccione Usar la identidad predeterminada de KMail para usar la dirección de correo predeterminada que tenga configurada en &kmail;.

### Ver

La sección Ver le permite controlar algunos aspectos de la apariencia de &kalarm;. En la pestaña General:

- Mostrar en la bandeja del sistema: Cuando está seleccionado, se muestra el icono en la bandeja del sistema cuando &kalarm; está en ejecución, de acuerdo con la opción seleccionada:

  - Mostrar siempre: El icono de la bandeja del sistema se muestra siempre.

  - Ocultar automáticamente si no hay alarmas activas: El icono de la bandeja del sistema se oculta si no hay alarmas activas.

  - Ocultar automáticamente si no hay alarmas activas en el periodo: El icono de la bandeja del sistema se oculta si no hay alarmas que venzan dentro del periodo introducido, comenzando desde ahora.

  Cuando el icono de la bandeja del sistema se oculta automáticamente, puede hacerlo visible por medio de la opción de la bandeja del sistema que muestra los iconos ocultos.

  Cuando Mostrar en la bandeja del sistema está seleccionado, al 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.

- Cuadro de grupo Consejo emergente de la bandeja del sistema: Estas opciones controlan qué información se muestra en el consejo que aparece cuando se pasa el cursor del ratón 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 que vencen 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.

- El cuadro de grupo Lista de alarmas le permite seleccionar los colores que se usan en la lista de alarmas de la ventana principal de &kalarm;, para mostrar alarmas desactivadas y archivadas.

La pestaña Ventanas de alarma contiene opciones para controlar el aspecto de las ventanas de mensajes de alarma. Las opciones disponibles dependen del sistema de ventanas que se use.

- Sistema de ventanas X11

  - Colocar las ventanas alejadas del cursor: Seleccione esta opción para mostrar las ventanas de mensajes de alarma tan lejos como se pueda de la posición actual del ratón. Esto minimiza la posibilidad de aceptar accidentalmente una alarma pulsando accidentalmente en un botón justo cuando aparece la ventana.

  - Centrar ventanas, retardar la activación de los botones de la ventana: Seleccione esta opción para mostrar las ventanas de mensajes de alarma en el centro de la pantalla. Para reducir la posibilidad de aceptar accidentalmente la alarma, los botones están desactivados inicialmente. El retardo en segundos antes de que se activen se especifica en Retardo en la activación de los botones (segundos).

  - Las ventanas de mensaje tienen una barra de título y retienen el foco del teclado: Esta opción controla si las ventanas de los mensajes de alarma son modales o no, &ie; si capturan el foco del teclado cuando aparecen. Vea la sección Visor del mensaje de alarma para más detalles.

- Sistema de ventanas Wayland

  - Para reducir la posibilidad de aceptar accidentalmente la alarma, los botones están desactivados inicialmente. El retardo en segundos antes de que se activen se especifica en Retardo en la activación de los botones (segundos).

### Editar

La sección Editar le permite elegir los valores predeterminados para las opciones del Diálogo de edición de alarma:

- La pestaña General contiene opciones que se aplican a todos los tipos de alarmas.

  - Definir el método predeterminado para mostrar mensajes de alarma.

  - Define los estados predeterminados para las casillas de verificaciónMostrar en KOrganizer y Cancelar si tarde.

  - Fijar el tipo de repetición predeterminado.

  - Selecciona el tratamiento predeterminado para repetición en años no bisiestos para repeticiones planificadas para el 29 de febrero.

- La pestaña Tipos de alarma contiene las opciones aplicables a tipos específicos de alarma.

  - Para mostrar alarmas:

    - Define el estado predeterminado de las casillas de verificación Cerrar automáticamente la ventana tras esta hora y Confirmar asentimiento.

    - Fijar las unidades predeterminadas del periodo.

    - Establecer las opciones especiales predeterminadas de visualización de la alarma.

    - Define las opciones de sonido predeterminadas. Tenga en cuenta que se debe indicar un archivo de sonido predeterminado aunque el tipo de sonido no sea Archivo de sonido.

  - Para alarmas de órdenes:

    - Define los estados predeterminados para las casillas de verificación Introducir un guion y Ejecutar en una ventana del terminal.

  - Para alarmas de correo electrónico:

    - Defina el estado predeterminado de la casilla de verificación Copia del correo electrónico a sí mismo.

- La sección Tipo de letra & color le permite elegir la apariencia predeterminada de los mensajes de alarma. Seleccione el tipo de letra predeterminado y los colores de primer plano y fondo.

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

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

- planificar una alarma nueva

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

- obtener ayuda

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

La línea de órdenes solo 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 la ruta 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.
`--auto-close` | Cierra automáticamente la ventana de alarma después del período de `--late-cancel`. Con esta opción se tiene que indicar `--late-cancel`.
`-b`, `--beep` | Hace un pitido audible cuando se muestra el mensaje. Ni `--speak` ni `--play` ni `--play-repeat` se pueden indicar con esta opción.
`--bcc` | Con copia oculta del correo a sí mismo. Con esta opción se debe especificar `--mail`.
`-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 primer plano del mensaje para el nombre del color de &Qt; especificado o el código hexadecimal 0xRRGGBB.
`-d`, `--disable` | Desactivar la alarma. No se producirá la alarma hasta que no se haya activado manualmente.
`--disable-all` | Desactivar la monitorización de alarmas. Esto evita que cualquier alarma se lance hasta que reactive las alarmas o reinicie &kalarm;, p. ej. en el próximo inicio de sesión. `--triggerEvent` no se puede especificar con esta opción.
`-e`, `--exec linea-de-órdenes` | Especifique una orden de shell para ejecutar. Si lo especificó, esta opción debe ser la última opción de &kalarm; en la línea de órdenes de &kalarm;. Todos los parámetros y opciones siguientes se interpretan como parte de la línea de órdenes a ejecutar `--file` y `--exec-display` y `--mail` se pueden especificar con esta opción.`--ack-confirm`, `--beep` y `--color` y `--colorfg` se ignoran con esta opción.
`-E`, `--exec-display línea de orden` | Especifique una orden de shell para ejecutar para generar el texto del mensaje de alarma. Si lo especificó, esta opción debe ser la última opción de &kalarm; en la línea de órdenes de &kalarm;. Todos los parámetros y opciones siguientes se interpretan como parte de la línea de órdenes a ejecutar. `--exec`, `--file` y `--mail` no se pueden especificar con esta opción.
`-f`, `--file URL` | Especifique la ruta o &URL; de un archivo de texto cuyo contenido va a formar el mensaje de alarma. `--exec`, `--exec-display` y `--mail` no pueden especificarse y mensaje no debe estar presente esta opción.
`-F`, `--from-id ID` | Usa la identidad de &kmail; especificada como remitente del correo electrónico. Junto con esta opción se debe indicar `--mail`.
`-i`, `--interval periodo` | Fije los intervalos entre las repeticiones de la alarma. Las horas y minutos se especifican 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). Si también se indica la opción `--recurrence`, no se permite ni Y (años) ni M (meses). Obligatorio si se indica `--repeat` o `--until`.
`-k`, `--korganizer` | Muestra la alarma como un evento en el calendario activo de &korganizer;.
`-l`, `--late-cancel periodo` | Cancela la alarma si no puede lanzarse dentro del periodo especificado después de la hora correcta. 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 formatonX, donde n es un número y X es una de las siguientes letras: W (semanas), D (días). El valor predeterminado de periodo es un minuto.
`-L`, `--login` | Activa la alarma cada vez que inicie sesión. Ni `--interval` ni `--repeat` ni `--until` se pueden especificar con esta opción.
`-m`, `--mail dirección` | Enviar un correo a las direcciones especificadas. Esta opción se puede repetir tantas veces como sea necesario. `--exec`, `--exec-display` y `--file` no pueden especificarse con esta opción, `--ack-confirm`, `--beep`, `--color` y `--colorfg` se ignoran con esta opción.
`-n`, `--name nombre` | Indicar un nombre para ayudarle a identificar la alarma.
`-N`, `--notify` | Mostrar la alarma como una notificación en lugar de en una ventana. Las opciones `--color`, `--colorfg`, `--play`, `--ack-confirm` y `--auto-close` son incompatibles con esta opción.
`-p`, `--play URL` | Especifique la ruta o &URL; de un archivo de audio para reproducirlo cuando se muestre el mensaje de alarma. Ni `--play-repeat` ni `--beep` ni `--speak` se pueden indicar con esta opción.
`-P`, `--play-repeat URL` | Indique la ruta o &URL; de un archivo de audio para que se reproduzca repetidamente, bien hasta que se utiliza Detener reproducción o mientras se muestre el mensaje de alarma. Ni `--play` ni `--beep` ni `--speak` se pueden indicar 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. No se puede especificar `--until` con esta opción.
`-r`, `--repeat contador` | Establece el número de veces que se debe producir la alarma o, si se ha indicado con `--recurrence`, el número de veces que se debe producir la alarma cada vez que la activa `--recurrence` (&ie; una repetición dentro de una repetición). Si no está presente `--recurrence`, indique -1 para repetir la alarma indefinidamente. Se debe especificar `--interval` y no se debe indicar `--until` con esta opción.
`-R`, `--reminder periodo` | Muestra un recordatorio de alarma la cantidad de tiempo dada antes o después de la alarma principal y cada una de sus repeticiones (si es que las hay). Elperiodo se especifica en el mismo formato descrito por la opción `--late-cancel`. Por omisión, el recordatorio se produce antes de la alarma. Para especificar un recordatorio después de la alarma, prefije periodo con +, p. ej. +3D. Esta opción no se puede especificar ni con `--exec` ni con `--mail` ni con `--reminder-once`.
`--reminder-once periodo` | Produce un recordatorio de alarma una vez, con el tiempo indicado antes o después de la primera repetición de la alarma. No se mostrará ningún otro recordatorio antes o después de las siguientes repeticiones (si las hubiera). El periodo se especifica en el mismo formato descrito por `--reminder`. Esta opción se puede indicar con `--exec`, `--mail` o `--reminder`.
`-s`, `--speak` | Leer el mensaje cuando se muestra. Esta opción requiere que &kalarm; se haya compilado con el uso de voz activado y que el módulo de voz de &Qt; esté instalado y en funcionamiento. No se pueden especificar `--beep`, `--play` ni `--play-repeat` con esta opción.
`-S`, `--subject asunto` | La línea del asunto del correo. Con esta opción se debe especificar `--mail`.
`-t`, `--time fecha/hora` | Disparar la alarma en la fecha o la fecha/hora especificada. Especifique una fecha sin una hora en formato yyyy-mm-dd[ TZ]; especifique una fecha y hora como [[[yyyy-]mm-]dd-]hh:mm[ TZ] (cuando se omiten, los campos de fecha son por omisión los valores de hoy). Si no se especifica zona horaria, se supone la hora local del sistema. Si está presente un especificador de zona horaria TZ, debe ser el nombre de una zona horaria del sistema (⪚ `Europe/London`), `UTC` representando la zona horaria UTC.
`-v`, `--volume porcentaje` | Define el volumen del audio para reproducir el archivo de sonido. Esta opción solo se puede usar si está especificada la opción `--play` o `--play-repeat`.
`-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`. Tenga en cuenta que si se especifica`--time`, la zona horaria se tomará de este valor y no se incluirá zona horaria en el valor de la opción `--until`. Debe especificarse `--interval` y no pueden especificarse `--repeat` y `--recurrence` 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`, `--exec`, `--exec-display`, `--play` o `--play-repeat`. 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 ejecutar varias funciones, incluyendo mostrar el Diálogo de edición de alarmas.

Opción | Descripción
--- | ---
`--edit id-Evento` | Abra el diálogo «Editar alarma» para modificar la alarma con el ID de evento especificado. El ID de evento es el ID único del evento, precedido opcionalmente por el nombre de la configuración o el ID numérico del recurso que lo contiene, en el formato [ID_de_recurso:]UID_de_evento.
`--edit-new-audio` | Muestra el diálogo de edición de alarma, para editar una alarma de audio nueva.
`--edit-new-command` | Muestra el diálogo de edición de alarma, para editar una alarma de orden nueva.
`--edit-new-display` | Muestra el diálogo de edición de alarma, para editar una alarma de visualización nueva.
`--edit-new-email` | Muestra el diálogo de edición de alarma, para editar una alarma de correo nueva.
`--edit-new-preset nombre-Plantilla` | Muestra el diálogo de edición de alarma, con las opciones predeterminadas de la plantilla de alarma con el nombre indicado, para editar una alarma nueva.
`--list` | Obtiene una lista de alarmas programadas a `stdout`. la lista muestra detalles concisos de cada alarma pendiente: su identificador de recurso, UID, siguiente periodo programado y texto del mensaje o archivo.
`--tray` | Muestra &kalarm; como un icono de la bandeja del sistema.
`--disable-all` | Desactivar monitorización de todas las alarmas.

Consulte también:

- kf6options(7)
- qt6options(7)

## Guía del desarrollador de &kalarm;

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

- planificar una alarma nueva

- cancela una alarma ya planificada

- desencadena una alarma ya planificada

- muestra el diálogo de edición de alarma

- listar alarmas programadas

Cada una de las funciones anteriores se implementa tanto como llamadas &DBus; como con la línea de órdenes. Las llamadas a &DBus; se deberían usar preferentemente si &kalarm; ya se está ejecutando.

### Interfaz &DBus;

Las llamadas a &DBus; descritas en este documento están todas implementadas en la ruta del objeto &DBus; de &kalarm; `/kalarm`. La interfaz está definida en los archivos `org.kde.kalarm.kalarm.xml` y `kalarmiface.h`.

cancelEvent
cancelEvent cancela una alarma ya planificada.

    void cancelEvent(const QString& id-Evento)

###### Parámetros

eventID

  Especifica el ID único del evento que se va a cancelar, opcionalmente precedido por el nombre de configuración o el ID numérico del recurso que contiene el evento, en el formato [ID_de_recurso:]UID_de_evento.

##### Descripción

`cancelEvent()` es una llamada &DBus; para cancelar la alarma especificada. &kalarm; borra la alarma del archivo de calendario sin mostrarla ni ejecutarla.

triggerEvent
triggerEvent activa una alarma ya planificada.

    void triggerEvent(const QString& id-Evento)

###### Parámetros

eventID

  Especifica el ID único del evento que se activará, opcionalmente precedido por el nombre de configuración o el ID numérico del recurso que contiene el evento, en el formato [ID_de_recurso:]UID_de_evento.

##### Descripción

`triggerEvent()` es una llamada &DBus; 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 calendario y luego la muestra o ejecuta.

Si la alarma se ha cumplido, &kalarm; borra todas las apariciones planificadas de la alarma hasta la hora actual y si no hay repeticiones de la alarma pendientes, la alarma se borra del calendario. Si la alarma aún no ha cumplido, sus apariciones planificadas se dejarán sin cambios.

scheduleMessage
scheduleMessage planifica un nuevo mensaje de alarma.

    bool scheduleMessage(const QString& nombre,
                         const QString& mensaje,
                         const QString& fechaHoraDeInicio,
                         int cancelaciónPosterior,
                         unsigned indicadores,
                         const QString& colorDelFondo,
                         const QString& colorDelTexto,
                         const QString& tipoDeLetra,
                         const QString& urlDeSonido,
                         int minsRestantes,
                         const QString& repetición,
                         int intervaloDeSubRepetición,
                         int contadorDeSubRepeticiones)

    bool scheduleMessage(const QString& nombre,
                         const QString& mensaje,
                         const QString& fechaHoraDeInicio,
                         int cancelaciónPosterior,
                         unsigned indicadores,
                         const QString& colorDelFondo,
                         const QString& colorDelTexto,
                         const QString& tipoDeLetra,
                         const QString& urlDeSonido,
                         int minsRestantes,
                         int tipoDeRepetición,
                         int intervaloDeRepetición,
                         int contadorDeRepeticiones)

    bool scheduleMessage(const QString& nombre,
                         const QString& mensaje,
                         const QString& fechaHoraDeInicio,
                         int cancelaciónTardía,
                         unsigned indicadores,
                         const QString& colorDelFondo,
                         const QString& colorDelTexto,
                         const QString& tipoDeLetra,
                         const QString& urlDeSonido,
                         int minutosRecordatorio,
                         int tipoDeRepetición,
                         int intervaloDeRepetición,
                         const QString& fechaHoraDeFinalización)

###### Parámetros

nombre

  Especifica un nombre opcional para la alarma.

mensaje

  Especifica el texto del mensaje a planificar, o si flags tiene activado el bit `DISPLAY_COMMAND`, especifica la línea de órdenes a ejecutar para generar el mensaje de texto.

fechaHoraDeInicio

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de solo fecha, la cadena debería tener el formato AAAA-MM-DD[ TZ] (tal y como lo devuelve el método QDate::toString(Qt::ISODate)). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS][ TZ] (tal y como lo devuelve el método QDateTime::toString(Qt::ISODate)) o HH:MM[:SS](tal y como lo devuelve el método QTime::toString(Qt::ISODate)). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se supone la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (⪚ `Europe/London`), `UTC` representando la zona horaria UTC.

cancelaciónPosterior

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

indicadores

  Especifica la O lógica de los indicadores de la alarma deseada. Los bits de la alarma son los que se definen en la clase KAlarmIface en `kalarmiface.h`. Tenga en cuenta que no todos los bits del indicador se pueden aplicar a los mensajes de la alarma.

colorDelFondo

  Especifica el color de fondo para cuando se muestre el mensaje. La cadena puede tener el formato #RRGGBB (tal y como devuelve el método QColor::name()), donde RR, GG y BB son valores hexadecimales de dos dígitos para el rojo, el verde y el azul. Además, la cadena puede ser de cualquiera de los formatos que acepte QColor::setNamedColor(), como un nombre de la base de datos de colores de las X (⪚ red o steelblue). Defina la cadena como nula para indicar que se use el color de fondo predeterminado actual.

colorDelTexto

  Especifica el color de primer plano para mostrar el mensaje. El formato de la cadena es el mismo que el de color-Fondo, o, de forma alternativa, definir la cadena como nula para indicar el color de primer plano predeterminado actual.

tipoDeLetra

  Especifica el tipo de letra para mostrar el mensaje. El formato de la cadena es la salida de QFont::toString(). Defina la cadena como nula para que se use el tipo de letra predeterminado actual para el mensaje en el momento en el que se muestre.

urlDeSonido

  Especifica el archivo de sonido que se va a reproducir cuando se muestre el mensaje. Defina el valor como nulo si no quiere que se reproduzca ningún archivo de sonido.

minsRestantes

  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 un valor negativo para un recordatorio a visualizar después de la alarma principal. Especifique cero si no necesita recordatorio.

repetición

  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.

tipoDeRepetición

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase KAlarmIface en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro startDateTime.

intervaloDeRepetición

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en recurType) entre repeticiones de la alarma.

contadorDeRepeticiones

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

fechaHoraDeFin

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si startDateTime incluye una hora, este parámetro también debe incluir una hora. Si startDateTime solo contiene una fecha, el parámetro también debe contener solo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para startDateTime.

intervaloDeSubRepetición

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya subrepetición. Se ignora si no se especifica repetición.

contadorDeSubRepeticiones

  Especifica el número de subrepeticiones de la alarma, incluyendo la aparición inicial.

##### Descripción

`scheduleMessage()` es una llamada &DBus; para planificar mostrar el mensaje de alarma especificado en la fecha y hora indicada. Hay tres formas. Las forma más general permite que se especifique una repetición arbitraria – úsela también para alarmas que no se repitan. Las otras formas proporcionan acceso a un juego restringido de tipos de repeticiones de la alarma, una especificando un contador de repeticiones y otra una hora de finalización.

Si la hora planificada (incluyendo cualquier repetición), ya ha pasado,&kalarm; muestra el mensaje inmediatamente (a no ser que el valor cancelar-si-tarde indique que es demasiado tarde para mostrar la alarma, en cuyo caso &kalarm; ignora la solicitud). Si la hora planificada (o una repetición) ocurre en el futuro, &kalarm; añade el mensaje de alarma a la alarma activa predeterminada para mostrarlo más tarde.

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

    bool scheduleFile(const QString& nombre,
                      const QString& URL,
                      const QString& fechaHoraDeInicio,
                      int cancelaciónTardía,
                      unsigned indicadores,
                      const QString& colorDelFondo,
                      const QString& urlSonido,
                      int minutosDelRecordatorio,
                      const QString& repetición,
                      int intervaloDeSubRepetición,
                      int contadorDeSubRepetición)

    bool scheduleFile(const QString& nombre,
                      const QString& url,
                      const QString& fechaHoraDeInicio,
                      int cancelaciónTardía,
                      unsigned indicadores,
                      const QString& colorDeFondo,
                      const QString& urlDeSonido,
                      int minutosRecordatorio,
                      int tipoRepetición,
                      int intervaloRepetición,
                      int contadorRepetición)

    bool scheduleFile(const QString& nombre,
                      const QString& url,
                      const QString& fechaHoraDeInicio,
                      int cancelaciónTardía,
                      unsigned indicadores,
                      const QString& colorDeFondo,
                      const QString& urlDeSonido,
                      int ninutosRecordatorio,
                      int tipoRepetición,
                      int intervaloRepetición,
                      const QString& fechaHoraFinal)

###### Parámetros

nombre

  Especifica un nombre opcional para la alarma.

url

  Especifica el archivo de texto o de imagen cuyo contenido se va a mostrar en el mensaje planificado.

fechaHoraDeInicio

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de solo fecha, la cadena debería tener el formato AAAA-MM-DD[ TZ] (tal y como lo devuelve el método QDate::toString(Qt::ISODate)). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS][ TZ] (tal y como lo devuelve el método QDateTime::toString(Qt::ISODate)) o HH:MM[:SS](tal y como lo devuelve el método QTime::toString(Qt::ISODate)). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se supone la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (⪚ `Europe/London`), `UTC` representando la zona horaria UTC.

cancelaciónPosterior

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

indicadores

  Especifica la O lógica de los indicadores de alarma deseadas. Los bits del indicador son los que se definen en la clase KAlarmIface en `kalarmiface.h`. Tenga en cuenta que no todos los bits del indicador se aplican a las alarmas de archivos.

colorDelFondo

  Especifica el color de fondo para cuando se muestre el archivo. La cadena puede tener el formato #RRGGBB (tal y como devuelve el método QColor::name()), donde RR, GG y BB son valores hexadecimales de dos dígitos para el rojo, el verde y el azul. Además, la cadena puede ser de cualquiera de los otros formatos que acepta QColor::setNamedColor(), como un nombre de la base de datos de colores de las X (⪚ red o steelblue). Defina la cadena como nula para indicar que se use el color de fondo predeterminado actual.

urlDeSonido

  Especifica el archivo de sonido que se va a reproducir cuando se muestre el mensaje. Defina el valor como nulo si no quiere que se reproduzca ningún archivo de sonido.

minsRestantes

  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 un valor negativo para un recordatorio a visualizar después de la alarma principal. Especifique cero si no necesita recordatorio.

repetición

  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.

tipoDeRepetición

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase KAlarmIface en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro startDateTime.

intervaloDeRepetición

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en recurType) entre repeticiones de la alarma.

contadorDeRepeticiones

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

fechaHoraDeFin

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si startDateTime incluye una hora, este parámetro también debe incluir una hora. Si startDateTime solo contiene una fecha, el parámetro también debe contener solo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para startDateTime.

intervaloDeSubRepetición

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya subrepetición. Se ignora si no se especifica repetición.

contadorDeSubRepeticiones

  Especifica el número de subrepeticiones de la alarma, incluyendo la aparición inicial.

##### Descripción

`scheduleFile()` es una llamada &DBus; para planificar el archivo de texto o imagen a mostrar en la fecha y hora especificada. Aparte de especificar una ruta de archivo o &URL; y de omitir el color de primer plano y el tipo de letra, 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 una orden de la shell.

    bool scheduleCommand(const QString& nombre,
                         const QString& orden,
                         const QString& fechaHoraDeInicio,
                         int cancelaciónTardía,
                         unsigned indicadores,
                         const QString& recurrencia,
                         int intervaloSubRepetición,
                         int contadorSubRepetición)

    bool scheduleCommand(const QString& nombre,
                         const QString& orden,
                         const QString& fechaHoraDeInicio,
                         int cancelaciónTardía,
                         unsigned indicadores,
                         int tipoRepetición,
                         int intervaloRepetición,
                         int contadorRepetición)

    bool scheduleCommand(const QString& nombre,
                         const QString& orden,
                         const QString& fechaHoraDeInicio,
                         int cancelaciónTardía,
                         unsigned indicadores,
                         int tipoRepetición,
                         int intervaloRepetición,
                         const QString& fechaHoraFinal)

###### Parámetros

nombre

  Especifica un nombre opcional para la alarma.

orden

  Indica la orden cuya ejecución se va a planificar. El parámetro indicadores indica si ese parámetro contiene un línea de órdenes de la shell o un guion con órdenes.

fechaHoraDeInicio

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de solo fecha, la cadena debería tener el formato AAAA-MM-DD[ TZ] (tal y como lo devuelve el método QDate::toString(Qt::ISODate)). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS][ TZ] (tal y como lo devuelve el método QDateTime::toString(Qt::ISODate)) o HH:MM[:SS](tal y como lo devuelve el método QTime::toString(Qt::ISODate)). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se supone la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (⪚ `Europe/London`), `UTC` representando la zona horaria UTC.

cancelaciónPosterior

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

indicadores

  Especifica la O lógica de los indicadores de alarma deseadas. Los bits del indicador son los que se definen en la clase KAlarmIface en `kalarmiface.h`. Tenga en cuenta que no todos los bits del indicador se pueden aplicar a las alarmas de órdenes.

repetición

  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.

tipoDeRepetición

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase KAlarmIface en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro startDateTime.

intervaloDeRepetición

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en recurType) entre repeticiones de la alarma.

contadorDeRepeticiones

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

fechaHoraDeFin

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si startDateTime incluye una hora, este parámetro también debe incluir una hora. Si startDateTime solo contiene una fecha, el parámetro también debe contener solo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para startDateTime.

intervaloDeSubRepetición

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya subrepetición. Se ignora si no se especifica repetición.

contadorDeSubRepeticiones

  Especifica el número de subrepeticiones de la alarma, incluyendo la aparición inicial.

##### Descripción

`scheduleCommand()` es una llamada a &DBus; para planificar la ejecución de la línea de órdenes de la shell o de un guion de órdenes para su ejecución en la fecha y hora indicada. Además de indicar una orden y de omitir el color del mensaje, tipo de letra y los parámetros del archivo de audio, su uso es idéntico a `scheduleMessage`. Puede ver la descripción de esa función para más detalles.

scheduleEmail
scheduleEmail planifica una alarma nueva que envía un correo.

    bool scheduleEmail(const QString& nombre,
                       const QString& ID_de,
                       const QString& direcciones,
                       const QString& asunto,
                       const QString& mensaje,
                       const QString& adjuntos,
                       const QString& fechaHoraDeInicio,
                       int cancelaciónTardía,
                       unsigned indicadores,
                       const QString& recurrencia,
                       int intervaloSubRepetición,
                       int contadorSubRepetición)

    bool scheduleEmail(const QString& nombre,
                       const QString& ID_de,
                       const QString& direcciones,
                       const QString& asunto,
                       const QString& mensaje,
                       const QString& adjuntos,
                       const QString& fechaHoraDeInicio,
                       int cancelaciónTardía,
                       unsigned indicadores,
                       int tipoRepetición,
                       int intervaloRepetición,
                       int contadorRepetición)

    bool scheduleEmail(const QString& nombre,
                       const QString& ID_de,
                       const QString& direcciones,
                       const QString& asunto,
                       const QString& mensaje,
                       const QString& adjuntos,
                       const QString& fechaHoraDeInicio,
                       int cancelaciónTardía,
                       unsigned indicadores,
                       int tipoRepetición,
                       int intervaloRepetición,
                       const QString& horaFinal)

###### Parámetros

nombre

  Especifica un nombre opcional para la alarma.

ID_de

  La identidad que va a usar &kmail; como remitente del correo electrónico. Si se deja vacío, la dirección de correo electrónico del remitente será la que esté configurada en las Preferencias de correo electrónico de &kalarm;.

direcciones

  Una lista de direcciones de correo electrónico de destinatarios, separadas por comas.

asunto

  Especifica la línea del asunto del correo.

mensaje

  Especifica el cuerpo del mensaje del correo.

adjuntos

  Una lista de rutas o &URL;s de archivos para enviar como adjuntos de correo, separadas por comas.

fechaHoraDeInicio

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de solo fecha, la cadena debería tener el formato AAAA-MM-DD[ TZ] (tal y como lo devuelve el método QDate::toString(Qt::ISODate)). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS][ TZ] (tal y como lo devuelve el método QDateTime::toString(Qt::ISODate)) o HH:MM[:SS](tal y como lo devuelve el método QTime::toString(Qt::ISODate)). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se supone la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (⪚ `Europe/London`), `UTC` representando la zona horaria UTC.

cancelaciónPosterior

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

indicadores

  Especifica la O lógica de los indicadores de alarma deseadas. Los bits del indicador son los que se definen en la clase KAlarmIface en `kalarmiface.h`. Tenga en cuenta que no todos los bits del indicador se aplican a las alarmas de correo electrónico.

repetición

  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.

tipoDeRepetición

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase KAlarmIface en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro startDateTime.

intervaloDeRepetición

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en recurType) entre repeticiones de la alarma.

contadorDeRepeticiones

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

fechaHoraDeFin

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si startDateTime incluye una hora, este parámetro también debe incluir una hora. Si startDateTime solo contiene una fecha, el parámetro también debe contener solo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para startDateTime.

intervaloDeSubRepetición

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya subrepetición. Se ignora si no se especifica repetición.

contadorDeSubRepeticiones

  Especifica el número de subrepeticiones de la alarma, incluyendo la aparición inicial.

##### Descripción

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

scheduleAudio
scheduleAudio planifica una alarma nueva que ejecuta una orden de la shell.

    bool scheduleAudio(const QString& nombre,
                       const QString& urlSonido,
                       int porcentajeVolumen,
                       const QString& fechaHoraDeInicio,
                       int cancelaciónTardía,
                       unsigned indicadores,
                       const QString& recurrencia,
                       int intervaloSubRepetición,
                       int contadorSubRepetición)

    bool scheduleAudio(const QString& nombre,
                       const QString& urlSonido,
                       int porcentajeVolumen,
                       const QString& fechaHoraDeInicio,
                       int cancelaciónTardía,
                       unsigned indicadores,
                       int tipoRepetición,
                       int intervaloRepetición,
                       int contadorRepetición)

    bool scheduleAudio(const QString& nombre,
                       const QString& urlSonido,
                       int porcentajeVolumen,
                       const QString& fechaHoraDeInicio,
                       int cancelaciónTardía,
                       unsigned indicadores,
                       int tipoRepetición,
                       int intervaloRepetición,
                       const QString& fechaHoraFinal)

###### Parámetros

nombre

  Especifica un nombre opcional para la alarma.

urlDeSonido

  Indica el archivo de audio que se va a reproducir.

porcentajeVolumen

  Especifica el nivel de volumen a utilizar, como un porcentaje sobre el volumen total. Especifique -1 para utilizar el volumen predeterminado.

fechaHoraDeInicio

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de solo fecha, la cadena debería tener el formato AAAA-MM-DD[ TZ] (tal y como lo devuelve el método QDate::toString(Qt::ISODate)). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS][ TZ] (tal y como lo devuelve el método QDateTime::toString(Qt::ISODate)) o HH:MM[:SS](tal y como lo devuelve el método QTime::toString(Qt::ISODate)). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se supone la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (⪚ `Europe/London`), `UTC` representando la zona horaria UTC.

cancelaciónPosterior

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

indicadores

  Especifica la O lógica de los indicadores de alarma deseadas. Los bits del indicador son los que se definen en la clase KAlarmIface en `kalarmiface.h`. Tenga en cuenta que no todos los bits del indicador se pueden aplicar a las alarmas de órdenes.

repetición

  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.

tipoDeRepetición

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase KAlarmIface en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro startDateTime.

intervaloDeRepetición

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en recurType) entre repeticiones de la alarma.

contadorDeRepeticiones

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

fechaHoraDeFin

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si startDateTime incluye una hora, este parámetro también debe incluir una hora. Si startDateTime solo contiene una fecha, el parámetro también debe contener solo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para startDateTime.

intervaloDeSubRepetición

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya subrepetición. Se ignora si no se especifica repetición.

contadorDeSubRepeticiones

  Especifica el número de subrepeticiones de la alarma, incluyendo la aparición inicial.

##### Descripción

`scheduleAudio()` es una llamada a &DBus; para programar el archivo de audio que se va a reproducir al a fecha y hora especificada. Aparte de especificar un volumen y omitir los parámetros de color y tipo de letra del mensaje, su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para detalles adicionales.

edit
edit Muestra el diálogo de edición de alarma para editar una alarma.

    bool edit(const QString& eventID)

###### Parámetros

eventID

  Especifica el ID único del evento que se va a editar, opcionalmente precedido por el nombre de configuración o el ID numérico del recurso que contiene el evento, en el formato [ID_de_recurso:]UID_de_evento.

###### Valor devuelto

false si la alarma indicada no se puede encontrar o es de solo lectura. En los demás casos, devuelve true.

##### Descripción

`edit()` es una llamada &DBus;para mostrar el diálogo de edición de alarma para editar la alarma indicada.

editNew
editNew Muestra el diálogo de edición de alarma para editar una alarma nueva.

    bool editNew(int type)

    bool editNew(const QString& templateName)

###### Parámetros

tipo

  Especifica el tipo de alarma. Los valores permitidos son DISPLAY, COMMAND, EMAIL, AUDIO. Están definidos en la clase KAlarmIface in `kalarmiface.h`.

templateName

  Indica el nombre de una plantilla de alarma que se debe tomar como base para la nueva alarma.

###### Valor devuelto

false si type contiene un valor no válido, o si no se puede encontrar una plantilla de nombre templateName; true en otro caso.

##### Descripción

`editNew()` es una llamada &DBus; para mostrar el Diálogo de edición de alarma para editar una alarma nueva. Si se especifica como parámetro un tipo de alarma, se visualiza un diálogo en blanco. Alternativamente, si se especifica como parámetro un nombre de plantilla de alarma, el diálogo se inicializa con los valores de la plantilla.

listar
listar Devuelve una lista de alarmas programadas.

    QString list()

###### Valor devuelto

Lista de alarmas, separada por saltos de línea, cada una en el formato id_de_recurso:UID hora texto

##### Descripción

`list()` es una llamada a &DBus; para devolver una cadena que contiene un resumen de alarmas programadas. La lista muestra detalles concisos de cada alarma pendiente: su identificador de recurso, UID, siguiente periodo programado y texto del mensaje o archivo.

### Interfaz de la línea de órdenes

Las opciones de la línea de órdenes se proporcionan para permitir que otros programas lancen &kalarm;, si es que no se está ejecutando ya, para activar o cancelar las alarmas planificadas, o para planificar alarmas nuevas. La razón para usar estas opciones de la línea de órdenes para este propósito es que si &kalarm; se iniciara sin ningún parámetro en la línea de órdenes y luego enviaba peticiones &DBus;, 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á en ejecución; si es así, deberían intentar usar llamadas &DBus;; para solicitar estas operaciones.

Las opciones de la línea de órdenes que se usan para planificar una alarma nueva se describen en el capítulo Operación en línea de órdenes. 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 órdenes (asumiendo que puedan proporcionar la información necesaria de los parámetros).

Opción | Descripción
--- | ---
`--cancelEvent eventID` | Cancelar la alarma con el ID de evento especificado. El ID de evento es el ID único del evento, opcionalmente precedido por el ID del recurso que lo contiene, en el formato [ID_de_recurso:]UID_de_evento. La acción es la misma que para la llamada &DBus; cancelEvent(). No se puede especificar `--triggerEvent` junto a esta opción.
`--triggerEvent eventID` | Activar la alarma con el ID de evento especificado. El ID de evento es el ID único del evento, opcionalmente precedido por el ID del recurso que lo contiene, en el formato [ID_de_recurso:]UID_de_evento. La acción es la misma que para la llamada &DBus; triggerEvent(). No se puede especificar `--cancelEvent` junto a esta opción.

Ejemplos:

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

## Preguntas y respuestas

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

La configuración de &kalarm; se guarda en los siguientes archivos de la carpeta `qtpaths --paths GenericConfigLocation`:

- `kalarmrc` contiene las preferencias de &kalarm;.

- `kalarmresources` contiene la lista de calendarios de alarmas que usa &kalarm; en la actualidad.

¿Dónde almacena &kalarm; las alarmas?

Cuando &kalarm; se ejecuta por primera vez, crea los siguientes calendarios de alarmas en la carpeta `qtpaths --pathsGenericDataLocation`:

- `kalarm/calendar.ics`, que contiene alarmas activas.

- `kalarm/expired.ics`, que contiene alarmas archivadas.

- `kalarm/template.ics`, que contiene plantillas de alarmas.

- `kalarm/displaying.ics`, que es un archivo de calendario especial que contiene detalles de las alarmas que se muestran actualmente, lo que permite que &kalarm;, cuando se reinicia, vuelva a mostrar las alarmas que se estaban mostrando cuando se detuvo la última vez.

Posteriormente, puede sustituir estos calendarios, excepto `displaying.ics`, o crear calendarios de alarmas adicionales en la ubicación que elija. Puede consultar los archivos de calendario en uso mostrando los detalles de cada calendario en la lista de calendarios de alarmas.

¿En qué formato se guardan las alarmas?

Los archivos de calendario en los que &kalarm; se almacena son archivos de texto cuyo formato está definido en el documento RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). Este es el formato estándar utilizado por todas las aplicaciones de kdepim. &kalarm; emplea ciertas propiedades no estándar, en cumplimiento con RFC2445. Estas se documentan en el archivo `DESIGN.kalarmcalendar.html` distribuido con &kalarm;.

¿Cuál es la función del complemento Akonadi de &kalarm;?

&kalarm; usa su complemento Akonadi para proporcionar todas las funciones que dependen de &akonadi; (el servicio de almacenamiento multiescritorio de &kde; &PIM;). Si este complemento no está instalado y activado, &kalarm; carecerá de las siguientes funciones:

- Envío de correos electrónicos a través de &kmail;, dejando &Sendmail; como la única opción para enviar correos electrónicos (consulte las Preferencias de correo electrónico).

- Arrastrar y soltar correos electrónicos.

- Selección de direcciones de correo de &kaddressbook;.

- Importar cumpleaños de &kaddressbook;.

- Migración de los recursos del calendario de alarmas de &akonadi; en la primera ejecución de una nueva versión de &kalarm;.

Si el complemento está instalado, se puede activar o desactivar en la pestaña General del diálogo de configuración.

¿Qué es el programa kalarmautostart?

kalarmautostart es un pequeño asistente cuya función es auto arrancar &kalarm; en el inicio de sesión.

&kalarm; se restaura, generalmente, por el gestor de sesiones al iniciar sesión (para volver a mostrar sus ventanas en el mismo estado en que se dejaron al cerrar sesión). Pero si no se estaba ejecutando cuando cerró sesión, no lo iniciará el gestor de sesiones y por lo tanto, necesita ser arrancado. Este problema es tal que cuando una aplicación se arranca tanto por el gestor de sesiones como auto iniciada, no hay garantía de lo que aparecerá primero. Si el auto arranque se produce primero, evitará que el gestor de sesiones pueda restaurar el estado de la aplicación.

Para evitar este problema kalarmautostart se arranca al inicio de sesión en lugar de &kalarm;. Todo lo que hace es esperar un rato (para asegurarse que el gestor de sesiones tiene tiempo de hacer su trabajo) antes de iniciar &kalarm; momento en el que termina.

¿Cómo puedo usar &kalarm; en un escritorio distinto de &plasma;?

Para lanzar &kalarm; en un escritorio que no sea &plasma;, el principal requisito es asegurar que &kalarm; se ejecuta automáticamente cuando inicie sesión. Puede consultar instrucciones más detalladas en el archivo `INSTALL` que se distribuye con &kalarm;.

## Créditos y licencia

&kalarm;

Copyright del programa 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025 &David.Jarvie; &David.Jarvie.mail;

Copyright de la documentación 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2016, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025 &David.Jarvie; &David.Jarvie.mail;

Traductores: Juan Manuel García Molina juanma@superiodico.net y Javier Viñal fjvinal@gmail.com.

&underFDL; &underGPL;

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 en adelante.

&documentation.index;