<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalarm;">
  <!ENTITY package "kdepim">
  <!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 de &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>
<holder
>&David.Jarvie;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>28-05-2013</date>
<releaseinfo
>2.10.03 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&kalarm; és un planificador d'alarma personal de missatge, ordre i correu electrònic per al &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
>&kalarm; us permet programar la visualització de missatges d'alarma personal, la reproducció de fitxers de so, l'execució d'ordres i l'enviament de missatges de correu electrònic.</para>

<para
>En el seu mode gràfic per omissió, &kalarm; mostra la llista d'alarmes pendents, mostrant els seus temps i els detalls. Podeu crear noves alarmes, o seleccionar les existents per a modificació o eliminació. Opcionalment, també podeu veure les alarmes expirades.</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 les alarmes visuals, podeu escriure un text de missatge, especificar un fitxer de text o d'imatge a mostrar, o especificar una ordre per mostrar la seva sortida. També podeu triar el color del missatge d'alarma, i si reproduir un so o parlar el missatge.</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, es mostrarà a cada escriptori &kde; per assegurar que no us el perdeu. La finestra de missatges mostrarà el temps durant el qual s'ha programat l'alarma. En general, té una opció de diferir per 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 de &kalarm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Missatge d'alarma</phrase>
</textobject>
</mediaobject>
</screenshot>

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

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

</chapter>

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

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

<tip
><para
>Totes els botons de selecció de valors en &kalarm; disposen d'acceleració. Per realitzar el canvi de valor a grans passos, manteniu premuda la tecla &Maj; mentre feu clic en els botons de fletxa incrementals.</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 &kalarm; proporciona 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'ordres executen bé una ordre o un script de l'intèrpret d'ordres que podeu escriure. No es veurà res a menys que es produeixi un error.</para>
</listitem>

<listitem>
<para
>Les alarmes de correu envien un correu electrònic. No es veurà res a menys que es produeixi un error.</para>
</listitem>

<listitem>
<para
>Les alarmes d'àudio reprodueixen un fitxer d'àudio. No es veurà res a menys que es produeixi un error.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Gestió d'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 les alarmes visuals si succeeix un error d'execució d'una pre- o post-alarma d'ordre especificada en el diàleg accions especials, excepte que el color de fons de la columna no es canvia a vermell.</para>

</sect2>
</sect1>

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

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

<screenshot>
<screeninfo
>Captura de pantalla de la finestra principal de &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 propera hora d'activació programada i el seu interval de repetició bàsic (&pex;, <quote
>1 dia</quote
> per una repetició diària, <quote
>3 setmanes</quote
> per a una repetició es desencadena el dilluns i dimecres cada tres setmanes, <quote
>En entrar</quote
> per 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 ordre de pre- o post-alarma d'una alarma visual, es mostrarà una indicació d'error en el color de la columna, tal com s'ha descrit anteriorment a <link linkend="errors"
>Gestió d'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 o text fent clic sobre la barra de títol de la columna corresponent. Per invertir l'ordre, feu clic altra vegada a la barra de títol de la columna.</para>

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

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

</sect2>

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

<para
>Per omissió, &kalarm; arxiva les alarmes per un període de temps limitat, una vegada que han expirat o s'han suprimit. (Fixeu-vos que les alarmes que suprimiu només s'emmagatzemen s'han activat almenys una vegada). Podeu controlar si &kalarm; haurà d'arxivar les alarmes expirades, i per quant temps, en el <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 amagar-les altra vegada, deseleccioneu <menuchoice
><guimenu
>Visualitza</guimenu
><guimenuitem
>Mostra les alarmes arxivades</guimenuitem
></menuchoice
>.</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 trobar les alarmes que contenen un cert text. Per 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 continuar la cerca de més alarmes que coincideixen, utilitzeu <menuchoice
><guimenu
>Edita</guimenu
><guimenuitem
>Cerca següent</guimenuitem
></menuchoice
> o <menuchoice
><guimenu
>Edita</guimenu
><guimenuitem
>Cerca anterior</guimenuitem
></menuchoice
>.</para>

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

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

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

<listitem>
<para
>Les alarmes d'ordres: 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 a 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 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 nova alarma</title>

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

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

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

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

<listitem>
<para
>Per basar la vostra alarma nova en una existent, ressalteu-la en 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 crear una nova alarma que mostri un missatge de correu electrònic existent, arrossegueu-lo des del &kmail; cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Després seleccioneu l'opció <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 remitent, destinatari, &etc;) com al text de l'alarma.</para>
</listitem>

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

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

<listitem>
<para
>Per a crear una nova alarma d'ordre, arrossegueu el text d'un script que comenci amb <quote
>#!</quote
> cap a la finestra principal de &kalarm; o la icona de la safata del sistema. A continuació, seleccioneu l'opció <guilabel
>Alarma d'ordres</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 crear una alarma visual de fitxer, arrossegueu un text o &URL; de fitxer d'imatge cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Això obrirà el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> i s'establirà com al nom de fitxer.</para>
</listitem>

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

<listitem>
<para
>Per a crear una nova alarma de text, arrossegueu una peça de text cap a la finestra principal de &kalarm; o la icona de la safata del sistema. Si s'us demana, seleccioneu l'opció <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 les alarmes d'aniversari per a les persones en &kaddressbook; tal com es descriu en <link linkend="birthdays"
>Importar aniversaris des de &kaddressbook;</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

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

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

<itemizedlist>
<listitem>
<para
>Feu doble clic sobre la seva entrada en 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
> al 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 suprimir les alarmes existents, seleccioneu-ne una o més fent clic a les seves entrades a la llista d'alarmes. A continuació, realitzeu una de les següents accions:</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
> al menú contextual.</para>
</listitem>
<listitem>
<para
>Per suprimir-les sense un missatge de confirmació, premeu &Maj;-<keycap
>Supr</keycap
>.</para>
</listitem>
</itemizedlist>

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

<para
>Podeu reactivar una alarma suprimida des de la llista d'alarmes arxivades, sempre que no hagi expirat. Per fer-ho, en primer lloc mostreu les alarmes arxivades, tal com es descriu en <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
> al menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>

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

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

</sect2>

<sect2>
<title
>Establir una alarma per despertar de l'estat de suspensió</title>

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

</sect2>

<sect2>
<title
>Confirmar una alarma</title>

<para
>Veure <link linkend="message-window"
>Finestra de missatge d'alarma</link
> per saber com confirmar 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 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 per a que us recordi l'emissió d'un programa de televisió que varia d'una setmana a una altra. La plantilla conté tots els detalls de l'alarma (missatge de text, ja sigui per reproduir un so, &etc;) a excepció de l'hora i la data. Ara, per crear l'alarma, tot el que necessitareu fer és obrir el <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 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
>Nova des de 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
>Nova des de plantilla</guimenuitem
></menuchoice
> al 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 plantilla...</guibutton
> per seleccionar una plantilla amb la que preconfigurar el diàleg.</para>
</listitem>
</itemizedlist>

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

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

<para
>Per crear una nova plantilla d'alarma, realitzeu una de les següents accions:</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 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 eliminar les plantilles existents, mostreu el diàleg Plantilles d'alarma seleccionant l'element de menú <menuchoice
> <guimenu
>Fitxers</guimenu
><guimenuitem
>Plantilles...</guimenuitem
> </menuchoice
>, seleccioneu-ne una o més i feu clic a <guibutton
>Elimina</guibutton
>. Es mostrarà un missatge de confirmació per evitar eliminacions 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 següents controls 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 ha de ser únic.</para>
</listitem>

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

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

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

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

<listitem>
<para
>Marcar <guilabel
>Temps des d'ara</guilabel
> per entrar el temps (en hores i minuts) després del qual es crearà l'alarma -s'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'alarma</title>

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

<para
>Podeu veure i gestionar els calendaris a través de la llista de calendaris, que es poden mostrar juntament amb la llista d'alarmes a la finestra principal de &kalarm;. Les alarmes de tots els calendaris d'alarma es mostren fusionades a la llista d'alarmes. Quan es desa una nova alarma, podeu definir una opció de configuració per determinar si s'ha de desar automàticament en el calendari per omissió, o si se us ha de demanar que seleccioneu un calendari. Quan s'edita una alarma existent, aquesta es desarà automàticament de nou en el seu calendari d'alarma original.</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'alarma es classifiquen per tipus d'alarma i el tipus d'emmagatzematge. El qual es pot deshabilitar, establir a només lectura, o fer el calendari per omissió per al seu tipus d'alarma.</para>

<variablelist>
<varlistentry>
<term
>Tipus d'alarma</term>
<listitem>
<para
>Els tres tipus d'entitats d'alarma &ndash;alarmes activades, alarmes arxivades i plantilles d'alarma&ndash; s'emmagatzemen en els calendaris d'alarma separats. &kalarm; té tres tipusde calendaris per omissió estàndard, un per a cada tipus (veure <link linkend="faq"
>Preguntes i respostes</link
> per a més detalls), que podeu canviar si ho voleu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Tipus d'emmagatzematge</term>
<listitem>
<para
>&kalarm; gestiona tres tipus d'emmagatzematge de calendaris d'alarma:</para>

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

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

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

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

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

<varlistentry>
<term
>Estat habilitat/deshabilitat</term>
<listitem>
<para
>Deshabilitar un calendari té el mateix efecte que eliminar-lo, excepte que encara apareix a la llista de calendaris per facilitar el tornar-lo a habilitar. Quan es deshabilita, les alarmes seran ignorades i no apareixeran a la llista d'alarmes o a la llista de plantilles. Quan es torna a habilitar, les alarmes es tornaran a mostrar i, si es tracta d'un calendari d'alarma actiu, s'activarà.</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 és possible ajornar les alarmes, ja que per això seria necessari el temps d'ajornament que es desa a l'alarma. Quan s'activen les alarmes, no s'eliminaran del calendari i seran arxivades fins que vos o un altre usuari accedeixi al calendari en mode de lectura i escriptura.</para>

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

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

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

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

<listitem
><para
>Si no teniu permisos per escriure al fitxer o una 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
> del menú contextual (veure <link linkend="import"
>Importar alarmes de calendaris externs</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Estat del calendari per omissió</term>
<listitem>
<para
>Un calendari de cada tipus d'alarma es pot fer opcionalment el calendari per omissió per a aquest tipus d'alarma. Les alarmes noves es desen automàticament al calendari per omissió per al tipus d'alarma apropiat, llevat que s'hagi seleccionat l'opció de preguntar per les noves alarmes i plantilles en el <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, es poden mostrar o ocultar fent <menuchoice
> <guimenu
>Visualitza</guimenu
><guimenuitem
>Mostra Calendaris</guimenuitem
> </menuchoice
>. Quan s'utilitza la llista de calendaris, primer seleccioneu el tipus d'alarma utilitzant el quadre combinat a sobre de la llista. Llavors, o bé feu clic en un dels botons sota la llista, o bé feu clic <mousebutton
>dret</mousebutton
> sobre el calendari apropiat en la llista i escolliu un element al 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, on podreu introduir la ubicació del calendari i les seves característiques. Si no hi ha cap calendari d'alarma existent a la ubicació especificada, es crearà un de nou.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Elimina</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Elimina el calendari seleccionat a la llista. El calendari mateix es deixa intacte; simplement s'esborra de la llista i, si ho voleu, posteriorment es podrà reinstal·lar a la llista.</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
>Recarrega</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Recarrega el calendari seleccionat. Es torna a llegir el calendari des de la seva ubicació d'emmagatzematge, assegurant que no hi ha discrepància entre el que mostra &kalarm; i l'estat actual del calendari. Si el calendari és compartit amb altres usuaris, qualsevol canvi realitzat ara serà vist per &kalarm;.</para>

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

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

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importa...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importa les alarmes des d'un fitxer de calendari extern al calendari seleccionat. Això es descriu en <link linkend="import"
>Importar alarmes de calendaris externs</link
>. Aquesta opció no està disponible per als calendaris deshabilitats 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 en <link linkend="export"
>Exportar alarmes a calendaris externs</link
>. Aquesta opció no està disponible per als calendaris deshabilitats.</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 l'estat. </para>
</listitem>
</varlistentry>

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

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

<varlistentry>
<term
><menuchoice
><guimenuitem
>Neteja el color</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Neteja el color de ressaltat de les alarmes d'aquest calendari a la llista d'alarmes.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

</sect2>

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

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

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

<para
>Si heu configurat <link linkend="calendars"
>calendaris d'alarma</link
>, les alarmes de cada tipus s'afegiran al calendari per omissió adequat, o si s'ha seleccionat l'opció de preguntar per les noves alarmes i plantilles en el <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
> al menú contextual. Això importa les alarmes del tipus seleccionat a aquest calendari. Per exemple, si el tipus de calendari seleccionat és plantilles d'alarma, les plantilles d'alarma (i no les alarmes actives o les alarmes arxivades) seran importades.</para>
</listitem>
</itemizedlist>

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

</sect2>

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

<para
>Podeu exportar les alarmes de &kalarm; a altres fitxers de calendari, ja sigui de les alarmes seleccionades a la llista d'alarmes, o totes les alarmes d'un calendari d'alarma. Els mètodes per fer-ho són els següents. Independentment del mètode utilitzat, podeu crear un fitxer de calendari nou o afegir les alarmes exportades a un fitxer de calendari existent. Per afegir-les, marqueu <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 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
> al menú contextual, o utilitzeu <menuchoice
><guimenu
>Fitxer</guimenu
> <guimenuitem
>Exporta les alarmes seleccionades...</guimenuitem
></menuchoice
> al menú principal.</para>
</listitem>

<listitem>
<para
>Per 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
> al menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>

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

<para
>Podeu definir les alarmes visuals per a dates de naixement desades en &kaddressbook;, per <menuchoice
><guimenu
>Fitxer</guimenu
> <guimenuitem
>Importa 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
>, podeu definir el text que es mostrarà en els missatges d'alarma de data de naixement. El text del missatge es crea mitjançant la combinació de text de <guilabel
>Prefix</guilabel
> seguit del nom de la persona seguit del text de <guilabel
>Sufix</guilabel
>. No s'afegeixen 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, la llista de selecció de la data de naixement es tornarà a avaluar.</para
></note>
</listitem>

<listitem>
<para
>A la llista <guilabel
>Selecció de dates de naixement</guilabel
>, seleccioneu les dates de naixement per a les que voleu crear alarmes. Tingueu en compte que la llista només mostra les entrades de &kaddressbook; que continguin una data de naixement i que encara no té una alarma en el format definit actualment en el grup de caselles <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'alarma</link
>, les alarmes s'afegiran al calendari d'alarmes actiu per omissió, o si s'ha seleccionat l'opció de preguntar per les noves alarmes i plantilles en el <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 de &kalarm;. La majoria de les accions es poden desfer, inclosa la creació, edició i supressió de les alarmes i les plantilles d'alarma, i la reactivació de les alarmes. Per evitar l'ús excessius de recursos per part de l'historial de desfer, el nombre de canvis emmagatzemats es limita als últims 12.</para>

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

<para
>Per 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 del qual podreu escollir l'acció a desfer. Si no veieu l'acció que esteu cercant, recordeu que primer podríeu necessitar desfer els canvis més recents, dels que depèn el canvi desitjat. Per exemple, podeu editar una alarma i després suprimir-la, no podreu desfer l'edició fins que no haver desfet la supressió.</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 us permet veure i editar una alarma. La primera vegada que utilitzeu &kalarm;, es mostrarà una forma simplificada del diàleg, amb només un petit nombre d'opcions visibles. Per veure-les totes, feu clic al botó <guibutton
>Més opcions</guibutton
>; per tornar al diàleg simplificat, feu clic al botó <guibutton
>Menys opcions</guibutton
>. &kalarm; recorda sempre la vostra última elecció cada vegada que es torna a mostrar el diàleg d'edició de l'alarma.</para>

<para
>Podeu configurar els valors per omissió 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
>Acció de l'alarma</title>

<para
>Els controls en el grup de caselles <guilabel
>Acció</guilabel
> varien 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 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 de missatge d'alarma (el qual podrà incloure salts de línia) al quadre d'edició.</para>
</listitem>

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

<listitem>
<para
><guilabel
>Sortida de l'ordre</guilabel
> per especificar que el text del missatge d'alarma serà generat per una ordre que s'executa quan s'activa l'alarma. Veure <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 mostrar l'alarma silenciosament.</para>
</listitem>

<listitem>
<para
><guilabel
>Timbre </guilabel
> per que soni un timbre.</para>
</listitem>

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

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

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

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

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

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

<listitem>
<para
>Si ho voleu, pot fer esvair el volum. Significa començar la reproducció a un volum a nivell normal i poc a poc fer-lo minvar fins al final, en un interval de temps especificat. El volum final és introduït en <guilabel
>Estableix el volum</guilabel
>. Per habilitar l'esvaïment, marqueu <guilabel
>Esvaïment</guilabel
>, i després introduïu el seu període en segons al 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 el so</guibutton
> per provar els nivells de so seleccionats.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Utilitzeu el botó <guibutton
>Tipus de lletra i color...</guibutton
> per seleccionar un tipus de lletra, i els colors del frontal i de fons, per al missatge d'alarma. En el diàleg <guilabel
>Escolliu el tipus de lletra i color de l'alarma</guilabel
>, marqueu <guilabel
>Usa el tipus de lletra per omissió</guilabel
> per mostrar el missatge en qualsevol tipus de lletra configurat com a per omissió en el moment en què es mostri el missatge. Per escollir un tipus de lletra específic per al missatge, desmarqueu <guilabel
>Usa el tipus de lletra per omissió</guilabel
>. (El tipus de lletra per omissió 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 entrada de text del missatge d'alarma.</para>
</listitem>

<listitem>
<para
>Utilitzeu el botó <guibutton
>Accions especials...</guibutton
> per 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ó pre-alarma</guilabel
>, introduïu una ordre de línia d'ordres a executar abans de mostrar l'alarma. Tingueu en compte que &kalarm; esperarà que es completi l'ordre abans de mostrar l'alarma.</para>

<para
>Una acció de pre-alarma només s'executa una vegada, quan el missatge d'alarma es mostra inicialment, fins i tot quan un missatge de recordatori és substituït pel missatge d'alarma real. <emphasis
>No</emphasis
> s'executa en cap de les següents circumstàncies:</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 <guilabel
>Executa per les alarmes ajornades</guilabel
> estigui marcada.</para
></listitem>
<listitem
><para
>Quan s'estava mostrant el missatge en el moment d'accedir a la sessió i es restaura després, quan 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 pre-alarma es pot utilitzar per controlar si es mostrarà el missatge d'alarma:</para>

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

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

<listitem>
<para
>En el camp <guilabel
>Acció post-alarma</guilabel
>, introduïu l'ordre a executar quan reconegueu 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 següents circumstàncies:</para>

<itemizedlist>
<listitem
><para
>Quan es tanca un missatge de recordatori.</para
></listitem>
<listitem
><para
>En posposar l'alarma, excepte quan l'alarma ajornada és 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
>Veure <link linkend="command-alarm"
>Alarmes d'ordres</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'ordres</title>

<para
>Les alarmes d'ordres 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 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. Tingueu en compte que quan s'executa l'ordre des del botó <guibutton
>Prova</guibutton
> en el diàleg d'edició de l'alarma, el <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'ordres són els següents:</para>

<itemizedlist>
<listitem>
<para
>La casella de selecció <guilabel
>Introduïu un script</guilabel
> us 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 passa directament a l'intèrpret d'ordres per omissió (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, podeu introduir el text d'un script a executar. Recordeu incloure a l'script una primera línia com <literal
>#!/bin/bash</literal
> per assegurar-vos que s'invoca l'intèrpret d'ordres correcte.</para>
</listitem>

<listitem>
<para
>Utilitzeu el grup de caselles <guilabel
>Sortida de l'ordre</guilabel
> per 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 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 desar la sortida de l'ordre en un fitxer. La sortida, precedida per un títol mostrarà el moment en què estava programat executar l'ordre, s'afegirà al contingut existent del fitxer. Introduïu el nom de fitxer en el quadre d'edició, o utilitzeu el botó al costat del quadre d'edició per mostrar un diàleg de selecció de fitxers.</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 electrònic 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 veure la vostra llibreta d'adreces del &kde; des de la qual podreu seleccionar els destinataris del correu electrònic. Es poden afegir adjunts utilitzant el botó <guibutton
>Afegeix...</guibutton
>. Tingueu en compte que els adjunts hauran d'existir quan s'activi l'alarma, no s'emmagatzemarà cap còpia en el moment de configurar l'alarma. Per esborrar un fitxer, seleccioneu-lo a la llista desplegable i feu clic al botó <guibutton
>Elimina</guibutton
>.</para>

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

<itemizedlist>
<listitem>
<para
>El quadre combinat <guilabel
>A</guilabel
> us permet seleccionar quina identitat de &kmail; utilitzar per a l'enviament del correu electrònic. Aquesta opció només apareix si la vostra adreça de correu electrònic <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
>Copia del correu a si mateix</guilabel
> per enviar una còpia oculta del correu a vos mateix quan s'activi l'alarma. L'adreça de correu electrònic a la qual es va enviar la còpia es pot establir en el <link linkend="preferences-email"
>diàleg de configuració</link
>, el valor per omissió serà l'adreça de correu electrònic configurada en l'Arranjament del sistema del &kde;.</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 següents opcions:</para>

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

<listitem>
<para
>Marqueu <guilabel
>Repetició</guilabel
> per repetir contínuament el fitxer d'àudio fins que se seleccioni l'opció <guilabel
>Atura la reproducció</guilabel
>. Per 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
> al 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 reproduït.</para>
</listitem>

<listitem>
<para
>Si ho voleu, pot fer esvair el volum. Significa començar la reproducció a un volum a nivell normal i poc a poc fer-lo minvar fins al final, en un interval de temps especificat. El volum final és introduït en <guilabel
>Estableix el volum</guilabel
>. Per habilitar l'esvaïment, marqueu <guilabel
>Esvaïment</guilabel
>, i després introduïu el seu període en segons al 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 que es va ajornar l'alarma. <guibutton
>Canvia...</guibutton
> mostrarà un diàleg que us permetrà 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 data i hora</guilabel
> introduïu la data i hora a la que 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 configurada, en la data especificada. (<link linkend="preferences-time"
>Configurar &kalarm;</link
> descriu com configurar el temps d'inici del dia).</para>

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

<listitem>
<para
><guilabel
>Temps des d'ara</guilabel
> per 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 aplicar a l'alarma. Aquesta s'utilitzarà per a totes les dates i hores en relació amb aquesta alarma, incloent les dates i hores de recurrència i excepció. Normalment, haureu d'abandonar els controls de la zona horària sense canvis a menys que tingueu una bona raó per canviar-la.</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 per omissió establerta en el <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
>, que serà la zona horària del vostre ordinador a menys que s'hagi canviat.</para>
</listitem>

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

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

</sect2>

<sect2>
<title
>Recordatori</title>

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

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

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


</sect2>

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

<para
>Les opcions finals de cancel·lació de l'alarma determinen com és 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 cancel·lar l'alarma si no es pot activar dins d'un període de temps especificat després de l'hora correcta. El període de temps se selecciona mitjançant els controls que apareixen quan marqueu la casella. Per exemple, si introduïu un període de temps d'1 hora, l'alarma s'activarà en la primera oportunitat una hora després, 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 calcula 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 activar l'alarma a la primera oportunitat a partir de l'hora programada, sense importar quan temps hagi transcorregut.</para>

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

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

</sect2>

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

<para
>Especifiqueu si 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 conveniència en el títol de la pestanya <guilabel
>Recurrència</guilabel
>. Primer es mostra l'interval de recurrència, seguit per l'interval de la sub-repetició establert mitjançant el botó <guibutton
>Sub-repetició</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 activar l'alarma un única vegada, seleccioneu <guilabel
>Sense recurrència</guilabel
>.</para
></listitem>

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

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

<itemizedlist>
<listitem>
<para
>Per a una recurrència setmanal, marqueu tots els dies de la setmana en què 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 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 especificar el nombre total d'ocurrències de l'alarma.</para
></listitem>

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

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

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

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

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

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

<sect3>
<title
>Sub-repetició</title>

<para
>Podeu utilitzar el botó <guibutton
>Sub-repetició</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 sub-repetició. Per exemple, per configurar una alarma que es repeteix cada hora des del migdia fins a les 18:00 de cada dijous, establireu una repetició setmanal el dijous a les 12:00, i utilitzareu el diàleg de sub-repetició per especificar un interval d'1 hora i o bé un compte de 6 o bé una durada de 6 hores.</para>

<para
>Al diàleg <guibutton
>Sub-repetició</guibutton
> mostrat en fer clic al botó <guilabel
>Sub-repetició</guilabel
>, marqueu <guilabel
>Repeteix cada</guilabel
> per establir una repetició, o desmarqueu-la per 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 vulgui (per exemple, dies) i després introduïu el nombre d'unitats.</para>
</listitem>

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

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

<listitem
><para
>Seleccioneu <guilabel
>Durada</guilabel
> per introduir el període de temps total durant el qual s'haurà de repetir l'alarma. No haurà de ser un múltiple exacte de l'interval de repetició, automàticament s'arrodoneix a la baixa quan feu clic a <guibutton
>Bé</guibutton
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

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

</sect3>
</sect2>

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

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

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

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

<para
>Premeu el botó <guibutton
>Carrega la plantilla</guibutton
> per seleccionar una plantilla per 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 provar l'alarma i comprovar si funciona correctament. S'executarà com si s'hagués programat en la forma normal. En el cas d'una alarma d'àudio, premeu el botó <guibutton
>Prova</guibutton
> una segona vegada per aturar la reproducció del fitxer de so.</para>

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

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Finestra de missatge d'alarma</title>

<para
>Quan venç un missatge d'alarma, es mostrarà a cada escriptori &kde; per assegurar que no us el perdeu. La finestra de missatges mostrarà el temps durant el qual s'ha programat l'alarma, de manera que podeu veure quan va sorgir si hereu fora de l'ordinador en aquell moment. Si el temps programat de l'alarma es troba en una zona horària diferent de la configuració del vostre ordinador local, també es mostrarà la zona horària. (Per als missatges de recordatori, la data/hora mostrada serà la prevista per a l'alarma principal o la seva recurrència, no la del missatge de recordatori, i el títol de la finestra serà <quote
>Recordatori</quote
>).</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 de missatges d'alarma proporciona qualsevol de les següents opcions 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 l'acceptació</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 fins a la data i hora</guilabel
> per introduir la data i hora en què el missatge es tornarà a mostrar, o seleccioneu <guilabel
>Ajorna durant un interval de temps</guilabel
> per introduir quant temps després d'ara (en hores i minuts) s'haurà de mostrar de nou el missatge. Feu clic a <guibutton
>Bé</guibutton
> per ajornar-la i tancar la seva finestra.</para>

<note
><para
>L'hora a la que s'ajorni l'alarma haurà de ser anterior a la propera activació programada o següent recordatori avançat. Per aquesta raó, el ​botó <guibutton
>​Ajorna...</guibutton
> a la finestra de missatge d'alarma i el botó <guibutton
>Bé</guibutton
> en el diàleg d'ajornament es deshabiliten un minut abans de la propera activació o recordatori avançat.</para>
<para
>Tingueu en compte que si es configura un recordatori <emphasis
>després</emphasis
> de l'alarma, <emphasis
>podríeu</emphasis
> retardar 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
>Repeat at login</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 <quote
>atura la reproducció</quote
>.</para>
</listitem>

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

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

<listitem>
<para
>El botó que mostra la icona de <guiicon
>&kalarm;</guiicon
> proporciona una manera convenient per activar &kalarm;.</para>
</listitem>
</itemizedlist>

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

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

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

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

<sect2>
<title
>Col·locar les finestres de missatges</title>

<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 reduir el risc de reconèixer accidentalment l'alarma, els botons de la finestra seran deshabilitats inicialment, activant-se només després d'un retard configurable.</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 per a que 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
>Col·locació de finestres</guimenuitem
> </menuchoice
>. Si voleu, podeu configurar una tecla de drecera global per a aquesta acció.</para>

</sect2>
</sect1>

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

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

<para
>La icona de la safata del sistema de &kalarm; per omissió resta oculta automàticament sempre que no hi ha alarmes vençudes en les properes 24 hores. Podeu canviar el límit de temps d'ocultació automàtica, o mostrar sempre la icona de la safata del sistema, utilitzant el <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 alternar entre mostra i oculta la finestra principal de &kalarm;.</para>

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

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Habilita o deshabilita el control de canvi de les alarmes.</action
></para>
<para
>Veure <link linkend="enable-disable"
>Habilitar i deshabilitar les alarmes</link
> per a més detalls.</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 crear una nova alarma.</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
>Col·locació de finestres</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Col·loca 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 &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Mostra el diàleg de configuració de &kalarm;.</action
></para>
<para
>El diàleg de configuració es descriu en <link linkend="preferences"
>Configurar &kalarm;</link
>. Inclou les opcions relatives a la icona de la safata del sistema de &kalarm;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Restaura/Minimitza</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Restaura o minimitza la finestra principal de &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 de &kalarm;.</action
></para>
<para
>Surt de &kalarm; si no s'estan mostrant finestres de missatges d'alarma.</para>
</listitem>
</varlistentry>
</variablelist>

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

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

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

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

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

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

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

<para
>Podeu tornar a carregar un calendari individual i refrescar 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
>. Veure <link linkend="calendars"
>Calendaris d'alarma</link
> per a més detalls.</para>

</sect1>

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

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

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

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

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

<para
>Quan una alarma es torna a habilitar individualment, no s'activarà mentre estiguin deshabilitades. En altres paraules, el deshabilitar una alarma individual cancel·la totes les seves ocurrències fins que es torni a habilitar.</para>

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

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

<sect2>
<title
>Habilitar la monitorització d'alarmes</title>

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

<para
>Si la monitorització d'alarmes està deshabilitada, feu el següent per 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
> al menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Deshabilitar la monitorització d'alarmes</title>

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

<itemizedlist>
<listitem>
<para
>Deseleccioneu <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 deseleccioneu <menuchoice
><guimenuitem
>Habilita les alarmes</guimenuitem
></menuchoice
> al menú contextual.</para>
</listitem>

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

<listitem>
<para
>Aturar &kalarm; com es descriu en <link linkend="quitting"
>Sortir de &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Les alarmes es poden deshabilitar permanent evitant que &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 deshabilitar individualment les alarmes</title>

<para
>Per habilitar individualment les alarmes que estan deshabilitades, realitzeu una de les següents accions:</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
> al menú contextual.</para>
</listitem>
</itemizedlist>

<para
>Per deshabilitar individualment les alarmes que estan actualment habilitades, realitzeu una de les següents accions:</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
>Deshabilita</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
>Deshabilita</guimenuitem
></menuchoice
> al menú contextual.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

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

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

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

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

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

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

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

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

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

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

</sect1>

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

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

</sect1>
</chapter>

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

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

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

<para
>La secció <guilabel
>General</guilabel
> us permetrà controlar el comportament de &kalarm; en general:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Inicia automàticament en entrar</guilabel
>: &kalarm; s'iniciarà automàticament en iniciar la sessió de &kde;, assegurant-vos que &kalarm; s'executa en tot moment a menys que surtiu manualment.</para>

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

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

<listitem>
<para
><guilabel
>Avisa abans de sortir</guilabel
>: Quan les alarmes estan deshabilitades mentre &kalarm; no s'està executant, en seleccionar aquesta opció se us demanarà confirmació si intenteu finalitzar &kalarm; utilitzant l'opció <menuchoice
><guimenu
>Surt</guimenu
></menuchoice
> de la icona de la safata del sistema. Això previndrà la deshabilitació accidental de les alarmes. Per raons de seguretat, aquesta opció es torna a habilitar automàticament per omissió cada vegada que canvieu el mode d'execució.</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 d'ajornament d'alarma per defecte</guilabel
>: Introduïu l'interval de temps per omissió, en hores i minuts, per mostrar inicialment quan es mostri el diàleg d'alarma ajornada. Tingueu en compte que si s'ha ajornat una alarma anteriorment, l'interval que es mostra inicialment en el diàleg d'alarma ajornada serà igual que l'interval d'ajornament utilitzat l'última vegada que l'alarma es va ajornar.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal per les alarmes d'ordres</guilabel
>: Podeu seleccionar quin tipus de finestra de terminal utilitzar per a les alarmes d'ordres que s'executin en una finestra de terminal. Algunes de les aplicacions més comuns 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 invocar la finestra de terminal. Per omissió, la cadena d'ordre de l'alarma s'afegirà al que especifiqueu. També podeu especificar a on s'inserirà la cadena d'ordre de l'alarma, utilitzant els següents codis:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>La cadena d'ordre de l'alarma que serà substituïda.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>La cadena d'ordre de l'alarma que serà substituïda, amb un <literal
>sleep</literal
> afegit.</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 l'ordre per executar el fitxer que serà substituït.</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
>, i l'ordre per executar el fitxer que serà substituït.</para>
</listitem>
</varlistentry>
</variablelist>

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

</itemizedlist>
</sect1>

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

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

<itemizedlist>
<listitem
><para
><guilabel
>Zona horària</guilabel
>: Seleccioneu la zona horària. &kalarm; l'utilitza per tot, excepte quan la substituïu individualment per a les alarmes.</para>
</listitem>

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

<listitem
><para
><guilabel
>Inici de dia per a les alarmes per data</guilabel
>: Estableix l'hora d'inici de la jornada per activar de només data, &ead;, aquelles per a les que es va seleccionar l'opció <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 us permeten definir les vostres hores de treball, és necessari quan l'única 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'inic del dia</guilabel
>: Introduïu l'hora a la qual comenceu a treballar 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 establir en &korganizer; per a les alarmes que es copien a &korganizer;. La durada per omissió és zero.</para>
</listitem>

</itemizedlist>
</sect1>

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

<para
>La secció <guilabel
>Emmagatzematge</guilabel
> us 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 emmagatzemar les alarmes i plantilles d'alarma noves quan s'utilitzin diversos calendaris d'alarma:</para>

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

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

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

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

<listitem
><para
><guibutton
>Neteja alarmes arxivades</guibutton
>: Aquest botó descarta totes les alarmes actualment arxivades al calendari per omissió d'alarmes arxivades. (Els altres calendaris d'alarmes arxivades no seran modificats en el cas que es comparteixen amb altres persones). Això no té efecte sobre les alarmes que posteriorment expirin o s'eliminin, 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
> us permet escollir les opcions per enviar i adreçar les alarmes de correu electrònic:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Client de correu</guilabel
>: Especifiqueu el client de correu electrònic a utilitzar per 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 és enviat a través de &kmail; (el qual en primer lloc serà iniciat si cal) de la següent manera:</para>

<itemizedlist>
<listitem
><para
>Si &kmail; és la versió 1.7 o posterior, el correu electrònic serà enviat automàticament.</para>
</listitem>

<listitem
><para
>Si &kmail; és una versió anterior, el correu electrònic serà afegit a la carpeta «<filename
>sortida</filename
>» del &kmail; per a la seva posterior transmissió.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Quan s'activa una alarma de correu electrònic, aquest correu és enviat automàticament a traves de &Sendmail;. Aquesta opció només funcionarà si el sistema està configurat per utilitzar &Sendmail;, o un agent de transport de correu compatible com <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'activa 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 &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 mostrar una notificació quan una alarma de correu electrònic resti a la cua per enviar a un sistema remot. Això pot ser útil si, per exemple, teniu una connexió telefònica, o el correu electrònic es posa a la cua en la carpeta «<filename
>sortida</filename
>» del &kmail;, de manera que us podeu assegurar que fareu el necessari per 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 introduir una adreça de correu electrònic.</para>
</listitem>

<listitem
><para
>Seleccioneu <guilabel
>Usa l'adreça de l'arranjament del sistema</guilabel
> per utilitzar l'adreça de correu electrònic que està configurada a l'Arranjament del sistema del &kde;.</para>
</listitem>

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

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

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

<listitem
><para
>Seleccioneu <guilabel
>Usa l'adreça de l'arranjament del sistema</guilabel
> per utilitzar l'adreça de correu electrònic que està configurada a l'Arranjament del sistema del &kde;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

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

<para
>La secció <guilabel
>Vista</guilabel
> us permet controlar alguns aspectes de l'aparença de &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 &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 mostrar les icones ocultes.</para>

<para
>Quan <guilabel
>Mostra a la safata del sistema</guilabel
> està seleccionat, el tancar la icona a la safata del sistema tancarà totes les finestres principals de &kalarm;, i si no hi ha finestres de missatges visibles, sortirà de l'aplicació.</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 de &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 primeres alarmes per a les pròximes 24 hores.</para>
</listitem>

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

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

<itemizedlist>
<listitem>
<para
><guilabel
>Prefix</guilabel
>: Especifiqueu un símbol o el text a mostrar davant de la quantitat de temps fins activar l'alarma, per distingir-la de l'hora a la qual està programada l'alarma.</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 de &kalarm;, per mostrar les alarmes deshabilitades i arxivades.</para>
</listitem>
</itemizedlist>

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

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

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

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

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

<para
>La secció <guilabel
>Edita</guilabel
> us permet seleccionar els valors per omissió 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
>Establir els estats per omissió per a les caselles de selecció <guilabel
>Mostra al KOrganizer</guilabel
> i <guilabel
>Cancel·la si ja és tard</guilabel
>.</para>
</listitem>

<listitem
><para
>Establir el tipus de repetició per omissió.</para>
</listitem>

<listitem
><para
>Seleccioneu el tractament per omissió en anys no de traspàs de 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 per omissió per a les caselles de selecció <guilabel
>Tanca la finestra automàticament després d'aquest temps</guilabel
> i <guilabel
>Confirma l'acceptació</guilabel
>.</para>
</listitem>

<listitem
><para
>Establiu les unitats de període per omissió pel recordatori.</para>
</listitem>

<listitem
><para
>Establiu les accions especials per omissió per a les alarmes visuals.</para>
</listitem>

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

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

<itemizedlist>
<listitem
><para
>Establiu els estats per omissió per a les caselles de selecció <guilabel
>Entra 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 per omissió per a la casella de selecció <guilabel
>Còpia del correu a si mateix</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>La pestanya <guilabel
>Tipus de lletra i color</guilabel
> us permet establir l'aparença per omissió dels missatges d'alarma. Seleccioneu el vostre tipus de lletra per omissió, i els colors de primer pla i de fons.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

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

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

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

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

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

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

<para
>Les següents opcions s'utilitzen per a programar una nova alarma:</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. S'ha d'especificar <option
>--mail</option
> amb aquesta opció.</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
>. S'ha d'especificar <option
>--late-cancel</option
> amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Emet un timbre audible quan es mostra el missatge. No es poden especificar <option
>--speak</option
>, <option
>--play</option
> i <option
>--play-repeat</option
> amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Us envia una còpia oculta del correu electrònic. S'ha d'especificar <option
>--mail</option
> amb aquesta opció.</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 &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 &Qt; o al codi hexadecimal 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Deshabilita l'alarma. No s'activarà fins que s'hagi habilitat manualment.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Deshabilita la monitorització d'alarmes. Això evita que les alarmes s'activin fins que torneu a habilitar les alarmes o reinicieu &kalarm;, &pex;, en el següent inici de sessió. No es pot especificar <option
>--triggerEvent</option
> amb aquesta opció.</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 per executar. Si s'especifica, aquesta opció haurà de ser l'última opció de &kalarm; a la línia d'ordres de &kalarm;. Tots els paràmetres de les ordres i opcions posteriors s'interpretaran com la formació de la línia d'ordres per executar. No es poden especificar <option
>--file</option
>, <option
>--exec-display</option
> i <option
>--mail</option
> amb aquesta opció. 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 generar el text del missatge d'alarma. Si s'especifica, aquesta opció haurà de ser l'última opció de &kalarm; en la línia d'ordres de &kalarm;. Tots els paràmetres i opcions posteriors s'interpretaran com la formació de la línia d'ordres per executar. No es poden especificar <option
>--exec</option
>, <option
>--file</option
> i <option
>--mail</option
> amb aquesta opció.</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 formar el missatge d'alarma. No es poden especificar <option
>--exec</option
>, <option
>--exec-display</option
> i <option
>--mail</option
>, i <replaceable
>missatge</replaceable
> no ha d'estar present amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>ID</replaceable
></option
></entry>
  <entry
>Utilitza la identitat de &kmail; especificada com a remitent del correu electrònic. S'ha d'especificar <option
>--mail</option
> amb aquesta opció.</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 següents lletres: 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 en el calendari de &korganizer; actiu.</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 següents lletres: S (setmanes), D (dies). El valor per omissió 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. No es poden especificar <option
>--interval</option
>, <option
>--repeat</option
> i <option
>--until</option
> amb aquesta opció.</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. No es poden especificar <option
>--exec</option
>, <option
>--exec-display</option
> i <option
>--file</option
> amb aquesta opció. 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
>-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, ja sigui com una alarma d'àudio o quan es mostri el missatge d'alarma. No es poden especificar <option
>--play-repeat</option
>, <option
>--beep</option
> i <option
>--speak</option
> amb aquesta opció.</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. No es poden especificar <option
>--play</option
>, <option
>--beep</option
> i <option
>--speak</option
> amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Estableix l'alarma a repetir. Especifiqueu la repetició utilitzant la sintaxi de iCalendar (definida en el <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), &pex;, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. No es pot especificar <option
>--until</option
> amb aquesta opció.</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 repetir l'alarma de forma indefinida. Hi haurà d'haver <option
>--interval</option
>, i <option
>--until</option
> no es podrà especificar amb aquesta opció.</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
>. Per omissió, el recordatori es produirà abans de l'alarma. Per 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 &jovie; estigui instal·lat i configurat, juntament amb un sintetitzador de veu compatible. No es pot especificar <option
>--beep</option
>, <option
>--play</option
> i <option
>--play-repeat</option
> amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>assumpte</replaceable
></option
></entry>
  <entry
>La línia d'assumpte del correu. S'ha d'especificar <option
>--mail</option
> amb aquesta opció. </entry>
</row>
<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à, per omissió els camps de data als valors per avui). Si no s'especifica la zona horària, s'assumirà la del sistema local. Si és present un especificador de zona horària <replaceable
>TZ</replaceable
>, aquest podrà ser el nom d'una zona horària del sistema (&pex; <userinput
>Europe/London</userinput
>), <userinput
>UTC</userinput
> representa la zona horària UTC, o <userinput
>Clock</userinput
> utilitza el rellotge de l'ordinador local i ignora les zones horàries.</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
>. Tingueu 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 següents opcions s'utilitzen per a realitzar vàries funcions, inclòs el 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 d'edició de l'alarma per editar l'alarma amb l'identificador d'esdeveniment especificat.</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 nova alarma d'àudio.</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 nova alarma d'ordre.</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 nova alarma visual.</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 nova alarma de correu.</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 nova alarma.</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 (si utilitza Akonadi), l'UID següent hora programada i el text del missatge o fitxer.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Mostra &kalarm; com una icona a la safata del sistema.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Desactiva el control de totes les alarmes.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>

<sect1 id="cmdline-help">
<title
>Opcions de l'ajuda</title>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opció</entry>
  <entry
>Descripció</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Mostra un text breu amb opcions d'ajuda.</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Mostra les opcions específiques de &Qt;.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Mostra les opcions específiques de &kde;.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Mostra totes les opcions.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Mostra els noms i adreces de correu dels autors de &kalarm;.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--version</option
></entry>
  <entry
>Mostra les versions en funcionament de la biblioteca &Qt;, &kde; i &kalarm;.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Mostra informació sobre la llicència.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect1>
</chapter>

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

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

<itemizedlist>
<listitem
><para
>programar una nova alarma</para
></listitem>
<listitem
><para
>cancel·la una alarma ja programada</para
></listitem>
<listitem
><para
>activa una alarma ja programada</para
></listitem>
<listitem
><para
>mostra el diàleg d'edició de l'alarma</para
></listitem>
<listitem
><para
>llista de 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 &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
> de &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'identificador únic de l'esdeveniment a cancel·lar.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

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

<para
><function
>cancelEvent()</function
> és una crida de &DBus; per cancel·lar l'alarma especificada. &kalarm; esborra 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'identificador únic de l'esdeveniment a activar.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

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

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

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

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>programa un nou missatge d'alarma.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>missatge</replaceable
>,
                     const QString&amp; <replaceable
>hora_data_inici</replaceable
>,
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <parameter
>etiquetes</parameter
>, 
                     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
>missatge</replaceable
>, 
                     const QString&amp; <replaceable
>hora_data_inici</replaceable
>, 
                     int <replaceable
>CancellaTard</replaceable
>,
                     unsigned <parameter
>etiquetes</parameter
>, 
                     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
>missatge</replaceable
>, 
                     const QString&amp; <replaceable
>hora_data_inici</replaceable
>, 
                     int <replaceable
>CancellaTard</replaceable
>, 
                     unsigned <parameter
>etiquetes</parameter
>, 
                     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
>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 generar el text del missatge.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>hora_data_inici</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] [Clock]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu 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
>), <userinput
>UTC</userinput
> representa la zona horària UTC, o <userinput
>Clock</userinput
> utilitza el rellotge de l'ordinador local i ignora les zones horàries.</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 el 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
>. Tingueu 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 <quote
>#RRGGBB</quote
> (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; <quote
>red</quote
> o <quote
>steelblue</quote
>). Establiu la cadena a «null» per especificar el color per omissió de 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 especificar el color per omissió de primer pla actual.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>tipus_de_lletra</parameter
></term>
<listitem>
<para
>Especifica el tipus de 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 utilitzar el tipus de lletra de missatge per omissió actual quan es mostri el missatge.</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 per a que 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 de iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Per exemple, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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
>hora_data_inici</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
>hora_data_inici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>hora_data_inici</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
>hora_data_inici</replaceable
> per 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 sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de sub-repeticions de l'alarma, incloent 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 &ndash;utilitzeu-ho per a no repetir les alarmes&ndash;. 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 qualsevol repetició) ja ha passat, &kalarm; mostrarà immediatament el missatge (a menys que el valor de <parameter
>CancellaTard</parameter
> indiqui que ja és massa tard per mostrar l'alarma, en aquest cas &kalarm; ignorarà la petició). Si l'hora programada (o una repetició) està en el futur, &kalarm; afegirà el missatge d'alarma al calendari d'alarmes actiu per omissió per a mostrar-lo després.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>programa una nova alarma que mostra el contingut d'un fitxer de text o d'imatge.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>,
                  const QString&amp; <replaceable
>hora_data_inici</replaceable
>,
                  int <replaceable
>CancellaTard</replaceable
>,
                  unsigned <parameter
>etiquetes</parameter
>,
                  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
>URL</replaceable
>,
                  const QString&amp; <replaceable
>hora_data_inici</replaceable
>,
                  int <replaceable
>CancellaTard</replaceable
>,
                  unsigned <parameter
>etiquetes</parameter
>,
                  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
>URL</replaceable
>,
                  const QString&amp; <replaceable
>hora_data_inici</replaceable
>,
                  int <replaceable
>CancellaTard</replaceable
>,
                  unsigned <parameter
>etiquetes</parameter
>,
                  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
>hora_data_final</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<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
>hora_data_inici</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] [Clock]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu 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
>), <userinput
>UTC</userinput
> representa la zona horària UTC, o <userinput
>Clock</userinput
> utilitza el rellotge de l'ordinador local i ignora les zones horàries.</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 el 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
>. Tingueu 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 <quote
>#RRGGBB</quote
> (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; <quote
>red</quote
> o <quote
>steelblue</quote
>). Establiu la cadena a «null» per especificar el color per omissió de 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 per a que 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 de iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Per exemple, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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
>hora_data_inici</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
>hora_data_inici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>hora_data_inici</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
>hora_data_inici</replaceable
> per 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 sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de sub-repeticions de l'alarma, incloent 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. Apart d'especificar un camí o &URL; de fitxer i ometent el color de fons i el tipus de lletra, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -veure la descripció de la funció per a més detalls-.</para>
</refsect1>
</refentry>


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

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<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
>hora_data_inici</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] [Clock]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu 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
>), <userinput
>UTC</userinput
> representa la zona horària UTC, o <userinput
>Clock</userinput
> utilitza el rellotge de l'ordinador local i ignora les zones horàries.</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 el 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
>. Tingueu 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 de iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Per exemple, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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
>hora_data_inici</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
>hora_data_inici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>hora_data_inici</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
>hora_data_inici</replaceable
> per 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 sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de sub-repeticions de l'alarma, incloent 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 executar a la data i hora especificats. Apart d'especificar una ordre i ometent els paràmetres del color de fons, el tipus de lletra i el fitxer d'àudio, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -veure la descripció de la funció per a més detalls-.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>programa una nova alarma que envia un correu electrònic.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(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
>hora_data_inici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <parameter
>etiquetes</parameter
>,
                   const QString&amp; <replaceable
>recurrència</replaceable
>,
                   int <replaceable
>IntervalSubRepetecions</replaceable
>, 
                   int <replaceable
>CompteSubRepetecions</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(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
>hora_data_inici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>,
                   unsigned <parameter
>etiquetes</parameter
>,
                   int <replaceable
>TipusRecurrència</replaceable
>,
                   int <replaceable
>IntervalRecurrència</replaceable
>,
                   int <replaceable
>CompteRecurrència</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(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
>hora_data_inici</replaceable
>,
                   int <replaceable
>CancellaTard</replaceable
>, 
                   unsigned <parameter
>etiquetes</parameter
>,
                   int <replaceable
>TipusRecurrència</replaceable
>,
                   int <replaceable
>IntervalRecurrència</replaceable
>,
                   const QString&amp; <replaceable
>endTime</replaceable
>)
</synopsis>

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<varlistentry>
<term
><parameter
>ID_De</parameter
></term>
<listitem>
<para
>La identitat de &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
> de &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 per enviar com a adjunts del correu.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>hora_data_inici</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] [Clock]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu 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
>), <userinput
>UTC</userinput
> representa la zona horària UTC, o <userinput
>Clock</userinput
> utilitza el rellotge de l'ordinador local i ignora les zones horàries.</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 el 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
>. Tingueu 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 de iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Per exemple, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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
>hora_data_inici</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
>hora_data_inici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>hora_data_inici</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
>hora_data_inici</replaceable
> per 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 sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de sub-repeticions de l'alarma, incloent 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 enviar a la data i hora especificats. Apart d'especificar una capçalera i contingut i ometent els paràmetres de color del missatge, el tipus de lletra i el fitxer d'àudio, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -veure la descripció de la funció per a més detalls-.</para>
</refsect1>
</refentry>


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

<refsect2>
<title
>Paràmetres</title>
<variablelist>
<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 utilitzar el volum per omissió.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>hora_data_inici</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] [Clock]</replaceable
> (com és retornat per <methodname
>QTime::toString(Qt::ISODate)</methodname
> ). Si no s'especifica una data, s'utilitzarà la data d'avui. Tingueu 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
>), <userinput
>UTC</userinput
> representa la zona horària UTC, o <userinput
>Clock</userinput
> utilitza el rellotge de l'ordinador local i ignora les zones horàries.</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 el 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
>. Tingueu 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 de iCalendar tal com es defineix en la <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Per exemple, <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> 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
>hora_data_inici</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
>hora_data_inici</replaceable
> inclou una hora, aquest paràmetre també inclourà una hora, si <replaceable
>hora_data_inici</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
>hora_data_inici</replaceable
> per 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 sub-repeticions de l'alarma. Especifiqueu 0 per a sense sub-repeticions. S'ignora si no s'especifica la recurrència.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>CompteSubRepetecions</parameter
></term>
<listitem>
<para
>Especifica el nombre de sub-repeticions de l'alarma, incloent 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. Apart d'especificar un volum i ometent els paràmetres de color del missatge i el tipus de lletra, el seu ús és idèntic al de <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> -veure la descripció de la funció per a més detalls-.</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 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'identificador únic de l'esdeveniment que voleu editar.</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 mostrar el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> per 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 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 la nova alarma activa.</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 mostrar el <link linkend="alarm-edit-dlg"
>diàleg d'edició de l'alarma</link
> per editar una alarma nova. Si s'especifica un tipus d'alarma com un paràmetre, es mostrarà un diàleg en blanc. D'altra banda, si s'especifica un nom de plantilla d'alarma com un paràmetre, el diàleg estarà configurat amb els detalls de la plantilla.</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
>resource_id</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>time</replaceable
> <replaceable
>text</replaceable
></returnvalue
> (si utilitza Akonadi), o <returnvalue
><replaceable
>UID</replaceable
> <replaceable
>hora</replaceable
> <replaceable
>text</replaceable
></returnvalue
> (si utilitza KResources).</para>
</refsect2>
</refsynopsisdiv>

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

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

</refsect1>
</refentry>

</sect1>

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

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

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

<para
>Les opcions de línia d'ordres per a programar una nova alarma es descriuen en el capítol de <link linkend="cmdline-operation"
>Operació de la línia d'ordres</link
>. Les opcions per 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'identificador d'esdeveniment especificat. No es pot especificar <option
>--triggerEvent</option
> amb aquesta opció.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>ID_esdeveniment</replaceable
></option
></entry>
  <entry
>Activa l'alarma amb l'identificador d'esdeveniment especificat. L'acció agafada és la mateixa que per a la crida de &DBus; <link linkend="triggerEvent"
>triggerEvent()</link
>. No es pot especificar <option
>--cancelEvent</option
> amb aquesta opció.</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>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Quin tipus de fitxers de configuració utilitza &kalarm;?</para>
</question>
<answer>
<para
><filename
>$KDEHOME/share/config/kalarmrc</filename
> manté les vostres preferències de &kalarm;.</para>
<para
><filename
>$KDEHOME/share/config/kresources/alarms/stdrc</filename
> manté la configuració del calendari d'alarma.</para>

<para
>($<envar
>KDEHOME</envar
> sol ser <filename class="directory"
>&tilde;/.kde</filename
> o similar).</para>
</answer>
</qandaentry>

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

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

<itemizedlist>
<listitem>
<para
><filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
> manté les alarmes actives (substituïble per l'entrada <parameter
>Calendar</parameter
>).</para>
</listitem>

<listitem>
<para
>$<filename
>$KDEHOME/share/apps/kalarm/expired.ics</filename
> manté les alarmes arxivades (substituïble per l'entrada <parameter
>ExpiredCalendar</parameter
>).</para>
</listitem>

<listitem>
<para
>$<filename
>$KDEHOME/share/apps/kalarm/template.ics</filename
> manté les plantilles d'alarma (substituïble per l'entrada <parameter
>TemplateCalendar</parameter
>).</para>
</listitem>
</itemizedlist>

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

<para
>Els detalls de les alarmes s'estan veient es desen al fitxer de calendari <filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>En quin format s'emmagatzemen les alarmes?</para>
</question>
<answer>
<para
>Els fitxers de calendari en els que &kalarm; emmagatzema les seves alarmes són fitxers de text en el format es defineix en el document <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 de kdepim. &kalarm; utilitza certes propietats no estàndard, de conformitat amb RFC2445. Aquestes es troben documentats en el fitxer <filename
>DESIGN.html</filename
> que es distribueix amb &kalarm;.</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 de &kalarm; en iniciar la sessió.</para>

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

<para
>Per evitar aquest problema, <application
>kalarmautostart</application
> és iniciat automàticament en iniciar la sessió en lloc de &kalarm;. Tot el que fa és esperar un curt temps (per assegurar-se que el gestor de sessions té temps per funcionar) abans d'iniciar &kalarm;, moment en el que finalitzarà.</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 &David.Jarvie; &David.Jarvie.mail; </para>

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

<para
>Traductor 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 per a &kde; 2 en endavant. </para>

</chapter>

<appendix id="installation">
<title
>Instal·lació</title>

<sect1 id="getting-kalarm">
<title
>Com obtenir &kalarm;</title>
&install.intro.documentation; <para
>&kalarm; també està disponible com un paquet independent per a &kde; 4, així com per a les versions anteriors &kde; 3 i &kde;, des de <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
> </para>

</sect1>

<sect1 id="requirements">
<title
>Requeriments</title>

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

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

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

<para
>Podeu trobar una llista de canvis en el fitxer <filename
>Changelog </filename
>, o a <ulink url="http://www.astrojar.org.uk/kalarm"
>http://www.astrojar.org.uk/kalarm</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Compilació i instal·lació</title>

<para
>Si no podeu obtenir un paquet binari precompilat adequat, necessitareu compilar &kalarm; des del codi font. Obteniu el fitxer del paquet font <filename
>kdepim-x.x.tar.bz2</filename
> o <filename
>kalarm-x.x.tar.bz2</filename
> (o similar), depenent de si voleu instal·lar &package; o simplement &kalarm;. Descomprimiu-lo en una nova carpeta amb una ordre similar a <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>paquet.tar.bz2</replaceable
></option
></userinput
>, i canvieu a la carpeta que heu creat.</para>
&install.compile.documentation; <warning
><para
>Si instal·leu &kalarm; en una carpeta diferent d'on està instal·lat el &kde;, no funcionarà correctament a menys que feu saber al &kde; la seva ubicació. Per a fer-ho, anteposeu la variable d'entorn <envar
>KDEDIRS</envar
> amb la ubicació de &kalarm;, cada vegada que abans d'iniciar el &kde;.</para>

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

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

<para
><userinput
><command
>./configure</command
> --enable-doc-language=<replaceable
>"fr en_GB"</replaceable
></userinput
></para>

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

</sect1>

<sect1 id="configuration">
<title
>Configuració</title>

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

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

</sect1>

</appendix>

&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:
-->

