Eigenschappen van plugin-elementenAlle layout-elementen, en alle actieve elementen hebben de volgende eigenschappen, toegankelijk via de "id_van_element.naam_van_eigenschap":
- zichtbaar
Of het GUI-element zichtbaar is of niet (boolean)
- ingeschakeld
Of het GUI-element is ingeschakeld of niet (boolean)
- vereist
Of het GUI-element vereist is (om een geldige instelling te bevatten) of niet. Let op dat elk element dat is uitgeschakeld of verborgen, impliciet niet vereist is (boolean)
Daarbij kunnen sommige elementen extra eigenschappen hebben die u kunt verbinden. De meeste actieve elementen hebben ook een standaard eigenschap waarvan de waarde wordt teruggegeven na het aanroepen van getBoolean/getString/getList ("..."), indien er geen specifieke eigenschap werd genoemd, zoals hieronder beschreven:
- <text> (tekst)
Standaard eigenschap is tekst
- tekst
De getoonde tekst (text)
- <varselector> (variabelekiezer)
Geen standaard eigenschap
- geselecteerd
De nu geselecteerde objecten. Dit heeft u waarschijnlijk niet nodig. Wordt intern gebruikt (Robject)
- root
Het root/parent object van de objecten waaruit u kunt kiezen (RObject)
- <varslot>
Standaard eigenschap is "available" (beschikbaar)
- available
Alle objecten in de varslot (RObject)
- geselecteerd
Van de objecten in de varslot, die objecten die nu zijn geselecteerd. Dit heeft u waarschijnlijk niet nodig. Wordt intern gebruikt (RObject)
- bron
Een kopie van de geselecteerde objecten in de overeenkomende varselector. Dit heeft u waarschijnlijk niet nodig. Wordt intern gebruikt (RObject)
- <valueselector> (waarde selector)
Standaard eigenschap is "geselecteerd"
- geselecteerd
De nu geselecteerde strings. Modifier "labeled" voor het ophalen van de overeenkomstige namen. In een <valueselector> heeft u dit waarschijnlijk niet direct nodig, (alleen in een <select>). (read/write StringList)
- available
De lijst van string-waarden waaruit u kunt kiezen. (read/write StringList)
- labels
Te tonen naamteksten voor de stringwaarden. (read/write StringList)
- <valueslot>
Zelfde als <varslot>, maar de eigenschappen zijn lijsten met strings, in plaats van RObjecten.
- <radio> (radioknoppen, selectierondjes)
Standaard eigenschap is "string"
- string, tekenreeks
De waarde van de nu geselecteerde optie (string)
- aantal
Het nummer van de nu geselecteerde optie (opties zijn van boven naar beneden genummerd, te beginnen met 0) (integer (geheel getal))
- <dropdown> (neerklapmenu)
Zelfde als <radio>
- <select> (kies, selecteer)
Zelfde als <valueselector>
- <option> (optie)
Geen standaard eigenschap. "enabled" (ingeschakeld) is de *enige* eigenschap, en is op dit moment niet beschikbaar voor opties in een <select> of <valueselector>. <option> heeft niet de eigenschappen "visible" (zichtbaar) of "required" (vereist).
- ingeschakeld
Of deze ene eigenschap moet worden aan- of uitgezet. In de meeste gevallen wilt u de gehele <radio< of <dropdown< (keuzelijst) aan/uitzetten. Maar u kunt dit gebruiken om het aangezet zijn dynamisch in te stellen voor een enkele optie in een <radio< of <dropdown< (bool)
- <checkbox> (keuzevakje)
De standaard eigenschap is "state.labeled", wat betekent dat de waarden opgegeven in de attributen
value(waarde), envalue_unchecked(waarde_niet_geactiveerd) worden teruggegeven, en niet de tekst getoond bij het keuzevakje.- status
Status van het keuzevakje (aan of uit). Merk op dat de nuttige modifiers van deze eigenschap (zoals van alle boolean eigenschappen) zijn "not" en "labeled" (van naam voorzien) (zie eigenschap-typen). Maar het is vaak beter geen modifier te koppelen aan een eigenschap, bijv. "checkbox_id.state", die de status teruggeeft van een keuzevakje in een formaat waardoor het gebruikt kan worden in een if statement (0 of 1). (boolean)
- <frame> (onvertaalbaar, zoiets als raamwerk)
Standaard eigenschap is "checked" (geactiveerd), als - en alleen als - de frame kan worden geactiveerd. Voor frames die niet kunnen worden geactiveerd is er geen standaard eigenschap.
- geactiveerd
Alleen beschikbaar voor activeerbare frames: status van het keuzevakje (aan of uit). Let erop dat nuttige modifiers van deze eigenschap (zoals van alle boolean eigenschappen) zijn "not" en "numeric" (zie (see eigenschap-typen). (boolean)
- <input> (invoer)
Standaard eigenschap is "text"
- tekst
Huidige tekst in het invoerveld (string)
- <matrix>
Standaard eigenschap is "cbind",
- rijen
Aantal rijen in de matrix (integer, geheel getal). Indien de gebruiker het aantal rijen in de matrix kan wijzigen, moet deze eigenschap worden beschouwd als read-only (alleen lezen). U kunt anders door dit te wijzigen, de grootte van de matrix veranderen.
- kolommen
Aantal kolommen in de matrix (integer, geheel getal). Indien de gebruiker het aantal kolommen in de matrix kan wijzigen, moet deze eigenschap worden beschouwd als read-only (alleen lezen). U kunt anders door dit te wijzigen, de grootte van de matrix veranderen.
- tsv
Gegevens in de matrix in het tsv-formaat (string: read-write (lezen-schrijven)). Merk op dat, vergeleken met de gebruikelijke tsv-indeling, de kolommen, en niet de rijen, van elkaar worden gescheiden door newline (nieuwe regel) karakters, en de cellen in een kolom door tab-karakters .
- 0,1,2...
De gegevens uit een kolom (de meest linkse kolom is 0).
getValue()/getString()geven dit terug als een enkele string, gescheiden door "\n". Maar aangeraden wordt hiervoor de functiegetList()te gebruiken, die deze kolom teruggeeft als een array van strings.- rij.0,rij.1,rij.2...
De gegevens uit een rij (de bovenste kolom is 0).
getValue()/getString()geven dit terug als een enkele string, gescheiden door "\n". Maar aangeraden wordt hiervoor de functiegetList()te gebruiken, die deze kolom teruggeeft als een array van strings.- cbind
Gegevens in een formaat dat geschikt is voor plakken in R, wrapped (een computerterm, die zoiets betekent als: ingevouwen, opgeborgen in) een cbind statement (string: read only (alleen lezen))
- <optionset> (verzameling van opties)
Geen standaard eigenschap.
- row_count
Aantal elementen in de optionset (integer). Read-only (alleen-lezen).
- current_row (huidige rij)
Huidig actieve element in de optionset (integer). -1 als er geen actief element is. Read-write (Lezen-schrijven).
- optioncolumn_ids (namen optionkolommen)
Voor elke <optioncolumn> die u definieert, wordt een string list eigenschap aangemaakt met de opgegeven id (naam).
- <browser> (bladerprogramma)
Standaard eigenschap is "selection"
- selection (selectie)
Huidige tekst (geselecteerde bestandsnaam) in de browser (string)
- <saveobject> (object opslaan)
Standaard eigenschap is "selection"
- selection (selectie)
Volledige naam van het geselecteerde object (string: read-only - gebruik "parent" en "objectnaam" voor instellen in een programma)
- parent
Het parent object (het object dat de basis is van het huidige object) van het geselecteerde object. Dit is altijd een bestaand object in R van een type dat andere objecten kan bevatten (bijv. een list of data.frame). Indien ingesteld op een lege string of een ongeldig object, wordt ".GlobalEnv" aangenomen. (Robject)
- objectnaam
De basisnaam van het geselecteerde object, bijv. de door de gebruiker ingevoerde string (gewijzigd naar een geldige naam in R indien nodig) (string)
- actief
Alleen voor activeerbare saveobjects: of controle actief/aangezet is. Altijd true voor niet-activeerbare saveobjects (bool)
- <spinbox> (spinveld)
Standaard eigenschap is altijd "int" of "real.formatted", afhankelijk van de modus van het spinveld
- int
Gehele waarde in het spinveld, of dichtstbijzijnd geheel getal (integer)
- real
Kommagetal in het spinveld (en eventueel geheel) (real)
- <formula> (formule)
Standaard eigenschap is "model"
- model
De huidige model-string (string)
- table (tabel)
De data.frame die de nodige variabelen bevat. Indien de variabelen van slechts een data.frame worden gebruikt, wordt de naam van de data.frame teruggegeven. Anders wordt een nodige nieuwe data.frame aangemaakt (string)
- labels
Indien variabelen uit meerdere data.frames komen, kunnen hun namen botsen (bijvoorbeeld, indien in beide data.frames een variabele met de naam "x" voorkomt). Dit geeft een lijst terug met deze gebotste namen als indices (indexen) en de beschrijvende naam als waarde (string)
- fixed_factors
De fixed factors. Dit heeft u waarschijnlijk niet nodig. Wordt intern gebruikt (RObject)
- dependent
De afhankelijke variabele(n). Dit heeft u waarschijnlijk niet nodig. Wordt intern gebruikt (RObject)
- <embed> (inbedden)
Geen standaard eigenschap
- code
De (programma)code die door de ingebedde plugin wordt gegenereerd (code)
- <preview> (voorbeeld, voorweergave)
Standaard eigenschap is "state" (status)
- status
Of het keuzevakje voor het voorbeeld actief is (niet nodig als het voorbeeld al eerder werd getoond) (boolean)
- <convert> (converteren, omzetten)
Dit element (gebruikt in de sectie <logic>) is bijzonder, omdat hettechnisch gesproken een eigenschap *is*, in plaats van dat het een of meer eigenschappen omvat. Het is boolean-achtig. Merk op dat nuttige modifiers van deze eigenschap (zoals van alle boolean eigenschappen) "not" en "numeric" zijn (zie eigenschap-typen)
- <switch> (schakelaar)
Dit element (gebruikt in de sectie <logic>) is bijzonder, omdat hettechnisch gesproken een eigenschap *is*, in plaats van dat het een of meer eigenschappen bevat. Hiermee kunt u tussen diverse doeleigenschappen schakelen, afhankelijk van de waarde van een conditie-eigenschap, of waarden van de conditie-eigenschap herindelen. Alle modifiers die u invoert worden doorgegeven naar de doeleigenschappen, dus, bijv. indien alle doeleigenschappen RObject-eigenschappen zijn, kunt u bij het schakelen ook de "korte naam"-modifier gebruiken. Maar als de doeleigenschappen niet allemaal van hetzelfde type zijn kan het gebruiken van modifiers tot fouten leiden. Voor
fixed_values, (vaste waarden) wordt elke modifier stilzwijgend genegeerd. Merk op dat doeleigenschappen, met een schakelaar beschikbaar, altijd read-only zijn.