<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Catalan  "INCLUDE"
><!-- change language only here -->
]>

<!-- The language must NOT be changed here. -->

<book id="kalarm" lang="&language;">

<bookinfo id="kalarminfo">
<title
>El manual del &kalarm;</title>

<authorgroup>
<author
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
> <address
>&David.Jarvie.mail;</address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
>&David.Jarvie.mail;</address
></affiliation>
<contrib
>Desenvolupador</contrib>
</othercredit>

&traductor.Antoni.Bella; 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year
><year
>2004</year
><year
>2005</year
><year
>2006</year
><year
>2007</year
><year
>2008</year
><year
>2009</year
><year
>2010</year
><year
>2011</year
><year
>2012</year
><year
>2013</year
><year
>2016</year
><year
>2018</year
><year
>2019</year
><year
>2020</year
><year
>2021</year
><year
>2022</year
><year
>2023</year
><year
>2024</year
><year
>2025</year>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>30 d'agost de 2025</date>
<releaseinfo
>3.12.0 (KDE Gear 25.12)</releaseinfo>

<abstract>
<para
>El &kalarm; és un planificador personal per a alarmes de missatge, ordre i correu electrònic creat per la comunitat &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarma</keyword>
<keyword
>recordatori</keyword>
<keyword
>planificador</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Introducció</title>

<para
>El &kalarm; 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.</para>

<para
>El &kalarm; mostra la llista d'alarmes pendents, mostrant els seus temps i els detalls. Podeu crear alarmes noves o seleccionar les existents per a la seva modificació o eliminació. De manera opcional, també podeu veure les alarmes expirades.</para>

<para
>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 a les alarmes visuals, podeu escriure un text de missatge, especificar un fitxer de text o d'imatge a mostrar, o especificar una ordre per a mostrar la seva sortida. També podeu triar el color del missatge d'alarma, i si reproduir un so o parlar el missatge.</para>

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

<para
>Quan venç un missatge d'alarma, si el sistema de finestres ho permet, es mostrarà a cada escriptori per a assegurar que no us el perdeu. La finestra de missatges mostrarà el temps durant el qual s'ha programat l'alarma. Normalment, disposa d'una opció d'ajornar per a demanar que es mostri de nou més tard. Un exemple d'un missatge d'alarma:</para>

<screenshot>
<screeninfo
>Captura de pantalla de la finestra de missatge del &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Missatge d'alarma</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>De manera opcional, un missatge d'alarma es podrà mostrar com a una notificació en lloc d'en una finestra.</para>

<para
>Quan l'alarma especifica una ordre a executar o un correu electrònic per a enviar, el &kalarm; no mostrarà res.</para>

<para
>El &kalarm; en general mostrarà una icona a la safata del sistema, encara que si voleu es pot ocultar.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Usar el &kalarm;</title>

<para
>Quan s'executa sense cap paràmetre a la línia d'ordres, el &kalarm; s'iniciarà en mode gràfic, i mostrarà la llista actual de les alarmes pendents.</para>

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

<mediaobject>
<imageobject>
<imagedata fileref="spinbox.png" format="PNG"/>
</imageobject>
</mediaobject>
</tip>

<sect1 id="alarm-types">
<title
>Tipus d'alarma</title>

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

<itemizedlist>
<listitem>
<para
>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.</para>
</listitem>

<listitem>
<para
>Les alarmes d'ordre executen bé una ordre o un script de l'intèrpret d'ordres. No es mostrarà res si es produeix un error.</para>
</listitem>

<listitem>
<para
>Les alarmes de correu envien un correu electrònic. No es mostrarà res si es produeix un error.</para>
</listitem>

<listitem>
<para
>Les alarmes d'àudio reprodueixen un fitxer d'àudio. No es mostrarà res si es produeix un error.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Gestió dels errors</title>

<para
>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).</para>

<para
>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 a les alarmes visuals si succeeix un error d'execució d'una pre o postalarma d'ordre especificada en el diàleg accions especials, excepte que el color de fons de la columna no canviarà a vermell.</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Llista d'alarmes</title>

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

<para
>Cal tenir en compte que la columna <guilabel
>Nom</guilabel
> només existirà si s'habilita l'ús dels noms de les alarmes a la pestanya <link linkend="preferences-general"
>General</link
> del diàleg de configuració.</para>

<screenshot>
<screeninfo
>Captura de pantalla de la finestra principal del &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Finestra principal</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Per a una alarma repetida, la llista mostra la seva pròxima hora d'activació programada i el seu interval de repetició bàsic (&pex;, «1 dia» per a una repetició diària, «3 setmanes» per a una repetició que s'activarà el dilluns i dimecres cada tres setmanes, «En entrar» per a una repetició d'alarma a cada inici de sessió).</para>

<para
>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 una ordre de pre o postalarma d'una alarma visual, es mostrarà una indicació d'error en el color de la columna, tal com s'ha descrit anteriorment a <link linkend="errors"
>Gestió dels errors</link
>.</para>

<sect2 id="listappear">
<title
>Canviar l'aparença de la llista d'alarmes</title>

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

<para
>De manera opcional, podeu mostrar el temps restant fins que es produeixi una alarma, juntament amb l'hora de l'alarma o en lloc d'aquesta.</para>

<para
>Podeu seleccionar les columnes que voleu mostrar o ocultar fent clic <mousebutton
>dret</mousebutton
> sobre les capçaleres de les columnes i utilitzant el menú contextual per a establir les columnes a mostrar. Però cal tenir en compte que almenys una de les columnes <guilabel
>Nom</guilabel
> o <guilabel
>Missatge, fitxer o ordre</guilabel
>, i almenys una de les columnes <guilabel
>Temps</guilabel
> o <guilabel
>Temps per a</guilabel
>, sempre es mostraran.</para>

<para
>Si utilitzeu diversos calendaris d'alarmes, podeu donar color al codi de les alarmes d'acord amb el calendari al qual pertanyen, seleccionant un color de fons diferent per a cada calendari (vegeu <link linkend="using-calendars"
>Usar els calendaris</link
>).</para>

</sect2>

<sect2 id="expired">
<title
>Les alarmes arxivades</title>

<para
>De manera predeterminada, el &kalarm; arxivarà 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 si s'han activat almenys una vegada). Podeu controlar si el &kalarm; haurà d'arxivar-les, i per quant de temps, en el <link linkend="preferences-storage"
>diàleg de configuració</link
>.</para>

<para
>Les alarmes arxivades es poden mostrar a la llista d'alarmes seleccionant <menuchoice
><guimenu
>Visualitza</guimenu
><guimenuitem
>Mostra les alarmes arxivades</guimenuitem
></menuchoice
>. Per a ocultar-les una altra vegada, desseleccioneu <menuchoice
><guimenu
>Visualitza</guimenu
><guimenuitem
>Mostra les alarmes arxivades</guimenuitem
></menuchoice
>.</para>

</sect2>

<sect2 id="datepicker">
<title
>Filtrar la llista d'alarmes per data</title>

<para
>Podeu restringir la llista d'alarmes per a només mostrar les alarmes que estan planificades per a ocórrer en una data seleccionada. Això s'aconsegueix mitjançant el selector de la data d'alarma, el qual es pot mostrar o ocultar amb l'element de menú <menuchoice
><guimenu
>Visualitza</guimenu
> <guimenuitem
>Mostra el selector de dates</guimenuitem
></menuchoice
>. Seleccioneu una data fent clic sobre seu en el selector de dates, o anul·leu la selecció fent clic de nou sobre seu. El selector de dates mostra un sol mes. Per a mostrar un mes diferent, utilitzeu els controls de fletxa que hi ha, o la roda del ratolí.</para>

</sect2>

<sect2 id="search">
<title
>Cercar a la llista d'alarmes</title>

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

<para
>La cerca es realitza de la manera següent:</para>

<itemizedlist>
<listitem>
<para
>Les alarmes de missatges de text: se cercarà al text del missatge.</para>
</listitem>

<listitem>
<para
>Les alarmes que mostren fitxers: se cercarà al camí/&URL; del fitxer.</para>
</listitem>

<listitem>
<para
>Les alarmes d'ordre: se cercarà la línia d'ordres o a l'script d'ordres.</para>
</listitem>

<listitem>
<para
>Les alarmes de correu: a més de l'assumpte i al cos del correu, se cercarà als destinataris i als &URL; dels adjunts.</para>
</listitem>

<listitem>
<para
>Les alarmes d'àudio: se cercarà al camí/&URL; del fitxer.</para>
</listitem>
</itemizedlist>

<note
><para
>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 a les alarmes arxivades, primer haureu de mostrar-les com es descriu en la secció anterior.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Crear i gestionar les alarmes</title>

<sect2>
<title
>Crear una alarma nova</title>

<para
>Per a crear una alarma nova, realitzeu una de les accions següents i, a continuació, seleccioneu el tipus d'alarma de la llista que apareix. Això mostrarà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> a través del qual la configurareu.</para>

<itemizedlist>
<listitem>
<para
>Seleccioneu <menuchoice
><guimenu
>Fitxer</guimenu
> <guimenuitem
>Nova</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre la icona de la safata del sistema i seleccioneu <menuchoice
><guimenuitem
>Alarma nova</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> en la llista d'alarmes i seleccioneu <menuchoice
><guimenuitem
>Nova</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

<para
>També podeu crear alarmes preconfigurades noves des de diverses fonts:</para>

<itemizedlist>
<listitem>
<para
>Per a preestablir la data de l'alarma en el <link linkend="alarm-edit-dlg"
>diàleg Edició de l'alarma</link
>, feu clic <mousebutton
>dret</mousebutton
> sobre la data desitjada en el gestor de dates d'alarma (vegeu <link linkend="datepicker"
>Filtrar la llista d'alarmes per data</link
>) i seleccioneu el tipus d'alarma adequat en el menú contextual.</para>
</listitem>

<listitem>
<para
>Per a basar la vostra alarma nova en una plantilla d'alarma, seguiu les instruccions a la secció <link linkend="templates"
>Plantilles d'alarma</link
>.</para>
</listitem>

<listitem>
<para
>Per a basar la vostra alarma nova en una existent, ressalteu-la a la llista i seleccioneu <menuchoice
><guimenu
>Fitxer</guimenu
><guimenuitem
>Copia</guimenuitem
></menuchoice
>. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> ja omplert amb una còpia dels detalls de l'alarma seleccionada.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma nova que mostri un missatge de correu electrònic existent, arrossegueu-lo des del &kmail; cap a la finestra principal del &kalarm;. Després seleccioneu l'opció <guilabel
>Mostra l'alarma</guilabel
>. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> amb tot el missatge de correu electrònic (incloent-hi el remitent, destinatari, &etc;) com al text de l'alarma.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma nova de correu electrònic per a enviar una còpia d'un missatge de correu electrònic existent, arrossegueu-lo des del &kmail; cap a la finestra principal del &kalarm;. A continuació, seleccioneu l'opció <guilabel
>Alarmes de correu</guilabel
>. El <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> estarà preconfigurat amb tot el missatge de correu electrònic, excepte el remitent.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma nova que mostri un resum d'una tasca pendent existent, arrossegueu-la des del &korganizer; o una altra aplicació cap a la finestra principal del &kalarm;. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> amb el contingut de la tasca pendent com a text de l'alarma.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma d'ordre nova arrossegueu el text d'un script que comenci amb «#!» cap a la finestra principal del &kalarm;. A continuació, seleccioneu l'opció <guilabel
>Alarma d'ordre</guilabel
>. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> preconfigurat amb el text de l'script.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma visual de fitxer, arrossegueu un text o &URL; de fitxer d'imatge cap a la finestra principal del &kalarm;. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> i s'establirà el nom de fitxer.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma d'àudio, arrossegueu un &URL; de fitxer d'àudio cap a la finestra principal del &kalarm;. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> i s'establirà el nom de fitxer.</para>
</listitem>

<listitem>
<para
>Per a crear una alarma de missatge de text, arrossegueu una peça de text cap a la finestra principal del &kalarm;. Si se us demana, seleccioneu l'opció <guilabel
>Mostra l'alarma</guilabel
>. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> preconfigurat amb tot el text de l'alarma.</para>
</listitem>

<listitem>
<para
>Podeu crear automàticament alarmes d'aniversari per a les persones al &kaddressbook; tal com es descriu en <link linkend="birthdays"
>Importar aniversaris des del &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Modificar una alarma existent</title>

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

<itemizedlist>
<listitem>
<para
>Feu doble clic sobre la seva entrada a la llista d'alarmes.</para>
</listitem>

<listitem>
<para
>Seleccioneu-la fent clic sobre la seva entrada a la llista d'alarmes. A continuació, escolliu <menuchoice
><guimenu
>Edita</guimenu
> <guimenuitem
>Edita</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre la seva entrada a la llista d'alarmes i escolliu <menuchoice
><guimenuitem
>Edita</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

<para
>Això mostrarà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>.</para>

</sect2>

<sect2>
<title
>Suprimir/reactivar una alarma</title>

<para
>Per a 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 accions següents:</para>

<itemizedlist>
<listitem>
<para
>Escolliu <menuchoice
><guimenu
>Edita</guimenu
><guimenuitem
>Suprimeix</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre les entrades seleccionades i escolliu <menuchoice
><guimenuitem
>Suprimeix</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
<listitem>
<para
>Per a suprimir-les sense un missatge de confirmació, premeu &Maj;-<keycap
>Supr</keycap
>.</para>
</listitem>
</itemizedlist>

<para
>Quan se suprimeix una alarma activa, aquesta serà arxivada, sempre que s'hagi activat almenys una vegada abans de ser suprimida, i sempre s'arxivaran totes les alarmes expirades. (Utilitzeu el <link linkend="preferences-storage"
>diàleg de configuració</link
> per a controlar si s'han d'arxivar les alarmes i durant quant de temps s'emmagatzemaran). Quan se suprimeix una alarma arxivada, o una alarma habilitada que encara no s'ha activat, aquesta se suprimirà permanentment.</para>

<para
>Podeu reactivar una alarma suprimida des de la llista d'alarmes arxivades, sempre que encara no hagi expirat. Per a fer-ho, en primer lloc mostreu les alarmes arxivades, tal com es descriu en <link linkend="expired"
>alarmes arxivades</link
>. Llavors:</para>

<itemizedlist>
<listitem>
<para
>Seleccioneu una o més alarmes arxivades apropiades fent clic a les seves entrades a la llista d'alarmes. A continuació, escolliu <menuchoice
> <guimenu
>Accions</guimenu
><guimenuitem
>Reactiva</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre les entrades en qüestió a la llista d'alarmes arxivades i escolliu <menuchoice
><guimenuitem
>Reactiva</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Habilitar i inhabilitar una alarma</title>

<para
>Vegeu <link linkend="enable-disable"
>Habilitar i inhabilitar les alarmes</link
> per a saber com habilitar i inhabilitar-les, sigui individualment o en conjunt.</para>

</sect2>

<sect2>
<title
>Establir una alarma a activar des de l'estat de suspensió</title>

<para
>Vegeu <link linkend="wake-suspend"
>Activar de l'estat de suspensió</link
> per a saber com configurar una alarma que activi el vostre sistema des dels seus estats de suspensió o hibernació.</para>

</sect2>

<sect2>
<title
>Reconèixer una alarma</title>

<para
>Vegeu <link linkend="message-display"
>Visualitzar el missatge de l'alarma</link
> per a saber com reconèixer les alarmes.</para>

</sect2>

<sect2 id="templates">
<title
>Plantilles d'alarma</title>

<para
>Si voleu configurar amb freqüència alarmes similars, podeu crear una plantilla d'alarma per a 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.</para>

<para
>A tall d'exemple, potser voldreu configurar una alarma regularment perquè 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, sigui per a reproduir un so, &etc;) a excepció de l'hora i la data. Ara, per a crear l'alarma, tot el que necessitareu fer és obrir el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> amb aquesta plantilla i després introduïu l'hora i la data.</para>

<para
>Per a crear una alarma basada en una plantilla, obriu el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> preconfigurat amb els detalls de la plantilla:</para>

<itemizedlist>
<listitem>
<para
>Seleccioneu l'element de menú <menuchoice
> <guimenu
>Fitxer</guimenu
><guimenuitem
>Nova</guimenuitem
> <guimenuitem
>Alarma nova des d'una plantilla</guimenuitem
> </menuchoice
>, i seleccioneu la plantilla desitjada.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre la icona de la safata del sistema i escolliu <menuchoice
><guimenuitem
>Alarma nova</guimenuitem
> <guimenuitem
>Alarma nova des d'una plantilla</guimenuitem
></menuchoice
> des del menú contextual. A continuació, seleccioneu la plantilla desitjada.</para>
</listitem>

<listitem>
<para
>S'obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> de la forma habitual, i feu clic al botó <guibutton
>Carrega una plantilla...</guibutton
> per a seleccionar una plantilla amb què preconfigurar el diàleg.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Configurar les plantilles</title>

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

<para
>Per a crear una plantilla d'alarma nova, realitzeu una de les accions següents:</para>

<itemizedlist>
<listitem>
<para
>Mostreu el diàleg Plantilles d'alarma, seleccioneu l'element de menú <menuchoice
> <guimenu
>Fitxer</guimenu
><guimenuitem
>Plantilles...</guimenuitem
></menuchoice
>, feu clic a <guibutton
>Nova</guibutton
>, i escolliu el tipus d'alarma de la llista que apareixerà. Això mostrarà un diàleg d'edició de la plantilla en blanc.</para>
</listitem>

<listitem>
<para
>Mostreu el diàleg Plantilles d'alarma, seleccioneu l'element de menú <menuchoice
> <guimenu
>Fitxer</guimenu
><guimenuitem
>Plantilles...</guimenuitem
> </menuchoice
>, seleccioneu una plantilla existent de la llista i feu clic a <guibutton
>Copia</guibutton
>. Això obrirà el diàleg d'edició de la plantilla completat amb una còpia dels detalls de la plantilla existent.</para>
</listitem>

<listitem>
<para
>Ressalteu una alarma a la llista d'alarmes i seleccioneu <menuchoice
> <guimenu
>Fitxer</guimenu
><guimenuitem
>Crea una plantilla...</guimenuitem
></menuchoice
>. Això obrirà el diàleg d'edició de la plantilla completat amb una còpia dels detalls de l'alarma seleccionada.</para>
</listitem>
</itemizedlist>

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

<para
>Per a suprimir les plantilles existents, mostreu el diàleg Plantilles d'alarma seleccionant l'element de menú <menuchoice
> <guimenu
>Fitxer</guimenu
><guimenuitem
>Plantilles...</guimenuitem
> </menuchoice
>, seleccioneu-ne una o més i feu clic a <guibutton
>Suprimeix</guibutton
>. Es mostrarà un missatge de confirmació per a evitar supressions accidentals.</para>

</sect3>

<sect3>
<title
>El diàleg d'edició de la plantilla</title>

<para
>El diàleg d'edició de la plantilla és similar al <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>. Els controls següents són diferents:</para>

<itemizedlist>
<listitem>
<para
>Introduïu el seu nom en <guilabel
>Nom de la plantilla</guilabel
>. É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 haurà de ser únic.</para>
</listitem>

<listitem>
<para
>En el grup de caselles <guilabel
>Hora</guilabel
>, escolliu una de:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Hora predeterminada</guilabel
> si no voleu especificar cap moment d'activació. Les alarmes basades en aquesta plantilla utilitzaran inicialment l'hora d'activació predeterminada normal per a les alarmes noves.</para>
</listitem>

<listitem>
<para
>Marcar <guilabel
>Hora</guilabel
> per a introduir un moment en què s'activi l'alarma.</para>
</listitem>

<listitem>
<para
>Marcar <guilabel
>Només data</guilabel
> per a especificar que l'alarma només haurà de tenir una data, no una hora.</para>
</listitem>

<listitem>
<para
>Marcar <guilabel
>Temps des d'ara</guilabel
> per a introduir el temps (en hores i minuts) des que s'ha creat l'alarma, i en el qual s'hauria d'activar.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>En el grup de caselles <guilabel
>Regla de recurrència</guilabel
> a la pestanya <guilabel
>Recurrència</guilabel
>, no necessiteu seleccionar dia o mes per a les recurrències setmanal o anual, respectivament.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Calendaris d'alarmes</title>

<para
>Si només feu servir un ordinador i treballeu de forma independent, potser no us farà res que el &kalarm; emmagatzemi les alarmes. Però si necessiteu accedir a les alarmes en més d'un ordinador, o en més d'una ubicació des de l'ordinador local, podeu definir «calendaris d'alarmes» per a indicar-li al &kalarm; que utilitzi altres calendaris d'alarmes addicionals per a, o en substitució del/s predeterminat/s.</para>

<para
>Podeu veure i gestionar els calendaris a través de la llista de calendaris, els quals es poden mostrar juntament amb la llista d'alarmes a la finestra principal del &kalarm;. Les alarmes de tots els calendaris d'alarmes es mostraran fusionades a la llista d'alarmes. Quan es desa una alarma nova, podeu definir una opció de configuració per a determinar si s'ha de desar automàticament en el calendari predeterminat, 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'alarmes original.</para>

<screenshot>
<screeninfo
>Captura de pantalla de la finestra principal de &kalarm; mostrant la llista de calendaris</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Finestra principal mostrant la llista de calendaris</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Tipus de calendari i opcions</title>

<para
>Els calendaris d'alarmes es classifiquen per tipus d'alarma i el tipus d'emmagatzematge. Després es poden inhabilitar, establir a només lectura, o fer el calendari predeterminat per al seu tipus d'alarma.</para>

<variablelist>
<varlistentry>
<term
>Tipus d'alarma</term>
<listitem>
<para
>Els tres tipus d'entitats d'alarma -alarmes activades, alarmes arxivades i plantilles d'alarma- s'emmagatzemen en calendaris d'alarmes separats. El &kalarm; disposa de tres tipus estàndard de calendaris predeterminats, un per a cada tipus (vegeu <link linkend="faq"
>Preguntes i respostes</link
> per a més detalls), el qual podeu canviar si ho voleu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Tipus d'emmagatzematge</term>
<listitem>
<para
>El &kalarm; gestiona dos tipus d'emmagatzematge per als calendaris d'alarmes:</para>

<itemizedlist>
<listitem
><para
>Fitxer local: Les alarmes s'emmagatzemen en un únic fitxer local en format iCalendar. De manera predeterminada, el &kalarm; utilitza calendaris de fitxer local (vegeu <link linkend="faq"
>Preguntes i respostes</link
> per a més detalls). «Fitxers locals», a més dels fitxers en l'equip local, poden incloure els calendaris d'alarmes a la xarxa local, així com la seva ubicació es pot representar per un nom de camí que comenci per <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Fitxer remot: Les alarmes s'emmagatzemen en un fitxer remot únic en format iCalendar. Aquest mètode d'emmagatzematge permet accedir a les dades de les alarmes de forma remota, sigui on sigui, o permet que altres persones visualitzin els calendaris d'alarma. Quan s'utilitzen fitxers remots, el &kalarm; funciona amb una còpia local de les dades.</para>

<warning
><para
>El &kalarm; no controla els canvis dels calendaris d'alarma remots, de manera que si els canvis els fa algú altre, el &kalarm; podria sobreescriure'ls. Per a evitar-ho, es recomana adoptar qualsevol de les polítiques següents:</para>
<itemizedlist>
<listitem
><para
>Assegurar-se que només una persona o sol·licitud accedeixi al calendari en qualsevol moment.</para
></listitem>
<listitem
><para
>Tots els usuaris que no siguin el propietari del calendari haurien de configurar el calendari com de només de lectura.</para
></listitem>
</itemizedlist>
<para
>Altrament, com a mínim hauríeu de tornar a carregar el calendari abans de canviar-lo o confiar en el seu contingut, utilitzant el mètode descrit a <link linkend="using-calendars"
>Usar els calendaris</link
>. Tingueu en compte també que si el calendari està configurat com de lectura-escriptura, el &kalarm; el sobreescriurà sempre que s'activi una alarma. </para
></warning>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estat habilitat/inhabilitat</term>
<listitem>
<para
>Inhabilitar un calendari té el mateix efecte que eliminar-lo, excepte que encara apareixerà a la llista de calendaris per a facilitar tornar-lo a habilitar. Quan s'inhabilita, les alarmes seran ignorades i no apareixeran a la llista d'alarmes o a la llista de plantilles. Quan es torna a habilitar, les seves alarmes es tornaran a mostrar i, si es tracta d'un calendari amb alarmes actives, s'activaran.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estat de només lectura</term>
<listitem>
<para
>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 serà possible ajornar-les, ja que per a això seria necessari el temps d'ajornament que es desa a l'alarma. Quan s'activen les seves alarmes, no s'eliminaran del calendari i seran arxivades fins que vós o un altre usuari accedeixi al calendari en mode de lectura i escriptura.</para>

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

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

<listitem
><para
>Si el calendari es va crear amb una versió posterior del &kalarm;, les dades es podrien perdre actualitzant-lo des de la vostra versió del &kalarm;.</para>
</listitem>

<listitem
><para
>Si el calendari es va crear amb una versió antiga del &kalarm;, les dades es podrien perdre actualitzant-lo des de la vostra versió del &kalarm;. 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 del &kalarm; necessita accedir-hi de nou.</para>
</listitem>

<listitem
><para
>Si no teniu permisos per a escriure al fitxer o carpeta de calendari.</para>
</listitem>
</itemizedlist>

<para
>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ó <menuchoice
><guimenuitem
>Importa...</guimenuitem
></menuchoice
> des del menú contextual (vegeu <link linkend="import"
>Importar les alarmes des de calendaris externs</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estat del calendari predeterminat</term>
<listitem>
<para
>Un calendari de cada tipus d'alarma es pot fer opcionalment el calendari predeterminat per a aquest tipus d'alarma. Les alarmes noves es desaran automàticament al calendari predeterminat per al tipus d'alarma apropiat, llevat que s'hagi seleccionat l'opció de preguntar per a les alarmes noves i plantilles en el <link linkend="preferences-storage"
>diàleg de configuració</link
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="using-calendars">
<title
>Usar els calendaris</title>

<para
>Podeu veure i gestionar els calendaris a través de la llista de calendaris, els quals es poden mostrar o ocultar amb l'element de menú <menuchoice
> <guimenu
>Visualitza</guimenu
><guimenuitem
>Mostra els calendaris</guimenuitem
> </menuchoice
>. Quan utilitzeu 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 <mousebutton
>dret</mousebutton
> sobre el calendari apropiat en la llista i escolliu un element des del menú contextual. Les accions disponibles són:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Afegeix...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>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, des d'on podreu introduir la ubicació del calendari i les seves característiques. Si no hi ha cap calendari d'alarmes existent a la ubicació especificada, se'n crearà un de nou.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Elimina</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Elimina el calendari seleccionat de 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Edita...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Edita el calendari seleccionat. Això mostrarà el diàleg de configuració del calendari seleccionat.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Torna a carregar</guimenuitem
></menuchoice
></term>
<listitem>
<para
>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 el &kalarm; i l'estat actual del calendari. Si el calendari és compartit amb altres usuaris, qualsevol canvi realitzat serà vist pel &kalarm;.</para>

<warning
><para
>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.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importa...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importa les alarmes des de fitxers de calendari externs al calendari seleccionat. Això es descriu a <link linkend="import"
>Importar alarmes des de calendaris externs</link
>. Aquesta opció no està disponible per als calendaris inhabilitats o de només lectura.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Exporta...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Exporta totes les alarmes en el calendari seleccionat a un fitxer de calendari extern. Això es descriu a <link linkend="export"
>Exportar les alarmes a calendaris externs</link
>. Aquesta opció no està disponible per als calendaris inhabilitats.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Mostra els detalls</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Mostra els detalls quant al calendari seleccionat. Això mostrarà informació sobre la ubicació del calendari, el tipus d'emmagatzematge i el seu estat. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Usa com a predeterminat</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Fa que el calendari seleccionat sigui el calendari predeterminat per al tipus de calendari seleccionat. Aquesta opció no està disponible per als calendaris inhabilitats o de només lectura.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Indica un color...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Seleccioneu un color de fons per a ressaltar les alarmes d'aquest calendari a la llista d'alarmes. Això us permetrà veure quines alarmes pertanyen a un calendari determinat.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Neteja el color</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Neteja el color de ressaltat per a les alarmes d'aquest calendari a la llista d'alarmes. L'opció només apareixerà després que s'hagi utilitzat <guimenuitem
>Indica un color</guimenuitem
> en aquest calendari.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Importar les alarmes des de calendaris externs</title>

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

<itemizedlist>
<listitem>
<para
>Utilitzeu <menuchoice
><guimenu
>Fitxer</guimenu
> <guimenuitem
>Importa les alarmes...</guimenuitem
></menuchoice
> per a importar les alarmes de tot tipus (alarmes actives, alarmes arxivades i plantilles d'alarma) des de fitxers de calendari.</para>

<para
>Si heu configurat <link linkend="calendars"
>calendaris d'alarmes</link
>, les alarmes de cada tipus s'afegiran al calendari predeterminat adequat, o si s'ha seleccionat l'opció de preguntar per a les alarmes i plantilles noves en el <link linkend="preferences-storage"
>diàleg de configuració</link
>, se us demanarà pel calendari a utilitzar.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre un calendari a la llista de calendaris, i escolliu <menuchoice
><guimenuitem
>Importa...</guimenuitem
></menuchoice
> des del menú contextual. Això importarà les alarmes del tipus seleccionat a aquest calendari. Per exemple, si el tipus de calendari seleccionat és plantilles d'alarma, seran importades les plantilles d'alarma (i no les alarmes actives o les alarmes arxivades).</para>
</listitem>
</itemizedlist>

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

</sect2>

<sect2 id="export">
<title
>Exportar les alarmes a calendaris externs</title>

<para
>Podeu exportar les alarmes del &kalarm; a altres fitxers de calendari, ja siguin les alarmes seleccionades a la llista d'alarmes, o totes les alarmes d'un calendari d'alarmes. Els mètodes per a 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 a afegir-les, marqueu <guilabel
>Annexa a un fitxer existent</guilabel
> en el diàleg de selecció de fitxers. En cas contrari, se sobreescriurà qualsevol fitxer existent.</para>

<itemizedlist>
<listitem>
<para
>Per a exportar les alarmes actualment seleccionades a la llista d'alarmes, feu clic <mousebutton
>dret</mousebutton
> sobre la selecció i escolliu <menuchoice
><guimenuitem
>Exporta...</guimenuitem
></menuchoice
> des del menú contextual, o utilitzeu <menuchoice
><guimenu
>Fitxer</guimenu
> <guimenuitem
>Exporta les alarmes seleccionades...</guimenuitem
></menuchoice
> al menú principal.</para>
</listitem>

<listitem>
<para
>Per a exportar totes les alarmes des d'un calendari, feu clic <mousebutton
>dret</mousebutton
> sobre un calendari a la llista de calendaris, i escolliu <menuchoice
><guimenuitem
>Exporta...</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Importar les dates de naixement des del &kaddressbook;</title>

<note
><para
>Aquesta funció només està disponible si s'ha instal·lat i activat el <link linkend="akonadi-plugin"
>connector de l'Akonadi</link
> del &kalarm;.</para>
</note>

<para
>Podeu definir les alarmes visuals per a les dates de naixement desades al &kaddressbook;, emprant <menuchoice
><guimenu
>Fitxer</guimenu
> <guimenuitem
>Importa les dates de naixement...</guimenuitem
></menuchoice
>. Això mostrarà un diàleg que us permetrà seleccionar per a quines dates de naixement crear alarmes.</para>

<itemizedlist>
<listitem>
<para
>En el grup de caselles <guilabel
>Text de l'alarma</guilabel
>, podreu 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ó del text de <guilabel
>Prefix</guilabel
>, seguit del nom de la persona, seguit del text de <guilabel
>Sufix</guilabel
>. No s'afegiran espais, de manera que recordeu incloure qualsevol espai necessari al final de <guilabel
>Prefix</guilabel
> i al començament de <guilabel
>Sufix</guilabel
>.</para>

<note
><para
>Si canvieu el text de l'alarma, es tornarà a avaluar la llista de selecció de la data de naixement.</para
></note>
</listitem>

<listitem>
<para
>A la llista <guilabel
>Selecció de les dates de naixement</guilabel
>, seleccioneu les dates de naixement per a les que voleu crear alarmes. Cal tenir en compte que la llista només mostrarà les entrades del &kaddressbook; que continguin una data de naixement i que encara no tinguin una alarma en el format actualment definit en el grup de caselles <guilabel
>Text de l'alarma</guilabel
>.</para>
</listitem>

<listitem>
<para
>La resta de controls són els mateixos que per a les alarmes de <guilabel
>Text</guilabel
> en el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>.</para>
</listitem>
</itemizedlist>

<para
>Si heu configurat els <link linkend="calendars"
>calendaris d'alarmes</link
>, les alarmes s'afegiran al calendari predeterminat d'alarmes actiu, o si s'ha seleccionat l'opció de preguntar per a les alarmes i plantilles noves en el <link linkend="preferences-storage"
>diàleg de configuració</link
>, se us demanarà pel calendari a utilitzar.</para>
</sect2>

<sect2 id="undo">
<title
>Desfer/refer</title>

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

<para
>Per a desfer l'últim canvi, seleccioneu <menuchoice
> <guimenu
>Edita</guimenu
><guimenuitem
>Desfés</guimenuitem
></menuchoice
>. Per a refer l'últim canvi que s'ha desfet, seleccioneu <menuchoice
> <guimenu
>Edita</guimenu
><guimenuitem
>Refés</guimenuitem
> </menuchoice
>.</para>

<para
>Per a desfer un canvi que no sigui l'últim, feu clic al botó <guibutton
>Desfés</guibutton
> a la barra d'eines i manteniu premut el botó del ratolí. Es mostrarà una llista d'accions des de la 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 quals depèn el canvi desitjat. Per exemple, podeu editar una alarma i després suprimir-la, no podreu desfer l'edició fins no haver desfet la supressió.</para>

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

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>El diàleg d'edició de l'alarma</title>

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

<para
>Podeu configurar els valors predeterminats de moltes de les opcions en el diàleg d'edició de l'alarma utilitzant la <link linkend="preferences-edit"
>pestanya Edita del diàleg de configuració</link
>.</para>

<screenshot>
<screeninfo
>Captura de pantalla del diàleg d'edició de l'alarma simplificat</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>El diàleg d'edició de l'alarma simplificat per a una alarma visual</phrase>
</textobject>
<caption
><para
>El diàleg d'edició de l'alarma simplificat per a una alarma visual</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Captura de pantalla del diàleg d'edició de l'alarma mostrant totes les opcions</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>El diàleg d'edició de l'alarma per a una alarma visual, mostrant totes les opcions</phrase>
</textobject>
<caption
><para
>El diàleg d'edició de l'alarma per a una alarma visual, mostrant totes les opcions</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Nom de l'alarma</title>

<para
>Podeu donar un nom a l'alarma en el camp <guilabel
>Nom de l'alarma</guilabel
>. Aquest és útil per a ajudar-vos a identificar l'alarma amb més facilitat. No cal que introduïu un nom i no cal que sigui únic.</para>

<para
>Cal tenir en compte que aquest camp només existirà si s'habilita l'ús dels noms de les alarmes a la pestanya <link linkend="preferences-general"
>General</link
> del diàleg de configuració.</para>

</sect2>

<sect2>
<title
>Acció de l'alarma</title>

<para
>Els controls en el grup de caselles <guilabel
>Acció</guilabel
> variaran en funció del tipus d'alarma que s'està editant.</para>

<sect3>
<title
>Alarmes visuals</title>

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

<itemizedlist>
<listitem>
<para
><guilabel
>Missatge de text</guilabel
> per tal d'introduir un text per al missatge d'alarma (el qual podrà incloure salts de línia) al quadre d'edició.</para>
</listitem>

<listitem>
<para
><guilabel
>Contingut del fitxer</guilabel
> per a 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 a mostrar un diàleg de selecció de fitxers. L'opció <guilabel
>Pronuncia</guilabel
> no estarà disponible per a aquest tipus d'alarma.</para>
</listitem>

<listitem>
<para
><guilabel
>Sortida de l'ordre</guilabel
> per a especificar que el text del missatge d'alarma serà generat per una ordre que s'executarà quan s'activi l'alarma. Vegeu <link linkend="command-alarm"
>Alarmes d'ordre</link
> per als detalls sobre com introduir l'ordre o script d'ordres a executar.</para>
</listitem>
</itemizedlist>

<para
>Els controls disponibles per a les alarmes visuals són:</para>

<itemizedlist>
<listitem>
<para
>L'opció <guilabel
>So</guilabel
> permet seleccionar si ha de sonar l'alarma quan es mostri el missatge d'alarma. Escolliu:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Cap</guilabel
> per a mostrar l'alarma silenciosament.</para>
</listitem>

<listitem>
<para
><guilabel
>Timbre </guilabel
> perquè soni un timbre.</para>
</listitem>

<listitem>
<para
><guilabel
>Pronuncia</guilabel
> perquè el missatge d'alarma es pronunciï i es mostri. Aquesta opció només està disponible si el &kalarm; s'ha construït amb el «speech» activat, i estigui instal·lat i funcionant el mòdul Speech de les &Qt;.</para>
</listitem>

<listitem>
<para
><guilabel
>Fitxer de so</guilabel
> per a reproduir un fitxer d'àudio. Utilitzeu el botó de la dreta per a mostrar el diàleg de fitxers de so que us permetrà seleccionar un fitxer per a 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.</para>

<para
>En el diàleg de fitxers de so:</para>

<itemizedlist>
<listitem>
<para
>Escriviu el camí del fitxer de so o utilitzeu el botó al costat del quadre d'edició per a 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ó canviarà la funció per a permetre-us aturar la reproducció.</para>
</listitem>

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

<listitem>
<para
>Marqueu <guilabel
>Volum</guilabel
> i ajusteu el control lliscant si voleu ajustar el volum del fitxer d'àudio a reproduir.</para>
</listitem>

<listitem>
<para
>Si el dorsal d'àudio que s'està utilitzant ho admet, podeu esvair el volum. Esvaïment significa començar a reproduir el fitxer d'àudio en un volum i canviar gradualment al volum final, en un interval de temps especificat. El volum final és el que s'ha introduït més amunt a <guilabel
>Volum</guilabel
>. Per a activar l'esvaïment, marqueu <guilabel
>Esvaïment</guilabel
>, i després introduïu el període d'esvaïment en segons en el camp <guilabel
>Temps d'esvaïment</guilabel
>, i ajusteu el control lliscant <guilabel
>Volum inicial</guilabel
>.</para>
</listitem>
</itemizedlist>

<tip
><para
>Podeu utilitzar el botó <guibutton
>Prova</guibutton
> per a provar els nivells de so seleccionats.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Utilitzeu el botó <guibutton
>Lletra i color...</guibutton
> per a seleccionar una lletra, i els colors de primer pla i de fons, per al missatge d'alarma. En el diàleg <guilabel
>Escolliu la lletra i color de l'alarma</guilabel
>, marqueu <guilabel
>Usa la lletra predeterminada</guilabel
> per a mostrar el missatge en qualsevol lletra configurada com a predeterminada en el moment en què es mostri el missatge. Per a escollir una lletra específica per al missatge, desmarqueu <guilabel
>Usa la lletra predeterminada</guilabel
>. (La lletra predeterminada i els colors es poden establir en el <link linkend="preferences-edit"
>diàleg de configuració</link
>).</para>

<para
>Els colors seleccionats es mostraran en el camp d'entrada de text del missatge d'alarma.</para>
</listitem>

<listitem>
<para
>L'opció <guilabel
>Mètode de visualització</guilabel
> permet seleccionar com es mostrarà l'alarma. Escolliu:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Finestra</guilabel
> per a mostrar l'alarma en una finestra. Aquesta opció permet utilitzar tot l'interval d'opcions quan es configura l'alarma.</para>
</listitem>

<listitem>
<para
><guilabel
>Notificació</guilabel
> per a utilitzar el sistema de notificació estàndard per a mostrar el missatge de l'alarma. A causa de les limitacions del sistema de notificació, les opcions següents de configuració de l'alarma no es poden utilitzar amb les notificacions: establir la lletra i color, establir un fitxer d'àudio perquè es reprodueixi quan es mostra l'alarma, confirmació del reconeixement de l'alarma, tancament automàtic de la pantalla en expirar el temps de cancel·lació.</para>
</listitem>
</itemizedlist>

<para
>Vegeu <link linkend="message-display"
>Visualitzar el missatge de l'alarma</link
> per a obtenir més detalls sobre com es mostren els missatges d'alarma.</para>
</listitem>

<listitem>
<para
>Utilitzeu el botó <guibutton
>Accions especials...</guibutton
> per a especificar ordres de l'intèrpret d'ordres a executar abans o després de mostrar l'alarma. Al diàleg <guilabel
>Accions especials de l'alarma</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>En el camp <guilabel
>Acció de prealarma</guilabel
>, introduïu una ordre de línia d'ordres a executar abans de mostrar l'alarma. Cal tenir en compte que el &kalarm; esperarà fins que es completi l'ordre abans de mostrar l'alarma.</para>

<para
>Una acció de prealarma només s'executarà una vegada quan es mostri inicialment el missatge d'alarma, fins i tot quan un missatge de recordatori substitueix el missatge d'alarma real. <emphasis
>No</emphasis
> s'executarà en cap de les circumstàncies següents:</para>

<itemizedlist>
<listitem
><para
>Quan es mostri un missatge de recordatori.</para
></listitem>
<listitem
><para
>Quan es torni a mostrar el missatge després de posposar l'alarma, a menys que <guilabel
>Executa per a les alarmes ajornades</guilabel
> estigui marcada.</para
></listitem>
<listitem
><para
>Quan es mostri el missatge en el moment de tancar la sessió i després es restaura quan hi torneu a accedir.</para
></listitem>
<listitem
><para
>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.</para
></listitem>
</itemizedlist>

<para
>L'acció de prealarma es pot utilitzar per a controlar si es mostrarà el missatge d'alarma:</para>

<itemizedlist>
<listitem
><para
>Marqueu <guilabel
>Cancel·la l'alarma en cas d'error</guilabel
> per a cancel·lar l'alarma si l'ordre de prealarma retorna un estat d'error. Això evitarà que es mostri el missatge d'alarma i s'executi qualsevol acció de postalarma.</para
></listitem>

<listitem
><para
>Normalment, si l'ordre de prealarma retorna un error, es mostrarà un missatge d'error i veureu una indicació d'error a la llista d'alarmes. Aquestes notificacions d'error es poden prevenir marcant <guilabel
>No notificar els errors</guilabel
>.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>En el camp <guilabel
>Acció de postalarma</guilabel
>, introduïu l'ordre a executar quan es reconegui l'alarma (bé feu clic a <guibutton
>Tanca</guibutton
> o utilitzeu el botó de tancar a la barra de títol de la finestra). <emphasis
>No</emphasis
> s'executarà en qualsevol de les circumstàncies següents:</para>

<itemizedlist>
<listitem
><para
>Quan es tanca un missatge de recordatori.</para
></listitem>
<listitem
><para
>En posposar l'alarma, excepte quan l'alarma ajornada sigui finalment reconeguda.</para
></listitem>
<listitem
><para
>Quan es tanca el missatge d'alarma a causa de sortir de la sessió.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Vegeu <link linkend="command-alarm"
>Alarmes d'ordre</link
> a continuació per als detalls sobre com s'executen les ordres a la línia d'ordres.</para>

</listitem>
</itemizedlist>
</sect3>

<sect3 id="command-alarm">
<title
>Alarmes d'ordre</title>

<para
>Les alarmes d'ordre executen una ordre sense mostrar cap missatge d'alarma.</para>

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

<para
>Quan s'executa l'ordre, la variable d'entorn <envar
>KALARM_UID</envar
> contindrà l'UID de l'esdeveniment per a l'alarma. Cal tenir en compte que quan s'executa l'ordre des del botó <guibutton
>Prova</guibutton
> en el diàleg d'edició de l'alarma, la <envar
>KALARM_UID</envar
> 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.</para>

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

<itemizedlist>
<listitem>
<para
>La casella de selecció <guilabel
>Introduïu un script</guilabel
> permet escollir introduir una ordre de línia d'ordres o un script.</para>

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

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

<listitem
><para
>Si l'ordre retorna un error, de manera normal es mostrarà un missatge d'error i veureu una indicació d'error a la llista d'alarmes. El missatge de notificació d'error es pot prevenir marcant <guilabel
>No notificar els errors</guilabel
>.</para
></listitem>

<listitem>
<para
>Utilitzeu el grup de caselles <guilabel
>Sortida de l'ordre</guilabel
> per a especificar el que voleu fer amb qualsevol sortida de terminal que produeixi l'ordre quan s'executi.</para>

<itemizedlist>
<listitem>
<para
>Marqueu <guilabel
>Executa en una finestra de terminal</guilabel
> per a 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 <link linkend="preferences-general"
>diàleg de configuració</link
>.</para>
</listitem>

<listitem>
<para
>Marqueu <guilabel
>Registra a un fitxer</guilabel
> per a 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 del fitxer en el quadre d'edició, o utilitzeu el botó al costat del quadre d'edició per a mostrar un diàleg de selecció de fitxers.</para>
</listitem>

<listitem>
<para
>Marqueu <guilabel
>Descarta</guilabel
> per a descartar la sortida de l'ordre.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>Alarmes de correu</title>

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

<para
>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 a veure la vostra llibreta d'adreces del &kde;, des de la qual podreu seleccionar els destinataris del correu electrònic (tingueu en compte que el botó només es mostrarà si s'ha instal·lat i activat el <link linkend="akonadi-plugin"
>connector de l'Akonadi</link
> del &kalarm;). Es poden afegir adjunts utilitzant el botó <guibutton
>Afegeix...</guibutton
>. Cal tenir 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 a eliminar un fitxer, seleccioneu-lo a la llista desplegable i feu clic al botó <guibutton
>Elimina</guibutton
>.</para>

<para
>Establiu les opcions següents:</para>

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

<listitem>
<para
>Marqueu <guilabel
>Còpia del correu a mi mateix</guilabel
> per a enviar una còpia oculta del correu a vós mateix quan s'activi l'alarma. L'adreça de correu electrònic a la qual s'enviarà la còpia es pot establir en el <link linkend="preferences-email"
>diàleg de configuració</link
>, de manera predeterminada serà la vostra adreça de correu electrònic establerta al &kmail;.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Alarmes d'àudio</title>

<para
>Les alarmes d'àudio reprodueixen un fitxer d'àudio sense mostrar cap missatge d'alarma.</para>

<para
>Establiu les opcions següents:</para>

<itemizedlist>
<listitem>
<para
>Introduïu el camí del fitxer de so o utilitzeu el botó al costat del quadre d'edició per a mostrar un diàleg de selecció de fitxers.</para>
</listitem>

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

<listitem>
<para
>Marqueu <guilabel
>Volum</guilabel
> i ajusteu el control lliscant si voleu ajustar el volum del fitxer d'àudio a reproduir.</para>
</listitem>

<listitem>
<para
>Si el dorsal d'àudio que s'està utilitzant ho admet, podeu esvair el volum. Esvaïment significa començar a reproduir el fitxer d'àudio en un volum i canviar gradualment al volum final, en un interval de temps especificat. El volum final és el que s'ha introduït més amunt a <guilabel
>Volum</guilabel
>. Per a activar l'esvaïment, marqueu <guilabel
>Esvaïment</guilabel
>, i després introduïu el període d'esvaïment en segons en el camp <guilabel
>Temps d'esvaïment</guilabel
>, i ajusteu el control lliscant <guilabel
>Volum inicial</guilabel
>.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Ajornament</title>

<para
>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 <guilabel
>Alarma ajornada</guilabel
> mostrarà l'hora en què es va ajornar l'alarma. <guibutton
>Canvia...</guibutton
> mostrarà un diàleg que permet canviar l'hora d'ajornament o cancel·lar-la.</para>

</sect2>

<sect2>
<title
>Hora</title>

<para
>En el grup de caselles <guilabel
>Hora</guilabel
>, seleccioneu qualsevol de les dues:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>A la data i hora</guilabel
> introduïu la data i hora a la qual cal activar l'alarma. Marqueu <guilabel
>Qualsevol hora</guilabel
> 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 configurat, en la data especificada. (<link linkend="preferences-time"
>Configurar el &kalarm;</link
> descriu com configurar l'hora d'inici del dia).</para>

<para
>Per a una alarma no recurrent, la data/hora que s'introdueixi haurà d'estar en el futur, o si només s'introdueix una data, podrà estar en 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'ajustarà automàticament a la primera recurrència de venciment després de l'hora actual.</para>
</listitem>

<listitem>
<para
><guilabel
>Temps des d'ara</guilabel
> per a introduir quant temps després d'avui (en hores i minuts) s'activarà l'alarma.</para>
</listitem>
</itemizedlist>

<para
>Si ho voleu, escolliu una zona horària per a aplicar a l'alarma. Aquesta s'utilitzarà per a totes les dates i hores en relació amb aquesta alarma, incloent-hi 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 es tingui una bona raó per a canviar-ho.</para>

<para
>Els controls de la zona horària només es mostren quan la zona horària seleccionada és diferent de la zona horària predeterminada establerta al <link linkend="preferences-time"
>diàleg de configuració</link
>, o si feu clic al botó <guibutton
>Zona horària...</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>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 <link linkend="preferences-time"
>diàleg de configuració</link
>, la qual serà la zona horària del vostre ordinador a menys que s'hagi canviat.</para>
</listitem>

<listitem>
<para
>Seleccioneu <guilabel
>Zona horària del sistema</guilabel
> si voleu utilitzar l'hora local de l'ordinador (en qualsevol ordinador, el &kalarm; passarà a estar en execució en aquell moment).</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Recordatori</title>

<para
>Per a una alarma visual, marqueu <guilabel
>Recordatori</guilabel
> si voleu mostrar un recordatori, 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ó. Cal tenir en compte que si l'alarma és recurrent, el període de recordatori normalment es limitarà a ser inferior a l'interval de recurrència o de subrepetició.</para>

<note
><para
>Els recordatoris no es mostraran per a les subrepeticions dins d'una recurrència. Els recordatoris només es mostraran per a cada repetició principal de l'alarma.</para
></note>

<para
>Si l'alarma és recurrent, marqueu <guilabel
>Recordatori només per a la primera recurrència</guilabel
> si només voleu un recordatori per a la primera repetició de l'alarma. Si marqueu aquesta opció, i abans hi ha un recordatori, el període de recordatori no estarà subjecte als límits normals de ser inferior a l'interval de recurrència o de subrepetició.</para>


</sect2>

<sect2>
<title
>Cancel·lar</title>

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

<itemizedlist>
<listitem>
<para
>La casella de selecció <guilabel
>Cancel·la si ja és tard</guilabel
> determina el que passarà si l'alarma no es pot activar en la seva hora programada.</para>

<para
>Marqueu aquesta casella per a 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 apareixeran 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.</para>

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

<para
>Deixeu la casella sense marcar per a activar l'alarma a la primera oportunitat a partir de l'hora programada, sense importar quant temps hagi transcorregut.</para>

<note
><para
>Una alarma només es podrà activar mentre esteu en una sessió, i amb les X i el &kalarm; en execució.</para
></note>
</listitem>

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

</sect2>

<sect2>
<title
>Recurrència</title>

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

<note
><para
>Les característiques bàsiques de repetició de l'alarma es mostren per comoditat en el títol de la pestanya <guilabel
>Recurrència</guilabel
>. Primer es mostra l'interval de la recurrència, seguit per l'interval de la subrepetició establert mitjançant el botó <guibutton
>Subrepetició</guibutton
>.</para
></note>

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

<itemizedlist>
<listitem
><para
>Per a activar l'alarma una única vegada, seleccioneu <guilabel
>Sense recurrència</guilabel
>.</para
></listitem>

<listitem
><para
>Seleccioneu <guilabel
>En entrar</guilabel
> per a 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. (Cal tenir en compte que una alarma repetida a l'inici de sessió també s'activarà cada vegada que reinicieu el &kalarm;).</para
></listitem>

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

<itemizedlist>
<listitem>
<para
>Per a una recurrència setmanal, marqueu tots els dies de la setmana en els que voleu activar l'alarma.</para>
</listitem>

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

<listitem>
<para
>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.</para>

<para
>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 <guilabel
>Alarma el 29 de febrer als anys que no siguin de traspàs</guilabel
>:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Cap</guilabel
>: 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.</para>
</listitem>

<listitem
><para
><guilabel
>28 de febrer</guilabel
>: 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.</para>
</listitem>

<listitem
><para
><guilabel
>1 de març</guilabel
>: 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.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>Per a 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.</para
></tip>

</listitem>
</itemizedlist>

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

<itemizedlist>
<listitem
><para
>Seleccioneu <guilabel
>Sense fi</guilabel
> per a continuar les repeticions indefinidament.</para
></listitem>

<listitem
><para
>Seleccioneu <guilabel
>Finalitza després de</guilabel
> per a especificar el nombre total d'ocurrències de l'alarma.</para
></listitem>

<listitem
><para
>Seleccioneu <guilabel
>Finalitza el</guilabel
> per a especificar la data/hora fins que s'ha de repetir l'alarma. Cal tenir en compte que utilitza la mateixa zona horària que l'hora d'inici de l'alarma.</para>

<note
><para
>La data/hora de finalització determina el moment en què s'activi l'última recurrència principal, però no limita les subrepeticions. Si es configuren, s'activaran normalment després de l'última recurrència principal, independentment de la data/hora de finalització.</para
></note>
</listitem>
</itemizedlist>

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

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

<listitem>
<para
>Podeu restringir una alarma perquè no s'activi en dies festius marcant <guilabel
>Exclou els festius</guilabel
>. Això no canviarà la manera com està programada l'alarma, sinó que simplement la suprimirà cada vegada que li toqui activar-se en un dia festiu. Podeu seleccionar el vostre país o regió per a les vacances en el <link linkend="preferences-time"
>diàleg de configuració</link
>.</para>
</listitem>

<listitem>
<para
>Podeu restringir una alarma perquè només s'activi durant la jornada laboral marcant <guilabel
>Només durant l'horari de treball</guilabel
>. Això no canviarà la manera com està programada l'alarma, sinó que simplement la suprimirà cada vegada que li toqui activar-se fora de l'horari de treball. Els dies i horari de treball s'estableixen en el <link linkend="preferences-time"
>diàleg de configuració</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Subrepetició</title>

<para
>Podeu utilitzar el botó <guibutton
>Subrepetició</guibutton
> 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 subrepetició. Per exemple, per a 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 subrepetició per a especificar un interval d'1 hora i o bé un compte de 6 o bé una durada de 6 hores.</para>

<note
><para
>Les subrepeticions només s'activen després d'una recurrència principal que realment s'activa. Si se suprimeix una recurrència principal a causa d'una data/hora d'excepció o per restriccions de vacances o de jornada laboral, no s'activaran les subrepeticions per a aquesta instància de la recurrència.</para>

<para
>També se suprimiran les subrepeticions individuals si es produeixen en una data/hora d'excepció, o durant les restriccions de vacances o de jornada laboral.</para
></note>

<para
>Al diàleg <guibutton
>Subrepetició</guibutton
> mostrat en fer clic al botó <guilabel
>Subrepetició</guilabel
>, marqueu <guilabel
>Repeteix cada</guilabel
> per a establir una repetició, o desmarqueu-la per a eliminar la repetició. Si marqueu <guilabel
>Repeteix cada</guilabel
>, establireu la repetició com segueix:</para>

<itemizedlist>
<listitem
><para
>Introduïu l'interval de temps entre les repeticions en els controls al costat de <guilabel
>Repeteix cada</guilabel
>. Seleccioneu les unitats de temps que vulgueu (&pex;, dies) i després introduïu el nombre d'unitats.</para>
</listitem>

<listitem
><para
>Especifiqueu el nombre de repeticions o la seva durada:</para>

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

<listitem
><para
>Seleccioneu <guilabel
>Durada</guilabel
> per a 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ó, s'arrodonirà automàticament a la baixa quan feu clic a <guibutton
>D'acord</guibutton
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>Per a impedir l'encavalcament de les subrepeticions per a la mateixa alarma, la durada d'una subrepetició està limitada a ser inferior a l'interval més llarg entre les recurrències principals. Cada vegada que l'alarma es repeteix tal com s'especifica a la recurrència principal, qualsevol subrepetició encara activa que es va iniciar en la recurrència anterior serà automàticament cancel·lada.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Altres controls</title>

<para
>Si la configuració del sistema permet que diverses alarmes despertin el sistema des de la suspensió, podeu seleccionar <guilabel
>Activa des de la suspensió</guilabel
> per a activar el sistema si actualment està suspès quan venç l'alarma. Aquesta funció no és disponible per a les alarmes de només data perquè la seva hora no està definida. Vegeu <link linkend="wake-suspend"
>Activa des de la suspensió</link
> per a més informació.</para>

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

<para
>Seleccioneu <guilabel
>Mostra al &korganizer;</guilabel
> per a afegir l'alarma al calendari actiu del &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 del &kalarm;.</para>

<note
><para
>Si posteriorment es modifica o suprimeix l'alarma al &kalarm;, l'esdeveniment del &korganizer; serà modificat o suprimit corresponentment. Tanmateix, si canvieu l'esdeveniment al &korganizer;, l'alarma al &kalarm; no es veurà afectada.</para
></note>

<para
>Premeu el botó <guibutton
>Carrega la plantilla</guibutton
> per a seleccionar una plantilla a preestablir amb el diàleg, com es descriu a <link linkend="create-edit"
>Crear i gestionar les alarmes</link
>. </para>

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

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

</sect2>
</sect1>

<sect1 id="message-display">
<title
>Visualitzar el missatge de l'alarma</title>

<para
>Els missatges d'alarma poden mostrar-se en finestres o com a notificacions, segons l'opció triada en el <link linkend="alarm-edit-dlg"
>diàleg Edició d'una alarma</link
>. Aquestes dues opcions de visualització es descriuen a continuació.</para>

<para
>Si inhibiu les notificacions per a l'escriptori, l'execució de les alarmes visuals se suspendrà fins que es tornin a habilitar les notificacions. Recordeu que això s'aplica a totes les alarmes visuals, independentment de si es mostren en finestres o com a notificacions.</para>

<sect2 id="message-window">
<title
>Finestra del missatge de l'alarma</title>

<para
>Els missatges d'alarma que es mostren a les finestres proporcionen la màxima funcionalitat.</para>

<para
>Quan venç un missatge d'alarma, es (si és possible) mostrarà a cada escriptori i no es pot cobrir per les finestres normals, per a assegurar que no us el perdeu. (Tingueu en compte que actualment només sistema de finestres X11 proporciona aquesta característica.) La finestra de missatges mostrarà el temps durant el qual s'ha programat l'alarma, de manera que podeu veure quan va sorgir si éreu 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»).</para>

<para
>Les finestres dels missatges d'alarma romandran visibles fins que es reconeguin, llevat que <guilabel
>Tanca la finestra automàticament després d'una cancel·lació retardada</guilabel
> estigui marcada en el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>. 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.</para>

<para
>La finestra del missatge de l'alarma proporciona qualsevol de les opcions següents aplicables a l'alarma que es mostra:</para>

<itemizedlist>
<listitem>
<para
>Reconèixer l'alarma fent clic al botó <guibutton
>Tanca</guibutton
>. Això tancarà la finestra (després d'un missatge de confirmació, si heu seleccionat <guilabel
>Confirma el reconeixement</guilabel
>).</para>
</listitem>

<listitem>
<para
>Editar l'alarma fent clic al botó <guibutton
>Edita...</guibutton
>. Això mostrarà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>.</para>
</listitem>

<listitem>
<para
>Mostrar les opcions d'ajornar l'alarma fins més tard fent clic al botó <guibutton
>Ajorna...</guibutton
>. Llavors seleccioneu <guilabel
>Ajorna durant</guilabel
> per a introduir quant temps a partir d'ara s'haurà de mostrar de nou el missatge (el botó <guilabel
>Predefinit</guilabel
> permet seleccionar d'una llista d'intervals de temps habituals), o seleccioneu <guilabel
>Ajorna fins</guilabel
> per a introduir la data i hora quan s'haurà de mostrar de nou el missatge. Feu clic a <guibutton
>D'acord</guibutton
> per a ajornar-la i tancar la seva finestra.</para>

<note
><para
>L'hora a la qual s'ajorni l'alarma haurà de ser anterior a la pròxima activació programada o recordatori avançat següent. Per aquesta raó, el ​ botó <guibutton
>​Ajorna...</guibutton
> a la finestra del missatge de l'alarma i el botó <guibutton
>D'acord</guibutton
> en el diàleg d'ajornament s'inhabiliten un minut abans de la pròxima activació o recordatori avançat.</para>
<para
>Cal tenir en compte que si es configura un recordatori <emphasis
>després</emphasis
> de l'alarma, <emphasis
>podríeu</emphasis
> ajornar l'alarma més enllà del seu temps de recordatori. En aquest cas, el recordatori seria suprimit.</para
></note>

<note
><para
>El botó <guibutton
>Ajorna...</guibutton
> no estarà disponible per a les alarmes que es mostren en iniciar la sessió, a causa que s'ha seleccionat l'opció <guilabel
>En iniciar la sessió</guilabel
>.</para
></note>
</listitem>

<listitem>
<para
>Aturar la reproducció dels fitxers de so de l'alarma fent clic al botó que mostra el símbol «atura la reproducció».</para>
</listitem>

<listitem>
<para
>Si el missatge de l'alarma es va crear arrossegant un correu electrònic des del &kmail;, podreu accedir directament al correu electrònic al &kmail;, feu clic al botó que mostra la icona del &kmail;. Això mostrarà el correu electrònic i seleccionarà la carpeta que conté el correu electrònic a la llista de carpetes del &kmail;.</para>

<warning
><para
>Si es regeneren els índexs del &kmail;, es perdrà l'enllaç al correu electrònic del &kmail;.</para
></warning>
</listitem>

<listitem>
<para
>El botó que mostra la icona del <guiicon
>&kalarm;</guiicon
> proporciona una manera còmoda per a activar la finestra principal del &kalarm;. amb aquesta alarma ressaltada.</para>
</listitem>
</itemizedlist>

<para
>La forma en què es mostren les finestres del missatge d'alarma depèn del sistema de finestres en ús.</para>

<itemizedlist>
<listitem>
<para
><application
>Sistema de finestres X11</application
></para>

<para
>Podeu escollir en el <link linkend="preferences-view"
>diàleg de configuració</link
> quin dels dos modes diferents s'haurà d'utilitzar per a mostrar les finestres dels missatges d'alarma:</para>

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

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

<para
>Podeu escollir en el <link linkend="preferences-view"
>diàleg de configuració</link
> quin dels dos esquemes s'haurà d'utilitzar per a col·locar les finestres d'un missatge d'alarma:</para>

<itemizedlist>
<listitem>
<para
>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.</para>
</listitem>

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

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

</listitem>

<listitem>
<para
><application
>Sistema de finestres Wayland</application
></para>

<para
>El sistema de finestres Wayland no permet a les aplicacions controlar la posició o la decoració de les seves finestres, de manera que les opcions de visualització són molt més limitades.</para>

<para
>Per a reduir el risc de reconèixer accidentalment l'alarma, els botons de la finestra seran inhabilitats inicialment, activant-se només després d'un retard configurable.</para>

</listitem>

</itemizedlist>

</sect2>

<sect2>
<title
>Notificacions dels missatges de l'alarma</title>

<para
>Els missatges d'alarma que es mostren com a notificacions ofereixen menys funcionalitat que els que es mostren en finestres.</para>

<para
>Quan venç un missatge d'alarma, es mostrarà com a una notificació. La notificació mostrarà el temps en el qual s'ha programat l'alarma. 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 es mostrarà una capçalera «Recordatori»).</para>

<para
>La notificació es tancarà automàticament després d'un breu temps d'espera. (Cal tenir en compte que el temps d'espera és comú per a totes les aplicacions, es pot canviar a l'&systemsettings;). Una vegada s'esgoti el temps d'espera d'una notificació, encara es podrà veure a l'historial de notificacions fins que l'elimineu o tanqueu la sessió. A causa que les aplicacions no tenen manera d'accedir a l'historial de notificacions, el &kalarm; no pot eliminar ni substituir les notificacions en l'historial com ho faria amb les finestres d'alarma. Per tant, l'historial pot contenir múltiples notificacions per a la mateixa alarma, inclosos els recordatoris i recurrències.</para>

<para
>La notificació del missatge d'alarma ofereix les opcions següents. Recordeu que en seleccionar qualsevol opció, la notificació es tancarà immediatament i evitarà que es mostri a l'historial de notificacions. També cal tenir en compte que aquestes opcions només estaran disponibles mentre la notificació està activa, abans que s'esgoti el temps d'espera. Si posteriorment accediu a la notificació en l'historial de notificacions, a causa de les limitacions del sistema de notificacions, l'única interacció disponible serà eliminar-la de l'historial.</para>

<itemizedlist>
<listitem>
<para
>Reconèixer l'alarma fent clic al botó <guibutton
>Tanca</guibutton
>. Això tancarà la notificació.</para>
</listitem>

<listitem>
<para
>Editar l'alarma fent clic al botó <guibutton
>Edita</guibutton
>. Això mostrarà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>.</para>
</listitem>

<listitem>
<para
>Mostra les opcions per a ajornar l'alarma fins més tard fent clic al botó <guibutton
>Ajorna</guibutton
>. Aquest botó només es mostrarà si és possible ajornar l'alarma. Per a més detalls, vegeu la descripció de l'opció d'ajornament a la secció <link linkend="message-window"
>Finestra del missatge de l'alarma</link
>.</para>
</listitem>

<listitem>
<para
>En fer clic a la notificació en qualsevol lloc que no sigui un botó, s'activarà la finestra principal del &kalarm;, amb aquesta alarma ressaltada.</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Funcionament de la safata del sistema</title>

<para
>De manera predeterminada, el &kalarm; mostra una icona a la safata del sistema. La icona proporciona control i una indicació d'estat per al monitoratge de les alarmes. Una icona normal del &kalarm; indica que les alarmes s'estan monitorant, mentre que dues icones modificades diferents indiquen que algunes alarmes, o totes les alarmes, no s'estan monitorant. Les modificacions de la icona depenen del tema de la icona que s'estigui utilitzant.</para>

<para
>La icona de la safata del sistema del &kalarm; restarà oculta automàticament de manera predeterminada sempre que no hi hagi alarmes vençudes en les pròximes 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 <link linkend="preferences-view"
>diàleg de configuració</link
>. Per a mostrar la icona quan està oculta, feu clic a la fletxa de la safata del sistema per a mostrar les icones ocultes.</para>

<para
>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 <link linkend="preferences-view"
>diàleg de configuració</link
>.</para>

<para
>Feu clic <mousebutton
>esquerre</mousebutton
> sobre la icona de la safata del sistema per a alternar entre mostra i oculta la finestra principal del &kalarm;.</para>

<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre la icona de la safata del sistema per a veure el seu menú contextual:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Habilita o inhabilita el monitoratge de les alarmes.</action
></para>
<para
>Per a més detalls, vegeu <link linkend="enable-disable"
>Habilitar i inhabilitar les alarmes</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Alarma nova</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Després que seleccioneu el tipus d'alarma de la llista que apareix, s'obrirà el diàleg d'edició de l'alarma per a crear una alarma nova.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Atura la reproducció</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Atura la reproducció del fitxer d'àudio que s'està reproduint.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Separa les finestres</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Separa les finestres d'alarma i de missatge d'error al llarg de la pantalla, o les agrupa.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Configura el &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Mostra el diàleg de configuració del &kalarm;.</action
></para>
<para
>El diàleg de configuració es descriu en <link linkend="preferences"
>Configurar el &kalarm;</link
>. Inclou les opcions relatives a la icona de la safata del sistema del &kalarm;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Restaura/Minimitza</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Restaura o minimitza la finestra principal del &kalarm;.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Surt</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Tanca la safata del sistema i la finestra principal del &kalarm;.</action
></para>
<para
>Surt del &kalarm; si no s'estan mostrant finestres de missatges d'alarma.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>Mostrar el &kalarm; a la safata del sistema</title>

<para
>Haureu d'estar executant l'escriptori &plasma; o un altre gestor de finestres adequat per a mostrar el &kalarm; a la safata del sistema.</para>

<para
>Seleccioneu <menuchoice
><guimenu
>Visualitza</guimenu
> <guimenuitem
>Mostra a la safata del sistema</guimenuitem
></menuchoice
> per a mostrar el &kalarm; a la safata del sistema d'acord amb les preferències establertes a la pestanya <link linkend="preferences-view"
>Vista</link
> del diàleg de configuració.</para>

<para
>Per a treure el &kalarm; de la safata del sistema, desseleccioneu <menuchoice
><guimenu
>Visualitza</guimenu
> <guimenuitem
>Mostra a la safata del sistema</guimenuitem
></menuchoice
>.</para>

<para
>Per a escollir si es mostrarà el &kalarm; a la safata del sistema després d'iniciar la sessió, utilitzeu la pestanya <link linkend="preferences-view"
>Vista</link
> del diàleg de configuració.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Actualitzar les alarmes</title>

<para
>En el cas improbable que una alarma no s'activi quan ho hauria de fer, podeu actualitzar la llista d'alarmes i activar les alarmes que faltin seleccionant <menuchoice
> <guimenu
>Accions</guimenu
><guimenuitem
>Actualitza les alarmes</guimenuitem
> </menuchoice
>. Això farà que el &kalarm; torni a carregar tots els calendaris d'alarmes.</para>

<para
>Podeu tornar a carregar un calendari individual i actualitzar les alarmes a la llista d'alarmes fent clic <mousebutton
>dret</mousebutton
> al calendari a la llista de calendaris i seleccionant l'opció de menú <menuchoice
><guimenuitem
>Torna a carregar</guimenuitem
></menuchoice
>. Per a més detalls, vegeu <link linkend="calendars"
>Calendaris d'alarmes</link
>.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Habilitar i inhabilitar les alarmes</title>

<para
>Les alarmes es poden habilitar i inhabilitar bé en conjunt o individualment:</para>

<itemizedlist>
<listitem>
<para
>El «monitoratge d'alarmes» s'aplica a les alarmes en conjunt. Mentre que el monitoratge d'alarmes està inhabilitat, cap alarma serà activada. Mentre que el monitoratge d'alarmes està habilitat (la situació normal), totes les alarmes que no estiguin inhabilitades individualment seran activades en el moment apropiat.</para>

<para
>Quan es torni a habilitar el monitoratge d'alarmes, les que s'han activat mentre estaven inhabilitades s'activaran ara (a menys que qualsevol de les opcions de cancel·lació retardada ho impedeixi). En altres paraules, inhabilitar el monitoratge d'alarmes té el mateix efecte que aturar el &kalarm; -les alarmes es posposen fins que es torni a habilitar-.</para>
</listitem>

<listitem>
<para
>Les alarmes es poden habilitar i inhabilitar individualment, independentment de l'estat del monitoratge d'alarmes. Pel que l'estat habilitada/inhabilitada individual de les alarmes no es modificarà mitjançant la inhabilitació i tornar a habilitar el monitoratge d'alarmes. A menys que el monitoratge d'alarmes estigui inhabilitat a causa que el &kalarm; no s'està executant, les alarmes individuals només es poden inhabilitar si s'utilitzen les ordres de menú.</para>

<para
>Quan una alarma es torna a habilitar individualment, no s'activarà si ha vençut mentre estava inhabilitada. En altres paraules, inhabilitar una alarma individual cancel·larà totes les seves ocurrències fins que es torni a habilitar.</para>

<para
>Un estat d'alarma individual d'habilitada/inhabilitada s'indica pel seu color a la llista d'alarmes (el color es pot configurar a la pestanya <link linkend="preferences-view"
>Vista</link
> del <link linkend="preferences-view"
>diàleg de configuració</link
>).</para>
</listitem>
</itemizedlist>

<para
>Per a activar una alarma, s'haurà d'habilitar individualment, així com el monitoratge d'alarmes haurà d'estar habilitada.</para>

<sect2>
<title
>Habilitar el monitoratge d'alarmes</title>

<para
>Perquè ocorri el monitoratge d'alarmes, el &kalarm; haurà d'estar en execució. Una vegada l'executeu, serà a partir de llavors que s'iniciarà automàticament cada vegada que accediu a menys que la inhabiliteu a la pestanya <link linkend="preferences-general"
>General</link
> del diàleg de configuració.</para>

<para
>Si el monitoratge d'alarmes està inhabilitat, feu el següent per a habilitar les alarmes:</para>

<itemizedlist>
<listitem>
<para
>Seleccioneu <menuchoice
><guimenu
>Accions</guimenu
><guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre la icona de la safata del sistema i escolliu <menuchoice
><guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Inhabilitar el monitoratge d'alarmes</title>

<para
>Podeu inhabilitar temporalment el monitoratge d'alarmes, el qual evitarà que el &kalarm; torni a mostrar cap alarma fins que les torneu a habilitar, o -si s'assumeix que el &kalarm; està configurat per a executar-se en iniciar la sessió- fins a la pròxima vegada que inicieu la sessió.</para>

<itemizedlist>
<listitem>
<para
>Desseleccioneu <menuchoice
><guimenu
>Accions</guimenu
> <guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre la icona de la safata del sistema i desseleccioneu <menuchoice
><guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>

<listitem>
<para
>Executeu el &kalarm; amb l'opció <option
>--disable-all</option
> des de la línia d'ordres.</para>
</listitem>

<listitem>
<para
>Atureu el &kalarm; com es descriu a <link linkend="quitting"
>Sortir del &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Les alarmes es poden inhabilitar permanent evitant que el &kalarm; s'executi en iniciar la sessió amb la pestanya <link linkend="preferences-general"
>General</link
> del diàleg de configuració.</para>

</sect2>

<sect2>
<title
>Habilitar i inhabilitar individualment les alarmes</title>

<para
>Per a habilitar individualment les alarmes que estan inhabilitades, realitzeu una de les accions següents:</para>

<itemizedlist>
<listitem>
<para
>Seleccioneu-ne una o més fent clic a les seves entrades a la llista d'alarmes. A continuació escolliu <menuchoice
> <guimenu
>Accions</guimenu
><guimenuitem
>Habilita</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre les entrades en qüestió a la llista d'alarmes i escolliu <menuchoice
><guimenuitem
>Habilita</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

<para
>Per a inhabilitar individualment les alarmes que estan actualment habilitades, realitzeu una de les accions següents:</para>

<itemizedlist>
<listitem>
<para
>Seleccioneu-ne una o més fent clic a les seves entrades a la llista d'alarmes. A continuació escolliu <menuchoice
> <guimenu
>Accions</guimenu
><guimenuitem
>Inhabilita</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
>Feu clic <mousebutton
>dret</mousebutton
> sobre les entrades en qüestió a la llista d'alarmes i escolliu <menuchoice
><guimenuitem
>Inhabilita</guimenuitem
></menuchoice
> des del menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Despertar de l'estat de suspensió</title>

<para
>Les alarmes es poden configurar perquè quan s'activin, despertin l'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à inactiu. El mecanisme que fa servir el &kalarm; per a despertar el sistema, i que es controla amb la interfície d'usuari, depèn del tipus de sistema i dels permisos de l'usuari. Hi ha dues possibilitats:</para>

<sect2>
<title
>Despertar de l'estat de suspensió del temporitzador del nucli Linux</title>

<para
>En els sistemes Linux, si l'usuari té la capacitat de temporitzador d'alarma del nucli (<literal
>cap_wake_alarm</literal
>), es pot configurar qualsevol nombre d'alarmes per a activar-se des de la suspensió. En aquest cas, l'activació des de la suspensió es configura per a cada alarma individual en el <link linkend="alarm-edit-dlg"
>diàleg d'edició d'alarma</link
> utilitzant l'opció <guilabel
>Activa des de la suspensió</guilabel
>.</para>

<para
>Podeu configurar el període de temps anterior a l'alarma que l'ordinador es desperti de la suspensió, per a assegurar que el sistema té temps de restaurar-se completament abans que s'activi l'alarma, en el <link linkend="preferences-time"
>diàleg de configuració</link
>.</para>

</sect2>

<sect2>
<title
>Despertar de l'estat de suspensió de l'RTC</title>

<para
>En sistemes no Linux, o en sistemes Linux on l'usuari no té la capacitat <literal
>cap_wake_alarm</literal
>, s'utilitza l'alarma del rellotge en temps real (<acronym
>RTC</acronym
>). Això només es pot establir per a una alarma cada vegada. En aquest cas, per a configurar-ho s'utilitza un diàleg especial d'activació des de la suspensió. El diàleg permet establir, cancel·lar o mostrar l'alarma d'activació des de la suspensió. Per a accedir al diàleg, seleccioneu <menuchoice
><guimenu
>Accions</guimenu
> <guimenuitem
>Activa des de la suspensió</guimenuitem
></menuchoice
>.</para>

<para
>L'ús de la funció per a despertar 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.</para>

<note
><para
>Aquest tipus d'alarma no és admesa 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 què funciona el mode de suspensió. Haureu de considerar l'establiment d'alarmes de prova per a comprovar la capacitat del vostre sistema abans de confiar en aquesta característica.</para
></note>

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

<para
>El diàleg despertar de la suspensió s'utilitza conjuntament amb la llista d'alarmes a la finestra principal del &kalarm;.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Usa l'alarma ressaltada</guibutton
>: Estableix l'alarma ressaltada a la llista d'alarmes com l'alarma per a despertar de la suspensió. Qualsevol alarma programada anteriorment serà cancel·lada, com s'ha explicat anteriorment. El botó només s'habilitarà si es ressalta una única alarma.</para>
</listitem>

<listitem>
<para
><guibutton
>Cancel·la el despertar de la suspensió</guibutton
>: Cancel·la qualsevol alarma existent del mode de suspensió (sigui establert pel &kalarm; o qualsevol altra aplicació -veure a dalt-). Cal tenir en compte que això només cancel·la funció d'activació associada a l'alarma, la mateixa alarma no se suprimeix i continuarà operant de forma normal.</para>
</listitem>

<listitem>
<para
><guibutton
>Mostra l'alarma actual</guibutton
>: Ressalta l'alarma que desperta de la suspensió actual a la llista d'alarmes, de manera que es pugui identificar. El botó estarà inhabilitat si se n'ha configurat una.</para>
</listitem>

<listitem>
<para
>El control <guilabel
>Nombre de minuts abans de l'alarma per a despertar de la suspensió</guilabel
> permet, si així ho voleu, assegurar-vos que el sistema té temps per a si mateix per a restablir-se completament abans que s'activi l'alarma, de manera que l'alarma podrà activar-se al moment correcte.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="quitting">
<title
>Sortir del &kalarm;</title>

<para
>Sortiu del &kalarm; seleccionant <menuchoice
> <guimenu
>Fitxer</guimenu
><guimenuitem
>Surt</guimenuitem
></menuchoice
>, o <menuchoice
><guimenuitem
>Surt</guimenuitem
></menuchoice
> des del menú contextual de la icona a la safata del sistema. Alternativament, si la icona de la safata del sistema no està visible, tanqueu la finestra principal del &kalarm;.</para>

</sect1>
</chapter>

<chapter id="preferences">
<title
>Configurar el &kalarm;</title>

<para
>Per a configurar el funcionament del &kalarm; per a adaptar-se al vostre sistema i a les vostres preferències personals, seleccioneu <menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura el &kalarm;...</guimenuitem
></menuchoice
>. Això mostrarà el diàleg de configuració.</para>

<sect1 id="preferences-general">
<title
>General</title>

<para
>La secció <guilabel
>General</guilabel
> permet controlar el comportament del &kalarm; en general:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Mode d'execució</guilabel
>: Això permet seleccionar si el &kalarm; s'hauria d'executar automàticament, manualment o no.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Executa automàticament</guilabel
>: Seleccioneu-ho per a executar el &kalarm; automàticament en iniciar la sessió per a assegurar-vos que sempre s'executa. Aquesta opció s'ha de seleccionar perquè el &kalarm; funcioni amb normalitat i sempre activi les alarmes.</para>
</listitem>

<listitem>
<para
><guilabel
>Executa només manualment</guilabel
>: Seleccioneu-ho si només voleu utilitzar el &kalarm; ocasionalment. No s'executarà automàticament, i haureu d'executar-lo manualment quan ho necessiteu. Un cop surti (o després de tancar la sessió), ja no funcionarà ni activarà alarmes fins que l'executeu manualment de nou.</para>
</listitem>

<listitem>
<para
><guilabel
>No executis</guilabel
>: Seleccioneu-ho si voleu deixar d'utilitzar el &kalarm;. Ja no s'iniciarà a l'inici de sessió ni després de sortir o tancar, ja no activarà alarmes.</para>

<para
>Tingueu en compte que si més tard executeu el &kalarm; de nou després de seleccionar aquesta opció, el &kalarm; reprendrà el funcionament normal i s'executarà automàticament en iniciar la sessió. Si encara no voleu utilitzar el &kalarm; després d'això, haureu de seleccionar aquesta opció <guilabel
>No executis</guilabel
> una vegada més.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Avisa abans de sortir</guilabel
>: El &kalarm; ha d'estar executant-se perquè s'activin les alarmes. Seleccioneu aquesta opció de manera que si intenteu finalitzar el &kalarm; utilitzant la seva opció <menuchoice
><guimenu
>Surt</guimenu
></menuchoice
>, se us advertirà que les alarmes estaran desactivades i es demanarà confirmació. Això evita la desactivació accidental de les alarmes. Per seguretat, aquesta opció es torna a activar automàticament de manera predeterminada cada vegada que canvieu el mode d'execució.</para>
</listitem>

<listitem
><para
><guilabel
>Habilita els noms d'alarmes</guilabel
>: Especifica si es pot assignar un nom a cada alarma per a ajudar-vos a identificar-la. Això determina si la columna <guilabel
>Nom</guilabel
> es mostrarà a la <link linkend="alarm-list"
>llista d'alarmes</link
> i si el camp <guilabel
>Nom de l'alarma</guilabel
> apareixerà en el <link linkend="alarm-edit-dlg"
>diàleg Edita l'alarma</link
>.</para>
</listitem>

<listitem
><para
><guilabel
>Confirma la supressió de les alarmes</guilabel
>: Especifica si se us demanarà una confirmació cada vegada que suprimiu una alarma.</para>
</listitem>

<listitem
><para
><guilabel
>Interval de temps predeterminat d'ajornament</guilabel
>: Introduïu l'interval de temps predeterminat, en hores i minuts, per a mostrar inicialment quan es mostri el diàleg d'alarma ajornada. Cal tenir 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.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal per a les alarmes d'ordre</guilabel
>: 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 comunes de finestra de terminal estan preconfigurades, &pex;, <application
>xterm</application
>, &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ó.</para>

<para
>Si voleu utilitzar una altra aplicació, o si voleu utilitzar una de les llistades, però amb diferents opcions per a l'ordre, seleccioneu <guilabel
>Altres</guilabel
> i introduïu l'ordre per a invocar la finestra de terminal. De manera predeterminada, 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 codis següents:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>Serà substituït per la cadena d'ordre de l'alarma.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>Serà substituït per la cadena d'ordre de l'alarma, amb un <literal
>sleep</literal
> annexat.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>Es crearà un fitxer d'ordre temporal que contindrà la cadena d'ordre de l'alarma, i serà substituït per l'ordre per a executar el fitxer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>Es crearà un fitxer d'ordre temporal que contindrà la cadena d'ordre de l'alarma amb un <literal
>sleep</literal
> annexat, i serà substituït per l'ordre per a executar el fitxer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>Serà substituït pel nom del &kalarm; en l'idioma actual.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>Quan s'activi 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.</para>
</listitem>

<listitem>
<para
><guilabel
>Connectors</guilabel
>: Aquesta secció permet triar quins dels connectors instal·lats del &kalarm; s'ha d'utilitzar.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Dorsal d'àudio</guilabel
>: Trieu quin sistema d'àudio utilitzar per a reproduir fitxers de so. Només es llisten els connectors d'àudio instal·lats; si no n'hi ha cap, aquesta opció no es mostra.</para>
</listitem>

<listitem
><para
><guilabel
>Activa l'Akonadi</guilabel
>: Trieu si usar l'&akonadi; per a proporcionar les característiques que depenen d'ell. Vegeu el <link linkend="akonadi-plugin"
>connector de l'Akonadi</link
> per ales detalls. Tingueu en compte que aquesta opció només es mostra si s'ha instal·lat el connector de l'Akonadi.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Hora i data</title>

<para
>La secció de <guilabel
>Data i hora</guilabel
> permet establir les opcions relacionades amb la data i hora:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Zona horària</guilabel
>: Seleccioneu la zona horària. El &kalarm; l'utilitza per a tot, excepte quan l'anul·leu per a les alarmes individuals.</para>
</listitem>

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

<listitem
><para
><guilabel
>Activa des de la suspensió abans de l'alarma</guilabel
>: Introduïu el nombre de minuts abans de l'hora d'activació de l'alarma per a despertar el sistema, per a les alarmes configurades per a despertar des de la suspensió. Permet assegurar que el sistema té temps per a restaurar-se completament abans que s'activi l'alarma, de manera que l'alarma pugui activar-se en el moment correcte. Aquesta opció només es mostra si la configuració del sistema permet que diverses alarmes despertin el sistema des de la suspensió. Vegeu <link linkend="wake-suspend"
>Activa des de la suspensió abans de l'alarma</link
> per a més informació.</para>
</listitem>

<listitem
><para
><guilabel
>Inici de dia per a les alarmes per data</guilabel
>: Estableix l'hora d'inici de la jornada per a activar només les alarmes per data, &ead;, aquelles per a les que es va seleccionar l'opció <guilabel
>Qualsevol hora</guilabel
>. 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.</para>
</listitem>

<listitem
><para
>Al grup de caselles <guilabel
>Horari de treball</guilabel
>: Aquestes opcions permeten definir les vostres hores de treball, és necessari quan se selecciona l'opció <guilabel
>Només durant l'horari de treball</guilabel
> per a una repetició en el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>.</para>

<itemizedlist>
<listitem
><para
>Marqueu cada dia que sigui un dia de treball.</para>
</listitem>

<listitem
><para
><guilabel
>Hora d'inici del dia</guilabel
>: Introduïu l'hora a la qual comenceu el treball cada dia.</para>
</listitem>

<listitem
><para
><guilabel
>Hora final del dia</guilabel
>: Introduïu l'hora a la qual acabeu el treball cada dia.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Duració de l'esdeveniment del KOrganizer</guilabel
>: Introduïu la durada de l'esdeveniment per a establir al &korganizer; per a les alarmes que es copien al &korganizer;. La durada predeterminada és zero.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-storage">
<title
>Emmagatzematge</title>

<para
>La secció <guilabel
>Emmagatzematge</guilabel
> permet escollir les opcions per a desar i arxivar les alarmes:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Alarmes i plantilles noves</guilabel
>: Especifiqueu quin calendari utilitzar per a emmagatzemar les alarmes i plantilles d'alarma noves quan s'utilitzin múltiples calendaris d'alarmes:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Desa al calendari predeterminat</guilabel
>: Les alarmes i plantilles d'alarma noves s'afegiran automàticament al calendari d'alarmes predeterminat sense demanar confirmació.</para>
</listitem>

<listitem>
<para
><guilabel
>Pregunta en quin calendari s'ha de desar</guilabel
>: En crear una alarma o una plantilla d'alarma nova i hi ha més d'un calendari d'alarmes per a escriure, se us demanarà que escolliu el calendari a on s'haurà de desar. Cal tenir en compte que quan es desen les alarmes en el venciment, de manera predeterminada sempre s'emmagatzemen en el calendari d'alarmes arxivades, sense preguntar.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>El grup de caselles <guilabel
>Alarmes arxivades</guilabel
>: Aquestes opcions controlen l'emmagatzematge de les alarmes arxivades en el calendari predeterminat d'alarmes arxivades.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Mantén les alarmes després d'expirar</guilabel
>: Seleccioneu aquesta opció per a arxivar les alarmes expirades i suprimides. Desseleccioneu-la per a no desar cap registre de les alarmes una vegada deixen d'estar actives. Cal tenir en compte que les alarmes suprimides només s'arxivaran si han estat prèviament activades. Si suprimiu una alarma abans que s'activi, aquesta serà descartada.</para>
</listitem>

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

<listitem
><para
><guibutton
>Neteja les alarmes arxivades</guibutton
>: Aquest botó descarta totes les alarmes actualment arxivades al calendari predeterminat d'alarmes arxivades. (Els altres calendaris d'alarmes arxivades no seran modificats en el cas que es comparteixin 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.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>Correu electrònic</title>

<para
>La secció <guilabel
>Correu electrònic</guilabel
> permet escollir les opcions per a enviar i adreçar les alarmes de correu electrònic:</para>

<note
><para
>Les opcions dependents del &kmail; només són disponibles si s'ha instal·lat i activat el <link linkend="akonadi-plugin"
>connector de l'Akonadi</link
> del &kalarm;.</para>
</note>

<itemizedlist>
<listitem>
<para
><guilabel
>Client de correu</guilabel
>: Especifiqueu el client de correu electrònic a utilitzar per a enviar les alarmes de correu electrònic:</para>

<itemizedlist>
<listitem
><para
><guilabel
>KMail</guilabel
>: Quan s'activa una alarma de correu electrònic, aquest correu serà enviat automàticament a través del &kmail;.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Quan s'activa una alarma de correu electrònic, aquest correu serà enviat automàticament a través del &Sendmail;. Aquesta opció només funcionarà si el sistema està configurat per a utilitzar el &Sendmail;, o un agent de transport de correu compatible com <application
>postfix</application
> o <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Copia els correus enviats a la carpeta «enviats» del &kmail;</guilabel
>: Seleccioneu aquesta opció si, cada vegada que s'activi una alarma de correu electrònic, voleu una còpia del correu electrònic enviat emmagatzemat a la carpeta «<filename
>enviats</filename
>» del &kmail;.</para>

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

<listitem>
<para
><guilabel
>Notifica quan es posin a la cua correus remots</guilabel
>: Seleccioneu aquesta opció per a mostrar una notificació quan una alarma de correu electrònic resti a la cua per a enviar-lo 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 «<filename
>sortida</filename
>» del &kmail;, de manera que podreu assegurar-vos que fareu el necessari per a transmetre efectivament el missatge.</para>
</listitem>

<listitem>
<para
>Seleccioneu la vostra adreça de correu electrònic a utilitzar com adreça del remitent en les alarmes de correu electrònic:</para>

<itemizedlist>
<listitem
><para
>Seleccioneu <guilabel
>De</guilabel
> per a introduir una adreça de correu electrònic.</para>
</listitem>

<listitem
><para
>Seleccioneu <guilabel
>Usa l'adreça predeterminada del KMail</guilabel
> per a utilitzar l'adreça predeterminada de correu electrònic que està configurada al &kmail;.</para>
</listitem>

<listitem
><para
>Seleccioneu <guilabel
>Usa les identitats del &kmail;</guilabel
> per a poder triar en el moment de configurar una alarma de correu electrònic del &kmail;, quines identitats emprar. La identitat predeterminada del &kmail; serà la utilitzada per a les alarmes que ja s'han configurat abans de seleccionar aquesta opció.</para>
</listitem>
</itemizedlist>
</listitem>

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

<itemizedlist>
<listitem
><para
>Seleccioneu <guilabel
>BCC</guilabel
> per a introduir una adreça de correu. Si les còpies ocultes s'han enviat al vostre compte a l'ordinador on s'executa el &kalarm;, aquí podreu introduir simplement el vostre nom d'usuari.</para>
</listitem>

<listitem
><para
>Seleccioneu <guilabel
>Usa l'adreça predeterminada del KMail</guilabel
> per a utilitzar l'adreça predeterminada de correu electrònic que està configurada al &kmail;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-view">
<title
>Vista</title>

<para
>La secció <guilabel
>Vista</guilabel
> permet controlar alguns aspectes de l'aparença del &kalarm;. A la pestanya <guilabel
>General</guilabel
>:</para>
<itemizedlist>

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

<itemizedlist>
<listitem>
<para
><guilabel
>Mostra sempre</guilabel
>: La icona de la safata del sistema es mostrarà sempre.</para>
</listitem>

<listitem>
<para
><guilabel
>Oculta automàticament si no hi ha alarmes actives</guilabel
>: La icona de la safata del sistema restarà oculta si no hi ha alarmes actives.</para>
</listitem>

<listitem>
<para
><guilabel
>Oculta automàticament si no vencen alarmes en el període de temps</guilabel
>: 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.</para>
</listitem>
</itemizedlist>

<para
>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 a mostrar les icones ocultes.</para>

<para
>Quan <guilabel
>Mostra a la safata del sistema</guilabel
> està seleccionada, tancar la icona a la safata del sistema tancarà totes les finestres principals del &kalarm;, i si no hi ha finestres de missatges visibles, sortirà de l'aplicació.</para>
</listitem>

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

<itemizedlist>
<listitem>
<para
><guilabel
>Mostra les alarmes de les pròximes 24 hores</guilabel
>: Quan se selecciona, es mostrarà un resum de les alarmes que vencin en les pròximes 24 hores.</para>
</listitem>

<listitem>
<para
><guilabel
>Nombre màxim d'alarmes a mostrar</guilabel
>: Desseleccioneu aquesta opció per a mostrar totes les alarmes de les pròximes 24 hores. Seleccioneu-la per a establir el nombre màxim d'alarmes que es mostraran.</para>
</listitem>

<listitem>
<para
><guilabel
>Mostra l'hora de l'alarma</guilabel
>: Seleccioneu aquesta opció per a mostrar l'hora en què està programada cada alarma.</para>
</listitem>

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

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

<listitem>
<para
>El grup de caselles <guilabel
>Llista d'alarmes</guilabel
> permet triar els colors utilitzats en la llista d'alarmes a la finestra principal del &kalarm;, per a mostrar les alarmes inhabilitades i arxivades.</para>
</listitem>
</itemizedlist>

<para
>La pestanya <guilabel
>Finestres d'alarma</guilabel
> conté les opcions per a controlar l'aparença de les finestres del missatge d'alarma. Les opcions disponibles depenen del sistema de finestres en ús.</para>

<itemizedlist>
<listitem>
<para
><application
>Sistema de finestres X11</application
></para>

<itemizedlist>
<listitem>
<para
><guilabel
>Col·loca les finestres lluny del cursor del ratolí</guilabel
>: Seleccioneu aquesta opció per a mostrar les finestres dels 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.</para>
</listitem>

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

<listitem>
<para
><guilabel
>Les finestres de missatge tenen una barra de títol i prenen el focus del teclat</guilabel
>: Aquesta opció controla si les finestres dels missatges d'alarma són modals o no, &ead;, si agafen el focus del teclat quan apareixen. Per a més detalls, vegeu la secció <link linkend="message-display"
>Visualitzar el missatge de l'alarma</link
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><application
>Sistema de finestres Wayland</application
></para>

<itemizedlist>
<listitem>
<para
>Per a reduir el risc d'accident en reconèixer l'alarma, els botons de la finestra estaran inicialment inhabilitats. El retard en segons abans que s'activin s'estableix a <guilabel
>Retard de l'activació dels botons (en segons)</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="preferences-edit">
<title
>Edita</title>

<para
>La secció <guilabel
>Edita</guilabel
> permet seleccionar els valors predeterminats en les opcions en el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>:</para>

<itemizedlist>
<listitem
><para
>La pestanya <guilabel
>General</guilabel
> conté les opcions que s'apliquen a tots els tipus d'alarma.</para>

<itemizedlist>
<listitem
><para
>Estableix el mètode predeterminat per a les alarmes visuals.</para>
</listitem>

<listitem
><para
>Establiu els estats predeterminats per a les caselles de selecció <guilabel
>Mostra al KOrganizer</guilabel
> i <guilabel
>Cancel·la si ja és tard</guilabel
>.</para>
</listitem>

<listitem
><para
>Establiu el tipus predeterminat de repetició.</para>
</listitem>

<listitem
><para
>Seleccioneu el tractament predeterminat en els anys no de traspàs de les recurrències anuals previstes per al 29 de febrer.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>La pestanya <guilabel
>Tipus d'alarma</guilabel
> conté les opcions que s'apliquen a tipus específics d'alarma.</para>

<itemizedlist>
<listitem>
<para
>Per a les alarmes visuals:</para>

<itemizedlist>
<listitem
><para
>Establiu els estats predeterminats per a les caselles de selecció <guilabel
>Tanca la finestra automàticament després d'aquest temps</guilabel
> i <guilabel
>Confirma el reconeixement</guilabel
>.</para>
</listitem>

<listitem
><para
>Establiu les unitats del període predeterminat per al recordatori.</para>
</listitem>

<listitem
><para
>Establiu les accions especials predeterminades de les alarmes visuals.</para>
</listitem>

<listitem
><para
>Establiu les opcions de so predeterminades. Cal tenir en compte que s'ha d'indicar un fitxer de so predeterminat, encara que el tipus de so no estigui establert a <guilabel
>Fitxer de so</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Per a les alarmes d'ordre:</para>

<itemizedlist>
<listitem
><para
>Establiu els estats predeterminats per a les caselles de selecció <guilabel
>Introduïu un script</guilabel
> i <guilabel
>Executa en una finestra de terminal</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Per a les alarmes de correu electrònic:</para>

<itemizedlist>
<listitem
><para
>Establiu l'estat predeterminat per a la casella de selecció <guilabel
>Còpia del correu a mi mateix</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>La pestanya <guilabel
>Lletra i color</guilabel
> permet establir l'aparença predeterminada dels missatges d'alarma. Seleccioneu la vostra lletra predeterminada, i els colors de primer pla i de fons.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Funcionament de la línia d'ordres</title>

<para
>Quan s'indiquen paràmetres de línia d'ordres, el &kalarm; no mostrarà la llista d'alarmes programades com s'ha descrit anteriorment a <link linkend="using-kalarm"
>Usar el &kalarm;</link
>. Les opcions específiques de la línia d'ordres per al &kalarm; es poden utilitzar per a les operacions següents:</para>

<itemizedlist>
<listitem
><para
>programar una alarma nova</para>
</listitem>
<listitem
><para
>controlar el mode visual del &kalarm;</para>
</listitem>
<listitem
><para
>obtenir ajuda</para>
</listitem>
</itemizedlist>

<para
>Les opcions addicionals de línia d'ordres es proporcionen principalment per a habilitar altres programes a la interfície del &kalarm;. Es descriuen en el capítol <link linkend="cmdline-interface"
>Guia del &kalarm; per a desenvolupadors</link
>.</para>

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

<sect1 id="cmdline-schedule">
<title
>Programar una alarma nova</title>

<para
>Les opcions següents s'utilitzen per a programar una alarma nova:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opció</entry>
  <entry
>Descripció</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Missatge de confirmació quan el missatge d'alarma és reconegut.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Especifica el camí o &URL; d'un fitxer que s'adjuntarà al correu electrònic. Aquesta opció es pot repetir si és necessari. Amb aquesta opció s'ha d'especificar <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Tanca automàticament la finestra d'alarma després de l'expiració del període <option
>--late-cancel</option
>. Amb aquesta opció s'ha d'especificar <option
>--late-cancel</option
>.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Emet un timbre audible quan es mostra el missatge. Amb aquesta opció no es poden especificar <option
>--speak</option
>, <option
>--play</option
> i <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Us envia una còpia oculta del correu electrònic. Amb aquesta opció s'ha d'especificar <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>color</replaceable
></option
></entry>
  <entry
>Estableix el color de fons del missatge al nom de color especificat per a les &Qt; o al codi hexadecimal 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>color</replaceable
></option
></entry>
  <entry
>Estableix el color de primer pla del missatge al nom de color especificat per a les &Qt; o al codi hexadecimal 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Inhabilita l'alarma. No s'activarà fins que s'hagi habilitat manualment.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Inhabilita el monitoratge d'alarmes. Això evita que les alarmes s'activin fins que torneu a habilitar les alarmes o reinicieu el &kalarm;, &pex;, en l'inici de sessió següent. Amb aquesta opció no es pot especificar <option
>--triggerEvent</option
>.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>línia_d'ordres</replaceable
></option
></entry>
  <entry
>Especifica una ordre de línia d'ordres a executar. Si s'especifica, aquesta opció haurà de ser l'última opció del &kalarm; a la línia d'ordres del &kalarm;. Tots els paràmetres de les ordres i opcions posteriors s'interpretaran com la formació de la línia d'ordres a executar. Amb aquesta opció no es poden especificar <option
>--file</option
>, <option
>--exec-display</option
> i <option
>--mail</option
>. S'ignoraran <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> i <option
>--colorfg</option
>.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>línia_d'ordres</replaceable
></option
></entry>
  <entry
>Especifica una ordre de línia d'ordres a executar per a generar el text del missatge d'alarma. Si s'especifica, aquesta opció haurà de ser l'última opció del &kalarm; a la línia d'ordres del &kalarm;. Tots els paràmetres i opcions posteriors s'interpretaran com la formació de la línia d'ordres a executar. Amb aquesta opció no es poden especificar <option
>--exec</option
>, <option
>--file</option
> i <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Especifica el camí o &URL; d'un fitxer de text o d'imatge per a formar el missatge d'alarma. Amb aquesta opció no es poden especificar <option
>--exec</option
>, <option
>--exec-display</option
> i <option
>--mail</option
>, i <replaceable
>missatge</replaceable
> no ha d'estar present.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Utilitza la identitat del &kmail; especificada com a remitent del correu electrònic. Amb aquesta opció s'ha d'especificar <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>període</replaceable
></option
></entry>
  <entry
>Estableix l'interval entre les repeticions de l'alarma. Les hores/minuts s'especifiquen en el format <replaceable
>nHnM</replaceable
>, on <replaceable
>n</replaceable
> és un nombre, &pex;, 3H30M. Els altres períodes de temps s'especifiquen en el format <replaceable
>nX</replaceable
>, on <replaceable
>n</replaceable
> és un nombre i <replaceable
>X</replaceable
> és una de les lletres següents: A (any), M (mes), S (setmana), D (dia). Si també s'especifica <option
>--recurrence</option
>, no estaran permesos A (anys) i M (mesos). Obligatori si s'especifica <option
>--repeat</option
> o <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Mostra l'alarma com un esdeveniment al calendari actiu del &korganizer;.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>període</replaceable
></option
></entry>
  <entry
>Cancel·la l'alarma si no es pot activar en el <replaceable
>període</replaceable
> especificat després de l'hora correcta. Hores/minuts s'especifiquen en el format <replaceable
>nHnM</replaceable
>, on <replaceable
>n</replaceable
> és un número, &pex;, 3H30M. Els altres períodes de temps s'especifiquen en el format <replaceable
>nX</replaceable
>, on <replaceable
>n</replaceable
> és un número i <replaceable
>X</replaceable
> és una de les lletres següents: S (setmanes), D (dies). El valor predeterminat de <replaceable
>període</replaceable
> és d'1 minut.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Activa l'alarma cada vegada que entreu. Amb aquesta opció no es poden especificar <option
>--interval</option
>, <option
>--repeat</option
> i <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>adreça</replaceable
></option
></entry>
  <entry
>Envia un correu a l'adreça especificada. Aquesta opció es pot repetir si és necessari. Amb aquesta opció no es poden especificar <option
>--exec</option
>, <option
>--exec-display</option
> i <option
>--file</option
>. Les opcions <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> i <option
>--colorfg</option
> seran ignorades amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>-n</option
>, <option
>--name <replaceable
>nom</replaceable
></option
></entry>
  <entry
>Especifica un nom per a ajudar-vos a identificar l'alarma.</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Mostra l'alarma com a una notificació, no en una finestra. Amb aquesta opció no es poden especificar <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> i <option
>--auto-close</option
>.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Especifica el camí o &URL; d'un fitxer d'àudio que es reproduirà una vegada, sigui com una alarma d'àudio o quan es mostri el missatge de l'alarma. Amb aquesta opció no es poden especificar <option
>--play-repeat</option
>, <option
>--beep</option
> i <option
>--speak</option
>.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Especifica el camí o &URL; d'un fitxer d'àudio que es reproduirà de forma repetida, o bé fins que s'utilitzi <guilabel
>Atura la reproducció</guilabel
>, o pel temps de mostrar el missatge d'alarma. Amb aquesta opció no es poden especificar <option
>--play</option
>, <option
>--beep</option
> i <option
>--speak</option
>.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Estableix l'alarma a repetir. Especifiqueu la repetició utilitzant la sintaxi d'iCalendar (definida en el <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), &pex;, «FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO». Amb aquesta opció no es pot especificar <option
>--until</option
>.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>compte</replaceable
></option
></entry>
  <entry
>Estableix el nombre de vegades que s'activarà l'alarma, o si s'ha especificat una recurrència amb <option
>--recurrence</option
>, el nombre de vegades que s'activarà l'alarma cada vegada que s'activi <option
>--recurrence</option
> (&ead;, una repetició dins d'una altra repetició). Si <option
>--recurrence</option
> no està present, especifiqueu -1 per a repetir l'alarma de forma indefinida. Amb aquesta opció hi haurà d'haver <option
>--interval</option
>, i <option
>--until</option
> no es podrà especificar.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>període</replaceable
></option
></entry>
  <entry
>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 <replaceable
>període</replaceable
> s'especifica en el mateix format com es descriu per a <option
>--late-cancel</option
>. De manera predeterminada, el recordatori es produirà abans de l'alarma. Per a especificar un recordatori després de l'alarma, utilitzeu el prefix <replaceable
>+</replaceable
> amb el <replaceable
>període</replaceable
>, &pex; +3D. Aquesta opció no es pot especificar amb <option
>--exec</option
>, <option
>--mail</option
> o <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>període</replaceable
></option
></entry>
  <entry
>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 <replaceable
>període</replaceable
> s'especifica en el mateix format com es descriu per a <option
>--reminder</option
>. Aquesta opció no es pot especificar amb <option
>--exec</option
>, <option
>--mail</option
> o <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Pronuncia el missatge quan es mostra. Aquesta opció requereix que el &kalarm; s'hagi construït amb el «speech» activat, i estigui instal·lat i funcionant el mòdul Speech de les &Qt;. Amb aquesta opció no es pot especificar <option
>--beep</option
>, <option
>--play</option
> i <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>assumpte</replaceable
></option
></entry>
  <entry
>La línia d'assumpte del correu. Amb aquesta opció s'ha d'especificar <option
>--mail</option
>.</entry>
</row>
<!-- test-set-time time (debug mode)-->
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>data/hora</replaceable
></option
></entry>
  <entry
>Activa l'alarma a la data o el dia/hora especificats. Especifica una data sense una hora en el format <replaceable
>aaaa-mm-dd[TZ]</replaceable
>, especifica una data i hora amb <replaceable
>[[[aaaa-]mm-]dd-]hh:mm[TZ]</replaceable
> (on s'ometrà, de manera predeterminada els camps de data als valors per a avui). Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>) o <userinput
>UTC</userinput
>, la qual representa la zona horària UTC.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>percentatge</replaceable
></option
></entry>
  <entry
>Ajusta el volum de l'àudio per a la reproducció del fitxer d'àudio. Aquesta opció només es pot utilitzar quan s'especifica <option
>--play</option
> o <option
>--play-repeat</option
>.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>data/hora</replaceable
></option
></entry>
  <entry
>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 <option
>--time</option
>. Cal tenir en compte que si s'especifica <option
>--time</option
>, la zona horària es prendrà del seu valor i no es podrà incloure en el valor de <option
>--until</option
>. Hi haurà d'estar <option
>--interval</option
>, i <option
>--repeat</option
> i <option
>--recurrence</option
> no es poden especificar amb aquesta opció.</entry>
</row>
<row>
  <entry
><replaceable
>missatge</replaceable
></entry>
  <entry
>Text de missatge a mostrar o, si s'especifica <option
>--mail</option
>, el cos del missatge del correu.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

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

<para
>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:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>red</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Recordatori de \nSTOP"</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>-c <replaceable
>0xFF0000</replaceable
></option
> <option
>-t <replaceable
>27-22:00</replaceable
></option
> <option
><replaceable
>"Recordatori de\nSTOP"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Altres opcions</title>

<para
>Les opcions següents s'utilitzen per a realitzar diverses funcions, incloent-hi mostrar el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
>.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opció</entry>
  <entry
>Descripció</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>ID_esdeveniment</replaceable
></option
></entry>
  <entry
>Mostra el diàleg Edita l'alarma per a editar l'alarma amb l'ID de l'esdeveniment especificat. L'ID de l'esdeveniment és un ID únic, de manera opcional precedit pel nom configurat o l'ID numèric del recurs que conté l'esdeveniment, en el format <replaceable
>[ID_recurs:]UID_esdeveniment</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Mostra el diàleg d'edició de l'alarma, per tal d'editar una alarma d'àudio nova.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Mostra el diàleg d'edició de l'alarma, amb la finalitat d'editar una alarma d'ordre nova.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Mostra el diàleg d'edició de l'alarma, per tal d'editar una alarma visual nova.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Mostra el diàleg d'edició de l'alarma, per tal d'editar una alarma de correu nova.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>nom_plantilla</replaceable
></option
></entry>
  <entry
>Mostra el diàleg d'edició de l'alarma, configurat amb la plantilla d'alarma amb el nom especificat, per tal d'editar una alarma nova.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Genera una llista de les alarmes programades a <filename
>stdout</filename
>. La llista mostra una breu descripció de cadascuna de les alarmes pendents: el seu identificador de recurs, l'UID, l'hora programada següent i el text del missatge o fitxer.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Mostra el &kalarm; com una icona a la safata del sistema.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Inhabilita el monitoratge de totes les alarmes.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Vegeu també:</para>
<simplelist>
<member
>kf6options(7)</member>
<member
>qt6options(7)</member>
</simplelist>

</sect1>

</chapter>

<chapter id="developers">
<title
>Guia del &kalarm; per a desenvolupadors</title>

<para
>El &kalarm; proporciona una interfície per a permetre que altres aplicacions requereixin les funcions següents:</para>

<itemizedlist>
<listitem
><para
>programar una alarma nova</para
></listitem>
<listitem
><para
>cancel·lar una alarma ja programada</para
></listitem>
<listitem
><para
>activar una alarma ja programada</para
></listitem>
<listitem
><para
>mostrar el diàleg d'edició de l'alarma</para
></listitem>
<listitem
><para
>llistar les alarmes planificades</para
></listitem>
</itemizedlist>

<para
>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 el &kalarm; ja està en execució.</para>

<sect1 id="dbus-interface">
<title
>Interfície de &DBus;</title>

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

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>cancel·la una alarma ja programada.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>ID_esdeveniment</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>ID_esdeveniment</parameter
></term>
<listitem>
<para
>Especifica l'ID únic de l'esdeveniment a cancel·lar, de manera opcional precedit pel nom configurat o l'ID numèric del recurs que conté l'esdeveniment, en el format <replaceable
>[ID_recurs:]UID_esdeveniment</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>

<para
><function
>cancelEvent()</function
> és una crida de &DBus; per a cancel·lar l'alarma especificada. El &kalarm; suprimirà l'alarma del calendari sense que es mostri o executi.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>activa una alarma ja programada.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>ID_esdeveniment</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>ID_esdeveniment</parameter
></term>
<listitem>
<para
>Especifica l'ID únic de l'esdeveniment a activar, de manera opcional precedit pel nom configurat o l'ID numèric del recurs que conté l'esdeveniment, en el format <replaceable
>[ID_recurs:]UID_esdeveniment</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>

<para
><function
>triggerEvent()</function
> és una crida de &DBus; per a activar la visualització immediata o l'execució de l'alarma especificada (sense importar l'hora a la qual està programada). El &kalarm; recuperarà l'alarma del calendari i després la mostra o executa.</para>

<para
>Si l'alarma ja ha vençut, llavors el &kalarm; suprimirà totes les aparicions programades de l'alarma fins a l'hora actual, i si no roman la repetició de l'alarma, l'alarma se suprimirà del calendari. Si l'alarma no ha vençut, les seves aparicions programades no es modificaran.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>programa un missatge d'alarma nou.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>nom</replaceable
>,
                     const QString&amp; <replaceable
>missatge</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <replaceable
>etiquetes</replaceable
>, 
                     const QString&amp; <replaceable
>ColorFons</replaceable
>, 
                     const QString&amp; <replaceable
>ColorPrimerPla</replaceable
>, 
                     const QString&amp; <replaceable
>tipus_de_lletra</replaceable
>, 
                     const QString&amp; <replaceable
>URL_àudio</replaceable
>, 
                     int <replaceable
>MinutsRecordatori</replaceable
>, 
                     const QString&amp; <replaceable
>recurrència</replaceable
>,
                     int <replaceable
>IntervalSubRepetecions</replaceable
>, 
                     int <replaceable
>CompteSubRepetecions</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>nom</replaceable
>,
                     const QString&amp; <replaceable
>missatge</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataInici</replaceable
>, 
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <replaceable
>etiquetes</replaceable
>, 
                     const QString&amp; <replaceable
>ColorFons</replaceable
>, 
                     const QString&amp; <replaceable
>ColorPrimerPla</replaceable
>, 
                     const QString&amp; <replaceable
>tipus_de_lletra</replaceable
>, 
                     const QString&amp; <replaceable
>URLàudio</replaceable
>, 
                     int <replaceable
>MinutsRecordatori</replaceable
>, 
                     int <replaceable
>TipusRecurrència</replaceable
>, 
                     int <replaceable
>IntervalRecurrència</replaceable
>, 
                     int <replaceable
>CompteRecurrència</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>nom</replaceable
>,
                     const QString&amp; <replaceable
>missatge</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataInici</replaceable
>, 
                     int <replaceable
>CancellaTard</replaceable
>, 
                     unsigned <replaceable
>etiquetes</replaceable
>, 
                     const QString&amp; <replaceable
>ColorFons</replaceable
>, 
                     const QString&amp; <replaceable
>ColorPrimerPla</replaceable
>, 
                     const QString&amp; <replaceable
>tipus_de_lletra</replaceable
>, 
                     const QString&amp; <replaceable
>URLàudio</replaceable
>, 
                     int <replaceable
>MinutsRecordatori</replaceable
>, 
                     int <replaceable
>TipusRecurrència</replaceable
>, 
                     int <replaceable
>IntervalRecurrència</replaceable
>, 
                     const QString&amp; <replaceable
>DataHoraFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>nom</parameter
></term>
<listitem>
<para
>Especifica un nom opcional per a l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>missatge</parameter
></term>
<listitem>
<para
>Especifica el text del missatge a programar, o si <parameter
>etiquetes</parameter
> té establert el bit <userinput
>DISPLAY_COMMAND</userinput
>, especifica la línia d'ordres a executar per a generar el text del missatge.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>HoraDataInici</parameter
></term>
<listitem>
<para
>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 <replaceable
>AAAA-MM-DD[TZ]</replaceable
> (com és retornat per <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format <replaceable
>AAAA-MM-DDTHH:MM[:SS][TZ]</replaceable
> (com és retornat per <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> ) o <replaceable
>HH:MM[:SS]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Cal tenir en compte que qualsevol valor per als segons serà ignorat.</para>

<para
>Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>) o <userinput
>UTC</userinput
>, la qual representa la zona horària UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CancellaTard</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>etiquetes</parameter
></term>
<listitem>
<para
>Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. Cal tenir en compte que no tots els bits de l'etiqueta són aplicables a les alarmes de missatge.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ColorFons</parameter
></term>
<listitem>
<para
>Especifica el color de fons per a mostrar el missatge. La cadena pot estar en el format «#RRGGBB» (com és retornat per <methodname
>QColor::name()</methodname
> 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 <methodname
>QColor::setNamedColor()</methodname
>, com un nom en la base de dades de color de X (&pex; «red» o «steelblue»). Establiu la cadena a «null» per a especificar el color predeterminat per al fons actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ColorPrimerPla</parameter
></term>
<listitem>
<para
>Especifica el color de primer pla per a mostrar el missatge. El format de la cadena és el mateix que per a <parameter
>ColorFons</parameter
>, o bé establiu la cadena a «null» per a especificar el color predeterminat per al primer pla actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>tipus_de_lletra</parameter
></term>
<listitem>
<para
>Especifica la lletra per a mostrar el missatge. El format de la cadena és la sortida de <methodname
>QFont::toString()</methodname
>. Establiu la cadena a «null» per a utilitzar la lletra predeterminada per al missatge actual quan es mostri aquest.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URLàudio</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>MinutsRecordatori</parameter
></term>
<listitem>
<para
>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 perquè el recordatori es mostri després de l'alarma principal. Especifiqueu 0 si no es requereix el recordatori.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrència</parameter
></term>
<listitem>
<para
>Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>TipusRecurrència</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. 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 <parameter
>HoraDataInici</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en <parameter
>TipusRecurrència</parameter
>) entre les recurrències de l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>DataHoraFinal</parameter
></term>
<listitem>
<para
>Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si <replaceable
>HoraDataInici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>HoraDataInici</replaceable
> 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 <replaceable
>HoraDataInici</replaceable
> per a interpretar el valor d'aquest paràmetre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de minuts entre les subrepeticions de l'alarma. Especifiqueu 0 per a sense subrepeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de subrepeticions de l'alarma, incloent-hi l'ocurrència inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Descripció</title>
<para
><function
>scheduleMessage()</function
> é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ó.</para>

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

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>programa una alarma nova que mostrarà el contingut d'un fitxer de text o d'imatge.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>nom</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                  int <replaceable
>CancellaTard</replaceable
>,
                  unsigned <replaceable
>etiquetes</replaceable
>,
                  const QString&amp; <replaceable
>ColorFons</replaceable
>,
                  const QString&amp; <replaceable
>URLàudio</replaceable
>,
                  int <replaceable
>MinutsRecordatori</replaceable
>,
                  const QString&amp; <replaceable
>recurrència</replaceable
>,
                  int <replaceable
>IntervalSubRepetecions</replaceable
>, 
                  int <replaceable
>CompteSubRepetecions</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>nom</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                  int <replaceable
>CancellaTard</replaceable
>,
                  unsigned <replaceable
>etiquetes</replaceable
>,
                  const QString&amp; <replaceable
>ColorFons</replaceable
>,
                  const QString&amp; <replaceable
>URLàudio</replaceable
>,
                  int <replaceable
>MinutsRecordatori</replaceable
>,
                  int <replaceable
>TipusRecurrència</replaceable
>,
                  int <replaceable
>IntervalRecurrència</replaceable
>,
                  int <replaceable
>CompteRecurrència</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>nom</replaceable
>,
                  const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                  int <replaceable
>CancellaTard</replaceable
>,
                  unsigned <replaceable
>etiquetes</replaceable
>,
                  const QString&amp; <replaceable
>ColorFons</replaceable
>,
                  const QString&amp; <replaceable
>URLàudio</replaceable
>,
                  int <replaceable
>MinutsRecordatori</replaceable
>,
                  int <replaceable
>TipusRecurrència</replaceable
>,
                  int <replaceable
>IntervalRecurrència</replaceable
>,
                  const QString&amp; <replaceable
>HoraDataFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>nom</parameter
></term>
<listitem>
<para
>Especifica un nom opcional per a l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
>Especifica el fitxer de text o d'imatge el contingut del qual es mostrarà en el missatge que es programi.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>HoraDataInici</parameter
></term>
<listitem>
<para
>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 <replaceable
>AAAA-MM-DD[TZ]</replaceable
> (com és retornat per <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format <replaceable
>AAAA-MM-DDTHH:MM[:SS][TZ]</replaceable
> (com és retornat per <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> ) o <replaceable
>HH:MM[:SS]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Cal tenir en compte que qualsevol valor per als segons serà ignorat.</para>

<para
>Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>) o <userinput
>UTC</userinput
>, la qual representa la zona horària UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CancellaTard</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>etiquetes</parameter
></term>
<listitem>
<para
>Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. Cal tenir en compte que no tots els bits de l'etiqueta són aplicables a les alarmes de fitxer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ColorFons</parameter
></term>
<listitem>
<para
>Especifica el color de fons per a mostrar el fitxer. La cadena pot estar en el format «#RRGGBB» (com és retornat per <methodname
>QColor::name()</methodname
> 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 <methodname
>QColor::setNamedColor()</methodname
>, com un nom en la base de dades de color de X (&pex; «red» o «steelblue»). Establiu la cadena a «null» per a especificar el color predeterminat per al fons actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URLàudio</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>MinutsRecordatori</parameter
></term>
<listitem>
<para
>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 perquè el recordatori es mostri després de l'alarma principal. Especifiqueu 0 si no es requereix el recordatori.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrència</parameter
></term>
<listitem>
<para
>Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>TipusRecurrència</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. 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 <parameter
>HoraDataInici</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en <parameter
>TipusRecurrència</parameter
>) entre les recurrències de l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>DataHoraFinal</parameter
></term>
<listitem>
<para
>Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si <replaceable
>HoraDataInici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>HoraDataInici</replaceable
> 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 <replaceable
>HoraDataInici</replaceable
> per a interpretar el valor d'aquest paràmetre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de minuts entre les subrepeticions de l'alarma. Especifiqueu 0 per a sense subrepeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de subrepeticions de l'alarma, incloent-hi l'ocurrència inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>
<para
><function
>scheduleFile()</function
> é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. A part d'especificar un camí o &URL; de fitxer i ometent el color de fons i la lletra, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -per a més detalls, vegeu la descripció de la funció-.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>programa una alarma nova que executarà una ordre.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>nom</replaceable
>,
                     const QString&amp; <replaceable
>Línia_d'ordres</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <replaceable
>etiquetes</replaceable
>,
                     const QString&amp; <replaceable
>recurrència</replaceable
>,
                     int <replaceable
>IntervalSubRepetecions</replaceable
>, 
                     int <replaceable
>CompteSubRepetecions</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>nom</replaceable
>,
                     const QString&amp; <replaceable
>Línia_d'ordres</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <replaceable
>etiquetes</replaceable
>,
                     int <replaceable
>TipusRecurrència</replaceable
>,
                     int <replaceable
>IntervalRecurrència</replaceable
>,
                     int <replaceable
>CompteRecurrència</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>nom</replaceable
>,
                     const QString&amp; <replaceable
>Línia_d'ordres</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataInicial</replaceable
>,
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <replaceable
>etiquetes</replaceable
>,
                     int <replaceable
>TipusRecurrència</replaceable
>,
                     int <replaceable
>IntervalRecurrència</replaceable
>,
                     const QString&amp; <replaceable
>HoraDataFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>nom</parameter
></term>
<listitem>
<para
>Especifica un nom opcional per a l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>línia_d'ordres</parameter
></term>
<listitem>
<para
>Especifica l'ordre a executar. El paràmetre <parameter
>etiquetes</parameter
> indica si aquest paràmetre conté una línia d'ordres o un script d'ordres.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>HoraDataInici</parameter
></term>
<listitem>
<para
>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 <replaceable
>AAAA-MM-DD[TZ]</replaceable
> (com és retornat per <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format <replaceable
>AAAA-MM-DDTHH:MM[:SS][TZ]</replaceable
> (com és retornat per <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> ) o <replaceable
>HH:MM[:SS]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Cal tenir en compte que qualsevol valor per als segons serà ignorat.</para>

<para
>Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>) o <userinput
>UTC</userinput
>, la qual representa la zona horària UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CancellaTard</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>etiquetes</parameter
></term>
<listitem>
<para
>Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. Cal tenir en compte que no tots els bits de l'etiqueta són aplicables a les alarmes d'ordre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrència</parameter
></term>
<listitem>
<para
>Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>TipusRecurrència</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. 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 <parameter
>HoraDataInici</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en <parameter
>TipusRecurrència</parameter
>) entre les recurrències de l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>DataHoraFinal</parameter
></term>
<listitem>
<para
>Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si <replaceable
>HoraDataInici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>HoraDataInici</replaceable
> 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 <replaceable
>HoraDataInici</replaceable
> per a interpretar el valor d'aquest paràmetre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de minuts entre les subrepeticions de l'alarma. Especifiqueu 0 per a sense subrepeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de subrepeticions de l'alarma, incloent-hi l'ocurrència inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>
<para
><function
>scheduleCommand()</function
> és una crida de &DBus; per a programar la línia d'ordres especificada, o scripts d'ordres, per a executar a la data i hora especificats. A part d'especificar una ordre i ometent els paràmetres del color de fons, la lletra i el fitxer d'àudio, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -per a més detalls, vegeu la descripció de la funció-.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>programa una alarma nova que enviarà un correu electrònic.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>nom</replaceable
>,
                   const QString&amp; <replaceable
>ID_De</replaceable
>,
                   const QString&amp; <replaceable
>adreces</replaceable
>,
                   const QString&amp; <replaceable
>assumpte</replaceable
>,
                   const QString&amp; <replaceable
>missatge</replaceable
>,
                   const QString&amp; <replaceable
>adjunts</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <replaceable
>etiquetes</replaceable
>,
                   const QString&amp; <replaceable
>recurrència</replaceable
>,
                   int <replaceable
>IntervalSubRepetecions</replaceable
>, 
                   int <replaceable
>CompteSubRepetecions</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>nom</replaceable
>,
                   const QString&amp; <replaceable
>ID_De</replaceable
>,
                   const QString&amp; <replaceable
>adreces</replaceable
>,
                   const QString&amp; <replaceable
>assumpte</replaceable
>,
                   const QString&amp; <replaceable
>missatge</replaceable
>,
                   const QString&amp; <replaceable
>adjunts</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <replaceable
>etiquetes</replaceable
>,
                   int <replaceable
>TipusRecurrència</replaceable
>,
                   int <replaceable
>IntervalRecurrència</replaceable
>,
                   int <replaceable
>CompteRecurrència</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>nom</replaceable
>,
                   const QString&amp; <replaceable
>ID_De</replaceable
>,
                   const QString&amp; <replaceable
>adreces</replaceable
>,
                   const QString&amp; <replaceable
>assumpte</replaceable
>,
                   const QString&amp; <replaceable
>missatge</replaceable
>,
                   const QString&amp; <replaceable
>adjunts</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>, 
                   unsigned <replaceable
>etiquetes</replaceable
>,
                   int <replaceable
>TipusRecurrència</replaceable
>,
                   int <replaceable
>IntervalRecurrència</replaceable
>,
                   const QString&amp; <replaceable
>TempsFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>nom</parameter
></term>
<listitem>
<para
>Especifica un nom opcional per a l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ID_De</parameter
></term>
<listitem>
<para
>La identitat del &kmail; a utilitzar com a remitent del correu. Si està buida, l'adreça del remitent serà la configurada a les <link linkend="preferences-email"
>preferències de correu</link
> del &kalarm;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>adreces</parameter
></term>
<listitem>
<para
>Una llista separada per comes de les adreces de correu dels destinataris.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>assumpte</parameter
></term>
<listitem>
<para
>Especifica la línia d'assumpte del correu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>missatge</parameter
></term>
<listitem>
<para
>Especifica el cos del missatge del correu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>adjunts</parameter
></term>
<listitem>
<para
>Una llista separada per comes dels camins o &URL; dels fitxers a enviar com a adjunts del correu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>HoraDataInici</parameter
></term>
<listitem>
<para
>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 <replaceable
>AAAA-MM-DD[TZ]</replaceable
> (com és retornat per <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format <replaceable
>AAAA-MM-DDTHH:MM[:SS][TZ]</replaceable
> (com és retornat per <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> ) o <replaceable
>HH:MM[:SS]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Cal tenir en compte que qualsevol valor per als segons serà ignorat.</para>

<para
>Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>) o <userinput
>UTC</userinput
>, la qual representa la zona horària UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CancellaTard</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>etiquetes</parameter
></term>
<listitem>
<para
>Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. Cal tenir en compte que no tots els bits de l'etiqueta són aplicables a les alarmes de correu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrència</parameter
></term>
<listitem>
<para
>Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>TipusRecurrència</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. 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 <parameter
>HoraDataInici</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en <parameter
>TipusRecurrència</parameter
>) entre les recurrències de l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>DataHoraFinal</parameter
></term>
<listitem>
<para
>Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si <replaceable
>HoraDataInici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>HoraDataInici</replaceable
> 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 <replaceable
>HoraDataInici</replaceable
> per a interpretar el valor d'aquest paràmetre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de minuts entre les subrepeticions de l'alarma. Especifiqueu 0 per a sense subrepeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de subrepeticions de l'alarma, incloent-hi l'ocurrència inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>
<para
><function
>scheduleEmail()</function
> és una crida de &DBus; per a programar el correu especificat per a enviar a la data i hora especificats. A part d'especificar una capçalera i contingut i ometent els paràmetres de color del missatge, la lletra i el fitxer d'àudio, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -per a més detalls, vegeu la descripció de la funció-.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>programa una alarma nova que executarà una ordre.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>nom</replaceable
>,
                   const QString&amp; <replaceable
>URLàudio</replaceable
>,
                   int <replaceable
>PercentatgeVolum</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <replaceable
>etiquetes</replaceable
>,
                   const QString&amp; <replaceable
>recurrència</replaceable
>,
                   int <replaceable
>IntervalSubRepetecions</replaceable
>, 
                   int <replaceable
>CompteSubRepetecions</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>nom</replaceable
>,
                   const QString&amp; <replaceable
>URLàudio</replaceable
>,
                   int <replaceable
>PercentatgeVolum</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <replaceable
>etiquetes</replaceable
>,
                   int <replaceable
>TipusRecurrència</replaceable
>,
                   int <replaceable
>IntervalRecurrència</replaceable
>,
                   int <replaceable
>CompteRecurrència</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>nom</replaceable
>,
                   const QString&amp; <replaceable
>URLàudio</replaceable
>,
                   int <replaceable
>PercentatgeVolum</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataInici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <replaceable
>etiquetes</replaceable
>,
                   int <replaceable
>TipusRecurrència</replaceable
>,
                   int <replaceable
>IntervalRecurrència</replaceable
>,
                   const QString&amp; <replaceable
>HoraDataFinal</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>nom</parameter
></term>
<listitem>
<para
>Especifica un nom opcional per a l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>URLàudio</parameter
></term>
<listitem>
<para
>Especifica el fitxer d'àudio que es reproduirà.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>PercentatgeVolum</parameter
></term>
<listitem>
<para
>Especifica el nivell de volum a utilitzar, com a percentatge del volum total. Especifiqueu -1 per a utilitzar el volum predeterminat.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>HoraDataInici</parameter
></term>
<listitem>
<para
>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 <replaceable
>AAAA-MM-DD[TZ]</replaceable
> (com és retornat per <methodname
>QDate::toString(Qt::ISODate)</methodname
>). Per a una alarma amb una data i una hora, la cadena haurà d'estar en el format <replaceable
>AAAA-MM-DDTHH:MM[:SS][TZ]</replaceable
> (com és retornat per <methodname
>QDateTime::toString(Qt::ISODate)</methodname
> ) o <replaceable
>HH:MM[:SS]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Cal tenir en compte que qualsevol valor per als segons serà ignorat.</para>

<para
>Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>) o <userinput
>UTC</userinput
>, la qual representa la zona horària UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CancellaTard</parameter
></term>
<listitem>
<para
>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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>etiquetes</parameter
></term>
<listitem>
<para
>Especifica l'OR lògic de les etiquetes d'alarma desitjades. Els bits de l'etiqueta són els definits en la classe <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. Cal tenir en compte que no tots els bits de l'etiqueta són aplicables a les alarmes d'ordre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>recurrència</parameter
></term>
<listitem>
<para
>Especifica una recurrència regular de l'alarma, utilitzant la sintaxi d'iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. 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.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>TipusRecurrència</parameter
></term>
<listitem>
<para
>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 <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>. 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 <parameter
>HoraDataInici</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de períodes (minuts/dies/setmanes/mesos/anys com s'especifica en <parameter
>TipusRecurrència</parameter
>) entre les recurrències de l'alarma.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteRecurrència</parameter
></term>
<listitem>
<para
>Especifica el nombre de vegades que s'ha de repetir l'alarma. Especifiqueu -1 per a repetir l'alarma de forma indefinida.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>DataHoraFinal</parameter
></term>
<listitem>
<para
>Especifica la data final o la data/hora, per a les recurrències de l'alarma. Si <replaceable
>HoraDataInici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>HoraDataInici</replaceable
> 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 <replaceable
>HoraDataInici</replaceable
> per a interpretar el valor d'aquest paràmetre.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>IntervalSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de minuts entre les subrepeticions de l'alarma. Especifiqueu 0 per a sense subrepeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de subrepeticions de l'alarma, incloent-hi l'ocurrència inicial.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>
<para
><function
>scheduleAudio()</function
> és una crida de &DBus; per a programar el fitxer d'àudio especificat a reproduir a la data i hora especificats. A part d'especificar un volum i ometent els paràmetres de color del missatge i la lletra, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -per a més detalls, vegeu la descripció de la funció-.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>edit</refname>
<refpurpose
>Mostra el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> per a editar una alarma.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>ID_esdeveniment</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>ID_esdeveniment</parameter
></term>
<listitem>
<para
>Especifica l'ID únic de l'esdeveniment a editar, de manera opcional precedit pel nom configurat o l'ID numèric del recurs que conté l'esdeveniment, en el format <replaceable
>[ID_recurs:]UID_esdeveniment</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Valor de retorn</title>
<para
><returnvalue
>fals</returnvalue
> si l'alarma especificada no s'ha trobat o és de només lectura, <returnvalue
>cert</returnvalue
> el contrari.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>

<para
><function
>edit()</function
> és una crida de &DBus; per a mostrar el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> per a editar l'alarma especificada.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Mostra el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> per a editar una alarma nova.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>tipus</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>nom_plantilla</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>tipus</parameter
></term>
<listitem>
<para
>Especifica el tipus d'alarma. Els valors permesos són DISPLAY, COMMAND, EMAIL, AUDIO. Aquests es defineixen en la classe <classname
>KAlarmIface</classname
> en el fitxer <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>nom_plantilla</parameter
></term>
<listitem>
<para
>Especifica el nom d'una plantilla d'alarma com a base de l'alarma activa nova.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Valor de retorn</title>
<para
><returnvalue
>fals</returnvalue
> si <parameter
>tipus</parameter
> té un valor no vàlid, o si no es pot trobar una plantilla amb el nom <parameter
>nom_plantilla</parameter
>; <returnvalue
>cert</returnvalue
> en cas contrari.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>

<para
><function
>editNew()</function
> és una crida de &DBus; per a mostrar el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> per a 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.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>list</refentrytitle>
</refmeta>
<refnamediv>
<refname
>list</refname>
<refpurpose
>Retorna una llista de les alarmes planificades.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Valor de retorn</title>
<para
>Llista d'alarmes, separades per salts de línia, cadascuna en el format <returnvalue
><replaceable
>ID_recurs</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>hora</replaceable
> <replaceable
>text</replaceable
></returnvalue
></para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Descripció</title>

<para
><function
>list()</function
> és una crida de &DBus; per a 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, l'UID, l'hora programada següent i el text del missatge o fitxer.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Interfície de la línia d'ordres</title>

<para
>Les opcions de línia d'ordres es proporcionen per a permetre que altres programes iniciïn el &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 aquesta finalitat és que si el &kalarm; es va iniciar sense cap paràmetre de línia d'ordres i després s'envien les crides de &DBus;, aquest començarà de manera predeterminada en el mode gràfic, el qual no és desitjable per a crides internes a l'aplicació.</para>

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

<para
>Les opcions de línia d'ordres per a programar una alarma nova es descriuen en el capítol de <link linkend="cmdline-operation"
>Funcionament de la línia d'ordres</link
>. Les opcions per a activar i cancel·lar alarmes programades són les següents:</para>

<note
><para
>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).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opció</entry>
  <entry
>Descripció</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>ID_esdeveniment</replaceable
></option
></entry>
  <entry
>Cancel·la l'alarma amb l'ID de l'esdeveniment especificat. L'ID de l'esdeveniment és un ID únic, de manera opcional precedit per l'ID del recurs que conté l'esdeveniment, en el format <replaceable
>[ID_recurs:]UID_esdeveniment</replaceable
>. L'acció agafada és la mateixa que per a la crida de &DBus; <link linkend="cancelEvent"
>cancelEvent()</link
>. Amb aquesta opció no es pot especificar <option
>--triggerEvent</option
>.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>ID_esdeveniment</replaceable
></option
></entry>
  <entry
>Activa l'alarma amb l'ID de l'esdeveniment especificat. L'ID de l'esdeveniment és un ID únic, de manera opcional precedit per l'ID del recurs que conté l'esdeveniment, en el format <replaceable
>[ID_recurs:]UID_esdeveniment</replaceable
>. L'acció agafada és la mateixa que per a la crida de &DBus; <link linkend="triggerEvent"
>triggerEvent()</link
>. Amb aquesta opció no es pot especificar <option
>--cancelEvent</option
>.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Exemples:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299,702</replaceable
></option
></userinput>
<prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--cancelEvent <replaceable
>&kalarm;-388886299,793</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>
</chapter>


<chapter id="faq">
<title
>Preguntes i respostes</title>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Quin tipus de fitxers de configuració utilitza el &kalarm;?</para>
</question>
<answer>
<para
>La configuració del &kalarm; es manté en els fitxers següents a la carpeta <command
>qtpaths --paths GenericConfigLocation</command
> :</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarmrc</filename
> manté les vostres preferències del &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarmresources</filename
> manté la llista dels calendaris d'alarma que utilitza actualment el &kalarm;.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>A on emmagatzema el &kalarm; les seves alarmes?</para>
</question>
<answer>

<para
>Quan s'executa per primera vegada el &kalarm;, crea els calendaris d'alarma següents a la carpeta <command
>qtpaths --paths GenericDataLocation</command
> :</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
>, el qual manté les alarmes actives.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
>, el qual manté les alarmes arxivades.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
>, el qual manté les plantilles d'alarma.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
> és un fitxer de calendari especial per a contenir els detalls de les alarmes que es mostren actualment, el qual permet que el &kalarm;, quan es torna a iniciar, torni a mostrar les alarmes que es mostraven la darrera vegada que es va aturar.</simpara>
</listitem>
</itemizedlist>

<para
>Posteriorment, podreu substituir aquests calendaris, excepte el <filename
>displaying.ics</filename
>, o crear calendaris d'alarma addicionals en qualsevol ubicació que trieu. Podreu esbrinar quins fitxers de calendari estan actualment en ús veient els detalls de cada calendari a la llista dels calendaris d'alarma.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>En quin format s'emmagatzemen les alarmes?</para>
</question>
<answer>
<para
>Els fitxers de calendari en els que el &kalarm; emmagatzema les seves alarmes són fitxers de text en el format definit en el document <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. Aquest és el format estàndard utilitzat per totes les aplicacions del kdepim. El &kalarm; utilitza certes propietats no estàndard, de conformitat amb el RFC2445. Aquestes es troben documentades en el fitxer <filename
>DESIGN-kalarmcalendar.html</filename
> que es distribueix amb el &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Quina és la funció del connector de l'Akonadi del &kalarm;?</para>
</question>
<answer>
<para
>El &kalarm; usa el seu connector de l'Akonadi per a proporcionar totes les característiques que depenen de l'&akonadi; (el servei d'emmagatzematge d'escriptori creuat &PIM; de &kde;). Si aquest connector no s'ha instal·lat ni activat, el &kalarm; no tindrà les característiques següents: <itemizedlist>
<listitem>
<simpara
>L'enviament de correus via el &kmail;, deixant el &Sendmail; com a única opció per a enviar correus electrònics (vegeu <link linkend="preferences-email"
>preferències de correu</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Operacions d'arrossegar i deixar anar correus electrònics.</simpara>
</listitem>
<listitem>
<simpara
>Selecció d'adreces de correu des del &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Importació de les dates de naixement des del &kaddressbook;.</simpara>
</listitem>
<listitem>
<simpara
>Migració dels recursos de calendaris d'alarma de l'&akonadi; en la primera execució d'una versió nova del &kalarm;.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Si el connector està instal·lat, es pot activar o desactivar en la pestanya <link linkend="preferences-general"
>General</link
> del diàleg de Configuració.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Què és el programa <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> és un petit programa d'ajuda en la funció d'inici automàtic del &kalarm; en iniciar la sessió.</para>

<para
>El &kalarm; sol ser restaurat pel gestor de sessions a l'inici de la sessió (per a 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ó.</para>

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

<qandaentry>
<question>
<para
>Puc utilitzar el &kalarm; en un escriptori que no sigui &plasma;?</para>
</question>
<answer>
<para
>Per a executar el &kalarm; en un escriptori no &plasma;, el requisit principal és assegurar-se que el &kalarm; s'executa automàticament cada vegada que accediu. Obtindreu instruccions més detallades en el fitxer <filename
>INSTALL</filename
> que es distribueix amb el &kalarm;.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Crèdits i llicència</title>

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

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

<para
>Traductor/Revisor de la documentació: &credits.Antoni.Bella;</para
> &underFDL; &underGPL; <para
>Donem les gràcies a l'autor de l'aplicació KAlarm al &kde; 1, Stefan Nikolaus (<email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>), qui amablement va accedir a permetre que el nom &kalarm; sigui utilitzat per a aquesta aplicació, la qual ha estat disponible des del &kde; 2 en endavant. </para>

</chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->

