Propietats dels elements del connectorTots els elements de disposició, i tots els elements actius tenen les propietats següents, accessibles a través de "id_of_element.name_of_property":
- visible
Si l'element de la IGU és visible o no (booleà)
- enabled
Si l'element de la IGU està habilitat o no (booleà)
- required
Si es requereix o no l'element de la IGU (per a mantenir una configuració vàlida). Tingueu en compte que qualsevol element que estigui desactivat o ocult també és implícitament no requerit (booleà).
A més d'això, alguns elements tenen propietats addicionals a les quals es pot connectar. La majoria dels elements actius també tenen una propietat "default", el valor de la qual es retornarà en les crides a getBoolean/getString/getList ("..."), si no s'ha nomenat cap propietat específica, com es descriu a continuació.
- <text>
La propietat predeterminada és text
- text
El text mostrat (text)
- <varselector>
Sense propietat predeterminada
- selected
Els objectes actualment seleccionats. Probablement, no voldreu utilitzar això. Usat internament (RObject)
- root
L'objecte arrel/pare dels objectes oferts per a la selecció (RObject)
- <varslot>
La propietat predeterminada és "available" (disponible)
- available
Tots els objectes continguts en el «varslot» (RObject)
- selected
Dels objectes que hi ha al «varslot», els que estan seleccionats actualment. Probablement, no voldreu utilitzar això. Usat internament (RObject)
- source
Una còpia dels objectes seleccionats en el «varselector» corresponent. Probablement no volen utilitzar això. Usat internament (RObject)
- <valueselector>
La propietat predeterminada és "selected"
- selected
Les cadenes actualment seleccionades. Modificador "labeled" per a recuperar les etiquetes corresponents. En un <valueselector> probablement no el voldreu utilitzar directament (només en un <select>). (Llegeix/escriu StringList)
- available
La llista de valors de cadena de la qual seleccionar. (Llegeix/escriu StringList)
- labels
Etiquetes a mostrar per als valors de cadena. (Llegeix/escriu StringList)
- <valueslot>
El mateix que <varslot>, però les propietats són llistes de cadenes, en lloc de RObjects.
- <radio>
La propietat predeterminada és "string"
- string
El valor de l'opció actualment seleccionada (cadena)
- number
El nombre de l'opció actualment seleccionada (les opcions estan numerades de dalt a baix, començant en el 0) (enter)
- <dropdown>
El mateix que <radio>
- <select>
El mateix que <valueselector>
- <option>
No hi ha cap propietat per defecte. "enabled" és la *única* propietat, i actualment no està disponible per a opcions dins de <select> o <valueselector>. <option> no té les propietats "visible" o "required".
- enabled
Si s'ha d'activar o desactivar aquesta opció única. En la majoria dels casos activareu/desactivareu tot el <radio< o <dropdown<. Però això es pot utilitzar per a establir dinàmicament l'activació d'una opció única dins d'un <radio< o <dropdown< (booleà)
- <checkbox>
La propietat predeterminada és "state.labeled", el qual vol dir que es retornen els valors especificats pels atributs
value, ivalue_unchecked, no l'etiqueta mostrada de la casella de selecció.- state
Estat de la casella de selecció (activada o desactivada). Tingueu en compte que els modificadors útils d'aquesta propietat (com totes les propietats booleanes) són "not" i "labeled" (vegeu tipus de propietats). No obstant això, sovint és més útil connectar a la propietat sense modificador, és a dir, "checkbox_id.state", el qual retornarà l'estat de la casella de selecció en un format adequat per al seu ús en una declaració "if" (0 o 1). (Booleà)
- <frame>
La propietat predeterminada és "checked", si (i només si) el marc es pot marcar. Per als marcs que no es poden marcar, no hi ha cap propietat per defecte.
- checked
Disponible només per als marcs que es poden marcar: estat de la casella de selecció (activada o desactivada). Tingueu en compte que els modificadors útils d'aquesta propietat (com totes les propietats booleanes) són "not" i "numeric" (vegeu tipus de propietats). (Booleà)
- <input>
La propietat predeterminada és "text"
- text
Text actual en el camp d'entrada (cadena)
- <matrix>
La propietat predeterminada és "cbind".
- rows
Nombre de files a la matriu (enter). Si la matriu permet a l'usuari afegir/eliminar files, aquesta propietat s'ha de tractar com de només lectura. En cas contrari, canviant-la, es canviarà la mida de la matriu.
- columns
Nombre de columnes a la matriu (enter). Si la matriu permet a l'usuari afegir/eliminar columnes, aquesta propietat s'ha de tractar com de només lectura. En cas contrari, canviant-la, es canviarà la mida de la matriu.
- tsv
Dades en la matriu en format «tsv» (cadena; lectura-escriptura). Tingueu en compte que en comparació amb la disposició «tsv» habitual, les columnes, no files, estan separades per caràcters de línia nova, i les cel·les dins d'una columna estan separades per caràcters tabuladors.
- 0,1,2...
Les dades d'una sola columna (0 per a la columna més a l'esquerra).
getValue()/getString()retorna això com una sola cadena, separada per «\n». No obstant això, la manera recomanada d'obtenir-ho és utilitzantgetList(), que retorna aquesta columna com una matriu de cadenes.- row.0,row.1,row.2...
Les dades d'una sola fila (0 per a la fila superior).
getValue()/getString()retorna això com una sola cadena, separada per «\n». No obstant això, la manera recomanada d'obtenir-ho és utilitzantgetList(), que retorna aquesta fila com una matriu de cadenes.- cbind
Dades en un format adequat per a enganxar a R, embolcallades en una expressió «cbind» (cadena; només lectura).
- <optionset>
No hi ha cap propietat predeterminada.
- row_count
Nombre d'elements a l'«optionset» (enter). Només lectura.
- current_row
Element actualment actiu a l'«optionset» (enter). -1 per a cap element actiu. Lectura i escriptura.
- optioncolumn_ids
Per a cada <optioncolumn> que definiu, es crearà una propietat de llista de cadenes amb l'identificador especificat.
- <browser>
La propietat predeterminada és "selection"
- selection
Text actual (nom de fitxer seleccionat) al navegador (cadena)
- <saveobject>
La propietat predeterminada és "selection"
- selection
Nom complet de l'objecte seleccionat (cadena; només lectura, per a establir-ho des del programa utilitzeu "parent" i "objectname")
- parent
L'objecte pare de l'objecte seleccionat. Aquest sempre és un objecte R existent d'un tipus que pot contenir altres objectes (p. ex., una llista o un «data.frame»). Quan s'estableix a una cadena buida o a un objecte no vàlid, s'assumeix ".GlobalEnv" (RObject)
- objectname
El nom base de l'objecte seleccionat, és a dir, la cadena introduïda per l'usuari (canviada a un nom R vàlid, si cal) (cadena)
- active
Només per a «saveobject» que es puguin marcar: si el control està activat/activat. Sempre cert per als «saveobject» que no es poden marcar (booleà)
- <spinbox>
La propietat predeterminada és "int" o "real.formatted", depenent del mode del botó de selecció de valors
- int
Valor enter que té el botó de selecció de valors, o enter més proper, si està en mode real (enter)
- real
Valor real que té el botó de selecció de valors (o enter, si és enter) (real)
- <formula>
La propietat predeterminada és "model"
- model
La cadena del model actual (cadena)
- table
El «data.frame» conté les variables requerides. Si només s'utilitzen variables d'un «data.frame», es retornarà el nom d'aquest «data.frame». Altrament es construeix un «data.frame» nou segons sigui necessari (cadena)
- labels
Si estan implicades les variables de diversos «data.frames», els seus noms es poden barrejar (per exemple, si ambdós «data.frames» contenen una variable anomenada «x»). Això retorna una llista amb els noms entrellaçats com a índexs i l'etiqueta descriptiva com a valor (cadena)
- fixed_factors
Els factors fixos. Probablement no voldreu utilitzar això. Usat internament (RObject)
- dependent
Les variables dependents. Probablement no voldreu utilitzar això. Usat internament (RObject)
- <embed>
Sense propietat predeterminada
- code
El codi generat pel connector incrustat (codi)
- <preview>
La propietat predeterminada és "state"
- state
Si la casella de previsualització està marcada (no necessàriament si ja s'ha mostrat la previsualització) (booleà)
- <convert>
Aquest element (utilitzat a la secció <logic>) és especial, ja que tècnicament *és* una propietat, en lloc de només tenir una o més propietats. És de tipus booleà. Tingueu en compte que els modificadors útils d'aquesta propietat (com totes les propietats booleanes) són "not" i "numeric" (vegeu tipus de propietats)
- <switch>
Aquest element (utilitzat a la secció <logic>) és especial, ja que tècnicament *és* una propietat (cadena), en lloc de només tenir una o més propietats. Permet canviar entre diverses propietats de destinació depenent del valor d'una propietat de condició, o per a tornar a assignar els valors de la propietat de condició. Qualsevol modificador que proporcioneu es transmet a les propietats de destinació, per tant, p. ex., si totes les propietats de destinació són propietats RObject, també podreu utilitzar el modificador "shortname" al commutador. No obstant això, si les propietats de destinació són de tipus diferents, l'ús de modificadors pot provocar errors. Pels
fixed_value, s'elimina qualsevol modificador, en silenci. Tingueu en compte que les propietats de destinació, quan s'accedeix a través d'un commutador, sempre són de només lectura.