RiferimentoIndice
- Tipi di proprietà/Modificatori
- Elementi di uso generale da utilizzare in qualsiasi file XML (
.xml,.rkh,.pluginmap) - Elementi da utilizzare nella descrizione XML dell'estensione
- Proprietà degli elementi dell'estensione
- Estensioni integrabili fornite dalla versione ufficiale di RKWard
- Elementi da utilizzare nei file di
.pluginmap - Elementi da utilizzare nei file .rkh (guida)
- Funzioni disponibili per la programmazione della logica della GUI
In alcuni punti di questa introduzione abbiamo parlato delle «proprietà» degli elementi della GUI o altro. In realtà ci sono diversi tipi di proprietà. Di solito non è necessario preoccuparsi di questo, poiché basta usare il buon senso per collegare qualsiasi proprietà a qualsiasi altra proprietà. Tuttavia, internamente, esistono diverse tipologie di proprietà. Ciò che conta è quando si recuperano alcuni valori speciali nel modello JS. Nelle istruzioni getString ("id")/getBoolean ("id")/getList ("id") puoi anche specificare alcuni cosiddetti «modificatori» come questo: getString ("id.modifier"). Questo modificatore influenzerà il modo in cui sarà stampato il valore. Continuare a leggere per l'elenco delle proprietà e i modificatori che ciascuna di esse rende disponibili:
- Proprietà delle stringhe
Il tipo più semplice di proprietà, utilizzato semplicemente per contenere un pezzo di testo. Modificatori:
- Nessun modificatore ("")
La stringa come definita / impostata
- quotata
La stringa tra virgolette (adatta per il passaggio a R come carattere).
- Proprietà dei booleani
Proprietà che possono essere attivate o disattivate, vere o false. Ad esempio, le proprietà create dai tag <convert>, così come la proprietà che accompagna una <checkbox> (vedi sotto). I seguenti valori saranno restituiti in base al modificatore specificato:
- Nessun modificatore ("")
In modo predefinito, la proprietà restituirà 1 se è vero e 0 in caso contrario. Il modo consigliato per recuperare i valori booleani è usare
getBoolean(). Notare che pergetString(), sarà restituita la stringa «0» quando la proprietà è falsa. Questa stringa restituirebbe vero, non falso in JS.- "labeled"
Restituisce la stringa «true» se vero, «false», se falso o qualora siano state specificate stringhe personalizzate (in genere in una <checkbox>).
- "true"
Restituisce la stringa come se la proprietà fosse vera, anche se è falsa
- "false"
Restituisce la stringa come se la proprietà fosse falsa, anche se è vera
- "not"
Questa in realtà restituisce un'altra proprietà booleana, che è il contrario dell'attuale (cioè falso se vero, vero se falso)
- "numeric"
Obsoleto, fornito per compatibilità con le versioni precedenti. Come nessun modificatore "". Restituisce «1» se la proprietà è vera o «0» se è falsa.
- Proprietà degli interi
Una proprietà pensata per contenere un valore intero (ma ovviamente restituisce comunque una stringa di caratteri numerici al modello JS). Non accetta alcun modificatore. Usato nelle <spinbox> (vedi sotto)
- Proprietà dei numeri reali
Una proprietà pensata per contenere un valore numerico reale (ma ovviamente restituisce comunque una stringa di caratteri numerici al modello JS). Utilizzata da <spinbox> (vedi sotto)
- Nessun modificatore ("")
Per
getValue()/getString(), questo restituisce lo stesso di «formatted». Nelle versioni future, sarà invece possibile ottenere una rappresentazione numerica.- "formatted"
Restituisce il numero formattato (come stringa).
- Proprietà RObject
Una proprietà ha progettato una selezione di uno o più oggetti di R. Utilizzato soprattutto in varselector e varslot. I seguenti valori saranno restituiti in base al modificatore specificato:
- Nessun modificatore ("")
Per impostazione predefinita, la proprietà restituirà il nome completo dell'oggetto selezionato. Se viene selezionato più di un oggetto, i nomi degli oggetti saranno separati da interruzioni di riga («\n»).
- "shortname"
Come sopra, ma restituisce solo nomi brevi per gli oggetti. Ad esempio, a un oggetto all'interno di un elenco verrebbe assegnato solo il nome che ha all'interno dell'elenco, senza il nome dell'elenco.
- "label"
Come sopra, ma restituisce RKWard etichette degli oggetti (se nessuna etichetta disponibile, è uguale al nome breve)
- Proprietà dell'elenco di stringhe
Questa proprietà contiene un elenco di stringhe.
- Nessun modificatore ("")
Per
getValue()/getString(), vengono restituite tutte le stringhe separate da «\n». Tutti i caratteri «\n» in ogni elemento sono convertiti in «\n» letterale. Tuttavia, l'utilizzo consigliato è quello di recuperare il valore congetList(), che restituirà un array di stringhe.- "joined"
Restituisce l'elenco come una singola stringa, con elementi uniti da «\n». Contrariamente a nessun modificatore (""), le singole stringhe sono _senza_ escape.
- Proprietà del codice
Una proprietà detenuta dalle estensioni che ha generato codice. Questa è importante per l'integrazione delle estensioni, al fine di integrare il codice generato dall'estensione integrata nel codice generato dall'estensione di integrazione (di livello superiore). I seguenti valori saranno restituiti in base al modificatore specificato:
- Nessun modificatore ("")
Restituisce il codice completo, cioè le sezioni «preprocess», «calcola», »printout» e (ma non «preview») concatenate a una stringa.
- "preprocess"
Restituisce solo la sezione di pre-elaborazione del codice
- "calculate"
Restituisce solo la sezione di calcolo del codice
- "printout"
Restituisce solo la sezione di stampa del codice
- "preview"
Restituisce la sezione di anteprima del codice