ARexx-kommandon

Inställningskommandon

Inställningsposter:
ALLOWCMD ANONYMOUS AREXX BACKGROUND BGSOUND BLINK BUTTON CACHEDISK CACHEMEMORY CACHEPATH COLOUR CONSOLE COOKIES CYCLETOLIST DRAGGING EDITOR	ENDTCP FASTRESPONSE FONT FTPPROXY GOPHERPROXY HISTORYCLOSE HISTORYOPEN HOMEURL HOTLISTCLOSE HOTLISTOPEN HOTLISTREQUESTER HTMLMODE HTMLVIEWER HTTPPROXY ICONS IGNOREMIME	IMAGES IMAGEVIEWER INDEXSUFFIX KEEPFREECHIP KEEPFREEFAST LIMITEDPROXY MAILTO MAXLOCAL MAXNETWORK MIME NETSTATUSOPEN NEWS NOCACHE NOCOOKIE NOPROXY OVERLAP	PALETTE POPUP POPUPMENU SAVEPATH SCREEN SCREENPENS SHOWBUTTONS STARTHOME STARTTCP STYLE TELNET TELNETPROXY TEMPPATH ULLINKS VERIFICATION

GETCFG

Mall:


   GETCFG ITEM,VAR/K,STEM/K

Returnerar en eller flera inställningsposter.

Argument Beskrivning
ITEM Namnet på den post, grupp eller lista som skall returneras.
Om det här argumentet inte anges kommer en vektor med alla inställningar att returneras.
VAR Namnet på den variabel som skall innehålla returvärdet från en post. Om inget namn anges kommer värdet att returneras i ARexx-variabeln RESULT.
STEM Namnet på den stamvariabel som skall innehålla returvärdet i form av en vektor med poster, en grupp, en lista, eller när alla inställningsposter returneras. Inkludera inte den avslutande punkten i det här namnet.

Argument	Beskrivning
ITEM	Namnet på den post, grupp eller lista som skall returneras. Om det här argumentet inte anges kommer en vektor med alla inställningar att returneras.
VAR	Namnet på den variabel som skall innehålla returvärdet från en post. Om inget namn anges kommer värdet att returneras i ARexx-variabeln `RESULT`.
STEM	Namnet på den stamvariabel som skall innehålla returvärdet i form av en vektor med poster, en grupp, en lista, eller när alla inställningsposter returneras. Inkludera inte den avslutande punkten i det här namnet.

SETCFG

Mall:


   SETCFG ITEM,VALUE,STEM/K,ADD/S

Sätter en eller flera inställningsposter. När det här kommandot har utförts kommer de nya inställningarna att gälla och kan göra att det aktuella dokumentet ritas om (eller till och med att skärmen stängs och öppnas igen). Om du behöver sätta flera inställningar på en gång är det bäst att kombinera alla poster i en vektor, så att den eventuella extra behandlingen bara behöver göras en gång.

Argument Beskrivning
ITEM Namn på den post som skall sättas.
VALUE Värde som den angivna inställningen skall sättas till.
STEM Namn på den stamvariabel som innehåller en vektor med poster att sätta. Posterna i den här vektorn behöver inte nödvändigtvis tillhöra samma grupp eller lista.
ADD Om den här flaggan anges kommer eventuella listposter att läggas till de existerande inställningarna.
Om det här argumentet inte anges, och listposter anges, kommer listposterna att ersätta listan för den inställningsposten.

Argument	Beskrivning
ITEM	Namn på den post som skall sättas.
VALUE	Värde som den angivna inställningen skall sättas till.
STEM	Namn på den stamvariabel som innehåller en vektor med poster att sätta. Posterna i den här vektorn behöver inte nödvändigtvis tillhöra samma grupp eller lista.
ADD	Om den här flaggan anges kommer eventuella listposter att läggas till de existerande inställningarna. Om det här argumentet inte anges, och listposter anges, kommer listposterna att ersätta listan för den inställningsposten.

Stamvariabel

Stamvariabeln, som används för att returnera värden från kommandot GETCFG, eller som argument till kommandot SETCFG, innehåller en vektor med strukturerad information. Varje post i vektorn innehåller namnet och värdet på en inställningspost.

Komponenter för strukturerad information
Namn Beskrivning
ITEM Namnet på posten.
VALUE Värdet för posten.

Komponenter för strukturerad information
Namn	Beskrivning
ITEM	Namnet på posten.
VALUE	Värdet för posten.

Typer av poster

Det finns tre grundläggande typer av inställningar: poster, grupper, och listor.

Poster

En (enstaka) post är en atomär inställning som identifieras av sitt namn.

Exempel: HTMLMODE är inställningen som kontrollerar läsarens HTML-läge.

Grupper

En grupp är en uppsättning med nära relaterade poster. De olika posterna identifieras av dess gruppnamn och dess postnamn, separerade med en punkt. I kommandot GETCFG kan gruppnamnet anges för att hämta hela gruppen på en gång (till en stamvariabel).

Exempel: STYLE är en grupp som innehåller alla stilinställningar för läsaren. STYLE.H3 och STYLE.BLOCKQUOTE är två olika poster i den här gruppen.

Listor

En lista innehåller ett eller flera värden för samma post. Dessa värden kan inte nås individuellt, bara som en vektor. Vektorns poster för listan har alla samma namn.

Det är möjligt att sätta eller lägga till ett enstaka värde med kommandot SETCFG. Om flaggan ADD anges kommer värdet att läggas till listan, annars kommer värdet att ersätta alla existerande värden.

Exempel: MIME är en lista som innehåller alla mediatyper och inställningar för externa program.

Inställningsposter

ALLOWCMD

Programinställningar, alternativ: Tillåt skalkommandon i länkar.

Värde: boolskt (0 eller 1).

ANONYMOUS

Nätverksinställningar, alternativ: Läs anonymt.

Värde: boolskt (0 eller 1).

AREXX

Användargränssnittsinställningar, ARexx: ARexx-programmenyn.

En lista med de olika menyalternativen.

Värde på varje post: sträng på formatet:

   snabbval;program;titel

snabbval	Ett tal i intervallet 1..10 som representerar menysnabbvalet (1 = `höger Amiga` + `1`; 9 = `höger Amiga` + `9`; 10 = `höger Amiga` + `0`) eller 0, som representerar inget snabbval.
program	Sökväg och namn för det ARexx-program som är kopplat till menyalternativet.
titel	Text som visas i menyn.

BACKGROUND

Läsarinställningar, alternativ: Använd bakgrund och färger.

Värde: boolskt (0 eller 1).

BGSOUND

Läsarinställningar, alternativ: Använd bakgrundsljud.

Värde: boolskt (0 eller 1).

BLINK

Läsarinställningar, alternativ: Blinkhastighet.

Värde: tal i intervallet 0..40 som anger blinkhastigheten i tiondelar av en sekund. Noll betyder inget blinkande.

BUTTON

Användargränssnittsinställningar, knappar: Användarknappar.

En lista med de olika posterna.

Värde på varje post: sträng på formatet:

   etikett RM kommando

etikett	Etikett som skall visas i knappen.
RM	Ett nyradstecken (0A hexadecimalt).
kommando	ARexx-kommando som skall utföras när knappen används.

CACHEDISK

Nätverksinställningar, fickminne: Storlek på disk.

Värde: ickenegativt tal som anger storleken på fickminnet på disk, i kB.

CACHEMEMORY

Nätverksinställningar, fickminne: Storlek i minnet.

Värde: ickenegativt tal som anger storleken på fickminnet i minnet, i kB.

CACHEPATH

Nätverksinställningar, fickminne: Låda.

Värde: sträng som anger en DOS-låda.

COLOUR

Läsarinställningar, färger: Förvalda läsarfärger.

Den här gruppen innehåller följande poster:

COLOUR.BACKGROUND Dokumentets bakgrundsfärg.
COLOUR.TEXT Dokumentets textfärg.
COLOUR.LINK Färg för ej besökta hyperlänkar.
COLOUR.VLINK Färg för besökta hyperlänkar.
COLOUR.ALINK Färg för aktiva (valda) hyperlänkar.
Värde på varje post: sträng med sex hexadecimala siffror som anger RGB-färgvärdet (RRGGBB).

COLOUR.BACKGROUND	Dokumentets bakgrundsfärg.
COLOUR.TEXT	Dokumentets textfärg.
COLOUR.LINK	Färg för ej besökta hyperlänkar.
COLOUR.VLINK	Färg för besökta hyperlänkar.
COLOUR.ALINK	Färg för aktiva (valda) hyperlänkar.

CONSOLE

Programinställningar, program: Konsoll.

Värde: sträng som anger ett DOS-konsollfönster.

COOKIES

Nätverksinställningar, alternativ: Kakor.

Värde: 0, 1 eller 2:

0 Varken spara och skicka några kakor.
1 Fråga användaren innan en kaka sparas.
2 Spara och skicka kakor utan att fråga användaren.

0	Varken spara och skicka några kakor.
1	Fråga användaren innan en kaka sparas.
2	Spara och skicka kakor utan att fråga användaren.

CYCLETOLIST

Läsarinställningar, alternativ: Visa växlingsknapp som lista.

Värde: boolskt (0 eller 1).

DRAGGING

Programinställningar, alternativ: Tillåt markering.

Värde: boolskt (0 eller 1).

EDITOR

Programinställningar, program: Redigera text.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för redigeraren.
argument	Argument för redigeraren.

ENDTCP

Nätverksinställningar, program: Avsluta TCP/IP-stack.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för skript för att avsluta TCP/IP-stack.
argument	Argument för skript.

FASTRESPONSE

Nätverksinställningar, fickminne: Snabb respons.

Värde: boolskt (0 eller 1).

FONT

Läsarinställningar, teckensnitt: Läsarteckensnitt.

Den här gruppen innehåller följande poster:

FONT.N# (# = 1..7) Normalt teckensnitt för den här storleken.
FONT.F# (# = 1..7) Teckensnitt med fast bredd för den här storleken.

FONT.N# (# = 1..7)	Normalt teckensnitt för den här storleken.
FONT.F# (# = 1..7)	Teckensnitt med fast bredd för den här storleken.

Värde på varje post: sträng på formatet:

   teckensnittsnamn/teckensnittsstorlek

teckensnittsnamn	Namn på teckensnitt, inklusive ändelsen `.font`.
teckensnittsstorlek	Tal som anger teckensnittets storlek.

FTPPROXY

Nätverksinställningar, proxy: FTP.

Värde: sträng som innehåller URL:en för proxyservern, inklusive det inledande http://.

GOPHERPROXY

Nätverksinställningar, proxy: Gopher.

Värde: sträng som innehåller URL:en för proxyservern, inklusive det inledande http://.

HISTORYCLOSE

Programinställningar, alternativ: Fönsterhistoria autostängs.

Värde: boolskt (0 eller 1).

HISTORYOPEN

Programinställningar, alternativ: Öppna fönsterhistoria.

Värde: boolskt (0 eller 1).

HOMEURL

Nätverksinställningar, alternativ: Hemsida.

Värde: sträng som innehåller URL:en för läsarens hemsida.

HOTLISTCLOSE

Programinställningar, alternativ: Snabblista autostängs.

Värde: boolskt (0 eller 1).

HOTLISTOPEN

Programinställningar, alternativ: Öppna snabblista.

Värde: boolskt (0 eller 1).

HOTLISTREQUESTER

Programinställningar, alternativ: Snabblisteknapp ger fönster.

Värde: boolskt (0 eller 1).

HTMLMODE

Läsarinställningar, alternativ: HTML-läge.

Värde: 0, 1 eller 2:

0 Strikt
1 Tolerant
2 Kompatibelt

0	Strikt
1	Tolerant
2	Kompatibelt

HTMLVIEWER

Programinställningar, program: Visa HTML-kod.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för HTML-kodsvisaren.
argument	Argument för HTML-kodsvisaren.

HTTPPROXY

Nätverksinställningar, proxy: HTTP.

Värde: sträng som innehåller URL:en för proxyservern, inklusive det inledande http://.

ICONS

Programinställningar, alternativ: Skapa ikoner.

Värde: boolskt (0 eller 1).

IGNOREMIME

Nätverksinställningar, alternativ: Ignorera mediatyp.

Värde: boolskt (0 eller 1).

IMAGES

Nätverksinställningar, alternativ: Bildladdning.

Värde: 0, 1 eller 2:

0 Av
1 Bara kartor
2 Alla bilder

0	Av
1	Bara kartor
2	Alla bilder

IMAGEVIEWER

Programinställningar, program: Visa bild.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för bildvisaren.
argument	Argument för bildvisaren.

INDEXSUFFIX

Nätverksinställningar, alternativ: Lokalt index.

Värde: sträng.

KEEPFREECHIP

Nätverksinställningar, fickminne: Håll grafikminne fritt.

Värde: ickenegativt tal som anger mängden minne i kB.

KEEPFREEFAST

Nätverksinställningar, fickminne: Håll övrigt minne fritt.

Värde: ickenegativt tal som anger mängden minne i kB.

LIMITEDPROXY

Nätverksinställningar, proxy: Begränsad proxyanvändning.

Värde: boolskt (0 eller 1).

MAILTO

Nätverksinställningar, program: Mailto:.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för mailto-program eller -skript.
argument	Argument för program eller skript.

MAXLOCAL

Nätverksinställningar, alternativ: Diskläsningar.

Värde: positivt tal.

MAXNETWORK

Nätverksinställningar, alternativ: Max nätkopplingar.

Värde: positivt tal.

MIME

Läsarinställningar, visare: Mediatyper och externa visare.

Det här är en lista med de olika media- och visardefinitionerna. Observera att varje post i listan hålls unik med avseende på mediatypen. Även om du använder flaggan ADD till kommandot SETCFG kommer en definition för en mediatyp att ersätta en befintlig definition för den mediatypen.

Värde på varje post: sträng på formatet:

   typ/undertyp;ändelser;händelse;namn;argument

typ/undertyp

Mediatyp.

ändelser

Filnamnsändelser som är förvalda för den här mediatypen.

händelse

Händelse som skall utföras för den här mediatypen. Giltiga händelser är:

D	Förvald.
I	Intern.
A	Insticksmodul.
E	Externt program.
P	Externt program via PIPE: (rör).
S	Spara till disk.

namn

DOS-låda och filnamn för insticksmodul eller externt program.

argument

Argument för insticksmodul eller externt program.

NETSTATUSOPEN

Programinställningar, alternativ: Öppna nätverksstatus.

Värde: boolskt (0 eller 1).

NEWS

Nätverksinställningar, program: News:.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för news-program eller skript.
argument	Argument för program eller skript.

NOCACHE

Nätverksinställningar, fickminne: Inget fickminne för.

Det här är en lista med namn eller mönster.

Värde på varje post: sträng.

NOCOOKIE

Nätverksinställningar, alternativ: Inga kakor för.

Det här är en lista med namn eller mönster.

Värde på varje post: sträng.

NOPROXY

Nätverksinställningar, proxy: Ingen proxy för.

Det här är en lista med namn eller mönster.

Värde på varje post: sträng.

OVERLAP

Programinställningar, alternativ: Rullningsöverlappning.

Värde: ickenegativt tal.

PALETTE

Programinställningar, palett: Ändra palett.

Det här är en grupp med följande poster:

PALETTE.# (# = 0..7) Palettdefinitionen för den här pennan.
Värde på varje post: sträng med sex hexadecimala siffror som anger RGB-värdet (RRGGBB).

PALETTE.# (# = 0..7)	Palettdefinitionen för den här pennan.

POPUP

Användargränssnittsinställningar, alternativ: Popupmenyaktivering.

Värde: sträng som innehåller ingen eller flera från:

A Tangenten alt.
C Tangenten control.
M Mittenmusknapp.
R Höger musknapp.
S Tangenten skift.

A	Tangenten `alt`.
C	Tangenten `control`.
M	Mittenmusknapp.
R	Höger musknapp.
S	Tangenten `skift`.

POPUPMENU

Användargränssnittsinställningar, popup: Popupmeny.

Det här är en lista med alla individuella menyalternativ.

Värde på varje post: sträng på formatet:

   meny RM minne RM titel RM kommando

meny

Identifierare för den menysektion som det här menyalternativet tillhör:

I	Popupmeny för bilder.
L	Popupmeny för länkar.
F	Popupmeny för ramar.

Ett radmatningstecken (0A hexadecimalt).

minne

Tal som anger när menyalternativet skall visas:

1	Visa alternativet om objektet är i minnet.
2	Visa alternativet om objektet inte är i minnet.
3	Alternativet visas alltid.

För popupmenyn för ramar används inte den här indikatorn och har värdet noll.

titel

Titel som skall användas för menyalternativet.

kommando

ARexx-kommando som skall utföras när menyalternativet väljs.

SAVEPATH

Programinställningar, alternativ: Sparlåda.

Värde: sträng som anger en DOS-låda.

SCREEN

Programinställningar, skärm: Skärmdetaljer.

Det här är en grupp som innehåller följande poster:

SCREEN.TYPE Typ av skärm som AWeb skall använda.
Värde: 0, 1 eller 2:

0 Förvald allmän skärm.
1 Namngiven allmän skärm.
2 Egen allmän skärm.

SCREEN.NAME Namn på den allmäna skärm som AWeb skall använda.
Värde: sträng.
SCREEN.MODE Skärmläge för den egna allmäna skärmen.
Värde: sträng som innehåller åtta hexadecimala siffror som anger skärmens läge.
SCREEN.WIDTH Den egna allmäna skärmens bredd i bildpunkter.
Värde: positivt tal.
SCREEN.HEIGHT Den egna allmäna skärmens höjd i bildpunkter.
Värde: positivt tal.
SCREEN.DEPTH Den egna allmäna skärmens djup i antal bitplan.
Värde: positivt tal.
SCREEN.PALETTE Ladda spridd palett.
Värde: 0, 1 eller 2:

0 Av
1 Färg
2 Gråskala

SCREENPENS

Programinställningar, palett: Penninställningar.

Värde: sträng som innehåller nio pennummer separerade med mellanslag. Numret anger vilken penna som skall användas för: text, ljusa kanter, mörka kanter, aktiva titelrader i fönster, aktiva fönsternamn, bakgrund (måste vara 0), viktig text, menytext, menybakgrund.

SHOWBUTTONS

Användargränssnittsinställningar, alternativ: Visa användarknappar.

Värde: boolskt (0 eller 1).

STARTHOME

Nätverksinställningar, alternativ: Börja med hemsida.

Värde: boolskt (0 eller 1).

STARTTCP

Nätverksinställningar, program: Starta TCP/IP-stack.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för startskript för TCP/IP-stacken.
argument	Argument för skript.

STYLE

Läsarinställningar, stilar: Stilinställningar.

Det här är en grupp som innehåller följande poster:

STYLE.H1
STYLE.H2
STYLE.H3
STYLE.H4
STYLE.H5
STYLE.H6
STYLE.BIG
STYLE.SMALL
STYLE.SUB
STYLE.SUP
STYLE.ADDRESS
(rubrik nivå 1)
(rubrik nivå 2)
(rubrik nivå 3)
(rubrik nivå 4)
(rubrik nivå 5)
(rubrik nivå 6)
(stort)
(litet)
(nedsänkt)
(upphöjt)
(adress)
STYLE.BLOCKQUOTE
STYLE.CITE
STYLE.CODE
STYLE.DFN
STYLE.EM
STYLE.KBD
STYLE.PRE
STYLE.SAMP
STYLE.STRONG
STYLE.VAR
(långt citat)
(citat)
(kod)
(definition)
(emfas)
(tangentbordsinmatning)
(förformaterad text)
(exmpelutmatning)
(stark emfas)
(variabel)

STYLE.H1 STYLE.H2 STYLE.H3 STYLE.H4 STYLE.H5 STYLE.H6 STYLE.BIG STYLE.SMALL STYLE.SUB STYLE.SUP STYLE.ADDRESS	(rubrik nivå 1) (rubrik nivå 2) (rubrik nivå 3) (rubrik nivå 4) (rubrik nivå 5) (rubrik nivå 6) (stort) (litet) (nedsänkt) (upphöjt) (adress)	STYLE.BLOCKQUOTE STYLE.CITE STYLE.CODE STYLE.DFN STYLE.EM STYLE.KBD STYLE.PRE STYLE.SAMP STYLE.STRONG STYLE.VAR	(långt citat) (citat) (kod) (definition) (emfas) (tangentbordsinmatning) (förformaterad text) (exmpelutmatning) (stark emfas) (variabel)

Den stil som skall användas för motsvarande HTML-element.

Värde: för STYLE.H1 till STYLE.H6: sträng på formatet:

   teckensnittstyp;absolut storlek;stil

För övriga poster: sträng på formatet:

   teckensnittstyp;relativ storlek;stil

teckensnittstyp

Vilken slags teckensnitt som skall användas:

N	Normalt teckensnitt.
F	Teckensnitt med fast bredd.

absolut storlek

Tal i intervallet 1..7.

relativ storlek

Tal i intervallet -6..+6.

stil

Sträng som innehåller ingen eller flera från:

B	Fet.
I	Kursiv.
U	Understruken.

TELNET

Nätverksinställningar, program: Telnet:.

Värde: sträng på formatet:

   kommando;argument

kommando	DOS-låda och filnamn för telnet-program eller -skript.
argument	Argument för program eller skript.

0	Verifiera alltid.
1	Verifiera en gång per session.
2	Verifiera aldrig.