&Anders.Lund; &Anders.Lund.mail;
&Dominik.Haumann; &Dominik.Haumann.mail;
&erik.kjaer.pedersen.role;

# Avancerede redigeringsværktøjer

## Kommentér/afkommentér

Kommentér og afkommentér-kommandoerne, der er tilgængelige fra Værktøjsmenuen tillader dig at tilføje eller fjerne kommentarmarkeringer til det udvalgte, eller den aktuelle linje hvis ingen tekst er markeret, hvis kommentarer er understøttet af det tekstformat du redigerer.

Reglerne for hvordan kommentering gøres er defineret i syntaksdefinitionerne, så hvis syntaksfremhævning ikke bruges, vil kommentering/afkommentering ikke være mulig.

Nogle formater definerer enkeltlinje kommenteringsmarkeringer, nogle multilinjemarkeringer og nogle begge. Hvis multilinjemarkeringer ikke er tilgængelige, vil kommentering af en markering der ikke fuldt indeholder dens sidste linje ikke være mulig.

Hvis enkeltlinjemarkeringer er tilgængelige, er kommentering af enkelte linjer foretrukket hvor det kan anvendes, da det hjælper med at undgå problemer med kommentarer der ligger inden i hinanden.

Når kommentarmarkeringer fjernes, bør ingen ukommenteret tekst være valgt. Når multilinje kommentarmarkeringer fjernes fra et udvalg, bliver alt hvidt udenfor kommentarmarkeringerne ignoreret.

For at placere kommentarmarkeringer bruges Værktøj Kommentér-menupunktet elle den tilsvarende tastaturgenvej, der som standard er &Ctrl;D.

For at fjerne kommentarmarkeringer bruges Værktøjer Afkommentér-menupunktet eller den tilsvarende tastaturgenvej, der som standard er &Ctrl;&Shift;D.

## Editorkomponentens kommandolinje

Kate's editorkomponent har en intern kommandolinje, som lader dig udføre visse handlinger fra en minimal grafisk grænseflade. Kommandolinjen er et tekstindtastningsfelt længst nede i redigeringsområdet. For at vise det, vælges Vis Skift til kommandolinje eller genvejstasten (normalt F7) bruges. Editoren sørger for et sæt kommandoer som er dokumenterede nedenfor, og yderligere kommandoer kan varetages af plugin.

For at udføre en kommando, skrives kommandoen og så trykkes på returtasten. Kommandolinjen angiver om kommandoen lykkedes og viser måske en meddelelse. Hvis du kom til kommandolinjen ved at trykke på F7 skjules den automatisk efter nogle sekunder. For at rydde meddelelsen og indtaste en ny kommando, trykkes på F7 igen.

Kommandolinjen har et indbygget hjælpesystem, udsted kommandoen `help` for at komme i gang. For at se en liste med alle tilgængelige kommandoer, skrives `help list`. For at vise hjælp om en bestemt kommando, skrives `help kommando`.

Kommandolinjen har en indbygget historik, så du kan genbruge kommandoer som allerede er skrevet ind. For at navigere i historikken, bruges tasterne Pil opad og Pil nedad. Når historikkommandoer vises er kommandoernes argument markerede, hvilket lader dig nemt overskrive argumenterne.

### Standardkommandoer på kommandolinjen

#### Kommandoer til at indstille editoren

Disse kommandoer sørges for af editorkomponenten og lader dig kun indstille det aktive dokument og visningen. Dette er praktisk hvis du vil bruge en indstilling som adskiller sig fra standardindstillingen, for eksempel for indrykning.

##### Argumenttyper

BOOLESK

  Denne bruges med kommandoer som slår noget til eller fra. Mulige værdier er `on` (til), `off` (fra), `true` (sand), `false` (falsk), `1` eller `0`.

HELTAL

  Et heltal

STRENG

  En streng

    set-tab-widthHELTAL bredde

  Indstiller tabulatorbredden til tallet `bredde`

    set-indent-widthHELTAL bredde

  Indstiller indrykningsbredden til tallet `bredde`. Bruges kun hvis du indrykker med mellemrum.

    set-word-wrap-columnHELTAL bredde

  Indstiller linjebredden for hårdt linjebrud til `bredde`. Dette bruges hvis du bruger automatisk linjebrud for din tekst.

    set-icon-borderBOOLESK

  Indstiller synligheden af ikonkanten.

    set-folding-markersBOOLESK aktivér

  Indstiller synligheden af foldningsmarkørruden.

    set-line-numbersBOOLESK aktivér

  Indstiller synligheden af linjenummerruden.

    set-replace-tabsBOOLESK aktivér

  Hvis aktiveret, erstattes tabulatortegn med mellemrum mens du skriver.

    set-remove-trailing-spaceBOOLESK aktivér

  Hvis aktiveret, fjernes afsluttende blanke tegn så snart markøren forlader en linje.

    set-show-tabsBOOLESK aktivér

  Hvis aktiveret, synliggøres tabulatortegn og afsluttende blanke tegn med en lille prik.

    set-indent-spacesBOOLESK aktivér

  Hvis aktiveret, indrykker editoren med `indrykningsbredde` mellemrum for hvert indrykningsniveau, i stedet for et tabulatortegn.

    set-mixed-indentBOOLESK aktivér

  Hvis aktiveret, bruger Kate en blanding af tabulatortegn og mellemrum for indrykning. Hvert indrykningsniveau har bredden `indrykningsbredde`, og flere indrykningsniveauer optimeres så at så mange tabulatortegn som muligt bruges.

  Når det udføres aktiverer kommandoen desuden indrykning med mellemrum, og hvis indrykningsbredden ikke angives indstilles den til halvdelen `tabulatorbredden` for dokumentet.

    set-word-wrapBOOLESK aktivér

  Aktiverer dynamisk linjebrud ifølge `aktivér`

    set-replace-tabs-saveBOOLESK aktivér

  Hvis aktiveret, erstattes tabulatortegn med blanke tegn så snart dokumentet gemmes.

    set-remove-trailing-space-saveBOOLESK aktivér

  Hvis aktiveret, fjernes afsluttende mellemrum fra alle linjer så snart dokumentet gemmes.

    set-indent-modenavn

  Indstiller automatisk indrykningstilstand til `navn`. Hvis `navn` ikke genkendes, indstilles tilstanden til 'none'. Gyldige tilstande er 'cstyle', 'csands', 'xml', 'python', 'varindent' og 'none'.

    set-highlightfremhævning

  Indstiller dokumentets syntaksfremhævningssystem. Argumentet skal være et gyldigt fremhævningsnavn, som vises i menuen Værktøjer Fremhævning. Kommandoen sørger for en liste for automatisk komplettering af argumentet.

#### Kommandoer for redigering

Disse kommandoer ændrer nuværende dokument.

    indent

  Indrykker de markerede linjer eller den nuværende linje.

    unindent

  Afindrykker markerede linjer eller nuværende linje.

    cleanindent

  Rydder indrykningen for markerede linjer eller nuværende linje ifølge dokumentets indrykningsindstillinger.

    comment

  Indsætter kommentarmarkeringer for at give markeringen, markerede linjer eller nuværende linje en kommentar ifølge tekstformatet som defineres af dokumentets syntaksfremhævningsdefinition.

    uncomment

  Fjerner kommentarmarkeringer fra markeringen, markerede linjer eller nuværende linje ifølge tekstformatet som defineres af dokumentets syntaksfremhævningsdefinition.

    kill-line

  Sletter den nuværende linje.

    replacemønstererstatning

  Erstatter tekst som matcher `mønster` med `erstatning`. Hvis du ønsker at `mønster` skal indeholde blanke tegn, skal både `mønster` og `erstatning` placeres indenfor enkelte eller dobbelte citationstegn. Hvis argumenterne ikke er citerede, bruges det første ord som `mønster` og resten som `erstatning`. Hvis `erstatning` er tom, fjernes hver forekomst af `mønster`.

  Du kan indstille kommandoen ved at tilføje et kolon fulgt af et eller flere bogstaver som hvert repræsenterer en indstilling, ved at angive `replace:tilvalg mønster erstatning`. Tilgængelige tilvalg er:

  `b`

    Søg baglæns.

  `c`

    Søg fra markørens position.

  `e`

    Søg kun i markeringen.

  `r`

    Udfør en søgning med et regulært udtryk. Hvis det angives, kan du bruge `\N`, hvor N er et tal, til at repræsentere fundet tekst i erstatningsstrengen.

  `s`

    Udfør versalfølsom søgning.

  `p`

    Spørg efter tilladelse til at erstatte næste forekomst.

  `w`

    Match kun hele ord.

    dateformat

  Indsætter en dato- og tidsstreng som defineres af angivet `format`, eller formatet yyyy-MM-dd hh:mm:ss hvis intet angives. Følgende oversættelser udføres når `format` tolkes:

  `d` | Dagen som et tal uden indledende nul (1-31).
  `dd` | Dagen som et tal med indledende nul (01-31).
  `ddd` | Dagens forkortede lokale navn (f.eks. 'man', 'søn').
  `dddd` | Dagens lange lokale navn (f.eks. 'mandag', 'søndag').
  `M` | Måneden som et tal uden indledende nul (1-12).
  `MM` | Måneden som et tal med indledende nul (01-12).
  `MMM` | Månedens forkortede lokale navn (f.eks. 'jan', 'dec').
  `yy` | Året som et tal med to cifre (00-99)
  `yyyy` | Året som et tal med fire cifre (1752-8000)
  `h` | Timen uden indledende nul (0-23 eller 1-12 hvis AM/PM vises).
  `hh` | Timen med indledende nul (00-23 eller 01-12 hvis AM/PM vises).
  `m` | Minut uden indledende nul (0-59).
  `mm` | Minut med indledende nul (00-59).
  `s` | Sekund uden indledende nul (0-59).
  `ss` | Sekund med indledende nul (00-59).
  `z` | Millisekunder uden indledende nul (0-999).
  `zzz` | Millisekunder med indledende nul (000-999).
  `AP` | Brug AM/PM visning. AP erstattes enten af "AM" eller "PM".
  `ap` | Brug am/pm visning. ap erstattes enten af "am" eller "pm".

    charidentifier

  Denne kommando tillader dig at indsætte tegn efter deres numeriske identifikator, i decimal, oktal eller hexadecimal form. For at bruge den starter du Redigeringskommando-dialogen og skriver `char: [number]` i indgangsfelterne, og trykker så på O.k..

  ##### `tegn`-eksempler

  Inddata: `char:234`

  Udskrift: `ê`

  Inddata: `char:0x1234`

  Udskrift: `ሴ`

`s///[ig]` `%s///[ig]`

  Denne kommando udfører en sed-lignende søg/erstat-operation på den aktuelle linje, eller på hele filen (`%s///`).

  Kort fortalt gennemsøges teksten for tekst der matcher søge-mønstret, det regulære udtryk mellem den første og anden skråstreg, og når en match findes, så erstattes den matchende del af teksten med det udtryk der er mellem den midterste og sidste del af strengen. Parenteser i søgemønstret laver tilbage-referencer,hvilket betyder at kommandoen huskler hvilken den af matchen der matchede i parenteser; disse strengs kan genbruges i erstatningsmønstret, refereret til som `\1` for det første sæt parenteser, `\2` for det andet og så videre.

  For at søge efter en rigtig ( `(` eller `)`, må du escape den ved brug af et tegnet: `\(\)`

  Hvis du tilføjer `i` tilsidst i udtrykket, bliver matchningen versalufølsom. Hvis du tilføjer `g` tilsidst, erstattes alle forekomster af mønstret, ellers erstattes kun den første forekomst.

  ##### Erstatning af tekst i den aktuelle linje

  Din meget venlige compiler stoppede netop, og fortale dig at klassen `minKlasse` nævnt i linje 3902 i din kildefil ikke er defineret.

  "Pokkers!" tænker du, det er selvfølgelig `MinKlasse`. Du går til linje 3902, og i stedet for at prøve at finde ordet i teksten, starter du Redigeringskommando-dialogen, indtaster `s/minKlasse/MinKlasse/i`, trykker på O.k.-knappen, gemmer filen og kompilerer – med held, uden fejl.

  ##### Erstatning af tekst i hele filen

  Forestil dig at du har en fil, i hvilken du nævner en Frøken Pedersen adskillige gange, og så kommer der nogen ind og fortæller dig at hun lige er blevet gift med Hr Krogh. Du vil nu selvfølgelig erstatte hver forekomst af Frøken Pedersen med Fru Krogh.

  Start kommandolinjen, og skriv kommandoen: `%s/Frøken Jensen/Fru Jensen/`, tryk på returtasten og du er færdig.

  ##### Et mere avanceret eksempel

  Dette eksempel gør brug af tilbagereferencer såvelsom tegnklasse (hvis du ikke ved hvad det er, så referér til den relaterede dokumentation nævnt nedenfor).

  Antag du har følgende linje:

      void MyClass::DoStringOps( String      &foo, String &bar String *p, int  &a, int &b )

  Du bliver nu klar over at det ikke er pæn kodning, og beslutter dig for at du ønsker at bruge `const` nøgleordet for alle adresser på argumenter, dem der er karakteriseret ved &-operatoren foran argumentnavnet. Du vil også gerne forenkle mellemrum, så der kun er 1 mellemrumstegn mellem hvert ord.

  Start Redigeringskommando-dialogen og indtast: `s/\s+(\w+)\s+(&)/ const \1 \2/g` og tryk på O.k.-knappen. `g`'et i slutningen af udtrykket får det regulære udtryk til at omkompilere for hver match og gemme til backreferences.

  Uddata: `void MyClass::DoStringOps( const String &foo, const String &bar String *p, const int &a, const int &b )`

  Operationen overstået! Hvad skete der egentlig? Vi kiggede efter mellemrum (`\s+`) fulgt af et eller flere alfabetiske tegn (`\w+`) fulgt af nogle flere mellemrum (`\s+`) fulgt af et ét-tegn, og under processen gemtes den alfabetiske stump og ét-tegnet til genbrug i erstatningsoperationen. Vi erstattede så den matchende del af vores linje med et enkelt mellemrum fulgt af const fulgt af et mellemrum fulgt af vores gemte alfabetiske stump (`\1`) fulgt af et mellemrum fulgt af vores gemte ét-tegn (`\2`)

  I visse tilfælde var vores alfabetiske stump Streng, i andre tilfælde int, så ved brug af karakterklassen `\w` og `+`-quantifier viste sig at være meget nyttig.

#### Kommandoer for navigering

    gotoHELTAL linje

  Denne kommandoen går til den angivne linje.

    findmønster

  Kommandoen går til første forekomst af `mønster` ifølge indstillingen. Følgende forekomster kan findes ved at bruge Redigér Søg igen (normal genvejstast er F3).

  Kommandoen kan indstilles ved at tilføje et kolon fulgt af et eller flere tilvalg. Formatet er `find:tilvalg mønster`. Følgende tilvalg understøttes:

  `b`

    Søg baglæns.

  `c`

    Søg fra markørens position.

  `e`

    Søg kun i markeringen.

  `r`

    Udfør en søgning med et regulært udtryk. Hvis det angives, kan du bruge `\N`, hvor N er et tal, til at repræsentere fundet tekst i erstatningsstrengen.

  `s`

    Udfør versalfølsom søgning.

  `w`

    Match kun hele ord.

    ifindmønster

  Kommandoen sørger for søgning mens du skriver. Du kan indstille opførslen eller søgningen ved at tilføje et kolon fulgt af et eller flere tilvalg, på denne måde: `ifind:tilvalg mønster`. Tilladte tilvalg er:

  `b`

    Søg baglæns.

  `r`

    Lav en søgning med et regulært udtryk.

  `s`

    Udfør versalfølsom søgning.

  `c`

    Søg fra markørens position.

## Brug af kodefoldning

Kodefoldning tillader dig at skjule dele af et dokument i editoren, hvilket gør det lettere at få overblik over store dokumenter. I &kate; udføres beregningen af områderne som kan foldes sammen ved at bruge reglerne som angives i definitionerne af syntaksfremhævning, og derfor er det kun tilgængeligt i visse formater, typisk i programkildekode, XML-markering og lignende. De fleste definitioner af syntaksfremhævning som understøtter kodefoldning lader dig også manuelt definere områderne som kan foldes sammen, typisk ved at bruge nøgleordene `BEGIN` og `END`.

For at bruge kodefoldningsfunktionen, aktiveres foldemarkører ved at bruge menupunktet Vis Vis foldemarkører hvis de ikke allerede er synlige. Foldemarkørfeltet til venstre på skærmen viser en grafisk visning af områderne som kan foldes sammen, med tegnene +/- for at angive mulige handlinger for et givet område: tegnet - betyder at området er ekspanderet, og at klikke på - folder området sammen så tegnet + vises i stedet.

Der sørges for fire kommandoer til at håndtere tilstanden af områderne som kan foldes sammen, se menudokumentationen.

Hvis du ikke vil bruge kodefoldningsfunktionen kan du deaktivere tilvalget Vis foldemarkører (om tilgængelige) på siden Udseende i indstillingen af editoren.

## Opret scripter for editorkomponenten med Javascript

### Indledning

Fra og med version 2.5, understøtter &kate;s editorkomponenten scripter med ECMA-script, også kendt som Javascript.

Scripter kan kun bruges via den indbyggede kommandolinje. Kravet er at scriptet placeres i en mappe hvor &kate; kan finde det, sammen med en valgfri .desktop-fil som definerer de tilhørende egenskaber. Den gyldige mappe hedder `katepart/scripts` i &kde;'s datamapper. Du kan finde datamapperne ved at udføre kommandoen `kde-config `--path` `data``. Du har oftest i det mindste en system og en personlig datamappe. Naturligvis er scripter i systemdatamappen tilgængelige for alle brugere på systemet, mens de i den personlige mappe kun er tilgængelige for dig selv.

Denne funktion er eksperimentel, og kommer formodentlig til at ændres i den fremtidige udvikling.

Vi ved at mange vil være skuffede over at man ikke kan tilføje scripter i menuen, eller tildele dem genvejstaster. Vi er kede af dette, men en gang i fremtiden vil det formodentlig komme til at være muligt.

Det er også endnu ikke muligt at sende en argumenter til scripter. Hav tålmodighed, så kan det tilføjes i en lys fremtid.

### Kates programmeringsgrænseflade for Javascript

Her angives det fuldstændige sæt funktioner og egenskaber som er tilgængelige i objekterne document og view. Desuden kan du naturligvis bruge alle standardobjekt såsom Math, String, Regex og så videre.

Når et script køres, er objektet `document` det nuværende dokument, og objektet `view` er den nuværende visning.

Argumenttyperne bruges naturligvis ikke i Javascript for øjeblikket, de er der kun hvor for at angive hvilken slags værdi som funktionerne forventer sig.

#### Globale funktioner

`debug( `streng`) [funktion]`

  #### parametre

  - `streng` strengen der kommer som uddata

  Skriver strengen ud på standardfejludskriften med kdDebug(). Et særligt udskriftsområde bruges for udskriften, som indledes med `Kate (KJS Scripts):`.

#### Programmeringsgrænsefladen `document`

`document.attribute( `linje` , `søjle` ); [funktion]`

  #### Parametre

  - `uint linje` Linjen for positionen hvor attributten findes.

  - `uint søjle` Søjlen for positionen hvor attributten findes.

  Returnerer den numeriske identifikator for dokumentpositionen [`linje`,`søjle`]. Attributten repræsenterar tekstens synlige udseende eller stil, og bruges også til at beregne syntaksfremhævningen for en bestemt del af teksten i blandet format såsom HTML eller PHP.

`document.canBreakAt( `Char c`, `uint attribut` ); [funktion]`

  #### Parametre

  - `c` Tegnet der skal testes

  - `attribut` Attributten på positionen for `c`.

  Returnerer om linjebrud er tilladt ved tegnet c med attributten attribut. Resultatet bestemmes ved at forespørge attributten som ejer fremhævningen om hvilke tegn som tillades ved linjebrud.

`document.canComment( `uint start_attribut`, `uint slut_attribut` ); [funktion]`

  #### Parametre

  - `start_attribut` Attributten i begyndelsen af området som skal ændres til en kommentar.

  - `slut_attribut` Attributten i slutningen af området som skal ændres til en kommentar.

  Returnerer om start_attribut og slut_attribut hører til samme syntaksfremhævningssystem. Hvis de gør det, er det fornuftigt.

  #### using canComment

      if ( document.canComment( document.attribute(1,0), document.attribute(5,0) ) ) {
          // 1,0 og 5,0 hører til samme syntaksfremhævningssystem
      }

`document.clear(); [funktion]`

  Rydder dokumentet.

`document.commentStart( `uint attribut` ); [funktion]`

  #### Parametre

  - `attribut` Attributten for teksten som strengen commentStart skal hente.

  Returnerer strengen som kræves for at starte en flerlinjekommentar for tekst med attributten, eller en tom streng hvis flerlinjekommentarer ikke understøttes for den tekst.

`document.commentMarker( `uint attribut` ); [funktion]`

  #### Parametre

  - `attribut` Attributten for teksten som strengen commentMarker skal hente

  Returnerer strengen som bruges til at markere resten af linjen som en kommentar med attributten, eller en tom streng hvis kommentarer for enkelte linjer ikke understøttes for teksten.

`document.commentEnd( `uint attribut` ); [funktion]`

  #### Parametre

  - `attribut` Attributten for teksten som strengen commentEnd skal hente

  Returnerer strengen som kræves for at afslutte en flerlinjekommentar for tekst med attributten, eller en tom streng hvis flerlinjekommentarer ikke understøttes for teksten.

`document.editBegin(); [funktion]`

  Start en redigeringsgruppe. Alle handlinger som udføres inden kaldet editEnd() grupperes som en handling at fortryde.

`document.editEnd(); [funktion]`

  Afslut en redigeringsgruppe.

`document.highlightMode; [egenskab:skrivebeskyttet]`

  Navnet på dokumentets fremhævningstilstand, såsom JavaScript eller C++. Hvis ingen syntaksfremhævningstilstand er indstillet for dokumentet, er værdien None. Bemærk at du skal bruge det engelske navn hvis det adskiller sig fra det oversatte.

`document.indentMode; [egenskab:skrivebeskyttet]`

  Navn på dokumentets indrykningstilstand, såsom `normal` eller `cstyle`. Husk at hvis ingen indrykningstilstand er indstillet er værdien `none`.

`document.indentWidth; [egenskab:skrivebeskyttet]`

  Indstiller indrykningsbredden sat for dokumentet. Dette bruges kun hvis du indrykker med mellemrum.

`document.insertLine( `uint linje`, `streng tekst` ); [funktion]`

  #### Parametre

  - `linje` dokumentets linjenummer

  - `tekst` tekst at indsætte

  Indsætter en ny linje med teksten `tekst` på linjen `linje`.

`document.insertText( `uint linje`, `uint søjle`, `streng tekst` ); [funktion]`

  #### Parametre

  - `linje` linjenummeret

  - `søjle` søjlen

  - `tekst` teksten som skal indsættes

  Indsætter teksten `tekst` på linjen `linje` og søjlen `søjle`.

document.length(); [funktion]

  Returnerer dokumentets størrelse i byte.

`document.lines(); [funktion]`

  Returnerer antal linjer i dokumentet.

document.mixedIndent; [egenskab:skrivebeskyttet]

  En boolesk værdi som angiver om indstillingen for blandet indrykning er aktiv for dokumentet. Hvis dette er tilfældet, optimeres indrykningen til at indeholde en blanding af tabulatortegn og mellemrum, ligesom den som bruges af editoren Emacs.

document.removeLine( `uint linje` ); [funktion]

  #### Parametre

  - `linje` linjenummer

  Fjerner dokumentlinjen linje.

`document.removeText( `uint startlinje`, `uint startsøjle`, `uint slutlinje`, `uint slutsøjle` ); [funktion]`

  #### Parametre

  - `startlinje` angiver startlinjen

  - `startsøjle` angiver startsøjlen

  - `slutlinje` angiver slutlinjen

  - `slutsøjle` angiver slutsøjlen

  Fjerner tekstområdet fra linjen `startlinje` og søjlen `startsøjle` frem til linjen `slutlinje` og søjlen `slutsøjle`.

`document.setText( `streng tekst` ); [funktion]`

  #### Parametre

  - `tekst` dokumentets tekst

  Ændrer hele dokumentets indhold til `tekst`.

`document.spaceIndent; [egenskab:skrivebeskyttet]`

  En boolesk værdi som angiver om indrykning med mellemrum er aktiv for dokumentet. Hvis dette er tilfældet, indrykkes dokumentet med indentWidth mellemrum pr niveau, ellers sker indrykning med et tabulatortegn pr niveau.

`document.textFull(); [funktion]`

  Returnerer hele dokumentets tekst. Hvis teksten omfatter flere linjer er linjebrudstegnet `\n`.

`document.textLine( uint linje ); [funktion]`

  #### Parametre

  - `linje` linjen

  Returnerer teksten på linjen `linje`.

`document.textRange( `uint startlinje`, `uint startsøjle`, `uint slutlinje`, `uint slutsøjle` ); [funktion]`

  #### Parametre

  - `startlinje` angiver startlinjen

  - `startsøjle` angiver startsøjlen

  - `slutlinje` angiver slutlinjen

  - `slutsøjle` angiver slutsøjlen

  Returnerer det angivne tekstområde. Hvis området omfatter flere linjer er linjebrydningstegnet `\n`.

#### Programmeringsgrænsefladen `view`

`view.clearSelection(); [funktion]`

  Afmarkerer al tekst.

`view.cursorColumn(); [funktion]`

  Returnerer den nuværende markørsøjle (tabulatortegn ekspanderes).

`view.cursorColumnReal(); [funktion]`

  Returnerer den nuværende rigtige markørsøjle (tabulatortegn regnes som et tegn).

`view.cursorLine(); [funktion]`

  Får nuværende markørs linje tilbage.

`view.hasSelection(); [funktion]`

  Returnerer `true` hvis visningen indeholder markeret tekst, ellers `false`.

`view.removeSelectedText(); [funktion]`

  Fjerner den markerede tekst, hvis visningen har en markering.

`view.selectAll(); [funktion]`

  Markerer al tekst.

`view.selection(); [funktion]`

  Returnerer den markerede tekst. Hvis markeringen omfatter flere linjer er linjebrudstegnet `\n`.

`view.selectionEndColumn; [egenskab:skrivebeskyttet]`

  Returnerer markeringens afsluttende søjle.

`view.selectionEndLine; [egenskab:skrivebeskyttet]`

  Returnerer markeringens afsluttende linje.

`view.selectionStartColumn; [egenskab:skrivebeskyttet]`

  Returnerer markeringens indledende søjle.

`view.selectionStartLine; [egenskab:skrivebeskyttet]`

  Returnerer markeringens indledende linje.

`view.setCursorPosition( `uint linje`, `uint søjle` ); [funktion]`

  #### Parametre

  - `linje` Angiver linjen for markøren.

  - `søjle` Angiver søjlen for markøren.

  Indstiller indtastningsmarkørens position i visningen til [`linje`, `søjle`]. Dette indstiller markørens position på visuel måde, dvs. at et tabulatortegn regnes om til `tabwidth` afhængig af positionen på linjen. Markørens position bliver synlig. Både linje og søjle begynder på nul.

`view.setCursorPositionReal( `uint linje`, `uint søjle` ); [funktion]`

  #### Parametre

  - `linje` Angiver linjen for markøren.

  - `søjle` Angiver søjlen for markøren.

  Indstiller indtastningsmarkørens position i visningen til [`linje`, `søjle`]. Dette indstiller strengpositionen, dvs. at et tabulatortegn regnes som 1. Markørens position bliver synlig. Både linje og søjle begynder på nul.

`view.setSelection( `uint startlinje`, `uint startsøjle`, `uint slutlinje`, `uint slutsøjle` ); [funktion]`

  #### Parametre

  - `startlinje` angiver startlinjen

  - `startsøjle` angiver startsøjlen

  - `slutlinje` angiver slutlinjen

  - `slutsøjle` angiver slutsøjlen

  Opretter en markering fra linjen `startlinje` og søjlen `startsøjle` frem til linjen `slutlinje` og søjlen `slutsøjle`.

#### Et eksempelscript

Som et eksempel laver vi et lille script som laver markeringen om til store bogstaver. Det er åbenbart at vi først skal kontrollere om en markering findes. Hvis dette er tilfældet, henter vi teksten, ændrer den til store bogstaver og erstatter den med den nye. En implementering skulle kunne se sådan her ud:

    if ( view.hasSelection() )
    {
      // laver markeringen om til store bogstaver
      column = view.selectionStartColumn;
      line = view.selectionStartLine;

      selection = view.selection().toUpperCase();

      document.editBegin();
      view.removeSelectedText();
      document.insertText( line, column, selection );
      document.editEnd();
    }

For at gruppere handlingerne sammen så de fortrydes med en enkelt aktivering af Fortryd, indkapsler vi linjerne

    view.removeSelectedText()

og

    document.insertText()

med

    document.editBegin()

og

    document.editEnd()

.

#### Et eksempel på en `.desktop`-fil

Her er et eksempel på en .desktop-fil som følger med scriptet ovenfor.

    # Eksempel på en .desktop-fil
    [Desktop Entry]
    Encoding=UTF-8
    Name=Kate Part JavaScript Uppercase
    Comment=Script to uppercase the selection
    X-Kate-Command=uppercase-selection
    X-Kate-Help=<p>Usage: <code>uppercase-selection</code></p>

Som du kan se kan du definere tegnsættet, angive et navn, en kommentar, en hjælpetekst med X-Kate-Help og kommandolinjenavnet via X-Kate-Command. Indgangene Name, Comment og X-Kate-Help oversættes automatisk til andre sprog af KDE's oversættelsesgrupper, hvis filerne findes i KDE's SVN-arkiv.

#### Sæt alting sammen

&kate; søger i scriptmapperne (se ovenfor) efter filerne `*.js`. For hver fil kontrolleres om der findes en tilsvarende `.desktop`-fil. I tilfældet uppercase.js ville der blive ledt efter uppercase.desktop.

Hvis en `.desktop`-fil ikke kan findes, registreres scriptet på kate-partens kommandolinje med filnavnet uden det afsluttende .js, så i vort tilfælde ville det være `uppercase`. Hvis kommandonavnet er godt, og du ikke behøver de ekstra funktioner som en `.desktop`-fil sørger for behøver du ikke en `.desktop`-fil i det hele taget.

Hvis en `.desktop`-fil findes, læser kate-parten navnet som scriptet skal registreres som fra indgangen X-Kate-Command i .desktop-filen, for eksempel X-Kate-Command=uppercase-selection.