<chapter id="dev">
<chapterinfo>
<authorgroup>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
<othercredit role="translator"
> <firstname
>Johan</firstname
> <surname
>Thelmén</surname
> <affiliation
><address
><email
>jth@home.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>
<title
>Utöka &kate;</title>

<sect1 id="dev-intro">
<title
>Inledning</title>

<para
>Som alla avancerade editorer erbjuder &kate; en mängd sätt att utöka dess funktionalitet. Du kan <link linkend="dev-scripting"
>skriva enkla skript för att lägga till funktionalitet med Javascript</link
>, lägga till utökad funktionalitet i editorkomponenten med <link linkend="dev-part"
>Insticksprogram för editorkomponenten</link
>, eller lägga till ännu mer funktionalitet i själva editorn med <link linkend="dev-app"
>insticksprogram för programmet &kate; skrivna i C++</link
> eller <link linkend="dev-pate"
>&pate; insticksprogram skriva i Python</link
>. Till sist, när du väl har utökat &kate;, är du välkommen att <ulink url="http://kate-editor.org/join-us/"
>gå med</ulink
> och dela med dig av dina förbättringar med hela världen.</para>

</sect1>

<sect1 id="dev-scripting">
<title
>Skapa skript med Javascript</title>

<para
>Sedan &kappname; 3.4 i &kde; 4.4 kan &kappname;s editorkomponent enkelt utökas genom att skriva skript. Skriptspråket är ECMAscript (känt överallt som Javascript). &kappname; stöder två sorters skript: intenterings- och kommandoradskript. </para>

<sect2 id="dev-scripting-indentation">
<title
>Indenteringsskript</title>

<para
>Indenteringsskript, som också kallas indenterare, indenterar automatiskt källkoden medan texten skrivs in. Som ett exempel, efter att ha tryckt på returtangenten ökar ofta indenteringsnivån. </para>

<para
>Följande avsnitt beskriver steg för steg hur skelettet för en enkel indenterare skapas. Som första steg, skapa en ny <filename
>*.js</filename
>-fil, som t.ex. heter <filename
>javascript.js</filename
> i den lokala hemkatalogen <filename
>$KDEHOME/share/apps/katepart/script/indentation</filename
>. </para>

<sect3 id="dev-scripting-indentation-header">
<title
>Indenteringsskriptets huvud</title>
<para
>Huvudet i filen <filename
>javascript.js</filename
> är inbäddat i en kommentar, och har följande form <programlisting>
/* kate-script
 * name: JavaScript
 * author: Exempel Namn &lt;exempel.namn@någon.adress.org&gt;
 * license: BSD
 * revision: 1
 * kate-version: 3.4
 * required-syntax-style: javascript
 * indent-languages: javascript
 * priority: 0
 * i18n-catalog: min_katalog
 *
 * En rad utan kolon ':' stoppar tolkning av huvudet. Alltså kan du lägga till valfri
 * text här som en detaljerad licens.
 */
</programlisting
> Varje post förklaras nu i detalj: <itemizedlist>
<listitem
><para
><literal
>kate-script</literal
> [krävs]: Textsträngen måste finnas på första raden i <filename
>*.js</filename
>-filen, annars hoppar &kappname; över skriptet. </para
></listitem>
<listitem
><para
><literal
>name</literal
> [krävs]: Detta är indenterarens namn som visas i menyn  <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Indentering</guimenuitem
></menuchoice
> och i inställningsdialogrutan. </para
></listitem>
<listitem
><para
><literal
>author</literal
> [valfri]: Upphovsmannens namn och kontaktinformation. </para
></listitem>
<listitem
><para
><literal
>license</literal
> [valfri]: Kort form av licensen, såsom BSD eller LGPLv3. </para
></listitem>
<listitem
><para
><literal
>revision</literal
> [krävs]: Skriptets utgåva. Numret ska ökas så fort skriptet ändras. </para
></listitem>
<listitem
><para
><literal
>kate-version</literal
> [krävs]: Minimal version av &kappname; som krävs. </para
></listitem>
<listitem
><para
><literal
>required-syntax-style</literal
> [valfri]: Lista åtskild med komman av syntaxfärgläggningsstilar som krävs. Det är viktigt för indenterare som förlitar sig på specifik syntaxfärgläggningsinformation i dokumentet. Om en krävd syntaxstil specificeras, är bara indenteraren tillgänglig när lämplig syntaxfärgläggning är aktiv. Det förhindrar <quote
>odefinierat beteende</quote
> orsakat av att använda indenteraren utan den förväntade färgläggningsmetoden. Exempelvis använder sig Ruby-indenteraren sig av det i filen <filename
>ruby.js</filename
> och <filename
>ruby.xml</filename
>. </para
></listitem>
<listitem
><para
><literal
>indent-languages</literal
> [valfri]: Lista åtskild med kommatecken av syntaxstilar som indenteraren kan indentera korrekt, t.ex. c++, java. </para
></listitem>
<listitem
><para
><literal
>priority</literal
> [valfri]: Om flera indenterare är lämpliga för en viss färglagd fil, bestämmer prioriteten vilken indenterare som väljes som standardindenterare. </para
></listitem>
<listitem
><para
><literal
>i18n-catalog</literal
> [valfri]: Ytterligare meddelandekatalog (<literal
>po</literal
>-fil) inläst för översättning av indenterare från tredjepart.</para
></listitem>
</itemizedlist>
</para>

<para
>&kappname; läsera alla par av formen <quote
><replaceable
>nyckel</replaceable
>: <replaceable
>värde</replaceable
></quote
> till ett kolon inte längre hittas. Det betyder att huvudet kan innehålla valfri text som en licens, vilket visas i exemplet. </para>

</sect3>

<sect3 id="dev-scripting-indentation-body">
<title
>Indenteringens källkod</title>
<para
>Efter att ha specificerat huvudet, förklarar det här avsnittet hur själva indenteringsskriptet fungerar. Det grundläggande skelettet för implementeringen ser ut så här: <programlisting>
// nödvändiga katepart js bibliotek, t.ex. range.js om Range används
require ("range.js");

triggerCharacters = "{}/:;";
function indent(line, indentWidth, ch)
{
    // anropas för varje nyrad (ch == '\n') och alla tecken angivna i
    // den globala variabeln triggerCharacters. Vid anrop av <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Justera</guimenuitem
></menuchoice>
    // är variabeln ch tom, dvs. ch == ''.
    //
    // se också: Programmeringsgränssnittet för skripthantering
    return -2;
}
</programlisting
> Funktionen <function
>indent()</function
> har tre parametrar: <itemizedlist
> <listitem
><para
><literal
>line</literal
>: raden som ska indenteras</para
></listitem
> <listitem
><para
><literal
>indentWidth</literal
>: indenteringsbredden i antal mellanslag</para
></listitem
> <listitem
><para
><literal
>ch</literal
>: antingen ett nyradstecken (<literal
>ch == '\n'</literal
>), avtryckartecknet angivet i <literal
>triggerCharacters</literal
> eller tom om användaren utförde åtgärden <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Justera</guimenuitem
></menuchoice
>.</para
></listitem
> </itemizedlist
> Returvärdet från funktionen <function
>indent()</function
> anger hur raden kommer att indenteras. Om returvärdet är ett enkelt heltal, tolkas det på följande sätt: <itemizedlist
> <listitem
><para
>returvärde <literal
>-2</literal
>: gör ingenting</para
></listitem
> <listitem
><para
>returvärde <literal
>-1</literal
>: behåll indentering (söker efter föregående icke tomma rad)</para
></listitem
> <listitem
><para
>returvärde <literal
> 0</literal
>: tal &gt;= 0 anger indenteringsdjupet i mellanslag</para
></listitem
> </itemizedlist
> Som alternativ kan ett fält med två element returneras. <itemizedlist
> <listitem
><para
><literal
>return [ indent, align ];</literal
></para
></listitem
> </itemizedlist
> I detta fall är det först elementet indenteringsdjupet ovan med samma betydelse för specialvärden. Det andra elementet är dock ett absolutvärde som representerar en kolumn för <quote
>justering</quote
>. Om värdet är större än indenteringsvärdet, representerar skillnaden ett antal mellanslag att lägga till efter indentering av den första parametern. Annars ignoreras det andra numret. Att använda tabulator och mellanslag för indentering kallas ofta <quote
>blandat läge</quote
>. </para>

<para
>Betrakta följande exempel: Antag att tabulator används för indentering, och tabulatorbredden är inställd till 4. Här representerar &lt;tab&gt; en tabulator, och '.' ett mellanslag. <programlisting>
1: &lt;tab&gt;&lt;tab&gt;anropa("Hej",
2: &lt;tab&gt;&lt;tab&gt;......."allesamman");
</programlisting
> Vid indentering av rad 2, returnerar funktionen <function
>indent()</function
> [8, 15]. Som resultat infogas två tabulatorer för att indentera till kolumn 8, och 7 mellanslag läggs till för att justera den andra parametern under den första, så att den förblir justerad om filen visas med en annan tabulatorbredd. </para>

<para
>En standardinstallation av KDE levererar &kappname; med flera indenterare. Den motsvarande Javascript-koden finns i <filename
>$KDEDIR/share/apps/katepart/script/indentation</filename
>. </para>

<para
>Att utveckla en indenterare kräver att skript läses in igen för att se om ändringar beter sig lämpligt. Istället för att starta om programmet, byt helt enkelt till kommandoraden och utför kommandot <command
>reload-scripts</command
>. </para>

<para
>Om du utvecklar användbara skript, fundera på att bidra med det till &kappname;-projektet genom att <ulink url="mailto:kwrite-devel@kde.org"
>kontakta e-postlistan</ulink
>. </para>

</sect3>
</sect2>

<sect2 id="dev-scripting-command-line">
<title
>Kommandoradskript</title>

<para
>Eftersom det är svårt att uppfylla allas behov, stöder &kappname; små hjälpverktyg för snabb textbehandling via den <link linkend="advanced-editing-tools-commandline"
>inbyggda kommandoraden</link
>. Exempelvis är kommandot <command
>sort</command
> implementerat som ett skript. Det här avsnittet förklarar hur man skapar <filename
>*.js</filename
>-filer för att utöka &kappname; med godtyckliga hjälpskript. </para>

<para
>Kommandoradskript är placerade i samma katalog som indenteringsskript. Som första steg, skapa alltså en ny <filename
>*.js</filename
>-fil som heter <filename
>mina_verktyg.js</filename
> i den lokala hemkatalogen <filename
>$KDEHOME/share/apps/katepart/script/commands</filename
>. </para>

<sect3 id="dev-scripting-command-line-header">
<title
>Kommandoradskriptets huvud</title>
<para
>Huvudet för varje kommandoradsskript är inbäddat i en kommentar och har följande form <programlisting>
/* kate-script
 * author: Exempel Namn &lt;exempel.namn@någon.adress.org&gt;
 * license: BSD
 * revision: 1
 * kate-version: 3.4
 * type: commands
 * functions: sort, format-paragraph
 * i18n-catalog: min_katalog
 *
 * En rad utan kolon ':' stoppar tolkning av huvudet. Alltså kan du lägga till valfri
 * text här som en detaljerad licens.
 */
</programlisting
> Varje post förklaras nu i detalj: <itemizedlist>
<listitem
><para
><literal
>kate-script</literal
> [krävs]: Textsträngen måste finnas på första raden i <filename
>*.js</filename
>-filen, annars hoppar &kappname; över skriptet.</para
></listitem>
<listitem
><para
><literal
>author</literal
> [valfri]: Upphovsmannens namn och kontaktinformation.</para
></listitem>
<listitem
><para
><literal
>license</literal
> [valfri]: Kort form av licensen, såsom BSD eller LGPLv3.</para
></listitem>
<listitem
><para
><literal
>revision</literal
> [krävs]: Skriptets utgåva. Numret ska ökas så fort skriptet ändras.</para
></listitem>
<listitem
><para
><literal
>kate-version</literal
> [krävs]: Minimal version av &kappname; som krävs.</para
></listitem>
<listitem
><para
><literal
>functions</literal
> [krävs]: Lista åtskild med kommatecken av kommandon i skriptet.</para
></listitem>
<listitem
><para
><literal
>i18n-catalog</literal
> [valfri]: Ytterligare meddelandekatalog (<literal
>po</literal
>-fil) inläst för översättning av skript från tredjepart.</para
></listitem>
</itemizedlist>
</para>

<para
>&kappname; läsera alla par av formen <quote
><replaceable
>nyckel</replaceable
>: <replaceable
>värde</replaceable
></quote
> till ett kolon inte längre hittas. Det betyder att huvudet kan innehålla valfri text som en licens, vilket visas i exemplet. Värdet på nyckeln functions är en lista åtskild med kommatecken av kommandon för kommandoraden. Varje funktion är tillgänglig via &kappname;s <link linkend="advanced-editing-tools-commandline"
>inbyggda kommandorad</link
>. </para>
</sect3>

<sect3 id="dev-scripting-command-line-body">
<title
>Skriptets källkod</title>

<para
>Alla funktioner specificerade i huvudet måste implementeras i skriptet. Exempelvis måste skriptfilen i exemplet ovan implementera de två funktionerna <command
>sort</command
> och <command
>format-paragraph</command
>. Alla funktioner har följande syntax: <programlisting
>// nödvändiga katepart.js bibliotek, t.ex. range.js om Range används
require ("range.js");

function &lt;namn&gt;(arg1, arg2, ...)
{
    // ... implementering, se också: Programmeringsgränssnittet för skripthantering
}
</programlisting>
</para>

<para
>Argument på kommandoraden skickas till funktionen som <parameter
>arg1</parameter
>, <parameter
>arg2</parameter
>, etc. För att ge dokumentation av varje kommando, implementera helt enkelt funktionen '<function
>help</function
>' på följande sätt: <programlisting>
function help(cmd)
{
    if (cmd == "sort") {
        return "Sortera markerad text.";
    } else if (cmd == "...") {
        // ...
    }
}
</programlisting
> Att utföra <command
>help sort</command
> på kommandoraden anropar hjälpfunktionen med argumentet <parameter
>cmd</parameter
> inställd till det givna kommandot, dvs. <parameter
>cmd == "sort"</parameter
>. &kappname; visar därefter den returnerade texten som dokumentation för användaren. Försäkra dig om att <link linkend="dev-scripting-api-i18n"
>översätta strängarna</link
>. </para>

<sect4 id="dev-scripting-command-line-shortcuts">
<title
>Tilldela genvägar</title>
<para
>För att kunna tilldela genvägar, måste skriptet tillhandahålla en funktion som heter <literal
>action</literal
> enligt följande: <programlisting>
function action(cmd)
{
    var a = new Object();
    if (cmd == "sort") {
        a.text = i18n("Sort Selected Text");
        a.icon = "";
        a.category = "";
        a.interactive = false;
        a.shortcut = "";
    } else if (cmd == "moveLinesDown") {
        // samma för nästa åtgärd
    }
    return a;
}
</programlisting
> Funktionens parameter <literal
>cmd</literal
> anger kommandot som genvägen begärs för. Det finns flera fält som du måste ange i Javascript-objektet som returneras: <itemizedlist>
<listitem
><para
><literal
>a.text</literal
> [krävs]: Texten visas i menyn <menuchoice
><guimenu
>Verktyg</guimenu
> <guisubmenu
>Skript</guisubmenu
></menuchoice
>. Försäkra dig om att du använder <literal
>i18n</literal
> för översättning.</para
></listitem>
<listitem
><para
><literal
>a.icon</literal
> [valfri]: Ikonen visas intill texten i menyn. Alla KDE:s ikonnamn kan användas här.</para
></listitem>
<listitem
><para
><literal
>a.category</literal
> [valfri]: Om en kategori anges, visas skriptet i en undermeny. Försäkra dig om att använda <literal
>i18n</literal
> för översättning.</para
></listitem>
<listitem
><para
><literal
>a.interactive</literal
> [valfri]: If the script needs user input, set this to <literal
>true</literal
>.</para
></listitem>
<listitem
><para
><literal
>a.shortcut</literal
> [valfri]: Genvägen som anges här är förvald genväg. Exempel: Ctrl+Alt+t. Se <ulink url="http://qt-project.org/doc/qt-4.8/qt.html#Key-enum"
>Qt:s dokumentation</ulink
> för ytterligare detaljinformation.</para
></listitem>
</itemizedlist>
</para>


<para
>Att utveckla ett kommandoradskript kräver att skript läses in igen för att se om ändringar beter sig lämpligt. Istället för att starta om programmet, byt helt enkelt till kommandoraden och utför kommandot <command
>reload-scripts</command
>. </para>

<para
>Om du utvecklar användbara skript, fundera på att bidra med det till &kappname;-projektet genom att <ulink url="mailto:kwrite-devel@kde.org"
>kontakta e-postlistan</ulink
>. </para>

</sect4>
</sect3>
</sect2>

<sect2 id="dev-scripting-api">
<title
>Programmeringsgränssnittet för skripthantering</title>

<para
>Programmeringsgränssnittet för skripthantering som presenteras här är tillgängligt i alla skript, dvs. indenteringsskript och kommandon för kommandoraden. <classname
>Cursor</classname
> och <classname
>Range</classname
> tillhandahålls av biblioteksfiler i <filename
>$KDEDIR/share/apps/katepart/libraries</filename
>. Om du vill använda dem i skriptet, vilket krävs för att använda vissa av funktionerna i <classname
>Document</classname
> eller <classname
>View </classname
>, inkludera det nödvändiga biblioteket med: <programlisting
>// nödvändiga katepart.js bibliotek, t.ex. range.js om Range används
require ("range.js");
</programlisting>
</para>

<para
>För att utöka det vanliga skriptprogrammeringsgränssnittet med egna funktioner och prototyper, skapa helt enkelt en ny fil i KDE:s lokala inställningskatalog <filename
>$KDEHOME/share/apps/katepart/libraries</filename
> och inkludera den i skriptet med: <programlisting
>require ("mitt_skriptnamn.js");
</programlisting>

</para>

<para
>För att utöka befintliga prototyper som <classname
>Cursor</classname
> eller <classname
>Range</classname
>, är det rekommenderade sättet <emphasis
>inte</emphasis
> att ändra den globala <filename
>*.js</filename
>-filen. Ändra istället prototypen för <classname
>Cursor</classname
> i Javascript efter att <filename
>cursor.js</filename
> har inkluderats i skriptet via <literal
>require</literal
>. </para>

<sect3 id="dev-scripting-api-prototypes">
<title
>Markörer och intervall</title>

<para
>Eftersom &kappname; är en texteditor är alla programmeringsgränssnitt baserade på markörer och intervall om det är möjligt. En markör (Cursor) är ett enkelt par <literal
>(rad, kolumn)</literal
>, som representerar en textposition i dokumentet. Ett intervall (Range) omfattar text från en markörs startposition till en markörs slutposition. Programmeringsgränssnittet förklaras i detalj i följande avsnitt. </para>

<sect4 id="dev-scripting-api-cursors">
<title
>Prototypen för Cursor</title>

<variablelist
><varlistentry>
<term
><synopsis
>Cursor();
</synopsis
></term>
<listitem
><para
>Konstruktor. Returnerar en markör på position <literal
>(0, 0)</literal
>.</para>
<para
>Exempel: <function
>var cursor = new Cursor();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konstruktor. Returnerar en markör på position (rad, kolumn). </para>
<para
>Exempel: <function
>var cursor = new Cursor(3, 42);</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor(<parameter
>Cursor <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Kopieringskonstruktor. Returnerar en kopia av markören <replaceable
>annan</replaceable
>. </para>
<para
>Exempel: <function
>var copy = new Cursor(other);</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor Cursor.clone();
</synopsis
></term>
<listitem
><para
>Returnerar en klon av markören.</para>
<para
>Exempel: <function
>var clone = cursor.clone();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor.setPosition(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställer in markörens position till <replaceable
>rad</replaceable
> och <replaceable
>kolumn</replaceable
>.</para>
<para
>Sedan: KDE 4.11 </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Cursor.isValid();
</synopsis
></term>
<listitem
><para
>Kontrollera om markören är giltig. Markören är ogiltig om rad och/eller kolumn har värdet <literal
>-1</literal
>. </para>
<para
>Exampel: <function
>var valid = cursor.isValid();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor Cursor.invalid();
</synopsis
></term>
<listitem
><para
>Returnerar en ny ogiltig markör placerad på <literal
>(-1, -1)</literal
>. </para>
<para
>Exempel: <function
>var invalidCursor = cursor.invalid();</function
> </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>int Cursor.compareTo(<parameter
>Cursor <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Jämför den här markören med markören <replaceable
>annan</replaceable
>. Returnerar <itemizedlist>
<listitem
><para
><literal
>-1</literal
>, om den här markören är placerad innan markören <replaceable
>annan</replaceable
>,</para
></listitem>
<listitem
><para
><literal
>0</literal
>, om båda markörerna är lika, och</para
></listitem>
<listitem
><para
><literal
>+1</literal
>, om den här markören är placerad efter markören <replaceable
>annan</replaceable
>.</para
></listitem>
</itemizedlist>
</para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Cursor.equals(<parameter
>Cursor <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om den här markören och markören <replaceable
>annan</replaceable
> är lika, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String Cursor.toString();
</synopsis
></term>
<listitem
><para
>Returnerar markören som en sträng på formen <quote
><literal
>Cursor(rad, kolumn)</literal
></quote
>. </para
></listitem>
</varlistentry
></variablelist>

</sect4>


<sect4 id="dev-scripting-api-ranges">
<title
>Prototyp för Range</title>

<variablelist
><varlistentry>
<term
><synopsis
>Range();
</synopsis
></term>
<listitem
><para
>Konstruktor. Att anropa <literal
>new Range()</literal
> returnerar intervallet (0, 0) - (0, 0). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range(<parameter
>Cursor <replaceable
>start</replaceable
></parameter
>, <parameter
>Cursor <replaceable
>slut</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konstruktor. Att anropa <literal
>new Range(<replaceable
>start</replaceable
>, <replaceable
>slut</replaceable
>)</literal
> returnerar intervallet (<replaceable
>start</replaceable
>, <replaceable
>slut</replaceable
>). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range(<parameter
>int <replaceable
>startrad</replaceable
></parameter
>, <parameter
>int <replaceable
>startkolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>slutrad</replaceable
></parameter
>, <parameter
>int <replaceable
>slutkolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Constructor. Calling <literal
>new Range(<replaceable
>startrad</replaceable
>, <replaceable
>startkolumn</replaceable
>, <replaceable
>slutrad</replaceable
>, <replaceable
>slutkolumn</replaceable
>)</literal
> returnerar intervallet från (<replaceable
>startrad</replaceable
>, <replaceable
>startkolumn</replaceable
>) to (<replaceable
>startrad</replaceable
>, <replaceable
>slutkolumn</replaceable
>). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range(<parameter
>Range <replaceable
>annat</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Kopieringskonstruktor. Returnerar en kopia av intervallet <replaceable
>annat</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range Range.clone();
</synopsis
></term>
<listitem
><para
>Returnerar en klon av intervallet. </para>
<para
>Exempel: <function
>var clone = range.clone();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.isEmpty();
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om både start- och slutmarkörerna är lika. </para>
<para
>Exempel: <function
>var empty = range.isEmpty();</function
> </para>
<para
>Sedan: KDE 4.11 </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.isValid();
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om både start- och slutmarkörerna är giltiga, annars <literal
>falskt</literal
>. </para>
<para
>Exempel: <function
>var valid = range.isValid();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range Range.invalid();
</synopsis
></term>
<listitem
><para
>Returnerar intervallet från (-1, -1) till (-1, -1). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.contains(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <constant
>true</constant
> om intervallet innehåller markörpositionen, annars <constant
>false</constant
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.contains(<parameter
>Range <replaceable
>annat</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om det här intervallet innehåller intervallet <replaceable
>annat</replaceable
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.containsColumn(<parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>kolumn</replaceable
> är i det halvöppna intervallet <literal
>[startkolumn, slutkolumn)</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.containsLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>rad</replaceable
> är i det halvöppna intervallet <literal
>[startrad, slutrad)</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.overlaps(<parameter
>Range <replaceable
>annat</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om det här intervallet och intervallet <replaceable
>annat</replaceable
> delar ett gemensamt område, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.overlapsLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>rad</replaceable
> är i intervallet <literal
>[startrad, slutrad]</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.overlapsColumn(<parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>kolumn</replaceable
> är i intervallet <literal
>[startkolumn, slutkolumn]</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.onSingleLine();
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om intervallet startar och slutar på samma rad, dvs. om <replaceable
>Range.start.line == Range.end.line</replaceable
>. </para>
<para
>Sedan: KDE 4.9 </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.equals(<parameter
>Range <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om det här intervallet och intervallet <replaceable
>annat</replaceable
> är lika, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String Range.toString();
</synopsis
></term>
<listitem
><para
>Returnerar intervallet som en sträng på formen <quote
><literal
>Range(Cursor(rad, kolumn), Cursor(rad, kolumn))</literal
></quote
>. </para
></listitem>
</varlistentry
></variablelist>

</sect4>
</sect3>

<sect3 id="dev-scripting-api-global">
<title
>Globala funktioner</title>
<para
>Det här avsnittet listar alla globala funktioner.</para>


<sect4 id="dev-scripting-api-includes">
<title
>Att läsa och inkludera filer</title>

<variablelist
><varlistentry>
<term
><synopsis
>String read(<parameter
>String <replaceable
>fil</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Söker efter angiven <replaceable
>fil</replaceable
> relativt i förhållande till katalogen <literal
>katepart/script/files</literal
> och returnerar innehållet som en sträng. </para
></listitem>
</varlistentry
></variablelist>

<variablelist
><varlistentry>
<term
><synopsis
>void require(<parameter
>String <replaceable
>fil</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Söker efter angiven <replaceable
>fil</replaceable
> relativt i förhållande till katalogen <literal
>katepart/script/libraries</literal
> och utvärdera den. Internt skyddas <literal
>require</literal
> från att samma <replaceable
>fil</replaceable
> inkluderas flera gånger. </para>
<para
>Sedan: KDE 4.10 </para>
</listitem>
</varlistentry
></variablelist>

</sect4>

<sect4 id="dev-scripting-api-debug">
<title
>Felsökning</title>

<variablelist
><varlistentry>
<term
><synopsis
>void debug(<parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Skriver ut <replaceable
>text</replaceable
> på <literal
>standardutmatningen</literal
> i terminalen som startade programmet. </para
></listitem>
</varlistentry
></variablelist>

</sect4>

<sect4 id="dev-scripting-api-i18n">
<title
>Översättning</title>

<para
>För att stödja fullständig landsanpassning, finns det flera funktioner för att översätta strängar i skript, närmare bestämt <literal
>i18n</literal
>, <literal
>i18nc</literal
>, <literal
>i18np</literal
> och <literal
>i18ncp</literal
>. Funktionerna beter sig exakt likadant som <ulink url="http://techbase.kde.org/Development/Tutorials/Localization/i18n"
>KDE:s översättningsfunktioner</ulink
>. </para>

<para
>Översättningsfunktionerna översätter strängarna de omger via KDE:s översättningssystem till det språk som används i programmet. Strängar i skript som utvecklas i &kappname;s officiella källkod extraheras automatiskt och är översättningsbara. Med andra ord, som utvecklare av &kappname; behöver man inte bry dig om att extrahera och översätta meddelanden. För skript från tredjepart som utvecklas utanför KDE, måste man dock extrahera och översätta meddelandena själv. En översättningskatalog som innehåller alla översatta strängar måste distribueras tillsammans med skriptet. Dessutom måste skriptets huvud explicit definiera katalogen som ska läsas in genom att ange <literal
>i18n-catalog</literal
>. </para>

<variablelist
><varlistentry>
<term
><synopsis
>void i18n(<parameter
>String <replaceable
>text</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter <replaceable
>text</replaceable
> till språket som används av programmet. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>void i18nc(<parameter
>String <replaceable
>sammanhang</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter <replaceable
>text</replaceable
> till språket som används av programmet. Dessutom är strängen <replaceable
>sammanhang</replaceable
> synlig för översättare, så att de kan tillhandahålla en bättre översättning. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>void i18np(<parameter
>String <replaceable
>singularis</replaceable
></parameter
>, <parameter
>String <replaceable
>pluralis</replaceable
></parameter
>, <parameter
>int <replaceable
>antal</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter antingen <replaceable
>singularis</replaceable
> eller <replaceable
>pluralis</replaceable
> till språket som används av programmet, beroende på angivet <replaceable
>antal</replaceable
>. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>void i18ncp(<parameter
>String <replaceable
>sammanhang</replaceable
></parameter
>, <parameter
>String <replaceable
>singularis</replaceable
></parameter
>, <parameter
>String <replaceable
>pluralis</replaceable
></parameter
>, <parameter
>int <replaceable
>antal</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter antingen <replaceable
>singularis</replaceable
> eller <replaceable
>pluralis</replaceable
> till språket som används av programmet, beroende på angivet <replaceable
>antal</replaceable
>. Dessutom är strängen <replaceable
>sammanhang</replaceable
> synlig för översättare, så att de kan tillhandahålla en bättre översättning. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry
></variablelist>

</sect4>
</sect3>

<sect3 id="dev-scripting-api-view">
<title
>Programmeringsgränssnittet för vyn</title>
<para
>När ett skript håller på att köras, finns det en global variabel <quote
><literal
>view</literal
></quote
> som representerar den för närvarande aktiva editorvyn. Det följande är en lista med alla tillgängliga funktioner i View. <variablelist
><varlistentry>
<term
><synopsis
><function
>Cursor view.cursorPosition()</function
>
</synopsis
></term>
<listitem
><para
>Returnerar den nuvarande markörpositionen i vyn.</para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.setCursorPosition(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
void view.setCursorPosition(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställ in den nuvarande markörpositionen till antingen (rad, kolumn) eller till den givna markören. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor view.virtualCursorPosition();
</synopsis
></term>
<listitem
><para
>Returnerar den virtuella markörpositionen, där varje tabulator räknas som motsvarande antal mellanslag, beroende på nuvarande tabulatorbredd. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.setVirtualCursorPosition(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
void view.setVirtualCursorPosition(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställ in den nuvarande virtuella markörpositionen till (rad, kolumn) eller till den givna markören. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String view.selectedText();
</synopsis
></term>
<listitem
><para
>Returnerar den markerade texten. Om ingen text är markerad, är den returnerade strängen tom. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool view.hasSelection();
</synopsis
></term>
<listitem
><para
>Returnerar <constant
>true</constant
> om vyn har markerad text, annars <constant
>false</constant
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range view.selection();
</synopsis
></term>
<listitem
><para
>Returnerar det markerade textintervallet. Det returnerade intervallet är ogiltigt om det inte finns någon markerad text. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.setSelection(<parameter
>Range <replaceable
>intervall</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställer in markerad text till angivet intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.removeSelectedText();
</synopsis
></term>
<listitem
><para
>Tar bort den markerade texten. Om vyn inte har någon markerad text, händer ingenting. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.selectAll();
</synopsis
></term>
<listitem
><para
>Markerar hela texten i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.clearSelection();
</synopsis
></term>
<listitem
><para
>Rensar textmarkeringen utan att ta bort texten. </para
></listitem>
</varlistentry
></variablelist>
</para>
</sect3>

<sect3 id="dev-scripting-api-document">
<title
>Programmeringsgränssnittet för dokumentet</title>
<para
>När ett skript håller på att köras, finns det en global variabel <quote
><literal
>document</literal
></quote
> som representerar det för närvarande aktiva dokumentet. Det följande är en lista med alla tillgängliga funktioner i Document. <variablelist
><varlistentry>
<term
><synopsis
>String document.fileName();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets filnamn eller en tom sträng för osparade textbuffrar. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.url();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets fullständiga webbadress eller en tom sträng för osparade textbuffrar. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.mimeType();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets Mime-typ eller Mime-typen <literal
>application/octet-stream</literal
> om ingen lämplig Mime-typ kunde hittas. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.encoding();
</synopsis
></term>
<listitem
><para
>Returnerar den nuvarande kodningen använd för att spara filen. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>String document.highlightingMode();
</synopsis
></term>
<listitem
><para
>Returnerar det allmänna färgläggningsläget som används för hela dokumentet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>String document.highlightingModeAt(<parameter
>Cursor <replaceable
>pos</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar färgläggningsläget som används på den givna positionen i dokumentet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>Array document.embeddedHighlightingModes();
</synopsis
></term>
<listitem
><para
>Returnerar ett fält med färgläggningslägen inbäddade i det här dokumentet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>bool document.isModified();
</synopsis
></term>
<listitem
><para
>Returnerar <constant
>true</constant
> om dokumentet har osparade ändringar (är modifierat), annars <constant
>false</constant
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.text();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets hela innehåll i en enda textsträng. Nya rader är markerade med nyradstecknet <quote
><literal
>\n</literal
></quote
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.text(<parameter
>int <replaceable
>från_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>från_kolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>till_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>till_kolumn</replaceable
></parameter
>);
String document.text(<parameter
>Cursor <replaceable
>från</replaceable
></parameter
>, <parameter
>Cursor <replaceable
>till</replaceable
></parameter
>);
String document.text(<parameter
>Range <replaceable
>intervall</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar texten i det angivna intervallet. Det rekommenderas att använda markör- och intervallbaserade versioner för bättre läsbarhet hos källkoden. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.line(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar den givna textraden som en sträng. Strängen är tom om den begärda raden är utanför tillgängligt intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.wordAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
String document.wordAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar ordet på den angivna markörposition. </para
></listitem>
</varlistentry>


<varlistentry>
<term>
<synopsis
>Range document.wordRangeAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
Range document.wordRangeAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis>
</term>
<listitem
><para
>Returnerar intervallet för ordet på den givna markörpositionen. Det returnerade intervallet är ogiltigt (se Range.isValid()) om textpositionen är efter ett radslut. Om det inte finns något ord vid den givna markörpositionen returneras ett tomt intervall. </para>
<para
>Sedan: KDE 4.9 </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.charAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
String document.charAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar tacknet på den angivna markörpositionen. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.firstChar(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det första tecknet på angiven <replaceable
>rad</replaceable
> som inte är ett blanktecken. Det första tecknet finns på kolumn 0. Om raden är tom, eller bara innehåller blanktecken, är den returnerade strängen tom. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.lastChar(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det sista tecknet på angiven <replaceable
>rad</replaceable
> som inte är ett blanktecken. Om raden är tom, eller bara innehåller blanktecken, är den returnerade strängen tom. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isSpace(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isSpace(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om tecknet på den givna markörpositionen är ett blanktecken, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.matchesAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
bool document.matchesAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om given <replaceable
>text</replaceable
> matchar på den motsvarande markörpositionen, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.startsWith(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>bool <replaceable
>hoppa_över_blanktecken</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om raden börjar med <replaceable
>text</replaceable
>, annars <literal
>falskt</literal
>. Argumentet <replaceable
>hoppa_över_blanktecken</replaceable
> bestämmer om inledande blanktecken ignoreras. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.endsWith(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>bool <replaceable
>hoppa_över_blanktecken</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om raden slutar med <replaceable
>text</replaceable
>, annars <literal
>falskt</literal
>. Argumentet <replaceable
>hoppa_över_blanktecken</replaceable
> bestämmer om inledande blanktecken ignoreras. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.setText(<parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Anger hela dokumentets text. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.clear();
</synopsis
></term>
<listitem
><para
>Tar bort hela texten i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.truncate(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.truncate(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Avkortar den givna raden på den givna kolumnen eller markörpositionen. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om den givna raden inte ingår i dokumentets intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.insertText(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
bool document.insertText(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Infogar <replaceable
>text</replaceable
> på den givna markörpositionen. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.removeText(<parameter
>int <replaceable
>från_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>från_kolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>till_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>till_kolumn</replaceable
></parameter
>);
bool document.removeText(<parameter
>Cursor <replaceable
>från</replaceable
></parameter
>, <parameter
>Cursor <replaceable
>till</replaceable
></parameter
>);
bool document.removeText(<parameter
>Range <replaceable
>intervall</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Tar bort text i det givna intervallet. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.insertLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Infogar text på den givna raden. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat eller raden inte ingår i dokumentets intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.removeLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Tar bort den givna textraden. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat eller raden inte ingår i dokumentets intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.wrapLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.wrapLine(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Radbryter raden vid den givna markörpositionen. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
>, t.ex. om rad &lt; 0. </para>
<para
>Sedan: KDE 4.9 </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void document.joinLines(<parameter
>int <replaceable
>startrad</replaceable
></parameter
>, <parameter
>int <replaceable
>slutrad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Sammanfogar rader från <replaceable
>startrad</replaceable
> till <replaceable
>slutrad</replaceable
>. Två på varandra följande rader åtskiljs alltid med exakt ett mellanslag. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lines();
</synopsis
></term>
<listitem
><para
>Returnerar antal rader i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.length();
</synopsis
></term>
<listitem
><para
>Returnerar antal tecken i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lineLength(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar längden på <replaceable
>rad</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void document.editBegin();
</synopsis
></term>
<listitem
><para
>Startar en redigeringsgrupp för gruppering av ångra/gör om. Försäkra dig om att alltid anropa <function
>editEnd()</function
> lika många gånger som du anropar <function
>editBegin()</function
>. Att anropa <function
>editBegin()</function
> använder en referensräknare internt, dvs. anropet kan nästlas. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void document.editEnd();
</synopsis
></term>
<listitem
><para
>Avslutar en redigeringsgrupp. Det sista anropet av <function
>editEnd()</function
> (dvs. det för det första anropet till <function
>editBegin()</function
>) avslutar redigeringssteget. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.firstColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det första tecknet som inte är ett blanktecken på given <replaceable
>rad</replaceable
>. Om det bara finns blanktecken på raden, är returvärdet <literal
>-1</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lastColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det sista tecknet som inte är ett blanktecken på given <replaceable
>rad</replaceable
>. Om det bara finns blanktecken på raden, är returvärdet <literal
>-1</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.prevNonSpaceColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.prevNonSpaceColumn(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kolumnen med ett tecken som inte är ett blanktecken med början på given markörposition genom att söka bakåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.nextNonSpaceColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.nextNonSpaceColumn(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kolumnen med ett tecken som inte är ett blanktecken med början på given markörposition genom att söka framåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.prevNonEmptyLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar nästa rad som inte är tom och som innehåller tecken som inte är blanktecken, genom att söka bakåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.nextNonEmptyLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar nästa rad som inte är tom och som innehåller tecken som inte är blanktecken, genom att söka framåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isInWord(<parameter
>String <replaceable
>tecken</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om givet <replaceable
>tecken</replaceable
> med given <replaceable
>egenskap</replaceable
> kan vara en del av ett  ord, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.canBreakAt(<parameter
>String <replaceable
>tecken</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om givet <replaceable
>tecken</replaceable
> med given <replaceable
>egenskap</replaceable
> är lämpat att bryta en rad, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.canComment(<parameter
>int <replaceable
>startegenskap</replaceable
></parameter
>, <parameter
>int <replaceable
>slutegenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om ett intervall som börjar och slutar med den givna egenskapen är lämpat att kommenteras bort, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.commentMarker(<parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kommentarmarkören för enraderskommentarar för en given <replaceable
>egenskap</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.commentStart(<parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kommentarmarkören för början av flerraderskommentarer för en given <replaceable
>egenskap</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.commentEnd(<parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kommentarmarkören för slutet av flerraderskommentarer för en given <replaceable
>egenskap</replaceable
>. </para
></listitem>
</varlistentry>



<varlistentry>
<term
><synopsis
>int document.attribute(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.attribute(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar egenskapen på den angivna markörpositionen. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isAttribute(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
bool document.isAttribute(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om egenskapen på den givna markörpositionen är lika med <replaceable
>egenskap</replaceable
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.attributeName(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
String document.attributeName(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar egenskapsnamnet som läsbar text. Det är lika med namnet <literal
>itemData</literal
> i syntaxfärgläggningsfilerna. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isAttributeName(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>namn</replaceable
></parameter
>);
bool document.isAttributeName(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>namn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om egenskapsnamnet på en viss markörposition motsvara givet <replaceable
>namn</replaceable
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.variable(<parameter
>String <replaceable
>nyckel</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar värdet på den begärda dokumentvariabeln <replaceable
>nyckel</replaceable
>. Om dokumentvariabeln inte finns, är returvärdet en tom sträng. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.setVariable(<parameter
>String <replaceable
>nyckel</replaceable
></parameter
>, <parameter
>String <replaceable
>värde</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställ in värdet på den begärda dokumentvariabeln <replaceable
>nyckel</replaceable
>. Returnerar värdet av den inställda variabeln. </para>
<para
>Se också: <link linkend="config-variables"
>Kate-dokumentvariabler</link
> </para>
<para
>Sedan: KDE 4.8 </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.firstVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar den virtuella kolumnen för det första tecknet som inte är ett blanktecken på den givna raden, eller <literal
>-1</literal
> om raden är tom eller bara innehåller blanktecken. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lastVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar den virtuella kolumnen för det sista tecknet som inte är ett blanktecken på den givna raden, eller <literal
>-1</literal
> om raden är tom eller bara innehåller blanktecken. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.toVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.toVirtualColumn(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
Cursor document.toVirtualCursor(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konverterar den givna <quote
>verkliga</quote
> markörpositionen till en virtuell markörposition, och returnerar antingen ett heltal eller ett markörobjekt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.fromVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>virtuell_kolumn</replaceable
></parameter
>);
int document.fromVirtualColumn(<parameter
>Cursor <replaceable
>virtuell_markör</replaceable
></parameter
>);
Cursor document.fromVirtualCursor(<parameter
>Cursor <replaceable
>virtuell_markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konverterar den givna virtuella markörpositionen till en <quote
>verklig</quote
> markörposition, och returnerar antingen ett heltal eller ett markörobjekt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor document.anchor(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>Char <replaceable
>tecken</replaceable
></parameter
>);
Cursor document.anchor(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>Char <replaceable
>tecken</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Söker bakåt efter det givna tecknet med början på den givna markören. Om exempelvis '(' anges som tecken, returnerar funktionen positionen på ett inledande '('. Det sker med referensräkning, dvs. andra '(...)' ignoreras. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor document.rfind(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
> = -1</parameter
>);
Cursor document.rfind(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
> = -1</parameter
>);
</synopsis
></term>
<listitem
><para
>Söker bakåt efter den givna texten med lämplig <replaceable
>egenskap</replaceable
>. Argumentet <replaceable
>egenskap</replaceable
> ignoreras om det anges som <literal
>-1</literal
>. Den returnerade markören är ogiltig om texten inte kunde hittas. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.defStyleNum(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.defStyleNum(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar standardstilen som används på den givna markörpositionen. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isCode(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isCode(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om egenskapen på given markörposition inte är lika med någon av följande stilar: <literal
>dsComment</literal
>, <literal
>dsString</literal
>, <literal
>dsRegionMarker</literal
>, <literal
>dsChar</literal
>, <literal
>dsOthers</literal
>. </para
></listitem>
</varlistentry>



<varlistentry>
<term
><synopsis
>bool document.isComment(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isComment(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsComment</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isString(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isString(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsString</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isRegionMarker(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isRegionMarker(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsRegionMarker</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isChar(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isChar(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsChar</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isOthers(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isOthers(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsOthers</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry
></variablelist>
</para>

</sect3>
</sect2>

</sect1>

<sect1 id="dev-part">
<title
>Editorkomponentens utökningar</title>

<para
><link linkend="editor-component-plugins"
>Utökningar av editorkomponenten</link
> utökar Kate-delprogrammet, den avancerade texteditorkomponenten som används inne i många KDE-program, såsom &kate;, &kwrite;, Kile och KDevelop. Att skapa ett insticksprogram för editorkomponenten låter dig utöka editorns funktionalitet i något eller alla dessa program.</para>

<para
>För att komma igång, se <ulink url="http://techbase.kde.org/Development/Tutorials/Kate/KTextEditor_Plugins"
>Handledningen om insticksprogram för KTextEditor på &kde;:s teknikbas</ulink
>. För ännu mer, se <ulink url="http://techbase.kde.org/Development/Tutorials/Kate/KTextEditor_Plugins_Advanced"
>den avancerade handledningen, också på teknikbasen</ulink
>.</para>

<para
>Du hittar den fullständiga dokumentationen av programmeringsgränssnittet i <ulink url="http://api.kde.org/4.10-api/kdelibs-apidocs/interfaces/ktexteditor/html/"
>&kde;:s referens för programmeringsgränssnitt</ulink
>.</para>

</sect1>

<sect1 id="dev-app">
<title
>C++ insticksprogram för programmet &kate;</title>

<para
><link linkend="kate-application-plugins"
>Insticksprogram för programmet Kate</link
> utökar funktionaliteten hos själva editorn &kate; på alla sätt man kan tänka sig, med användning av samma programspråk som &kate; är skrivet i, C++.</para>

<para
>För att komma igång, se handledningen <ulink url="http://kate-editor.org/2004/01/06/writing-a-kate-plugin/"
>Skriva ett insticksprogram för &kate;på &kate;s webbplats</ulink
>. Det finns också <ulink url="http://quickgit.kde.org/?p=kate.git&amp;a=tree&amp;f=addons%2Fkate%2Fhelloworld"
>ett klassiskt <quote
>Hello world</quote
> exempelinsticksprogram inkluderat i &kate;s källkod</ulink
>.</para>

</sect1>

<sect1 id="dev-pate">
<title
>&pate; Python-insticksprogram</title>

<para
><link linkend="pate"
>&pate; insticksprogram</link
> låter dig också utöka &kate;s funktionalitet på vilket sätt du vill, med användning av programspråket Python.</para>

<para
>För att komma igång, se <ulink url="http://kate-editor.org/2012/07/01/python-plugin-developer-guide-part-1/"
>utvecklarguiden för Python-insticksprogram på &kate;s webbplats</ulink
>.</para>

<para
>Du kan också komma åt referensen för programmeringsgränssnittet på skärmen <link linkend="pate-config"
>Inställning av &pate;</link
>.</para>

</sect1>

</chapter>
