Funzioni disponibili per la programmazione della logica della GUI- Classe «Component»
Classe che rappresenta un singolo componente o proprietà del componente. L'istanza più importante di questa classe è la variabile «gui», che è predefinita come proprietà radice del componente attuale. I seguenti metodi sono disponibili per le istanze della classe «Component»:
- absoluteId(id_base)
Restituisce l'ID assoluto di id_base o, se id_base viene omesso, l'identificatore del componente.
- getValue(id)
Sconsigliato. Utilizzare invece
getString(), getBoolean() o getList(). Restituisce il valore della proprietà figlia specificata. Restituisce il valore di questa proprietà, se l'ID viene omesso.- getString(id)
Restituisce il valore della proprietà figlia specificata come stringa. Restituisce il valore di questa proprietà, se l'ID viene omesso.
- getBoolean(id)
Restituisce il valore della proprietà figlia specificata come booleano (se possibile). Restituisce il valore di questa proprietà, se l'ID viene omesso.
- getList(id)
Restituisce il valore della proprietà figlia specificata come vettore di stringhe (se possibile). Restituisce il valore di questa proprietà, se l'ID viene omesso.
- setValue(id, valore)
Impostare il valore della proprietà figlio specificata su valore.
- getChild(id)
Restituisce un'istanza della proprietà figlio con l'id indicato.
- addChangeCommand(id, comando)
Eseguire
comandoogni volta che la proprietà figlio specificata da id cambia.idpuò essere specificato come una singola stringa o come un array di id (se la funzione deve essere chiamata per le modifiche in più proprietà).commandè un valore richiamabile (solitamente una funzione), tuttavia, per compatibilità con le estensioni scritte per le versioni precedenti di RKWard, può anche essere specificato come una stringa da valutare.La funzione restituisce il parametro
comando, per comodità (in modo da poterlo, ad esempio, assegnare a una variabile e/o richiamarlo durante l'inizializzazione).
- Classe «RObject»
Classe che rappresenta un singolo oggetto di R. Un'istanza di questa classe può essere ottenuta usando makeRObject(nome_oggetto). I seguenti metodi sono disponibili per le istanze della classe «RObject»:
Avvertimento
Se nel backend sono ancora presenti comandi, le informazioni fornite da questi metodi possono essere obsolete al momento dell'esecuzione del codice dell'estensione. Non farvi affidamento per operazioni critiche (rischio di perdita di dati).
- getName()
Restituisce il nome assoluto dell'oggetto.
- exists()
Restituisce se l'oggetto esiste. In genere, è necessario verificarlo prima di utilizzare uno dei metodi elencati di seguito.
- dimensions()
Restituisce un vettore di dimensioni (simile a dim() in R).
- classes()
Restituisce un vettore di classi (simile a class() in R).
- isClass(class)
Restituisce vero, se l'oggetto appartiene alla classe class.
- isDataFrame()
Restituisce vero, se l'oggetto è una cornice di dati.
- isMatrix()
Restituisce vero, se l'oggetto è una matrice.
- isList()
Restituisce vero, se l'oggetto è un elenco.
- isFunction()
Restituisce vero, se l'oggetto è una funzione.
- isEnvironment()
Restituisce vero, se l'oggetto è un ambiente.
- isDataNumeric()
Restituisce vero se l'oggetto è un vettore di dati numerici.
- isDataFactor()
Restituisce vero, se l'oggetto è un vettore di dati fattoriali.
- isDataCharacter()
Restituisce vero, se l'oggetto è un vettore di dati caratteriali.
- isDataLogical()
Restituisce vero, se l'oggetto è un vettore di dati logici.
- parent()
Restituisce un'istanza di «RObject» che rappresenta il genitore di questo oggetto.
- child(childname)
Restituisce un'istanza di «RObject» che rappresenta il figlio nome_figlio di questo oggetto.
- Classe «RObjectArray»
Un vettore di istanze di RObject. Un'istanza di questa classe può essere ottenuta utilizzando makeRObjectArray(nomi_oggetti). È particolarmente utile quando si tratta di «varslot» che consentono di selezionare più oggetti.
- Funzione include()
include(filename) può essere utilizzato per includere un file JS separato.
- Funzione doRCommand()
Obsoleto. Non utilizzare nelle nuove estensioni:doRCommand(comando, callback). Utilizzare invece new RCommand().
- new RCommand()-function
new RCommand(comando, id_facoltativo) può essere utilizzato per richiedere informazioni a R. Leggere la sezione su come interrogare R dall'interno di un'estensione per dettagli e avvertenze.