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

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

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

<bookinfo id="kalarminfo">
<title
>Handbok &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
>Utvecklare</contrib>
</othercredit>

<othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@bredband.net</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2023-09-02</date>
<releaseinfo
>3.7.0 (KDE Gear 23.12)</releaseinfo>

<abstract>
<para
>&kalarm; är en personlig schemaläggare av alarm/påminnelsemeddelanden och kommandon för &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarm</keyword>
<keyword
>påminnelse</keyword>
<keyword
>schemaläggning</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Inledning</title>

<para
>&kalarm; låter dig schemalägga visning av personliga alarmmeddelanden, uppspelning av ljudfiler, körning av kommandon och sändning av e-post.</para>

<para
>&kalarm; visar en lista med pågående alarm, med tider och information. Du kan skapa nya alarm, eller du kan välja befintliga alarm för att ändra eller ta bort dem. Du kan också välja att se utgångna alarm.</para>

<para
>När du anpassar ett alarm, kan du välja om det ska upprepas, och om alarmet ska avbrytas om det inte kan aktiveras vid den schemalagda tiden. För visade alarm kan du skriva in en meddelandetext, ange en text- eller bildfil att visa, eller ange ett kommando vars utmatning ska visas. Du kan också välja färgen för alarmmeddelandet, om ett ljud ska spelas eller om meddelandet ska läsas upp,</para>

<para
>Alarm kan också schemaläggas på kommandoraden, eller via &DBus; anrop från andra program.</para>

<para
>När ett alarmmeddelande ska visas, syns det på alla skrivbord för att vara säker på att du inte missar det. Meddelandefönstret visar tiden då alarmet var schemalagt. Det har oftast ett alternativ som anger att det ska skjutas upp, och visas igen senare. Ett exempel på ett alarmmeddelande:</para>

<screenshot>
<screeninfo
>Skärmbild av &kalarm;s meddelandefönster</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Alarmmeddelande</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Ett alarmmeddelande kan valfritt visas som en underrättelse istället för i ett fönster.</para>

<para
>När alarmet anger ett kommando som ska köras, visar &kalarm; ingenting.</para>

<para
>&kalarm; visar oftast en ikon i systembrickan, även om den kan döljas om det önskas.</para>

</chapter>

<chapter id="using-kalarm">
<title
>Att använda &kalarm;</title>

<para
>När det körs utan kommandoradsväljare, startar &kalarm; i grafiskt läge, och visar den nuvarande listan med pågående alarm.</para>

<tip
><para
>Alla sifferrutor i &kalarm; har en accelerationsfunktion. För att ändra värdet med större steg, håll nere &Shift;-tangenten medan du klickar på pilknapparna.</para>

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

<sect1 id="alarm-types">
<title
>Alarmtyper</title>

<para
>Grundfunktionerna tillgängliga från de olika alarmtyper som &kalarm; tillhandahåller är:</para>

<itemizedlist>
<listitem>
<para
>Visade alarm visar antingen ett textmeddelande som du skriver in, innehållet i en text- eller bildfil eller textutmatning från ett kommando som körs när alarmet visas. Förutom att visa en av dessa texter, kan de också spela upp ljudfiler, läsa upp texten eller avge en enkel ljudsignal. Du kan också ange kommandon som ska köras innan och efter alarmmeddelandet visas.</para>
</listitem>

<listitem>
<para
>Kommandoalarm kör antingen ett kommando eller ett skalskript som du kan skriva in. Ingenting visas om inte ett fel uppstår.</para>
</listitem>

<listitem>
<para
>E-postalarm skickar ett brev. Ingenting visas om inte ett fel uppstår.</para>
</listitem>

<listitem>
<para
>Ljudalarm spelar en ljudfil. Ingenting visas om inte ett fel uppstår.</para>
</listitem>
</itemizedlist>

<sect2 id="errors">
<title
>Felhantering</title>

<para
>Om ett fel uppstår när ett alarm utlöses, visas ett felmeddelande (om du inte tidigare har angivit att den typen av meddelande inte ska visas igen).</para>

<para
>Om ett körningsfel uppstod den senaste gången ett kommandoalarm utlöstes, visas ett vitt utropstecken på röd botten i meddelandets färgkolumn. Detaljinformation om felet visas i ett verktygstips om du placerar markören över den raden i alarmlistan. Samma felindikeringar anges för visade alarm om ett körningsfel uppstod för ett kommando innan eller efter alarmet angivna i dialogrutan Särskilda åtgärder, förutom att färgkolumnen inte ändras till röd bakgrund.</para>

</sect2>
</sect1>

<sect1 id="alarm-list">
<title
>Alarmlista</title>

<para
>Huvudfönstret i &kalarm; visar den nuvarande listan med pågående alarm, med tider, antal upprepningar, färger, namn och meddelandetexter, namn på filer som ska spelas eller visas, kommandon som ska köras eller e-postrubriker. (För ett alarm som upprepas, är tiden som anges nästa gång alarmet ska visas. För ett alarm med en påminnelse, är tiden som visas själva alarmets tid, inte påminnelsens tid.) En ikon till vänster om varje alarms text/fil/kommando/e-postrubrik anger alarmets typ.</para>

<para
>Observera att kolumnen <guilabel
>Namn</guilabel
> bara finns om användning av alarmnamn är aktiverat under fliken <link linkend="preferences-general"
>Allmänt</link
> i inställningsdialogrutan.</para>

<screenshot>
<screeninfo
>Skärmbild av &kalarm;s huvudfönster</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Huvudfönster</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>För ett upprepat alarm, visar listan nästa gång det är schemalagt att visas och det grundläggande upprepningsintervallet (t.ex. <quote
>1 dag</quote
> för daglig upprepning, <quote
>3 veckor</quote
> för en upprepning som utlöses på måndag och onsdag var tredje vecka, <quote
>Inloggning</quote
> för ett alarm som upprepas vid inloggning).</para>

<para
>Om ett körningsfel uppstod den senaste gången ett kommandoalarm utlöstes, eller den senaste gången ett visat alarms kommando innan eller efter alarmet kördes, visas en felindikering i färgkolumnen, som beskrivs i <link linkend="errors"
>Felhantering</link
> ovan.</para>

<sect2 id="listappear">
<title
>Ändra alarmlistans utseende</title>

<para
>Alarmen kan sorteras efter datum/tid, upprepningsintervall, färg, typ, namn eller text genom att klicka på rubriken för lämplig kolumn. För att vända sorteringsordning, klicka på kolumnens rubrik en gång till.</para>

<para
>Du kan valfritt visa återstående tid tills varje alarm aktiveras, tillsammans med eller istället för alarmets schemalagda tid.</para>

<para
>Du kan välja vilka kolumner som ska visas eller döljas genom att <mousebutton
>höger</mousebutton
>klicka på kolumnrubrikerna och använda den sammanhangsberoende menyn för att ställa in kolumner att visa. Men observera att åtminstone en av kolumnerna <guilabel
>Namn</guilabel
> eller <guilabel
>Meddelande, fil eller kommando</guilabel
>, och åtminstone en av kolumnerna <guilabel
>Tid</guilabel
> eller <guilabel
>Tid till</guilabel
>, alltid visas.</para>

<para
>Om du använder flera alarmkalendrar kan du färgkoda alarm enligt vilken kalender de hör till, genom att välja olika bakgrundsfärg för varje kalender (se <link linkend="using-calendars"
>Använda kalendrar</link
>).</para>

</sect2>

<sect2 id="expired">
<title
>Arkiverade alarm</title>

<para
>Normalt lagrar &kalarm; alarm under en begränsad tid efter de har gått ut eller tagits bort. (Men observera att de alarm som du tar bort bara lagras om de redan har visats minst en gång.) Du kan styra om &kalarm; lagrar utgångna alarm, och hur länge, i <link linkend="preferences-storage"
>inställningsdialogrutan</link
>.</para>

<para
>Arkiverade alarm kan visas i alarmlistan genom att markera <menuchoice
><guimenu
>Visa</guimenu
><guimenuitem
>Visa arkiverade alarm</guimenuitem
></menuchoice
>. För att dölja dem igen, avmarkera <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Visa arkiverade alarm</guimenuitem
></menuchoice
>.</para>

</sect2>

<sect2 id="datepicker">
<title
>Filtrera alarmlistan enligt datum</title>

<para
>Du kan begränsa alarmlistan att bara visa alarm som är schemalagda att inträffa ett visst datum. Det åstadkoms genom alarmdatumväljaren, som kan visas eller döljas med <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Visa datumväljare</guimenuitem
></menuchoice
>. Välj ett datum genom att klicka på datumväljaren, eller välj bort det genom att klicka på den igen. Datumväljaren visar en enda månad. Använd pilknapparna i datumväljaren eller mushjulet för att visa en annan månad.</para>

</sect2>

<sect2 id="search">
<title
>Söka i alarmlistan</title>

<para
>Du kan söka igenom alarmlistan för att  hitta alarm som innehåller en söktext. För att göra det, välj <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Sök...</guimenuitem
></menuchoice
>. I sökdialogrutan, välj alarmtyper som du vill söka efter. För att fortsätta söka efter fler alarm som passar in, använd <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Sök igen</guimenuitem
></menuchoice
> eller <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Sök föregående</guimenuitem
></menuchoice
>.</para>

<para
>Sökning utförs på följande sätt:</para>

<itemizedlist>
<listitem>
<para
>Alarm med textmeddelande: meddelandets text söks igenom.</para>
</listitem>

<listitem>
<para
>Alarm med filvisning: filens namn eller webbadress söks igenom.</para>
</listitem>

<listitem>
<para
>Kommandoalarm: kommandoraden eller kommandoskriptet söks igenom.</para>
</listitem>

<listitem>
<para
>E-postalarm: förutom rubriken och texten i brevet, söks också mottagarna och webbadresser för bilagor igenom.</para>
</listitem>

<listitem>
<para
>Ljudalarm: filens namn eller webbadress söks igenom.</para>
</listitem>
</itemizedlist>

<note
><para
>Bara alarm som för närvarande visas i alarmlistan kan visas vid sökning. Om du alltså vill söka i utgångna alarm, måste du först visa dem som beskrivs i föregående avsnitt.</para
></note>
</sect2>
</sect1>

<sect1 id="create-edit">
<title
>Skapa och hantera alarm</title>

<sect2>
<title
>Skapa ett nytt alarm</title>

<para
>För att skapa ett nytt alarm, gör något av följande, och välj därefter alarmtyp i listan som visas. Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> som används för att ställa in alarmet.</para>

<itemizedlist>
<listitem>
<para
>Välj <menuchoice
> <guimenu
>Arkiv</guimenu
><guimenuitem
>Nytt</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Nytt alarm</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på posten i alarmlistan och välj <menuchoice
><guimenuitem
>Ny</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

<para
>Som ett alternativ kan du skapa nya alarm förinställda från olika källor:</para>

<itemizedlist>
<listitem>
<para
>För att förinställa alarmets datum i <link linkend="alarm-edit-dlg"
>Alarmredigeringsdialogrutan</link
>, högerklicka på önskat datum i alarmdatumväljaren (se <link linkend="datepicker"
>Filtrera datumlistan enligt datum</link
>) och välj lämplig alarmtyp i den sammanhangsberoende menyn.</para>
</listitem>

<listitem>
<para
>För att basera det nya alarmet på en alarmmall, följ instruktionerna i avsnittet <link linkend="templates"
>Alarmmallar</link
>.</para>
</listitem>

<listitem>
<para
>För att basera det nya alarmet på ett befintligt, markera det befintliga alarmet i listan och välj <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Kopiera</guimenuitem
></menuchoice
>. Då visas <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> redan ifylld med en kopia av det markerade alarmets information.</para>
</listitem>

<listitem>
<para
>För att skapa ett nytt alarm som visar befintlig e-post, dra brevet från &kmail; till &kalarm;s huvudfönster. Välj därefter alternativet <guilabel
>Visningsalarm</guilabel
>. Det visar <link linkend="alarm-edit-dlg"
>Dialogrutan för alarmredigering</link
> med hela brevet (inklusive avsändare, mottagare, etc.) som alarmtexten.</para>
</listitem>

<listitem>
<para
>För att skapa ett nytt e-postalarm för att skicka en kopia av ett befintligt brev, dra brevet från &kmail; till &kalarm;s huvudfönster. Välj därefter alternativet <guilabel
>E-postalarm</guilabel
>. <link linkend="alarm-edit-dlg"
>Dialogrutan för alarmredigering</link
> är förinställd med hela brevet utom avsändare.</para>
</listitem>

<listitem>
<para
>För att skapa ett nytt alarm som visar en summering av en befintlig uppgift, dra uppgiften från &korganizer; till &kalarm;s huvudfönster. Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> med uppgiftens innehåll som alarmtexten.</para>
</listitem>

<listitem>
<para
>För att skapa ett nytt kommandoalarm, dra skriptets text med början på <quote
>#!</quote
> till &kalarm;s huvudfönster. Välj därefter alternativet <guilabel
>Kommandoalarm</guilabel
>. Det visar <link linkend="alarm-edit-dlg"
>Dialogrutan för alarmredigering</link
> förinställd med skriptets text.</para>
</listitem>

<listitem>
<para
>För att skapa ett alarm som visar en fil, dra webbadress för en text- eller bildfil till &kalarm;s huvudfönster. Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> med filnamnet angivet.</para>
</listitem>

<listitem>
<para
>För att skapa ett ljudalarm, dra ljudfilens webbadress till &kalarm;s huvudfönster. Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> med filnamnet angivet.</para>
</listitem>

<listitem>
<para
>För att skapa ett nytt alarm med ett textmeddelande, dra vilket textstycke som helst till &kalarm;s huvudfönster. Om tillfrågad, välj alternativet <guilabel
>Visningsalarm</guilabel
>. Det visar <link linkend="alarm-edit-dlg"
>Dialogrutan för alarmredigering</link
> förinställd med alarmtexten.</para>
</listitem>

<listitem>
<para
>Du kan automatiskt skapa födelsedagsalarm för personer i adressboken enligt beskrivningen i <link linkend="birthdays"
>Importera födelsedagar från adressboken</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Ändra ett befintligt alarm</title>

<para
>För att ändra ett befintligt alarm (utgångna alarm kan inte påverkas), gör något av följande:</para>

<itemizedlist>
<listitem>
<para
>Dubbelklicka på posten i alarmlistan.</para>
</listitem>

<listitem>
<para
>Välj det genom att klicka på posten i alarmlistan. Välj sedan <menuchoice
> <guimenu
>Redigera</guimenu
> <guimenuitem
>Redigera</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på posten i alarmlistan och välj <menuchoice
><guimenuitem
>Redigera</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

<para
>Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>.</para>

</sect2>

<sect2>
<title
>Ta bort eller aktivera ett alarm igen</title>

<para
>För att ta bort befintliga alarm, markera ett eller flera genom att klicka på deras poster i alarmlistan. Gör därefter något av följande:</para>

<itemizedlist>
<listitem>
<para
>Välj <menuchoice
> <guimenu
>Redigera</guimenu
><guimenuitem
>Ta bort</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på markerade poster och välj <menuchoice
><guimenuitem
>Ta bort</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
<listitem>
<para
>För att ta bort dem utan fråga om bekräftelse, skriv &Shift;+<keycap
>Delete</keycap
>.</para>
</listitem>
</itemizedlist>

<para
>När du tar bort ett aktivt alarm arkiveras det, under förutsättning att det har visats minst en gång innan det tas bort, och under förutsättning att utgångna alarm överhuvudtaget arkiveras. (Använd <link linkend="preferences-storage"
>Inställningsdialogrutan</link
> för att styra om och hur länge arkiverade alarm lagras.) När du tar bort ett arkiverat alarm, eller ett aktivt alarm som ännu inte har visats, tas det bort permanent.</para>

<para
>Du kan aktivera ett borttaget alarm igen från listan med arkiverade alarm, under förutsättning att det ännu inte gått ut. För att göra det, visa först arkiverade alarm, som beskrivs under <link linkend="expired"
>Arkiverade alarm</link
>, och gör därefter följande:</para>

<itemizedlist>
<listitem>
<para
>Välj ett eller flera lämpliga arkiverade alarm genom att klicka på deras poster i alarmlistan. Välj sedan <menuchoice
> <guimenu
>Åtgärder</guimenu
> <guimenuitem
>Aktivera igen</guimenuitem
></menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på önskade poster i alarmlistan med utgångna alarm och välj <menuchoice
><guimenuitem
>Aktivera igen</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Aktivera och stänga av ett alarm</title>

<para
>Se <link linkend="enable-disable"
>Aktivera och stänga av alarm</link
> om hur alarm aktiveras och stängs av, antingen individuellt eller alla tillsammans.</para>

</sect2>

<sect2>
<title
>Ställa in ett alarm för att vakna från viloläge</title>

<para
>Se <link linkend="wake-suspend"
>Vakna från viloläge</link
> för att ta reda på hur man ställer in ett alarm att väcka systemet från viloläge eller dvala.</para>

</sect2>

<sect2>
<title
>Bekräfta ett alarm</title>

<para
>Se <link linkend="message-display"
>Alarmmeddelandevisning</link
> om hur man bekräftar alarm.</para>

</sect2>

<sect2 id="templates">
<title
>Alarmmallar</title>

<para
>Om du ofta vill ställa in alarm som liknar varandra, kan du skapa en alarmmall för att undvika att behöva mata in all information från början varje gång. En mall kan innehålla all information som ett alarm kan innehålla, utom startdatum.</para>

<para
>Du kan till exempel ofta vilja ställa in ett alarm för att påminna dig om ett tv-program vars starttid varierar från vecka till vecka. Mallen skulle innehålla all alarminformation (meddelandetext, om ett ljud ska spelas, etc.) utom tid och datum. För att skapa alarmet, är allt du nu behöver göra att öppna <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> med mallen och därefter skriva in tid och datum.</para>

<para
>För att skapa ett alarm baserat på en mall, öppna <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> förinställd med mallinformationen:</para>

<itemizedlist>
<listitem>
<para
>Välj menyalternativet <menuchoice
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Nytt</guimenuitem
> <guimenuitem
>Nytt alarm från mall</guimenuitem
></menuchoice
>, och välj därefter önskad mall.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
> klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Nytt alarm</guimenuitem
><guimenuitem
>Nytt alarm från mall</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn. Välj därefter önskad mall.</para>
</listitem>

<listitem>
<para
>Öppna <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> på vanligt sätt, och klicka på knappen <guibutton
>Ladda mall...</guibutton
> för att välja en mall som dialogrutan ska förinställas med.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Anpassa mallar</title>

<para
>Du kan skapa, ändra eller ta bort mallar med dialogrutan för alarmmallar, eller skapa en ny alarmmall baserad på ett befintligt alarm.</para>

<para
>För att skapa en ny alarmmall, gör något av följande:</para>

<itemizedlist>
<listitem>
<para
>Visa dialogrutan för alarmmallar genom att välja menyalternativet <menuchoice
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Mallar...</guimenuitem
></menuchoice
>, klicka på <guibutton
>Ny</guibutton
> och välja alarmtyp i listan som dyker upp. Då visas en tom dialogruta för mallredigering.</para>
</listitem>

<listitem>
<para
>Öppna dialogrutan för alarmmallar genom att välja menyalternativet <menuchoice
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Mallar...</guimenuitem
> </menuchoice
>, markera en befintlig mall i listan och klicka på <guibutton
>Kopiera</guibutton
>. Då visas dialogrutan för mallredigering redan ifylld med en kopia av den befintliga mallens information.</para>
</listitem>

<listitem>
<para
>Markera ett alarm i alarmlistan och välj <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Skapa mall...</guimenuitem
></menuchoice
>. Då visas dialogrutan för mallredigering redan ifylld med en kopia av det markerade alarmets information.</para>
</listitem>
</itemizedlist>

<para
>För att ändra en befintlig mall, visa dialogrutan för alarmmallar genom att välja menyalternativet <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Mallar...</guimenuitem
></menuchoice
> och klicka på <guibutton
>Redigera</guibutton
>. Då visas dialogrutan för mallredigering, som beskrivs nedan.</para>

<para
>För att ta bort en befintlig mall, visa dialogrutan för alarmmallar genom att välja menyalternativet <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Mallar...</guimenuitem
></menuchoice
>, markera en eller flera mallar och klicka på <guibutton
>Ta bort</guibutton
>. En bekräftelse visas för att förhindra borttagning av misstag.</para>

</sect3>

<sect3>
<title
>Dialogruta för mallredigering</title>

<para
>Dialogrutan för mallar liknar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>. Följande delar är annorlunda:</para>

<itemizedlist>
<listitem>
<para
>Skriv in mallens namn under <guilabel
>Mallnamn</guilabel
>. Det är mallens namn som visas i listorna för att välja mallar, så det är bäst att välja ett namn som påminner dig om dess funktion. Varje mallnamn måste vara unikt.</para>
</listitem>

<listitem>
<para
>I rutan <guilabel
>Tid</guilabel
>, välj en av:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Förvald tid</guilabel
> om du inte vill ange någon starttid. Alarm som baseras på mallen kommer använda den normala förvalda starttiden för nya alarm från början.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Tid</guilabel
> för att skriva in en tid då alarmet ska visas.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Bara datum</guilabel
> för att ange att alarmet bara ska ha ett datum, inte en tid.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Tid från nu</guilabel
> för att skriva in hur långt från nuvarande tid (i timmar och minuter) som alarmet ska visas.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>I rutan <guilabel
>Upprepningsregel</guilabel
> under fliken <guilabel
>Upprepning</guilabel
>, behöver ingen dag eller månad väljas för respektive veckovisa eller årliga upprepningar.</para>
</listitem>
</itemizedlist>

</sect3>

</sect2>

<sect2 id="calendars">
<title
>Alarmkalendrar</title>

<para
>Om du bara använder en dator, och arbetar oberoende av andra, kanske det inte spelar någon roll för dig var &kalarm; lagrar sina alarm. Men om du behöver komma åt alarm på mer än en dator, eller på mer än en plats med din lokala dator, kan du definiera <quote
>alarmkalendrar</quote
> för att tala om för &kalarm; att använda andra alarmkalendrar förutom, eller istället för, de förinställda.</para>

<para
>Du kan titta på och ändra kalendrar via kalenderlistan, som kan visas bredvid alarmlistan i &kalarm;s huvudfönster. Alarm från alla alarmkalendrar visas blandade i alarmlistan. När du sparar ett nytt alarm, kan du ange ett inställningsalternativ för att avgöra om det automatiskt sparas i den förvalda kalendern, eller om du blir tillfrågad om att välja en kalender. När du redigerar ett befintligt alarm, sparas det automatiskt i sin ursprungliga alarmkalender.</para>

<screenshot>
<screeninfo
>Skärmbild av &kalarm;s huvudfönster, som visar kalenderlistan</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow-calendars.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Huvudfönster som visar kalenderlistan</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect3>
<title
>Kalendertyper och alternativ</title>

<para
>Alarmkalendrar kategoriseras enligt alarmtyp och lagringstyp. De kan inaktiveras, göras skrivskyddade eller göras till förvald kalender för sin alarmtyp.</para>

<variablelist>
<varlistentry>
<term
>Alarmtyp</term>
<listitem>
<para
>De tre alarmtyperna, aktiva alarm, arkiverade alarm och alarmmallar, lagras i separata alarmkalendrar. &kalarm; har därför tre förvalda kalendrar, en för varje typ, som du kan ändra om du vill (se <link linkend="faq"
>Vanliga frågor</link
> för detaljinformation).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Lagringstyp</term>
<listitem>
<para
>&kalarm; hanterar två lagringstyper för alarmkalendrar:</para>

<itemizedlist>
<listitem
><para
>Lokal fil: Alarm lagras i en enda lokal fil med iCalendar-format. &kalarm; använder normalt lokala filkalendrar (se <link linkend="faq"
>Vanliga frågor</link
> för detaljinformation). <quote
>Lokala filer</quote
> kan, förutom filer på den lokala datorn, också omfatta alarmkalendrar på det lokala nätverket, under förutsättning att deras plats kan representeras av en sökväg som börjar med <literal
>/</literal
>.</para>
</listitem>

<listitem
><para
>Lokal katalog: Alarm lagras i en lokal katalog, där varje alarm lagras i en separat iCalendar-fil i katalogen. Lagringsmetoden har fördelen att bara ett alarm borde gå förlorat i händelse av att en fil skadas, och inte hela kalendern.</para>
</listitem>
<!--FIXME not in kf5?
<listitem
><para
>Remote file: Alarms are stored in a single remote
file in iCalendar format. This storage method allows you to access
your alarm data remotely no matter where you are, or enables alarm
calendars to be viewed by other people. When using remote files,
&kalarm; works with a local cache of the data.</para>

<warning
><para
>If a remote alarm calendar is shared between users,
changes made by one person may not be automatically made available to
another user, or there could be a time delay before the other user
sees it. So one user could make a change which is then overwritten by
another user without either person noticing what has happened. The
technical reason for this is that a change made by person A will only
be available to person B after person A's cached copy has first been
saved to the remote file, and then person B's cached copy
of the remote file has been reloaded. When and if the calendar is
saved and reloaded depends on the calendar configuration parameters
which each user has set for that alarm calendar.</para>

<para
>Ways to avoid this problem include adjusting the calendar save
and reload configuration parameters, or adopting a policy that users
other than the alarm calendar's owner should open it in read-only
mode.</para
></warning>
</listitem>
-->
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Aktiverad och inaktiverad status</term>
<listitem>
<para
>Att inaktivera en kalender har samma effekt som att ta bort den, utom att den fortfarande visas i kalenderlistan för att enkelt kunna aktiveras igen. När den är inaktiv, ignoreras alarmen i den och de visas inte i alarmlistan eller listan med mallar. När den aktiveras igen, visas dess alarm igen, och om det är en aktiv alarmkalender, blir de aktiva igen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Skrivskyddad status</term>
<listitem>
<para
>Alarmen i en skrivskyddad kalender kan inte ändras eller nya alarm läggas till. Du kan alltså inte redigera dess alarm, eller spara nya alarm i den. Det är inte heller möjligt att skjuta upp alarm, eftersom det skulle vara nödvändigt att spara en tid att skjuta upp dem till i alarmen. Efter dess alarm visas tas de inte bort från kalendern och arkiveras till du eller någon annan användare öppnar kalendern som skrivbar.</para>

<para
>Du kan ställa in kalenderns status till skrivskyddad i kalenderns inställningsdialogruta. Dock kan vissa kalendrar inte göras skrivbara, av olika orsaker:</para>

<itemizedlist>
<listitem
><para
>Om en kalender skapades av ett annat program, skulle det inte vara säkert att låta &kalarm; uppdatera den, eftersom skillnader i dataformat skulle kunna göra den oanvändbar för programmet som skapade den.</para>
</listitem>

<listitem
><para
>Om kalendern skapades av en senare version av &kalarm; kan data gå förlorad. Om din version av &kalarm; är för gammal, uppdatera den.</para>
</listitem>

<listitem
><para
>Om kalendern skapades av en tidigare version av &kalarm; kan data gå förlorad eller så kan den bli oanvändbar för den tidigare versionen av &kalarm; om din version av &kalarm; uppdaterar den. Du blir tillfrågad om du vill konvertera dess format så att den blir skrivbar, med eventuella kompatibilitetsproblem om den tidigare versionen av &kalarm; behöver komma åt den igen, i åtanke.</para>
</listitem>

<listitem
><para
>Om du inte har rättigheter att skriva till kalenderfilen eller katalogen.</para>
</listitem>
</itemizedlist>

<para
>Om du behöver skrivrättighet för alarm i en kalender som inte kan göras skrivbar, kan du kopiera alarmen genom att importera dem till en skrivbar kalender, genom att använda den senare kalenderns alternativ <menuchoice
><guimenuitem
>Importera...</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn (se <link linkend="import"
>Importera alarm från externa kalendrar</link
>).</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Förvald kalenderstatus</term>
<listitem>
<para
>En kalender av varje alarmtyp kan valfritt göras till förvald kalender för den alarmtypen. Nya alarm sparas automatiskt i den förvalda kalendern med lämplig alarmtyp, om du inte har valt alternativet att bli tillfrågad för nya alarm och alarmmallar i <link linkend="preferences-storage"
>inställningsdialogrutan</link
>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="using-calendars">
<title
>Använda kalendrar</title>

<para
>Du kan titta på och ändra kalendrar via kalenderlistan, som kan visas eller döljas med <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Visa kalendrar</guimenuitem
></menuchoice
>. Välj först alarmtyp i kombinationsrutan ovanför listan, när kalenderlistan används. Klicka därefter antingen på en av knapparna under listan, eller <mousebutton
>höger</mousebutton
>klicka på lämplig kalender i listan och välj ett alternativ i den sammanhangsberoende menyn. Tillgängliga alternativ är:</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Lägg till...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Lägger till en kalender av vald typ i listan. Du blir tillfrågad om att välja en lagringstyp, och därefter visas kalenderns inställningsdialogruta, där du kan skriva in kalenderns plats och karaktäristik. Om det inte finns någon befintlig alarmkalender på angiven plats, skapas en ny.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Ta bort</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Tar bort den markerade kalendern från listan. Själva kalendern lämnas oförändrad, den tas helt enkelt bort från listan, och kan senare återinföras i listan om så önskas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Redigera...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Redigerar markerad kalender. Det visar inställningsdialogrutan för den markerade kalendern.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Uppdatera</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Uppdatera markerad kalender. Kalendern läses in igen från stället den är lagrad, vilket säkerställer att det inte finns någon skillnad mellan vad &kalarm; visar och kalenderns aktuella tillstånd. Om kalendern delas med andra användare, syns nu alla eventuella ändringar som de har gjort i &kalarm;.</para>

<warning
><para
>Om du uppdaterar en fjärrkalender, kommer alla ändringar av alarm som du har gjort sedan kalendern senast sparades att gå förlorade. Dessutom kan alarm som eventuellt har gått ut sedan de senast sparades, visas igen.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Importera...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Importera alarm från externa kalenderfiler till den markerade kalendern. Detta beskrivs i <link linkend="import"
>Importera alarm från externa kalendrar</link
>. Alternativet är inte tillgängligt för inaktiverade eller skrivskyddade kalendrar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Exportera...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Exportera alla alarm i den markerade kalendern till en extern kalenderfil. Detta beskrivs i <link linkend="export"
>Exportera alarm till externa kalendrar</link
>. Alternativet är inte tillgängligt för inaktiverade kalendrar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Visa detaljinformation</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Visar detaljinformation om den markerade kalendern. Det visar kalenderns plats, lagringstyp och statusinformation. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Använd som förval</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Gör den markerade kalendern till förvald kalender för vald kalendertyp. Alternativet är inte tillgängligt för inaktiverade eller skrivskyddade kalendrar.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Ange färg...</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Välj en bakgrundsfärg för att markera kalenderns alarm i alarmlistan. Det gör det möjligt att se med en enda blick vilka alarm som hör till en viss kalender.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Ta bort färg</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Ta bort färgmarkeringen för kalenderns alarm i alarmlistan. Alternativet visas bara efter <guimenuitem
>Ange färg</guimenuitem
> har används i kalendern.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="import">
<title
>Importera alarm från externa kalendrar</title>

<para
>Du kan importera alarm från andra kalenderfiler till &kalarm;. Importfunktionen söker igenom de valda kalenderfilerna efter händelser som innehåller alarm, och kopierar dem (med nya unika identifierare) till &kalarm;s kalender. Händelser utan alarm, och andra typer av kalenderposter, ignoreras. Det finns två sätt att importera alarm:</para>

<itemizedlist>
<listitem>
<para
>Använd  med <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Importera alarm...</guimenuitem
></menuchoice
> för att importera alarm av alla typer (aktiva alarm, arkiverade alarm och alarmmallar) från kalenderfilerna.</para>

<para
>Om du har ställt in <link linkend="calendars"
>alarmkalendrar</link
>, läggs alarm av varje typ till i lämplig förvald kalender, eller också blir du tillfrågad om kalendern om du har valt alternativet att bli tillfrågad för nya alarm och alarmmallar i <link linkend="preferences-storage"
>inställningsdialogrutan</link
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på en kalender i kalenderlistan och välj <menuchoice
><guimenuitem
>Importera...</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn. Det importerar alarm av typen som för närvarande är vald till kalendern. Om den valda kalendertypen till exempel är alarmmallar, importeras alarmmallar (och inte aktiva alarm eller arkiverade alarm).</para>
</listitem>
</itemizedlist>

<warning
><para
>Om du importerar alarm från kalenderfiler som skapades av andra program än &kalarm;, kan alarmen ändras av importprocessen, till och med alarmtider kan ändras. Det beror på datalagringskonventioner använda av det andra programmet, och är oundvikliga om dessa konventioner skiljer sig från vad &kalarm; förväntar sig. Kontrollera alltid importerade alarm för att hitta oväntade ändringar, och justera dem om det behövs.</para
></warning>

</sect2>

<sect2 id="export">
<title
>Exportera alarm till externa kalendrar</title>

<para
>Du kan exportera alarm från &kalarm; till andra kalenderfiler, antingen alarm som för närvarande är markerade i alarmlistan, eller alla alarm från en alarmkalender. Metoderna för att göra det anges nedan. Oberoende av vilken metod som används, kan du antingen skapa en ny kalenderfil eller lägga till de exporterade alarmen sist i en befintlig kalenderfil. Markera <guilabel
>Lägg till sist i befintlig fil</guilabel
> i filvalsdialogrutan för att lägga till alarmen, annars skrivs en eventuell befintlig fil över.</para>

<itemizedlist>
<listitem>
<para
>För att exportera alarm som för närvarande är markerade i alarmlistan, <mousebutton
>höger</mousebutton
>klicka på markeringen och välj <menuchoice
><guimenuitem
>Exportera...</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn, eller använd <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Exportera markerade alarm...</guimenuitem
></menuchoice
> i huvudmenyn.</para>
</listitem>

<listitem>
<para
>För att exportera alla alarm från en kalender, <mousebutton
>höger</mousebutton
>klicka på kalendern i kalenderlistan och välj <menuchoice
><guimenuitem
>Exportera...</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2 id="birthdays">
<title
>Importera födelsedagar från adressboken</title>

<note
><para
>Funktionen är bara tillgänglig om &kalarm;s <link linkend="akonadi-plugin"
>Akonadi insticksprogram</link
> är installerat och aktiverat.</para>
</note>

<para
>Du kan ställa in visning av alarm vid födelsedagar som är lagrade i adressboken med &kaddressbook;<menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Importera födelsedagar...</guimenuitem
></menuchoice
>. Då visas en dialogruta som låter dig välja för vilka födelsedagar alarm ska skapas.</para>

<itemizedlist>
<listitem>
<para
>I rutan <guilabel
>Alarmtext</guilabel
> kan du ställa in texten som visas i alarmmeddelandet för födelsedag. Meddelandetexten skapas genom att kombinera texten i <guilabel
>Prefix</guilabel
>, följt av personens namn, följt av texten i <guilabel
>Suffix</guilabel
>. Inga mellanslag läggs till, så kom ihåg att lägga till eventuellt nödvändiga avslutande mellanslag i <guilabel
>Prefix</guilabel
> och inledande mellanslag i <guilabel
>Suffix</guilabel
>.</para>

<note
><para
>Om du ändrar alarmtexten, utvärderas listan för val av födelsedag igen.</para
></note>
</listitem>

<listitem>
<para
>Välj födelsedagarna som du vill skapa alarm för i listan <guilabel
>Välj födelsedagar</guilabel
>. Observera att listan bara visar poster från adressboken som innehåller en födelsedag, och som inte redan har ett födelsedagsalarm med formatet som för närvarande anges i rutan <guilabel
>Alarmtext</guilabel
>.</para>
</listitem>

<listitem>
<para
>Återstående inställningar är likadana som för <guilabel
>Text</guilabel
>-alarm i <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>.</para>
</listitem>
</itemizedlist>

<para
>Om du har ställt in <link linkend="calendars"
>alarmkalendrar</link
>, läggs alarm till i förvald aktiv alarmkalender, eller också blir du tillfrågad om kalendern om du har valt alternativet att bli tillfrågad för nya alarm och alarmmallar i <link linkend="preferences-storage"
>inställningsdialogrutan</link
>.</para>
</sect2>

<sect2 id="undo">
<title
>Ångra och Gör om</title>

<para
>Du kan ångra och göra om de senaste ändringarna som du har gjort under nuvarande session med &kalarm;. De flesta åtgärder kan ångras, inklusive skapa, redigera och ta bort alarm och alarmmallar, och återaktivering av alarm. För att förhindra att alltför omfattande resurser används av ångrahistoriken, är antal ändringar som lagras begränsat till de 12 senaste.</para>

<para
>För att ångra den senaste ändringen, välj <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Ångra</guimenuitem
></menuchoice
>. För att göra om den senaste ändringen som ångrades, välj <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Gör om</guimenuitem
></menuchoice
>.</para>

<para
>För att ångra en annan ändring än den senaste, klicka på knappen <guibutton
>Ångra</guibutton
> i verktygsraden och håll nere musknappen. En lista med åtgärder visas där du kan välja den du vill ångra. Om du inte ser åtgärden du letar efter, kom ihåg att du först kan behöva ångra senare ändringar, som den önskade ändringen beror på. Om du till exempel redigerade ett alarm, och därefter tog bort det, kan du inte ångra redigeringen förrän du först har ångrat borttagningen.</para>

<para
>Att göra om än annan ändring än den senaste kan också göras på ett liknande sätt, genom att använda knappen <guibutton
>Gör om</guibutton
> i verktygsraden.</para>

</sect2>
</sect1>

<sect1 id="alarm-edit-dlg">
<title
>Dialogrutan för alarmredigering</title>

<para
>Dialogrutan för alarmredigering låter dig betrakta och redigera ett alarm. När du först använder &kalarm; visas en förenklad utformning av dialogrutan, där bara ett fåtal alternativ är synliga.Klicka på knappen <guibutton
>Fler alternativ</guibutton
> för att se alla alternativ. För att återgå till den föreklande dialogrutan, klicka på knappen <guibutton
>Färre alternativ</guibutton
>. &kalarm; kommer alltid ihåg den senaste inställningen när dialogrutan för alarmredigering visas igen.</para>

<para
>Du kan ställa in standardvärden för många av inställningarna i dialogrutan för alarmredigering med <link linkend="preferences-edit"
>inställningsdialogrutans redigeringsflik</link
>.</para>

<screenshot>
<screeninfo
>Skärmbild av den förenklade dialogrutan för alarmredigering</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow-simple.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Förenklad dialogruta för alarmredigering för ett visat alarm</phrase>
</textobject>
<caption
><para
>Förenklad dialogruta för alarmredigering för ett visat alarm</para
></caption>
</mediaobject>
</screenshot>

<screenshot>
<screeninfo
>Skärmbild av dialogrutan för alarmredigering som visar alla alternativ</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Dialogrutan för alarmredigering för ett visat alarm, som visar alla alternativ</phrase>
</textobject>
<caption
><para
>Dialogrutan för alarmredigering för ett visat alarm, som visar alla alternativ</para
></caption>
</mediaobject>
</screenshot>

<sect2>
<title
>Alarmnamn</title>

<para
>Du kan ge alarmet ett namn i fältet <guilabel
>Alarmnamn</guilabel
>. Det är en bekvämlighet för att enklare kunna identifiera namnet. Du behöver inte ange ett namn, och det behöver inte vara unikt.</para>

<para
>Observera att fältet bara visas om användning av alarmnamn är aktiverat under fliken <link linkend="preferences-general"
>Allmänt</link
> i inställningsdialogrutan.</para>

</sect2>

<sect2>
<title
>Alarmåtgärder</title>

<para
>Komponenterna i rutan <guilabel
>Åtgärd</guilabel
> varierar beroende på alarmtypen som redigeras.</para>

<sect3>
<title
>Visade alarm</title>

<para
>Visade alarm öppnar ett fönster när alarmet aktiveras. Välj metod att skapa alarmfönstrets innehåll, med kombinationsrutan längst upp:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Textmeddelande</guilabel
> för att skriva in en alarmmeddelandetext (som kan innehålla flera rader) i redigeringsrutan.</para>
</listitem>

<listitem>
<para
><guilabel
>Filinnehåll</guilabel
> för att skriva in namnet eller webbadressen till en textfil vars innehåll ska visas i alarmmeddelandet. Använd knappen intill redigeringsrutan för att visa en filvalsdialogruta. Alternativet <guilabel
>Läs upp</guilabel
> är inte tillgängligt för den här alarmtypen.</para>
</listitem>

<listitem>
<para
><guilabel
>Kommandoutmatning</guilabel
> för att ange att alarmmeddelandet kommer att skapas av ett kommando som körs när alarmet aktiveras. Se <link linkend="command-alarm"
>Kommandoalarm</link
> nedan för detaljinformation om hur kommandon eller kommandoskript att köra anges.</para>
</listitem>
</itemizedlist>

<para
>Komponenter tillgängliga för att visa alarm är:</para>

<itemizedlist>
<listitem>
<para
>Alternativet <guilabel
>Ljud</guilabel
> låter dig välja om du vill att ett hörbart alarm ska avges när alarmmeddelandet visas. Välj:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Inget</guilabel
> för att visa alarmet tyst.</para>
</listitem>

<listitem>
<para
><guilabel
>Ljudsignal</guilabel
> för att avge en ljudsignal.</para>
</listitem>

<listitem>
<para
><guilabel
>Läs upp</guilabel
> för att läsa upp alarmmeddelandet förutom att det visas. Alternativet är bara tillgängligt om &kalarm; byggdes med tal aktiverat och du har modulen &Qt; Speech installerad och fungerande.</para>
</listitem>

<listitem>
<para
><guilabel
>Ljudfil</guilabel
> för att spela en ljudfil. Använd knappen till höger för att visa ljudfilsdialogrutan, som låter dig välja en fil att spela och ställa in volym och upprepningsalternativ. Om du håller musen över knappen, visar ett verktygstips ljudfilen som för närvarande är vald.</para>

<para
>I ljudfildialogrutan:</para>

<itemizedlist>
<listitem>
<para
>Skriv in ljudets filsökväg, eller använd knappen intill redigeringsrutan för att visa en filvalsdialogruta. Du kan lyssna på den valda filen genom att klicka på uppspelningsknappen till vänster om redigeringsfältet. Knappen ändrar då funktion för att låta dig stoppa uppspelningen när du har hört tillräckligt.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Upprepa</guilabel
> för att kontinuerligt upprepa ljudfilen så länge som alarmet visas. (Fönstret med alarmmeddelandet innehåller en knapp för att stoppa uppspelning av ljudet om du behöver tystnad med fortfarande vill visa alarmet.)</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Volym</guilabel
> och justera skjutreglaget om du vill justera volymen som ljudfilen spelas upp med.</para>
</listitem>

<listitem>
<para
>Om &phonon; ljudgränssnittet som för närvarande används stöder det, kan du tona volymen. Att tona betyder att börja spela ljudfilen med en volym och gradvis ändra till den slutliga volymen, under ett angivet tidsintervall. Den slutliga volymen är den som skrivs in i <guilabel
>Volym</guilabel
> ovan. För att aktivera toning, markera <guilabel
>Tona</guilabel
>, och skriv därefter in perioden i sekunder i fältet <guilabel
>Toningstid</guilabel
>, och justera skjutkontrollen <guilabel
>Ursprunglig volym</guilabel
>.</para>
</listitem>
</itemizedlist>

<tip
><para
>Du kan använda knappen <guibutton
>Försök</guibutton
> för att prova valda ljudnivåer.</para
></tip>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Använd knappen <guibutton
>Teckensnitt och färg...</guibutton
> för att välja ett teckensnitt, samt förgrunds- och bakgrundsfärg för alarmmeddelandet. Markera <guilabel
>Använd standardteckensnitt</guilabel
> i dialogrutan <guilabel
>Välj alarmteckensnitt och färg</guilabel
> för att visa meddelandet med vilket teckensnittet som än är förvalt när meddelandet visas. För att välja ett särskilt teckensnitt för meddelandet, avmarkera <guilabel
>Använd standardteckensnitt</guilabel
>.(Standardteckensnitt och färgerna som visas kan ställas in i <link linkend="preferences-edit"
>inställningsdialogrutan</link
>.)</para>

<para
>Valda färger visas i alarmmeddelandets textinmatningsfält.</para>
</listitem>

<listitem>
<para
>Alternativet <guilabel
>Visningsmetod</guilabel
> låter dig välja hur du vill visa alarmet. Välj:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Fönster</guilabel
> för att visa alarmet i ett fönster. Alternativet erbjuder hela utbudet av alternativ att använda när alarmet ställs in.</para>
</listitem>

<listitem>
<para
><guilabel
>Underrättelse</guilabel
> för att använda det vanliga underrättelsesystemet för att visa alarmmeddelandet. På grund av begränsningarna i underrättelsesystemet, kan inte följande alarminställningar användas med underrättelser: ställa in teckensnitt och färg, ställa in en ljudfil som spelas när alarmet visas, bekräfta alarm igen, automatisk stängning av visningen efter att perioden för att avbryta sent går ut.</para>
</listitem>
</itemizedlist>

<para
>Se avsnittet <link linkend="message-display"
>Alarmmeddelandevisning</link
> för ytterligare information om hur alarmmeddelanden visas.</para>
</listitem>

<listitem>
<para
>Använd knappen <guibutton
>Särskilda åtgärder...</guibutton
> för att ange skalkommandon som ska köras innan eller efter alarmet visas. I dialogrutan <guilabel
>Ange alarmåtgärder</guilabel
>:</para>

<itemizedlist>
<listitem>
<para
>Skriv in ett skalkommando att köra innan alarmet visas i fältet <guilabel
>Åtgärd innan alarmet</guilabel
>. Observera att &kalarm; väntar på att kommandot ska bli färdigt innan alarmet visas.</para>

<para
>En åtgärd innan alarmet utförs bara en gång när alarmet visas första gången, inklusive när ett påminnelsemeddelande ersätts av själva alarmmeddelandet. Den utförs <emphasis
>inte</emphasis
> under någon av följande omständigheter:</para>

<itemizedlist>
<listitem
><para
>När ett påminnelsemeddelande visas.</para
></listitem>
<listitem
><para
>När meddelandet visas igen efter att alarmet har skjutits upp, om inte <guilabel
>Utför för uppskjutna alarm</guilabel
> är markerat.</para
></listitem>
<listitem
><para
>När meddelandet visades när du loggade ut och senare återställs när du loggar in.</para
></listitem>
<listitem
><para
>När ett återkommande alarm visas, men alarmmeddelandet (eller det uppskjutna alarmmeddelandet) från en tidigare förekomst av alarmet fortfarande är synligt, med andra ord, när den tidigare förekomsten av alarmet inte ännu har bekräftats.</para
></listitem>
</itemizedlist>

<para
>Åtgärden innan alarmet kan användas för att bestämma om alarmmeddelandet ska visas:</para>

<itemizedlist>
<listitem
><para
>Markera <guilabel
>Avbryt alarm vid fel</guilabel
> för att avbryta alarmet om kommandot innan alarmet returnerar felstatus. Det förhindrar att alarmmeddelandet visas, och att eventuell åtgärd efter alarmet utförs.</para
></listitem>

<listitem
><para
>Om kommandot innan alarmet returnerar ett fel visas normalt ett felmeddelande, och en felindikering visas i alarmlistan. Dessa felunderrättelser kan förhindras genom att markera <guilabel
>Underrätta inte vid fel</guilabel
>.</para
></listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Skriv in ett skalkommando att köra när alarmet bekräftas i fältet <guilabel
>Åtgärd efter alarmet</guilabel
> (vare sig det sker genom att klicka på <guibutton
>Stäng</guibutton
> eller genom att använda stängningsknappen i fönstrets namnlist). Det utförs <emphasis
>inte</emphasis
> under någon av följande omständigheter:</para>

<itemizedlist>
<listitem
><para
>När ett påminnelsemeddelande stängs.</para
></listitem>
<listitem
><para
>När du skjuter upp alarmet, utom när det uppskjutna alarmet slutligen bekräftas.</para
></listitem>
<listitem
><para
>När alarmmeddelandet stängs på grund av att du loggar ut.</para
></listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Se <link linkend="command-alarm"
>kommandoalarm</link
> nedan för detaljer om hur skalkommandon körs.</para>

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

<sect3 id="command-alarm">
<title
>Kommandoalarm</title>

<para
>Kommandoalarm kör ett kommando utan att visa ett alarmmeddelande.</para>

<note
><para
>Alarmtypen är inte tillgängligt om &kde; kör i kioskläge.</para
></note>

<para
>När kommandot utförs innehåller miljövariabeln <envar
>KALARM_UID</envar
> alarmets händelse-UID. Observera att när kommandot utförs med knappen <guibutton
>Prova</guibutton
> i dialogrutan för alarmredigering, kommer <envar
>KALARM_UID</envar
> att vara tom om det är ett nytt alarm, eller om alarmet har ändrats i dialogrutan, eftersom alarmet bara erhåller UID när det sparas i alarmkalendern.</para>

<para
>Komponenterna tillgängliga för kommandoalarm är:</para>

<itemizedlist>
<listitem>
<para
>Kryssrutan <guilabel
>Ange ett skript</guilabel
> låter dig välja om en skalkommandorad eller ett skript ska anges.</para>

<para
>Om alternativet inte är markerat, kan du skriva in en skalkommandorad att köra. Kommandot skickas direkt till förvalt skal (definierat av miljövariabeln <envar
>SHELL</envar
>), och kan innehålla alla alternativ, väljare, kommandon med rörledning, etc. som tillåts av skalet på en ensam kommandorad.</para>

<para
>Om alternativet är markerat kan du ange texten för ett skript som ska köras. Kom ihåg att inkludera en första rad som <literal
>#!/bin/bash</literal
> för att försäkra dig om att rätt kommandotolk startas.</para>
</listitem>

<listitem
><para
>Om kommandot returnerar ett fel visas normalt ett felmeddelande, och en felindikering visas i alarmlistan. Felunderrättelsemeddelandet kan förhindras genom att markera <guilabel
>Underrätta inte vid fel</guilabel
>.</para
></listitem>

<listitem>
<para
>Använd grupprutan <guilabel
>Kommandoutmatning</guilabel
> för att ange vad du vill ska göras med eventuell utmatning till terminalen som kommandot skapar när det kör.</para>

<itemizedlist>
<listitem>
<para
>Markera <guilabel
>Kör i terminalfönster</guilabel
> för att få kommandot att köras i ett terminalfönster. Du kan välja vilken typ av terminalfönster som ska användas i <link linkend="preferences-general"
>Inställningsdialogrutan</link
>.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Logga i fil</guilabel
> för att spara kommandots utmatning i en fil. Utmatningen, föregången av en rubrik som visar tiden då kommandot schemalades att köra, läggs till sist efter eventuellt befintligt innehåll i filen. Skriv in filnamnet i redigeringsrutan, eller använd knappen intill redigeringsrutan för att visa en filvalsdialogruta.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Kasta</guilabel
> för att kasta utmatningen från kommandot.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect3>

<sect3>
<title
>E-postalarm</title>

<para
>E-postalarm skickar e-post utan att visa något alarmmeddelande.</para>

<para
>Fyll i mottagarnas adresser, e-postrubriken och meddelandetexten i de tre redigeringsfälten. Använd knappen intill adressredigeringsrutan för att visa &kde;:s adressbok, där du kan välja e-postmottagare (observera att knappen bara visas om &kalarm;s <link linkend="akonadi-plugin"
>Akonadi insticksprogram</link
> är installerat och aktiverat). Bilagor kan läggas till med knappen <guibutton
>Lägg till..</guibutton
>. Observera att bilagor måste fortfarande finnas vid tiden då alarmet inträffar. Ingen kopia lagras när alarmet ställs in. För att ta bort en bilaga, markera det i kombinationsrutan och klicka på knappen <guibutton
>Ta bort</guibutton
>.</para>

<para
>Ställ in följande alternativ:</para>

<itemizedlist>
<listitem>
<para
>Kombinationsrutan <guilabel
>Från</guilabel
> låter dig välja vilken &kmail;-identitet som ska användas som din e-postadress när e-post skickas. Alternativet visas bara om din e-postadress efter <guilabel
>Från</guilabel
> i <link linkend="preferences-email"
>Inställningsdialogrutan</link
> är inställd till <guilabel
>Använd identiteter i &kmail;</guilabel
>. Annars är din e-postadress förinställd i <link linkend="preferences-email"
>Inställningsdialogrutan</link
>, vilket gör att alternativet inte gäller.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Kopiera e-post till mig själv</guilabel
> för att skicka en dold kopia av e-posten till dig själv när alarmet inträffar. E-postadressen som kopian skickas till kan ställas in i <link linkend="preferences-email"
>inställningsdialogrutan</link
>, där det förvalda värdet är e-postadressen som ställts in &kmail;.</para>
</listitem>
</itemizedlist>

</sect3>

<sect3>
<title
>Ljudalarm</title>

<para
>Ljudalarm spelar en ljudfil utan att visa något alarmmeddelande.</para>

<para
>Ställ in följande alternativ:</para>

<itemizedlist>
<listitem>
<para
>Ange sökväg till ljudfilen, eller använd knappen intill redigeringsrutan för att visa en filvalsdialogruta.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Upprepa</guilabel
> för att upprepa ljudfilen hela tiden tills alternativet <guilabel
>Stoppa uppspelning</guilabel
> används. För att stoppa uppspelning av filen, använd menyalternativet <menuchoice
><guimenu
>Åtgärder</guimenu
><guimenuitem
>Stoppa uppspelning</guimenuitem
></menuchoice
>, eller <mousebutton
>höger</mousebutton
>klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Stoppa uppspelning</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn. Om du vill, kan du ställa in en global snabbtangent för åtgärden.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Volym</guilabel
> och justera skjutreglaget om du vill justera volymen som ljudfilen spelas upp med.</para>
</listitem>

<listitem>
<para
>Om &phonon; ljudgränssnittet som för närvarande används stöder det, kan du tona volymen. Att tona betyder att börja spela ljudfilen med en volym och gradvis ändra till den slutliga volymen, under ett angivet tidsintervall. Den slutliga volymen är den som skrivs in i <guilabel
>Volym</guilabel
> ovan. För att aktivera toning, markera <guilabel
>Tona</guilabel
>, och skriv därefter in perioden i sekunder i fältet <guilabel
>Toningstid</guilabel
>, och justera skjutkontrollen <guilabel
>Ursprunglig volym</guilabel
>.</para>
</listitem>
</itemizedlist>
</sect3>
</sect2>

<sect2>
<title
>Uppskjutning</title>

<para
>Om alarmet är återkommande, och det skjutits upp efter att det visats senast, så visar rutan <guilabel
>Uppskjutna alarm</guilabel
> tiden som det skjutits upp till. <guibutton
>Ändra...</guibutton
> visar en dialogruta som låter dig ändra tiden eller inte längre skjuta upp alarmet.</para>

</sect2>

<sect2>
<title
>Tid</title>

<para
>I rutan <guilabel
>Tid</guilabel
>, välj antingen:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Vid datum/tid:</guilabel
> för att ange datum och tid när alarmet ska aktiveras. Markera <guilabel
>När som helst</guilabel
> om du bara vill ange ett datum för alarmet. I detta fall visas alarmet vid första tillfälle efter den inställda tiden då dagen börjar, på angivet datum. (<link linkend="preferences-time"
>Anpassa &kalarm;</link
> beskriver hur man ställer in tiden då dagen börjar.)</para>

<para
>För ett alarm som inte upprepas måste datum och tid som du skriver in vara i framtiden, eller om du bara skriver in ett datum måste det vara idag eller senare. För ett alarm som upprepas finns inga sådana begränsningar, eftersom startdatum och tid automatiskt justeras till första upprepningen efter aktuell tid.</para>
</listitem>

<listitem>
<para
><guilabel
>Tid från nu</guilabel
> för att skriva in hur långt från nuvarande tid (i timmar och minuter) som alarmet ska visas.</para>
</listitem>
</itemizedlist>

<para
>Om önskat, välj tidszon då alarmet ska visas. Tidszonen används för alla datum och tider som hör ihop med alarmet, inklusive upprepning och undantagna datum och tider. Normalt bör du lämna inställningen av tidszon oförändrad om du inte har orsak att ändra den.</para>

<para
>Inställningen av tidszon visas bara när den valda tidszonen skiljer sig från den normala tidszonen i <link linkend="preferences-time"
>inställningsdialogrutan</link
>, eller om du klickar på knappen <guibutton
>Tidszon...</guibutton
>.</para>

<itemizedlist>
<listitem>
<para
>Välj tidszon i kombinationsrutan som alarmet ska använda. När ett nytt alarm skapas, är det inställt till tidszonen vald i <link linkend="preferences-time"
>inställningsdialogrutan</link
>, som är din dators tidszon om du inte har ändrat den.</para>
</listitem>

<listitem>
<para
>Markera <guilabel
>Systemets tidszon</guilabel
> om du vill använda den lokala datortiden (på vilken dator som helst som &kalarm; råkar köra på vid tillfället).</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Påminnelse</title>

<para
>Markera <guilabel
>Påminnelse</guilabel
> om du antingen vill visa en påminnelse innan eller efter huvudalarmet och var och en av dess upprepningar (om det finns några) för visade alarm. Ange hur långt i förväg eller efteråt med redigeringskontrollerna intill kryssrutan. Observera att om alarmet upprepas är påminnelseperioden normalt begränsad till att vara kortare än upprepningens eller delrepetitionernas intervall.</para>

<note
><para
>Påminnelser visas inte för delrepetitioner inom en upprepning. Påminnelser visas bara för varje huvudupprepning av alarmet.</para
></note>

<para
>Om alarmet upprepas, markera <guilabel
>Påminnelse bara för första upprepning</guilabel
> om du bara vill ha en påminnelse för alarmets första upprepning. Om det är markerat, och det är en avancerad påminnelse, gäller inte den normala begränsningen för påminnelseperioden att den är kortare än upprepningens eller delrepetitionernas intervall.</para>


</sect2>

<sect2>
<title
>Avbrytning</title>

<para
>Alternativen för att avbryta vid försening avgör hur alarm behandlas efter sin schemalagda tid:</para>

<itemizedlist>
<listitem>
<para
>Kryssrutan <guilabel
>Hoppa över om sent</guilabel
> avgör vad som händer om alarmet inte kan visas vid den schemalagda tiden.</para>

<para
>Markera den här rutan om alarmet ska avbrytas om det inte kan visas inom en given tidsperiod efter den rätta tiden. Tidsperioden väljes med inställningarna som visas när rutan markeras. Om du till exempel skriver in tidsperioden en timma, visas alarmet vid första möjliga tillfälle upp till en timma efter det skulle visats, men om det inte kan visas inom en timma avbryts aktiveringen.</para>

<note
><para
>Hur sent ett alarm med bara datum är, dvs. de som har alternativet <guilabel
>När som helst</guilabel
> markerat, beräknas från tiden då dagen börjar för det datum då alarmet är schemalagt.</para
></note>

<para
>Lämna rutan omarkerad för att visa alarmet vid första tillfälle med början den schemalagda tiden, oberoende av hur försenat det är.</para>

<note
><para
>Ett alarm kan bara aktiveras medan du är inloggad, och medan både X och &kalarm; kör.</para
></note>
</listitem>

<listitem>
<para
>Markera <guilabel
>Stäng fönstret automatiskt efter den här tiden</guilabel
> om du vill att alarmfönstret ska stängas automatiskt om det fortfarande visas efter utgången av perioden för att avbryta sent.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Upprepning</title>

<para
>Ange om och hur alarmet ska upprepas under fliken <guilabel
>Upprepning</guilabel
>.</para>

<note
><para
>Alarmets grundläggande upprepningskaraktäristik visas av bekvämlighetsskäl i namnet på fliken <guilabel
>Upprepning</guilabel
>. Upprepningsintervallet visas först, följt av eventuella delrepetitionsintervall inställda med knappen <guibutton
>Delrepetition</guibutton
>.</para
></note>

<para
>Välj typ av upprepning eller tidsperiod i rutan <guilabel
>Upprepningsregel</guilabel
> , på följande sätt:</para>

<itemizedlist>
<listitem
><para
>För att bara visa alarmet en gång, välj <guilabel
>Ingen upprepning</guilabel
>.</para
></listitem>

<listitem
><para
>Markera <guilabel
>Vid inloggning</guilabel
> om du vill att alarmet ska visas så fort du loggar in, till den schemalagda sluttiden. Då visas det en sista gång vid sin schemalagda sluttid. (Observera att ett alarm som upprepas vid inloggning också visas så fort du startar om &kalarm;.)</para
></listitem>

<listitem>
<para
>För att låta alarmet upprepas med regelbundna intervall, välj en tidsperiod och skriv sedan in i rutan <guilabel
>Upprepa var</guilabel
> hur många tidsperioder som ska gå ut mellan upprepningarna. För att till exempel upprepa var 14:e dag, kan du välja <guilabel
>Varje dag</guilabel
> och skriva in värdet 14, eller välja <guilabel
>Varje vecka</guilabel
> och skriva in värdet 2. Beroende på tidsperioden som väljs, kan det finnas ytterligare alternativ:</para>

<itemizedlist>
<listitem>
<para
>För en veckovis upprepning, markera varje dag i veckan då du vill visa alarmet.</para>
</listitem>

<listitem>
<para
>För en månadsvis upprepning, kan du antingen välja ett fast datum eller en position (t.ex. den andra tisdagen).</para>
</listitem>

<listitem>
<para
>För en månadsvis upprepning, kan du antingen välja ett fast datum under månaden eller en position under en månaden (t.ex. den sista lördagen i maj). Markera varje månad under året då du vill aktivera alarmet.</para>

<para
>Om du ställer in årliga upprepningar för 29:e februari, kan du ange hur de ska hanteras år som inte är skottår, genom att välja lämpligt alternativ för <guilabel
>Alarm den 29:e februari när det inte är skottår</guilabel
>:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Inget</guilabel
>: alarmet inträffar den 29:e februari under skottår, men visas inte andra år.</para>
</listitem>

<listitem
><para
><guilabel
>28:e feb</guilabel
>: alarmet inträffar den 29:e februari under skottår, och 28:e februari andra år.</para>
</listitem>

<listitem
><para
><guilabel
>1:a mars</guilabel
>: alarmet inträffar den 29:e februari under skottår, och 1:a mars andra år.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<tip
><para
>För att ställa in ett dagligt alarm som bara ska inträffa på vardagar, använd veckovis upprepning och markera alla vardagar.</para
></tip>

</listitem>
</itemizedlist>

<para
>Ställ in det övergripande tidsområdet i rutan <guilabel
>Upprepningens slut</guilabel
> på följande sätt:</para>

<itemizedlist>
<listitem
><para
>Välj <guilabel
>Inget slut</guilabel
> för att fortsätta upprepningarna för evigt.</para
></listitem>

<listitem
><para
>Välj <guilabel
>Sluta efter</guilabel
> för att ange totalt antal upprepningar av alarmet.</para
></listitem>

<listitem
><para
>Välj <guilabel
>Sluta vid</guilabel
> för att ange datum/tid som alarmet kommer att upprepas till. Observera att det använder samma tidszon som alarmets starttid.</para>

<note
><para
>Slutdatum och sluttid bestämmer när den sista huvudupprepningen sker, men begränsar inte delrepetitioner. Om delrepetitioner är inställda, sker de normalt efter den sista huvudupprepningen, oberoende av slutdatum och sluttid.</para
></note>
</listitem>
</itemizedlist>

<para
>Grupprutan <guilabel
>Undantag</guilabel
> låter dig undanta vissa datum eller tider från upprepningen som du har ställt in. Observera att alternativen inte visas i den förenklade formen av dialogrutan för alarmredigering. Klicka på <guibutton
>Fler alternativ</guibutton
> för att se dem.</para>

<itemizedlist>
<listitem>
<para
>Listan med undantag (dvs datum eller tider) visas till vänster. För att lägga till ett nytt undantag, skriv in ett datum till höger och tryck på <guibutton
>Lägg till</guibutton
>. För att ändra ett undantag, skriv in det nya datumet till höger och tryck på <guibutton
>Ändra</guibutton
>. För att ta bort ett undantag, markera det i listan och tryck på <guibutton
>Ta bort</guibutton
>.</para>
</listitem>

<listitem>
<para
>Du kan begränsa ett alarm att inte ske under helger genom att markera <guilabel
>Undanta helger</guilabel
>. Det ändrar inte sättet som alarmet schemaläggs, det visar helt enkelt inte alarmet när det råkar ske på en helg. Du kan välja land eller region för helger i <link linkend="preferences-time"
>inställningsdialogrutan</link
>.</para>
</listitem>

<listitem>
<para
>Du kan begränsa ett alarm att bara ske under arbetstid genom att markera <guilabel
>Bara under arbetstid</guilabel
>. Det ändrar inte sättet som alarmet schemaläggs, det visar helt enkelt inte alarmet när det råkar ske utanför arbetstid. Arbetsdagar och arbetstimmar ställs in i <link linkend="preferences-time"
>inställningsdialogrutan</link
>.</para>
</listitem>
</itemizedlist>

<sect3>
<title
>Delrepetition</title>

<para
>Du kan använda knappen <guibutton
>Delrepetition</guibutton
> för att ställa in en repetition inne i en upprepning. I detta fall, varje gång alarmet ska visas enligt vad som anges i huvudförekomsten, repeteras det flera gånger enligt specifikationen i delrepetition istället för att bara visas en gång. För att till exempel ställa in ett alarm som repeteras varje timma från klockan tolv till sex på eftermiddagen varje torsdag, skulle du ställa in en veckovis upprepning på torsdag 12:00, och använda dialogrutan Delrepetition för att ange en timmas intervall och antingen 6 som antal eller 6 timmars varaktighet.</para>

<para
>Markera <guilabel
>Repetera var</guilabel
> för att ställa in en repetition, eller avmarkera den för att ta bort repetitionen, i dialogrutan för delrepetition som visas när du klickar på knappen <guibutton
>Delrepetition</guibutton
>. Om <guilabel
>Repetera var</guilabel
> är markerad, ställer du in repetitionen på följande sätt:</para>

<itemizedlist>
<listitem
><para
>Skriv in tidsintervallet mellan repetitioner i inställningarna intill <guilabel
>Repetera var</guilabel
>. Välj önskade tidsenheter (t.ex. <guilabel
>dagar</guilabel
>) och skriv därefter in antal enheter.</para>
</listitem>

<listitem
><para
>Ange antingen antal repetitioner eller dess varaktighet:</para>

<itemizedlist>
<listitem
><para
>Markera <guilabel
>Antal repetitioner</guilabel
> för att skriva in hur många gånger alarmet ska visas, inklusive den ursprungliga förekomsten. För att till exempel få alarmet att visas ytterligare tre gånger efter det först visas, ska du skriva in 4 här.</para>
</listitem>

<listitem
><para
>Markera <guilabel
>Varaktighet</guilabel
> för att skriva in den totala tidsperioden då alarmet ska repeteras. Det behöver inte vara en exakt multipel av repetitionsintervallet, utan det avrundas automatiskt neråt när du klickar på <guibutton
>Ok</guibutton
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<note
><para
>För att förhindra överlappande delrepetitioner för samma alarm, är en delrepetitions varaktighet begränsad till mindre än det längsta intervallet mellan huvudupprepningar. Varje gång alarmet upprepas enligt vad som är angivet i huvudupprepningen, avbryts automatiskt alla aktiva delrepetitioner som påbörjades vid den föregående upprepningen.</para
></note>

</sect3>
</sect2>

<sect2>
<title
>Övriga åtgärder</title>

<para
>Om systeminställningen tillåter flera alarm att väcka systemet från avstängning, kan du välja <guilabel 
>Vakna från viloläge</guilabel 
> för att väcka systemet om det för närvarande är i viloläge när alarmet går ut. Se <link linkend="wake-suspend"
>Vakna från viloläge</link
> för mer information.</para>

<para
>Kryssrutan <guilabel
>Bekräfta meddelande</guilabel
> låter dig ange om du vill bli tillfrågad om bekräftelse när du stänger alarmmeddelandets fönster för visade alarm. Det kan användas som en säkerhetsåtgärd för att undvika att bekräfta alarm av misstag.</para>

<para
>Välj <guilabel
>Visa i &korganizer;</guilabel
> för att lägga till ett alarm i &korganizer;s aktiva kalender, där det visas som en händelse utan alarm. Alternativet gör det möjligt att följa alarm i &korganizer;, medan du fortfarande drar nytta av &kalarm;s funktioner.</para>

<note
><para
>Om du senare ändrar eller tar bort alarmet i &kalarm;, ändras eller tas händelsen bort i &korganizer; på motsvarande sätt. Men om du ändrar händelsen i &korganizer;, påverkas inte alarmet i &kalarm;.</para
></note>

<para
>Tryck på knappen <guibutton
>Ladda mall</guibutton
> för att välja en mall att förinställa dialogrutan med, som beskrivs i <link linkend="create-edit"
>Skapa och hantera alarm</link
>. </para>

<para
>Tryck på knappen <guibutton
>Försök</guibutton
> för att prova alarmet och kontrollera om det fungerar riktigt. Alarmet utförs precis som om det hade schemalagts som vanligt. I fallet med ljudalarm, klicka på knappen <guibutton
>Försök</guibutton
> en andra gång för att stoppa uppspelning av ljudfilen.</para>

<para
>Tryck på knappen <guibutton
>Ok</guibutton
> när alla uppgifter är riktiga, för att lägga till alarmet i listan på schemalagda alarm. Observera att när ett befintligt alarm redigeras, är knappen <guibutton
>Ok</guibutton
> inaktiverad innan några ändringar har gjorts.</para>

</sect2>
</sect1>

<sect1 id="message-display">
<title
>Alarmmeddelandevisning</title>

<para
>Alarmmeddelanden kan visas i fönster eller som underrättelser, beroende på alternativet som väljes i <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>. De två visningsalternativen beskrivs nedan.</para>

<para
>Om du förhindrar underrättelser för skrivbordet, skjuts visning av alarm upp tills underrättelser aktiveras igen. Observera att det gäller visning av alla alarm, oberoende av om de visas i fönster eller som underrättelser.</para>

<sect2 id="message-window">
<title
>Alarmmeddelandefönster</title>

<para
>Alarmmeddelanden som visas i fönster erbjuder flest funktioner.</para>

<para
>När ett alarmmeddelande ska visas, syns det på alla skrivbord och kan inte täckas av vanliga fönster, för att vara säker på att du ser det. Meddelandefönstret visar tiden då alarmet var schemalagt, så att du kan se när det visades om du inte var vid datorn när det dök upp. Om alarmets schemalagda tid är i en annan tidszon än den lokala datorns inställningar, visas också tidszonen. (För påminnelsemeddelanden, visas datum/tid för huvudalarmet eller dess upprepning, inte påminnelsens tid, och fönsternamnet är <quote
>Påminnelse</quote
>).</para>

<para
>Meddelandefönster för alarm förblir synliga till du bekräftar dem, om inte <guilabel
>Stäng fönster automatiskt efter den här tiden</guilabel
> markerats i <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>. I fallet med upprepade alarm, om ett meddelandefönster som inte bekräftas finns kvar från ett tidigare tillfälle då alarmet inträffade, dyker helt enkelt det befintliga fönstret upp när alarmet upprepas. Det här undviker att flera kopior av samma meddelande måste bekräftas, om du inte vill eller kan bekräfta ett meddelande när det inträffar.</para>

<para
>Fönstret med alarmmeddelanden tillhandahåller alla av följande alternativ som passar för det visade alarmet:</para>

<itemizedlist>
<listitem>
<para
>Bekräfta alarmet genom att klicka på knappen <guibutton
>Stäng</guibutton
>. Det här stänger fönstret (efter förfrågan om bekräftelse, om du markerat <guilabel
>Bekräfta meddelande</guilabel
>).</para>
</listitem>

<listitem>
<para
>Redigera alarmet genom att klicka på knappen <guibutton
>Redigera...</guibutton
>. Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>.</para>
</listitem>

<listitem>
<para
>Visa alternativ för att skjuta upp alarmet till senare genom att klicka på knappen <guibutton
>Skjut upp...</guibutton
>. Välj sedan <guilabel
>Skjut upp till datum/tid</guilabel
> för att skriva in datum och tid när meddelandet ska visas igen (knappen <guilabel
>Förinställning</guilabel
> låter dig välja i en lista med vanliga tidsintervall), eller välj <guilabel
>Skjut upp under tidsintervall</guilabel
> för att skriva in datum och tid som meddelandet ska visas igen. Klicka sedan på <guibutton
>Ok</guibutton
> för att skjuta upp alarmmeddelandet och stänga dess fönster.</para>

<note
><para
>Tiden alarmet skjuts upp till måste vara tidigare än dess nästa schemalagda förekomst eller nästa avancerade påminnelse. Av detta skäl är knappen <guibutton
>Skjut upp...</guibutton
> i fönstret med alarmmeddelandet och knappen <guibutton
>Ok</guibutton
> i uppskjutningsdialogrutan inaktiverade en minut innan nästa förekomst eller avancerad påminnelse.</para>
<para
>Observera att om en påminnelse är inställd <emphasis
>efter</emphasis
> alarmet, <emphasis
>kan</emphasis
> det skjutas upp efter sin påminnelsetid. I detta fall bortses från påminnelsen.</para
></note>

<note
><para
>Knappen <guibutton
>Skjut upp...</guibutton
> är inte tillgänglig för alarm som visas vid inloggning beroende på att alternativet <guilabel
>Upprepa vid inloggning</guilabel
> markerades.</para
></note>
</listitem>

<listitem>
<para
>Sluta spela alarmets ljudfil genom att klicka på knappen som visar symbolen <quote
>stoppa uppspelning</quote
>.</para>
</listitem>

<listitem>
<para
>Om alarmet skapades genom att dra ett brev från &kmail;, kan du direkt komma åt brevet i &kmail; genom att klicka på knappen som visar &kmail;s ikon. Det visar brevet och väljer korgen som innehåller brevet i &kmail;s korglista.</para>

<warning
><para
>Om &kmail;s index skapas om, går länken till brevet i &kmail; förlorad.</para
></warning>
</listitem>

<listitem>
<para
>Knappen som visar ikonen <guiicon
>&kalarm;</guiicon
> tillhandahåller ett bekvämt sätt att aktivera &kalarm;s huvudfönster, med det alarmet markerat.</para>
</listitem>
</itemizedlist>

<para
>Du kan välja vilket av två olika lägen som ska användas för att visa fönster med alarmmeddelanden i <link linkend="preferences-view"
>inställningsdialogrutan</link
>:</para>

<itemizedlist>
<listitem>
<para
>Som ett normalt fönster. I det här läget övertar alarmmeddelandefönstret tangentbordsfokus när det visas, så om du håller på att skriva vid tillfället, hamnar dina tangentnedtryckningar i det istället för ditt ursprungliga program.</para>
</listitem>

<listitem>
<para
>Som ett fönster som inte fokuseras. I det här läget påverkas inte tangentbordsfokus när alarmmeddelandefönstret visas, så det stör inte det du skriver. Dock har fönstret ingen namnlist eller ram i det här läget, så du kan inte flytta eller ändra storlek på det.</para>
</listitem>
</itemizedlist>

<note
><para
>När ett alarm visas ovanpå ett program med fullskärmsläge, visas det som ett vanligt fönster oberoende av det här inställningsalternativet. Det beror på en begränsning i fönsterhanteringssystemet.</para
></note>

<sect3>
<title
>Positionering av meddelandefönster</title>

<para
>Du kan välja vilken av två metoder som ska användas för att placera fönster med alarmmeddelanden i <link linkend="preferences-view"
>inställningsdialogrutan</link
>:</para>

<itemizedlist>
<listitem>
<para
>Fönstren visas så lång från aktuell muspekare som möjligt. Det minimerar påverkan av ditt arbetsflöde och minimerar möjligheten att bekräfta ett alarm av misstag.</para>
</listitem>

<listitem>
<para
>Fönstren visas mitt på skärmen. För att minska risken att bekräfta ett alarm av misstag, är fönstrets knappar inaktiverade från början och blir aktiva efter en inställningsbar fördröjning.</para>
</listitem>
</itemizedlist>

<para
>Om flera fönster med alarmmeddelanden, eller felmeddelanden, visas, kan du sprida fönstren över skärmen så att alla är synliga, eller gruppera alla tillsammans igen i skärmens övre vänstra hörn, med användning av menyalternativet <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Sprid fönster</guimenuitem
> </menuchoice
>. Om du så önskar, kan du ställa in en global snabbtangent för åtgärden.</para>

</sect3>
</sect2>

<sect2>
<title
>Alarmmeddelandeunderrättelser</title>

<para
>Alarmmeddelanden som visas som underrättelser erbjuder färre funktioner än de som visas i fönster.</para>

<para
>När ett alarmmeddelande ska visas görs det med en underrättelse. Underrättelsen visar tiden då alarmet var schemalagt. Om alarmets schemalagda tid är i en annan tidszon än den lokala datorns inställningar, visas också tidszonen. (För påminnelsemeddelanden, visas datum/tid för huvudalarmet eller dess upprepning, inte påminnelsens tid, och rubriken <quote
>Påminnelse</quote
> visas.)</para>

<para
>Underrättelsen stängs automatiskt efter en kort tidsgräns går ut (observera att tidsgränsen är gemensam för alla program, den kan ändras i systeminställningarna). Efter tidsgränsen har gått ut, kan den fortfarande se i underrättelsehistoriken tills du tar bort den eller loggar ut. Eftersom program inte har något sätt att komma åt underrättelsehistoriken, kan inte &kalarm; ta bort eller ersätta underrättelser i historiken som det skulle göra för alarmfönster. Så historiken kan innehålla flera underrättelser för samma alarm, inklusive påminnelser och upprepningar.</para>

<para
>Alarmmeddelandeunderrättelser erbjuder följande alternativ. Observera att om något alternativ väljes stängs underrättelsen omedelbart, och förhindrar att den visas i underrättelsehistoriken. Observera också att alternativen bara är tillgängliga medan underrättelsen är aktiv, innan tidsgränsen går ut. Vid senare åtkomst av underrättelsen i underrättelsehistoriken är det enda tillgängliga alternativet att ta bort den från historiken, på grund av begränsningar i underrättelsesystemet.</para>

<itemizedlist>
<listitem>
<para
>Bekräfta alarmet genom att klicka på knappen <guibutton
>Stäng</guibutton
>. Det stänger underrättelsen.</para>
</listitem>

<listitem>
<para
>Redigera alarmet genom att klicka på knappen <guibutton
>Redigera</guibutton
>. Det visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>.</para>
</listitem>

<listitem>
<para
>Visa alternativ för att skjuta upp alarmet till senare genom att klicka på knappen <guibutton
>Skjut upp</guibutton
>. Knappen visas bara om det är möjligt att skjuta upp alarmet. Se beskrivningen av uppskjutningsalternativet i avsnittet <link linkend="message-window"
>Alarmmeddelandefönster</link
> för detaljinformation.</para>
</listitem>

<listitem>
<para
>Att klicka på underrättelsen var som helst utom på en knapp aktiverar &kalarm;s huvudfönster med det alarmet markerat.</para>
</listitem>

</itemizedlist>

</sect2>
</sect1>

<sect1 id="system-tray">
<title
>Hantering i systembrickan</title>

<para
>&kalarm; visar normalt en ikon i systembrickan. Ikonen möjliggör både styrning och statusindikering av alarmbevakning. En normal &kalarm;-ikon anger att alarm bevakas, medan två olika ändrade ikoner antingen anger att vissa alarm, eller alla alarm, inte bevakas. Hur ikonerna ändras beror på ikontemat som används.</para>

<para
>&kalarm;s ikon i systembrickan döljs normalt automatiskt så snart det inte finns några alarm som kommer att inträffa inom de följande 24 timmarna. Tidsgränsen för att dölja automatiskt kan ändras, eller alltid visa ikonen i systembrickan, genom att använda <link linkend="preferences-view"
>Inställningsdialogrutan</link
>. För att visa ikonen när den har dolts automatiskt, klicka på pilen i systembrickan för att visa dolda ikoner.</para>

<para
>Om du håller muspekaren över systembrickans ikon, visas en sammanfattning av några av de första alarmmeddelanden som går ut under följande 24 timmar som ett verktygstips. Du kan stänga av funktionen, eller ställa in antalet alarm att visa, och deras format, i <link linkend="preferences-view"
>inställningsdialogrutan</link
>.</para>

<para
><mousebutton
>Vänster</mousebutton
>klicka på ikonen i systembrickan för att välja att visa eller gömma &kalarm;s huvudfönster.</para>

<para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan för att visa den sammanhangsberoende menyn.</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Aktivera alarm</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Aktiverar eller inaktiverar bevakning av alarm.</action
></para>
<para
>Se <link linkend="enable-disable"
>Aktivera och stänga av alarm</link
> för detaljinformation.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Nytt alarm</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>När du har valt alarmtyp i listan som visas, öppnas dialogrutan för alarmredigering för att skapa ett nytt alarm.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Stoppa uppspelning</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Stoppar uppspelning av ljudfilen som för närvarande spelas.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Sprid fönster</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Sprider ut alarm- och felmeddelandefönster över skärmen, eller grupperar dem  tillsammans igen.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Anpassa &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Visar &kalarm;s inställningsdialogruta.</action
></para>
<para
>Inställningsdialogrutan beskrivs under <link linkend="preferences"
>Anpassa &kalarm;</link
>. Den innehåller också alternativ som har att göra med  &kalarm;s ikon i systembrickan.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Återställ/minimera</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Återställer eller minimerar &kalarm;s huvudfönster.</action
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Stänger &kalarm;s ikon i systembrickan och huvudfönster.</action
></para>
<para
>Avslutar &kalarm; om inga fönster med alarmmeddelanden visas.</para>
</listitem>
</varlistentry>
</variablelist>

<sect2>
<title
>Visa &kalarm; i systembrickan</title>

<para
>Du måste köra &plasma;-skrivbordet eller en annan lämplig fönsterhanterare för att kunna visa &kalarm; i systembrickan.</para>

<para
>Välj <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Visa i systembrickan</guimenuitem
></menuchoice
> för att visa &kalarm; i systembrickan enligt inställningarna under fliken <link linkend="preferences-view"
>Visa</link
> i inställningsdialogrutan.</para>

<para
>För att ta bort &kalarm; från systembrickan, avmarkera <menuchoice
> <guimenu
>Visa</guimenu
><guimenuitem
>Visa i systembricka</guimenuitem
></menuchoice
>.</para>

<para
>För att välja om &kalarm; visas eller inte i systembrickan vid start, använd fliken <link linkend="preferences-view"
>Visa</link
> i inställningsdialogrutan.</para>
</sect2>
</sect1>

<sect1 id="refreshing">
<title
>Förnya alarm</title>

<para
>Om den osannolika händelsen att ett alarm inte visas när det skulle ha visats inträffar, kan du uppdatera alarmlistan och visa alla alarm som inte visats, genom att välja <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Förnya alarm</guimenuitem
> </menuchoice
>. Det gör att &kalarm; uppdaterar alla alarmkalendrar.</para>

<para
>Du kan uppdatera en individuell kalender och uppdatera dess alarm i alarmlistan genom att <mousebutton
>höger</mousebutton
>klicka på kalendern i kalenderlistan och välja menyalternativet <menuchoice
><guimenuitem
>Uppdatera</guimenuitem
></menuchoice
>. Se <link linkend="calendars"
>Alarmkalendrar</link
> för detaljinformation.</para>

</sect1>

<sect1 id="enable-disable">
<title
>Aktivera och stänga av alarm</title>

<para
>Alarm kan aktiveras eller stängas av tillsammans eller individuellt:</para>

<itemizedlist>
<listitem>
<para
><quote
>Alarmbevakning</quote
> gäller alarm som helhet. När alarmbevakning är inaktiverad, visas inga alarm överhuvudtaget. När alarmbevakning är aktiverad (det normala tillståndet), visas alla alarm som inte är individuellt inaktiverade vid lämpliga tider.</para>

<para
>När alarmbevakning aktiveras igen, visas nu alarm som skulle ha visats medan den var inaktiverad (om inte något alternativ för att avbryta försenade förhindrar det). Med andra ord, att inaktivera alarmbevakning har samma effekt som att stoppa &kalarm;: alarm fördröjs till den aktiveras igen.</para>
</listitem>

<listitem>
<para
>Alarm kan aktiveras och inaktiveras individuellt, oberoende av status för alarmbevakningen. Aktiveringsstatus för individuella alarm är alltså oförändrad om alarmbevakning inaktiveras och sedan åter aktiveras. I motsats till alarmbevakning som potentiellt skulle kunna inaktiveras på grund av att &kalarm; inte kör, kan bara individuella alarm inaktiveras om du använder menykommandon för att göra det.</para>

<para
>När alarm aktiveras igen individuellt, visas det nu inte om det gick ut medan det var inaktiverat.  Med andra ord, att inaktivera ett individuellt alarm ställer in alla förekomster till det aktiveras igen.</para>

<para
>Ett alarms individuella aktiveringsstatus anges av dess färg i alarmlistan (färgen kan ställas in under fliken <link linkend="preferences-view"
>Visa</link
> i inställningsdialogrutan).</para>
</listitem>
</itemizedlist>

<para
>För att ett alarm ska visas, måste det vara individuellt aktiverat och dessutom måste alarmbevakningen vara aktiverad.</para>

<sect2>
<title
>Aktivera alarmbevakning</title>

<para
>För att alarmbevakning ska ske, måste &kalarm; köra. När du väl har kört &kalarm; startas det automatiskt så snart du loggar in, om du inte senare inaktiverar det under fliken <link linkend="preferences-general"
>Allmänt</link
> i inställningsdialogrutan.</para>

<para
>Om alarmbevakning för närvarande är avstängd, gör något av följande för att aktivera alarm:</para>

<itemizedlist>
<listitem>
<para
>Välj <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Aktivera alarm</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan och välj <menuchoice
><guimenuitem
>Aktivera alarm</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Inaktivera alarmbevakning</title>

<para
>Du kan tillfälligt inaktivera alarmbevakning, vilket förhindrar att &kalarm; kontrollerar ytterligare alarm, antingen till du aktiverar alarm igen, eller - under förutsättning att &kalarm; är inställt att starta vid inloggning - till nästa gång du loggar in.</para>

<itemizedlist>
<listitem>
<para
>Avmarkera <menuchoice
> <guimenu
>Åtgärder</guimenu
><guimenuitem
>Aktivera alarm</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på ikonen i systembrickan och avmarkera <menuchoice
><guimenuitem
>Aktivera alarm</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>

<listitem>
<para
>Kör &kalarm; med kommandoradväljaren <option
>--disable-all</option
>.</para>
</listitem>

<listitem>
<para
>Stoppa &kalarm; som beskrivs i <link linkend="quitting"
>Avsluta &kalarm;</link
>.</para>
</listitem>
</itemizedlist>

<para
>Alarm kan inaktiveras permanent genom att förhindra att &kalarm; startas vid inloggning genom att använda fliken <link linkend="preferences-general"
>Allmänt</link
> i inställningsdialogrutan.</para>

</sect2>

<sect2>
<title
>Aktivera och stänga av individuella alarm</title>

<para
>För att aktivera individuella alarm som för närvarande är avstängda, gör något av följande:</para>

<itemizedlist>
<listitem>
<para
>Välj ett eller flera alarm genom att klicka på deras poster i alarmlistan. Välj sedan <menuchoice
> <guimenu
>Åtgärder</guimenu
> <guimenuitem
>Aktivera</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på önskade poster i alarmlistan och välj <menuchoice
><guimenuitem
>Aktivera</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

<para
>För att stänga av individuella alarm som för närvarande är aktiverade, gör något av följande:</para>

<itemizedlist>
<listitem>
<para
>Välj ett eller flera alarm genom att klicka på deras poster i alarmlistan. Välj sedan <menuchoice
> <guimenu
>Åtgärder</guimenu
> <guimenuitem
>Inaktivera</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Höger</mousebutton
>klicka på önskade poster i alarmlistan och välj <menuchoice
><guimenuitem
>Inaktivera</guimenuitem
></menuchoice
> i den sammanhangsberoende menyn.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="wake-suspend">
<title
>Vakna från viloläge</title>

<para
>Alarm kan konfigureras för att väcka din dator från dvala eller viloläge när alarmet utlöses, så att alarmet kan inträffa även när systemet stängs av. Mekanismen som används av &kalarm; för att väcka systemet, och användargränssnittet för att styra det, beror på typen av system och användarbehörigheter. Det finns två möjligheter:</para>

<sect2>
<title
>Vakna från viloläge med tidtagning i Linux kärna</title>

<para
>På Linux-system, om användaren har möjlighet att använda kärnans alarmtidtagning (<literal
>cap_wake_alarm</literal
>), kan valfritt antal alarm ställas in för att vakna från viloläge. I det här fallet ställs vakna från viloläge in för varje enskilt larm i <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> med alternativet <guilabel 
>Vakna från viloläge</guilabel 
>.</para>

<para
>Du kan ställa in hur lång tid innan alarmet ska vakna från viloläge, för att säkerställa att systemet hinner återställa sig helt innan alarmet utlöses, i <link linkend="preferences-time"
>Inställningsdialogrutan</link
>.</para>

</sect2>

<sect2>
<title
>Vakna från viloläge med realtidsklocka</title>

<para
>På andra system än Linux, eller på Linux där användaren inte har tillgång till <literal
>cap_wake_alarm</literal
>, används realtidsklockan (<acronym
>RTC</acronym
>). Det kan bara ställas in för ett alarm åt gången. I det här fallet används en speciell dialogruta för Vakna från viloläge för att ställa in det. Dialogrutan gör att alarmet för vakna från viloläge kan ställas in, avbrytas eller visas. För att komma åt dialogrutan, välj <menuchoice
><guimenu 
>Åtgärder</guimenu 
> <guimenuitem 
>Vakna från viloläge</guimenuitem
></menuchoice 
>.</para>

<para
>Användning av funktionen Vakna från viloläge kräver administratörsrättigheter. Du kommer att bli tillfrågad om administratörens lösenord när du ställer in eller avbryter ett alarm för att vakna från viloläge.</para>

<note
><para
>Vakna från viloläge stöds inte av vissa datorer, särskilt äldre, och vissa datorer stöder bara inställning av en uppvakningstid upp till 24 timmar framåt. Det kan också finnas begränsningar gällande vilket typ av viloläge som funktionen kan vakna från. Du bör också överväga att använda provalarm för att kontrollera systemets möjligheter innan du förlitar dig på funktionen.</para
></note>

<warning
><para
>Datorn kan bara schemalägga ett enda vakna från viloläge på en gång. Om du använder funktionen med &kalarm; måste du försäkra dig om att det inte orsakar konflikt med något annat program som också använder vakna från viloläge. Så fort ett program schemalägger eller tar bort vakna från viloläge, avbryter det en eventuellt tidigare inställd vakna från viloläge, oberoende om den ställs in av &kalarm; eller av något annat program.</para
></warning>

<para
>Dialogrutan Vakna från viloläge används tillsammans med alarmlistan i &kalarm;s huvudfönster.</para>

<itemizedlist>
<listitem>
<para
><guibutton
>Använd markerat alarm</guibutton
>: Detta ställer in alarmet som för närvarande är markerat i alarmlistan som alarmet för att vakna från viloläge. Ett eventuellt befintligt alarm för att vakna från viloläge avbryts, som förklarades ovan. Knappen är bara aktiverad om exakt ett alarm är markerat.</para>
</listitem>

<listitem>
<para
><guibutton
>Avbryt vakna från viloläge</guibutton
>: Detta avbryter ett eventuellt befintligt alarm för att vakna från viloläge (vare sig det har ställts in av &kalarm; eller något annat program - se ovan). Observera att det bara avbryter uppvakningsfunktionen kopplad till alarmet. Själva alarmet tas inte bort och fortsätter att fungera normalt.</para>
</listitem>

<listitem>
<para
><guibutton
>Visa aktuellt alarm</guibutton
>: Detta markera det nuvarande alarmet för att vakna från viloläge i alarmlistan, så att den kan identifieras. Knappen är inaktiverad om det inte finns något vakna från viloläge inställt för närvarande.</para>
</listitem>

<listitem>
<para
><guilabel
>Antal minuter innan alarmet att vakna från viloläge</guilabel
> låter dig försäkra att systemet har tid att återställas helt och hållet innan alarmet inträffar, om du så önskar, så att alarmet kan inträffa rätt tid.</para>
</listitem>
</itemizedlist>

</sect2>
</sect1>

<sect1 id="quitting">
<title
>Att avsluta &kalarm;</title>

<para
>Avsluta &kalarm; genom att välja <menuchoice
><guimenu
>Arkiv</guimenu
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
> eller <menuchoice
><guimenuitem
>Avsluta</guimenuitem
></menuchoice
> i systembrickans sammanhangsberoende meny. Som alternativ, om ikonen i systembrickan inte är synlig, stäng alla fönster i &kalarm;.</para>

</sect1>
</chapter>

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

<para
>För att ställa in &kalarm;s funktion att passa systemet och dina personliga önskemål, välj <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &kalarm;...</guimenuitem
> </menuchoice
>. Då visas inställningsdialogrutan.</para>

<sect1 id="preferences-general">
<title
>Allmänt</title>

<para
>Sidan <guilabel
>Allmänt</guilabel
> låter dig styra &kalarm;s övergripande beteende.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Start vid inloggning</guilabel
>: &kalarm; startas automatiskt vid inloggning till en session, vilket försäkrar att &kalarm; alltid kör, om du inte avslutar det för hand.</para>

<warning
><para
>Det här alternativet bör alltid vara markerat, om du inte avser att sluta använda &kalarm;.</para
></warning>

<note
><para
>Alternativet markeras automatiskt igen så fort &kalarm; körs. Om du alltså har avmarkerat alternativet och vill fortsätta förhindra att &kalarm; körs vid inloggning, måste du avmarkera alternativet igen varje gång du kör &kalarm;.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Varna innan avslutning</guilabel
>: Om alarm stängs av då &kalarm; inte kör, och det här alternativet är markerat, blir du tillfrågad om att bekräftelse om du försöker avsluta &kalarm; med alternativet <menuchoice
><guimenu
>Avsluta</guimenu
></menuchoice
> i systembrickans ikon. Det förhindrar avstängning av alarm av misstag. Av säkerhetsskäl aktiveras det här alternativet automatiskt igen, så fort du byter körläge.</para>
</listitem>

<listitem
><para
><guilabel
>Aktivera alarmnamn</guilabel
>: Ange om alla alarm kan ges namn för att hjälpa dig identifiera dem. De bestämmer om kolumnen <guilabel
>Namn</guilabel
> visas i <link linkend="alarm-list"
>alarmlistan</link
>, och om fältet <guilabel
>Alarmnamn</guilabel
> visas i <link linkend="alarm-edit-dlg"
>Alarmredigeringsdialogrutan</link
>.</para>
</listitem>

<listitem
><para
><guilabel
>Bekräfta borttagning av alarm</guilabel
>: Ange om du ska bli tillfrågad om bekräftelse varje gång du tar bort ett alarm.</para>
</listitem>

<listitem
><para
><guilabel
>Förvalt tidsintervall för uppskjutning</guilabel
>: Ange förvalt tidsintervall, i timmar och minuter, att visa från början när dialogrutan Skjut upp alarm visas. Observera att om ett alarm tidigare har skjutits upp, är intervallet som visas från början i dialogrutan Skjut upp alarm lika med uppskjutningsintervallet som användes den senaste gången alarmet sköts upp.</para>
</listitem>

<listitem
><para
><guilabel
>Terminal för kommandoalarm</guilabel
>: Här kan du välja vilken typ av terminalfönster som ska användas för kommandoalarm som körs i ett terminalfönster. Några av de vanligaste programmen för terminalfönster är förinställda, t.ex. <application
>xterm</application
> och &konsole;, även om bara de som är installerade på ditt system visas här. Du kan titta på de verkliga kommandoväljarna som används för varje program genom att använda den sammanhangsberoende hjälpen för dess alternativknapp.</para>

<para
>Om du vill använda ett annat program, eller vill använda något av de angivna, men med andra kommandoradsväljare, markera <guilabel
>Annat</guilabel
> och skriv in kommandot för att starta terminalfönstret. Normalt läggs alarmets kommandosträng till efter det du anger. Som ett alternativ kan du ange var alarmets kommandosträng ska infogas, genom att använda följande koder:</para>

<variablelist>
<varlistentry>
<term
>%c</term>
<listitem>
<para
>Alarmets kommandosträng ersätter detta.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%w</term>
<listitem>
<para
>Alarmets kommandosträng ersätter detta, med <literal
>sleep</literal
> tillagt sist.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%C</term>
<listitem>
<para
>En tillfällig kommandofil som innehåller alarmets kommandosträng skapas, och kommandot att köra filen ersätter detta.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%W</term>
<listitem>
<para
>En tillfällig kommandofil som innehåller alarmets kommandosträng skapas med <literal
>sleep</literal
> tillagt sist, och kommandot att köra filen ersätter detta.</para>
</listitem>
</varlistentry>
<varlistentry>
<term
>%t</term>
<listitem>
<para
>&kalarm;s namn på aktuellt språk ersätter detta.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>När kommandoalarmet inträffar, citeras kommandosträngen innan den infogas i terminalfönstrets kommando.</para>
</listitem>

<listitem
><para
><guilabel
>Aktivera Akonadi</guilabel
>: Välj om &akonadi; ska användas för att tillhandahålla funktioner som beror på det. Se <link linkend="akonadi-plugin"
>Akonadi insticksprogram</link
> för detaljerad information. Observera att alternativet bara visas om Akonadi-insticksprogrammet är installerat.</para>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-time">
<title
>Tid och datum</title>

<para
><guilabel
>Tid och datum</guilabel
> låter dig välja alternativ relaterade till tid och datum:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Tidszon</guilabel
>: Välj tidszon. &kalarm; använder tidszonen överallt, utom när du överskrider den för enskilda alarm.</para>
</listitem>

<listitem
><para
><guilabel
>Helgområde</guilabel
>: Välj vilket lands eller regions helger som ska användas. Det påverkar upprepade alarm där alternativet att undanta helger är valt.</para>
</listitem>

<listitem
><para
><guilabel
>Vakna från viloläge innan alarm</guilabel
>: Ange antalet minuter innan alarmet utlöses för att väcka systemet, för alarm som är inställda på att vakna från viloläge. Det gör att du kan säkerställa att systemet hinner återställa sig helt innan alarmet utlöses, så att alarmet kan utlösas vid rätt tidpunkt. Alternativet visas endast om systeminställningen tillåter flera alarm att väcka systemet från viloläge. Se <link linkend="wake-suspend"
>Vakna från viloläge</link
> för mer information.</para>
</listitem>

<listitem
><para
><guilabel
>Dagens början för alarm som bara gäller datum</guilabel
>: Ange tiden då dagen börjar för att kunna visa alarm som bara gäller ett datum, dvs. de där alternativet <guilabel
>När som helst</guilabel
> valdes. På datumet då de inträffar, visas sådana alarm vid det tidigast möjliga tillfälle under 24 timmar från tiden då dagen börjar.</para>
</listitem>

<listitem
><para
>Rutan <guilabel
>Arbetstid</guilabel
>: Alternativen låter dig definiera din arbetstid, som behövs när alternativet <guilabel
>Bara under arbetstid</guilabel
> väljes för en upprepning i <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>.</para>

<itemizedlist>
<listitem
><para
>Markera alla dagar som är arbetsdagar.</para>
</listitem>

<listitem
><para
><guilabel
>Daglig starttid</guilabel
>: Ange tiden du börjar arbetet varje dag.</para>
</listitem>

<listitem
><para
><guilabel
>Daglig sluttid</guilabel
>: Ange tiden du slutar arbetet.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Händelsens varaktighet i Korganizer</guilabel
>: Ange händelsens varaktighet att ställa in i &korganizer; för alarm som kopieras till &korganizer;. Den normala varaktigheten är noll.</para>
</listitem>

</itemizedlist>
</sect1>

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

<para
><guilabel
>Lagring</guilabel
> låter dig välja alternativ för att spara och arkivera alarm:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Nya alarm och mallar</guilabel
>: Ange vilken kalender som ska användas för att lagra nya alarm och alarmmallar när flera alarmkalendrar används:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Lagra i förvald kalender</guilabel
>: Nya alarm och alarmmallar läggs automatiskt till i den förvalda alarmkalendern utan att fråga efter bekräftelse.</para>
</listitem>

<listitem>
<para
><guilabel
>Fråga efter vilken kalender att lagra i</guilabel
>: När du skapar ett nytt alarm eller en ny alarmmall och det finns mer än en skrivbar alarmkalender, blir du tillfrågad om att välja vilken kalender som ska användas för lagring. Observera att när alarm sparas efter de har gått ut, lagras de alltid i förvald alarmkalender för arkivering utan att fråga.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Rutan <guilabel
>Arkiverade alarm</guilabel
>: Alternativen styr lagring av arkiverade alarm i den förvalda alarmkalendern för arkiverade alarm.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Behåll alarm efter de gått ut</guilabel
>: Markera alternativet för att arkivera utgångna och borttagna alarm. Avmarkera det för att inte behålla någon information om alarm när de väl slutar att vara aktiva. Observera att borttagna alarm bara arkiveras om de tidigare har visats. Om du tar bort ett alarm innan det någonsin har visats, kastas det.</para>
</listitem>

<listitem
><para
><guilabel
>Kasta utgångna alarm efter</guilabel
>: Ställer in antal dagar att lagra utgångna och borttagna alarm i arkivet. Därefter tas de bort permanent.</para>
</listitem>

<listitem
><para
><guibutton
>Rensa arkiverade alarm</guibutton
>: Den här knappen rensar alla alarm som för närvarande är arkiverade från den förvalda kalendern för arkiverade alarm. (Andra kalendrar för arkiverade alarm lämnas oförändrade, ifall de delas med andra användare.) Knappen har ingen effekt för alarm som senare går ut eller tas bort. De fortsätter att arkiveras enligt inställda alternativ.</para>
</listitem>
</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-email">
<title
>E-post</title>

<para
>Sidan <guilabel
>E-post</guilabel
> låter dig välja alternativ för sändning och adressering av e-postalarm:</para>

<note
><para
>Alternativ som beror på &kmail; är bara tillgängliga om &kalarm;s <link linkend="akonadi-plugin"
>Akonadi insticksprogram</link
> är installerat och aktiverat.</para>
</note>

<itemizedlist>
<listitem>
<para
><guilabel
>E-postprogram</guilabel
>: Anger e-postprogrammet som ska användas för att skicka e-postalarm:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Kmail</guilabel
>: När ett e-postalarm inträffar, skickas e-post automatiskt med &kmail;.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: När ett e-postalarm inträffar, skickas e-post automatiskt med &Sendmail;. Alternativet fungerar bara om systemet är inställt för att använda &Sendmail; eller ett program som fungerar som &Sendmail; till exempel <application
>postfix</application
> eller <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Kopiera skickad e-post till &kmail;s korg "skickat"</guilabel
>: Markera det här alternativet om du vill att en kopia av det skickade brevet ska lagras i &kmail;s korg <filename
>skickat</filename
>, så fort ett e-postalarm inträffar.</para>

<note
><para
>Det här alternativet är inte tillgängligt om &kmail; väljes som e-postprogram eftersom &kmail; gör det automatiskt.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>Meddela när e-post till annan dator läggs i kö</guilabel
>: Markera alternativet för att visa ett meddelande så fort ett e-postalarm köar e-post för att skicka till en annan dator. Det kan vara användbart om du till exempel har en uppringd förbindelse, eller om e-post köas i &kmail;s <filename
>utkorg</filename
>, så att du kan försäkra dig om att du gör vad som än behövs för att verkligen skicka e-posten.</para>
</listitem>

<listitem>
<para
>Välj din e-postadress att använda som avsändarens adress i e-postalarm:</para>

<itemizedlist>
<listitem
><para
>Välj <guilabel
>Från</guilabel
> för att skriva in en e-postadress.</para>
</listitem>

<listitem
><para
>Välj <guilabel
>Använd förvald identitet i Kmail</guilabel
> för att använda förvald e-postadress som är inställd i &kmail;.</para>
</listitem>

<listitem
><para
>Välj <guilabel
>Använd identiteter i &kmail;</guilabel
> för att kunna välja vilken av &kmail;s e-postadresser som ska användas när ett e-postalarm ställs in. &kmail;s förvalda identitet används för alarm som redan ställts in innan alternativet markerades.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Välj din e-postadress som ska användas för att skicka dolda kopior av e-postalarm till dig själv när alternativet <guilabel
>Kopiera e-post till mig själv</guilabel
> är markerat:</para>

<itemizedlist>
<listitem
><para
>Välj <guilabel
>Dold kopia</guilabel
> för att skriva in en e-postadress. Om dolda kopior ska skickas till ditt konto på datorn där &kalarm; kör, kan du helt enkelt skriva in ditt inloggningsnamn här.</para>
</listitem>

<listitem
><para
>Välj <guilabel
>Använd förvald identitet i Kmail</guilabel
> för att använda förvald e-postadress som är inställd i &kmail;.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

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

<para
>Sidan <guilabel
>Visa</guilabel
> låter dig styra några aspekter rörande &kalarm;s utseende. Under fliken <guilabel
>Allmänt</guilabel
>:</para>
<itemizedlist>

<listitem>
<para
>Grupprutan <guilabel
>Visa i systembrickan</guilabel
>: Om markerad, visas ikonen i systembrickan medan &kalarm; kör, i enlighet med valt alternativ:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Visa alltid</guilabel
>: Ikonen i systembrickan visas alltid.</para>
</listitem>

<listitem>
<para
><guilabel
>Dölj automatiskt om inga aktiva alarm</guilabel
>: Ikonen i systembrickan är dold om det inte finns några aktiva alarm.</para>
</listitem>

<listitem>
<para
><guilabel
>Dölj automatiskt om inget alarm inträffar inom tidsperioden</guilabel
>: Ikonen i systembrickan är dold om inga alarm kommer att inträffa inom den angivna tidsperioden, med början från nu.</para>
</listitem>
</itemizedlist>

<para
>När systembrickan döljs automatiskt, kan du visa den med användning av systembrickans alternativ för att visa dolda ikoner.</para>

<para
>När <guilabel
>Visa i systembrickan</guilabel
> är markerad och ikonen i systembrickan stängs, stängs alla huvudfönster i &kalarm;, och om inga meddelandefönster är synliga, avslutas programmet.</para>
</listitem>

<listitem>
<para
>Rutan <guilabel
>Verktygstips i systembrickan</guilabel
>: De här alternativen styr vilken information som visas i verktygstipsen som visas när muspekaren hålls över &kalarm;s ikon i systembrickan.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Visa alarm för följande 24 timmar</guilabel
>: Om markerad, visas en sammanfattning av de första alarm som går ut under följande 24 timmar.</para>
</listitem>

<listitem>
<para
><guilabel
>Maximalt antal alarm att visa</guilabel
>: Avmarkera det här alternativet för visa alla alarm för de följande 24 timmarna. Markera det för att ange det maximala antalet larm som kommer att visas.</para>
</listitem>

<listitem>
<para
><guilabel
>Visa alarmtid</guilabel
>: Markera det här alternativet för att visa tiden då varje alarm är schemalagt.</para>
</listitem>

<listitem>
<para
><guilabel
>Visa tid till alarm</guilabel
>: Markera alternativet för att visa hur lång tid som är kvar till varje alarms nästa schemalagda aktivering. Tiden visas i timmar och minuter.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Prefix</guilabel
>: Ange en symbol eller text att visa framför hur lång tid som är kvar till alarmet, för att skilja den från tiden då alarmet är schemalagt.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Rutan <guilabel
>Alarmlista</guilabel
> gör det möjligt att välja färger som används av alarmlistan i &kalarm;s huvudfönster, för att visa inaktiverade och arkiverade alarm.</para>
</listitem>
</itemizedlist>

<para
>Fliken <guilabel
>Alarmfönster</guilabel
> innehåller alternativ för att styra utseendet hos fönster för alarmmeddelanden.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Placera fönster långt från muspekaren</guilabel
>: Välj alternativet för att visa fönster med alarmmeddelanden så långt bort från muspekarens aktuella position som möjligt. Det minimerar risken att bekräfta ett alarm av misstag genom att klicka på en knapp utan avsikt precis när fönstret med alarmmeddelandet dyker upp.</para>
</listitem>

<listitem>
<para
><guilabel
>Centrera fönster, med fördröjd aktivering av fönsterknappar</guilabel
>: Välj alternativet för att visa fönster med alarmmeddelanden mitt på skärmen. För att minimera risken att bekräfta ett alarm av misstag, är fönstrets knappar inaktiverade från början. Fördröjningen i sekunder innan de blir aktiva, ställs in med <guilabel
>Fördröjning vid aktivering av knappar (sekunder)</guilabel
>.</para>
</listitem>

<listitem>
<para
><guilabel
>Meddelandefönster har namnlist och tar tangentbordsfokus</guilabel
>: Alternativet styr om alarmmeddelandefönster får tangentbordsfokus när de visas. Se avsnittet <link linkend="message-display"
>Alarmmeddelandevisning</link
> för detaljinformation.</para>
</listitem>
</itemizedlist>
</sect1>

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

<para
>Sidan <guilabel
>Redigera</guilabel
> låter dig ange förvalda värden för alternativ i <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
>:</para>

<itemizedlist>
<listitem
><para
>Fliken <guilabel
>Allmänt</guilabel
> innehåller alternativ som gäller alla typer av alarm.</para>

<itemizedlist>
<listitem
><para
>Ange förvald metod för visning av alarmmeddelanden.</para>
</listitem>

<listitem
><para
>Ange förvalda värden för kryssrutorna <guilabel
>Visa i Korganizer</guilabel
> och <guilabel
>Hoppa över om sent</guilabel
>.</para>
</listitem>

<listitem
><para
>Ange förvald typ för upprepade meddelanden.</para>
</listitem>

<listitem
><para
>Välj standardhantering för årliga upprepningar för 29:e februari under år som inte är skottår.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Fliken <guilabel
>Alarmtyper</guilabel
> innehåller alternativ som gäller specifika typer av alarm.</para>

<itemizedlist>
<listitem>
<para
>För visade alarm:</para>

<itemizedlist>
<listitem
><para
>Ange förvalda värden för kryssrutorna <guilabel
>Stäng fönstret automatiskt efter den här tiden</guilabel
> och <guilabel
>Bekräfta igen</guilabel
>.</para>
</listitem>

<listitem
><para
>Ange förvald period för upprepade meddelanden.</para>
</listitem>

<listitem
><para
>Ange förvalda särskilda visningsåtgärder för alarm.</para>
</listitem>

<listitem
><para
>Ställ in förvalda ljudalternativ. Observera att en förvald ljudfil kan anges även om ljudtypen inte är inställd till <guilabel
>Ljudfil</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>För kommandoalarm:</para>

<itemizedlist>
<listitem
><para
>Ange förvalda värden för kryssrutorna <guilabel
>Ange ett skript</guilabel
> och <guilabel
>Kör i terminalfönster</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>För e-postalarm:</para>

<itemizedlist>
<listitem
><para
>Ställ in förvalt tillstånd för kryssrutan <guilabel
>Kopiera e-post till mig själv</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
>Fliken <guilabel
>Teckensnitt och färg</guilabel
> låter dig ställa in förvalt utseende för alarmmeddelanden. Välj deras normala teckensnitt samt förgrunds- och bakgrundsfärger.</para>
</listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="cmdline-operation">
<title
>Kommandoradsväljare</title>

<para
>När kommandoradsväljare anges, visar inte &kalarm; listan med schemalagda alarm som beskrivs ovan under <link linkend="using-kalarm"
>Använda &kalarm;</link
>. Speciella kommandoradsväljare för &kalarm; kan användas för att utföra följande operationer:</para>

<itemizedlist>
<listitem
><para
>schemalägg ett nytt alarm</para>
</listitem>
<listitem
><para
>styr &kalarm;s visningsläge</para>
</listitem>
<listitem
><para
>skaffa hjälp</para>
</listitem>
</itemizedlist>

<para
>Ytterligare kommandoradsväljare är tillgängliga främst för att låta andra program arbeta ihop med &kalarm;. De beskrivs i kapitlet <link linkend="cmdline-interface"
>Utvecklingsguide för &kalarm;</link
>.</para>

<para
>Kommandoraden får bara innehålla väljare för en &kalarm; operation. Om du vill utföra flera operationer, måste du anropa &kalarm; flera gånger, med en enda uppsättning väljare varje gång.</para>

<sect1 id="cmdline-schedule">
<title
>Schemalägg ett nytt alarm</title>

<para
>Följande väljare används för att schemalägga ett nytt alarm:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Alternativ</entry>
  <entry
>Beskrivning</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Fråga en extra gång när du bekräftar alarmet.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>webbadress</replaceable
></option
></entry>
  <entry
>Ange namnet eller webbadressen för en fil som ska bifogas e-post. Väljaren kan upprepas efter behov. <option
>--mail</option
> måste anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>--auto-close</option
></entry>
  <entry
>Stäng automatiskt alarmfönstret efter perioden <option
>--late-cancel</option
> har gått ut. <option
>--late-cancel</option
> måste anges med den här välljaren.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Avge ett hörbart ljud när meddelandet visas. <option
>--speak</option
>, <option
>--play</option
> och <option
>--play-repeat</option
> kan inte anges med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Skicka en dold kopia av e-posten till dig själv. <option
>--mail</option
> måste anges med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>färg</replaceable
></option
></entry>
  <entry
>Visa meddelandet med bakgrundsfärgen enligt det angivna &Qt;-färgnamnet eller hexadecimala koden 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>färg</replaceable
></option
></entry>
  <entry
>Visa meddelandet med förgrundsfärgen enligt det angivna &Qt;-färgnamnet eller hexadecimala koden 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-d</option
>, <option
>--disable</option
></entry>
  <entry
>Stäng av alarmet. Det  visas inte förrän det har aktiverats manuellt.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Inaktivera bevakning av alarm. Det förhindrar alla alarm från att visas till alarm aktiveras igen eller &kalarm; startas om, t.ex. vid nästa inloggning. <option
>--triggerEvent</option
> kan inte anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>kommandorad</replaceable
></option
></entry>
  <entry
>Anger ett skalkommando som ska köras. Om angiven, så måste den här väljaren vara den sista väljaren på &kalarm;s kommandorad. Alla efterföljande kommandoradsväljare tolkas som om de utgör kommandoraden som ska köras. <option
>--file</option
> och <option
>--mail</option
> kan inte anges tillsammans med den här väljaren. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> och <option
>--colorfg</option
> ignoreras med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-E</option
>, <option
>--exec-display <replaceable
>kommandorad</replaceable
></option
></entry>
  <entry
>Anger ett skalkommando som ska köras för att skapa alarmmeddelandets text. Om angiven, så måste den här väljaren vara den sista väljaren på &kalarm;s kommandorad. Alla efterföljande kommandoradsväljare tolkas som om de utgör kommandoraden som ska köras. <option
>--exec</option
>, <option
>--file</option
> och <option
>--mail</option
> kan inte anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>webbadress</replaceable
></option
></entry>
  <entry
>Ange namnet eller webbadressen för en text- eller bildfil vars innehåll ska användas som alarmmeddelande. <option
>--exec</option
>, <option
>--exec-display</option
> och <option
>--mail</option
> kan inte anges, och <replaceable
>meddelande</replaceable
> får inte finnas med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-F</option
>, <option
>--from-id <replaceable
>identifikation</replaceable
></option
></entry>
  <entry
>Använd angiven &kmail;-identitet som avsändare av brevet. <option
>--mail</option
> måste anges med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>period</replaceable
></option
></entry>
  <entry
>Ange intervallet mellan upprepningar av alarmet. Timmar/minuter anges med formatet <replaceable
>nHnM</replaceable
>, där <replaceable
>n</replaceable
> är ett tal, t.ex. 3H30M. Andra tidsperioder anges på formatet <replaceable
>nX</replaceable
>, där <replaceable
>n</replaceable
> är ett tal och <replaceable
>X</replaceable
> är en av följande bokstäver: Y (år), M (månader), W (veckor), D (dagar). Om <option
>--recurrence</option
> också anges, tillåts inte Y (år) och M (månader). Krävs om <option
>--repeat</option
> eller <option
>--until</option
> anges.</entry>
</row>
<row>
  <entry
><option
>-k</option
>, <option
>--korganizer</option
></entry>
  <entry
>Visa alarmet som en händelse i &korganizer;s aktiva kalender.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel <replaceable
>period</replaceable
></option
></entry>
  <entry
>Avbryt alarmet om det inte kan visas inom angiven <replaceable
>period</replaceable
> efter den riktiga tiden. Timmar/minuter anges med formatet <replaceable
>nHnM</replaceable
>, där <replaceable
>n</replaceable
> är ett tal, t.ex. 3H30M. Andra tidsperioder anges på formatet <replaceable
>nX</replaceable
>, där <replaceable
>n</replaceable
> är ett tal och <replaceable
>X</replaceable
> är en av följande bokstäver: W (veckor) eller D (dagar). Standardvärdet för <replaceable
>period</replaceable
> är 1 minut.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Visa alarmet varje gång då loggar in. <option
>--interval</option
>, <option
>--repeat</option
> och <option
>--until</option
> kan inte anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>adress</replaceable
></option
></entry>
  <entry
>Skicka e-post till angiven adress. Alternativet kan upprepas om nödvändigt. <option
>--exec</option
>, <option
>--exec-display</option
> och <option
>--file</option
> kan inte anges tillsammans med den här väljaren. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> och <option
>--colorfg</option
> ignoreras med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-n</option
>, <option
>--name</option
></entry>
  <entry
>Ange ett namn för att hjälpa dig identifiera alarmet.</entry>
</row>
<row>
  <entry
><option
>-N</option
>, <option
>--notify</option
></entry>
  <entry
>Visa alarmet som en underrättelse. <option
>--color</option
>, <option
>--colorfg</option
>, <option
>--play</option
>, <option
>--ack-confirm</option
> och <option
>--auto-close</option
> kan inte anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-p</option
>, <option
>--play <replaceable
>webbadress</replaceable
></option
></entry>
  <entry
>Ange namnet eller webbadressen för en ljudfil som ska spelas en gång, antingen som ett ljudalarm eller när alarmmeddelandet visas. <option
>--play-repeat</option
>, <option
>--beep</option
> och <option
>--speak</option
> kan inte anges med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-P</option
>, <option
>--play-repeat <replaceable
>webbadress</replaceable
></option
></entry>
  <entry
>Ange namnet eller webbadressen för en ljudfil som ska spelas upprepade gånger, antingen till <guilabel
>Stoppa uppspelning</guilabel
> används, eller medan alarmmeddelandet visas. <option
>--play</option
>, <option
>--beep</option
> och <option
>--speak</option
> kan inte anges med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Ställ in att alarmet ska upprepas. Ange upprepningsintervall med iCalendar-syntax (definierad av <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>), t.ex. <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. <option
>--until</option
> kan inte anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>antal</replaceable
></option
></entry>
  <entry
>Ställer in antal gånger alarmet ska visas, eller om en upprepning anges med <option
>--recurrence</option
>, antal gånger alarmet ska visas varje gång <option
>--recurrence</option
> aktiverar det (dvs. en repetition inom en upprepning). Om <option
>--recurrence</option
> inte finns med, kan -1 anges för att repetera alarmet i oändlighet. <option
>--interval</option
> måste, och <option
>--until</option
> kan inte, anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>period</replaceable
></option
></entry>
  <entry
>Visa ett påminnelsealarm angiven tid innan eller efter huvudalarmet och var och en av dess upprepningar (om det finns några). <replaceable
>period</replaceable
> anges med samma format som beskrivs för <replaceable
>--late-cancel</replaceable
>. Normalt visas påminnelsen innan alarmet. För ange en påminnelse efter alarmet, inled <replaceable
>period</replaceable
> med <replaceable
>+</replaceable
>, t.ex. +3D. Den här väljaren kan inte anges med <option
>--exec</option
>, <option
>--mail</option
> eller <option
>--reminder-once</option
>.</entry>
</row>
<row>
  <entry
><option
>--reminder-once <replaceable
>period</replaceable
></option
></entry>
  <entry
>Visa ett påminnelsealarm en gång den angivna tidsrymden innan eller efter den första upprepningen av alarmet. Ingen påminnelse visas innan eller efter efterföljande upprepningar (om det finns några). <replaceable
>period</replaceable
> anges i samma format som beskrivs för <option
>--reminder</option
>. Väljaren kan inte anges med <option
>--exec</option
>, <option
>--mail</option
> eller <option
>--reminder</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--speak</option
></entry>
  <entry
>Läs upp meddelandet när det visas. Alternativet kräver att &kalarm; byggdes med tal aktiverat och att modulen &Qt; Speech är installerad och fungerar. <option
>--beep</option
>, <option
>--play</option
> och <option
>--play-repeat</option
> kan inte anges med den här väljaren.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>ämne</replaceable
></option
></entry>
  <entry
>E-postens rubrik. <option
>--mail</option
> måste anges med den här väljaren.</entry>
</row>
<!-- test-set-time time (debug mode)-->
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>datum/tid</replaceable
></option
></entry>
  <entry
>Visa alarmet det datum eller det datum och den tid som anges. Ange ett datum utan tid med formatet <replaceable
>åååå-mm-dd[ TZ]</replaceable
>. Ange ett datum och en tid med <replaceable
>[[[åååå-]mm-]dd-]tt:mm[ TZ]</replaceable
> (när det utelämnas får datumkomponenterna dagens datum). Om ingen tidszon anges, används systemets lokala tidszon. Om en tidszonangivelse <replaceable
>TZ</replaceable
> finns med, kan det vara namnet på en systemtidszon (t.ex. <userinput
>Europe/London</userinput
>) eller <userinput
>UTC</userinput
> som representerar tidszonen UTC.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--volume <replaceable
>procenttal</replaceable
></option
></entry>
  <entry
>Ställ in ljudvolym för att spela ljudfilen. Väljaren kan bara anges när <option
>--play</option
> eller <option
>--play-repeat</option
> anges.</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>datum/tid</replaceable
></option
></entry>
  <entry
>Upprepa alarmet till det datum eller datum/tid som anges. Ange ett datum eller ett datum och en tid med samma format som för <option
>--time</option
>. Observera att om <option
>--time</option
> anges, hämtas tidszonen från dess värde, och någon tidszon kan inte ingå i värdet för <option
>--until</option
>. <option
>--interval</option
> måste anges, och <option
>--repeat</option
> eller <option
>--recurrence</option
> kan inte anges tillsammans med den här väljaren.</entry>
</row>
<row>
  <entry
><replaceable
>meddelande</replaceable
></entry>
  <entry
>Meddelandetext som ska visas, eller om <option
>--mail</option
> anges, meddelandetexten i e-posten.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Antingen en meddelandetext, <option
>--file</option
>, <option
>--exec</option
>, <option
>--exec-display</option
>, <option
>--play</option
> eller <option
>--play-repeat</option
> måste anges. Utom enligt vad som anges ovan är alla väljare valfria.</para>

<para
>Två olika exempel som visar ett meddelande med flera rader, med röd bakgrund vid klockan 20:00 den 27:de innevarande månad, är:</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
>"Kom ihåg att \nSTOPPA"</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
>"Kom ihåg att\nSTOPPA"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect1>

<sect1 id="cmdline-other">
<title
>Andra alternativ</title>

<para
>Följande alternativ används för att utföra diverse funktioner, inklusive visa <link linkend="alarm-edit-dlg"
>Dialogrutan för alarmredigering</link
>.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Alternativ</entry>
  <entry
>Beskrivning</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--edit <replaceable
>händelse-ID</replaceable
></option
></entry>
  <entry
>Visar alarmredigeringsdialogrutan för att redigera alarmet med angivet händelse-ID. En händelse-ID är händelsens unika ID, valfritt inledd med konfigurationsnamnet eller numeriskt ID för resursen som innehåller händelsen på formatet <replaceable
>[resurs-ID:]händelse-ID</replaceable
>.</entry>
</row>
<row>
  <entry
><option
>--edit-new-audio</option
></entry>
  <entry
>Visar dialogrutan för alarmredigering för att redigera ett nytt ljudalarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-command</option
></entry>
  <entry
>Visar dialogrutan för alarmredigering för att redigera ett nytt kommandoalarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-display</option
></entry>
  <entry
>Visar dialogrutan för alarmredigering för att redigera ett nytt visat alarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-email</option
></entry>
  <entry
>Visar dialogrutan för alarmredigering för att redigera ett nytt e-postalarm.</entry>
</row>
<row>
  <entry
><option
>--edit-new-preset <replaceable
>mallnamn</replaceable
></option
></entry>
  <entry
>Visar dialogrutan för alarmredigering förinställd med alarmmallen med angivet namn, för att redigera ett nytt alarm.</entry>
</row>
<row>
  <entry
><option
>--list</option
></entry>
  <entry
>Mata ut en lista över schemalagda alarm till <filename
>standardutmatningen</filename
>. Listan visas kortfattad information om varje pågående alarm: dess resursidentifierare, UID, nästa schemalagda tid och meddelandetext eller fil.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Visar &kalarm; som en ikon i systembrickan.</entry>
</row>
<row>
  <entry
><option
>--disable-all</option
></entry>
  <entry
>Inaktivera bevakning av alla alarm.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Se också:</para>
<simplelist>
<member
>kf5options(7)</member>
<member
>qt5options(7)</member>
</simplelist>

</sect1>

</chapter>

<chapter id="developers">
<title
>Utvecklingsguide för &kalarm;</title>

<para
>&kalarm; tillhandahåller ett gränssnitt som låter andra program begära följande funktioner:</para>

<itemizedlist>
<listitem
><para
>schemalägg ett nytt alarm</para
></listitem>
<listitem
><para
>avbryt ett redan schemalagt alarm</para
></listitem>
<listitem
><para
>aktivera ett redan schemalagt alarm</para
></listitem>
<listitem
><para
>visa dialogrutan för alarmredigering</para
></listitem>
<listitem
><para
>Lista schemalagda alarm</para
></listitem>
</itemizedlist>

<para
>Var och en av de ovannämnda funktionerna implementeras både som ett &DBus; anrop och via kommandoraden. D-Bus anrop är att föredra om &kalarm; redan kör.</para>

<sect1 id="dbus-interface">
<title
>&DBus; gränssnitt</title>

<para
>&DBus; anropen som beskrivs i det här dokumentet är alla implementerade i &kalarm;s &DBus; objektsökväg <constant
>/kalarm</constant
>. Gränssnittet är definierat i filerna <filename
>org.kde.kalarm.kalarm.xml</filename
> och <filename
>kalarmiface.h</filename
>.</para>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>avbryt ett redan schemalagt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>händelse-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>händelse-ID</parameter
></term>
<listitem>
<para
>Anger unikt ID för händelsen som ska avbrytas, valfritt inledd med konfigurationsnamnet eller numeriskt ID för resursen som innehåller händelsen på formatet <replaceable
>[resurs-ID:]händelse-ID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>cancelEvent()</function
> är ett &DBus; anrop för att avbryta det angivna alarmet. &kalarm; tar bort alarmet från kalendern utan att visa eller köra det.</para>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>aktivera ett redan schemalagt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>händelse-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>händelse-ID</parameter
></term>
<listitem>
<para
>Anger unikt ID för händelsen som ska utlösas, valfritt inledd med konfigurationsnamnet eller numeriskt ID för resursen som innehåller händelsen på formatet <replaceable
>[resurs-ID:]händelse-ID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>triggerEvent()</function
> är ett &DBus; anrop för att aktivera omedelbar visning eller körning av det angivna alarmet (oberoende av vilken tid det är schemalagt). &kalarm; hämtar alarmet från kalendern och visar det eller kör det.</para>

<para
>Om alarmet redan ska aktiveras, tar &kalarm; sedan bort alla schemalagda händelser för alarmet fram till nuvarande tid, och om inga upprepningar av alarmet fortfarande finns kvar, så tas alarmet bort från kalendern. Om alarmet inte ska aktiveras ännu, så lämnas dess schemalagda händelser oförändrade.</para>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>schemalägg ett nytt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>namn</replaceable
>,
                     const QString&amp; <replaceable
>meddelande</replaceable
>,
                     const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                     int <replaceable
>avbryt_försenat</replaceable
>,
                     int <replaceable
>flaggor</replaceable
>, 
                     const QString&amp; <replaceable
>bg</replaceable
>, 
                     const QString&amp; <replaceable
>fg</replaceable
>, 
                     const QString&amp; <replaceable
>teckensnitt</replaceable
>, 
                     const KUrl&amp; <replaceable
>ljudadress</replaceable
>, 
                     int <replaceable
>påminnelse</replaceable
>, 
                     const QString&amp; <replaceable
>upprepning</replaceable
>,
                     int <replaceable
>delrepetition_intervall</replaceable
>, 
                     int <replaceable
>delrepetition_antal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>namn</replaceable
>,
                     const QString&amp; <replaceable
>meddelande</replaceable
>, 
                     const QString&amp; <replaceable
>startdatum_tid</replaceable
>, 
                     int <replaceable
>avbryt_försenat</replaceable
>, int <replaceable
>flaggor</replaceable
>, 
                     const QString&amp; <replaceable
>bg</replaceable
>, 
                     const QString&amp; <replaceable
>fg</replaceable
>, 
                     const QString&amp; <replaceable
>teckensnitt</replaceable
>, 
                     const KUrl&amp; <replaceable
>ljudadress</replaceable
>, 
                     int <replaceable
>påminnelse</replaceable
>, 
                     int <replaceable
>upprepningstyp</replaceable
>, 
                     int <replaceable
>upprepningsintervall</replaceable
>, 
                     int <replaceable
>upprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>namn</replaceable
>,
                     const QString&amp; <replaceable
>meddelande</replaceable
>, 
                     const QString&amp; <replaceable
>startdatum_tid</replaceable
>, 
                     int <replaceable
>avbryt_försenat</replaceable
>, 
                     int <replaceable
>flaggor</replaceable
>, 
                     const QString&amp; <replaceable
>bg</replaceable
>, 
                     const QString&amp; <replaceable
>fg</replaceable
>, 
                     const QString&amp; <replaceable
>teckensnitt</replaceable
>, 
                     const KUrl&amp; <replaceable
>ljudadress</replaceable
>, 
                     int <replaceable
>påminnelse</replaceable
>, 
                     int <replaceable
>upprepningstyp</replaceable
>, 
                     int <replaceable
>upprepningsintervall</replaceable
>, 
                     const QString&amp; <replaceable
>slut_datum_tid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>namn</parameter
></term>
<listitem>
<para
>Anger ett valfritt namn på alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>meddelande</parameter
></term>
<listitem>
<para
>Anger texten i meddelandet att schemalägga, eller om <parameter
>flaggor</parameter
> har biten <userinput
>DISPLAY_COMMAND</userinput
>, anger kommandoraden att köra för att skapa texten i meddelandet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startdatum_tid</parameter
></term>
<listitem>
<para
>Anger schemalagt datum, eller datum och tid, då meddelandet ska visas. Strängen ska vara på formatet <replaceable
>ÅÅÅÅ-MM-DD[ TZ]</replaceable
> för ett alarm med bara datum (som returneras av <methodname
>QDate::toString(Qt::ISODate)</methodname
>). För ett alarm med ett datum och en tid, ska strängen vara på formatet <replaceable
>ÅÅÅÅ-MM-DDTTT:MM[:SS][ TZ]</replaceable
> (som returneras av <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) eller <replaceable
>TT:MM[:SS]</replaceable
> (som returneras av <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Om inget datum anges, används dagens datum. Observera att ett eventuellt sekundvärde ignoreras.</para>

<para
>Om någon tidszon inte anges, förutsätts att den lokala systemtidszonen ska användas. Om en tidszonangivelse <replaceable
>TZ</replaceable
> finns med, kan det vara namnet på en systemtidszon (t.ex. <userinput
>Europe/London</userinput
>) eller <userinput
>UTC</userinput
> som representerar tidszonen UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>avbryt_försenat</parameter
></term>
<listitem>
<para
>Gör att alarmet avbryts om det inte kan visas inom angivet antal minuter efter alarmets schemalagda tid. Om värdet är 0, avbryts inte alarmet oberoende av hur sent det visas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flaggor</parameter
></term>
<listitem>
<para
>Anger logiskt eller av de önskade alarmflaggorna. Flaggbitarna är definierade i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Observera att alla flaggbitar inte gäller meddelandealarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bg</parameter
></term>
<listitem>
<para
>Anger bakgrundsfärg för att visa meddelandet. Formatet på strängen kan vara <quote
>#RRGGBB</quote
> (som returneras av <methodname
>QColor::name()</methodname
>), där RR, GG och BB är tvåsiffrors hexadecimala värden för röd, grön och blå. Alternativt kan strängen vara något av de andra format som accepteras av <methodname
>QColor::setNamedColor()</methodname
>, såsom ett namn från X-färgdatabasen (t.ex. <quote
>red</quote
> eller <quote
>steelblue</quote
>). Ange strängens värde som null för att välja aktuell förvald bakgrundsfärg.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fg</parameter
></term>
<listitem>
<para
>Anger förgrundsfärg för att visa meddelandet. Formatet på strängen är samma som för <parameter
>bg</parameter
>, eller alternativt kan strängens värde anges som null för att välja aktuell förvald förgrundsfärg.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>teckensnitt</parameter
></term>
<listitem>
<para
>Anger teckensnittet för att visa meddelandet. Strängens format är det som skrivs ut med <methodname
>QFont::toString()</methodname
>. Ange strängens värde som null för att använda förvalt teckensnitt för meddelanden som gäller vid tiden då meddelandet visas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ljudadress</parameter
></term>
<listitem>
<para
>Anger ljudfilen som ska spelas när meddelandet visas. Ange värdet null om ingen ljudfil ska spelas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>påminnelse_minuter</parameter
></term>
<listitem>
<para
>Anger antal minuter i förväg innan huvudalarmet och varje upprepning (om det finns någon) som påminnelsen ska visas. Ange ett negativt värde för en påminnelse som ska visas efter huvudalarmet. Ange 0 om ingen påminnelse krävs.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepning</parameter
></term>
<listitem>
<para
>Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Till exempel skulle <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningstyp</parameter
></term>
<listitem>
<para
>Anger alarmets upprepningstyp. Tillåtna värden är MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Dessa definieras i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Månatliga upprepningar är av typen dagen under månaden, och årliga upprepningar är av typen datum under året, där datumet i båda fall tas från väljaren <parameter
>startdatum_tid</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsintervall</parameter
></term>
<listitem>
<para
>Anger antal perioder (minuter/dagar/veckor/månader/år som anges av <parameter
>upprepningstyp</parameter
>) mellan upprepningar av alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsantal</parameter
></term>
<listitem>
<para
>Anger antalet gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>slut_datum_tid</parameter
></term>
<listitem>
<para
>Anger slutdatum, eller datum och tid, för alarmets upprepningar. Om <parameter
>startdatum_tid</parameter
> innehåller en tid, måste den här väljaren också innehålla en tid. Om <parameter
>startdatum_tid</parameter
> bara innehåller ett datum, måste den här väljaren också bara innehålla ett datum. Den får inte innehålla en specifikation av tidzon: samma tidzon som i <parameter
>startdatum_tid</parameter
> används för att tolka parameterns värde.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_intervall</parameter
></term>
<listitem>
<para
>Anger antalet minuter mellan delrepetitioner av alarmet. Ange 0 för ingen delrepetition. Ignoreras om ingen upprepning är angiven.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_antal</parameter
></term>
<listitem>
<para
>Anger antalet delrepetitioner av alarmet, inklusive ursprunglig aktivering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beskrivning</title>
<para
><function
>scheduleMessage()</function
> är ett &DBus; anrop för att schemalägga det angivna alarmmeddelandet för visning vid det angivna datumet och tiden. Det har tre former. De mest generella formen tillåter att en godtycklig upprepning anges. Använd den också för alarm som inte upprepas. De övriga formerna tillhandahåller bekväm åtkomst till en begränsad mängd upprepningstyper, den ena anger ett upprepningsantal och den andra en sluttid.</para>

<para
>Om den schemalagda tiden (inklusive eventuella upprepningar) redan har gått ut, visar  &kalarm; omedelbart meddelandet (om inte värdet <parameter
>avbryt_försenat</parameter
> anger att det nu är för sent att visa alarmet, då &kalarm; ignorerar begäran). Om den schemalagda tiden (eller en upprepning) är i framtiden, lägger &kalarm; till alarmmeddelandet i den förvalda aktiva alarmkalendern för att visas senare.</para>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>schemalägg ett nytt alarm som visar innehållet i en text- eller bildfil.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>namn</replaceable
>,
                  const KUrl&amp; <replaceable
>webbadress</replaceable
>,
                  const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                  int <replaceable
>avbryt_försenat</replaceable
>,
                  int <replaceable
>flaggor</replaceable
>,
                  const QString&amp; <replaceable
>bg</replaceable
>,
                  const KUrl&amp; <replaceable
>ljudadress</replaceable
>,
                  int <replaceable
>påminnelse</replaceable
>,
                  const QString&amp; <replaceable
>upprepning</replaceable
>,
                  int <replaceable
>delrepetition_intervall</replaceable
>, 
                  int <replaceable
>delrepetition_antal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>namn</replaceable
>,
                  const KUrl&amp; <replaceable
>webbadress</replaceable
>,
                  const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                  int <replaceable
>avbryt_försenat</replaceable
>,
                  int <replaceable
>flaggor</replaceable
>,
                  const QString&amp; <replaceable
>bg</replaceable
>,
                  const KUrl&amp; <replaceable
>ljudadress</replaceable
>,
                  int <replaceable
>påminnelse</replaceable
>,
                  int <replaceable
>upprepningstyp</replaceable
>,
                  int <replaceable
>upprepningsintervall</replaceable
>,
                  int <replaceable
>upprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>namn</replaceable
>,
                  const KUrl&amp; <replaceable
>webbadress</replaceable
>,
                  const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                  int <replaceable
>avbryt_försenat</replaceable
>,
                  int <replaceable
>flaggor</replaceable
>,
                  const QString&amp; <replaceable
>bg</replaceable
>,
                  const KUrl&amp; <replaceable
>ljudadress</replaceable
>,
                  int <replaceable
>påminnelse</replaceable
>,
                  int <replaceable
>upprepningstyp</replaceable
>,
                  int <replaceable
>upprepningsintervall</replaceable
>,
                  const QString&amp; <replaceable
>slut_datum_tid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>namn</parameter
></term>
<listitem>
<para
>Anger ett valfritt namn på alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>webbadress</parameter
></term>
<listitem>
<para
>Anger text- eller bildfilen vars innehåll ska visas i meddelandet som schemaläggs.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startdatum_tid</parameter
></term>
<listitem>
<para
>Anger schemalagt datum, eller datum och tid, då meddelandet ska visas. Strängen ska vara på formatet <replaceable
>ÅÅÅÅ-MM-DD[ TZ]</replaceable
> för ett alarm med bara datum (som returneras av <methodname
>QDate::toString(Qt::ISODate)</methodname
>). För ett alarm med ett datum och en tid, ska strängen vara på formatet <replaceable
>ÅÅÅÅ-MM-DDTTT:MM[:SS][ TZ]</replaceable
> (som returneras av <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) eller <replaceable
>TT:MM[:SS]</replaceable
> (som returneras av <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Om inget datum anges, används dagens datum. Observera att ett eventuellt sekundvärde ignoreras.</para>

<para
>Om någon tidszon inte anges, förutsätts att den lokala systemtidszonen ska användas. Om en tidszonangivelse <replaceable
>TZ</replaceable
> finns med, kan det vara namnet på en systemtidszon (t.ex. <userinput
>Europe/London</userinput
>) eller <userinput
>UTC</userinput
> som representerar tidszonen UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>avbryt_försenat</parameter
></term>
<listitem>
<para
>Gör att alarmet avbryts om det inte kan visas inom angivet antal minuter efter alarmets schemalagda tid. Om värdet är 0, avbryts inte alarmet oberoende av hur sent det visas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flaggor</parameter
></term>
<listitem>
<para
>Anger logiskt eller av de önskade alarmflaggorna. Flaggbitarna är definierade i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Observera att alla flaggbitar inte gäller filalarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bg</parameter
></term>
<listitem>
<para
>Anger bakgrundsfärg för att visa filen. Formatet på strängen kan vara <quote
>#RRGGBB</quote
> (som returneras av <methodname
>QColor::name()</methodname
>), där RR, GG och BB är tvåsiffrors hexadecimala värden för röd, grön och blå. Alternativt kan strängen vara något av de andra format som accepteras av <methodname
>QColor::setNamedColor()</methodname
>, såsom ett namn från X-färgdatabasen (t.ex. <quote
>red</quote
> eller <quote
>steelblue</quote
>). Ange strängens värde som null för att välja aktuell förvald bakgrundsfärg.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ljudadress</parameter
></term>
<listitem>
<para
>Anger ljudfilen som ska spelas när meddelandet visas. Ange värdet null om ingen ljudfil ska spelas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>påminnelse_minuter</parameter
></term>
<listitem>
<para
>Anger antal minuter i förväg innan huvudalarmet och varje upprepning (om det finns någon) som påminnelsen ska visas. Ange ett negativt värde för en påminnelse som ska visas efter huvudalarmet. Ange 0 om ingen påminnelse krävs.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepning</parameter
></term>
<listitem>
<para
>Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Till exempel skulle <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningstyp</parameter
></term>
<listitem>
<para
>Anger alarmets upprepningstyp. Tillåtna värden är MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Dessa definieras i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Månatliga upprepningar är av typen dagen under månaden, och årliga upprepningar är av typen datum under året, där datumet i båda fall tas från väljaren <parameter
>startdatum_tid</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsintervall</parameter
></term>
<listitem>
<para
>Anger antal perioder (minuter/dagar/veckor/månader/år som anges av <parameter
>upprepningstyp</parameter
>) mellan upprepningar av alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsantal</parameter
></term>
<listitem>
<para
>Anger antalet gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>slut_datum_tid</parameter
></term>
<listitem>
<para
>Anger slutdatum, eller datum och tid, för alarmets upprepningar. Om <parameter
>startdatum_tid</parameter
> innehåller en tid, måste den här väljaren också innehålla en tid. Om <parameter
>startdatum_tid</parameter
> bara innehåller ett datum, måste den här väljaren också bara innehålla ett datum. Den får inte innehålla en specifikation av tidzon: samma tidzon som i <parameter
>startdatum_tid</parameter
> används för att tolka parameterns värde.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_intervall</parameter
></term>
<listitem>
<para
>Anger antalet minuter mellan delrepetitioner av alarmet. Ange 0 för ingen delrepetition. Ignoreras om ingen upprepning är angiven.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_antal</parameter
></term>
<listitem>
<para
>Anger antalet delrepetitioner av alarmet, inklusive ursprunglig aktivering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>
<para
><function
>scheduleFile()</function
> är ett &DBus; anrop för att schemalägga en angiven text- eller bildfil för visning vid det angivna datumet och tiden. Förutom att ange ett filnamn eller webbadress, och utelämna färg och teckensnitt, är användningen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivningen av den funktionen för ytterligare detaljer.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>schemalägg ett nytt alarm som kör ett skalkommando.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>ljudwebbadress</replaceable
>,
                   int <replaceable
>volymprocent</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   unsigned <replaceable
>flaggor</replaceable
>,
                   const QString&amp; <replaceable
>upprepning</replaceable
>,
                   int <replaceable
>delupprepningsintervall</replaceable
>, 
                   int <replaceable
>delupprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>ljudwebbadress</replaceable
>,
                   int <replaceable
>volymprocent</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   unsigned <replaceable
>flaggor</replaceable
>,
                   int <replaceable
>upprepningstyp</replaceable
>,
                   int <replaceable
>upprepningsintervall</replaceable
>,
                   int <replaceable
>upprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>ljudwebbadress</replaceable
>,
                   int <replaceable
>volymprocent</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   unsigned <replaceable
>flaggor</replaceable
>,
                   int <replaceable
>upprepningstyp</replaceable
>,
                   int <replaceable
>upprepningsintervall</replaceable
>,
                   const QString&amp; <replaceable
>slutdatum_tid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>namn</parameter
></term>
<listitem>
<para
>Anger ett valfritt namn på alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>kommandorad</parameter
></term>
<listitem>
<para
>Anger kommandot vars körning ska schemaläggas. Väljaren<parameter
>flags</parameter
> anger om väljaren innehåller en skalkommandorad eller ett kommandoskript.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startdatum_tid</parameter
></term>
<listitem>
<para
>Anger schemalagt datum, eller datum och tid, då meddelandet ska visas. Strängen ska vara på formatet <replaceable
>ÅÅÅÅ-MM-DD[ TZ]</replaceable
> för ett alarm med bara datum (som returneras av <methodname
>QDate::toString(Qt::ISODate)</methodname
>). För ett alarm med ett datum och en tid, ska strängen vara på formatet <replaceable
>ÅÅÅÅ-MM-DDTTT:MM[:SS][ TZ]</replaceable
> (som returneras av <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) eller <replaceable
>TT:MM[:SS]</replaceable
> (som returneras av <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Om inget datum anges, används dagens datum. Observera att ett eventuellt sekundvärde ignoreras.</para>

<para
>Om någon tidszon inte anges, förutsätts att den lokala systemtidszonen ska användas. Om en tidszonangivelse <replaceable
>TZ</replaceable
> finns med, kan det vara namnet på en systemtidszon (t.ex. <userinput
>Europe/London</userinput
>) eller <userinput
>UTC</userinput
> som representerar tidszonen UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>avbryt_försenat</parameter
></term>
<listitem>
<para
>Gör att alarmet avbryts om det inte kan visas inom angivet antal minuter efter alarmets schemalagda tid. Om värdet är 0, avbryts inte alarmet oberoende av hur sent det visas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flaggor</parameter
></term>
<listitem>
<para
>Anger logiskt eller av de önskade alarmflaggorna. Flaggbitarna är definierade i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Observera att alla flaggbitar inte gäller kommandoalarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepning</parameter
></term>
<listitem>
<para
>Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Till exempel skulle <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningstyp</parameter
></term>
<listitem>
<para
>Anger alarmets upprepningstyp. Tillåtna värden är MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Dessa definieras i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Månatliga upprepningar är av typen dagen under månaden, och årliga upprepningar är av typen datum under året, där datumet i båda fall tas från väljaren <parameter
>startdatum_tid</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsintervall</parameter
></term>
<listitem>
<para
>Anger antal perioder (minuter/dagar/veckor/månader/år som anges av <parameter
>upprepningstyp</parameter
>) mellan upprepningar av alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsantal</parameter
></term>
<listitem>
<para
>Anger antalet gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>slut_datum_tid</parameter
></term>
<listitem>
<para
>Anger slutdatum, eller datum och tid, för alarmets upprepningar. Om <parameter
>startdatum_tid</parameter
> innehåller en tid, måste den här väljaren också innehålla en tid. Om <parameter
>startdatum_tid</parameter
> bara innehåller ett datum, måste den här väljaren också bara innehålla ett datum. Den får inte innehålla en specifikation av tidzon: samma tidzon som i <parameter
>startdatum_tid</parameter
> används för att tolka parameterns värde.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_intervall</parameter
></term>
<listitem>
<para
>Anger antalet minuter mellan delrepetitioner av alarmet. Ange 0 för ingen delrepetition. Ignoreras om ingen upprepning är angiven.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_antal</parameter
></term>
<listitem>
<para
>Anger antalet delrepetitioner av alarmet, inklusive ursprunglig aktivering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>
<para
><function
>scheduleCommand()</function
> är ett &DBus; anrop för att schemalägga en angiven skalkommandorad, eller kommandoskript, för körning vid det angivna datumet och tiden. Förutom att ange ett kommando och utelämna meddelandets färg, teckensnitt och ljudfil, är användningen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivningen av den funktionen för ytterligare detaljer.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>schemalägg ett nytt alarm som skickar e-post.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>från_id</replaceable
>,
                   const QString&amp; <replaceable
>adresser</replaceable
>,
                   const QString&amp; <replaceable
>rubrik</replaceable
>,
                   const QString&amp; <replaceable
>meddelande</replaceable
>,
                   const QString&amp; <replaceable
>bilagor</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   int <replaceable
>flaggor</replaceable
>,
                   const QString&amp; <replaceable
>upprepning</replaceable
>,
                   int <replaceable
>delrepetition_intervall</replaceable
>, 
                   int <replaceable
>delrepetition_antal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>från_id</replaceable
>,
                   const QString&amp; <replaceable
>adresser</replaceable
>,
                   const QString&amp; <replaceable
>rubrik</replaceable
>,
                   const QString&amp; <replaceable
>meddelande</replaceable
>,
                   const QString&amp; <replaceable
>bilagor</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   int <replaceable
>flaggor</replaceable
>,
                   int <replaceable
>upprepningstyp</replaceable
>,
                   int <replaceable
>upprepningsintervall</replaceable
>,
                   int <replaceable
>upprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>från_id</replaceable
>,
                   const QString&amp; <replaceable
>adresser</replaceable
>,
                   const QString&amp; <replaceable
>rubrik</replaceable
>,
                   const QString&amp; <replaceable
>meddelande</replaceable
>,
                   const QString&amp; <replaceable
>bilagor</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>, 
                   nt <replaceable
>flaggor</replaceable
>,
                   int <replaceable
>upprepningstyp</replaceable
>,
                   int <replaceable
>upprepningsintervall</replaceable
>,
                   const QString&amp; <replaceable
>sluttid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>namn</parameter
></term>
<listitem>
<para
>Anger ett valfritt namn på alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>från_id</parameter
></term>
<listitem>
<para
>Identiteten i &kmail; som ska användas som brevets avsändare. Om tom blir avsändarens e-postadress den som är inställd i &kalarm;s <link linkend="preferences-email"
>E-postinställningar</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>adresser</parameter
></term>
<listitem>
<para
>En lista av mottagarnas e-postadresser åtskilda med kommatecken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>rubrik</parameter
></term>
<listitem>
<para
>Anger e-postens rubrikrad.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>meddelande</parameter
></term>
<listitem>
<para
>Anger e-postens meddelandetext.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bilagor</parameter
></term>
<listitem>
<para
>En lista med sökvägar eller webbadresser för filer som ska skickas som e-postbilagor, åtskilda med kommatecken.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startdatum_tid</parameter
></term>
<listitem>
<para
>Anger schemalagt datum, eller datum och tid, då meddelandet ska visas. Strängen ska vara på formatet <replaceable
>ÅÅÅÅ-MM-DD[ TZ]</replaceable
> för ett alarm med bara datum (som returneras av <methodname
>QDate::toString(Qt::ISODate)</methodname
>). För ett alarm med ett datum och en tid, ska strängen vara på formatet <replaceable
>ÅÅÅÅ-MM-DDTTT:MM[:SS][ TZ]</replaceable
> (som returneras av <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) eller <replaceable
>TT:MM[:SS]</replaceable
> (som returneras av <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Om inget datum anges, används dagens datum. Observera att ett eventuellt sekundvärde ignoreras.</para>

<para
>Om någon tidszon inte anges, förutsätts att den lokala systemtidszonen ska användas. Om en tidszonangivelse <replaceable
>TZ</replaceable
> finns med, kan det vara namnet på en systemtidszon (t.ex. <userinput
>Europe/London</userinput
>) eller <userinput
>UTC</userinput
> som representerar tidszonen UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>avbryt_försenat</parameter
></term>
<listitem>
<para
>Gör att alarmet avbryts om det inte kan visas inom angivet antal minuter efter alarmets schemalagda tid. Om värdet är 0, avbryts inte alarmet oberoende av hur sent det visas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flaggor</parameter
></term>
<listitem>
<para
>Anger logiskt eller av de önskade alarmflaggorna. Flaggbitarna är definierade i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Observera att alla flaggbitar inte gäller e-postalarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepning</parameter
></term>
<listitem>
<para
>Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Till exempel skulle <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningstyp</parameter
></term>
<listitem>
<para
>Anger alarmets upprepningstyp. Tillåtna värden är MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Dessa definieras i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Månatliga upprepningar är av typen dagen under månaden, och årliga upprepningar är av typen datum under året, där datumet i båda fall tas från väljaren <parameter
>startdatum_tid</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsintervall</parameter
></term>
<listitem>
<para
>Anger antal perioder (minuter/dagar/veckor/månader/år som anges av <parameter
>upprepningstyp</parameter
>) mellan upprepningar av alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsantal</parameter
></term>
<listitem>
<para
>Anger antalet gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>slut_datum_tid</parameter
></term>
<listitem>
<para
>Anger slutdatum, eller datum och tid, för alarmets upprepningar. Om <parameter
>startdatum_tid</parameter
> innehåller en tid, måste den här väljaren också innehålla en tid. Om <parameter
>startdatum_tid</parameter
> bara innehåller ett datum, måste den här väljaren också bara innehålla ett datum. Den får inte innehålla en specifikation av tidzon: samma tidzon som i <parameter
>startdatum_tid</parameter
> används för att tolka parameterns värde.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_intervall</parameter
></term>
<listitem>
<para
>Anger antalet minuter mellan delrepetitioner av alarmet. Ange 0 för ingen delrepetition. Ignoreras om ingen upprepning är angiven.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_antal</parameter
></term>
<listitem>
<para
>Anger antalet delrepetitioner av alarmet, inklusive ursprunglig aktivering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>
<para
><function
>scheduleEmail()</function
> är ett &DBus; anrop för att schemalägga att skicka e-post vid det angivna datumet och tiden. Förutom att ange en e-postrubrik och innehåll, och utelämna meddelandets färg, teckensnitt och ljudfil, är användningen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivningen av den funktionen för ytterligare detaljer.</para>
</refsect1>
</refentry>


<refentry id="scheduleAudio">
<refmeta>
<refentrytitle
>scheduleAudio</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleAudio</refname>
<refpurpose
>schemalägg ett nytt alarm som kör ett skalkommando.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>ljudwebbadress</replaceable
>,
                   int <replaceable
>volymprocent</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   unsigned <replaceable
>flaggor</replaceable
>,
                   const QString&amp; <replaceable
>upprepning</replaceable
>,
                   int <replaceable
>delupprepningsintervall</replaceable
>, 
                   int <replaceable
>delupprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>ljudwebbadress</replaceable
>,
                   int <replaceable
>volymprocent</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   unsigned <replaceable
>flaggor</replaceable
>,
                   int <replaceable
>upprepningstyp</replaceable
>,
                   int <replaceable
>upprepningsintervall</replaceable
>,
                   int <replaceable
>upprepningsantal</replaceable
>)
</synopsis>
<synopsis
>bool scheduleAudio(const QString&amp; <replaceable
>namn</replaceable
>,
                   const QString&amp; <replaceable
>ljudwebbadress</replaceable
>,
                   int <replaceable
>volymprocent</replaceable
>,
                   const QString&amp; <replaceable
>startdatum_tid</replaceable
>,
                   int <replaceable
>avbryt_försenat</replaceable
>,
                   unsigned <replaceable
>flaggor</replaceable
>,
                   int <replaceable
>upprepningstyp</replaceable
>,
                   int <replaceable
>upprepningsintervall</replaceable
>,
                   const QString&amp; <replaceable
>slutdatum_tid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>namn</parameter
></term>
<listitem>
<para
>Anger ett valfritt namn på alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>ljudadress</parameter
></term>
<listitem>
<para
>Anger ljudfilen som ska spelas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>volumePercent</parameter
></term>
<listitem>
<para
>Anger volymnivå att använda, som procent av maximal volym. Ange -1 för att använda normalvolym.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>startdatum_tid</parameter
></term>
<listitem>
<para
>Anger schemalagt datum, eller datum och tid, då meddelandet ska visas. Strängen ska vara på formatet <replaceable
>ÅÅÅÅ-MM-DD[ TZ]</replaceable
> för ett alarm med bara datum (som returneras av <methodname
>QDate::toString(Qt::ISODate)</methodname
>). För ett alarm med ett datum och en tid, ska strängen vara på formatet <replaceable
>ÅÅÅÅ-MM-DDTTT:MM[:SS][ TZ]</replaceable
> (som returneras av <methodname
>QDateTime::toString(Qt::ISODate)</methodname
>) eller <replaceable
>TT:MM[:SS]</replaceable
> (som returneras av <methodname
>QTime::toString(Qt::ISODate)</methodname
>). Om inget datum anges, används dagens datum. Observera att ett eventuellt sekundvärde ignoreras.</para>

<para
>Om någon tidszon inte anges, förutsätts att den lokala systemtidszonen ska användas. Om en tidszonangivelse <replaceable
>TZ</replaceable
> finns med, kan det vara namnet på en systemtidszon (t.ex. <userinput
>Europe/London</userinput
>) eller <userinput
>UTC</userinput
> som representerar tidszonen UTC.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>avbryt_försenat</parameter
></term>
<listitem>
<para
>Gör att alarmet avbryts om det inte kan visas inom angivet antal minuter efter alarmets schemalagda tid. Om värdet är 0, avbryts inte alarmet oberoende av hur sent det visas.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flaggor</parameter
></term>
<listitem>
<para
>Anger logiskt eller av de önskade alarmflaggorna. Flaggbitarna är definierade i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Observera att alla flaggbitar inte gäller kommandoalarm.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepning</parameter
></term>
<listitem>
<para
>Anger en regelbunden upprepning av alarmet, med iCalendar-syntax som definieras av <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445</ulink
>. Till exempel skulle <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> ange fyra upprepningar med tremånadersintervall den sista måndagen i månaden. För ett alarm som inte ska upprepas, ange en tom sträng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningstyp</parameter
></term>
<listitem>
<para
>Anger alarmets upprepningstyp. Tillåtna värden är MINUTELY, DAILY, WEEKLY, MONTHLY, YEARLY. Dessa definieras i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>. Månatliga upprepningar är av typen dagen under månaden, och årliga upprepningar är av typen datum under året, där datumet i båda fall tas från väljaren <parameter
>startdatum_tid</parameter
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsintervall</parameter
></term>
<listitem>
<para
>Anger antal perioder (minuter/dagar/veckor/månader/år som anges av <parameter
>upprepningstyp</parameter
>) mellan upprepningar av alarmet.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>upprepningsantal</parameter
></term>
<listitem>
<para
>Anger antalet gånger som alarmet ska upprepas. Ange -1 för att upprepa alarmet för evigt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>slut_datum_tid</parameter
></term>
<listitem>
<para
>Anger slutdatum, eller datum och tid, för alarmets upprepningar. Om <parameter
>startdatum_tid</parameter
> innehåller en tid, måste den här väljaren också innehålla en tid. Om <parameter
>startdatum_tid</parameter
> bara innehåller ett datum, måste den här väljaren också bara innehålla ett datum. Den får inte innehålla en specifikation av tidzon: samma tidzon som i <parameter
>startdatum_tid</parameter
> används för att tolka parameterns värde.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_intervall</parameter
></term>
<listitem>
<para
>Anger antalet minuter mellan delrepetitioner av alarmet. Ange 0 för ingen delrepetition. Ignoreras om ingen upprepning är angiven.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>delrepetition_antal</parameter
></term>
<listitem>
<para
>Anger antalet delrepetitioner av alarmet, inklusive ursprunglig aktivering.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>
<para
><function
>scheduleAudio()</function
> är ett &DBus; anrop för att schemalägga att spela angiven ljudfil vid det angivna datumet och tiden. Förutom att ange volymen, och utelämna meddelandets färg och teckensnitt, är användningen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivningen av den funktionen för ytterligare detaljer.</para>
</refsect1>
</refentry>

<refentry id="dbus_edit">
<refmeta>
<refentrytitle
>edit</refentrytitle>
</refmeta>
<refnamediv>
<refname
>edit</refname>
<refpurpose
>Visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> för att redigera ett alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool edit(const QString&amp; <replaceable
>händelse-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>händelse-ID</parameter
></term>
<listitem>
<para
>Anger unikt ID för händelsen som ska redigeras, valfritt inledd med konfigurationsnamnet eller numeriskt ID för resursen som innehåller händelsen på formatet <replaceable
>[resurs-ID:]händelse-ID</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Returvärde</title>
<para
><returnvalue
>falskt</returnvalue
> om det angivna alarmet inte kunde hittas eller är skrivskyddat, annars <returnvalue
>sant</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>edit()</function
> är ett &DBus; anrop för att visa <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> för att redigera det angivna alarmet.</para>

</refsect1>
</refentry>

<refentry id="dbus_editnew">
<refmeta>
<refentrytitle
>editNew</refentrytitle>
</refmeta>
<refnamediv>
<refname
>editNew</refname>
<refpurpose
>Visar <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> för att redigera ett nytt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool editNew(int <replaceable
>typ</replaceable
>)
</synopsis>
<synopsis
>bool editNew(const QString&amp; <replaceable
>mallnamn</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametrar</title>
<variablelist>
<varlistentry>
<term
><parameter
>typ</parameter
></term>
<listitem>
<para
>Anger alarmtypen. Tillåtna värden är DISPLAY, COMMAND, EMAIL, AUDIO. De definieras i klassen <classname
>KAlarmIface</classname
> i <filename
>kalarmiface.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>mallnamn</parameter
></term>
<listitem>
<para
>Anger namnet på en alarmmall som det nya alarmet ska baseras på.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>

<refsect2>
<title
>Returvärde</title>
<para
><returnvalue
>falskt</returnvalue
> om <parameter
>typ</parameter
> har ett ogiltigt värde, eller om ingen mall med namnet <parameter
>mallnamn</parameter
> kan hittas, annars <returnvalue
>sant</returnvalue
>.</para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>editNew()</function
> är ett &DBus; anrop för att visa <link linkend="alarm-edit-dlg"
>dialogrutan för alarmredigering</link
> för att redigera ett nytt alarm. Om en alarmtyp anges som parameter, visas en tom dialogruta. Annars, om namnet på en alarmmall anges som parameter, är dialogrutan förinställd med information från mallen.</para>

</refsect1>
</refentry>

<refentry id="dbus_list">
<refmeta>
<refentrytitle
>list</refentrytitle>
</refmeta>
<refnamediv>
<refname
>list</refname>
<refpurpose
>Returnera en lista över schemalagda alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>QString list()
</synopsis>

<refsect2>
<title
>Returvärde</title>
<para
>Lista över alarm, åtskilda av nyrader, vart och ett med formatet  <returnvalue
><replaceable
>resurs_id</replaceable
>:<replaceable
>UID</replaceable
> <replaceable
>tid</replaceable
> <replaceable
>text</replaceable
></returnvalue
></para>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivning</title>

<para
><function
>list()</function
> är ett &DBus;-anrop för att returnera en sträng som innehåller en sammanfattning av schemalagda alarm. Listan visas kortfattad information om varje pågående alarm: dess resursidentifierare, UID, nästa schemalagda tid och meddelandetext eller fil.</para>

</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Kommandoradsgränssnitt</title>

<para
>Kommandoradsväljare tillhandahålls för att göra det möjligt för andra program att starta &kalarm; om det inte redan kör, för att visa eller avbryta schemalagda meddelanden, eller schemalägga nya meddelanden. Orsaken att kommandoradsväljare används för detta syfte är att om &kalarm; startades utan kommandoradsväljare och &DBus; anrop sedan skickades, skulle det starta i det förvalda grafiska läget, vilket helt klart inte är önskvärt för en begäran mellan program.</para>

<note
><para
>Program bör först kontrollera om &kalarm; redan kör. Om detta är fallet, bör de istället använda &DBus; anrop för att begära de här åtgärderna.</para
></note>

<para
>Kommandoradsväljarna för att schemalägga ett nytt alarm beskrivs i kapitlet <link linkend="cmdline-operation"
>Kommandoradsväljare</link
>. Alternativen för att visa och avbryta schemalagda alarm är följande:</para>

<note
><para
>Normala användare kan också, om de så önskar, använda de här kommandoradsväljarna (med antagandet att de kan ange den nödvändiga väljarinformationen).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Alternativ</entry>
  <entry
>Beskrivning</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--cancelEvent <replaceable
>händelse-ID</replaceable
></option
></entry>
  <entry
>Avbryt alarmet med angivet händelse-ID. En händelse-ID är händelsens unika ID, valfritt inledd med ID för resursen som innehåller händelsen på formatet <replaceable
>[resurs-ID:]händelse-ID</replaceable
>. Åtgärden som utförs är samma som för &DBus;-anropet <link linkend="cancelEvent"
>cancelEvent()</link
>. Det går inte att att ange <option
>--triggerEvent</option
> tillsammans med väljaren.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>händelse-ID</replaceable
></option
></entry>
  <entry
>Utlös alarmet med angivet händelse-ID. En händelse-ID är händelsens unika ID, valfritt inledd med ID för resursen som innehåller händelsen på formatet <replaceable
>[resurs-ID:]händelse-ID</replaceable
>. Åtgärden som utförs är samma som för &DBus;-anropet <link linkend="triggerEvent"
>triggerEvent()</link
>. Det går inte att att ange <option
>--cancelEvent</option
> tillsammans med väljaren.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Några exempel:</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
>Vanliga frågor</title>

<qandaset id="faqlist">
<qandaentry>
<question>
<para
>Vilka inställningsfiler använder &kalarm;?</para>
</question>
<answer>
<para
>&kalarm;s inställning finns i följande filer i katalogen <command
>qtpaths --paths GenericConfigLocation</command
>:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarmrc</filename
> innehåller dina inställningar av &kalarm;.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarmresources</filename
> innehåller listan över alarmkalendrar som för närvarande används av &kalarm;.</simpara>
</listitem>
</itemizedlist>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Var lagrar &kalarm; sina alarm?</para>
</question>
<answer>

<para
>När &kalarm; körs för första gången, skapar det följande alarmkalendrar i katalogen <command
>qtpaths --paths GenericDataLocation</command
>:</para>

<itemizedlist>
<listitem>
<simpara
><filename
>kalarm/calendar.ics</filename
>, som innehåller aktiva alarm.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/expired.ics</filename
>, som innehåller arkiverade alarm.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/template.ics</filename
>, som innehåller alarmmallar.</simpara>
</listitem>

<listitem>
<simpara
><filename
>kalarm/displaying.ics</filename
>, som är en särskilt kalenderfil som innehåller detaljinformation om alarm som för närvarande visas, vilket låter &kalarm; åter visa alla alarm som visades när det avslutades senast.</simpara>
</listitem>
</itemizedlist>

<para
>Därefter kan du ersätta kalendrarna, utom <filename
>displaying.ics</filename
>, eller skapa ytterligare alarmkalendrar på vilken plats du vill. Du kan ta reda på vilka kalenderfiler som för närvarande används genom att visa alla kalendrarnas detaljinformation i alarmkalenderlistan.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Vilket format lagras alarm med?</para>
</question>
<answer>
<para
>Kalenderfilerna där &kalarm; lagrar sina alarm är textfiler vars format definieras av dokumentet <ulink url="http://www.w3.org/2002/12/cal/rfc2445.html"
>RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar)</ulink
>. Det är standardformatet som används av alla kdepim-program. &kalarm; använder vissa egenskaper som inte är standardiserade, i enlighet med RFC2445. De är dokumenterade i filen <filename
>DESIGN-kalarmcalendar.html</filename
> som distribueras med &kalarm;.</para>
</answer>
</qandaentry>

<qandaentry id="akonadi-plugin">
<question>
<para
>Vad är funktionen hos &kalarm;s Akonadi insticksprogram?</para>
</question>
<answer>
<para
>&kalarm; använder sitt Akonadi insticksprogram för att tillhandahålla alla funktioner som beror på &akonadi; (&kde;:s lagringstjänst för personlig informationshantering för flera plattformar). Om insticksprogrammet inte är installerat och aktiverat, saknar &kalarm; följande funktioner: <itemizedlist>
<listitem>
<simpara
>Skicka e-post via &kmail;, vilket leder till att &Sendmail; är det enda alternativet för att skicka e-post (se <link linkend="preferences-email"
>E-postinställningar</link
>).</simpara>
</listitem>
<listitem>
<simpara
>Drag och släpp brev.</simpara>
</listitem>
<listitem>
<simpara
>Val av e-postadresser från adressboken.</simpara>
</listitem>
<listitem>
<simpara
>Importera födelsedagar från adressboken.</simpara>
</listitem>
<listitem>
<simpara
>Överföring av &akonadi;-resurser för alarmkalender vid första körning av &kalarm;.</simpara>
</listitem>
</itemizedlist>
</para>
<para
>Om insticksprogrammet är installerat, kan det aktiveras eller inaktiveras under fliken <link linkend="preferences-general"
>Allmänt</link
> i inställningsdialogrutan.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Vad är programnamnet för <application
>kalarmautostart</application
>?</para>
</question>
<answer>
<para
><application
>kalarmautostart</application
> är ett litet hjälpprogram, vars funktion är att starta &kalarm; automatiskt vid inloggning.</para>

<para
>&kalarm; återställs normalt av sessionshanteringen vid inloggning (för att visa sina fönster igen med samma tillstånd som de hade när du loggade ut). Men om det inte körde när du loggade ut, skulle det inte startas av sessionshanteringen, och behöver därför startas automatiskt. Problemet är att när ett program både sköts av sessionshanteringen och startas automatiskt, finns det ingen garanti vilket som sker först. Om automatiskt start kommer först, förhindrar det att sessionshanteringen återställer programmets tillstånd.</para>

<para
>För att undvika problemet, startas <application
>kalarmautostart</application
> automatiskt vid inloggning istället för &kalarm;. Allt det gör är att vänta en kort stund (för att försäkra sig om att sessionshanteringen har haft tid att göra sitt jobb) innan &kalarm; startas, och därefter avslutas det.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Hu kan man använda &kalarm; på ett annat skrivbord än &plasma;?</para>
</question>
<answer>
<para
>För att köra &kalarm; på ett annat skrivbord än &plasma;, är det viktigaste kravet att försäkra sig om att &kalarm; körs automatiskt så fort du loggar in. Mer detaljerade instruktioner finns i filen <filename
>INSTALL</filename
> som levereras med &kalarm;.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Tack till och licens</title>

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

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

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@bredband.net</email
></para
> &underFDL; &underGPL; <para
>Tack till upphovsmannen för programmet KAlarm för &kde; 1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, som vänligen gick med på att det här programmet, tillgängligt från &kde; 2 och framåt, fick använda namnet &kalarm;. </para>

</chapter>

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

