Proprietà degli elementi dell'estensioneTutti gli elementi di struttura e tutti gli elementi attivi contengono le seguenti proprietà, accessibili tramite «id_elemento.nome_proprietà»:
- visible
Decidere se l'elemento della GUI è visibile o meno (booleano)
- enabled
Decidere se l'elemento della GUI è abilitato o meno (booleano)
- required
Decidere se l'elemento della GUI è richiesto (per contenere un'impostazione valida) o meno. Notare che qualsiasi elemento che è disabilitato o nascosto è anche implicitamente non richiesto (booleano).
Inoltre, alcuni elementi hanno proprietà aggiuntive a cui è possibile connettersi. La maggior parte degli elementi attivi ha anche una proprietà «predefinita» il cui valore sarà restituito sulle chiamate a getBoolean/getString/getList("..."), se non è stata nominata alcuna proprietà specifica, come descritto di seguito.
- <text>
La proprietà predefinita è text
- text
Il testo visualizzato (testo)
- <varselector>
Nessuna proprietà predefinita
- selected
Gli oggetti attualmente selezionati. Probabilmente non si dovranno utilizzare. Utilizzati internamente (RObject)
- root
L'oggetto radice/genitore degli oggetti offerti per la selezione (RObject)
- <varslot>
La proprietà predefinita è «available»
- available
Tutti gli oggetti contenuti nel varslot (RObject)
- selected
Degli oggetti contenuti nel varslot, quelli attualmente selezionati. Probabilmente non si dovranno utilizzare. Utilizzati internamente (RObject)
- source
Una copia degli oggetti selezionati nel corrispondente selettore. Probabilmente non si dovranno utilizzare. Utilizzati internamente (RObject)
- <valueselector>
La proprietà predefinita è «selected»
- selected
Le stringhe attualmente selezionate. Modificatore «labeled» per recuperare le etichette corrispondenti. In un <valueselector> probabilmente non si desidera utilizzarlo direttamente (solo in un <select>). (lettura/scrittura StringList)
- available
L'elenco di valori di stringa da cui selezionare. (lettura/scrittura StringList)
- labels
Etichette da visualizzare per i valori di stringa. (lettura/scrittura StringList)
- <valueslot>
Come <varslot>, ma le proprietà sono elenchi di stringhe, anziché RObjects.
- <radio>
La proprietà predefinita è «string»
- string
Il valore dell'opzione attualmente selezionata (stringa)
- number
Il numero dell'opzione attualmente selezionata (le opzioni sono numerate dall'alto verso il basso, a partire da 0) (intero)
- <dropdown>
Uguale a <radio>
- <select>
Uguale a <valueselector>
- <option>
Nessuna proprietà predefinita. «enabled» è l'*unica* proprietà e non è attualmente disponibile per le opzioni all'interno di <select> o <valueselector>. <option> non ha le proprietà «visible» o «required».
- enabled
Abilitare o disabilitare questa singola opzione. Nella maggior parte dei casi, si abilita/disabilita l'intero <radio< o <menu a tendina<. Ma questo può essere utilizzato per impostare dinamicamente l'abilitazione di una singola opzione all'interno di un <radio< o <menu a tendina< (bool)
- <checkbox>
La proprietà predefinita è «state.labeled», il che significa che sono restituiti i valori specificati dagli attributi
valueevalue_unchecked,non l'etichetta visualizzata della casella di selezione.- state
Stato della casella di controllo (attivata o disattivata). Nota che utili modificatori di questa proprietà (come di tutte le proprietà booleane) sono «not» e «labeled» (vedere tipi di proprietà). Tuttavia, spesso è molto utile connettersi alla proprietà senza modificatore, cioè «checkbox_id.state», che restituirà lo stato della casella di controllo in un formato adatto all'uso in un'istruzione if (0 o 1). (booleano)
- <frame>
La proprietà predefinita è «checked», se - e solo se - la cornice è controllabile. Per le cornici non verificabili, non esiste una proprietà predefinita.
- checked
Disponibile solo per cornici selezionabili: stato della casella di controllo (attiva o disattiva). Notare che utili modificatori di questa proprietà (come di tutte le proprietà booleane) sono «not» e «numeric» (vedere tipi di proprietà). (booleano)
- <input>
La proprietà predefinita è «text»
- text
Testo attuale nel campo di inserimento (stringa)
- <matrix>
La proprietà predefinita è «cbind».
- rows
Numero di righe nella matrice (numero intero). Se la matrice consente all'utente di aggiungere / rimuovere righe, questa proprietà deve essere considerata di sola lettura. Altrimenti, cambiandolo, cambierà la dimensione della matrice.
- columns
Numero di colonne nella matrice (numero intero). Se la matrice consente all'utente di aggiungere / rimuovere colonne, questa proprietà deve essere considerata di sola lettura. Altrimenti, cambiandolo, cambierà la dimensione della matrice.
- tsv
Dati nella matrice in formato tsv (stringa; lettura-scrittura). Si noti che rispetto alla solita struttura tsv, colonne, non righe, sono separate da caratteri da caratteri di interruzione di riga e le celle all'interno di una colonna sono separate da caratteri di tabulazione.
- 0,1,2...
I dati da una singola colonna (0 per la colonna più a sinistra).
getValue()/getString()restituisce questo come una singola stringa, separata da «\n». Tuttavia, il modo consigliato per ottenerlo è utilizzaregetList(), che restituisce questa colonna come un vettore di stringhe.- riga.0,riga.1,riga.2...
I dati da una singola riga (0 per la riga più in alto).
getValue()/getString()restituisce questo come una singola stringa, separata da «\n». Tuttavia, il modo consigliato per ottenerlo è utilizzaregetList(), che restituisce questa riga come un vettore di stringhe.- cbind
Dati in un formato adatto per incollare in R, racchiusi in un'istruzione cbind (stringa; sola lettura).
- <optionset>
Nessuna proprietà predefinita.
- row_count
Numero di elementi nell'insieme di opzioni (intero). Sola lettura.
- current_row
Elemento attualmente attivo nell'insieme di opzioni (intero). -1 per nessun elemento attivo. Lettura-scrittura.
- optioncolumn_ids
Per ogni <optioncolumn> specificata, sarà creata una proprietà dell'elenco di stringhe con l'id specificato.
- <browser>
La proprietà predefinita è «selection»
- selection
Testo attuale (nome file selezionato) nel browser (stringa)
sovrascrivereSe l'opzione «sovrascrivi» è selezionata (booleano, di sola lettura, ovvero è possibile leggere lo stato della casella di controllo, ma non modificarlo, a livello di programmazione)
- <saveobject>
La proprietà predefinita è «selection»
- selection
Nome completo dell'oggetto selezionato (stringa; sola lettura - per impostarlo a livello di codice, utilizzare «parent» e «objectname»)
- parent
L'oggetto principale dell'oggetto selezionato. Questo è sempre un oggetto di R oggetto di un tipo che può contenere altri oggetti (ad es. un elenco o una cornice di dati). Se impostato su una stringa vuota o un oggetto non valido, viene assunto «.GlobalEnv» (RObject)
- objectname
Il nome base dell'oggetto selezionato, cioè la stringa inserita dall'utente (modificata in un nome R valido, se necessario) (stringa)
- active
Solo per getti di salvataggio verificabili: se il controllo è selezionato/abilitato. Sempre vero per saveobject non marcabili (booleano)
- <spinbox>
La proprietà predefinita è «int» o «real.formatted» a seconda della modalità della casella di selezione
- int
Valore intero mantenuto dalla casella di selezione o intero più vicino, se in modalità reale (intero)
- real
Valore reale mantenuto dalla casella di selezione (e intero, se in numero intero) (reale)
- <formula>
La proprietà predefinita è «model»
- model
La stringa del modello attuale (stringa)
- table
La cornice di dati che contiene le variabili richieste. Se vengono utilizzate variabili di una sola cornice, viene restituito il nome di quella cornice. Altrimenti viene creata una nuovo cornice di dati come richiesto (stringa)
- labels
Se sono coinvolte variabili da più cornici di dati, i loro nomi potrebbero essere alterati (ad esempio, se entrambe le cornici contengono una variabile denominata «x»). Ciò restituisce un elenco con i nomi alterati come indici e l'etichetta descrittiva come valore (stringa)
- fixed_factors
I fattori costanti. Probabilmente non si dovranno utilizzare. Utilizzati internamente (RObject)
- dependent
Le variabili dipendenti. Probabilmente non si dovranno utilizzare. Utilizzate internamente (RObject)
- <embed>
Nessuna proprietà predefinita
- code
Il codice generato dall'estensione integrata (codice)
- <preview>
La proprietà predefinita è «state»
- state
Se la casella di anteprima è selezionata (non necessariamente se l'anteprima è già stata mostrata) (booleano)
- <convert>
Questo elemento (utilizzato nella sezione <logic>) è speciale, in quanto tecnicamente *è* una proprietà, invece di contenere solo una o più proprietà. È di tipo booleano. Nota che i modificatori utili di questa proprietà (come di tutte le proprietà booleane) sono «not» e «numeric» (vedere tipi di proprietà)
- <switch>
Questo elemento (utilizzato nella sezione <logica>) è speciale, in quanto tecnicamente *è* una proprietà (stringa), invece di contenere solo una o più proprietà. Permette di passare tra diverse proprietà di destinazione a seconda del valore di una proprietà di condizione o di rimappare i valori della proprietà di condizione. Tutti i modificatori forniti vengono passati alle proprietà di destinazione, quindi, ad es. se tutte le proprietà di destinazione sono proprietà RObject, potete utilizzare anche il modificatore "shortname" sullo switch. Tuttavia, se le proprietà di destinazione sono di tipo diverso, l'utilizzo dei modificatori potrebbe causare errori. Per
fixed_value, qualsiasi modificatore viene eliminato silenziosamente. Tenete presente che le proprietà di destinazione, quando si accede tramite uno switch, sono sempre di sola lettura.