<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kalarm;">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Danish "INCLUDE"
><!-- change language only here -->
]>

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

<book lang="&language;">

<bookinfo>
<title
>&kalarm;-håndbogen</title>

<authorgroup>
<author
><firstname
>David</firstname
> <othername
></othername
> <surname
>Jarvie</surname
> <affiliation
> <address
><email
>software@astrojar.org.uk</email
></address>
</affiliation>
</author>

<othercredit role="developer"
><firstname
>David</firstname
> <surname
>Jarvie</surname
> <affiliation
><address
><email
>software@astrojar.org.uk</email
></address
></affiliation>
<contrib
>Udvikler</contrib>
</othercredit>

&erik.kjaer.pedersen.role; 
</authorgroup>

<copyright>
<year
>2001</year
><year
>2002</year
><year
>2003</year>
<holder
>David Jarvie</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<date
>2003-12-01</date>
<releaseinfo
>1.00.00</releaseinfo>

<abstract>
<para
>&kalarm; er en personlig skemalægger af alarmer, påmindelser, e-post og kommandoer for &kde;.</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdepim</keyword>
<keyword
>kalarm</keyword>
<keyword
>alarm</keyword>
<keyword
>påmindelse</keyword>
</keywordset>

</bookinfo>


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

<para
>&kalarm; er en personlig skemalægger for alarmbeskeder, kommandoer og e-post. Den lader dig indstille personlige alarmer/påmindelser som så dukker op på skærmen på det valgte tidspunkt, eller du kan indstille kommandoer der skal køres eller e-post der skal sendes.</para>

<para
>I sin normale grafiske tilstand, viser &kalarm; en liste med ventende alarmer, med tider og information. Du kan oprette nye alarmer, eller du kan vælge eksisterende alarmer for at ændre eller fjerne dem. Du kan også vælge at se udløbne alarmer.</para>

<para
>Når du indstiller eller ændrer en alarm, kan du enten indtaste teksten for alarmbeskeden, angive en tekst- eller billedfil som skal vises, en kommando som skal køres eller e-post som skal sendes. Du kan også vælge farven for alarmbeskeden, om den skal gentages, om en lyd skal afspilles og om alarmen skal annulleres hvis den ikke kan vises på det skemalagte tidspunkt.</para>

<para
>Alarmer kan også skemalægges på kommandolinjen, eller via &DCOP;-kald fra andre programmer.</para>

<para
>Når en alarmbesked skal vises, ses den på alle &kde;-skriveborde for at være sikker på at du ikke overser den. Beskedvinduet viser tiden hvor alarmen var skemalagt. Det har oftest en valgmulighed som angiver at det skal udsættes, og vises igen senere. Et eksempel på en alarmbesked:</para>

<screenshot>
<screeninfo
>Skærmbillede af &kalarm;s beskedvindue</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="alarmmessage.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Alarmbesked</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Når alarmen angiver en kommando som skal køres, viser &kalarm; ingenting.</para>

<para
>&kalarm; kan køre i en af to tilstande: <quote
>kontinuert</quote
> (det normale) hvor den kører i &kde;'s statusfelt, eller <quote
>ved forespørgsel</quote
> hvor den kører når der er brug for det (med mulighed for at vise en uafhængig ikon i statusfeltet).</para>

<para
>Dette dokument refererer på forskellige steder til <application
>alarmdæmonen</application
>. Det er et program som kører i baggrunden, kontrollerer ventende alarmer og fortæller &kalarm; at de skal vises når de indtræffer.</para>

</chapter>

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

<sect1 id="graphmode">
<title
>Grafisk tilstand</title>

<para
>Når den køres uden kommandolinjeflag, starter &kalarm; i grafisk tilstand, og viser den nuværende liste med ventende alarmer.</para>

<para
>Når &kalarm; starter i grafisk tilstand, kontrolleres om <application
>alarmdæmonen</application
> kører. Hvis den ikke allerede kører, så starter &kalarm; den.</para>

<tip
><para
>Alle spinbokse i &kalarm; har en accelerationsfunktion. For at ændre værdien med større skridt, holdes <keycap
>&Shift;</keycap
>-tasten nede mens du klikker på pileknapperne.</para
></tip>

<sect2>
<title
>Alarmliste</title>

<para
>Hovedvinduet i &kalarm; viser den nuværende liste med ventende alarmer, med tider, antal gentagelser, farver og beskedtekster, navne på filer som skal vises, kommandoer som skal køres eller emner for e-post. (For en alarm som gentages, er tiden som angives næste gang alarmen udløses.) En ikon til venstre for hver alarm tekst/fil/kommando angiver alarmens type.</para>

<screenshot>
<screeninfo
>Skærmbillede af &kalarm;s hovedvindue</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="mainwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Hovedvindue</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>For en gentagen alarm, viser listen næste gang det er skemalagt den skal vises og det grundlæggende gentagelsesinterval (f.eks. <quote
>1 dag</quote
> for daglig gentagelse, <quote
>3 uger</quote
> for en gentagelse som udløses på mandag og onsdag hvor tredje uge, <quote
>Login</quote
> for en alarm som gentages ved indlogning).</para>

<para
>Alarmen kan sorteres efter dato/tid, antal gentagelser, farve eller beskedtekst ved at klikke på titellinjen i den relevante søjle. For at vende sorteringsrækkefølgen om, klikkes på søjlens titellinje en gang til.</para>

<para
>Du kan vælge at vise tiden indtil hver alarm udløses, sammen med, eller i stedet for, alarmens skemalagte tidspunkt. For at vise eller skjule alarmtidssøjlen, vælges <menuchoice
><guimenu
>Vis</guimenu
><guimenuitem
>Vis alarmtider</guimenuitem
></menuchoice
>. For at vise eller skjule søjlen tid-til-alarm, vælges <menuchoice
><guimenu
>Vis</guimenu
><guimenuitem
>Vis tid til alarm</guimenuitem
></menuchoice
>. I det mindste en af disse søjler vises altid.</para>

<para
>Udløbne alarmer kan vises i alarmlisten ved at vælge <menuchoice
><guimenu
>Vis</guimenu
><guimenuitem
>Vis udløbne alarmer</guimenuitem
></menuchoice
>. For at skjule dem igen, gentages handlingen.</para>

</sect2>

<sect2>
<title
>Tilføj en ny alarm</title>

<para
>For at tilføje en ny alarmbesked, gøres et af følgende. Dette viser redigeringsvinduet for alarmbeskeder som beskrevet nedenfor.</para>

<itemizedlist>
<listitem>
<para
>Vælg <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
> Ny</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på ikonen i statusfeltet og vælg <menuchoice
><guimenuitem
>Ny alarm</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>

<listitem>
<para
>Dobbeltklik på det tomme sted under den sidste indgang i alarmlisten.</para>
</listitem>

<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på det tomme sted under den sidste indgang i alarmlisten og vælg <menuchoice
><guimenuitem
>Ny</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>
</itemizedlist>

<para
>Alternativt kan du oprette nye alarmer forindstillede fra forskellige kilder:</para>

<itemizedlist>
<listitem>
<para
>For at basere den nye alarm på en eksisterende, markeres den eksisterende alarm på listen og så vælges <menuchoice
><guimenu
>Handlinger</guimenu
> <guimenuitem
>Kopiér</guimenuitem
></menuchoice
>. Så vises alarmen med redigeringsdialogen allerede udfyldt med en kopi af den markerede alarms information.</para>
</listitem>

<listitem>
<para
>For at oprette en ny alarm som viser eksisterende e-post, trækkes brevet fra &kmail; til &kalarm;s hovedvindue eller statusfeltets ikon. Dette viser dialogen for alarmredigering med hele brevet (inklusive afsender, modtager, osv.) som alarmteksten.</para>
</listitem>

<listitem>
<para
>Ved at trække et vilkårlig stykke tekst til &kalarm;s hovedvindue eller statusfeltets ikon, vises dialogen for alarmredigering med alarmens tekst angivet.</para>
</listitem>

<listitem>
<para
>For at oprette en alarm som viser en fil, trækkes filens &URL; til &kalarm;s hovedvindue eller statusfeltets ikon. Dette åbner dialogen for alarmredigering med filnavnet angivet.</para>
</listitem>

<listitem>
<para
>Du kan automatisk oprette fødselsdagsalarmer for personer i adressebogen som beskrevet i <link linkend="birthdays"
>Importér fødselsdage fra adressebogen</link
>.</para>
</listitem>

</itemizedlist>

</sect2>

<sect2 id="edit-alarm">
<title
>Ændr en eksisterende alarm</title>

<para
>For at ændre en eksisterende alarm (udløbne alarmer kan ikke påvirkes), gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Dobbeltklik på indgangen i alarmlisten.</para>
</listitem>

<listitem>
<para
>Vælg det ved at klikke på indgangen i alarmlisten. Vælg derefter <menuchoice
> <guimenu
>Handlinger</guimenu
> <guimenuitem
>Ændr</guimenuitem
></menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på indgangen i alarmlisten og vælg <menuchoice
><guimenuitem
>Ændr</guimenuitem
></menuchoice
> i den sammenhængsafhængig menuen.</para>
</listitem>
</itemizedlist>

<para
>Dette viser redigeringsvinduet for alarmer:</para>

<screenshot>
<screeninfo
>Skærmbillede af alarmredigeringsvinduet</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editwindow.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Alarmredigeringsvinduet</phrase>
</textobject>
</mediaobject>
</screenshot>

<para
>Vælg alarmtype i gruppeboksen <guilabel
>Handling</guilabel
>.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Tekst</guilabel
> for at indtaste en alarmbeskedtekst (som kan indeholde flere linjer) i redigeringsboksen. Sæt et af følgende tilvalg:</para>

<itemizedlist>
<listitem>
<para
>Afkrydsningsboksen <guilabel
>Bekræft besked</guilabel
> lader dig angive om du vil bedes om bekræftelse når du lukker alarmbeskedens vindue. Dette kan bruges som en sikkerhedshandling for at undgå at bekræfte alarmer ved en fejl.</para>
</listitem>

<listitem>
<para
>Markér afkrydsningsboksen <guilabel
>Lyd</guilabel
> hvis du ønsker at en hørbar alarm skal lyde når alarmbeskeden vises. Normalt høres et pip, brug knappen til højre for at vælge en lydfil som skal afspilles. For at gå tilbage til et pip, klikkes på knappen igen. For at se hvad den nuværende lyd er, holdes musen over knappen indtil et værktøjsvink vises.</para>
</listitem>

<listitem>
<para
>Markér afkrydsningsboksen <guilabel
>Påmindelse</guilabel
> hvis du vil vise en påmindelse inden hovedalarmen og hver af dens gentagelser (hvis der er nogen). Angiv hvor langt i forvejen med redigeringskontrollerne ved siden af  afkrydsningsboksen.</para>
</listitem>

<listitem>
<para
>Vælg baggrundsfarve for vinduet med alarmbeskeden. (Farvevalgslisten kan indstilles i <link linkend="preferences"
>indstillingsdialogen</link
>.) </para>
</listitem>

<listitem>
<para
>Brug knappen <guibutton
>Skrifttype og farve...</guibutton
> til at vælge en skrifttype for alarmbeskeden. Markér <guilabel
>Brug standardskrifttype</guilabel
> i dialogen <guilabel
>Vælg alarmskrifttype og farve</guilabel
> til at vise beskeden med hvilken som helst skrifttype som er standard når beskeden vises. (Standardskrifttype kan indstilles i <link linkend="preferences"
>indstillingsdialogen</link
>.) For at vælge en særlig skrifttype for beskeden, afmarkeres <guilabel
>Brug standardskrifttype</guilabel
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Fil</guilabel
> for at indtaste navn eller &URL; til en tekstfil hvis indhold skal vises i alarmbeskeden. Brug knappen ved siden af  redigeringsboksen til at vise en filvalgsdialog. Sæt tilvalg på samme måde som for tekstalarmen ovenfor.</para>
</listitem>

<listitem>
<para
><guilabel
>Kommando</guilabel
> for at indtaste en skalkommandolinje der skal  køres. Kommandoen sendes direkte til standard-skallen (defineret af miljøvariablen <envar
>SHELL</envar
>), og kan indholde alt muligt, flag, kommander med pipe, osv. som tillades af skallen på en enkel kommandolinje.</para>

<note
><para
>Dette er ikke tilgængeligt hvis &kde; kører i kiosktilstand.</para
></note>
</listitem>

<listitem>
<para
><guilabel
>E-post</guilabel
> for at indtaste e-post der skal sendes. Udfyld  modtagernes adresser, emne for e-post og beskedteksten i de tre redigeringsfelter. Brug knappen ved siden af adresseredigeringsboksen til at vise &kde;'s adressebog, hvor du kan vælge modtagere af e-post. Bilag kan tilføjes med knappen <guibutton
>Tilføj..</guibutton
>. Bemærk at bilag skal stadigvæk eksistere på det tidspunkt hvor alarmen indtræffer. Ingen kopi opbevares når alarmen indstilles. For at fjerne et bilag, markeres det i dropned-boksen og der klikkes på knappen <guibutton
>Fjern</guibutton
>.</para>

<para
>Du kan indstille den E-postadresse som kopien sendes fra i <link linkend="preferences"
>indstillingsdialogen</link
>, hvor standardværdien er e-postadressen som den er indstillet i &kde;'s kontrolcenter.</para>

<para
>Indstil følgende valgmuligheder:</para>

<itemizedlist>
<listitem>
<para
>Markér afkrydsningsboksen <guilabel
>Kopiér e-post til mig selv</guilabel
> for at sende en blind kopi af e-posten til dig selv når alarmen indtræffer. E-postadressen som kopien sendes til kan indstilles i <link linkend="preferences"
>indstillingsdialogen</link
>, hvor standardværdien er e-postadressen som er indstillet i &kde;'s kontrolcenter.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>


<para
>Hvis alarmen er gentagende, og den blev udsat efter den sidst blev vist, så viser boksen <guilabel
>Udskudte alarmer</guilabel
> tiden som den er udskudt til. <guibutton
>Ændr...</guibutton
> viser en dialog som lader dig ændre tiden der er udskudt til, eller ikke længer at udskyde alarmen.</para>

<para
>I <guilabel
>Tid</guilabel
>-gruppeboksen vælges enten</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Ved dato/tid</guilabel
> til at indtaste dato og tid når alarmen skal vises. Markér afkrydsningsboksen <guilabel
>Når som helst</guilabel
> hvis du kun vil angive en dato for alarmen: i dette tilfælde vises alarmen ved den første mulighed efter den indstillede tid hvor dagen begynder, på den angivne dato. (<link linkend="preferences"
>Indstil &kalarm;</link
> beskriver hvordan man indstiller tiden når dagen begynder.)</para>

<para
>For en ikke-gentagende alarm, skal den dato/tid du indtaster være i fremtiden, eller hvis du kun angiver dato, skal det være i dag eller senere. For en gentagende alarm, er der ingen sådanne begrænsninger, da startdato/tid automatisk vil blive justeret til den første gentagelse der er efter det nuværende tidspunkt.</para>
</listitem>

<listitem>
<para
><guilabel
>Tid fra nu</guilabel
> for at indtaste hvor langt fra nuværende tidspunkt (i timer og minutter) som alarmen skal vises.</para>
</listitem>
</itemizedlist>

<para
>Alarmens grundlæggende gentagelseskarakteristik vises af bekvemmelighedsgrunde under fanebladet <guilabel
>Alarm</guilabel
>. Angiv om og hvordan alarmen skal gentages under fanebladet <guilabel
>Gentagelse</guilabel
>.</para>

<itemizedlist>
<listitem>
<para
>Vælg type af gentagelse i boksen <guilabel
>Gentagelsesregel</guilabel
>, på følgende måde:</para>

<itemizedlist>
<listitem
><para
>For kun at vise alarmen én gang, vælges <guilabel
>Ingen gentagelse</guilabel
>.</para
></listitem>

<listitem
><para
>Markér <guilabel
>Ved indlogning</guilabel
> hvis du ønsker at alarmen skal vises så snart du logger på, indtil den skemalagte sluttid. (Bemærk at en alarm som gentages ved indlogning også vises så snart du aktiverer alarmer, eller genstarter eller nulstiller <application
>alarmdæmonen</application
>.)</para
></listitem>

<listitem>
<para
>For at lade alarmen gentages med regelmæssige intervaller, vælges en tidsperiode og derefter indtastes i <guilabel
>Gentag hver</guilabel
>-boksen hvor mange tidsperioder der skal gå mellem gentagelserne. For  eksempel for at gentage hver 14. dag, kan du vælge <guilabel
>Daglig</guilabel
> og indtaste værdien 14, eller vælge <guilabel
>Ugentlig</guilabel
> og indtaste værdien 2. Afhængig af tidsperioden som vælges, kan der være yderligere valgmuligheder:</para>

<itemizedlist>
<listitem>
<para
>For en ugevis gentagelse, kan hver dag i ugen hvor du vil vise alarmen markeres.</para>
</listitem>

<listitem>
<para
>For en månedsvis gentagelse, kan du enten vælge en fast dato eller en position (&eg; den anden tirsdag).</para>
</listitem>

<listitem>
<para
>For en månedsvis gentagelse, kan du enten vælge en fast dato i måneden eller en position i en måneden (f.eks. den sidste lørdag i maj). Markér hver måned i året hvor du vil aktivere alarmen.</para>
</listitem>
</itemizedlist>

<tip
><para
>For at indstille en daglig alarm som kun skal indtræffe på hverdage, bruges ugevis gentagelse og alle hverdage markeres.</para
></tip>

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

<listitem>
<para
>Indstil det omfattende tidsområde i boksen <guilabel
>Gentagelsernes slutning</guilabel
> på følgende måde:</para>

<itemizedlist>
<listitem
><para
>Vælg <guilabel
>Ingen afslutning</guilabel
> for at fortsætte gentagelserne for evigt.</para
></listitem>

<listitem
><para
>Vælg <guilabel
>Slut efter</guilabel
> for at angive totalt antal gentagelser af alarmen.</para
></listitem>

<listitem
><para
>Vælg <guilabel
>Slut den</guilabel
> for at angive dato/tid som alarmen vil gentages til.</para
></listitem>
</itemizedlist>

</listitem>

<listitem>
<para
>Hvis du vil undtage visse datoer eller tidspunkter fra gentagelserne som du har indstillet, angives de i gruppeboksen <guilabel
>Undtagelser</guilabel
>. Listen med undtagelser (dvs. dato eller tider) vises til venstre. For at tilføje en ny undtagelse, indskrives en dato til højre og der trykkes på <guibutton
>Tilføj</guibutton
>. For at ændre en undtagelse, indskrives den nye dato til højre og der trykkes på <guibutton
>Ændr</guibutton
>. For at fjerne en undtagelse, markeres den i listen og der trykkes på <guibutton
>Slet</guibutton
>.</para>
</listitem>

</itemizedlist>

<para
>Afkrydsningsboksen <guilabel
>Annullér hvis for sent</guilabel
> afgør hvad der skal ske hvis alarmen ikke kan aktiveres på sit skemalagte tidspunkt. Markér denne boks for at annullere alarmen, hvis den ikke kan aktiveres indenfor et minut efter det rigtige tidspunkt. Lad boksen være umarkeret for at aktivere alarmen ved den første mulighed efter det skemalagte tidspunkt. Alarm med kun dato, dvs. dem som har tilvalget <guilabel
>Når som helst</guilabel
> markeret, annulleres hvis de ikke kan vises indenfor 24 timer efter tidspunktet hvor dagen anses for at begynde på den skemalagte dato.</para>

<note
><para
>En alarm kan kun aktiveres mens du er logget på, og mens både X og <application
>alarmdæmonen</application
> kører.</para
></note>

<para
>Tryk på knappen <guibutton
>O.k.</guibutton
> når alle detaljer er rigtige, for at tilføje alarmen til listen over skemalagte alarmer.</para>

</sect2>

<sect2>
<title
>Slet en alarm</title>

<para
>For at slette en eksisterende alarm, gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Vælg den ved at klikke på indgangen i alarmlisten. Vælg derefter <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
>Slet</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på indgangen i alarmlisten og vælg <menuchoice
><guimenuitem
>Slet</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Vis en alarm</title>

<para
>For at se en eksisterende alarm, uden at kunne ændre den, gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Vælg den ved at klikke på indgangen i alarmlisten. Vælg derefter <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
>Vis</guimenuitem
> </menuchoice
>.</para>
</listitem>
<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på indgangen i alarmlisten og vælg <menuchoice
><guimenuitem
>Vis</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>
</itemizedlist>

<para
>Dette viser redigeringsvinduet for alarmer i skrivebeskyttet tilstand.</para>

</sect2>

<sect2>
<title
>Bekræft en alarm</title>

<para
>Se <link linkend="message-window"
>Alarmbeskedvindue</link
> for hvordan man bekræfter en alarm.</para>

</sect2>

<sect2 id="birthdays">
<title
>Importér fødselsdage fra adressebogen</title>

<para
>Du kan indstille visning af alarmer for fødselsdage som er opbevaret i &kaddressbook; med <menuchoice
><guimenu
>Fil</guimenu
> <guimenuitem
>Importér fødselsdage...</guimenuitem
></menuchoice
>. Derpå vises en dialog som lader dig vælge for hvilke fødselsdage alarmer skal laves.</para>

<itemizedlist>
<listitem>
<para
>I gruppeboksen <guilabel
>Alarmtekst</guilabel
> kan du indstille teksten som vises i alarmbeskeden for en fødselsdag. Beskedteksten laves ved at kombinere teksten i <guilabel
>Præfiks</guilabel
>, fulgt af personens navn, fulgt af teksten i <guilabel
>Suffiks</guilabel
>. Ingen mellemrum tilføjes, så husk at tilføje eventuelle nødvendige afsluttende mellemrum i <guilabel
>Præfiks</guilabel
> og indledende mellemrum i <guilabel
>Suffiks</guilabel
>.</para>

<note
><para
>Hvis du ændrer alarmteksten, evalueres listen for valg af fødselsdag igen.</para
></note>
</listitem>

<listitem>
<para
>Vælg fødselsdagene som du vil oprette alarmer for i listen <guilabel
>Vælg fødselsdage</guilabel
>. Bemærk at listen kun viser indgange fra adressebogen som indeholder en fødselsdag, og som ikke allerede har en fødselsdagsalarm med formatet som for øjeblikket er angivet i gruppeboksen <guilabel
>Alarmtekst</guilabel
>.</para>
</listitem>

<listitem>
<para
>Tilbageværende indstillinger er ligesom for <guilabel
>Tekst</guilabel
>-alarmer i <link linkend="edit-alarm"
>dialogen for alarmredigering</link
>.</para>
</listitem>
</itemizedlist>

</sect2>

<sect2>
<title
>Vis &kalarm; i statusfeltet</title>

<para
>Du skal køre &kde;-skrivebordet for at vise &kalarm; i statusfeltet. Hvis &kalarm; kører i <quote
>kontinuert</quote
> tilstand, vises ikonen i statusfeltet altid. Disse anvisninger gælder kun tilstanden <quote
>ved forespørgsel</quote
>. (Se <link linkend="preferences"
>Indstil &kalarm;</link
> for en beskrivelse af køretilstande.)</para>

<para
>For at vise &kalarm; i &kde;'s  statusfelt, vælges <menuchoice
> <guimenu
>Vis</guimenu
><guimenuitem
>Vis i statusfelt</guimenuitem
> </menuchoice
>.</para>

<para
>For at fjerne &kalarm; fra &kde;'s statusfelt, gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Vælg <menuchoice
> <guimenu
>Vis</guimenu
><guimenuitem
>Skjul fra statusfelt</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på ikonen i statusfeltet og vælg <menuchoice
><guimenuitem
>Afslut</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>
</itemizedlist>

<para
>Brug af ikonen i statusfeltet beskrives <link linkend="system-tray"
>nedenfor</link
>.</para>

</sect2>

<sect2 id="enable-disable">
<title
>Aktivér/deaktivér af alarmovervågning</title>

<sect3>
<title
>Aktivér alarmovervågning</title>

<para
>Først, hvis &kalarm;s køretilstand er <quote
>kontinuert</quote
> og du har valgt <guilabel
>Deaktivér alarm når programmet ikke er startet</guilabel
> i indstillingsdialogen, skal du sørge for at &kalarm; kører for at alarmovervågning kan ske.</para>

<para
>Derefter, hvis overvågning er deaktiveret for øjeblikket, gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Vælg <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
>Aktivér alarm</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på ikonen i statusfeltet og vælg <menuchoice
><guimenuitem
>Aktivér alarm</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>
</itemizedlist>

<para
><application
>Alarmdæmonen</application
> startes om nødvendigt, og alarmer overvåges så at de kan vises når det er det rette tidspunkt.</para>

<warning
><para
>Når <application
>alarmdæmonen</application
> startes, påvirker det alle andre programmer som bruger <application
>alarmdæmonen</application
>.</para
></warning>

</sect3>

<sect3>
<title
>Deaktivér alarmovervågning</title>

<para
>Der er flere måder at deaktivere alarmovervågning, som forhindrer at &kalarm; viser yderligere alarmer, enten indtil de aktiveres igen, eller - under forudsætning af at <application
>alarmdæmonen</application
> er indstillet til at starte ved indlogning - indtil næste gang du logger på.</para>

<para
>For at deaktivere alarmer uden at stoppe <application
>alarmdæmonen</application
> (og derfor uden at påvirke andre programmer som bruger <application
>alarmdæmonen</application
>), gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Vælg <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
>Alarmer aktiverede</guimenuitem
> </menuchoice
>.</para>
</listitem>

<listitem>
<para
><mousebutton
>Højre</mousebutton
>klik på ikonen i statusfeltet og vælg <menuchoice
><guimenuitem
>Alarmer aktiverede</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu.</para>
</listitem>

<listitem>
<para
>Hvis &kalarm;s køretilstand er <quote
>kontinuert</quote
> og du har valgt <guilabel
>Deaktivér alarmer når programmet ikke er startet</guilabel
> i indstillingsdialogen, afslut &kalarm;.</para>
</listitem>
</itemizedlist>

<para
>Deaktivér alarmer ved at stoppe <application
>alarmdæmonen</application
>:</para>

<itemizedlist>
<listitem>
<para
>Vælg <menuchoice
><guimenu
>Indstillinger</guimenu
><guimenuitem
>Kontrollér alarmdæmonen...</guimenuitem
> </menuchoice
>. Dette viser dialogen for tjenestehåndteringer, som gør det muligt at stoppe <application
>alarmdæmonen</application
>.</para>
</listitem>
</itemizedlist>

<warning
><para
>Dette påvirker alle programmer som bruger <application
>alarmdæmonen</application
>.</para
></warning>

</sect3>
</sect2>

<sect2>
<title
>Genopfrisk alarmer</title>

<para
>Hvis den usandsynlige begivenhed, at en alarm ikke vises når den skulle have været vist, skulle  indtræffe, kan du opdatere alarmlisten og vise alle alarmer som ikke blev vist, ved at vælge <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
>Genopfrisk alarmer</guimenuitem
> </menuchoice
>.</para>

<para
>&kalarm; viser alarmer som er sprunget over ved at nulstille <application
>alarmdæmonen</application
>, som beskrevet i afsnittet <link linkend="daemon-reset"
>Alarmdæmonen</link
>.</para>

</sect2>

<sect2>
<title
>Kontrol af <application
>alarmdæmonen</application
></title>

<para
>For at kontrollere <application
>alarmdæmonen</application
>, vælges <menuchoice
><guimenu
>Indstillinger</guimenu
><guimenuitem
>Kontrollér alarmdæmonen...</guimenuitem
> </menuchoice
>. Dette viser dialogen for tjenestehåndtering, som lader dig stoppe eller starte <application
>alarmdæmonen</application
>, og indstille om den kører automatisk ved indlogning. Se <link linkend="daemon-control"
>Kontrollér alarmdæmonen med tjenestehåndtering</link
> for mere information.</para>

</sect2>

<sect2>
<title
>Afslut programmet</title>

<para
>Afslut &kalarm; ved at lukke alle vinduer og ikonen i statusfeltet, eller ved  i <quote
>kontinuert</quote
> køretilstand at lukke alle beskedvinduer og vælge <menuchoice
><guimenuitem
>Afslut</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu for statusikonen.</para>

<para
><menuchoice
><guimenu
>Fil</guimenu
><guimenuitem
>Afslut</guimenuitem
> </menuchoice
> lukker kun selve vinduet. Virkningen af menupunktet <menuchoice
><guimenuitem
>Afslut</guimenuitem
></menuchoice
> i den sammenhængsafhængige menu for statusikonene afhænger af køretilstanden: for tilstanden <quote
>ved forespørgsel</quote
> skjules statusikonen ikon, men i <quote
>kontinuert</quote
> tilstand afsluttes programmet.</para>

<tip
><para
>Hvis <guilabel
>Deaktivér alarmer når programmet ikke er startet</guilabel
> ikke er markeret i indstillingsdialogen, sker ingenting med <application
>alarmdæmonen</application
> når &kalarm; afsluttes. Den fortsætter, hvis den allerede er aktiv,  med at overvåge skemalagte alarmer og bede om at de vises når de indtræffer.</para
></tip>

</sect2>
</sect1>

<sect1 id="message-window">
<title
>Alarmbeskedvindue</title>

<para
>Når en alarmbesked skal vises, ses det på alle &kde;-skriveborde og kan ikke dækkes af almindelige vinduer, for at være sikker på at du ser den. Beskedvinduet viser tiden hvor alarmen er skemalagt, så du kan se når den vises hvis du ikke var ved maskinen da den dukkede op. (For påmindelsesbeskeder, vises dato/tid for hovedalarmen eller dens gentagelse, ikke påmindelselsens tid, og vinduesnavnet er <quote
>Påmindelse</quote
>).</para>

<para
>I tilfældet med gentagne alarmer, hvis et beskedvindue som ikke bekræftes er tilovers fra et tidligere tilfælle hvor alarmen indtraf, dukker det eksisterende vindue helt enkelt op når alarmen gentages. Dette undgår at flere kopier af samme besked skal bekræftes, hvis du ikke vil eller kan bekræfte en besked når den indtræffer.</para>

<para
>Når et vindue med en alarmbesked vises, gøres et af følgende:</para>

<itemizedlist>
<listitem>
<para
>Bekræft den ved at klikke på knappen <guibutton
>Luk</guibutton
>. Dette lukker vinduet (efter at bede om bekræftelse, hvis du har markeret <guilabel
>Bekræft beskeder</guilabel
>).</para>
</listitem>

<listitem>
<para
>Vis muligheder for at udskyde alarmen ved at klikke på knappen <guibutton
>Udskyd...</guibutton
>. Vælg derefter <guilabel
>Udskyd indtil dato/tid</guilabel
> for at indtaste dato og tid når beskeden skal vises igen, eller vælg <guilabel
>Udskyd i tidsinterval</guilabel
> for at indtaste hvor meget senere (i timer og minutter) beskeden skal vises igen. Klik derefter på <guibutton
>Udskyd</guibutton
> for at udskyde alarmbeskeden.</para>

<note
><para
>Tiden alarmen udskydes til skal være før end næste skemalagte gentagelse eller påmindelse.</para
></note>

<note
><para
>Knappen <guibutton
>Udskyd...</guibutton
> er ikke tilgængelig for alarmer som vises ved indlogning på grund af at <guilabel
>Gentag ved indlogning</guilabel
> er markeret.</para
></note>
</listitem>
</itemizedlist>

<para
>Knappen med <guiicon
>&kalarm;</guiicon
>-ikonen sørger for en bekvem måde at aktivere &kalarm;.  Klik på den har ingen virkning på vinduet med alarmbeskeden.</para>

<para
>Alarmbeskedvinduet kan vises i to forskellige tilstande, afhængig af hvad du foretrækker. Du kan vælge tilstanden i <link linkend="preferences"
>Indstillingsdialogen</link
>.</para>

<itemizedlist>
<listitem>
<para
>Som et normalt vindue. I denne tilstand overtager alarmbeskedvinduet tastaturets fokus når det vises, så hvis du tilfældigvis er i gang med at skrive, havner dine tastenedtrykninger i det i stedet for i dit oprindelige program.</para>
</listitem>

<listitem>
<para
>Som et vindue som ikke fokuseres. I denne tilstand påvirkes tastaturets fokus ikke når alarmbeskedvinduet vises, så det forstyrrer ikke det du skriver. Vinduet har dog ingen titellinje i denne tilstand, så du kan ikke flytte det.</para>
</listitem>
</itemizedlist>

</sect1>

<sect1 id="system-tray">
<title
>Ikonen i statusfeltet</title>

<para
>&kalarm; kan køres som en ikon i &kde;'s statusfelt. Denne ikon muliggør aktivering af &kalarm; med et klik, og giver både kontrol og statusindikation for alarmovervågningen. En normal &kalarm;-ikon angiver at alarmer overvåges, mens et rødt kryds ved ikonen angiver at alarm ikke overvåges.</para>

<para
>Hvis du lader musemarkøren svæve over statusikonen, vises et sammendrag af nogle af de første alarmbeskeder som udløber de følgende 24 timer som et værktøjsvink. Du kan lukke af for denne funktion, eller indstille antallet af alarmer som vises, og deres format, i <link linkend="preferences"
>Indstillingsdialogen</link
>.</para>

<para
><mousebutton
>Venstre</mousebutton
>klik på statusikonen for at vælge at vise eller skjule &kalarm;s hovedvindue.</para>

<para
><mousebutton
>Højre</mousebutton
>klik på statusikonen for at vise den sammenhængsafhængige menu.</para>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenuitem
>Aktivér alarm</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Aktiverer overvågning af alarmer.</action
></para>
<para
>Se <link linkend="enable-disable"
>Aktivér/deaktivér  alarmovervågning</link
> for detaljer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Alarmer aktiverede</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Deaktivere for overvågning af alarmer.</action
></para>
<para
>Se <link linkend="enable-disable"
>Aktivér/deaktivér  alarmovervågning</link
> for detaljer.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Ny alarm...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Viser redigeringsdialogen for alarmer for at oprette en ny alarm.</action
></para>
<para
>Dialogen for alarmredigering beskrives under <link linkend="edit-alarm"
>Ændr en eksisterende alarm</link
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Indstil &kalarm;...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Viser &kalarm;s indstillingsdialog.</action
></para>
<para
>Indstillingsdialogen beskrives under <link linkend="preferences"
>Indstil &kalarm;</link
>. Den indeholder også tilvalg som har at gøre med  &kalarm;s statusikon.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Kontrollér alarmdæmonen...</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Viser tjenestehåndteringsdialogen, som lader dig kontrollere alarmdæmonen.</action
></para>
<para
>Se <link linkend="enable-disable"
>Kontrollér alarmdæmonen med tjenestehåndteringen</link
> for mere information.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Genopret/minimér</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Genopretter eller minimerer &kalarm;s hovedvindue.</action
></para>
<para
>Dette tilvalg er kun tilgængeligt i <quote
>kontinuert</quote
> køretilstand. (Se <link linkend="preferences"
>Indstil &kalarm;</link
> for en beskrivelse af køretilstande.)</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenuitem
>Afslut</guimenuitem
></menuchoice
></term>
<listitem
><para
><action
>Lukker for &kalarm;s statusikon.</action
></para>
<para
>I <quote
>kontinuert</quote
> køretilstand, lukkes også alle &kalarm;s hovedvindue. Det har ingen virkning på overvågningen af alarmer af <application
>alarmdæmonen</application
>, hvis du ikke har valgt <guilabel
>Deaktivér alarmer når programmet ikke er startet</guilabel
> i indstillingsdialogen.</para>
</listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="cmdline-operation">
<title
>Kommandolinjeflag</title>

<para
>Når kommandolinjeflag angives, viser &kalarm; ikke listen med skemalagte alarmer som beskrevet i <link linkend="graphmode"
>grafisk tilstand</link
>. Specielle kommandolinjeflag for &kalarm; kan bruges til at udføre følgende operationer:</para>

<itemizedlist>
<listitem
><para
>skemalæg en ny alarm</para>
</listitem>
<listitem
><para
>kontrollér <application
>alarmdæmonen</application
></para>
</listitem>
<listitem
><para
>kontrollér &kalarm;s visningstilstand</para>
</listitem>
<listitem
><para
>få hjælp</para>
</listitem>
</itemizedlist>

<para
>Yderligere kommandolinjeflag er tilgængelige først og fremmest for at lade andre programmer kunne  arbejde sammen med &kalarm;. De beskrives i kapitlet <link linkend="cmdline-interface"
>Udviklingsguide for &kalarm;</link
>.</para>

<para
>Kommandolinjen må kun indeholde flag for én &kalarm;-operation. Hvis du vil udføre flere operationer, skal du kalde &kalarm; flere gange, med et enkelt sæt flag hver gang.</para>

<sect2 id="cmdline-schedule">
<title
>Skemalæg en ny alarm</title>

<para
>Følgende flag bruges til at skemalægge en ny alarm:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Tilvalg</entry>
  <entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>-a</option
>, <option
>--ack-confirm</option
></entry>
  <entry
>Spørg en ekstra gang når du bekræfter alarmen.</entry>
</row>
<row>
  <entry
><option
>-A</option
>, <option
>--attach <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Angiv navn eller &URL; for en fil som skal vedlægges e-post. Dette tilvalg kan gentages efter behov. <option
>--mail</option
> skal angives sammen med dette flag.</entry>
</row>
<row>
  <entry
><option
>-b</option
>, <option
>--beep</option
></entry>
  <entry
>Afspil en hørbar lyd når beskeden vises. <option
>--sound</option
> må ikke være til sted hvis dette flag angives.</entry>
</row>
<row>
  <entry
><option
>--bcc</option
></entry>
  <entry
>Send en blind kopi af e-posten til dig selv. <option
>--mail</option
> skal angives med dette flag.</entry>
</row>
<row>
  <entry
><option
>-c</option
>, <option
>--color</option
>, <option
>--colour <replaceable
>farve</replaceable
></option
></entry>
  <entry
>Vis beskeden med baggrundsfarven ifølge det angivne &Qt;-farvenavn eller den hexadecimal kode 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-C</option
>, <option
>--colorfg</option
>, <option
>--colourfg <replaceable
>farve</replaceable
></option
></entry>
  <entry
>Vis beskeden med forgrundsfarven ifølge det angivne &Qt;-farvenavn eller den hexadecimale kode 0xRRGGBB.</entry>
</row>
<row>
  <entry
><option
>-e</option
>, <option
>--exec <replaceable
>kommandolinje</replaceable
></option
></entry>
  <entry
>Angiver en skalkommando som skal køres. Hvis dette er angivet, så skal dette flag være det sidste på &kalarm;s kommandolinje. Alle efterfølgende kommandolinjeflag tolkes som om de udgør kommandolinjen som skal køres. <option
>--file</option
> og <option
>--mail</option
> kan ikke angives sammen med dette flag. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> og <option
>--colorfg</option
> ignoreres med dette  flag.</entry>
</row>
<row>
  <entry
><option
>-f</option
>, <option
>--file <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Angiv navn eller &URL; for en tekst- eller billedfil hvis indhold skal bruges som alarmbesked. <option
>--exec</option
> og <option
>--mail</option
> kan ikke angives, og <replaceable
>beskeden</replaceable
> må ikke være til stede med dette flag.</entry>
</row>
<row>
  <entry
><option
>-i</option
>, <option
>--interval <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Angiv intervallet mellem gentagelser af alarmen. Timer/minutter angives i formatet <replaceable
>nHnM</replaceable
>, hvor <replaceable
>n</replaceable
> er et tal, f.eks. 3H30M. Andre tidsperioder angives i formatet <replaceable
>nX</replaceable
>, hvor <replaceable
>n</replaceable
> er et tal og <replaceable
>X</replaceable
> er et af følgende bogstaver: Y (år), M (måneder), W (uger), D (dage). Kræves hvis <option
>--repeat</option
> eller <option
>--until</option
> angives. <replaceable
>--recurrence</replaceable
> kan ikke angives med dette flag.</entry>
</row>
<row>
  <entry
><option
>-l</option
>, <option
>--late-cancel</option
></entry>
  <entry
>Afbryd alarmen hvis den ikke kan vises på det rigtige tidspunkt.</entry>
</row>
<row>
  <entry
><option
>-L</option
>, <option
>--login</option
></entry>
  <entry
>Vis alarmen hver gang du logger på. <option
>--interval</option
>, <option
>--repeat</option
> og <option
>--until</option
> kan ikke angives sammen med dette flag.</entry>
</row>
<row>
  <entry
><option
>-m</option
>, <option
>--mail <replaceable
>adresse</replaceable
></option
></entry>
  <entry
>Send e-post til angiven adresse. Dette tilvalg kan gentages om nødvendigt. <option
>--exec</option
> og <option
>--file</option
> kan ikke angives sammen med dette flag. <option
>--ack-confirm</option
>, <option
>--beep</option
>, <option
>--color</option
> og <option
>--colorfg</option
> ignoreres med dette flag.</entry>
</row>
<row>
  <entry
><option
>--recurrence <replaceable
>spec</replaceable
></option
></entry>
  <entry
>Indstil at alarmen skal gentages. Angiv gentagelsesinterval med iCalendar-syntaks (defineret af RFC2445), f.eks. <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
>. <option
>--repeat</option
>, <option
>--interval</option
>, og <option
>--until</option
> kan ikke angives sammen med dette flag.</entry>
</row>
<row>
  <entry
><option
>-r</option
>, <option
>--repeat <replaceable
>antal</replaceable
></option
></entry>
  <entry
>Antal gange som alarmen skal gentages. Angiv -1 for at gentage alarmen for evigt. <option
>--interval</option
> skal angives, og <option
>--until</option
> eller <option
>--recurrence</option
> kan ikke angives sammen med dette flag.</entry>
</row>
<row>
  <entry
><option
>-R</option
>, <option
>--reminder <replaceable
>periode</replaceable
></option
></entry>
  <entry
>Vis en påmindelsesalarm det angivne tidsrum inden hovedalarmen og for hver af dens gentagelser (hvis der er nogen). Timer/minutter angives i formatet <replaceable
>nHnM</replaceable
>, hvor <replaceable
>n</replaceable
> er et tal, f.eks. 3H30M. Andre tidsperioder angives i formatet <replaceable
>nX</replaceable
>, hvor <replaceable
>n</replaceable
> er et tal og <replaceable
>X</replaceable
> er et af følgende bogstaver: Y (år), M (måneder), W (uger), D (dage). Dette flag kan ikke angives sammen med <option
>--exec</option
> eller <option
>--mail</option
>.</entry>
</row>
<row>
  <entry
><option
>-s</option
>, <option
>--sound <replaceable
>URL</replaceable
></option
></entry>
  <entry
>Angiv navn eller &URL; for en lydfil som skal afspilles når alarmbeskeden vises. <option
>--beep</option
> må ikke være til stede hvis denne flag angives.</entry>
</row>
<row>
  <entry
><option
>-S</option
>, <option
>--subject <replaceable
>emne</replaceable
></option
></entry>
  <entry
>E-postens emne. <option
>--mail</option
> skal angives med dette flag.</entry>
</row>
<row>
  <entry
><option
>-t</option
>, <option
>--time <replaceable
>dato/tid</replaceable
></option
></entry>
  <entry
>Vis alarmen på den dato eller dato/tid som angives. Angiv en dato uden en tid i formatet <replaceable
>åååå-mm-dd</replaceable
>, og angiv en dato og en tid med <replaceable
>[[[åååå-]mm-]dd-]tt:mm</replaceable
> (hvor udeladte felter antages at gælde dagens dato).</entry>
</row>
<row>
  <entry
><option
>-u</option
>, <option
>--until <replaceable
>dato/tid</replaceable
></option
></entry>
  <entry
>Gentag alarmen indtil den dato eller dato/tid som angives. Angiv en dato uden en tid i samme format som for <option
>--time</option
>. <option
>--interval</option
> skal angives, og <option
>--repeat</option
> eller <option
>--recurrence</option
> kan ikke angives sammen med dette flag.</entry>
</row>
<row>
  <entry
><replaceable
>besked</replaceable
></entry>
  <entry
>Beskedtekst som skal vises, eller hvis <option
>--mail</option
> angives, beskedteksten i e-posten.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>Enten en beskedtekst, <option
>--file</option
> eller <option
>--exec</option
>  skal angives. Ellers er alle flag valgfrie, bortset fra hvor andet er angivet ovenfor.</para>

<para
>To forskellige eksempler som viser en besked med flere linjer, med rød baggrund, klokken 20:00 den 27. i indeværende måned, er:</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
>"Husk  at \nSTOPPE"</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
>"Husk  at\nSTOPPE"</replaceable
></option
></userinput
>
</screen>
</informalexample>

</sect2>

<sect2>
<title
>Øvrige tilvalg</title>

<para
>Følgende tilvalg bruges til at nulstille eller stoppe <application
>alarmdæmonen</application
>, eller kontrollere &kalarm;s visningstilstand.</para>

<para
>Se afsnittet <link linkend="daemon-reset"
>Alarmdæmonen</link
> for en beskrivelse af hvordan <application
>alarmdæmonen</application
> kan nulstilles eller stoppes.</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Tilvalg</entry>
  <entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--reset</option
></entry>
  <entry
>Nulstil <application
>alarmdæmonen</application
>.</entry>
</row>
<row>
  <entry
><option
>--stop</option
></entry>
  <entry
>Stop <application
>alarmdæmonen</application
>.</entry>
</row>
<row>
  <entry
><option
>--tray</option
></entry>
  <entry
>Viser &kalarm; som en ikon i &kde;'s statusfelt.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
>For eksempel, for at nulstille <application
>alarmdæmonen</application
>:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--reset</option
></userinput
>
</screen>
</informalexample>

</sect2>

<sect2>
<title
>Hjælpetilvalg</title>

<para
>Følgende hjælpetilvalg er fælles for alle &kde;-programmer:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Tilvalg</entry>
  <entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help</option
></entry>
  <entry
>Viser en kortfattet hjælpetekst om tilvalgene (flag).</entry>
</row>
<row>
  <entry
><option
>--help-qt</option
></entry>
  <entry
>Viser talrige generelle &Qt;-specifikke flag.</entry>
</row>
<row>
  <entry
><option
>--help-kde</option
></entry>
  <entry
>Viser talrige generelle &kde;-specifikke flag.</entry>
</row>
<row>
  <entry
><option
>--help-all</option
></entry>
  <entry
>Viser alle tilvalg.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Viser navn og e-postadresser for &kalarm;s forfattere.</entry>
</row>
<row>
  <entry
><option
>-v</option
>, <option
>--version</option
></entry>
  <entry
>Viser de versioner af &Qt;-biblioteket, &kde; og &kalarm; som kører.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Viser licensinformation.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</sect2>
</sect1>

<sect1 id="daemon">
<title
>Alarmdæmon</title>

<para
><application
>Alarmdæmonen</application
>, &kalarmd;, overvåger &kalarm;s kalenderfil for alarmer som indtræffer. Når den afgør at en alarm er indtruffet, fortæller den &kalarm; at den skal vise den, eller annullere den hvis det er for sent og sen visning ikke er valgt for denne alarmbesked.</para>

<para
>Under &kde;3, kan <application
>alarmdæmonen</application
> også bruges af andre programmer, inklusive Korganizer.</para>

<para
><application
>Alarmdæmonen</application
> kører i baggrunden, uden nogen brugergrænseflade. Den kan styres som beskrevet nedenfor.</para>

<sect2>
<title
>Start, nulstil og stop <application
>alarmdæmonen</application
></title>

<para
><application
>Alarmdæmonen</application
> startes normalt ved indlogning til &kde;-sessionen (hvis du ikke bruger tjenestehåndteringens dialog til at lukke for automatisk start), og kører hele tiden indtil du logger af. Hvis den af en eller anden grund ikke kører, sker ingen overvågning af alarmer og &kalarm; viser ingen alarmer.</para>

<sect3>
<title
>Start af <application
>alarmdæmonen</application
></title>

<para
>For at starte <application
>alarmdæmonen</application
> kan du enten køre &kalarm; i sin forvalgte grafiske tilstand (dvs. uden nogen kommandolinjeflag), aktivere alarmen i menuen for &kalarm;s  statusikon, nulstille dæmonen som beskrevet <link linkend="daemon-reset"
>nedenfor</link
>, starte den med tjenestehåndteringens dialog (se <link linkend="daemon-control"
>Styre alarmdæmonen med tjenestehåndteringen</link
>) eller køre <application
>alarmdæmonen</application
> direkte fra kommandolinjen:</para>

<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>kalarmd</command
></userinput
>
</screen>

</sect3>

<sect3 id="daemon-reset">
<title
>Nulstil <application
>alarmdæmonen</application
></title>

<para
>Det er også muligt at nulstille <application
>alarmdæmonen</application
> uden at stoppe den. En nulstilling gør at <application
>alarmdæmonen</application
> læser  listen over skemalagte beskeder igen fra kalenderfilen og initierer sine  &kalarm;-relaterede data igen.</para>

<para
>Hvorfor skulle du ville nulstille <application
>alarmdæmonen</application
>? Det er ikke en særlig sandsynlig hændelse, men hvis &kalarm; af en eller anden grund ikke kunne køre da <application
>alarmdæmonen</application
> bad den om at aktivere en alarm, så aktiveres den alarm aldrig hvis ikke <application
>alarmdæmonen</application
> enten nulstilles eller startes igen. At nulstille er at foretrække frem for at stoppe <application
>alarmdæmonen</application
> og starte den igen, eftersom at nulstille dæmonen ikke påvirker noget andet program som bruger <application
>alarmdæmonen</application
>.</para>

<tip
><para
>At nulstille starter <application
>alarmdæmonen</application
> hvis den ikke kører for øjeblikket.</para
></tip>

<para
>For at nulstille <application
>alarmdæmonen</application
>, bruges enten menukommandoen <menuchoice
> <guimenu
>Handlinger</guimenu
><guimenuitem
>Genopfrisk alarm</guimenuitem
></menuchoice
>, eller følgende kommando skrives:</para>

<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--reset</option
></userinput
>
</screen>

</sect3>

<sect3>
<title
>Stop <application
>alarmdæmonen</application
></title>

<para
>At stoppe <application
>alarmdæmonen</application
> forhindrer al fortsat overvågning af skemalagte alarmbeskeder indtil dæmonen startes igen.</para>

<warning
><para
>At stoppe den påvirker funktionen for alle andre programmer som også bruger <application
>alarmdæmonen</application
>. Overvej at nulstille dæmonen i stedet.</para
></warning>

<para
>For at stoppe <application
>alarmdæmonen</application
>, bruges enten tjenestehåndteringens dialog (se <link linkend="daemon-control"
>Kontrollér alarmdæmonen med tjenestehåndteringen</link
>) eller følgende kommando skrives:</para>

<screen width="40"
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--stop</option
></userinput
>
</screen>
</sect3>

</sect2>

<sect2 id="daemon-control">
<title
>Kontrollér <application
>alarmdæmonen</application
> med tjenestehåndteringen</title>

<para
>Tjenestehåndtereringens dialog lader dig indstille og styre <application
>alarmdæmonen</application
>. Du kan:</para>

<itemizedlist>
<listitem>
<para
>Indstil om den køres automatisk ved indlogning.</para>
<warning
><para
>Hvis hverken <application
>alarmdæmonen</application
> eller &kalarm; er indstillede til at køre ved indlogning, sker ingen overvågning af alarmer og &kalarm; viser ingen alarmer.</para
></warning>
</listitem>

<listitem>
<para
>Stop og start <application
>alarmdæmonen</application
>.</para>
<warning
><para
>Når <application
>alarmdæmonen</application
> startes eller stoppes, påvirker det alle andre programmer som bruger <application
>alarmdæmonen</application
>.</para
></warning>
</listitem>
</itemizedlist>

<para
>Tjenestehåndteringens dialog kan enten kommes til via menupunktet <menuchoice
><guimenu
>Indstillinger</guimenu
><guimenuitem
>Kontrollér alarmdæmonen...</guimenuitem
></menuchoice
>, eller via &kde;'s kontrolcenter.</para>

</sect2>
</sect1>
</chapter>

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

<para
>For at indstille &kalarm;s brug, vælges <menuchoice
><guimenu
>Indstillinger</guimenu
> <guimenuitem
>Indstil &kalarm;...</guimenuitem
> </menuchoice
>. Derpå vises indstillingsdialogen.</para>

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

<para
>Afsnittet <guilabel
>Generelt</guilabel
> lader dig kontrollere &kalarm;s generelle opførsel.</para>

<itemizedlist>
<listitem
><para
>Gruppeboksen <guilabel
>Køretilstand</guilabel
>: Disse valgmuligheder styrer &kalarm;s statusikon, og giver også en vis kontrol over &kalarm;s brug af systemressourcer, ved at angive om den skal køre hele tiden eller ej. Hvis systemets ydelse er vigtig, kan det være ønskværdigt at køre den efter behov uden at vise ikonen i statusfeltet. At køre den hele tiden i statusfeltet bruger flere systemressourcer, men giver den fordel at en indikering af at alarmer er aktiverede kan vises og at programmet er mere lettilgængeligt. At køre &kalarm; efter behov påvirker ikke kørsel af alarmer, eftersom det er <application
>alarmdæmonen</application
> og ikke &kalarm; som overvåger alarmlisten og udløser alarmer.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Kør hele tiden i statusfeltet</guilabel
>: &kalarm; kører hele tiden, og ikonen i statusfeltet vises altid mens den kører. Hvis ikonen i statusfeltet lukkes, lukkes alle hovedvinduer i &kalarm;, og hvis intet beskedvindue er synligt, afsluttes programmet. De mulige tilvalg i denne tilstand er:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Automatisk start ved indlogning</guilabel
>: Dette starter &kalarm; ved indlogning til en &kde;-session, hvilket sørger for at &kalarm; altid kører, hvis du ikke afslutter den manuelt.</para>
</listitem>
<listitem
><para
><guilabel
>Deaktivér alarmer når programmet ikke er startet</guilabel
>:  Markering af dette gør at alarmer deaktiveres så snart &kalarm;s ikon i statusfeltet ikke er synlig.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Advar inden afslutning</guilabel
>: Hvis alarmer lukkes af når &kalarm; ikke kører, og dette er markeret, bliver du bedt om at bekræfte om du forsøger at afslutte &kalarm; med  <menuchoice
><guimenu
>Afslut</guimenu
></menuchoice
> i statusikonen. Det forhindrer lukning af alarmer ved en fejl. Af sikkerhedsgrunde aktiveres dette automatisk igen, så snart du skifter køretilstand.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>

<para
>Hvis intet &kde; statusfelt findes i denne tilstand, kører &kalarm; hele tiden i baggrunden, og alarmer er altid aktiverede.</para>
</listitem>

<listitem
><para
><guilabel
>Kør kun efter behov</guilabel
>: &kalarm; kører kun når en alarm indtræffer, hvis du kører den manuelt, eller mens ikonen i statusfeltet vises. I denne tilstand kan ikonen i statusfeltet stadigvæk vises, men lukkes ikonen i statusfeltet påvirker det ikke nogen af &kalarm;s vinduer.</para>

<itemizedlist>
<listitem
><para
><guilabel
>Start ikon i statusfeltet automatisk ved indlogning</guilabel
>: Dette viser &kalarm;s statusikon ved indlogning. &kalarm; kører indtil ikonen i statusfeltet lukkes.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Dagens begyndelse for alarmer som kun gælder dato</guilabel
>: Angiv tiden når dagen begynder for at kunne vise alarm som kun gælder en dato, dvs. dem hvor tilvalget <guilabel
>Når som helst</guilabel
> blev valgt. På datoen hvor de indtræffer, vises sådanne alarmer på det tidligst mulige tidspunkt under 24 timer fra tiden hvor dagen begynder.</para>
</listitem>

<listitem
><para
>Hvis du indstiller årlige gentagelser for den 29. februar, skal du angive hvordan de skal håndteres i år som ikke er skudår, ved at vælge et af følgende:</para>

<itemizedlist>
<listitem
><para
><guilabel
>28. februar</guilabel
>: alarmen indtræffer den 29. februar i skudår, og 28. februar andre år.</para>
</listitem>

<listitem
><para
><guilabel
>1. marts</guilabel
>: alarmen indtræffer den 29. februar i skudår, og 1. marts andre år.</para>
</listitem>

<listitem
><para
><guilabel
>Gentag ikke</guilabel
>: alarmen indtræffer den 29. februar i skudår, men vises ikke andre år.</para>
</listitem>
</itemizedlist>

<note
><para
>Ændres dette gør det ikke at næste skemalagte tid for eksisterende alarmer omberegnes. Det påvirker kun nye alarmer, eller eksisterende alarm efter de er udløst næste gang.</para
></note>
</listitem>

<listitem
><para
><guilabel
>Bekræft sletning af alarmer</guilabel
>: Angiv om du skal  bedes om bekræftelse hver gang du sletter en alarm.</para>
</listitem>

<listitem
><para
>Gruppeboksen <guilabel
>Udløbne alarmer</guilabel
>: Disse valgmuligheder styrer opbevaringen af udløbne alarmer.</para>
<itemizedlist>
<listitem
><para
><guilabel
>Behold alarm efter udløb</guilabel
>: Markér dette for at beholde udløbne alarmer. Afmarkér det for at ikke beholde nogen information om alarmer når de udløbet.</para>
</listitem>

<listitem
><para
><guilabel
>Kassér udløbne alarmer efter</guilabel
>: Angiver antal dage som udløbne alarmer opbevares efter de senest indtraf.</para>
</listitem>

<listitem
><para
><guibutton
>Ryd udløbne alarmer</guibutton
>: Denne knap kasserer alle udløbne alarmer som for øjeblikket er opbevarede. Dette har ingen virkning for alarm som senere udløber. De fortsætter med at opbevares ifølge det indstillede punkt.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</sect1>

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

<para
>Afsnittet <guilabel
>E-post</guilabel
> giver dig valgmuligheder for at sende og adressere af e-postalarmer:</para>

<itemizedlist>
<listitem>
<para
><guilabel
>E-postprogram</guilabel
>: Angiver e-postprogrammet som skal bruges til at sende e-postalarm:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Kmail</guilabel
>: Når en e-postalarm indtræffer, lægges e-posten i &kmail;s <filename
>udbakke</filename
>, under forudsætning af at &kmail; kører på det tidspunkt. Hvis den ikke kører, vises et &kmail; brevvindue hvor e-postinformationen er udfyldt, så du kan sende brevet manuelt.</para>
</listitem>

<listitem
><para
><guilabel
>Sendmail</guilabel
>: Når en e-postalarm indtræffer, sendes e-post automatisk med <application
>sendmail</application
>. Dette virker kun hvis systemet er indstillet til at bruge <application
>sendmail</application
> eller et program som virker ligesom <application
>sendmail</application
> for eksempel <application
>postfix</application
> eller <application
>qmail</application
>.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
><guilabel
>Fra</guilabel
> e-postadresse angiver din e-postadresse som skal bruges som afsenderens adresse i e-postalarmer. Vælg <guilabel
>Brug adresse fra kontrolcentret</guilabel
> for at bruge e-postadressen som er indstillet i &kde;'s kontrolcenter.</para>
</listitem>

<listitem>
<para
><guilabel
>Blind kopi</guilabel
> e-postadresse angiver den e-postadresse som skal bruges til at sende blinde kopier af e-postalarmer til dig selv når punktet <guilabel
>Kopiér e-post til mig selv</guilabel
> er markeret. Hvis blinde kopier skal sendes til din konto på maskinen som &kalarm; kører på, er det nok at indtaste dit brugernavn her. Vælg <guilabel
>Brug adresse fra kontrolcentret</guilabel
> for at bruge e-postadressen som er indstillet i &kde;'s kontrolcenter.</para>
</listitem>

<listitem>
<para
><guilabel
>Meddel når e-post lægges i kø</guilabel
>: Markér dette for at få vist en besked så snart en e-postalarm sætter e-post i kø for at sende den til en anden maskine. Dette kan være nyttigt, hvis du for eksempel har en opringet forbindelse, så du sørge for at du gør hvad som endnu behøves for virkelig at sende en e-post.</para>
</listitem>
</itemizedlist>
</sect1>

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

<para
><guilabel
>Vis</guilabel
>-afsnittet lader dig styre nogle aspekter vedrørende &kalarm;s udseende.</para>
<itemizedlist>

<listitem>
<para
>Gruppeboksen <guilabel
>Alarmliste</guilabel
>: Disse valgmuligheder styrer den information der vises i alarmlisten fra begyndelsen når &kalarm; startes. (Når &kalarm; er startet, bruges <guimenu
>Vis</guimenu
>-menuen til at ændre det der vises.)</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Vis alarmtid</guilabel
>: Markér dette for at vise dato og tidspunkt hvor hver alarm er skemalagt næste gang.</para>
</listitem>

<listitem>
<para
><guilabel
>Vis tid til alarm</guilabel
>: Markér dette for at vise hvor lang tid der er tilbage inden hver alarms næste skemalagte aktivering. Tiden vises i dage (om nødvendigt), timer og minutter.</para>
</listitem>
</itemizedlist>
</listitem>

<listitem>
<para
>Gruppeboksen <guilabel
>Værktøjsvink i statusfeltet</guilabel
>: Disse valgmuligheder styrer den information der vises i værktøjsvinkene som vises når musemarkøren svæver over &kalarm;s ikon i statusfeltet.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Vis alarm for de følgende 24 timer</guilabel
>: Hvis dette er markeret, vises et sammendrag af de første alarmer som udløber de følgende 24 timer.</para>
</listitem>

<listitem>
<para
><guilabel
>Maksimalt antal alarm at vise</guilabel
>: Afmarkér dette for at vise alle alarmer for de følgende 24 timer. Markér dette for at angive det maksimale antal alarm som vil blive vist.</para>
</listitem>

<listitem>
<para
><guilabel
>Vis alarmtid</guilabel
>: Markér dette for at vise tiden når hver alarm er skemalagt.</para>
</listitem>

<listitem>
<para
><guilabel
>Vis tid til alarm</guilabel
>: Markér dette for at vise hvor lang tid der er tilbage til hver alarms næste skemalagte aktivering. Tiden vises i timer og minutter.</para>

<itemizedlist>
<listitem>
<para
><guilabel
>Præfiks</guilabel
>: Angiv et symbol eller en tekst at vise foran hvor lang tid der er tilbage til alarmen, for at skille den fra tidspunktet på hvilket alarmen er skemalagt.</para>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</listitem>

<listitem
><para
><guilabel
>Fokuseret beskedvindue</guilabel
>: Dette styrer om alarmbeskeder er fokuserede eller ej, dvs. om de tager tastaturets fokus når de vises. Se afsnittet <link linkend="message-window"
>Alarmbeskedvindue</link
> for detaljeret information.</para>
</listitem>

<listitem
><para
><guilabel
>Vis udløbne alarmer</guilabel
>: Markér dette for at vise udløbne alarmer i alarmlisten når &kalarm; starter. (Når &kalarm; er startet, bruges <menuchoice
><guimenu
>Vis</guimenu
> <guimenuitem
>Vis udløbne alarmer</guimenuitem
></menuchoice
>, til at skjule det der vises.)</para>
</listitem>

<listitem
><para
><guilabel
>Opdateringsinterval for ikon i statusfeltet</guilabel
>: Indstiller frekvensen som &kalarm;s ikon i statusfeltet opdateres for at vise om alarmer overvåges for øjeblikket. Dette omfatter en kontrol af at <application
>alarmdæmonen</application
> kører.</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="preferences-appearance">
<title
>Udseende</title>

<para
>Afsnittet <guilabel
>Udseende</guilabel
> lader dig indstille standardudseende for alarmbeskeder.</para>
<itemizedlist>

<listitem
><para
>Vælg standardskrifttype og baggrundsfarve at bruge til visning af alarmbeskeder.</para>
</listitem>

<listitem
><para
>Redigér farvevalgslisten som vises når du klikker på dropned-boksen for baggrundsfarve:</para>
<itemizedlist>

<listitem
><para
><guilabel
>Tilføj farve</guilabel
>: Viser en farvevalgsdialog som lader dig vælge en farve at tilføje til listen.</para>
</listitem>

<listitem
><para
><guilabel
>Fjern farve</guilabel
>: Fjerner farven som for øjeblikket vises i dropned-boksen <guilabel
>Baggrundsfarve</guilabel
> fra listen. Egne farveværdier kan ikke fjernes fra listen, og når de vises er knappen deaktiveret.</para>
</listitem>

</itemizedlist>
</listitem>

</itemizedlist>
</sect1>

<sect1 id="preferences-edit">
<title
>Redigér</title>

<para
>Afsnittet <guilabel
>Redigér</guilabel
> lader dig angive standardværdier for valgmulighederne i alarmredigeringsdialogen:</para>
<itemizedlist>

<listitem
><para
>Indstil tekstfarven som skal bruges til at vise udløbne alarmer i alarmlisten.</para>
</listitem>

<listitem
><para
>Sæt standardværdier for afkrydsningsboksene <guilabel
>Annullér hvis for sent</guilabel
>, <guilabel
>Bekræft besked</guilabel
> og <guilabel
>Kopiér e-post til mig selv</guilabel
>.</para>
</listitem>

<listitem
><para
>Sæt lydsignal som standardværdi for punktet <guilabel
>Lyd</guilabel
>.</para>
</listitem>

<listitem
><para
>Sæt standardtype for gentagne beskeder.</para>
</listitem>

<listitem
><para
>Sæt standardperiode for gentagne beskeder.</para>
</listitem>

</itemizedlist>
</sect1>

</chapter>

<chapter id="developers">
<title
>Udviklingsguide for &kalarm;</title>

<para
>&kalarm; sørger for en grænseflade som lader andre programmer forespørge følgende funktioner:</para>

<itemizedlist>
<listitem
><para
>skemalæg en ny alarm</para
></listitem>
<listitem
><para
>aktivér eller afbryd en allerede skemalagt alarm</para
></listitem>
<listitem
><para
>afbryd en allerede skemalagt alarm</para
></listitem>
<listitem
><para
>aktivér en allerede skemalagt alarm</para
></listitem>
</itemizedlist>

<para
>Hver af de ovennævnte funktioner implementeres både som et &DCOP;-kald og via kommandolinjen. &DCOP;-kald er at foretrække hvis &kalarm; allerede kører.</para>

<sect1 id="dcop-interface">
<title
>&DCOP;-grænseflade</title>

<refentry id="cancelEvent">
<refmeta>
<refentrytitle
>cancelEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>cancelEvent</refname>
<refpurpose
>afbryd en allerede skemalagt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void cancelEvent(const QString&amp; <replaceable
>kalenderfil</replaceable
>, const QString&amp; <replaceable
>begivenheds-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>kalenderfil</parameter
></term>
<listitem>
<para
>Angiver &URL; for kalenderfilen som indeholder begivenheden som skal annulleres.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>begivenheds-ID</parameter
></term>
<listitem>
<para
>Angiver et entydigt ID for begivenheden som skal annulleres, som opbevaret er i <replaceable
>kalenderfil</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>

<para
><function
>cancelEvent()</function
> er et &DCOP;-kald til at annullere den angivne alarm. &kalarm;  sletter alarmen fra kalenderfilen uden at vise eller køre den.</para>

<note
><para
>Parameteren <replaceable
>kalenderfil</replaceable
> bruges kun til integritetskontrol: Hvis &URL;'en angiver &kalarm;s nuværende standardkalenderfil, så ignoreres forespørgslen.</para
></note>

<note
><para
>Det gamle navn for denne funktion, <function
>cancelMessage</function
>, er beholdt for kompatibilitet, men alle nye programmer skal bruge <function
>cancelEvent</function
>.</para
></note>

</refsect1>
</refentry>

<refentry id="triggerEvent">
<refmeta>
<refentrytitle
>triggerEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>triggerEvent</refname>
<refpurpose
>udløs en allerede skemalagt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void triggerEvent(const QString&amp; <replaceable
>kalenderfil</replaceable
>, const QString&amp; <replaceable
>begivenheds-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>kalenderfil</parameter
></term>
<listitem>
<para
>Angiver &URL;'en for kalenderfilen som indeholder begivenheden som skal udløses.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>begivenheds-ID</parameter
></term>
<listitem>
<para
>Angiver et entydigt ID for begivenheden som skal udløses, som er opbevaret i <replaceable
>kalenderfil</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>

<para
><function
>triggerEvent()</function
> er et &DCOP;-kald til at udløse visning eller kørsel af den angivne alarm med det samme (uafhængig af hvilken tid den er skemalagt). &kalarm; henter alarmen fra kalenderfilen og viser den eller kører den.</para>

<para
>Hvis alarmen allerede skal aktiveres, sletter &kalarm; alle skemalagte forekomster af alarmen frem til nuværende tid, og hvis der ingen gentagelser af alarmen er tilbage, så tages alarmen bort fra kalenderfilen. Hvis alarmen ikke skal aktiveres endnu, så efterlades dens skemalagte begivenheder uforandrede.</para>

<note
><para
>Parameteren <replaceable
>kalenderfil</replaceable
> bruges kun til integritetskontrol: Hvis &URL;'en angiver &kalarm;s nuværende standardkalenderfil, så ignoreres forespørgslen.</para
></note>

<note
><para
>Det gamle navn på denne funktion, <function
>displayMessage</function
>, er beholdt for kompatibilitet, men alle nye programmer skal bruge <function
>triggerEvent</function
>.</para
></note>

</refsect1>
</refentry>

<refentry id="handleEvent">
<refmeta>
<refentrytitle
>handleEvent</refentrytitle>
</refmeta>
<refnamediv>
<refname
>handleEvent</refname>
<refpurpose
>udløs eller annullér en allerede skemalagt alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>void handleEvent(const QString&amp; <replaceable
>kalenderfil</replaceable
>, const QString&amp; <replaceable
>begivenheds-ID</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>kalenderfil</parameter
></term>
<listitem>
<para
>Angiver &URL;'en for kalenderfilen som indeholder begivenheden som skal vises/køres eller annulleres.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>begivenheds-ID</parameter
></term>
<listitem>
<para
>Angiver et entydigt ID for begivenheden som skal vises/køres eller annulleres, som er opbevaret i <replaceable
>kalenderfil</replaceable
>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>

<para
><function
>handleEvent()</function
> er et &DCOP;-kald til at vise/køre eller annullere den angivne alarm. &kalarm; henter alarmen fra kalenderfilen og afgør hvilken handling som skal udføres afhængig af hvornår alarmen skal aktiveres.</para>

<itemizedlist>
<listitem
><para
>Hvis alarmen endnu ikke skal aktiveres, sker der ingenting.</para>
</listitem>

<listitem
><para
>Hvis alarmen skal aktiveres, opfører det sig som følger. Hvis flaget for at annullere sene alarmer er sat og alarmen er for sen, dvs. den skemalagte tid for at vise den var mere end et minut siden, viser eller kører &kalarm; ikke alarmen, ellers viser eller kør &kalarm; alarmen. Hvis ingen gentagelser af alarmen stadigvæk er skemalagte, sletter &kalarm; derefter alarmen fra kalenderfilen.</para>
</listitem>
</itemizedlist>

<note
><para
>Parameteren <replaceable
>kalenderfil</replaceable
> bruges kun til integritetskontrol: Hvis &URL;'en angiver &kalarm;s nuværende standardkalenderfil, så ignoreres forespørgslen.</para
></note>

</refsect1>
</refentry>

<refentry id="scheduleMessage">
<refmeta>
<refentrytitle
>scheduleMessage</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleMessage</refname>
<refpurpose
>skemalæg en ny alarm.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>besked</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, const QFont&amp; <replaceable
>skrifttype</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, const QString&amp; <replaceable
>gentagelse</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>besked</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, const QFont&amp; <replaceable
>skrifttype</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, const QString&amp; <replaceable
>gentagelse</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>besked</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>antal_gentagelser</replaceable
>)
</synopsis>
<synopsis
>bool scheduleMessage(const QString&amp; <replaceable
>besked</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, const QColor&amp; <replaceable
>fg</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>sluttid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>besked</parameter
></term>
<listitem>
<para
>Angiver teksten for beskeden som skal skemalægges.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dato_tid</parameter
></term>
<listitem>
<para
>Angiver den skemalagte dato og tid hvor beskeden skal vises.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bg</parameter
></term>
<listitem>
<para
>Angiver baggrundsfarven beskeden vises med.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>fg</parameter
></term>
<listitem>
<para
>Angiver forgrundsfarven beskeden vises med.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>skrifttype</parameter
></term>
<listitem>
<para
>Angiver skrifttypen for beskeden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flag</parameter
></term>
<listitem>
<para
>Angiver logisk OR for de ønskede flag for alarmbeskeden. Flagbitterne er dem defineret i klassen KAlarmEvent i <filename
>alarmevent.h</filename
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lydURL</parameter
></term>
<listitem>
<para
>Angiver navn eller &URL; for en lydfil hvis indhold skal afspilles når beskeden vises.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>påmindelse</parameter
></term>
<listitem>
<para
>Angiver antal minutter i forvejen inden hovedalarmen og hver gentagelse (hvis der er nogen) som påmindelsen skal vises. Angiv 0 hvis ingen påmindelse kræves.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>gentagelse</parameter
></term>
<listitem>
<para
>Angiver en regelmæssig gentagelse af alarmen, med iCalendar-syntaks som defineret af RFC2445. For eksempel ville <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> angive fire gentagelser med tremånedersinterval den sidste mandag i måneden. For en alarm som ikke skal gentages, angives en tom streng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>enkel_gentagelsestype</parameter
></term>
<listitem>
<para
>Angiver alarmens gentagelsestype. De tilladte værdier er MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De defineres i klassen KAlarmEvent i <filename
>alarmevent.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>interval</parameter
></term>
<listitem>
<para
>Angiver antal perioder (minutter/dage/uger/måneder/år) mellem gentagelser af alarmbeskeden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>antal_gentagelser</parameter
></term>
<listitem>
<para
>Angiver antal gang som alarmbeskeden skal vises. Angiv -1 for at gentage alarmen for evigt.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1 id="scheduleMessage-descrip">
<title
>Beskrivelse</title>
<para
><function
>scheduleMessage()</function
> er et &DCOP;-kald til at skemalægge den angivne alarmbesked til visning på den angivne dato og tid. Den har flere former. De to mest generelle former tillader at en vilkårlig gentagelse angives. Brug dem også til alarmer som ikke gentages. De øvrige former sørger for bekvem adgang til en begrænset mængde gentagelsestyper, den ene angiver et gentagelsesantal og den anden en sluttid, begge bruger standardskrifttypen.</para>

<para
>Hvis den skemalagte tid (inklusive eventuelle gentagelser) allerede er overstået, viser  &kalarm; beskeden med det samme, ellers ignoreres forespørgslen hvis flaget LATE_CANCEL er sat. Hvis den skemalagte tid (eller en gentagelse) er i fremtiden, tilføjer &kalarm; alarmbeskeden til kalenderfilen for at vises senere.</para>

<para
>Brug en kodesekvens som ligner den følgende til at angive data for parametrene i &DCOP;-kaldet til <function
>scheduleMessage()</function
> for en alarm som ikke gentages, eller for alarmer som gentages regelmæssigt med iCalendar-syntaks til at angive gentagelsen:</para>

<screen
>QString message, audioFile, recurrence;
QDateTime dateTime;
QColor bgColor, fgColor;
Q_UINT32 flags;
Q_INT32 reminder;
. . .
QByteArray data;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt; message;
arg.writeRawBytes((char*)&amp;dateTime, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColour, sizeof(QColor));
arg.writeRawBytes((char*)&amp;fgColour, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; audioFile &lt;&lt; reminder &lt;&lt; recurrence;
</screen>

<para
>Brug en kodesekvens som ligner den følgende til at angive data for parametrene i &DCOP;-kaldet til <function
>scheduleMessage()</function
> for en alarm som gentages regelmæssigt uden at bruge iCalendar-syntaks:</para>

<screen
>QString message, audioFile;
QDateTime dateTime;
QColor bgColor, fgColor;
Q_UINT32 flags;
Q_INT32 reminder, repeatType, repeatCount, repeatInterval;
. . .
QByteArray data;
QDataStream arg(data, IO_WriteOnly);
arg &lt;&lt; message;
arg.writeRawBytes((char*)&amp;dateTime, sizeof(QDateTime));
arg.writeRawBytes((char*)&amp;bgColour, sizeof(QColor));
arg.writeRawBytes((char*)&amp;fgColour, sizeof(QColor));
arg &lt;&lt; flags &lt;&lt; audioFile &lt;&lt; reminder &lt;&lt; repeatType &lt;&lt; repeatCount &lt;&lt; repeatInterval;
</screen>
</refsect1>
</refentry>

<refentry id="scheduleFile">
<refmeta>
<refentrytitle
>scheduleFile</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleFile</refname>
<refpurpose
>skemalæg en ny alarm som viser indholdet i en tekst- eller billedfil.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, const QString&amp; <replaceable
>gentagelse</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>antal_gentagelser</replaceable
>)
</synopsis>
<synopsis
>bool scheduleFile(const QString&amp; <replaceable
>URL</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, const QColor&amp; <replaceable
>bg</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>lydURL</replaceable
>, int <replaceable
>påmindelse</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>sluttid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>URL</parameter
></term>
<listitem>
<para
>Angiver navn eller &URL; for en tekst- eller billedfil hvis indhold skal vises i beskeden som skemalægges.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dato_tid</parameter
></term>
<listitem>
<para
>Angiver den skemalagte dato og tiden når filen skal vises.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bg</parameter
></term>
<listitem>
<para
>Angiver baggrundsfarven for at vise filen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flag</parameter
></term>
<listitem>
<para
>Angiver logisk OR for de ønskede flag for alarmbeskeden. Flagbitterne er definerede i klassen KAlarmEvent i <filename
>alarmevent.h</filename
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>lydURL</parameter
></term>
<listitem>
<para
>Angiver navn eller &URL; for en lydfil hvis indhold skal afspilles når beskeden vises.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>påmindelse</parameter
></term>
<listitem>
<para
>Angiver antal minutter i forvejen inden hovedalarmen og hver gentagelse (hvis der er nogen) som påmindelsen skal vises. Angiv 0 hvis ingen påmindelse kræves.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>gentagelse</parameter
></term>
<listitem>
<para
>Angiver en regelmæssig gentagelse af alarmen, med iCalendar-syntaks som defineret af RFC2445. For eksempel ville <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> angive fire gentagelser med tremånedersinterval den sidste mandag i måneden. For en alarm som ikke skal gentages, angives en tom streng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>enkel_gentagelsestype</parameter
></term>
<listitem>
<para
>Angiver alarmens gentagelsestype. De tilladte værdier er MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De defineres i klassen KAlarmEvent i <filename
>alarmevent.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>interval</parameter
></term>
<listitem>
<para
>Angiver antal perioder (minutter/dage/uger/måneder/år) mellem gentagelser af alarmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>antal_gentagelser</parameter
></term>
<listitem>
<para
>Angiver antal gange som filen skal vises. Angiv -1 for at gentage alarmen for evigt.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>
<para
><function
>scheduleFile()</function
> er et &DCOP;-kald til at skemalægge en angiven tekst- eller billedfil til visning på den angivne dato og tid. Foruden at angive et filnavn eller &URL; og udelade forgrundsfarven, er brugen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivelsen af den funktion for yderligere detaljer.</para>
</refsect1>
</refentry>


<refentry id="scheduleCommand">
<refmeta>
<refentrytitle
>scheduleCommand</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleCommand</refname>
<refpurpose
>skemalæg en ny alarm som kører en skalkommando.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>kommandolinje</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>gentagelse</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>kommandolinje</replaceable
>, const QDateTime* <replaceable
>dato_tid</replaceable
>, int <replaceable
>flag</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>antal_gentagelser</replaceable
>)
</synopsis>
<synopsis
>bool scheduleCommand(const QString&amp; <replaceable
>kommandolinje</replaceable
>, const QDateTime* <replaceable
>dato_tid</replaceable
>, int <replaceable
>flag</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>sluttid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>kommandolinje</parameter
></term>
<listitem>
<para
>Angiver skalkommandoen hvis kørsel skal skemalægges.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dato_tid</parameter
></term>
<listitem>
<para
>Angiver den skemalagte dato og tid hvor kommandoen skal køres.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flag</parameter
></term>
<listitem>
<para
>Angiver logisk OR for de ønskede flag for alarmbeskeden. Flagbitterne er definerede i klassen KAlarmEvent i <filename
>alarmevent.h</filename
>, undtagen at flaget BEEP ignoreres.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>gentagelse</parameter
></term>
<listitem>
<para
>Angiver en regelmæssig gentagelse af alarmen, med iCalendar-syntaks som defineret af RFC2445. For eksempel ville <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> angive fire gentagelser med tremånedersinterval den sidste mandag i måneden. For en alarm som ikke skal gentages, angives en tom streng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>enkel_gentagelsestype</parameter
></term>
<listitem>
<para
>Angiver alarmens gentagelsestype. De tilladte værdier er MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De defineres i klassen KAlarmEvent i <filename
>alarmevent.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>interval</parameter
></term>
<listitem>
<para
>Angiver antal perioder (minutter/dage/uger/måneder/år) mellem gentagelser af alarmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>antal_gentagelser</parameter
></term>
<listitem>
<para
>Angiver antal gange som alarmen skal gentages. Angiv -1 for at gentage alarmen for evigt.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>
<para
><function
>scheduleCommand()</function
> er et &DCOP;-kald til at skemalægge en angiven skalkommandolinje for kørsel på den angivne dato og tid. Bortset fra at angive en kommandolinje og udelade beskedens farve og lydfil, er brugen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivelsen af den funktion for yderligere detaljer.</para>
</refsect1>
</refentry>


<refentry id="scheduleEmail">
<refmeta>
<refentrytitle
>scheduleEmail</refentrytitle>
</refmeta>
<refnamediv>
<refname
>scheduleEmail</refname>
<refpurpose
>skemalæg et ny alarm som sender e-post.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>adresser</replaceable
>, const QString&amp; <replaceable
>emne</replaceable
>, const QString&amp; <replaceable
>besked</replaceable
>, const QString&amp; <replaceable
>bilag</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, int <replaceable
>flag</replaceable
>, const QString&amp; <replaceable
>gentagelse</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>adresser</replaceable
>, const QString&amp; <replaceable
>emne</replaceable
>, const QString&amp; <replaceable
>besked</replaceable
>, const QString&amp; <replaceable
>bilag</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, int <replaceable
>flag</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, int <replaceable
>antal_gentagelser</replaceable
>)
</synopsis>
<synopsis
>bool scheduleEmail(const QString&amp; <replaceable
>adresser</replaceable
>, const QString&amp; <replaceable
>emne</replaceable
>, const QString&amp; <replaceable
>besked</replaceable
>, const QString&amp; <replaceable
>bilag</replaceable
>, const QDateTime&amp; <replaceable
>dato_tid</replaceable
>, int <replaceable
>flag</replaceable
>, int <replaceable
>enkel_gentagelsestype</replaceable
>, int <replaceable
>interval</replaceable
>, const QDateTime&amp; <replaceable
>sluttid</replaceable
>)
</synopsis>

<refsect2>
<title
>Parametre</title>
<variablelist>
<varlistentry>
<term
><parameter
>adresser</parameter
></term>
<listitem>
<para
>Angiver modtagarens e-postadresse. Angiv flere adresser ved at skille dem ad med kommategn.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>emne</parameter
></term>
<listitem>
<para
>Angiver emne for e-posten.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>besked</parameter
></term>
<listitem>
<para
>Angiver e-postens beskedtekst.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>bilag</parameter
></term>
<listitem>
<para
>Angiver &URL;'er for filer som skal vedlægges e-posten. Adskil flere &URL;'er med kommategn.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>dato_tid</parameter
></term>
<listitem>
<para
>Angiver den skemalagte dato og tid når e-posten skal sendes.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>flag</parameter
></term>
<listitem>
<para
>Angiver logisk OR for de ønskede flag for alarmbeskeden. Flagbitterne er definerede i klassen KAlarmEvent i <filename
>alarmevent.h</filename
></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>gentagelse</parameter
></term>
<listitem>
<para
>Angiver en regelmæssig gentagelse af alarmen, med iCalendar-syntaks som defineret af RFC2445. For eksempel ville <quote
>FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO</quote
> angive fire gentagelser med tremånedersinterval den sidste mandag i måneden. For en alarm som ikke skal gentages, angives en tom streng.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>enkel_gentagelsestype</parameter
></term>
<listitem>
<para
>Angiver alarmens gentagelsestype. De tilladte værdier er MINUTELY, DAILY, WEEKLY, MONTHLY_DAY, ANNUAL_DATE. De defineres i klassen KAlarmEvent i <filename
>alarmevent.h</filename
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>interval</parameter
></term>
<listitem>
<para
>Angiver antal perioder (minutter/dage/uger/måneder/år) mellem gentagelser af alarmen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><parameter
>antal_gentagelser</parameter
></term>
<listitem>
<para
>Angiver antal gange som e-posten skal sendes. Angiv -1 for at gentage alarmen for evigt.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title
>Beskrivelse</title>
<para
><function
>scheduleEmail()</function
> er et &DCOP;-kald til at skemalægge at sende e-post på den angivne dato og tid. Udover at angive et emne og indhold, og udelade beskedens farve og lydfil, er brugen identisk med <link linkend="scheduleMessage-descrip"
><function
>scheduleMessage</function
></link
> - se beskrivelsen af den funktion for yderligere detaljer.</para>
</refsect1>
</refentry>

</sect1>

<sect1 id="cmdline-interface">
<title
>Kommandolinjegrænseflade</title>

<para
>Kommandolinjeflag er der for at gøre det muligt for andre programmer (såsom <application
>alarmdæmonen</application
>) at starte &kalarm; hvis den ikke allerede kører, til at vise eller annullere skemalagte beskeder, eller skemalægge nye beskeder. Grunden til at kommandolinjeflag bruges til dette formål er at hvis &kalarm; startedes uden kommandolinjeflag og &DCOP;-kald siden blev sendt, så ville det starte i den forvalgte grafiske tilstand, hvilket helt klart ikke er ønskværdigt for en forespørgsel mellem programmer.</para>

<note
><para
>Programmer bør først kontrollere om &kalarm; allerede kører. Hvis dette er tilfældet, bør de i stedet bruge &DCOP;-kald til at bede om disse handlinger.</para
></note>

<para
>Kommandolinjeflagene til at skemalægge en ny alarmbesked beskrives i kapitlet <link linkend="cmdline-operation"
>Brug af &kalarm;</link
>. Valgmulighederne for at vise og annullere skemalagte alarmer er følgende:</para>

<note
><para
>Normale brugere kan også, hvis de ønsker det, bruge disse kommandolinjeflag (under antagelse af at de kan angive den nødvendige parameterinformation).</para
></note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Tilvalg</entry>
  <entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--calendarURL <replaceable
>url</replaceable
></option
></entry>
  <entry
>Brug kalenderfilen med angiven &URL;. Dette bruges kun til integritetskontrol: Hvis &URL;'en ikke angiver &kalarm;s nuværende standardkalenderfil, så ignoreres forespørgslen.</entry>
</row>
<row>
  <entry
><option
>--cancelEvent <replaceable
>begivenheds-ID</replaceable
></option
></entry>
  <entry
>Annullér begivenheden med med den angivne begivenheds-ID.</entry>
</row>
<row>
  <entry
><option
>--triggerEvent <replaceable
>begivenheds-ID</replaceable
></option
></entry>
  <entry
>Udløs begivenheden med den angivne begivenheds-ID. Handlingen som udføres er den samme som for <link linkend="handleEvent"
>triggerEvent()</link
>  &DCOP;-kaldet.</entry>
</row>
<row>
  <entry
><option
>--handleEvent <replaceable
>begivenheds-ID</replaceable
></option
></entry>
  <entry
>Udløs eller annullér begivenheden med den angivne begivenheds-ID. &kalarm; afgør hvilken handling der behøves på samme måde som for <link linkend="handleEvent"
>handleEvent()</link
>  &DCOP;-kaldet.</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<para
><option
>--cancelEvent</option
>, <option
>--triggerEvent</option
> og <option
>--handleEvent</option
> er gensidigt udelukkende. <option
>--calendarURL</option
> er valgfri, men kan kun bruges med et af de andre tre flag.</para>

<para
>Nogle eksempler:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kalarm</command
> <option
>--triggerEvent <replaceable
>&kalarm;-387486299.702</replaceable
></option
> <option
>--calendarURL <replaceable
>file:/home/zaphod/hydra.ics</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
>Spørgsmål og svar</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Hvilke konfigurationsfiler bruger &kalarm;?</para>
</question>
<answer>
<para
>Filen <filename
>$KDEHOME/share/config/kalarmrc</filename
> indeholder &kalarm;s indstillinger.</para>

<para
>Kalenderfilen som opbevarer dine skemalagte alarmbeskeder hedder <filename
>$KDEHOME/share/apps/kalarm/calendar.ics</filename
>, hvis en anden kalenderfil ikke angives i indstillingsfilen med indgangen <parameter
>Calendar</parameter
> i afsnittet <parameter
>General</parameter
>.</para>

<note
><para
>Hvis du skifter kalenderfil i indstillingsfilen, skal du også redigere <application
>alarmdæmonens</application
> konfigurationsfil <filename
>clients</filename
> for at fjerne referencen til den gamle kalenderfil. Dette skal gøres når <application
>alarmdæmonen</application
> ikke kører, for at undgå at din ændring overskrives.</para
></note>

<para
>Kalenderfilen som opbevarer dine udløbne alarmbeskeder hedder <filename
>$KDEHOME/share/apps/kalarm/expired.ics</filename
>, hvis en anden kalenderfil ikke angives i indstillingsfilen.</para>

<para
>Detaljeret information om den alarm som for øjeblikket vises, opbevares i kalenderfilen <filename
>$KDEHOME/share/apps/kalarm/displaying.ics</filename
>.</para>

</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Hvilke konfigurationsfiler bruger <application
>alarmdæmonen</application
>?</para>
</question>
<answer>
<para
>Filen <filename
>$KDEHOME/share/config/kalarmdrc</filename
> indeholder <application
>alarmdæmonens</application
> indstillinger.</para>

<para
>Filen <filename
>$KDEHOME/share/apps/kalarmd/clients</filename
> indeholder værdier for klientprogrammer som tidligere er registreret ved <application
>alarmdæmonen</application
>, og deres kalenderfiler.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Hvad er programnavnet for &kalarm; og <application
>alarmdæmonen</application
>?</para>
</question>
<answer>
<para
>&kalarm;s programnavn er <application
>kalarm</application
> og <application
>alarmdæmonens</application
> programnavn er <application
>kalarmd</application
>. Desuden, men kun i &kde;-versioner før 3.1, findes der et lille program som hedder <application
>kalarmautostart</application
>, hvis funktion er at starte &kalarm;s statusikon ved indlogning.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Medvirkende og licens</title>

<para
>&kalarm; </para>
<para
>Program ophavsret 2001, 2002, 2003 David Jarvie <email
>software@astrojar.org.uk</email
> </para>
<para
>Forfattere af alarmdæmonen: <itemizedlist>
<listitem
><para
>Preston Brown <email
>pbrown@kde.org</email
></para>
</listitem>
<listitem
><para
>David Jarvie <email
>software@astrojar.org.uk</email
></para>
</listitem>
<listitem
><para
>Cornelius Schumacher <email
>schumacher@kde.org</email
></para>
</listitem>
</itemizedlist>
</para>

<para
>Dokumentation ophavsret 2001, 2002, 2003 David Jarvie <email
>software@astrojar.org.uk</email
> </para>

&erik.kjaer.pedersen.credit; 

<para
>Tak til forfatteren af programmet KAlarm for &kde; 1, Stefan Nikolaus <email
>stefan.nikolaus@stuco.uni-oldenburg.de</email
>, som venligst gik med til at dette &kde;2/&kde;3 program måtte bruge navnet &kalarm;. </para>
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="getting-kalarm">
<title
>Hvordan får man fat på &kalarm;</title>
&install.intro.documentation; <para
>&kalarm; er tilgængeligt for &kde;2 og som en fritstående pakke for &kde;3 fra <ulink url="http://www.astrojar.org.uk/linux/kalarm.html"
>http://www.astrojar.org.uk/linux/kalarm.html</ulink
>. </para>

</sect1>

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

<para
>&kalarm; kræver at de almindelige &kde;-biblioteker er installerede (<filename
>kdelibs</filename
>-pakken). For at kompilere fra kildekode, har du også brug for &Qt; og udviklingspakken for <filename
>kdelibs</filename
>. X11-udviklingspakken, hvis den er tilstede, bruges til at forbedre &kalarm;s mulighed for at virke i &kde; uden et statusfelt.</para>

<para
>&kalarm; bruger cirka 12 Mb og <application
>alarmdæmonen</application
> bruger cirka 2,5 Mb hukommelse for at køre, men dette kan variere afhængig af platform og indstillinger.</para>

<para
>Du finder en liste over ændringer i filen <filename
>ChangeLog</filename
>, eller på <ulink url="http://www.astrojar.org.uk/linux/kalarm.html"
>http://www.astrojar.org.uk/linux/kalarm.html</ulink
>.</para>
</sect1>

<sect1 id="compilation">
<title
>Kompilering og installation</title>

<para
>Hvis du ikke kan finde en passende forkompileret binær pakke, må du kompilere &kalarm; selv fra kildefiler. Hent kildekodepakken <filename
>kdepim-x.x.tar.gz</filename
> eller <filename
>kalarm-x.x.tar.gz</filename
> (eller lignende), afhængig af om du vil installere &package; eller kun &kalarm;. Pak den ud i en ny mappe med en kommando noget i retning af <userinput
><command
>tar</command
> <option
>xvfj <replaceable
>pakke.tar.bz2</replaceable
></option
></userinput
> og gå til mappen som er blevet lavet.</para>
&install.compile.documentation; <note
><para
>Hvis du har mere end en version af &kde; installeret (t.ex &kde;2 og &kde;3), kan &kalarm; muligvis blive installeret i en forkert &kde;-mappe. Hvis det behøves kan du angive &kde;-mappen som en parameter til <userinput
><command
>./configure</command
></userinput
> . Hvis du for eksempel har installeret &kde; i <filename
>/opt/kde2</filename
>:</para>

<para
><userinput
><command
>./configure</command
> --prefix=<replaceable
>/opt/kde2</replaceable
></userinput
></para>
</note>
</sect1>

<sect1 id="configuration">
<title
>Indstilling</title>

<para
>Ingen særlig indstilling kræves til opsætning af &kalarm; til at køre på &kde;-skrivebordet. Så snart du har kørt &kalarm; første gang, startes <application
>alarmdæmonen</application
> hver gang du logger på, for at overvåge skemalagte alarmer.</para>

<para
>For at køre &kalarm; på et andet skrivebord end &kde;, er det vigtigste krav at sørge for at <application
>alarmdæmonen</application
> køres automatisk så snart du logger på. Mere detaljerede instruktioner findes i filen <filename
>INSTALL</filename
> som distribueres med &kalarm;.</para>

</sect1>

</appendix>

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

