Te gebruiken elementen in de XML-beschrijving van de plugin

Eigenschappen van de elementen staan worden genoemd in een aparte sectie.

Algemene elementen

<document>

Moet aanwezig zijn in elk beschrijvend .xml-bestand als de root-node. Geen speciale functie. Geen attributen

<about> (over)

Informatie over deze plugin (auteur, licentie, etc. ) Dit element is toegestaan in zowel een afzonderlijk .xml-bestand van een plugin, als in .pluginmap-bestanden. Zie de naslag .pluginmap-bestanden voor details, het hoofdstuk over 'about'-informatie voor een inleiding.

<code> (programmacode)

Definieert waar een JS-sjabloon (template) voor de plugin kan worden gevonden. Gebruik dit slechts een keer per bestand, als een directe child van de document-tag. Attributen:

bestand

Bestandsnaam van het JS-sjabloon, relatief tot de directory waarin de plugin-xml is

<help>

Definieert waar het help-bestand van de plugin kan worden gevonden. Gebruik dit slechts een keer per bestand, als een directe child van de document-tag. Attributen:

bestand

Bestandsnaam van het help-bestand, relatief tot de directory waarin de plugin-xml is

<copy> (kopieer)

Kan worden gebruikt als een child (direct of indirect) van de elementen in de hoofdindeling, bijv. <dialog> en <wizard>. Dit wordt gebruikt om een geheel blok van 1:1-attributen van een XML-element te kopiëren. Attributen:

id

De te zoeken ID. De <copy> tag zoekt naar een eerder XML-element dat dezelfde ID heeft gekregen, en kopieert dit met alle daarvan afgeleide elementen.

copy_element_tag_name

In enkele gevallen wilt u een bijna letterlijke kopie hebben, maar de tag-naam van het gekopieerde element wijzigen. Het belangrijkste voorbeeld hiervan is wanneer u een hele <tab> wilt kopiëren uit een dialoog-interface naar de <pagina> van een assistent- interface. In dat geval stelt u copy_element_tag_name="page" in om deze conversie automatisch te doen.

Interface-definities

<dialog>

Definieert een dialoog-type interface. Plaats de GUI-definitie in deze tag. Gebruik dit slechts een keer per bestand, als een directe child van de document-tag. Ten minste een van de "dialog" (dialoog) of "wizard" (assistent) -tags is vereist voor een plugin. Attributen:

label

Koptekst van de dialoog

aanbevolen

Moet de dialoog gebruikt worden als de "aanbevolen" interface (bijv. de interface die standaard wordt getoond, tenzij de gebruiker in RKWard een specifieke standaard interface heeft ingesteld)? Dit attribuut heeft op dit moment geen effect, omdat het impliciet "true" is, tenzij de assistent (wizard) aanbevolen is.

<wizard> (assistent)

Definieert een assistent-achtige interface. Plaats de GUI-definitie in deze tag. Gebruik dit slechts een keer per bestand, als een directe child van de document-tag. Ten minste een van de "dialog" of "wizard" -tags is vereist voor een plugin. Accepteert alleen <page> of <embed>-tags als directe children. Attributen:

label

Koptekst voor de assistent

aanbevolen

Moet de dialoog gebruikt worden als de "aanbevolen" interface (bijv. de interface die standaard wordt getoond, tenzij de gebruiker in RKWard een specifieke standaard interface heeft ingesteld)? Optioneel, standaard is "false".

Elementen voor de indeling (layout)

Alle elementen in deze sectie accepteren een attribuut id="naamstring".Dit attribuut is optioneel voor alle elementen. Het kan bijvoorbeeld worden gebruikt om het hele indelingselement te tonen/verbergen, samen met alle elementen die erin zijn (zie hoofdstuk GUI-logica). De id-naamstring mag geen "." (punt) of ";" (puntkomma) bevatten, en moet algemeen gesproken worden beperkt tot alfanumerieke karakters en de lage streep ("_"). Alleen de extra attributen worden genoemd:

<page> (pagina)

Definieert een nieuwe pagina in een assistent. Alleen toegestaan als directe child van een <wizard>-element.

<row> (rij)

Alle directe children van een "row"-tag worden van links naar rechts geplaatst.

<column>

Alle directe children van een "column"-tag worden van boven naar beneden geplaatst.

<stretch> (uitrekken)

Standaard nemen elementen van een GUI alle beschikbare ruimte in beslag. Bijvoorbeeld, als u twee kolommen naast elkaar heeft, de linkse volgepakt met elementen, en de rechtse bevat alleen maar een eenzame <radio>, zal de <radio> verticaal uit worden gerekt, ook al heeft die niet werkelijk al die ruimte nodig, en ziet het er niet fraai uit. In dit geval heeft u eigenlijk lege ruimte nodig onder de <radio>. Dan gebruikt u het <stretch>-element. Dat zal alleen maar wat ruimte in beslag nemen. Gebruik dit element niet al teveel, Meestal is het goed dat GUI-elementen alle beschikbare ruimte krijgen, slechts een enkele keer niet. Voor het <stretch>-element zijn geen argumenten nodig, zelfs geen ïd" (naam). U kunt ook geen children plaatsen in het <stretch> element (met andere woorden: u gebruikt het alleen maar als "<stretch>".)

<frame> (onvertaalbaar, zoiets als raamwerk)

Tekent een lijst/vakje rondom zijn directe children. Kan worden gebruikt voor het visueel in groepen plaatsen van bij elkaar behorende opties. De indeling binnen een frame is van boven naar beneden, tenzij u er een <row> in plaatst. Attributen:

label

Koptekst voor de frame (optioneel)

activeerbaar

Frames kunnen activeerbaar (checkable) worden gemaakt. In dat geval worden alle elementen erin uitgeschakeld, wanneer de frame niet wordt geactiveerd, en aangezet wanneer die wel wordt geactiveerd. (optioneel, standaard is "false")

geactiveerd

Alleen voor activeerbare frames. Moet een frame standaard worden geactiveerd? Standaard is "true". Niet geïnterpreteerd voor niet-activeerbare frames.

<tabbook> (aantal tabbladen)

Organiseert elementen in een tabbook. Accepteert alleen <tab>-tags als directe children.

<tab> (tabblad)

Definieert een pagina in een tabbook. Plaats de GUI-definitie voor de tab in deze tag. Kan alleen worden gebruikt als een directe child van een <tabbook>-tag. Een <tabbook> moet minstens twee gedefinieerde tabs hebben. Attributen:

label

Koptekst voor de tab-pagina (vereist)

<text> (tekst)

Toont de tekst in deze tag in het GUI-element. Wat eenvoudige HTML-markeringen worden ondersteund (zoals <b>, <i>, <p>, en <br/>). Maar beperk u hierbij tot een minimum. Het invoegen van een lege regel resulteert in een einde-regel (line break). Attributen:

type

Type van de tekst. Een van "normal", "warning" (waarschuwing) of "error" (fout). Dit heeft invloed op hoe de tekst eruit ziet (optioneel, normal is standaard)

Actieve elementen

Alle elementen in deze sectie accepteren een attribuut id="naamstring". Dit attribuut is vereist voor alle elementen. Alleen de extra attributen worden genoemd. De id-string mag geen "." (punten) bevatten.

<varselector> (variabelekiezer)

Geeft een lijst van beschikbare objecten waaruit de gebruiker een of meer van kan kiezen. Heeft alleen nut als er een of meer <varslot>s zijn. Attributen:

label

Naam van de varselector (optioneel, standaard is "Select variable(s)")

<varslot>

Wordt samen gebruikt met een "varselector" om het mogelijk te maken een of meer variabelen te selecteren. Attributen:

label

Naam van de varslot (aangeraden, standaard is "Variable:")

source

De bron waaruit de varslot de selectie moet ophalen (vereist, behalve als u zelf de verbinding maakt of met behulp van source_property (bron_eigenschap))

source_property (bron_eigenschap)

Een willekeurige bron_eigenschap waaruit waarden moeten worden gekopieerd wanneer er op de selecteer-knop wordt geklikt. Indien opgegeven wordt het "source"-attribuut genegeerd.

vereist

Of - voor het indienen van de code - het vereist is dat deze varslot een geldige waarde bevat. Zie See vereist-eigenschap (optioneel, standaard is false)

multi

Of de varslot slechts een (standaard, "false") of meerdere objecten bevat

allow_duplicates (duplicaten_ toestaan)

Of de varslot alleen unieke objecten (standaard, "false") mag bevatten, of dat hetzelfde object er meerdere keren er aan kan worden toegevoegd.

min_vars

Alleen zinvol als multi="true". Minimum aantal variabelen dat gekozen moet worden voor een geldige selectie (optioneel, standaard is "1")

min_vars_if_any (minimum_aantal_variabelen_indien_aanwezig)

Alleen zinvol als multi="true": Sommige varslots kunnen als geldig worden beschouwd, als bijvoorbeeld de varslot of leeg is, of tenminste twee waarden bevat. Hiermee wordt opgegeven hoeveel variabelen er moeten worden geselecteerd, als er sowieso variabelen worden geselecteerd (2 in het voorbeeld). (optioneel, standaard is "1")

max_vars

Alleen zinvol als multi="true". Maximum aantal variabelen dat gekozen kan worden (optioneel, standaard is "0", wat betekent geen maximum)

classes (klassen, maar onvertaalbaar, want term uit de programmeertaal)

Indien u een of meer R-class-namen opgeeft (gescheiden door spaties (" "), accepteert de varslot alleen variabelen die tot die classes behoren (optioneel, gebruik dit heel voorzichtig). De gebruiker moet niet beperkt worden in het maken van geldige keuzes, en R heeft heel veel verschillende classes!)

typen

Indien u een of meer variabelen-typen opgeeft (gescheiden door spaties (" "), accepteert de varslot alleen objecten met deze types. Geldige typen zijn "unknown" (onbekend), "number" (getal), "string", "factor", "invalid" (ongeldig). Optioneel, gebruik dit heel voorzichtig). De gebruiker moet niet beperkt worden in het maken van geldige keuzes, en RKWard kent niet altijd het type van een variabele)

num_dimensions (aantal_dimensies)

Het aantal dimensies dat een object moet hebben. "0" (standaard) betekent dat elk aantal dimensies wordt geaccepteerd. (optioneel, standaard is "0")

min_length

De kleinste lengte die een object mag hebben. (optioneel, standaard is "0")

max_length

De grootste lengte die een object kan hebben. (optioneel, standaard is die het grootste gehele getal dat in het systeemgeheugen kan worden opgeslagen)

<valueselector> (waarde selector)

Geeft een lijst van beschikbare strings (geen R-objecten) die kunnen worden geselecteerd in een of meer bijgaande <valueslot>s.String-opties kunnen worden gedefinieerd met <option>-tags als directe children (zie onder), of door instellen van dynamische eigenschappen. Attributen:

label

Naam van de varselector (optioneel, standaard is geen naam (label))

<valueslot>

Gebruikt samen met een <valueselector> zodat de gebruiker een of meer string items kan selecteren. Dit element is voor een groot deel identiek aan <varslot>, en deelt dezelfde attributen, behalve die die naar eigenschappen verwijzen van de toegestane items (bijv. classes, types, num_dimensions, min_length, max_length).

<radio> (radioknoppen, selectierondjes)

Definieert een groep van knoppen voor radio alleen (slechts een kan op enig moment geselecteerd zijn). Vereist minstens twee <option>-tags als directe children. Andere tags zijn niet toegestaan als children. Attributen:

label

Naam van de radioknoppen (aanbevolen, standaard is "selecteer een:")

<dropdown> (neerklapmenu)

Definieert een groep opties waarvan er een en slechts een tegelijk kan worden geselecteerd, in een keuzelijst (dropdown list). Dit is functioneel gelijk aan een <radio>, maar ziet er anders uit. Vereist minstens twee <option>-tags als directe children. Geen andere tags zijn toegestaan als children. Attributen:

label

Naam van de keuzelijst (aanbevolen, standaard is "Selecteer een:")

<select> (kies, selecteer)

Geeft een lijst van beschikbare strings waaruit de gebruiker een of meer kan kiezen. String-opties kunnen worden gedefinieerd met <option>-tags als directe children (zie onder) of door dynamische eigenschappen in te stellen. Attributen:

label

Naam voor de <select> (optioneel, standaard is geen naam)

Enkel

Indien op waar ingesteld, is alleen een enkele waarde selecteerbaar, in plaats van meerdere waarden tegelijk (logische waarde, standaard is onwaar)

<option> (optie)

Kan alleen worden gebruikt als een directe child van een <radio>, <dropdown>, <valueselector> of <select>-element. Omdat <option>-elementen altijd deel uitmaken van een van de selectie-elementen, hebben zij gewoonlijk zelf geen "id" (naam), maar zie onder. Attributen:

label

Naam voor de optie (vereist)

waarde

De stringwaarde die het parent-element teruggeeft indien deze optie wordt gekozen/geselecteerd (vereist)

geactiveerd

Of de optie standaard "true" of "false" moet worden gekozen/geselecteerd. In een <radio> of <dropdown>, kan slechts een optie worden ingesteld opchecked="true", en indien er geen optie is ingesteld, wordt het eerste element automatisch gekozen/ geselecteerd. In een <select>, kan elk aantal opties worden ingesteld op gekozen. (optioneel, standaard is "false")

id

Opgeven van de "id"-parameter (naam) voor de <option>-elementen is optioneel (en feitelijk wordt het instellen van een "id" afgeraden, tenzij u er werkelijk een nodig heeft). Maar het opgeven van een "id" maakt het wel mogelijk <option>s dynamisch aan/uit te zetten, door te verbinden met de booleaanse eigenschap id_of_radio.id_of_optionX.enabled. Op dit moment werkt dit alleen voor opties in <radio> of <dropdown>-elementen; <valueselector> en <select>-opties ondersteunen op dit moment geen ids.

<checkbox> (keuzevakje)

Definieert een keuzevakje. bijv. een enkele optie die alleen kan worden ingesteld op aan of uit. Attributen:

label

Naam voor het keuzevakje (vereist)

waarde

De waarde die door het keuzevakje wordt teruggegeven indien gekozen (vereist)

value_unchecked

De waarde die door het keuzevakje wordt teruggegeven indien niet gekozen (optioneel, standaard is "", bijv. een lege string)

geactiveerd

Of de optie standaard "true" moet zijn of "false" (optioneel, standaard is "false")

<frame> (onvertaalbaar, zoiets als raamwerk)

Het frame-element wordt gewoonlijk zuiver gebruikt als een layout (indelings) element, en wordt genoemd in de sectie over indelings elementen. Echter, het kan ook kiesbaar worden gemaakt, en dus tegelijkertijd optreden als een eenvoudig keuze-element.

<input> (invoer)

Definieert een vrij veld voor tekstinvoer. Attributen:

label

Naam voor het invoerveld (vereist)

aanvankelijk

Aanvangstekst voor het tekstveld (optioneel, standaard is "", bijv. een lege string)

grootte

Te kiezen uit "small" (klein), "medium" (middelgroot), of "large" (groot). "large" definieert een invoerveld met meerdere regels. "small" en "medium" velden met maar een regel (optioneel, standaard is "medium")

vereist

Of het - voor het indienen van de code - vereist is dat deze invoer niet leeg is. Zie vereist-eigenschap (optioneel, standaard is false)

<matrix>

Een tabel voor het invoeren van matrix-gegevens (of vectoren) in de GUI.

Opmerking

Dit invoer-element is niet geoptimaliseerd voor het invoeren/ bewerken van grote hoeveelheden gegevens. Hoewel er geen strikte grens is aan de grootte van een <matrix>, moet die in het algemeen niet groter zijn dan tien rijen/kolommen. Als u meer gegevens verwacht, kunt u het mogelijk maken die als een R-object te selecteren (wat een goed idee kan zijn als alternatieve optie, in bijna alle gevallen dat een matrix-element nodig is).

Attributen:

label

Naam van de tabel (vereist)

modus

Een van "integer" (geheel getal), "real" (kommagetal) of "string" (rij karakters tussen aanhalingstekens). Het type van gegevens die in de tabel worden geaccepteerd (vereist)

min

Kleinste acceptabele waarde (voor matrices van het type "integer" of "real") (optioneel, standaard is kleinste getal dat kan woorden weergegeven)

max

Grootste acceptabele waarde (voor matrices van het type "integer" of "real") (optioneel, standaard is grootste getal dat kan woorden weergegeven)

ontbrekende waarden toestaan

Of ontbrekende (lege) waarden in de matrix worden toegestaan. Dit is bedoeld voor matrices met modus "string" (Optioneel, standaard is false).

allow_user_resize_columns

Indien ingesteld op true, kan de gebruiker kolommen toevoegen door in de meest rechtse (inactieve) cellen te typen (optioneel, standaard is true).

allow_user_resize_rows

Indien ingesteld op true, kan de gebruiker rijen toevoegen door in de onderste (inactieve) cellen te typen (optioneel, standaard is true).

rows

Aantal rijen in de matrix. Heeft geen effect op allow_user_resize_rows="true".

Opmerking

Dit kan ook worden geregeld door instellen van de "rows"-eigenschap.

(optioneel, standaard is 2).

columns

Aantal kolommen in de matrix. Heeft geen effect op allow_user_resize_columns="true".

Opmerking

Dit kan ook worden geregeld door instellen van de "columns"-eigenschap.

(optioneel, standaard is 2).

min_rows

Kleinste aantal rijen in de matrix. De matrix kan niet tot onder deze waarde worden ingekrompen. (optioneel, standaard is 0: zie ook: allow_missings.).

min_columns

Kleinste aantal kolommen in de matrix. De matrix kan niet tot onder deze waarde worden ingekrompen. (optioneel, standaard is 0: zie ook: allow_missings.).

fixed_height (vaste hoogte)

Zodat het GUI-element zijn originele hoogte behoudt. Gebruik dit niet samen met matrices, waarin het aantal rijen op enige manier kan veranderen. Nuttig, speciaal bij het aanmaken van een vector invoer-element (columns = "1") Als deze optie ingesteld is op true, is er geen horizontale schuifbalk, zelfs als de matrix te breed is (omdat dit de hoogte zou beïnvloeden). (optioneel, standaard is false).

fixed_width (vaste breedte)

Een beetje misplaatste naam. Neem aan dat het aantal kolommen niet verandert. De laatste (of enige) kolom wordt uitgerekt om alle beschikbare ruimte op te vullen. Gebruik dit niet samen met matrices, waarin het aantal kolommen op enige manier kan veranderen. Nuttig, vooral bij het aanmaken van een vector invoer-element (rijen is "1"), (optioneel, standaard is false).

horiz_headers

Te gebruiken strings voor de horizontale koptekst, gescheiden door ";". Geen koptekst wordt getoond, indien ingesteld op "". (optioneel, standaard is kolomnummer).

vert_headers

Te gebruiken strings voor de verticale koptekst, gescheiden door ";". Geen koptekst wordt getoond, indien ingesteld op "". (optioneel, standaard is kolomnummer).

<optionset> (verzameling van opties)

Een UI voor het herhalen van een aantal opties voor een willekeurig aantal items (introductie voor optionsets). Attributen:

min_rows

Indien opgegeven, wordt de set gemarkeerd als ongeldig, tenzij die minstens dit aantal rijen heeft (optioneel, integer).

min_rows_if_any

Net als voor min_rows, maar wordt alleen getest al er minstens een rij is (optioneel, integer)

max_rows

Indien opgegeven, wordt de set gemarkeerd als ongeldig, tenzij die hoogstens dit aantal rijen heeft (optioneel, integer).

keycolumn (sleutelkolom)

Id (naam) van de kolom die als sleutelkolom wordt gebruikt. Een optionset met een (geldige) keycolumn acteert als een "driven" (aangedreven) optionset. Een optionset zonder keycolumn staat het zelf invoegen/verwijderen toe van items. De keycolumn moet als extern worden gemarkeerd. (optioneel, standaard is geen keycolumn).

Child-elements: (kind-element: van een parent afgeleid element, child en parent zijn onvertaalbare termen uit de programmeertaal)

<optioncolumn> (optiekolom)

Declareert één option column van de set. Voor elke waarde die u uit de optionset wilt ophalen, moet u een aparte <optioncolumn> declareren. Attributen:

id

De id (naam) van de optioncolumn (vereist, string).

extern

Ingesteld op true, indien de optioncolumn van buiten de optionset wordt bestuurd (optioneel, boolean, standaard is false).

label

Indien gegeven, wordt de optionset getoond in een kolom met die naam (optioneel, string, standaard is niet getoond).

verbinden

De eigenschap waarmee de optionset moet worden verbonden, gegeven als id (naam) in het <content>-gebied. Voor externe <optioncolumn>s wordt de overeenkomende waarde ingesteld op de extern ingestelde waarde. Voor reguliere (niet-externe) <optioncolumn>s wordt de overeenkomende rij van de <optioncolumn>-eigenschap ingesteld, wanneer de eigenschap verandert binnen het content-gebied. (optioneel, string, standaard is niet verbonden).

standaard

Alleen voor externe kolommen: de aan te nemen waarde voor deze kolom, indien geen waarde bekend is voor een ingang, Zelden nuttig. (optioneel, standaard is lege string)

<content> (inhoud)

Declareer de inhoud / UI van de set. Geen attributen. Alle gebruikelijke actieve, passieve, en layout-elementen zijn toegestaan als childname-elementen. Bovendien, in eerdere versies van RKWard (tot aan 0.6.3) was het speciale child-element <optiondisplay> toegestaan. Dit is verouderd in RKWard 0.6.4, en moet domweg worden verwijderd uit bestaande plugins.

<logic> (logica)

Optionele specificatie van de toe te passen UI-logica in het contents-gebied van de optionset. Zie de naslag over <logic>

<browser> (bladerprogramma)

Een element dat is ontworpen voor het selecteren van een enkele bestandsnaam (of naam van een directory). Merk op dat dit veld elke string accepteert, zelfs als die alleen in bestanden zou moeten worden gebruikt:

label

Naam van de browser (optioneel, standaard is "Enter filename" (voer bestandsnaam in))

aanvankelijk

Aanvangstekst van de browser (optioneel, standaard is "", bijv. een lege string)

type

Een van "file" (bestand), "dir", of "savefile" (opslaan bestand). Voor het selecteren van een bestaand bestand, bestaande directory, of niet-bestaand bestand. (optioneel, standaard is "file")

allow_urls

Of (niet-lokale) URLs kunnen worden geselecteerd (optioneel, standaard is "false")

filter

Bestandstype filter, bijv.: ("*.txt *.csv" voor .txt en .csv -bestanden) Een aparte ingang voor "Alle bestanden" wordt automatisch toegevoegd Optioneel, standaard is "", bijv. Alle bestanden.)

vereist

Of het - bij het indienen van de code- vereist is dat het veld niet leeg is. Merk op dat dit niet noodzakelijk betekent dat de geselecteerde bestandsnaam geldig is. Zie vereist-eigenschap (optioneel, standaard is true)

<saveobject> (object opslaan)

Een element ontworpen voor het selecteren van de naam van een R-object waarnaar het moet worden opgeslagen (bijv. in het algemeen niet reeds bestaand, in tegenstelling tot een varslot():

label

Naam voor de invoer (optioneel, standaard is "Save to:" (opslaan op:))

aanvankelijk

Begintekst voor de invoer (optioneel, standaard is "mijn.data" (mijn gegevens))

vereist

Of - bij het indienen van de code - het vereist is dat het veld een toegestane objectnaam bevat. Zie vereist-eigenschap (optioneel, standaard is true)

activeerbaar

In veel gevallen is het opslaan naar een R-object optioneel. In deze gevallen kan met dit attribuut een keuzevakje worden ingebouwd in het saveobject-element. Indien ingesteld op true, wordt de saveobject aan/uit gezet door het keuzevakje. Zie de active-eigenschap van saveobject (optioneel, standaard is false)

geactiveerd

Alleen voor kiesbare saveobject-elementen: of dit standaard gekozen/aan is (optioneel, standaard is false)

<spinbox> (spinveld)

Een spinveld waarin de gebruiker een numerieke waarde kan kiezen, of met directe toetsenbord-invoer, of met op/neer pijltjes. Attribuut:

label

Naam voor het spinveld (aanbevolen, standaard is "Enter value:" (waarde invoeren))

min

De laagste waarde die in het spinveld mag worden ingevoerd (optioneel, standaard is de laagste technisch mogelijke waarde in het spinveld)

max

De hoogste waarde die in het spinveld mag worden ingevoerd (optioneel, standaard is de hoogste technisch mogelijke waarde in het spinveld)

aanvankelijk

De beginwaarde getoond in het spinveld (optioneel, standaard is "0")

type

Een van "real" (kommagetal) of "integer" (geheel getal). Of in het spinveld kommagetallen of gehele getallen moeten worden gekozen. (optioneel, standaard is "real")

default_precision (standaard nauwkeurigheid)

Alleen zinvol als het type van het spinveld "real" is. Geeft het standaard aantal decimalen op in het spinveld (alleen dit aantal laatste nullen wordt getoond). Wanneer de gebruiker de op/neer pijltjes gebruikt, wordt deze decimale plaats veranderd. Maar de gebruiker kan toch waarden invoeren met een grotere nauwkeurigheid (zie onder) (optioneel, standaard is "2")

max_precision (maximale nauwkeurigheid)

Het grootste aantal cijfers dat zinvol kan worden weergegeven (optioneel, standaard is "8")

<formula> (formule)

In dit geavanceerde element kan de gebruiker een formule/aantal interacties kiezen uit geselecteerde variabelen. Bijvoorbeeld voor een GLM (Vert.: ik vermoed dat bedoeld wordt: een Generalized Linear Model: een gegeneraliseerd lineair model, maar verder doet dit er niet toe) kan dit element worden gebruikt voor het opgeven van de interactie-termen in het model. Attributen:

fixed_factors

De ID van de varslot die de geselecteerde fixed factors (vaste factoren) bevat (vereist)

afhankelijk

De ID van de varslot dat de afhankelijke variabele bevat (vereist)

<embed> (inbedden)

Bed een andere plugin in in deze plugin (zie hoofdstuk over inbedden). Attributen:

component

De geregistreerde naam van de in te bedden component (zie hoofdstuk over inbedden). Attributen:

as_button (als knop)

Indien ingesteld op "true", wordt alleen een drukknop geplaatst in de inbeddende GUI, de ingebedde GUI wordt alleen getoond (in een afzonderlijk venster) wanneer op de drukknop wordt gedrukt (optioneel, standaard is "false")

label

Alleen zinvol als as_button = "true": De naam van de knop (aanbevolen, standaard is "Opties")

<preview> (voorbeeld, voorweergave)

Keuzevakje voor het aan/uitzetten van de voorbeeldfunctionaliteit. Merk op dat vanaf versie 0.6.5 van RKWard <preview> preview-elementen speciaal zijn in plugin-dialogen (niet assistenten): Zij worden geplaatst in de kolom voor knoppen, ongeacht van waar ze in de UI zijn gedefinieerd. Maar het is nog steeds een goed idee ze op een zinvolle plaats in de layout te definiëren, voor achterwaartse compatibiliteit (backwards compatibility). Attributen:

label

Naam van het vakje (optioneel, standaard is "Preview")

modus

Type van preview. Ondersteund worden "plot" (zie hoofdstuk over grafiek previews), "output" (zie hoofdstuk over (HTML) uitvoer previews), "data" (zie gegevens previews), en "custom" (zie aangepaste previews). (optioneel, standaard is "plot")

plaatsing

Plaatsing van de preview: "attached" (vastgemaakt aan de hoofdwerkplaats), "detached" (los venster), "docked" (vastgemaakt aan plugin-dialoog) en "default" (dit is nu nog hetzelfde als "docked", maar kan in de toekomst mogelijk worden ingesteld door de gebruiker). In het algemeen wordt aanbevolen dit de standaard instelling te laten voor de beste UI-consistentie (optioneel, standaard is "default")

actief

Of de preview standaard actief is. In het algemeen worden alleen docked previews standaard actief gemaakt, en zelfs dan is er een reden voor dat dit standaard inactief is (optioneel, standaard is "false")

Logische sectie

<logic> (logica)

Het element dat de logische sectie bevat. Alle onderstaande elementen kunnen alleen in het <logic> element voorkomen. Het <logic> element kan alleen een directe child van het <document>-element zijn (hoogstens een per document), of van <optionset>-elementen (hoogstens een per optionset). De logische sectie van het document geldt op dezelfde manier voor zowel <dialog> en <wizard>-GUIs.

<external> (extern)

Maakt een nieuwe (string) eigenschap aan die bedoeld wordt als aanknopingspunt voor een externe eigenschap als de plugin ingebed wordt. Zie hoofdstuk over "incomplete" plugins. Attributen:

id

De ID (naam) van de nieuwe eigenschap (vereist)

standaard

De standaard string-waarde van de nieuwe eigenschap, bijv. de gebruikte waarde, indien de eigenschap niet verbonden is met een externe eigenschap (optioneel, standaard is een lege string)

<i18n> (internationalisatie)

Maakt een nieuwe (string)eigenschap aan bedoeld voor een ge-internationaliseerde naam. Attributen:

id

De ID (naam) van de nieuwe eigenschap (vereist)

label

De naam. Deze wordt straks vertaald. (vereist)

<set> (verzameling)

Stelt een vaste waarde in voor een eigenschap (natuurlijk blijft die niet vast als u de eigenschap ook verbindt met een andere eigenschap). Bijvoorbeeld, als u een plugin inbedt, maar enkele van zijn elementen wilt verbergen, kunt u de zichtbaarheid- eigenschap van die elementen op "false" instellen. Vooral nuttig voor inbeddende/ingebedde plugins. Merk op: als er meerdere <set>-elementen zijn met dezelfde id, heeft de laatst gedefinieerde voorrang. Dit kan soms nuttig zijn om op te vertrouwen bij het gebruik van <include>d onderdelen (parts). Attributen:

id

De ID (naam) van de in te stellen eigenschap (vereist)

aan

De in te stellen string-waarde van de eigenschap (vereist). Merk op: voor booleaanse eigenschappen zoals zichtbaarheid, aan staan, stelt u het attribuut typisch in op ="true" of op ="false".

<convert> (converteren, omzetten)

Maakt een nieuwe booleaanse eigenschap aan die afhangt van de toestand van een of meer verschillende eigenschappen. Attributen:

id

De ID (naam) van de nieuwe eigenschap (vereist)

bronnen

De ids (namen) van de eigenschappen waar deze eigenschap vanaf hangt. Een of meer eigenschappen kunnen worden genoemd, gescheiden door een ";". (vereist)

modus

De modus van de conversie/bewerking. Een van "equals" (gelijk aan), "notequals" (ongelijk aan), "range" (bereik), "and" (en), "or" (of). Indien in "equals"-modus, is de eigenschap alleen "true", als de waarde van al zijn sources gelijk zijn aan de attribuut-standaard (zie onder). Indien in de "notequals"-modus, is de eigenschap alleen dan "true" indien de waarde van al zijn sources verschillen met de attribuut-standaard (zie onder). Indien in "range"-modus moeten de sources numeriek zijn (integer of real). De eigenschap is alleen dan "true", indien alle bronnen binnen het bereik liggen die gegeven wordt door de attributen min en max (zie onder). In "and"-modus moeten de bronnen booleaanse eigenschappen zijn. De eigenschap is alleen dan "true", als alle bronnen tegelijk "true" zijn. In "or"-modus, moeten de sources booleaanse eigenschappen zijn. De eigenschap is alleen dan "true", als minstens een van de bronnen "true" is. (vereist)

standaard

Alleen zinvol in de modi "equals" of "notequals": de string-waarde waarmee wordt vergeleken (vereist indien in een van deze modi)

min

Alleen zinvol in de modus "range": de kleinste waarde waarmee wordt vergeleken (optioneel, standaard is de kleinste real die de machine aan kan)

max

Alleen zinvol in de modus "range": de grootste waarde waarmee wordt vergeleken (optioneel, standaard is de grootste real die de machine aan kan)

require_true (vereist_waar)

Indien ingesteld op "true", wordt de eigenschap vereist, en is die alleen geldig als de toestand true/on is. Dus, als de eigenschap "false" is, blokkeert die de knop Indienen (optioneel, standaard is "false").

Let op

Als u dit gebruikt, moet u ervoor zorgen dat de gebruiker gemakkelijk kan vinden wat er mis is, zoals het tonen van een uitleggende <text>.

<switch> (schakelaar)

Maak een nieuwe eigenschap aan die naar verschillende doel-eigenschappen (target properties) (of vaste strings) doorgeeft (relay), op basis van de waarde van een conditie-eigenschap. Hierdoor kunt u logica opbouwen die vergelijkbaar is met de constructs if() of switch(). Attributen:

id

De ID (naam) van de nieuwe eigenschap (vereist)

conditie

De id (naam) van de conditie-eigenschap (vereist)

Child elementen: (een child is een voortzetting van een parent. Dit soort termen zijn algemeen in een moderne computertaal)

<true> (waar)

Indien de conditie-eigenschap een boolean is, kunt u de twee child elementen <true> en <false> opgeven (en deze alleen). (vereist, als <false> ook gegeven wordt)

<false> (onwaar)

Indien de conditie-eigenschap een boolean is, kunt u de twee child elementen <true> en <false> opgeven (en deze alleen). (vereist, als <true> ook gegeven wordt)

<case> (in geval dat)

Indien de conditie-eigenschap een boolean is, kunt u een willekeurig aantal <case>-elementen opgeven, een voor elke waarde van de conditie-eigenschap die u wilt gebruiken (minstens een zo'n element is vereist, indien de conditie niet een boolean is)

<default> (standaard)

Indien de conditie-eigenschap geen boolean is, maakt het optionele <default>-element het mogelijk het gedrag op te geven, indien geen <case>-element overeenkomt met de waarde van de conditie-eigenschap (optioneel, alleen een keer toegestaan, in combinatie met een of meer <case>-elementen).

Child-elementen <true>, <false>, <case>, en <default> hebben de volgende attributen:

standaard

Alleen voor <case>-elementen: de waarde waaraan de conditie-eigenschap moet voldoen (vereist, string).

fixed_value (vaste_waarde)

Een vaste string die moet worden opgegeven als de waarde van de <switch>-eigenschap, als de huidige conditie klopt (vereist, als de dynamic_value niet wordt gegeven).

dynamic_value (dynamische_waarde)

De id (naam) van de doeleigenschap die moet worden gegeven als de waarde van de <switch>-eigenschap, als de huidige conditie klopt (vereist, als fixed_value niet is gegeven).

<connect> (verbinden)

Verbindt twee eigenschappen. De client-eigenschap wordt gewijzigd zodra de governor-eigenschap verandert (maar niet andersom). Attributen:

client

De ID van de client_eigenschap, bijv. de aan te passen eigenschap (vereist)

governor

De ID van de governor-eigenschap, bijv. de eigenschap die de klanteigenschap aanpast. Deze kan een modifier inhouden (vereist)

reconcile (in overeenstemming brengen)

Indien "true"zal de client-eigenschap de governor-eigenschap bij verbinding zo aanpassen dat de governor-eigenschap alleen waarden accepteert die ook door de client worden geaccepteerd (bijv. stel dat de governor een numerieke eigenschap is met als kleinste waarde "0", en de client een numerieke eigenschap met als kleinste waarde "100". Als reconcile de waarde "true"heeft wordt voor beide eigenschappen de kleinste waarde "100"). Dit werkt in het algemeen alleen indien beide eigenschappen van hetzelfde basistype zijn (optioneel, standaard is dit "false")

<dependency_check> (controleren op afhankelijkheden)

Maakt een boolean eigenschap aan die true is, indien aan de opgegeven afhankelijkheden wordt voldaan, en anders false. De XML-syntaxis van het element is dezelfde als die van de <dependencies>-elementen, beschreven in de .pluginmap-naslag. Vanaf RKWard 0.6.1, worden alleen de RKWard en R versiespecificaties in beschouwing genomen, en niet de afhankelijkheden van pakketten en pluginmaps.

<script>

Definieer scriptcode voor de besturing van de UI-logica. Zie de sectie voor GUJI-logica in scripts voor de details. De te gebruiken scriptcode kan in het "file" (bestand) -attribuut worden gegeven, , of als een tekst met commentaar van het element. Het <script>-element is niet toegestaan in de <logic> sectie van een optionset. Attributen:

bestand

Bestandsnaam van het scriptbestand (vereist)