# El manual de &kalarm;

## Introducció

&kalarm; us permet programar la visualització de missatges d'alarma personal, la reproducció de fitxers de so, l'execució d'ordres i l'enviament de missatges de correu electrònic.

En el seu mode gràfic per omissió, &kalarm; mostra la llista d'alarmes pendents, mostrant els seus temps i els detalls. Podeu crear noves alarmes, o seleccionar les existents per a modificació o eliminació. Opcionalment, també podeu veure les alarmes expirades.

Quan es configura una alarma podeu decidir si s'ha de repetir, i si s'ha de cancel·lar si no es pot activar a la seva hora programada. Per les alarmes visuals, podeu escriure un text de missatge, especificar un fitxer de text o d'imatge a mostrar, o especificar una ordre per mostrar la seva sortida. També podeu triar el color del missatge d'alarma, i si reproduir un so o parlar el missatge.

Les alarmes es poden programar des de la línia d'ordres o a través de crides de &DBus; des dels programes.

Quan venç un missatge d'alarma, es mostrarà a cada escriptori &kde; per assegurar que no us el perdeu. La finestra de missatges mostrarà el temps durant el qual s'ha programat l'alarma. En general, té una opció d'ajornar per demanar que es mostri de nou més tard. Un exemple d'un missatge d'alarma:

Captura de pantalla de la finestra de missatge de &kalarm; Missatge d'alarma

Quan l'alarma especifica una ordre a executar o un correu electrònic per enviar, &kalarm; no mostra res.

&kalarm; en general mostra una icona a la safata del sistema, encara que si voleu es pot amagar.

## Usar &kalarm;

Quan s'executa sense cap paràmetre a la línia d'ordres, &kalarm; s'inicia en mode gràfic, i mostra la llista actual d'alarmes pendents.

Totes els botons de selecció de valors en &kalarm; disposen d'acceleració. Per realitzar el canvi de valor a grans passos, manteniu premuda la tecla &Maj; mentre feu clic en els botons de fletxa incrementals.

### Tipus d'alarma

Les funcions bàsiques disponibles en els diferents tipus d'alarma que &kalarm; proporciona són:

- Mostrar alarmes visuals amb un missatge de text que heu escrit, o el contingut d'un fitxer de text o d'imatge, o la sortida de text d'una ordre que s'executa quan s'activa l'alarma. A més de mostrar un d'aquests elements, també pot reproduir fitxers d'àudio, parlar el text, o emetre un timbre simple. També podeu especificar ordres que s'executaran abans i després del missatge d'alarma.

- Les alarmes d'ordre executen bé una ordre o un script de l'intèrpret d'ordres que podeu escriure. No es veurà res a menys que es produeixi un error.

- Les alarmes de correu envien un correu electrònic. No es veurà res a menys que es produeixi un error.

- Les alarmes d'àudio reprodueixen un fitxer d'àudio. No es veurà res a menys que es produeixi un error.

#### Gestió d'errors

Si es produeix un error quan s'activa una alarma, apareixerà un missatge d'error (a menys que s'hagi especificat prèviament no mostrar de nou aquest tipus de missatges).

Si va succeir un error d'execució l'última vegada que es va activar una alarma d'ordre, es mostrarà un signe d'exclamació blanc sobre vermell a la columna de missatges. Els detalls de l'error es mostraran en un consell d'eina si situeu el cursor sobre aquesta línia en la llista d'alarmes. Es mostren les mateixes indicacions d'error per les alarmes visuals si succeeix un error d'execució d'una pre- o post-alarma d'ordre especificada en el diàleg accions especials, excepte que el color de fons de la columna no es canvia a vermell.

### Llista d'alarmes

La finestra principal de &kalarm; mostra la llista actual d'alarmes pendents, mostrant els seus temps, els intervals de repetició, colors i text dels missatges, els noms dels fitxers a reproduir o mostrar, executar ordres o els assumptes de correu electrònic. (Per a una alarma que es repeteix, el temps que es mostra és la pròxima activació. Per a una alarma amb un recordatori, el temps que es mostra és el de la pròpia alarma, no la del recordatori). Una icona a la part esquerra de cada text de alarma/fitxer/ordre/assumpte del correu electrònic indica el tipus d'alarma.

Captura de pantalla de la finestra principal de &kalarm; Finestra principal

Per a una alarma repetida, la llista mostra la seva propera hora d'activació programada i el seu interval de repetició bàsic (&pex;, 1 dia per una repetició diària, 3 setmanes per a una repetició es desencadena el dilluns i dimecres cada tres setmanes, En entrar per una repetició d'alarma a cada inici de sessió).

Si va succeir un error d'execució l'última vegada que es va activar una alarma d'ordre, o l'última vegada que es va executar ordre de pre- o post-alarma d'una alarma visual, es mostrarà una indicació d'error en el color de la columna, tal com s'ha descrit anteriorment a Gestió d'errors.

#### Canviar l'aparença de la llista d'alarmes

Les alarmes es poden ordenar per data/hora, interval de repetició, color, tipus o text fent clic sobre la barra de títol de la columna corresponent. Per invertir l'ordre, feu clic altra vegada a la barra de títol de la columna.

De forma opcional, podeu mostrar el temps que falta per a que compleixi cada alarma, juntament amb, o en lloc de l'hora programada de l'alarma. Per mostrar o amagar la columna d'hora de l'alarma, seleccioneu Visualitza Mostra les hores de les alarmes. Per mostrar o amagar la columna de temps per a l'alarma, seleccioneu Visualitza Mostra el temps restant per a les alarmes. Sempre es mostrarà almenys una d'aquestes columnes.

Si utilitzeu diversos calendaris d'alarma, podeu donar color al codi de les alarmes d'acord amb el calendari que al que pertanyen, seleccionant un color de fons diferent per a cada calendari (veure Usar els calendaris).

#### Les alarmes arxivades

Per omissió, &kalarm; arxiva les alarmes per un període de temps limitat, una vegada que han expirat o s'han suprimit. (Fixeu-vos que les alarmes que suprimiu només s'emmagatzemen s'han activat almenys una vegada). Podeu controlar si &kalarm; haurà d'arxivar les alarmes expirades, i per quant temps, en el diàleg de configuració.

Les alarmes arxivades es poden mostrar a la llista d'alarmes seleccionant Visualitza Mostra les alarmes arxivades. Per amagar-les altra vegada, deseleccioneu Visualitza Mostra les alarmes arxivades.

#### Cercar a la llista d'alarmes

Podeu cercar a través de la llista d'alarmes per trobar les alarmes que contenen un cert text. Per fer-ho, seleccioneu Edita Cerca.... Al diàleg de cerca, seleccioneu el tipus d'alarma que voleu cercar. Per continuar la cerca de més alarmes que coincideixen, utilitzeu Edita Cerca següent o Edita Cerca anterior.

La cerca es realitza de la següent manera:

- Les alarmes de missatges de text: se cercarà el text del missatge.

- Les alarmes que mostren fitxers: se cercarà el camí/&URL; del fitxer.

- Les alarmes d'ordre: se cercarà la línia d'ordres o a l'script d'ordres.

- Les alarmes de correu: a més de a l'assumpte i al cos del correu, se cercarà als destinataris i als URL dels adjunts.

- Les alarmes d'àudio: se cercarà al camí/&URL; del fitxer.

Només es poden seleccionar per a la cerca les alarmes que es mostren actualment a la llista d'alarmes. De manera que si voleu cercar alarmes arxivades, primer haureu de mostrar-les com es descriu en la secció anterior.

### Crear i gestionar les alarmes

#### Crear una alarma nova

Per crear una nova alarma, realitzeu una de les següents accions i, a continuació, seleccioneu el tipus d'alarma de la llista que apareix. Això mostrarà el diàleg d'edició de l'alarma a través del qual configurareu l'alarma.

- Seleccioneu Fitxer Nova.

- Feu clic dret sobre la icona de la safata del sistema i seleccioneu Alarma nova al menú contextual.

- Feu clic dret en la llista d'alarmes i seleccioneu Nova al menú contextual.

També podeu crear noves alarmes preconfigurades des de diverses fonts:

- Per basar la vostra alarma nova en una plantilla d'alarma, seguiu les instruccions en la secció Plantilles d'alarma.

- Per basar la vostra alarma nova en una existent, ressalteu-la en la llista i seleccioneu Fitxer Copia. Això obrirà el diàleg d'edició de l'alarma ja omplert amb una còpia dels detalls de l'alarma seleccionada.

- Per crear una nova alarma que mostri un missatge de correu electrònic existent, arrossegueu-lo des del &kmail; cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Després seleccioneu l'opció Mostra l'alarma. Això obrirà el diàleg d'edició de l'alarma amb tot el missatge de correu electrònic (incloent remitent, destinatari, &etc;) com al text de l'alarma.

- Per crear una nova alarma de correu electrònic per enviar una còpia d'un missatge de correu electrònic existent, arrossegueu-lo des del &kmail; cap a la finestra principal de &kalarm; o la icona de la safata del sistema. A continuació, seleccioneu l'opció Alarmes de correu. El diàleg d'edició de l'alarma està preconfigurat amb tot el missatge de correu electrònic, excepte el remitent.

- Per crear una nova alarma que mostri un resum d'un pendent existent, arrossegueu-lo des del &korganizer; o una altra aplicació cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Això obrirà el diàleg d'edició de l'alarma amb el contingut del pendent com al text de l'alarma.

- Per a crear una nova alarma d'ordre, arrossegueu el text d'un script que comenci amb #! cap a la finestra principal de &kalarm; o la icona de la safata del sistema. A continuació, seleccioneu l'opció Alarma d'ordre. Això obrirà el diàleg d'edició de l'alarma preconfigurat amb el text de l'script.

- Per crear una alarma visual de fitxer, arrossegueu un text o &URL; de fitxer d'imatge cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Això obrirà el diàleg d'edició de l'alarma i s'establirà com al nom de fitxer.

- Per crear una alarma d'àudio, arrossegueu un &URL; de fitxer d'àudio cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Això obrirà el diàleg d'edició de l'alarma i s'establirà com al nom de fitxer.

- Per a crear una nova alarma de text, arrossegueu una peça de text cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Si s'us demana, seleccioneu l'opció Mostra l'alarma. Això obrirà el diàleg d'edició de l'alarma preconfigurat amb tot el text de l'alarma.

- Podeu crear automàticament les alarmes d'aniversari per a les persones en &kaddressbook; tal com es descriu en Importar aniversaris des de &kaddressbook;.

#### Modificar una alarma existent

Per modificar una alarma pendent existent (les alarmes expirades no es poden modificar), realitzeu una de les següents accions:

- Feu doble clic sobre la seva entrada en la llista d'alarmes.

- Seleccioneu-la fent clic sobre la seva entrada a la llista d'alarmes. A continuació, escolliu Edita Edita.

- Feu clic dret sobre la seva entrada a la llista d'alarmes i escolliu Edita al menú contextual.

Això mostrarà el diàleg d'edició de l'alarma.

#### Suprimir/reactivar una alarma

Per suprimir les alarmes existents, seleccioneu-ne una o més fent clic a les seves entrades a la llista d'alarmes. A continuació, realitzeu una de les següents accions:

- Escolliu Edita Suprimeix.

- Feu clic dret sobre les entrades seleccionades i escolliu Suprimeix al menú contextual.

- Per suprimir-les sense un missatge de confirmació, premeu &Maj;-Supr.

Quan se suprimeix una alarma activa, aquesta és arxivada, sempre que s'hagi activat almenys una vegada abans de ser suprimida, i sempre s'arxiven totes les alarmes expirades. (Utilitzeu el diàleg de configuració per controlar si s'han d'arxivar les alarmes i durant quant de temps s'emmagatzemen). Quan se suprimeix una alarma arxivada, o una alarma habilitada que encara no s'ha activat, aquesta se suprimeix permanentment.

Podeu reactivar una alarma suprimida des de la llista d'alarmes arxivades, sempre que no hagi expirat. Per fer-ho, en primer lloc mostreu les alarmes arxivades, tal com es descriu en alarmes arxivades. Llavors:

- Seleccioneu una o més alarmes arxivades apropiades fent clic a les seves entrades a la llista d'alarmes. A continuació, escolliu Accions Reactiva.

- Feu clic dret sobre les entrades en qüestió a la llista d'alarmes arxivades i escolliu Reactiva al menú contextual.

#### Habilitar i deshabilitar una alarma

Veure Habilitar i deshabilitar les alarmes per a saber com habilitar i deshabilitar les alarmes, ja sigui individualment o en conjunt.

#### Establir una alarma per despertar de l'estat de suspensió

Veure Despertar de l'estat de suspensió per saber com configurar una alarma per despertar el vostre sistema des dels seus estats de suspensió o hibernació.

#### Confirmar una alarma

Veure Finestra de missatge d'alarma per saber com confirmar les alarmes.

#### Plantilles d'alarma

Si voleu configurar amb freqüència alarmes similars, podeu crear una plantilla d'alarma per evitar haver d'introduir cada vegada tots els detalls. Una plantilla pot contenir tots els detalls que una alarma pot contenir, a més de la data d'inici.

A tall d'exemple, potser voldreu configurar una alarma regularment per a que us recordi l'emissió d'un programa de televisió que varia d'una setmana a una altra. La plantilla conté tots els detalls de l'alarma (missatge de text, ja sigui per reproduir un so, &etc;) a excepció de l'hora i la data. Ara, per crear l'alarma, tot el que necessitareu fer és obrir el diàleg d'edició de l'alarma amb aquesta plantilla i després introduïu l'hora i la data.

Per crear una alarma basada en una plantilla, obriu el diàleg d'edició de l'alarma preconfigurat amb els detalls de la plantilla:

- Seleccioneu l'element de menú Fitxer Nova Alarma nova des d'una plantilla , i seleccioneu la plantilla desitjada.

- Feu clic dret sobre la icona de la safata del sistema i escolliu Alarma nova Alarma nova des d'una plantilla al menú contextual. A continuació, seleccioneu la plantilla desitjada.

- S'obrirà el diàleg d'edició de l'alarma de la forma habitual, i feu clic al botó Carrega una plantilla... per seleccionar una plantilla amb la que preconfigurar el diàleg.

##### Configurar les plantilles

Podeu crear, modificar o eliminar les plantilles mitjançant el diàleg Plantilles d'alarma, o podeu crear una nova plantilla d'alarma basada en una alarma existent.

Per crear una nova plantilla d'alarma, realitzeu una de les següents accions:

- Mostreu el diàleg Plantilles d'alarma, seleccioneu l'element de menú Fitxer Plantilles..., feu clic a Nova, i escolliu el tipus d'alarma de la llista que apareixerà. Això mostrarà un diàleg d'edició de la plantilla en blanc.

- Mostreu el diàleg Plantilles d'alarma, seleccioneu l'element de menú Fitxer Plantilles... , seleccioneu una plantilla existent de la llista i feu clic a Copia. Això obrirà el diàleg d'edició de la plantilla completat amb una còpia dels detalls de la plantilla existent.

- Ressalteu una alarma a la llista d'alarmes i seleccioneu Fitxer Crea una plantilla.... Això obrirà el diàleg d'edició de la plantilla completat amb una còpia dels detalls de l'alarma seleccionada.

Per modificar una plantilla existent, mostreu el diàleg Plantilles d'alarma, seleccioneu l'element de menú Fitxer Plantilles... i feu clic a Edita. Això mostrarà el diàleg d'edició de la plantilla que es descriu a sota.

Per eliminar les plantilles existents, mostreu el diàleg Plantilles d'alarma seleccionant l'element de menú Fitxer Plantilles... , seleccioneu-ne una o més i feu clic a Elimina. Es mostrarà un missatge de confirmació per evitar eliminacions accidentals.

##### El diàleg d'edició de la plantilla

El diàleg d'edició de la plantilla és similar al diàleg d'edició de l'alarma. Els següents controls són diferents:

- Introduïu el seu nom en Nom de la plantilla. És el nom de la plantilla que es mostrarà a les llistes de selecció de plantilles, així que el millor és triar un nom que recordi la seva funció. El nom de cada plantilla ha de ser únic.

- En el grup de caselles Hora, escolliu una de:

  - Hora per omissió si no voleu especificar cap moment d'activació. Les alarmes basades en aquesta plantilla utilitzaren inicialment l'hora d'activació per omissió normal per a les noves alarmes.

  - Marcar Hora per introduir un moment en què l'alarma s'activi.

  - Marcar Només data per especificar que l'alarma només ha de tenir una data, no una hora.

  - Marcar Temps des d'ara per introduir el temps (en hores i minuts) després del qual es crearà l'alarma -s'activarà-.

- En el grup de caselles Regla de recurrència a la pestanya Recurrència, no necessiteu seleccionar dia o mes per a les recurrències setmanal o anual, respectivament.

#### Calendaris d'alarma

Si només feu servir un ordinador i treballeu de forma independent, potser no hi fa res que &kalarm; emmagatzemi les alarmes. Però si necessiteu accedir a les alarmes en més d'un ordinador, o en més d'una ubicació a l'ordinador local, podeu definir calendaris d'alarma per dir-li a &kalarm; que utilitzi altres calendaris d'alarma addicional per a, o en substitució de, les per omissió.

Podeu veure i gestionar els calendaris a través de la llista de calendaris, que es poden mostrar juntament amb la llista d'alarmes a la finestra principal de &kalarm;. Les alarmes de tots els calendaris d'alarma es mostren fusionades a la llista d'alarmes. Quan es desa una nova alarma, podeu definir una opció de configuració per determinar si s'ha de desar automàticament en el calendari per omissió, o si se us ha de demanar que seleccioneu un calendari. Quan s'edita una alarma existent, aquesta es desarà automàticament de nou en el seu calendari d'alarma original.

Captura de pantalla de la finestra principal de &kalarm; mostrant la llista de calendaris Finestra principal mostrant la llista de calendaris

##### Tipus de calendari i opcions

Els calendaris d'alarma es classifiquen per tipus d'alarma i el tipus d'emmagatzematge. El qual es pot deshabilitar, establir a només lectura, o fer el calendari per omissió per al seu tipus d'alarma.

Tipus d'alarma

- Els tres tipus d'entitats d'alarma –alarmes activades, alarmes arxivades i plantilles d'alarma– s'emmagatzemen en els calendaris d'alarma separats. &kalarm; té tres tipusde calendaris per omissió estàndard, un per a cada tipus (veure Preguntes i respostes per a més detalls), que podeu canviar si ho voleu.

Tipus d'emmagatzematge

- &kalarm; gestiona tres tipus d'emmagatzematge de calendaris d'alarma:

  - Fitxer local: Les alarmes s'emmagatzemen en un únic fitxer local en format iCalendar. &kalarm; per omissió utilitza calendaris de fitxer local (veure Preguntes i respostes per a més detalls). Fitxers locals, a més dels fitxers en l'equip local, poden incloure els calendaris d'alarma a la xarxa local, així com la seva ubicació es poden representar per un nom de camí que comenci per `/`.

  - Directori local: Les alarmes s'emmagatzemen en una carpeta local, cada alarma s'emmagatzema en un fitxer d'iCalendar independent dins de la carpeta. Aquest mètode d'emmagatzematge té l'avantatge que en el cas de corrupció de fitxers, perdreu una sola alarma, no tot el calendari.

  - Fitxers remot: Les alarmes s'emmagatzemen en un únic fitxer remot en format iCalendar. Aquest mètode d'emmagatzematge us permetrà accedir a les dades de l'alarma de forma remota, sense importar on us trobeu, o permetrà que els calendaris d'alarma siguin visibles per altres persones. Quan s'utilitzen fitxers remots, &kalarm; funciona amb una memòria cau local de les dades.

    Si un calendari d'alarma remot és compartit entre els usuaris, els canvis realitzats per una persona poden no estar automàticament a disposició d'un altre usuari, o hi podria haver un retard de temps abans que un altre usuari el veu. De manera que un usuari pot fer un canvi que després se sobreescriu amb un altre usuari sense que ningú s'adoni del que ha succeït. La raó tècnica d'això és que un canvi realitzat per una persona A només estarà disponible per a la persona B després que la persona A hagi desat primer una còpia a la memòria cau del fitxer remot, i després que la persona B hagi recarregat el fitxer remot. Quan es desa o recarrega el calendari depèn dels paràmetres de configuració del calendari que cada usuari ha establert per a aquest calendari d'alarma.

    Maneres d'evitar aquest problema inclouen l'ajust dels paràmetres de configuració per desar i recarregar els calendaris, o adoptar una política per a que els altres usuaris no siguin els propietaris del calendari d'alarma i hagin d'obrir-lo en mode de només lectura.

Estat habilitat/deshabilitat

- Deshabilitar un calendari té el mateix efecte que eliminar-lo, excepte que encara apareix a la llista de calendaris per facilitar el tornar-lo a habilitar. Quan es deshabilita, les alarmes seran ignorades i no apareixeran a la llista d'alarmes o a la llista de plantilles. Quan es torna a habilitar, les alarmes es tornaran a mostrar i, si es tracta d'un calendari d'alarma actiu, s'activarà.

Estat de només lectura

- Un calendari d'alarmes de només lectura no es pot modificar. Pel que no podreu editar les seves alarmes, o desar-ne de noves. A més, no és possible ajornar les alarmes, ja que per això seria necessari el temps d'ajornament que es desa a l'alarma. Quan s'activen les alarmes, no s'eliminaran del calendari i seran arxivades fins que vos o un altre usuari accedeixi al calendari en mode de lectura i escriptura.

  Podeu definir l'estat de només lectura d'un calendari en el diàleg de configuració del calendari. No obstant, alguns calendaris no es poden fer d'escriptura, per diverses raons:

  - Si un calendari ha estat creat per una altra aplicació, no seria segur permetre que &kalarm; l'actualitzi, ja que les diferències en el format de les dades podria fer-lo inusable per l'aplicació que el va crear.

  - Si el calendari es va crear amb una versió posterior de &kalarm;, les dades es podrien perdre actualitzant-lo des de la vostra versió de &kalarm; actualitzat.

  - Si el calendari es va crear amb una versió antiga de &kalarm;, les dades es podrien perdre actualitzant-lo des de la vostra versió de &kalarm; actualitzat. Se us demanarà si voleu convertir el seu format per tal de donar-vos permisos d'escriptura, tenint en compte els possibles problemes de compatibilitat si la versió anterior de &kalarm; hi necessita per accedir de nou.

  - Si no teniu permisos per escriure al fitxer o una carpeta de calendari.

  Si necessiteu accés d'escriptura a les alarmes en un calendari que no es pot fer d'escriptura, podeu copiar les seves alarmes important-les a un calendari d'escriptura utilitzant l'opció Importa... del menú contextual (veure Importar alarmes de calendaris externs).

Estat del calendari per omissió

- Un calendari de cada tipus d'alarma es pot fer opcionalment el calendari per omissió per a aquest tipus d'alarma. Les alarmes noves es desen automàticament al calendari per omissió per al tipus d'alarma apropiat, llevat que s'hagi seleccionat l'opció de preguntar per les noves alarmes i plantilles en el diàleg de configuració.

##### Usar els calendaris

Podeu veure i gestionar els calendaris a través de la llista de calendaris, es poden mostrar o ocultar fent Visualitza Mostra els calendaris . Quan s'utilitza la llista de calendaris, primer seleccioneu el tipus d'alarma utilitzant el quadre combinat a sobre de la llista. Llavors, o bé feu clic en un dels botons sota la llista, o bé feu clic dret sobre el calendari apropiat en la llista i escolliu un element al menú contextual. Les accions disponibles són:

Afegeix...

- Afegeix un calendari del tipus seleccionat a la llista. Se us demanarà que escolliu un tipus d'emmagatzematge, després d'això es mostrarà el diàleg de configuració del calendari, on podreu introduir la ubicació del calendari i les seves característiques. Si no hi ha cap calendari d'alarma existent a la ubicació especificada, es crearà un de nou.

Elimina

- Elimina el calendari seleccionat a la llista. El calendari mateix es deixa intacte. Simplement s'esborra de la llista i, si ho voleu, posteriorment es podrà reinstal·lar a la llista.

Edita...

- Edita el calendari seleccionat. Això mostrarà el diàleg de configuració del calendari seleccionat.

Torna a carregar

- Torna a carregar el calendari seleccionat. Es torna a llegir el calendari des de la seva ubicació d'emmagatzematge, assegurant que no hi ha discrepància entre el que mostra &kalarm; i l'estat actual del calendari. Si el calendari és compartit amb altres usuaris, qualsevol canvi realitzat ara serà vist per &kalarm;.

  Si torneu a carregar un calendari remot, es perdrà qualsevol canvi realitzat a les alarmes des de l'última vegada que es va desar el calendari. A més, es poden tornar a activar totes les alarmes que havien expirat.

Desa

- Desa qualsevol canvi en el calendari seleccionat. El calendari s'actualitza amb qualsevol canvi d'alarma ocorregut des de l'última vegada que es va desar o recarregar el calendari. Això només és útil per als calendaris remots, ja que els calendaris locals es desen automàticament després de cada canvi. Podeu configurar quan i amb quina freqüència es desa automàticament un calendari remot, amb el seu diàleg de configuració (a través de l'opció Edita... al menú contextual).

  Si deseu un calendari remot que es comparteix amb altres usuaris, els canvis realitzats per aquests des de l'última recàrrega (automàtica o manual) es perdran.

Importa...

- Importa les alarmes des d'un fitxer de calendari extern al calendari seleccionat. Això es descriu en Importar alarmes de calendaris externs. Aquesta opció no està disponible per als calendaris deshabilitats o de només lectura.

Exporta...

- Exporta totes les alarmes en el calendari seleccionat a un fitxer de calendari extern. Això es descriu en Exportar alarmes a calendaris externs. Aquesta opció no està disponible per als calendaris deshabilitats.

Mostra els detalls

- Mostra els detalls quant al calendari seleccionat. Això mostrarà informació sobre la ubicació del calendari, el tipus d'emmagatzematge i l'estat.

Usa com a per omissió

- Fa que el calendari seleccionat sigui el calendari per omissió per al tipus de calendari seleccionat. Aquesta opció no està disponible per als calendaris deshabilitats o de només lectura.

Indica un color...

- Seleccioneu un color de fons per ressaltar les alarmes d'aquest calendari a la llista d'alarmes. Això us permetrà veure que les alarmes de pertanyen a un calendari determinat.

Neteja el color

- Neteja el color de ressaltat de les alarmes d'aquest calendari a la llista d'alarmes.

#### Importar alarmes de calendaris externs

Podeu importar alarmes des d'altres fitxers de calendari a &kalarm;. La funció d'importació escaneja el fitxer de calendari seleccionat per a esdeveniments que continguin alarmes, i els copia (amb els nous ID únics) al calendari de &kalarm;. Esdeveniments sense alarmes, i entrades de calendari que no siguin esdeveniments, seran ignorades. Hi ha dues maneres d'importar-les:

- Utilitzeu Fitxer Importa les alarmes... per importar les alarmes de tot tipus (alarmes actives, alarmes arxivades i plantilles d'alarma) del calendari.

  Si heu configurat calendaris d'alarma, les alarmes de cada tipus s'afegiran al calendari per omissió adequat, o si s'ha seleccionat l'opció de preguntar per les noves alarmes i plantilles en el diàleg de configuració, se us demanarà pel calendari a utilitzar.

- Feu clic dret sobre un calendari a la llista de calendaris, i escolliu Importa... al menú contextual. Això importa les alarmes del tipus seleccionat a aquest calendari. Per exemple, si el tipus de calendari seleccionat és plantilles d'alarma, les plantilles d'alarma (i no les alarmes actives o les alarmes arxivades) seran importades.

Si importeu alarmes de fitxers de calendari creades per altres aplicacions que &kalarm;, les alarmes podran ser modificades pel procés d'importació –fins i tot els temps d'alarma poden canviar–. Això dependrà de les convencions d'emmagatzematge de dades utilitzades per l'altra aplicació, i és inevitable si els convenis difereixen del que espera &kalarm;. Verifiqueu sempre les alarmes importades per canvis inesperats, i ajusteu-les d'acord a les vostres necessitats.

#### Exportar alarmes a calendaris externs

Podeu exportar les alarmes de &kalarm; a altres fitxers de calendari, ja sigui de les alarmes seleccionades a la llista d'alarmes, o totes les alarmes d'un calendari d'alarma. Els mètodes per fer-ho són els següents. Independentment del mètode utilitzat, podeu crear un fitxer de calendari nou o afegir les alarmes exportades a un fitxer de calendari existent. Per afegir-les, marqueu Annexa a un fitxer existent en el diàleg de selecció de fitxers; en cas contrari, se sobreescriurà qualsevol fitxer existent.

- Per exportar les alarmes actualment seleccionades a la llista d'alarmes, feu clic dret sobre la selecció i escolliu Exporta... al menú contextual, o utilitzeu Fitxer Exporta les alarmes seleccionades... al menú principal.

- Per exportar totes les alarmes des d'un calendari, feu clic dret sobre un calendari a la llista de calendaris, i escolliu Exporta... al menú contextual.

#### Importar dates de naixement des de &kaddressbook;

Podeu definir les alarmes visuals per a dates de naixement desades en &kaddressbook;, per Fitxer Importa les dates de naixement.... Això mostrarà un diàleg que us permetrà seleccionar per a quines dates de naixement crear alarmes.

- En el grup de caselles Text de l'alarma, podeu definir el text que es mostrarà en els missatges d'alarma de data de naixement. El text del missatge es crea mitjançant la combinació de text de Prefix seguit del nom de la persona seguit del text de Sufix. No s'afegeixen espais, de manera que recordeu incloure qualsevol espai necessari al final de Prefix i al començament de Sufix.

  Si canvieu el text de l'alarma, la llista de selecció de la data de naixement es tornarà a avaluar.

- A la llista Selecció de les dates de naixement, seleccioneu les dates de naixement per a les que voleu crear alarmes. Tingueu en compte que la llista només mostra les entrades de &kaddressbook; que continguin una data de naixement i que encara no té una alarma en el format definit actualment en el grup de caselles Text de l'alarma.

- La resta de controls són els mateixos que per a les alarmes de Text en el diàleg d'edició de l'alarma.

Si heu configurat els calendaris d'alarma, les alarmes s'afegiran al calendari d'alarmes actiu per omissió, o si s'ha seleccionat l'opció de preguntar per les noves alarmes i plantilles en el diàleg de configuració, se us demanarà pel calendari a utilitzar.

#### Desfer/refer

Podeu desfer i refer els canvis més recents realitzats durant la sessió actual de &kalarm;. La majoria de les accions es poden desfer, inclosa la creació, edició i supressió de les alarmes i les plantilles d'alarma, i la reactivació de les alarmes. Per evitar l'ús excessius de recursos per part de l'historial de desfer, el nombre de canvis emmagatzemats es limita als últims 12.

Per desfer l'últim canvi, seleccioneu Edita Desfés. Per refer l'últim canvi que s'ha desfet, seleccioneu Edita Refés .

Per desfer un canvi que no sigui l'últim, feu clic al botó Desfés a la barra d'eines i manteniu premut el botó del ratolí. Es mostrarà una llista d'accions des del qual podreu escollir l'acció a desfer. Si no veieu l'acció que esteu cercant, recordeu que primer podríeu necessitar desfer els canvis més recents, dels que depèn el canvi desitjat. Per exemple, podeu editar una alarma i després suprimir-la, no podreu desfer l'edició fins que no haver desfet la supressió.

Refer un canvi que no sigui l'últim es pot fer d'una manera similar, utilitzant el botó Refés de la barra d'eines.

### El diàleg d'edició de l'alarma

El diàleg d'edició de l'alarma us permet veure i editar una alarma. La primera vegada que utilitzeu &kalarm;, es mostrarà una forma simplificada del diàleg, amb només un petit nombre d'opcions visibles. Per veure-les totes, feu clic al botó Més opcions; per tornar al diàleg simplificat, feu clic al botó Menys opcions. &kalarm; recorda sempre la vostra última elecció cada vegada que es torna a mostrar el diàleg d'edició de l'alarma.

Podeu configurar els valors per omissió de moltes de les opcions en el diàleg d'edició de l'alarma utilitzant la pestanya Edita del diàleg de configuració.

Captura de pantalla del diàleg d'edició de l'alarma simplificat El diàleg d'edició de l'alarma simplificat per a una alarma visual

El diàleg d'edició de l'alarma simplificat per a una alarma visual

Captura de pantalla del diàleg d'edició de l'alarma mostrant totes les opcions El diàleg d'edició de l'alarma per a una alarma visual, mostrant totes les opcions

El diàleg d'edició de l'alarma per a una alarma visual, mostrant totes les opcions

#### Acció de l'alarma

Els controls en el grup de caselles Acció varien en funció del tipus d'alarma que s'està editant.

##### Alarmes visuals

Les alarmes visuals mostraran una finestra quan s'activi l'alarma. Seleccioneu el mètode utilitzat per generar el contingut de la finestra de l'alarma, utilitzant el quadre combinat a la part superior:

- Missatge de text per tal d'introduir un text de missatge d'alarma (el qual podrà incloure salts de línia) al quadre d'edició.

- Contingut del fitxer per introduir el camí o &URL; d'un fitxer de text o d'imatge el contingut del qual serà mostrat en el missatge d'alarma. Utilitzeu el botó al costat del quadre d'edició per mostrar un diàleg de selecció de fitxers. L'opció Pronuncia no està disponible per a aquest tipus d'alarma.

- Sortida de l'ordre per especificar que el text del missatge d'alarma serà generat per una ordre que s'executa quan s'activa l'alarma. Veure Alarmes d'ordre per als detalls sobre com introduir l'ordre o script d'ordres a executar.

Els controls disponibles per a les alarmes visuals són:

- L'opció So permet seleccionar si ha de sonar l'alarma quan es mostri el missatge d'alarma. Escolliu:

  - Cap per a mostrar l'alarma silenciosament.

  - Timbre per a que soni un timbre.

  - Pronuncia per a que el missatge d'alarma sigui parlat alhora que es mostra. Aquesta opció només estarà disponible si heu instal·lat i configurat el &jovie; (del paquet kdeaccessibility), juntament amb un sintetitzador de veu compatible, &pex;, Festival.

  - Fitxer de so per a reproduir un fitxer d'àudio. Utilitzeu el botó de la dreta per a mostrar el diàleg de fitxer de so que us permetrà seleccionar un fitxer per reproduir i configurar el volum i les opcions de repetició. Si passeu el ratolí sobre el selector, un consell d'eina mostrarà el fitxer d'àudio seleccionat.

    En el diàleg fitxer de so:

    - Escriviu el camí del fitxer de so o utilitzeu el botó al costat del quadre d'edició per mostrar un diàleg de selecció de fitxers. Podeu escoltar el fitxer seleccionat, feu clic al botó de reproducció a l'esquerra del camp d'edició. Aquest botó canvia la funció per a permetre-us aturar la reproducció.

    - Marqueu Repetició per a repetir contínuament el fitxer d'àudio durant el temps que es mostri l'alarma. (La finestra de missatge d'alarma conté un botó per aturar la reproducció del so per si necessiteu silenci, però encara es mostrarà l'alarma).

    - Marqueu Volum i ajusteu el control lliscant si voleu ajustar el volum del fitxer d'àudio reproduït.

    - Si ho voleu, pot fer esvair el volum. Significa començar la reproducció a un volum a nivell normal i poc a poc fer-lo minvar fins al final, en un interval de temps especificat. El volum final és introduït en Estableix el volum. Per habilitar l'esvaïment, marqueu Esvaïment, i després introduïu el seu període en segons al camp Temps d'esvaïment, i ajusteu el control lliscant Volum inicial.

    Podeu utilitzar el botó Prova per provar els nivells de so seleccionats.

- Utilitzeu el botó Tipus de lletra i color... per a seleccionar un tipus de lletra, i els colors del frontal i de fons, per al missatge d'alarma. En el diàleg Escolliu el tipus de lletra i color de l'alarma, marqueu Usa el tipus de lletra per omissió per mostrar el missatge en qualsevol tipus de lletra configurat com a per omissió en el moment en què es mostri el missatge. Per escollir un tipus de lletra específic per al missatge, desmarqueu Usa el tipus de lletra per omissió. (El tipus de lletra per omissió i els colors es poden establir en el diàleg de configuració).

  Els colors seleccionats es mostraran en el camp entrada de text del missatge d'alarma.

- Utilitzeu el botó Accions especials... per especificar ordres de l'intèrpret d'ordres a executar abans o després de mostrar l'alarma. Al diàleg Accions especials de l'alarma:

  - En el camp Acció de pre-alarma, introduïu una ordre de línia d'ordres a executar abans de mostrar l'alarma. Tingueu en compte que &kalarm; esperarà que es completi l'ordre abans de mostrar l'alarma.

    Una acció de pre-alarma només s'executa una vegada, quan el missatge d'alarma es mostra inicialment, fins i tot quan un missatge de recordatori és substituït pel missatge d'alarma real. No s'executa en cap de les següents circumstàncies:

    - Quan es mostri un missatge de recordatori.

    - Quan es torni a mostrar el missatge després de posposar l'alarma, a menys Executa per a les alarmes ajornades estigui marcada.

    - Quan s'estava mostrant el missatge en el moment d'accedir a la sessió i es restaura després, quan torneu a accedir.

    - Quan s'activi una alarma que es repeteix (o un missatge d'alarma diferida) però encara és visible el missatge d'alarma des d'una ocurrència anterior; en altres paraules, quan l'anterior ocurrència de l'alarma encara no ha estat reconeguda.

    L'acció de pre-alarma es pot utilitzar per controlar si es mostrarà el missatge d'alarma:

    - Marqueu Cancel·la l'alarma en cas d'error per a cancel·lar l'alarma si l'ordre de pre-alarma torna un estat d'error. Això evitarà que el missatge d'alarma a mostrar, i qualsevol acció de post-alarma sigui executada.

    - Normalment, si l'ordre de pre-alarma retorna un error, es mostrarà un missatge d'error i una indicació d'error es mostra a la llista d'alarmes. Aquestes notificacions d'error es poden prevenir marcant No notificar els errors.

  - En el camp Acció de post-alarma, introduïu l'ordre a executar quan reconegueu l'alarma (bé feu clic a Tanca o utilitzeu el botó de tancar a la barra de títol de la finestra). No s'executarà en qualsevol de les següents circumstàncies:

    - Quan es tanca un missatge de recordatori.

    - En posposar l'alarma, excepte quan l'alarma ajornada és finalment reconeguda.

    - Quan es tanca el missatge d'alarma a causa de sortir de la sessió.

  Veure Alarmes d'ordre a continuació per als detalls sobre com s'executen les ordres a la línia d'ordres.

##### Alarmes d'ordre

Les alarmes d'ordre executen una ordre sense mostrar cap missatge d'alarma.

Aquest tipus d'alarma no està disponible si s'executa el &kde; en el mode kiosk.

Quan s'executa l'ordre, la variable d'entorn `KALARM_UID` contindrà l'UID de l'esdeveniment per a l'alarma. Tingueu en compte que quan s'executa l'ordre des del botó Prova en el diàleg d'edició de l'alarma, el `KALARM_UID` restarà en blanc si es tracta d'una alarma nova, o si l'alarma ha estat modificada en el diàleg, ja que l'alarma només adquireix un UID quan es desa en el calendari d'alarmes.

Els controls disponibles per a les alarmes d'ordre són els següents:

- La casella de selecció Introduïu un script us permet escollir introduir una ordre de línia d'ordres o un script.

  Si aquesta opció està sense marcar, podreu introduir una ordre de línia d'ordres a executar. L'ordre es passa directament a l'intèrpret d'ordres per omissió (definit per la variable d'entorn `SHELL`), i pot incloure qualsevol opció, paràmetres, canonades, &etc; permeses per la línia d'ordres en una sola línia.

  Si aquesta opció està marcada, podeu introduir el text d'un script a executar. Recordeu incloure a l'script una primera línia com `#!/bin/bash` per assegurar-vos que s'invoca l'intèrpret d'ordres correcte.

- Utilitzeu el grup de caselles Sortida de l'ordre per especificar el que voleu fer amb qualsevol sortida de terminal que produeixi l'ordre quan s'executi.

  - Marqueu Executa en una finestra de terminal per fer que l'ordre s'executi en una finestra de terminal. Podeu escollir quin tipus de finestra de terminal s'ha d'utilitzar en el diàleg de configuració.

  - Marqueu Registra a un fitxer per desar la sortida de l'ordre en un fitxer. La sortida, precedida per un títol mostrarà el moment en què estava programat executar l'ordre, s'afegirà al contingut existent del fitxer. Introduïu el nom de fitxer en el quadre d'edició, o utilitzeu el botó al costat del quadre d'edició per mostrar un diàleg de selecció de fitxers.

  - Marqueu Descarta per a descartar la sortida de l'ordre.

##### Alarmes de correu

Les alarmes de correu electrònic envien un correu electrònic sense mostrar cap missatge d'alarma.

Ompliu les adreces dels destinataris, l'assumpte del correu electrònic i el cos del missatge en els tres camps d'edició. Utilitzeu el botó al costat del quadre d'edició del destinatari per veure la vostra llibreta d'adreces del &kde; des de la qual podreu seleccionar els destinataris del correu electrònic. Es poden afegir adjunts utilitzant el botó Afegeix.... Tingueu en compte que els adjunts hauran d'existir quan s'activi l'alarma, no s'emmagatzemarà cap còpia en el moment de configurar l'alarma. Per esborrar un fitxer, seleccioneu-lo a la llista desplegable i feu clic al botó Elimina.

Establiu les següents opcions:

- El quadre combinat A us permet seleccionar quina identitat de &kmail; utilitzar per a l'enviament del correu electrònic. Aquesta opció només apareix si la vostra adreça de correu electrònic A al diàleg de configuració està establerta a Usa les identitats del &kmail;. En cas contrari la vostra adreça de correu estarà preestablerta en el diàleg de configuració, el que farà inaplicable aquesta opció.

- Marqueu Còpia del correu a mi mateix per enviar una còpia oculta del correu a vos mateix quan s'activi l'alarma. L'adreça de correu electrònic a la qual es va enviar la còpia es pot establir en el diàleg de configuració, el valor per omissió serà l'adreça de correu electrònic configurada en l'Arranjament del sistema del &kde;.

##### Alarmes d'àudio

Les alarmes d'àudio reprodueixen un fitxer d'àudio sense mostrar cap missatge d'alarma.

Establiu les següents opcions:

- Introduïu el camí del fitxer de so o utilitzeu el botó al costat del quadre d'edició per mostrar un diàleg de selecció de fitxers.

- Marqueu Repetició per repetir contínuament el fitxer d'àudio fins que se seleccioni l'opció Atura la reproducció. Per aturar la reproducció del fitxer, també podeu seleccionar l'opció de menú Accions Atura la reproducció, o fer clic dret sobre la icona de la safata del sistema i escollir Atura la reproducció al menú contextual. Si ho voleu, podeu configurar una drecera de teclat global per a aquesta acció.

- Marqueu Volum i ajusteu el control lliscant si voleu ajustar el volum del fitxer d'àudio reproduït.

- Si ho voleu, pot fer esvair el volum. Significa començar la reproducció a un volum a nivell normal i poc a poc fer-lo minvar fins al final, en un interval de temps especificat. El volum final és introduït en Estableix el volum. Per habilitar l'esvaïment, marqueu Esvaïment, i després introduïu el seu període en segons al camp Temps d'esvaïment, i ajusteu el control lliscant Volum inicial.

#### Ajornament

Si l'alarma és una alarma que es repeteix i que es va ajornar després de l'última vegada que es va mostrar, el grup de caselles Alarma ajornada mostrarà l'hora en que es va ajornar l'alarma. Canvia... mostrarà un diàleg que us permetrà canviar l'hora d'ajornament o cancel·lar-la.

#### Hora

En el grup de caselles Hora, seleccioneu qualsevol de les dues:

- A la data i hora introduïu la data i hora a la que cal activar l'alarma. Marqueu Qualsevol hora si voleu especificar només una data per a l'alarma: en aquest cas, l'alarma es mostrarà a la primera oportunitat a partir de l'hora d'inici del dia configurada, en la data especificada. (Configurar &kalarm; descriu com configurar el temps d'inici del dia).

  Per a una alarma que no recurrent, la data/hora que s'introdueixi haurà de ser en el futur, o si s'introdueix només una data podrà ser avui o més tard. Per a una alarma que es repeteix, no hi ha restriccions d'aquest tipus ja que la data/hora d'inici s'ajusta automàticament a la primera recurrència de venciment després de l'hora actual.

- Temps des d'ara per introduir quant temps després d'avui (en hores i minuts) s'activarà l'alarma.

Si ho voleu, escolliu una zona horària per aplicar a l'alarma. Aquesta s'utilitzarà per a totes les dates i hores en relació amb aquesta alarma, incloent les dates i hores de recurrència i excepció. Normalment, haureu d'abandonar els controls de la zona horària sense canvis a menys que tingueu una bona raó per canviar-la.

Els controls de la zona horària només es mostren quan la zona horària seleccionada és diferent de la zona horària per omissió establerta en el diàleg de configuració, o si feu clic al botó Zona horària....

- En el quadre combinat, escolliu la zona horària que ha d'utilitzar aquesta alarma. En crear una nova alarma, aquesta s'establirà inicialment a la zona horària seleccionada en el diàleg de configuració, que serà la zona horària del vostre ordinador a menys que s'hagi canviat.

- Marqueu Ignora la zona horària si voleu utilitzar l'hora de l'ordinador local (en qualsevol ordinador &kalarm; passa a estar en execució en aquell moment), fent cas omís de les zones horàries.

  No és recomanable usar aquesta opció si l'alarma té una recurrència especificada en hores i minuts. Si ho feu, l'alarma pot activar-se en hores inesperades després d'un canvi d'horari d'estiu.

#### Recordatori

Per a una alarma visual, marqueu Recordatori si voleu mostrar un recordatori, ja sigui abans o després de l'alarma principal i cadascuna de les seves repeticions (si n'hi ha). Introduïu quant temps abans o després, amb els controls d'edició al costat de la casella de selecció. Tingueu en compte que si l'alarma és recurrent, el període de recordatori normalment es limita a ser menor que l'interval de recurrència o de sub-repetició.

Els recordatoris no es mostren per a les sub-repeticions dins d'una recurrència. Els recordatoris només es mostren per a cada repetició de l'alarma principal.

Si l'alarma és recurrent, marqueu Recordatori només per a la primera recurrència si només voleu un recordatori per a la primera repetició de l'alarma. Si marqueu aquesta opció, i és un recordatori abans, el període de recordatori que no estarà subjecte als límits normals de ser menys que l'interval de recurrència o de sub-repetició.

#### Cancel·lar

Les opcions finals de cancel·lació de l'alarma determinen com és tractarà després de l'hora programada:

- La casella de selecció Cancel·la si ja és tard determina el que passarà si l'alarma no es pot activar en la seva hora programada.

  Marqueu aquesta casella per cancel·lar l'alarma si no es pot activar dins d'un període de temps especificat després de l'hora correcta. El període de temps se selecciona mitjançant els controls que apareixen quan marqueu la casella. Per exemple, si introduïu un període de temps d'1 hora, l'alarma s'activarà en la primera oportunitat una hora després del venciment, però si no es pot activar dins d'una hora la seva activació serà cancel·lada.

  El retard en les alarmes de només data, &ead;, les que tenen activada l'opció Qualsevol hora, es calcula a partir de l'hora d'inici del dia sobre la data programada per a l'alarma.

  Deixeu la casella sense marcar per activar l'alarma a la primera oportunitat a partir de l'hora programada, sense importar quan temps hagi transcorregut.

  Una alarma només es pot activar mentre esteu en una sessió, i amb les X i &kalarm; en execució.

- Marqueu Tanca la finestra automàticament després d'aquest temps si voleu que la finestra de l'alarma es tanqui automàticament si encara s'està mostrant quan s'abasti l'hora final de cancel·lació de l'alarma.

#### Recurrència

Especifiqueu si voleu o com s'haurà de repetir l'alarma utilitzant la pestanya Recurrència.

Les característiques bàsiques de repetició de l'alarma es mostren per comoditat en el títol de la pestanya Recurrència. Primer es mostra l'interval de recurrència, seguit per l'interval de la sub-repetició establert mitjançant el botó Sub-repetició.

En el grup de caselles Regla de recurrència, s'estableix el tipus de recurrència o període de temps com segueix:

- Per activar l'alarma un única vegada, seleccioneu Sense recurrència.

- Seleccioneu En entrar per activar l'alarma cada vegada que accediu, fins a la seva hora de finalització programada. Després, a la seva hora de finalització programada finalment s'activarà un cop més. (Tingueu en compte que una alarma repetida a l'inici de sessió també s'activarà cada vegada que reinicieu &kalarm;).

- Per fer que l'alarma es repeteixi a intervals regulars, seleccioneu un dels tipus període de temps i després introduïu en el quadre Repeteix cada quants períodes de temps han de transcórrer entre les repeticions. Per exemple, per repetir cada dues setmanes, podeu seleccionar Diària i introduir en un valor de 14, o seleccionar Setmanal i introduir un valor de 2. Depenent del tipus de període de temps seleccionat, pot ser que tingueu altres opcions:

  - Per a una recurrència setmanal, marqueu tots els dies de la setmana en què voleu activar l'alarma.

  - Per a una recurrència mensual, podeu seleccionar una data fixa, o una posició (&pex;, el segon dimarts).

  - Per a una recurrència anual, podeu seleccionar un dia fix al mes, o una posició en un mes (&pex;, l'últim dissabte de maig). Marqueu cada mes de l'any en què voleu activar l'alarma.

    Si definiu una recurrència anual per al 29 de febrer, podreu especificar com s'haurà de manejar en anys que no siguin de traspàs, seleccionant l'opció corresponent Alarma el 29 de febrer als anys que no siguin de traspàs:

    - Cap: l'alarma s'activarà el 29 de febrer en els anys de traspàs, però serà suprimida en els anys que no siguin de traspàs.

    - 28 de febrer: l'alarma s'activarà el 29 de febrer en els anys de traspàs, i el 28 de febrer en anys que no siguin de traspàs.

    - 1 de març: l'alarma s'activarà el 29 de febrer en els anys de traspàs, i l'1 de març en anys que no siguin de traspàs.

  Per ajustar l'alarma diària a activar-se només de dilluns a divendres, utilitzeu una recurrència setmanal i marqueu cada dia laboral de la setmana.

En el grup de caselles Fi de la recurrència, s'estableix l'hora final de la recurrència com segueix:

- Seleccioneu Sense fi per a continuar les repeticions indefinidament.

- Seleccioneu Finalitza després de per especificar el nombre total d'ocurrències de l'alarma.

- Seleccioneu Finalitza el per especificar la data/hora fins que s'ha de repetir l'alarma. Tingueu en compte que utilitza la mateixa zona horària que l'hora d'inici de l'alarma.

  La data/hora de finalització determina el moment en que s'activi l'última recurrència principal, però no limita les sub-repeticions. Si es configuren, s'activaran normalment després de l'última recurrència principal, independentment de la data/hora de finalització.

El grup de caselles Excepcions us permet excloure certes dates/hores de la recurrència que heu configurat. Tingueu en compte que aquests controls no es mostren en la forma abreujada del diàleg d'edició de l'alarma: per veure'ls, feu clic a Més opcions.

- La llista d'excepcions (&ead;, dates/hores excloses) es mostra a l'esquerra. Per afegir una nova excepció, introduïu una data a la dreta i premeu Afegeix. Per canviar una excepció, seleccioneu-la a la llista, introduïu la nova data a la dreta i premeu Canvia. Per eliminar una excepció, ressalteu-la a la llista i premeu Elimina.

- Podeu restringir una alarma per a que no s'activi en dies festius marcant Exclou els festius. Això no canvia la manera com està programada l'alarma, sinó que simplement suprimeix l'alarma cada vegada que li toca activar-se en un dia festiu. Podeu seleccionar el vostre país o regió per a les vacances en el diàleg de configuració.

- Podeu restringir una alarma per a que només s'activi durant la jornada laboral marcant Només durant l'horari de treball. Això no canvia la manera com està programada l'alarma, sinó que simplement suprimeix l'alarma cada vegada que li toca activar-se fora de l'horari de treball. Els dies i horari de treball s'estableixen en el diàleg de configuració.

##### Sub-repetició

Podeu utilitzar el botó Sub-repetició per a configurar una repetició dins d'una repetició. En aquest cas, cada vegada que l'alarma faci com se li especifica a la recurrència principal, en lloc d'activar-se un cop ho farà en repetides ocasions d'acord amb les especificacions de la sub-repetició. Per exemple, per configurar una alarma que es repeteix cada hora des del migdia fins a les 18:00 de cada dijous, establireu una repetició setmanal el dijous a les 12:00, i utilitzareu el diàleg de sub-repetició per especificar un interval d'1 hora i o bé un compte de 6 o bé una durada de 6 hores.

Al diàleg Sub-repetició mostrat en fer clic al botó Sub-repetició, marqueu Repeteix cada per establir una repetició, o desmarqueu-la per eliminar la repetició. Si marqueu Repeteix cada, establireu la repetició com segueix:

- Introduïu l'interval de temps entre les repeticions en els controls al costat de Repeteix cada. Seleccioneu les unitats de temps que vulgui (per exemple, dies) i després introduïu el nombre d'unitats.

- Especifica el nombre de repeticions o la seva durada:

  - Seleccioneu Nombre de repeticions per introduir quantes vegades s'activarà després de la recurrència principal. Així, per exemple, per fer que l'alarma s'activi 4 vegades en cada recurrència principal, &ead;, tres vegades més, haureu d'introduir 3.

  - Seleccioneu Durada per introduir el període de temps total durant el qual s'haurà de repetir l'alarma. No haurà de ser un múltiple exacte de l'interval de repetició, automàticament s'arrodoneix a la baixa quan feu clic a D'acord.

Per impedir el solapament de sub-repeticions per a la mateixa alarma, la durada d'una sub-repetició està limitada a ser menor que l'interval més llarg entre les recurrència principal. Cada vegada que l'alarma es repeteix tal com s'especifica a la recurrència principal, qualsevol sub-repetició encara activa que es va iniciar en la recurrència anterior serà automàticament cancel·lada.

#### Altres controls

Per a les alarmes visuals, la casella de selecció Confirma l'acceptació us permet especificar si se us demanarà confirmació en tancar la finestra de missatge d'alarma. Això es pot utilitzar com a salvaguarda contra el reconeixement accidental de les alarmes.

Seleccioneu Mostra al &korganizer; per afegir l'alarma al calendari actiu de &korganizer;, on apareixerà com un esdeveniment sense alarma. Aquesta opció permet realitzar un seguiment de les alarmes al &korganizer; mentre que seguiu fent ús de les funcions de &kalarm;.

Si posteriorment es modifica o suprimeix l'alarma al &kalarm;, l'esdeveniment de &korganizer; serà modificat o eliminat corresponentment. No obstant, si canvieu l'esdeveniment al &korganizer;, l'alarma al &kalarm; no es veurà afectada.

Premeu el botó Carrega la plantilla per seleccionar una plantilla per preestablir amb el diàleg, com es descriu a Crear i gestionar les alarmes.

Premeu el botó Prova per provar l'alarma i comprovar si funciona correctament. S'executarà com si s'hagués programat en la forma normal. En el cas d'una alarma d'àudio, premeu el botó Prova una segona vegada per aturar la reproducció del fitxer de so.

Premeu el botó D'acord quan totes les dades siguin correctes, per afegir l'alarma a la llista programada. Tingueu en compte que quan aneu a editar una alarma existent, el botó D'acord es trobarà inhabilitat mentre no es realitzi cap canvi.

### Finestra de missatge d'alarma

Quan venç un missatge d'alarma, es mostrarà a cada escriptori &kde; per assegurar que no us el perdeu. La finestra de missatges mostrarà el temps durant el qual s'ha programat l'alarma, de manera que podeu veure quan va sorgir si hereu fora de l'ordinador en aquell moment. Si el temps programat de l'alarma es troba en una zona horària diferent de la configuració del vostre ordinador local, també es mostrarà la zona horària. (Per als missatges de recordatori, la data/hora mostrada serà la prevista per a l'alarma principal o la seva recurrència, no la del missatge de recordatori, i el títol de la finestra serà Recordatori).

Les finestres dels missatges d'alarma romandran visibles fins que es reconeguin, llevat que Tanca la finestra automàticament després d'una cancel·lació retardada estigui marcada en el diàleg d'edició de l'alarma. En el cas d'una alarma que es repeteix, si romà una finestra de missatge no reconeguda d'una activació anterior de l'alarma, simplement apareixerà la finestra existent quan l'alarma sigui recurrent. Això evitarà haver de reconèixer diverses còpies del mateix missatge, cas que potser no voldreu.

La finestra de missatges d'alarma proporciona qualsevol de les següents opcions aplicables a l'alarma que es mostra:

- Reconèixer l'alarma fent clic al botó Tanca. Això tancarà la finestra (després d'un missatge de confirmació, si heu seleccionat Confirma l'acceptació).

- Editar l'alarma fent clic al botó Edita.... Això mostrarà el diàleg d'edició de l'alarma.

- Mostrar les opcions d'ajornar l'alarma fins més tard fent clic al botó Ajorna.... Llavors seleccioneu Ajorna fins a la data i hora per introduir la data i hora en què el missatge es tornarà a mostrar, o seleccioneu Ajorna durant un interval de temps per introduir quant temps després d'ara (en hores i minuts) s'haurà de mostrar de nou el missatge. Feu clic a D'acord per ajornar-la i tancar la seva finestra.

  L'hora a la que s'ajorni l'alarma haurà de ser anterior a la propera activació programada o següent recordatori avançat. Per aquesta raó, el ​botó ​Ajorna... a la finestra de missatge d'alarma i el botó D'acord en el diàleg d'ajornament es deshabiliten un minut abans de la propera activació o recordatori avançat.

  Tingueu en compte que si es configura un recordatori després de l'alarma, podríeu ajornar l'alarma més enllà del seu temps de recordatori. En aquest cas, el recordatori seria suprimit.

  El botó Ajorna... no estarà disponible per a les alarmes que es mostren en iniciar la sessió, a causa que s'ha seleccionat l'opció En iniciar la sessió.

- Aturar la reproducció dels fitxers de so de l'alarma fent clic al botó que mostra el símbol atura la reproducció.

- Si el missatge d'alarma es va crear arrossegant un correu electrònic des de &kmail;, podreu accedir directament al correu electrònic al &kmail;, feu clic al botó que mostra la icona de &kmail;. Això seleccionarà i ressaltarà el correu electrònic a la llista de carpetes de &kmail;.

  Si els índexs de &kmail; es regeneren, l'enllaç al correu electrònic de &kmail; es perdrà.

- El botó que mostra la icona de &kalarm; proporciona una manera convenient per activar &kalarm;.

Podeu escollir en el diàleg de configuració quina dels dos modes diferents s'haurà d'utilitzar per mostrar les finestres de missatges d'alarma:

- Com una finestra normal. En aquest mode, el focus del teclat pren la finestra de missatge d'alarma quan apareix, de manera que si esteu escrivint en aquest moment les pulsacions del teclat es desviaran a ella en comptes de a la vostra aplicació original.

- Com una finestra no modal. En aquest mode, el focus del teclat no es veurà afectat quan aparegui la finestra de missatge d'alarma, de manera que no interferirà amb la vostra escriptura. No obstant, en aquest mode la finestra no tindrà barra de títol o marc, per la qual cosa no la podreu moure o canviar-la de mida.

Quan es mostra una alarma al davant d'una aplicació a pantalla completa, es mostrarà com una finestra no modal, independentment d'aquesta configuració. Això es deu a una limitació del sistema de finestres.

#### Col·locar les finestres de missatges

Podeu escollir en el diàleg de configuració quin dels dos esquemes s'haurà d'utilitzar per a col·locar les finestres d'un missatge d'alarma:

- Les finestres es mostren tan lluny del cursor del ratolí com sigui possible. Això minimitza la interrupció del vostre flux de treball i minimitza la possibilitat de reconèixer accidentalment l'alarma.

- Les finestres es mostren en el centre de la pantalla. Per reduir el risc de reconèixer accidentalment l'alarma, els botons de la finestra seran deshabilitats inicialment, activant-se només després d'un retard configurable.

Si teniu diverses finestres de missatge d'alarma, o de missatges d'error, les podeu distribuir a través de la pantalla per a que totes siguin visibles, o agrupar-les a la part superior esquerra de la pantalla, mitjançant l'opció de menú Visualitza Separa les finestres . Si voleu, podeu configurar una tecla de drecera global per a aquesta acció.

### Funcionament de la safata del sistema

&kalarm; per omissió mostra una icona a la safata del sistema. La icona proporciona control i una indicació d'estat per a gestionar les alarmes. Una icona normal de &kalarm; indica que les alarmes s'estan monitoritzant, mentre que una icona gris indica que les alarmes no s'estan monitoritzant. Si algunes de les alarmes individuals estan deshabilitades, ho indicarà una petita creu superposada sobre la icona.

La icona de la safata del sistema de &kalarm; per omissió resta oculta automàticament sempre que no hi ha alarmes vençudes en les properes 24 hores. Podeu canviar el límit de temps d'ocultació automàtica, o mostrar sempre la icona de la safata del sistema, utilitzant el diàleg de configuració. Per a mostrar la icona quan està oculta, feu clic a la fletxa de la safata del sistema per a mostrar les icones ocultes.

Si passeu el cursor del ratolí sobre la icona de la safata del sistema, es mostrarà un resum de les primeres alarmes de missatge que vencen en les pròximes 24 hores com un consell d'eina. Podeu desactivar aquesta característica, o configurar el nombre d'alarmes a mostrar i el seu format, en el diàleg de configuració.

Feu clic esquerre sobre la icona de la safata del sistema per alternar entre mostra i oculta la finestra principal de &kalarm;.

Feu clic dret sobre la icona de la safata del sistema per veure el menú contextual:

Habilita les alarmes

- Habilita o deshabilita el control de canvi de les alarmes.

  Veure Habilitar i deshabilitar les alarmes per a més detalls.

Alarma nova

- Després que seleccioneu el tipus d'alarma de la llista que apareix, s'obrirà el diàleg d'edició de l'alarma per crear una nova alarma.

Atura la reproducció

- Atura la reproducció del fitxer d'àudio que s'està reproduint.

Separa les finestres

- Separa les finestres d'alarma i de missatge d'error al llarg de la pantalla, o les agrupa.

Configura &kalarm;...

- Mostra el diàleg de configuració de &kalarm;.

  El diàleg de configuració es descriu en Configurar &kalarm;. Inclou les opcions relatives a la icona de la safata del sistema de &kalarm;.

Restaura/Minimitza

- Restaura o minimitza la finestra principal de &kalarm;.

Surt

- Tanca la safata del sistema i la finestra principal de &kalarm;.

  Surt de &kalarm; si no s'estan mostrant finestres de missatges d'alarma.

#### Mostrar &kalarm; a la safata del sistema

Haureu d'estar executant l'escriptori &kde; o un altre gestor de finestres adequat per mostrar &kalarm; a la safata del sistema.

Select Visualitza Mostra a la safata del sistema per mostrar &kalarm; a la safata del sistema d'acord amb les preferències establertes a la pestanya Visualitza del diàleg de configuració.

Per treure &kalarm; de la safata del sistema, deseleccioneu Visualitza Mostra a la safata del sistema.

Per escollir si &kalarm; es mostrarà a l'inici a la safata del sistema, utilitzeu la pestanya Vista del diàleg de configuració.

### Refrescar les alarmes

En el cas improbable que una alarma no s'activi quan ho hauria de fer, podeu refrescar la llista d'alarmes i activar les alarmes que faltin seleccionant Accions Refresca les alarmes . Això farà que &kalarm; torni a carregar tots els calendaris d'alarma.

Podeu tornar a carregar un calendari individual i refrescar les alarmes a la llista d'alarmes fent clic dret al calendari a la llista de calendaris i seleccionant l'opció de menú Torna a carregar. Veure Calendaris d'alarma per a més detalls.

### Habilitar i deshabilitar les alarmes

Les alarmes es poden habilitar i deshabilitar bé en conjunt o individualment:

- La monitorització d'alarmes s'aplica a les alarmes en conjunt. Mentre que la monitorització d'alarmes està deshabilitada, cap alarma serà activada. Mentre que la monitorització d'alarmes està habilitada (la situació normal), totes les alarmes que no estiguin deshabilitades individualment serà activada en el moment apropiat.

  Quan es torni a habilitar la monitorització d'alarmes, les que s'han activat mentre estaven deshabilitades s'activaran ara (a menys que qualsevol de les opcions de cancel·lació retardada ho impedeixi). En altres paraules, deshabilitar la monitorització d'alarmes té el mateix efecte que aturar &kalarm; –les alarmes es posposen fins que es torni a habilitar–.

- Les alarmes es poden habilitar i deshabilitar individualment, independentment de l'estat de la monitorització d'alarmes. Pel que l'estat habilitada/deshabilitada individual de les alarmes no es modificarà mitjançant la deshabilitació i tornar a habilitar la monitorització d'alarmes. A menys que la monitorització d'alarmes sigui deshabilitada a causa que &kalarm; no s'està executant, les alarmes individuals només es poden deshabilitar si s'utilitzen les ordres de menú.

  Quan una alarma es torna a habilitar individualment, no s'activarà si ha vençut mentre estava deshabilitada. En altres paraules, el deshabilitar una alarma individual cancel·la totes les seves ocurrències fins que es torni a habilitar.

  Un estat d'alarma individual d'habilitada/deshabilitada s'indica pel seu color a la llista d'alarmes (el color es pot configurar en la pestanya Vista del diàleg de configuració).

Per activar una alarma, s'haurà d'habilitar individualment, així com la monitorització d'alarmes haurà d'estar habilitada.

#### Habilitar la monitorització d'alarmes

Per a que ocorri la monitorització d'alarmes, &kalarm; haurà d'estar en execució. Una vegada executeu &kalarm;, serà a partir de llavors que s'iniciarà automàticament cada vegada que accediu a menys que la deshabiliteu a la pestanya General del diàleg de configuració.

Si la monitorització d'alarmes està deshabilitada, feu el següent per habilitar les alarmes:

- Seleccioneu Accions Habilita les alarmes.

- Feu clic dret sobre la icona de la safata del sistema i escolliu Habilita les alarmes al menú contextual.

#### Deshabilitar la monitorització d'alarmes

Podeu deshabilitar temporalment la monitorització d'alarmes, el qual evitarà que &kalarm; torni a mostrar cap alarma fins que les torneu a habilitar, o –si s'assumeix que &kalarm; està configurat per executar-se en iniciar la sessió– fins la propera vegada que inicieu la sessió.

- Deseleccioneu Accions Habilita les alarmes.

- Feu clic dret sobre la icona de la safata del sistema i deseleccioneu Habilita les alarmes al menú contextual.

- Executar &kalarm; amb l'opció `--disable-all` de la línia d'ordres.

- Aturar &kalarm; com es descriu en Sortir de &kalarm;.

Les alarmes es poden deshabilitar permanent evitant que &kalarm; s'executi en iniciar la sessió amb la pestanya General del diàleg de configuració.

#### Habilitar i deshabilitar individualment les alarmes

Per habilitar individualment les alarmes que estan deshabilitades, realitzeu una de les següents accions:

- Seleccioneu-ne una o més fent clic a les seves entrades a la llista d'alarmes. A continuació escolliu Accions Habilita .

- Feu clic dret sobre les entrades en qüestió a la llista d'alarmes i escolliu Habilita al menú contextual.

Per deshabilitar individualment les alarmes que estan actualment habilitades, realitzeu una de les següents accions:

- Seleccioneu-ne una o més fent clic a les seves entrades a la llista d'alarmes. A continuació escolliu Accions Deshabilita .

- Feu clic dret sobre les entrades en qüestió a la llista d'alarmes i escolliu Deshabilita al menú contextual.

### Despertar de l'estat de suspensió

És possible configurar una alarma seleccionada per a que quan s'activi desperti el vostre ordinador des de la hibernació o suspensió, de manera que l'acció de l'alarma pot ocórrer fins i tot quan el sistema està apagat. Aquesta funció és controlada per un diàleg al qual s'accedeix seleccionant Accions Activa després de la suspensió. El diàleg la permet establir, cancel·lar o mostrar.

L'ús de la funció activa després de la suspensió requereix privilegis administratius. Se us demanarà la contrasenya de l'usuari root quan establiu o cancel·leu una alarma d'aquest tipus.

Aquest tipus d'alarma no està suportada per alguns ordinadors, especialment els antics, i alguns que només suporten l'establiment d'una hora d'activació de fins a 24 hores d'antelació. També hi poden haver restriccions en la manera en que funciona el mode de suspensió. Haureu de considerar l'establiment d'alarmes de prova per comprovar la capacitat del vostre sistema abans de confiar en aquesta característica.

El vostre ordinador només pot programar una sola alarma d'aquest tipus. Si utilitzeu aquesta funció amb &kalarm;, us haureu d'assegurar que no entra en conflicte amb qualsevol altra aplicació que també utilitzi el mode de suspensió. Cada vegada que una aplicació programa o neteja aquest estat, això cancel·la qualsevol establiment d'aquest tipus establert prèviament, sense importar l'establert a &kalarm; o a qualsevol altra aplicació.

El diàleg Activació després de la suspensió s'utilitza conjuntament amb la llista d'alarmes a la finestra principal de &kalarm;.

- Usa l'alarma ressaltada: Estableix l'alarma ressaltada a la llista d'alarmes com l'alarma per activa després de la suspensió. Qualsevol alarma programada anteriorment serà cancel·lada, com s'ha explicat anteriorment. El botó només s'habilitarà si exactament es ressalta una única alarma.

- Cancel·la l'activació des de la suspensió: Cancel·la qualsevol alarma existent del mode de suspensió (ja sigui establert per &kalarm; o qualsevol altra aplicació -veure a dalt-). Tingueu en compte que això només cancel·la funció d'activació associada a l'alarma, la pròpia alarma no se suprimeix i continuarà operant de forma normal.

- Mostra l'alarma actual: Ressalta l'alarma de suspensió actual a la llista d'alarmes, de manera que es pugui identificar. El botó estarà deshabilitat si se n'ha configurat una.

- El control Nombre de minuts abans de l'alarma per activar des de la suspensió us permetrà, si així ho voleu, assegurar-vos que el sistema té temps per a si mateix per restablir-se completament abans que s'activi l'alarma, de manera que l'alarma podrà activar-se al moment correcte.

### Sortir de &kalarm;

Sortiu de &kalarm; seleccionant Fitxer Surt, o Surt al menú contextual de la icona de la safata del sistema. Alternativament, si la icona de la safata del sistema no està visible, tanqueu la finestra principal de &kalarm;.

## Configurar &kalarm;

Per configurar el funcionament de &kalarm; per adaptar-se al vostre sistema i les vostres preferències personals, seleccioneu Arranjament Configura &kalarm;.... Això mostrarà el diàleg de configuració.

### General

La secció General us permetrà controlar el comportament de &kalarm; en general:

- Inicia automàticament en iniciar la sessió: &kalarm; s'iniciarà automàticament en iniciar la sessió de &kde;, assegurant-vos que &kalarm; s'executa en tot moment a menys que sortiu manualment.

  Aquesta opció sempre s'haurà de marcar a menys que preteneu deixar d'usar &kalarm;.

  Aquesta opció es torna a seleccionar automàticament cada vegada que s'executi &kalarm;. De manera que si teniu sense marcar aquesta opció i voleu continuar amb evitar l'execució de &kalarm; en iniciar la sessió, necessitareu desmarcar-la cada vegada que executeu &kalarm;.

- Avisa abans de sortir: Quan les alarmes estan deshabilitades mentre &kalarm; no s'està executant, en seleccionar aquesta opció se us demanarà confirmació si intenteu finalitzar &kalarm; utilitzant l'opció Surt de la icona de la safata del sistema. Això previndrà la deshabilitació accidental de les alarmes. Per raons de seguretat, aquesta opció es torna a habilitar automàticament per omissió cada vegada que canvieu el mode d'execució.

- Confirma la supressió de les alarmes: Especifica si se us demanarà una confirmació cada vegada que suprimiu una alarma.

- Interval de temps per omissió d'ajornament de l'alarma: Introduïu l'interval de temps per omissió, en hores i minuts, per mostrar inicialment quan es mostri el diàleg d'alarma ajornada. Tingueu en compte que si s'ha ajornat una alarma anteriorment, l'interval que es mostra inicialment en el diàleg d'alarma ajornada serà igual que l'interval d'ajornament utilitzat l'última vegada que l'alarma es va ajornar.

- Terminal per a les alarmes d'ordre: Podeu seleccionar quin tipus de finestra de terminal utilitzar per a les alarmes d'ordre que s'executin en una finestra de terminal. Algunes de les aplicacions més comuns de finestra de terminal estan preconfigurades, &pex;, xterm, &konsole;, encara que només es mostraran aquelles que estiguin instal·lades al sistema. Podeu veure les opcions d'ordres utilitzades per a cada aplicació veient l'ajuda contextual per al seu botó d'opció.

  Si voleu utilitzar una altra aplicació, o si voleu utilitzar una de les llistades, però amb diferents opcions per a l'ordre, seleccioneu Altres i introduïu l'ordre per invocar la finestra de terminal. Per omissió, la cadena d'ordre de l'alarma s'afegirà al que especifiqueu. També podeu especificar a on s'inserirà la cadena d'ordre de l'alarma, utilitzant els següents codis:

  %c

- La cadena d'ordre de l'alarma que serà substituïda.

%w

- La cadena d'ordre de l'alarma que serà substituïda, amb un `sleep` afegit.

%C

- Es crearà un fitxer d'ordre temporal que contindrà la cadena d'ordre de l'alarma, i l'ordre per executar el fitxer que serà substituït.

%W

- Es crearà un fitxer d'ordre temporal que contindrà la cadena d'ordre de l'alarma amb un `sleep`, i l'ordre per executar el fitxer que serà substituït.

%t

- Serà substituïda pel nom del &kalarm; en l'idioma actual.

Quan s'activa l'alarma d'ordre, la seva cadena d'ordre es posarà entre cometes abans d'inserir-la a la línia d'ordres de la finestra de terminal.

### Hora i data

La secció de Data i hora us permet establir les opcions relacionades amb la data i hora:

- Zona horària: Seleccioneu la zona horària. &kalarm; l'utilitza per tot, excepte quan la substituïu individualment per a les alarmes.

- Regió per als dies festius: Seleccioneu quin país o regió utilitzar per als dies festius. Això afectarà a les alarmes recurrents que tenen activada l'opció d'excloure els festius.

- Inici de dia per a les alarmes per data: Estableix l'hora d'inici de la jornada per activar de només data, &ead;, aquelles per a les que es va seleccionar l'opció Qualsevol hora. A la data de venciment, aquestes alarmes s'activaran a la primera oportunitat durant les 24 hores a partir de l'hora d'inici del dia.

- Al grup de caselles Horari de treball: Aquestes opcions us permeten definir les vostres hores de treball, és necessari quan l'única se selecciona l'opció Només durant l'horari de treball per a una repetició en el diàleg d'edició de l'alarma.

  - Marqueu cada dia que sigui un dia de treball.

  - Hora d'inici del dia: Introduïu l'hora a la qual comenceu a treballar cada dia.

  - Hora final del dia: Introduïu l'hora a la qual acabeu el treball cada dia.

- Duració de l'esdeveniment del KOrganizer: Introduïu la durada de l'esdeveniment per establir en &korganizer; per a les alarmes que es copien a &korganizer;. La durada per omissió és zero.

### Emmagatzematge

La secció Emmagatzematge us permet escollir les opcions per a desar i arxivar les alarmes:

- Alarmes i plantilles noves: Especifiqueu quin calendari utilitzar per emmagatzemar les alarmes i plantilles d'alarma noves quan s'utilitzin diversos calendaris d'alarma:

  - Desa al calendari per omissió: Les alarmes i plantilles d'alarma noves s'afegiran automàticament al calendari d'alarma per omissió sense demanar confirmació.

  - Pregunta en quin calendari s'ha de desar: En crear una alarma o una plantilla d'alarma nova i hi haurà més d'un calendari d'alarma per escriure, se us demanarà que escolliu el calendari a on s'haurà de desar. Tingueu en compte que quan es desen les alarmes en el venciment, sempre s'emmagatzemen en el calendari d'alarmes arxivades per omissió sense preguntar.

- El grup de caselles Alarmes arxivades: Aquestes opcions controlen l'emmagatzematge de les alarmes arxivades en el calendari per omissió d'alarmes arxivades.

  - Mantén les alarmes després d'expirar: Seleccioneu aquesta opció per arxivar les alarmes expirades i suprimides. Deseleccioneu-la per a no desar cap registre de les alarmes una vegada deixen d'estar actives. Tingueu en compte que les alarmes suprimides només s'arxiven si han estat prèviament activades. Si suprimiu una alarma abans que s'activi, aquesta serà descartada.

  - Descarta les alarmes arxivades després de: Estableix el nombre de dies per emmagatzemar les alarmes expirades i suprimir-les a l'arxiu, després del qual se suprimiran definitivament.

  - Neteja les alarmes arxivades: Aquest botó descarta totes les alarmes actualment arxivades al calendari per omissió d'alarmes arxivades. (Els altres calendaris d'alarmes arxivades no seran modificats en el cas que es comparteixen amb altres persones). Això no té efecte sobre les alarmes que posteriorment expirin o se suprimeixin, sinó que se seguiran arxivant d'acord amb les opcions seleccionades.

### Correu electrònic

La secció Correu electrònic us permet escollir les opcions per enviar i adreçar les alarmes de correu electrònic:

- Client de correu: Especifiqueu el client de correu electrònic a utilitzar per enviar les alarmes de correu electrònic:

  - KMail: Quan s'activa una alarma de correu electrònic, aquest correu és enviat a través de &kmail; (el qual en primer lloc serà iniciat si cal) de la següent manera:

    - Si &kmail; és la versió 1.7 o posterior, el correu electrònic serà enviat automàticament.

    - Si &kmail; és una versió anterior, el correu electrònic serà afegit a la carpeta «`sortida`» del &kmail; per a la seva posterior transmissió.

  - Sendmail: Quan s'activa una alarma de correu electrònic, aquest correu és enviat automàticament a traves de &Sendmail;. Aquesta opció només funcionarà si el sistema està configurat per utilitzar &Sendmail;, o un agent de transport de correu compatible com postfix o qmail.

- Copia els correus enviats a la carpeta «enviats» del &kmail;: Seleccioneu aquesta opció si, cada vegada que s'activa una alarma de correu electrònic, voleu una còpia del correu electrònic enviat emmagatzemat a la carpeta «`enviats`» del &kmail;.

  Aquesta opció no està disponible si se selecciona &kmail; com a client de correu electrònic, ja que ho fa automàticament.

- Notifica quan es posin a la cua correus remots: Seleccioneu aquesta opció per mostrar una notificació quan una alarma de correu electrònic resti a la cua per enviar a un sistema remot. Això pot ser útil si, per exemple, teniu una connexió telefònica, o el correu electrònic es posa a la cua en la carpeta «`sortida`» del &kmail;, de manera que us podeu assegurar que fareu el necessari per transmetre efectivament el missatge.

- Seleccioneu la vostra adreça de correu electrònic a utilitzar com adreça del remitent en les alarmes de correu electrònic:

  - Seleccioneu De per introduir una adreça de correu electrònic.

  - Seleccioneu Usa l'adreça de l'Arranjament del sistema per utilitzar l'adreça de correu electrònic que està configurada a l'Arranjament del sistema del &kde;.

  - Seleccioneu Usa les identitats del &kmail; per poder triar en el moment de configurar una alarma de correu electrònic de &kmail;, quines identitats usar. La identitat per omissió del &kmail; serà la usada per a les alarmes que ja s'han configurat abans de seleccionar aquesta opció.

- Seleccioneu la vostra adreça de correu a utilitzar per enviar còpies ocultes de les alarmes de correu a tu mateix quan l'opció Còpia del correu a mi mateix estigui seleccionada:

  - Seleccioneu BCC per introduir una adreça de correu. Si les còpies ocultes es van enviar al vostre compte a l'ordinador on s'executa &kalarm;, simplement podeu introduir el vostre nom d'usuari aquí.

  - Seleccioneu Usa l'adreça de l'Arranjament del sistema per utilitzar l'adreça de correu electrònic que està configurada a l'Arranjament del sistema del &kde;.

### Vista

La secció Vista us permet controlar alguns aspectes de l'aparença de &kalarm;. A la pestanya General:

- El grup de caselles Mostra a la safata del sistema: Quan està seleccionada, la icona de la safata del sistema serà mostrada mentre s'executi &kalarm;, d'acord amb l'opció seleccionada:

  - Mostra sempre: La icona de la safata del sistema es mostrarà sempre.

  - Oculta automàticament si no hi ha alarmes actives: La icona de la safata del sistema restarà oculta si no hi ha alarmes actives.

  - Oculta automàticament si no vencen alarmes en el període de temps: La icona de la safata del sistema restarà oculta si no hi ha cap alarma vençuda dins del període de temps especificat, a partir d'ara.

  Quan la icona de la safata del sistema s'oculta automàticament, podreu fer-la visible a través de l'opció de la safata del sistema per mostrar les icones ocultes.

  Quan Mostra a la safata del sistema està seleccionat, el tancar la icona a la safata del sistema tancarà totes les finestres principals de &kalarm;, i si no hi ha finestres de missatges visibles, sortirà de l'aplicació.

- El grup de caselles Consell de la safata del sistema: Aquestes opcions controlen quina informació mostrar al consell que apareixerà quan passeu el cursor del ratolí sobre la icona de &kalarm; a la safata del sistema.

  - Mostra les alarmes per a les properes 24 hores: Quan se selecciona, es mostrarà un resum de les alarmes que vencin en les properes 24 hores.

  - Nombre màxim d'alarmes a mostrar: Deseleccioneu aquesta opció per mostrar totes les alarmes de les properes 24 hores. Seleccioneu-la per establir el nombre màxim d'alarmes que es mostraran.

  - Mostra l'hora de l'alarma: Seleccioneu aquesta opció per mostrar l'hora en què està programada cada alarma.

  - Mostra el temps restant fins a l'alarma: Seleccioneu aquesta opció per mostrar el temps restant abans de la següent ocurrència programada de cada alarma. El període de temps es mostra en hores i minuts.

    - Prefix: Especifiqueu un símbol o el text a mostrar davant de la quantitat de temps fins activar l'alarma, per distingir-la de l'hora a la qual està programada l'alarma.

- El grup de caselles Llista d'alarmes permet triar els colors utilitzats en la llista d'alarmes a la finestra principal de &kalarm;, per mostrar les alarmes deshabilitades i arxivades.

La pestanya Finestres d'alarma conté les opcions per controlar l'aparença de les finestres de missatge d'alarma.

- Col·loca les finestres lluny del cursor del ratolí: Seleccioneu aquesta opció per mostrar les finestres de missatges d'alarma el més lluny possible de la posició actual del cursor del ratolí. Això minimitza la possibilitat de reconèixer accidentalment una alarma fent clic en un botó de la mateixa a la finestra de missatge.

- Centra les finestres, retardant l'activació dels botons de la finestra: Seleccioneu aquesta opció per mostrar les finestres de missatges d'alarma al centre de la pantalla. Per reduir el risc d'accident en reconèixer l'alarma, els botons de la finestra són deshabilitats inicialment. El retard en segons abans que s'activin s'estableix a Retard de l'activació dels botons (en segons).

- Les finestres de missatge tenen una barra de títol i prenen el focus del teclat: Aquesta opció controla si les finestres de missatges d'alarma són modals o no, &ead;, si agafen el focus del teclat quan apareixen. Veure la secció Finestra de missatge d'alarma per a més detalls.

### Edita

La secció Edita us permet seleccionar els valors per omissió en les opcions en el diàleg d'edició de l'alarma:

- La pestanya General conté les opcions que s'apliquen a tots els tipus d'alarma.

  - Establir els estats per omissió per a les caselles de selecció Mostra al KOrganizer i Cancel·la si ja és tard.

  - Establir el tipus de repetició per omissió.

  - Seleccioneu el tractament per omissió en anys no de traspàs de recurrències anuals previstes per al 29 de febrer.

- La pestanya Tipus d'alarma conté les opcions que s'apliquen a tipus específics d'alarma.

  - Per a les alarmes visuals:

    - Establiu els estats per omissió per a les caselles de selecció Tanca la finestra automàticament després d'aquest temps i Confirma l'acceptació.

    - Establiu les unitats de període per omissió pel recordatori.

    - Establiu les accions especials per omissió per a les alarmes visuals.

    - Establiu les opcions de so per omissió. Tingueu en compte que s'ha d'indicar un fitxer de so per omissió, encara que el tipus de so no estigui establert a Fitxer de so.

  - Per a les alarmes d'ordre:

    - Establiu els estats per omissió per a les caselles de selecció Introduïu un script i Executa en una finestra de terminal.

  - Per a les alarmes de correu electrònic:

    - Establiu l'estat per omissió per a la casella de selecció Còpia del correu a mi mateix.

- La pestanya Tipus de lletra i color us permet establir l'aparença per omissió dels missatges d'alarma. Seleccioneu el vostre tipus de lletra per omissió, i els colors de primer pla i de fons.

## Operació de la línia d'ordres

Quan s'indiquen paràmetres de línia d'ordres, &kalarm; no mostrarà la llista d'alarmes programades com s'ha descrit anteriorment a Usar &kalarm;. Les opcions específiques de la línia d'ordres per a &kalarm; es poden utilitzar per a les següents operacions:

- programar una alarma nova

- controlar el mode visual de &kalarm;

- obtenir ajuda

Les opcions addicionals de línia d'ordres es proporcionen principalment per habilitar altres programes a la interfície de &kalarm;. Es descriuen en el capítol Guia de &kalarm; per a desenvolupadors.

La línia d'ordres només ha de contenir les opcions aplicables per a una operació de &kalarm;. Si voleu realitzar operacions múltiples, s'ha d'invocar múltiples vegades &kalarm; amb un sol conjunt d'opcions cada vegada.

### Programar una alarma nova

Les següents opcions s'utilitzen per a programar una nova alarma:

Opció | Descripció
`-a`, `--ack-confirm` | Missatge de confirmació quan el missatge d'alarma és reconegut.
`-A`, `--attach `URL`` | Especifica el camí o &URL; d'un fitxer que s'adjuntarà al correu electrònic. Aquesta opció es pot repetir si és necessari. S'ha d'especificar `--mail` amb aquesta opció.
`--auto-close` | Tanca automàticament la finestra d'alarma després de l'expiració del període `--late-cancel`. S'ha d'especificar `--late-cancel` amb aquesta opció.
`-b`, `--beep` | Emet un timbre audible quan es mostra el missatge. No es poden especificar `--speak`, `--play` i `--play-repeat` amb aquesta opció.
`--bcc` | Us envia una còpia oculta del correu electrònic. S'ha d'especificar `--mail` amb aquesta opció.
`-c`, `--color`, `--colour `color`` | Estableix el color de fons del missatge al nom de color especificat per a &Qt; o al codi hexadecimal 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg `color`` | Estableix el color de primer pla del missatge al nom de color especificat per a &Qt; o al codi hexadecimal 0xRRGGBB.
`-d`, `--disable` | Deshabilita l'alarma. No s'activarà fins que s'hagi habilitat manualment.
`--disable-all` | Deshabilita la monitorització d'alarmes. Això evita que les alarmes s'activin fins que torneu a habilitar les alarmes o reinicieu &kalarm;, &pex;, en el següent inici de sessió. No es pot especificar `--triggerEvent` amb aquesta opció.
`-e`, `--exec `línia_d'ordres`` | Especifica una ordre de línia d'ordres per executar. Si s'especifica, aquesta opció haurà de ser l'última opció de &kalarm; a la línia d'ordres de &kalarm;. Tots els paràmetres de les ordres i opcions posteriors s'interpretaran com la formació de la línia d'ordres per executar. No es poden especificar `--file`, `--exec-display` i `--mail` amb aquesta opció. S'ignoraran `--ack-confirm`, `--beep`, `--color` i `--colorfg`.
`-E`, `--exec-display `línia_d'ordres`` | Especifica una ordre de línia d'ordres a executar per generar el text del missatge d'alarma. Si s'especifica, aquesta opció haurà de ser l'última opció de &kalarm; en la línia d'ordres de &kalarm;. Tots els paràmetres i opcions posteriors s'interpretaran com la formació de la línia d'ordres per executar. No es poden especificar `--exec`, `--file` i `--mail` amb aquesta opció.
`-f`, `--file `URL`` | Especifica el camí o &URL; d'un fitxer de text o d'imatge per formar el missatge d'alarma. No es poden especificar `--exec`, `--exec-display` i `--mail`, i `missatge` no ha d'estar present amb aquesta opció.
`-F`, `--from-id `ID`` | Utilitza la identitat de &kmail; especificada com a remitent del correu electrònic. S'ha d'especificar `--mail` amb aquesta opció.
`-i`, `--interval `període`` | Estableix l'interval entre les repeticions de l'alarma. Les hores/minuts s'especifiquen en el format `nHnM`, on `n` és un nombre, &pex;, 3H30M. Els altres períodes de temps s'especifiquen en el format `nX`, on `n` és un nombre i `X` és una de les següents lletres: A (any), M (mes), S (setmana), D (dia). Si també s'especifica `--recurrence`, no estaran permesos A (anys) i M (mesos). Obligatori si s'especifica `--repeat` o `--until`.
`-k`, `--korganizer` | Mostra l'alarma com un esdeveniment en el calendari de &korganizer; actiu.
`-l`, `--late-cancel `període`` | Cancel·la l'alarma si no es pot activar en el `període` especificat després de l'hora correcta. Hores/minuts s'especifiquen en el format `nHnM`, on `n` és un número, &pex;, 3H30M. Els altres períodes de temps s'especifiquen en el format `nX`, on `n` és un número i `X` és una de les següents lletres: S (setmanes), D (dies). El valor per omissió de `període` és d'1 minut.
`-L`, `--login` | Activa l'alarma cada vegada que entreu. No es poden especificar `--interval`, `--repeat` i `--until` amb aquesta opció.
`-m`, `--mail `adreça`` | Envia un correu a l'adreça especificada. Aquesta opció es pot repetir si és necessari. No es poden especificar `--exec`, `--exec-display` i `--file` amb aquesta opció. Les opcions `--ack-confirm`, `--beep`, `--color` i `--colorfg` seran ignorades amb aquesta opció.
`-p`, `--play `URL`` | Especifica el camí o &URL; d'un fitxer d'àudio que es reproduirà una vegada, ja sigui com una alarma d'àudio o quan es mostri el missatge d'alarma. No es poden especificar `--play-repeat`, `--beep` i `--speak` amb aquesta opció.
`-P`, `--play-repeat `URL`` | Especifica el camí o &URL; d'un fitxer d'àudio que es reproduirà de forma repetida, o bé fins que s'utilitzi Atura la reproducció, o pel temps de mostrar el missatge d'alarma. No es poden especificar `--play`, `--beep` i `--speak` amb aquesta opció.
`--recurrence `spec`` | Estableix l'alarma a repetir. Especifiqueu la repetició utilitzant la sintaxi d'iCalendar (definida en el RFC2445), &pex;, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. No es pot especificar `--until` amb aquesta opció.
`-r`, `--repeat `compte`` | Estableix el nombre de vegades que s'activarà l'alarma, o si s'ha especificat una recurrència amb `--recurrence`, el nombre de vegades que s'activarà l'alarma cada vegada que s'activi `--recurrence` (&ead;, una repetició dins d'una altra repetició). Si `--recurrence` no està present, especifiqueu -1 per repetir l'alarma de forma indefinida. Hi haurà d'haver `--interval`, i `--until` no es podrà especificar amb aquesta opció.
`-R`, `--reminder `període`` | Fa sortir una alarma de recordatori en la quantitat de temps especificat abans o després de l'alarma principal i cadascuna de les seves repeticions (si n'hi ha). El `període` s'especifica en el mateix format com es descriu per a `--late-cancel`. Per omissió, el recordatori es produirà abans de l'alarma. Per especificar un recordatori després de l'alarma, utilitzeu el prefix `+` amb el `període`, &pex; +3D. Aquesta opció no es pot especificar amb `--exec`, `--mail` o `--reminder-once`.
`--reminder-once `període`` | Fa sortir una alarma de recordatori una vegada, en la quantitat de temps especificat abans o després de la primera recurrència de l'alarma principal. No recordarà si s'ha mostrat abans o després de les recurrències posteriors (si n'hi ha). El `període` s'especifica en el mateix format com es descriu per a `--reminder`. Aquesta opció no es pot especificar amb `--exec`, `--mail` o `--reminder`.
`-s`, `--speak` | Pronuncia el missatge quan es mostra. Aquesta opció requereix que &jovie; estigui instal·lat i configurat, juntament amb un sintetitzador de veu compatible. No es pot especificar `--beep`, `--play` i `--play-repeat` amb aquesta opció.
`-S`, `--subject `assumpte`` | La línia d'assumpte del correu. S'ha d'especificar `--mail` amb aquesta opció.
`-t`, `--time `data/hora`` | Activa l'alarma a la data o el dia/hora especificats. Especifica una data sense una hora en el format `aaaa-mm-dd [TZ]`, especifica una data i hora amb `[[[aaaa-]mm-]dd-]hh:mm [TZ]` (on s'ometrà, per omissió els camps de data als valors per avui). Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària `TZ`, aquest podrà ser el nom d'una zona horària del sistema (&pex; `Europe/London`), `UTC` representa la zona horària UTC, o `Clock` utilitza el rellotge de l'ordinador local i ignora les zones horàries.
`-v`, `--volume `percentatge`` | Ajusta el volum de l'àudio per a la reproducció del fitxer d'àudio. Aquesta opció només es pot utilitzar quan s'especifica `--play` o `--play-repeat`.
`-u`, `--until `data/hora`` | Repeteix l'alarma fins a la data o la data/hora especificats. Especifiqueu la data o la data/hora utilitzant la mateixa sintaxi que per a `--time`. Tingueu en compte que si s'especifica `--time`, la zona horària es prendrà del seu valor i no es podrà incloure en el valor de `--until`. Hi haurà d'estar `--interval`, i `--repeat` i `--recurrence` no es poden especificar amb aquesta opció.
`missatge` | Text de missatge a mostrar o, si s'especifica `--mail`, el cos del missatge del correu.

Encara que sigui un missatge de text, cal especificar `--file`, `--exec`, `--exec-display`, `--play` o `--play-repeat`, les excepcions ja esmentades, totes les opcions són opcionals.

Dos exemples alternatius mostrant un missatge de diverses línies amb un fons vermell a les 10 pm el 27 d'aquest mes són:

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

### Altres opcions

Les següents opcions s'utilitzen per a realitzar vàries funcions, inclòs el mostrar el diàleg d'edició de l'alarma.

Opció | Descripció
`--edit `ID_esdeveniment`` | Mostra el diàleg d'edició de l'alarma per editar l'alarma amb l'identificador d'esdeveniment especificat.
`--edit-new-audio` | Mostra el diàleg d'edició de l'alarma, per tal d'editar una nova alarma d'àudio.
`--edit-new-command` | Mostra el diàleg d'edició de l'alarma, amb la finalitat d'editar una nova alarma d'ordre.
`--edit-new-display` | Mostra el diàleg d'edició de l'alarma, per tal d'editar una nova alarma visual.
`--edit-new-email` | Mostra el diàleg d'edició de l'alarma, per tal d'editar una nova alarma de correu.
`--edit-new-preset `nom_plantilla`` | Mostra el diàleg d'edició de l'alarma, configurat amb la plantilla d'alarma amb el nom especificat, per tal d'editar una nova alarma.
`--list` | Genera una llista de les alarmes programades a `stdout`. La llista mostra una breu descripció de cadascuna de les alarmes pendents: el seu identificador de recurs (si utilitza Akonadi), l'UID següent hora programada i el text del missatge o fitxer.
`--tray` | Mostra &kalarm; com una icona a la safata del sistema.
`--disable-all` | Desactiva el control de totes les alarmes.

### Opcions de l'ajuda

Les següents opcions d'ajuda són comuns a tots els programes de &kde;:

Opció | Descripció
`--help` | Mostra un text breu amb opcions d'ajuda.
`--help-qt` | Mostra les opcions específiques de &Qt;.
`--help-kde` | Mostra les opcions específiques de &kde;.
`--help-all` | Mostra totes les opcions.
`--author` | Mostra els noms i adreces de correu dels autors de &kalarm;.
`-v`, `--version` | Mostra les versions en funcionament de la biblioteca &Qt;, &kde; i &kalarm;.
`--license` | Mostra informació sobre la llicència.

## Guia de &kalarm; per a desenvolupadors

&kalarm; proporciona una interfície per permetre que altres aplicacions requereixin les següents funcions:

- programar una alarma nova

- cancel·la una alarma ja programada

- activa una alarma ja programada

- mostra el diàleg d'edició de l'alarma

- llista de les alarmes planificades

Cadascuna de les anteriors funcions estan implementades tant a través d'una crida de &DBus; com a la línia d'ordres. Les crides de &DBus; s'han d'utilitzar amb preferència si &kalarm; ja està en execució.

### Interfície de &DBus;

Les crides de &DBus; descrites en aquest document s'implementen en el camí de l'objecte de &DBus; `/kalarm` de &kalarm;. La interfície es defineix en els fitxers `org.kde.kalarm.kalarm.xml` i `kalarmiface.h`.

cancelEvent

cancelEvent

cancel·la una alarma ja programada.

    void cancelEvent(const QString& ID_esdeveniment)

##### Paràmetres

`ID_esdeveniment`

- Especifica l'identificador únic de l'esdeveniment a cancel·lar.

##### Descripció

`cancelEvent()` és una crida de &DBus; per cancel·lar l'alarma especificada. &kalarm; suprimeix l'alarma del calendari sense que es mostri o executi.

triggerEvent

triggerEvent

activa una alarma ja programada.

    void triggerEvent(const QString& ID_esdeveniment)

##### Paràmetres

`ID_esdeveniment`

- Especifica l'identificador únic de l'esdeveniment a activar.

##### Descripció

`triggerEvent()` és una crida de &DBus; per activar la visualització immediata o l'execució de l'alarma especificada (sense importar l'hora a la que està programada). &kalarm; recupera l'alarma del calendari i després la mostra o executa.

Si l'alarma ja ha vençut, llavors &kalarm; elimina totes les aparicions programades de l'alarma fins a l'hora actual, i si no romandrà la repetició de l'alarma, l'alarma s'eliminarà del calendari. Si l'alarma no ha vençut, les seves aparicions programades no es modificaran.

scheduleMessage

scheduleMessage

programa un nou missatge d'alarma.

    bool scheduleMessage(const QString& missatge,
                         const QString& hora_data_inici,
                         int CancellaTard,
                         unsigned etiquetes,
                         const QString& ColorFons,
                         const QString& ColorPrimerPla,
                         const QString& tipus_de_lletra,
                         const QString& URLàudio,
                         int MinutsRecordatori,
                         const QString& recurrència,
                         int IntervalSubRepetecions,
                         int CompteSubRepetecions)

    bool scheduleMessage(const QString& missatge,
                         const QString& hora_data_inici,
                         int CancellaTard,
                         unsigned etiquetes,
                         const QString& ColorFons,
                         const QString& ColorPrimerPla,
                         const QString& tipus_de_lletra,
                         const QString& URLàudio,
                         int MinutsRecordatori,
                         int TipusRecurrència,
                         int IntervalRecurrència,
                         int CompteRecurrència)

    bool scheduleMessage(const QString& missatge,
                         const QString& hora_data_inici,
                         int CancellaTard,
                         unsigned etiquetes,
                         const QString& ColorFons,
                         const QString& ColorPrimerPla,
                         const QString& tipus_de_lletra,
                         const QString& URLàudio,
                         int MinutsRecordatori,
                         int TipusRecurrència,
                         int IntervalRecurrència,
                         const QString& DataHoraFinal)

##### Paràmetres

`missatge`

- Especifica el text del missatge a programar, o si `etiquetes` té establert el bit `DISPLAY_COMMAND`, especifica la línia d'ordres a executar per generar el text del missatge.

`hora_data_inici`

- Especifica la data programada, o la data/hora, s'ha de mostrar el missatge. Per a una alarma de només data, la cadena haurà d'estar en el format `AAAA-MM-DD [TZ]` (com és retornat per `QDate::toString(Qt::ISODate)`). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format `AAAA-MM-DDTHH:MM[:SS] [TZ]` (com és retornat per `QDateTime::toString(Qt::ISODate)` ) o `HH:MM[:SS] [Clock]` (com és retornat per `QTime::toString(Qt::ISODate)` ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu en compte que qualsevol valor per als segons serà ignorat.

  Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària `TZ`, aquest podrà ser el nom d'una zona horària del sistema (&pex; `Europe/London`), `UTC` representa la zona horària UTC, o `Clock` utilitza el rellotge de l'ordinador local i ignora les zones horàries.

`CancellaTard`

- Causa que l'alarma sigui cancel·lada si no es pot activar amb el nombre especificat de minuts després de l'hora programada de l'alarma. Si el valor és 0, l'alarma no es cancel·larà sense importar el tard que s'activi.

`etiquetes`

- Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Tingueu en compte que no tots els bits de l'etiqueta són aplicables a les alarmes de missatge.

`ColorFons`

- Especifica el color de fons per a mostrar el missatge. La cadena pot estar en el format #RRGGBB (com és retornat per `QColor::name()` on RR, GG i BB són dos dígits hexadecimals per als colors vermell, verd i blau. Com a alternativa, la cadena pot estar en qualsevol dels formats acceptats per `QColor::setNamedColor()`, com un nom en la base de dades de color de X (&pex; red o steelblue). Establiu la cadena a «null» per especificar el color per omissió de fons actual.

`ColorPrimerPla`

- Especifica el color de primer pla per a mostrar el missatge. El format de la cadena és el mateix que per a `ColorFons`, o bé establiu la cadena a «null» per especificar el color per omissió de primer pla actual.

`tipus_de_lletra`

- Especifica el tipus de lletra per a mostrar el missatge. El format de la cadena és la sortida de `QFont::toString()`. Establiu la cadena a «null» per utilitzar el tipus de lletra de missatge per omissió actual quan es mostri el missatge.

`URLàudio`

- Especifica el fitxer d'àudio que es reproduirà quan es mostri el missatge. Establiu el valor a «null» si no hi ha cap fitxer d'àudio a reproduir.

`MinutsRecordatori`

- Especifica el nombre de minuts abans de l'alarma principal i de cadascuna de les seves repeticions (si n'hi ha) a la qual s'haurà de mostrar una alarma de recordatori. Introduïu un valor negatiu per a que el recordatori es mostri després de l'alarma principal. Especifiqueu 0 si no es requereix el recordatori.

`recurrència`

- Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la RFC2445. Per exemple, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaria 4 repeticions a intervals de 3 mesos l'últim dilluns de cada mes. Per a una alarma no recurrent, especifiqueu una cadena buida.

`TipusRecurrència`

- Especifica el tipus de repetició per a l'alarma. Els valors permesos són MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Aquests es defineixen en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Les recurrències mensuals són del dia del tipus de mes, i les recurrències anuals són de la data en el tipus d'any, amb la data en ambdós casos agafada del paràmetre `hora_data_inici`.

`IntervalRecurrència`

- Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en `TipusRecurrència`) entre les recurrències de l'alarma.

`CompteRecurrència`

- Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.

`DataHoraFinal`

- Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si `hora_data_inici` inclou una hora, aquest paràmetre també inclourà una hora, si `hora_data_inici` conté només una data, aquest paràmetre també contindrà només una data. No ha de contenir un especificador de zona horària; s'utilitzarà la mateixa zona horària que per `hora_data_inici` per interpretar el valor d'aquest paràmetre.

`IntervalSubRepetecions`

- Especifica el nombre de minuts entre les sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.

`CompteSubRepetecions`

- Especifica el nombre de sub-repeticions de l'alarma, incloent l'ocurrència inicial.

##### Descripció

`scheduleMessage()` és una crida de &DBus; per a programar el missatge d'alarma especificat per a mostrar-lo a la data i hora especificats. Té tres formes. La forma més general permet una recurrència arbitrària a especificar –utilitzeu-ho per a no repetir les alarmes–. Les altres formes faciliten l'accés a un conjunt limitat de tipus de recurrència d'alarma, un especificador del nombre de repeticions i l'altre una hora de finalització.

Si l'hora programada (incloent qualsevol repetició) ja ha passat, &kalarm; mostrarà immediatament el missatge (a menys que el valor de `CancellaTard` indiqui que ja és massa tard per mostrar l'alarma, en aquest cas &kalarm; ignorarà la petició). Si l'hora programada (o una repetició) està en el futur, &kalarm; afegirà el missatge d'alarma al calendari d'alarmes actiu per omissió per a mostrar-lo després.

scheduleFile

scheduleFile

programa una nova alarma que mostra el contingut d'un fitxer de text o d'imatge.

    bool scheduleFile(const QString& URL,
                      const QString& hora_data_inici,
                      int CancellaTard,
                      unsigned etiquetes,
                      const QString& ColorFons,
                      const QString& URLàudio,
                      int MinutsRecordatori,
                      const QString& recurrència,
                      int IntervalSubRepetecions,
                      int CompteSubRepetecions)

    bool scheduleFile(const QString& URL,
                      const QString& hora_data_inici,
                      int CancellaTard,
                      unsigned etiquetes,
                      const QString& ColorFons,
                      const QString& URLàudio,
                      int MinutsRecordatori,
                      int TipusRecurrència,
                      int IntervalRecurrència,
                      int CompteRecurrència)

    bool scheduleFile(const QString& URL,
                      const QString& hora_data_inici,
                      int CancellaTard,
                      unsigned etiquetes,
                      const QString& ColorFons,
                      const QString& URLàudio,
                      int MinutsRecordatori,
                      int TipusRecurrència,
                      int IntervalRecurrència,
                      const QString& hora_data_final)

##### Paràmetres

`URL`

- Especifica el fitxer de text o d'imatge el contingut del qual es mostrarà en el missatge que es programi.

`hora_data_inici`

- Especifica la data programada, o la data/hora, s'ha de mostrar el missatge. Per a una alarma de només data, la cadena haurà d'estar en el format `AAAA-MM-DD [TZ]` (com és retornat per `QDate::toString(Qt::ISODate)`). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format `AAAA-MM-DDTHH:MM[:SS] [TZ]` (com és retornat per `QDateTime::toString(Qt::ISODate)` ) o `HH:MM[:SS] [Clock]` (com és retornat per `QTime::toString(Qt::ISODate)` ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu en compte que qualsevol valor per als segons serà ignorat.

  Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària `TZ`, aquest podrà ser el nom d'una zona horària del sistema (&pex; `Europe/London`), `UTC` representa la zona horària UTC, o `Clock` utilitza el rellotge de l'ordinador local i ignora les zones horàries.

`CancellaTard`

- Causa que l'alarma sigui cancel·lada si no es pot activar amb el nombre especificat de minuts després de l'hora programada de l'alarma. Si el valor és 0, l'alarma no es cancel·larà sense importar el tard que s'activi.

`etiquetes`

- Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Tingueu en compte que no tots els bits de l'etiqueta són aplicables a les alarmes de fitxer.

`ColorFons`

- Especifica el color de fons per a mostrar el fitxer. La cadena pot estar en el format #RRGGBB (com és retornat per `QColor::name()` on RR, GG i BB són dos dígits hexadecimals per als colors vermell, verd i blau. Com a alternativa, la cadena pot estar en qualsevol dels formats acceptats per `QColor::setNamedColor()`, com un nom en la base de dades de color de X (&pex; red o steelblue). Establiu la cadena a «null» per especificar el color per omissió de fons actual.

`URLàudio`

- Especifica el fitxer d'àudio que es reproduirà quan es mostri el missatge. Establiu el valor a «null» si no hi ha cap fitxer d'àudio a reproduir.

`MinutsRecordatori`

- Especifica el nombre de minuts abans de l'alarma principal i de cadascuna de les seves repeticions (si n'hi ha) a la qual s'haurà de mostrar una alarma de recordatori. Introduïu un valor negatiu per a que el recordatori es mostri després de l'alarma principal. Especifiqueu 0 si no es requereix el recordatori.

`recurrència`

- Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la RFC2445. Per exemple, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaria 4 repeticions a intervals de 3 mesos l'últim dilluns de cada mes. Per a una alarma no recurrent, especifiqueu una cadena buida.

`TipusRecurrència`

- Especifica el tipus de repetició per a l'alarma. Els valors permesos són MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Aquests es defineixen en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Les recurrències mensuals són del dia del tipus de mes, i les recurrències anuals són de la data en el tipus d'any, amb la data en ambdós casos agafada del paràmetre `hora_data_inici`.

`IntervalRecurrència`

- Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en `TipusRecurrència`) entre les recurrències de l'alarma.

`CompteRecurrència`

- Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.

`DataHoraFinal`

- Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si `hora_data_inici` inclou una hora, aquest paràmetre també inclourà una hora, si `hora_data_inici` conté només una data, aquest paràmetre també contindrà només una data. No ha de contenir un especificador de zona horària; s'utilitzarà la mateixa zona horària que per `hora_data_inici` per interpretar el valor d'aquest paràmetre.

`IntervalSubRepetecions`

- Especifica el nombre de minuts entre les sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.

`CompteSubRepetecions`

- Especifica el nombre de sub-repeticions de l'alarma, incloent l'ocurrència inicial.

##### Descripció

`scheduleFile()` és una crida de &DBus; per a programar el text o fitxer d'imatge especificat per a mostrar-lo a la data i hora especificats. Apart d'especificar un camí o &URL; de fitxer i ometent el color de fons i el tipus de lletra, el seu ús és idèntic al de `scheduleMessage` -veure la descripció de la funció per a més detalls-.

scheduleCommand

scheduleCommand

programa una nova alarma que executa una ordre.

    bool scheduleCommand(const QString& línia_d'ordres,
                         const QString& hora_data_inici,
                         int CancellaTard,
                         unsigned etiquetes,
                         const QString& recurrència,
                         int IntervalSubRepetecions,
                         int CompteSubRepetecions)

    bool scheduleCommand(const QString& línia_d'ordres,
                         const QString& hora_data_inici,
                         int CancellaTard,
                         unsigned etiquetes,
                         int TipusRecurrència,
                         int IntervalRecurrència,
                         int CompteRecurrència)

    bool scheduleCommand(const QString& línia_d'ordres,
                         const QString& hora_data_inici,
                         int CancellaTard,
                         unsigned etiquetes,
                         int TipusRecurrència,
                         int IntervalRecurrència,
                         const QString& hora_data_final)

##### Paràmetres

`línia_d'ordres`

- Especifica l'ordre a executar. El paràmetre `etiquetes` indica si aquest paràmetre conté una línia d'ordres o un script d'ordres.

`hora_data_inici`

- Especifica la data programada, o la data/hora, s'ha de mostrar el missatge. Per a una alarma de només data, la cadena haurà d'estar en el format `AAAA-MM-DD [TZ]` (com és retornat per `QDate::toString(Qt::ISODate)`). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format `AAAA-MM-DDTHH:MM[:SS] [TZ]` (com és retornat per `QDateTime::toString(Qt::ISODate)` ) o `HH:MM[:SS] [Clock]` (com és retornat per `QTime::toString(Qt::ISODate)` ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu en compte que qualsevol valor per als segons serà ignorat.

  Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària `TZ`, aquest podrà ser el nom d'una zona horària del sistema (&pex; `Europe/London`), `UTC` representa la zona horària UTC, o `Clock` utilitza el rellotge de l'ordinador local i ignora les zones horàries.

`CancellaTard`

- Causa que l'alarma sigui cancel·lada si no es pot activar amb el nombre especificat de minuts després de l'hora programada de l'alarma. Si el valor és 0, l'alarma no es cancel·larà sense importar el tard que s'activi.

`etiquetes`

- Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Tingueu en compte que no tots els bits de l'etiqueta són aplicables a les alarmes d'ordre.

`recurrència`

- Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la RFC2445. Per exemple, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaria 4 repeticions a intervals de 3 mesos l'últim dilluns de cada mes. Per a una alarma no recurrent, especifiqueu una cadena buida.

`TipusRecurrència`

- Especifica el tipus de repetició per a l'alarma. Els valors permesos són MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Aquests es defineixen en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Les recurrències mensuals són del dia del tipus de mes, i les recurrències anuals són de la data en el tipus d'any, amb la data en ambdós casos agafada del paràmetre `hora_data_inici`.

`IntervalRecurrència`

- Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en `TipusRecurrència`) entre les recurrències de l'alarma.

`CompteRecurrència`

- Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.

`DataHoraFinal`

- Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si `hora_data_inici` inclou una hora, aquest paràmetre també inclourà una hora, si `hora_data_inici` conté només una data, aquest paràmetre també contindrà només una data. No ha de contenir un especificador de zona horària; s'utilitzarà la mateixa zona horària que per `hora_data_inici` per interpretar el valor d'aquest paràmetre.

`IntervalSubRepetecions`

- Especifica el nombre de minuts entre les sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.

`CompteSubRepetecions`

- Especifica el nombre de sub-repeticions de l'alarma, incloent l'ocurrència inicial.

##### Descripció

`scheduleCommand()` és una crida de &DBus; per a programar la línia d'ordres especificada, o scripts d'ordres, per executar a la data i hora especificats. Apart d'especificar una ordre i ometent els paràmetres del color de fons, el tipus de lletra i el fitxer d'àudio, el seu ús és idèntic al de `scheduleMessage` -veure la descripció de la funció per a més detalls-.

scheduleEmail

scheduleEmail

programa una nova alarma que envia un correu electrònic.

    bool scheduleEmail(const QString& ID_De,
                       const QString& adreces,
                       const QString& assumpte,
                       const QString& missatge,
                       const QString& adjunts,
                       const QString& hora_data_inici,
                       int CancellaTard,
                       unsigned etiquetes,
                       const QString& recurrència,
                       int IntervalSubRepetecions,
                       int CompteSubRepetecions)

    bool scheduleEmail(const QString& ID_De,
                       const QString& adreces,
                       const QString& assumpte,
                       const QString& missatge,
                       const QString& adjunts,
                       const QString& hora_data_inici,
                       int CancellaTard,
                       unsigned etiquetes,
                       int TipusRecurrència,
                       int IntervalRecurrència,
                       int CompteRecurrència)

    bool scheduleEmail(const QString& ID_De,
                       const QString& adreces,
                       const QString& assumpte,
                       const QString& missatge,
                       const QString& adjunts,
                       const QString& hora_data_inici,
                       int CancellaTard,
                       unsigned etiquetes,
                       int TipusRecurrència,
                       int IntervalRecurrència,
                       const QString& endTime)

##### Paràmetres

`ID_De`

- La identitat de &kmail; a utilitzar com a remitent del correu. Si està buida, l'adreça del remitent serà la configurada a les preferències de correu de &kalarm;.

`adreces`

- Una llista separada per comes de les adreces de correu dels destinataris.

`assumpte`

- Especifica la línia d'assumpte del correu.

`missatge`

- Especifica el cos del missatge del correu.

`adjunts`

- Una llista separada per comes dels camins o &URL; dels fitxers per enviar com a adjunts del correu.

`hora_data_inici`

- Especifica la data programada, o la data/hora, s'ha de mostrar el missatge. Per a una alarma de només data, la cadena haurà d'estar en el format `AAAA-MM-DD [TZ]` (com és retornat per `QDate::toString(Qt::ISODate)`). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format `AAAA-MM-DDTHH:MM[:SS] [TZ]` (com és retornat per `QDateTime::toString(Qt::ISODate)` ) o `HH:MM[:SS] [Clock]` (com és retornat per `QTime::toString(Qt::ISODate)` ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu en compte que qualsevol valor per als segons serà ignorat.

  Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària `TZ`, aquest podrà ser el nom d'una zona horària del sistema (&pex; `Europe/London`), `UTC` representa la zona horària UTC, o `Clock` utilitza el rellotge de l'ordinador local i ignora les zones horàries.

`CancellaTard`

- Causa que l'alarma sigui cancel·lada si no es pot activar amb el nombre especificat de minuts després de l'hora programada de l'alarma. Si el valor és 0, l'alarma no es cancel·larà sense importar el tard que s'activi.

`etiquetes`

- Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Tingueu en compte que no tots els bits de l'etiqueta són aplicables a les alarmes de correu.

`recurrència`

- Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la RFC2445. Per exemple, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaria 4 repeticions a intervals de 3 mesos l'últim dilluns de cada mes. Per a una alarma no recurrent, especifiqueu una cadena buida.

`TipusRecurrència`

- Especifica el tipus de repetició per a l'alarma. Els valors permesos són MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Aquests es defineixen en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Les recurrències mensuals són del dia del tipus de mes, i les recurrències anuals són de la data en el tipus d'any, amb la data en ambdós casos agafada del paràmetre `hora_data_inici`.

`IntervalRecurrència`

- Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en `TipusRecurrència`) entre les recurrències de l'alarma.

`CompteRecurrència`

- Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.

`DataHoraFinal`

- Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si `hora_data_inici` inclou una hora, aquest paràmetre també inclourà una hora, si `hora_data_inici` conté només una data, aquest paràmetre també contindrà només una data. No ha de contenir un especificador de zona horària; s'utilitzarà la mateixa zona horària que per `hora_data_inici` per interpretar el valor d'aquest paràmetre.

`IntervalSubRepetecions`

- Especifica el nombre de minuts entre les sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.

`CompteSubRepetecions`

- Especifica el nombre de sub-repeticions de l'alarma, incloent l'ocurrència inicial.

##### Descripció

`scheduleEmail()` és una crida de &DBus; per a programar el correu especificat per enviar a la data i hora especificats. Apart d'especificar una capçalera i contingut i ometent els paràmetres de color del missatge, el tipus de lletra i el fitxer d'àudio, el seu ús és idèntic al de `scheduleMessage` -veure la descripció de la funció per a més detalls-.

scheduleAudio

scheduleAudio

programa una nova alarma que executa una ordre.

    bool scheduleAudio(const QString& URLàudio,
                       int PercentatgeVolum,
                       const QString& hora_data_inici,
                       int CancellaTard,
                       unsigned etiquetes,
                       const QString& recurrència,
                       int IntervalSubRepetecions,
                       int CompteSubRepetecions)

    bool scheduleAudio(const QString& URLàudio,
                       int PercentatgeVolum,
                       const QString& hora_data_inici,
                       int CancellaTard,
                       unsigned etiquetes,
                       int TipusRecurrència,
                       int IntervalRecurrència,
                       int CompteRecurrència)

    bool scheduleAudio(const QString& URLàudio,
                       int PercentatgeVolum,
                       const QString& hora_data_inici,
                       int CancellaTard,
                       unsigned etiquetes,
                       int TipusRecurrència,
                       int IntervalRecurrència,
                       const QString& hora_data_final)

##### Paràmetres

`URLàudio`

- Especifica el fitxer d'àudio que es reproduirà.

`PercentatgeVolum`

- Especifica el nivell de volum a utilitzar, com a percentatge del volum total. Especifiqueu -1 per utilitzar el volum per omissió.

`hora_data_inici`

- Especifica la data programada, o la data/hora, s'ha de mostrar el missatge. Per a una alarma de només data, la cadena haurà d'estar en el format `AAAA-MM-DD [TZ]` (com és retornat per `QDate::toString(Qt::ISODate)`). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format `AAAA-MM-DDTHH:MM[:SS] [TZ]` (com és retornat per `QDateTime::toString(Qt::ISODate)` ) o `HH:MM[:SS] [Clock]` (com és retornat per `QTime::toString(Qt::ISODate)` ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu en compte que qualsevol valor per als segons serà ignorat.

  Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària `TZ`, aquest podrà ser el nom d'una zona horària del sistema (&pex; `Europe/London`), `UTC` representa la zona horària UTC, o `Clock` utilitza el rellotge de l'ordinador local i ignora les zones horàries.

`CancellaTard`

- Causa que l'alarma sigui cancel·lada si no es pot activar amb el nombre especificat de minuts després de l'hora programada de l'alarma. Si el valor és 0, l'alarma no es cancel·larà sense importar el tard que s'activi.

`etiquetes`

- Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Tingueu en compte que no tots els bits de l'etiqueta són aplicables a les alarmes d'ordre.

`recurrència`

- Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la RFC2445. Per exemple, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaria 4 repeticions a intervals de 3 mesos l'últim dilluns de cada mes. Per a una alarma no recurrent, especifiqueu una cadena buida.

`TipusRecurrència`

- Especifica el tipus de repetició per a l'alarma. Els valors permesos són MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Aquests es defineixen en la classe `KAlarmIface` en el fitxer `kalarmiface.h`. Les recurrències mensuals són del dia del tipus de mes, i les recurrències anuals són de la data en el tipus d'any, amb la data en ambdós casos agafada del paràmetre `hora_data_inici`.

`IntervalRecurrència`

- Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en `TipusRecurrència`) entre les recurrències de l'alarma.

`CompteRecurrència`

- Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.

`DataHoraFinal`

- Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si `hora_data_inici` inclou una hora, aquest paràmetre també inclourà una hora, si `hora_data_inici` conté només una data, aquest paràmetre també contindrà només una data. No ha de contenir un especificador de zona horària; s'utilitzarà la mateixa zona horària que per `hora_data_inici` per interpretar el valor d'aquest paràmetre.

`IntervalSubRepetecions`

- Especifica el nombre de minuts entre les sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.

`CompteSubRepetecions`

- Especifica el nombre de sub-repeticions de l'alarma, incloent l'ocurrència inicial.

##### Descripció

`scheduleAudio()` és una crida de &DBus; per a programar el fitxer d'àudio especificat a reproduir a la data i hora especificats. Apart d'especificar un volum i ometent els paràmetres de color del missatge i el tipus de lletra, el seu ús és idèntic al de `scheduleMessage` -veure la descripció de la funció per a més detalls-.

edit

edit

Mostra el diàleg d'edició de l'alarma per editar una alarma.

    bool edit(const QString& ID_esdeveniment)

##### Paràmetres

`ID_esdeveniment`

- Especifica l'identificador únic de l'esdeveniment que voleu editar.

##### Valor de retorn

fals si l'alarma especificada no s'ha trobat o és de només lectura, cert el contrari.

##### Descripció

`edit()` és una crida de &DBus; per mostrar el diàleg d'edició de l'alarma per editar l'alarma especificada.

editNew

editNew

Mostra el diàleg d'edició de l'alarma per editar una alarma nova.

    bool editNew(int tipus)

    bool editNew(const QString& nom_plantilla)

##### Paràmetres

`tipus`

- Especifica el tipus d'alarma. Els valors permesos són DISPLAY, COMMAND, EMAIL, AUDIO. Aquests es defineixen en la classe `KAlarmIface` en el fitxer `kalarmiface.h`.

`nom_plantilla`

- Especifica el nom d'una plantilla d'alarma com a base de la nova alarma activa.

##### Valor de retorn

fals si `tipus` té un valor no vàlid, o si no es pot trobar una plantilla amb el nom `nom_plantilla`; cert en cas contrari.

##### Descripció

`editNew()` és una crida de &DBus; per mostrar el diàleg d'edició de l'alarma per editar una alarma nova. Si s'especifica un tipus d'alarma com un paràmetre, es mostrarà un diàleg en blanc. D'altra banda, si s'especifica un nom de plantilla d'alarma com un paràmetre, el diàleg estarà configurat amb els detalls de la plantilla.

list

list

Retorna una llista de les alarmes planificades.

    QString list()

##### Valor de retorn

Llista d'alarmes, separades per salts de línia, cadascuna en el format `resource_id`:`UID` `time` `text` (si utilitza Akonadi), o `UID` `hora` `text` (si utilitza KResources).

##### Descripció

`list()` és una crida de &DBus; per retornar una cadena que conté un resum de les alarmes programades. La llista mostra una breu descripció de cadascuna de les alarmes pendents: el seu identificador de recurs (si utilitza Akonadi), l'UID següent hora programada i el text del missatge o fitxer.

### Interfície de línia d'ordres

Les opcions de línia d'ordres es proporcionen per permetre que altres programes iniciïn &kalarm; si no s'està executant, a fi d'activar o cancel·lar les alarmes programades, o programar-ne de noves. La raó d'utilitzar opcions de línia d'ordres per a aquest propòsit és que si &kalarm; es van iniciar sense cap paràmetre de línia d'ordres i després s'envien les crides de &DBus;, aquest començarà per omissió en el mode gràfic, el qual no és desitjable per a crides internes a l'aplicació.

Els programes han de comprovar primer si &kalarm; ja està en execució, si ho és, s'utilitzaran les crides de &DBus; per a demanar aquestes operacions.

Les opcions de línia d'ordres per a programar una nova alarma es descriuen en el capítol de Operació de la línia d'ordres. Les opcions per activar i cancel·lar alarmes programades són les següents:

Els usuaris normals també poden si ho desitgen utilitzar aquestes opcions de línia d'ordres (assumint que puguin proporcionar la informació necessària dels paràmetres).

Opció | Descripció
`--cancelEvent `ID_esdeveniment`` | Cancel·la l'alarma amb l'identificador d'esdeveniment especificat. No es pot especificar `--triggerEvent` amb aquesta opció.
`--triggerEvent `ID_esdeveniment`` | Activa l'alarma amb l'identificador d'esdeveniment especificat. L'acció agafada és la mateixa que per a la crida de &DBus; triggerEvent(). No es pot especificar `--cancelEvent` amb aquesta opció.

Exemples:

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

## Preguntes i respostes

&reporting.bugs; &updating.documentation;

Quin tipus de fitxers de configuració utilitza &kalarm;?

`$KDEHOME/share/config/kalarmrc` manté les vostres preferències de &kalarm;.

`$KDEHOME/share/config/kresources/alarms/stdrc` manté la configuració del calendari d'alarma.

($`KDEHOME` sol ser `˜/.kde` o similar).

A on emmagatzema &kalarm; les alarmes?

Els noms dels fitxers de calendari que &kalarm; crea la primera vegada que s'executa són els següents (però aquests poden substituir-se per les entrades en la secció `General` del fitxer de preferències de &kalarm;):

- `$KDEHOME/share/apps/kalarm/calendar.ics` manté les alarmes actives (substituïble per l'entrada `Calendar`).

- $`$KDEHOME/share/apps/kalarm/expired.ics` manté les alarmes arxivades (substituïble per l'entrada `ExpiredCalendar`).

- $`$KDEHOME/share/apps/kalarm/template.ics` manté les plantilles d'alarma (substituïble per l'entrada `TemplateCalendar`).

Podeu descobrir els fitxers de calendari que estan actualment en ús per veure els detalls de cada calendari a la llista de calendaris d'alarma. Els noms de fitxer es desen al fitxer de configuració del calendari d'alarma.

Els detalls de les alarmes s'estan veient es desen al fitxer de calendari `$KDEHOME/share/apps/kalarm/displaying.ics`.

En quin format s'emmagatzemen les alarmes?

Els fitxers de calendari en els que &kalarm; emmagatzema les seves alarmes són fitxers de text en el format es defineix en el document RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). Aquest és el format estàndard utilitzat per totes les aplicacions de kdepim. &kalarm; utilitza certes propietats no estàndard, de conformitat amb RFC2445. Aquestes es troben documentats en el fitxer `DESIGN.html` que es distribueix amb &kalarm;.

Què és el programa kalarmautostart?

kalarmautostart és un petit programa d'ajuda en la funció d'inici automàtic de &kalarm; en iniciar la sessió.

&kalarm; sol ser restaurada pel gestor de sessions a l'inici de la sessió (per tornar a mostrar les seves finestres en el mateix estat en què estaven quan es va tancar la sessió). Però si no s'estava executant, no s'iniciarà i per tant serà iniciat automàticament. El problema és que quan una aplicació és alhora restaurada pel gestor de sessions i iniciada automàticament, no hi ha cap garantia del que succeirà primer. Si s'inicia automàticament en primer lloc, impedirà que el gestor de sessions restauri l'estat de l'aplicació.

Per evitar aquest problema, kalarmautostart és iniciat automàticament en iniciar la sessió en lloc de &kalarm;. Tot el que fa és esperar un curt temps (per assegurar-se que el gestor de sessions té temps per funcionar) abans d'iniciar &kalarm;, moment en el que finalitzarà.

## Crèdits i llicència

&kalarm;

Copyright del programa 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 &David.Jarvie; &David.Jarvie.mail;

Copyright de la documentació 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 &David.Jarvie; &David.Jarvie.mail;

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

Donem les gràcies a l'autor de l'aplicació KAlarm al &kde; 1, Stefan Nikolaus (stefan.nikolaus@stuco.uni-oldenburg.de), qui amablement va accedir a permetre que el nom &kalarm; sigui utilitzat per a aquesta aplicació, la qual ha estat disponible per a &kde; 2 en endavant.

## Instal·lació

### Com obtenir &kalarm;

&install.intro.documentation;

&kalarm; també està disponible com un paquet independent per a &kde; 4, així com per a les versions anteriors &kde; 3 i &kde;, des de http://www.astrojar.org.uk/kalarm

### Requeriments

&kalarm; requereix les biblioteques estàndard de &kde; per a la seva instal·lació (els paquets `kdelibs` i `kdepimlibs`), a més del paquet `kdebase/runtime`. Per compilar el codi font, també necessitareu els paquets de biblioteques de desenvolupament pertinents, i el paquet de desenvolupament de &Qt;.

Els següents paquets opcionals milloren &kalarm; durant l'execució si es troben instal·lats:

- &jovie; (del paquet kdeaccessibility): si està instal·lat i configurat, juntament amb un paquet sintetitzador de veu compatible, permet a &kalarm; parlar els missatges d'alarma quan es mostren.

Podeu trobar una llista de canvis en el fitxer `Changelog` , o a http://www.astrojar.org.uk/kalarm.

### Compilació i instal·lació

Si no podeu obtenir un paquet binari precompilat adequat, necessitareu compilar &kalarm; des del codi font. Obteniu el fitxer del paquet font `kdepim-x.x.tar.bz2` o `kalarm-x.x.tar.bz2` (o similar), depenent de si voleu instal·lar &package; o simplement &kalarm;. Descomprimiu-lo en una nova carpeta amb una ordre similar a ``tar` `xvfj `paquet.tar.bz2```, i canvieu a la carpeta que heu creat.

&install.compile.documentation;

Si instal·leu &kalarm; en una carpeta diferent d'on està instal·lat el &kde;, no funcionarà correctament a menys que feu saber al &kde; la seva ubicació. Per a fer-ho, anteposeu la variable d'entorn `KDEDIRS` amb la ubicació de &kalarm;, cada vegada que abans d'iniciar el &kde;.

Per exemple, si el &kde; està instal·lat a `/opt/kde`, `KDEDIRS` normalment pot estar establert a `/etc/opt/kde:/opt/kde`. Si instal·leu &kalarm; a `/usr/local`, haureu d'establir `KDEDIRS` a `/usr/local:/etc/opt/kde:/opt/kde` abans d'iniciar el &kde;.

La versió autònoma de &kalarm; té una opció de configuració especial que us permet seleccionar els idiomes de la documentació a instal·la especificant un codi d'idioma, o una llista de codis d'idioma, com un paràmetre a `./configure`. Per omissió, s'instal·la la documentació en tots els idiomes disponibles. En el paquet s'inclou una llista dels idiomes per a la documentació, amb els seus codis, es troba en el fitxer `DOC-LANGUAGES`. Per exemple, per instal·lar només la documentació en francès i anglès britànic:

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

Tingueu en compte que aquesta opció no té cap efecte sobre les traduccions que s'instal·lin per a la interfície d'usuari.

### Configuració

No es requereix cap configuració especial per configurar &kalarm; per funcionar a l'escriptori &kde;. Un cop executat &kalarm; per primera vegada, s'iniciarà cada vegada que accediu, per tal de supervisar les alarmes programades.

Per executar &kalarm; en un escriptori no &kde;, el requisit principal és assegurar-se que &kalarm; s'executa automàticament cada vegada que accediu. Obtindreu instruccions més detallades en el fitxer `INSTALL` que es distribueix amb &kalarm;.

&documentation.index;