![](/trunk5/en/kdoctools5-common/top-kde.jpg)
Sumari
- Tipus de propietats/Modificadors
- Elements de propòsit general que s'utilitzaran en qualsevol fitxer XML (
.xml
,.rkh
,.pluginmap
) - Elements a utilitzar en la descripció XML del connector
- Propietats dels elements del connector
- Connectors incrustables distribuïts amb la versió oficial del RKWard
- Elements que s'utilitzaran en els fitxers
.pluginmap
- Elements per a utilitzar en fitxers .rkh (ajuda)
- Funcions disponibles per a la creació de scripts de lògica de la IGU
En alguns llocs d'aquesta introducció hem parlat de «propietats» d'elements de la IGU o d'altres. De fet, hi ha diversos tipus de propietats. Normalment no cal que us preocupeu per això, ja que podeu utilitzar el sentit comú per a connectar qualsevol propietat a qualsevol altra propietat. No obstant això, internament, hi ha tipus diferents de propietats. El que importa és quan s'obtenen alguns valors especials a la plantilla JS. A les sentències getString ("id")/getBoolean ("id")/getList ("id") també podeu especificar alguns dels anomenats «modificadors» com aquest: getString ("id.modifier")
. Aquest modificador afectarà, de manera que s'imprimirà el valor. Llegiu la llista de propietats i els modificadors que publiquen:
- Propietats de cadena
El tipus de propietat més senzill, utilitzat per a contenir un tros de text. Modificadors:
- Sense modificador ("")
La cadena com a definida/establerta.
- quoted
La cadena en la forma citada (adequada per a passar a R com a caràcter).
- Propietats booleanes
Propietats que poden estar activades o desactivades, certes o falses. Per exemple, les propietats creades per les etiquetes <convert>, també la propietat que acompanya una <checkbox> (vegeu a sota). Es retornaran els valors següents segons el modificador indicat:
- Sense modificador ("")
Per defecte, la propietat retornarà 1 si és certa i 0 en cas contrari. La manera recomanada d'obtenir els valors booleans és utilitzant
getBoolean()
. Tingueu en compte que per agetString()
, es retornarà la cadena "0" quan la propietat sigui falsa. Aquesta cadena s'avaluaria a certa, no a falsa en JS.- "labeled"
Retorna la cadena «true» (certa) quan és certa, «false» (falsa) quan és falsa, o qualsevol cadena personalitzada que s'hagi especificat (normalment en una <checkbox>).
- "true"
Retorna la cadena com si la propietat fos certa, encara que sigui falsa
- "false"
Retorna la cadena com si la propietat fos falsa, encara que sigui certa
- "not"
Això realment retorna una altra propietat booleana, la qual és la inversa de l'actual (és a dir, falsa si és certa, certa si és falsa)
- "numeric"
Obsoleta, proporcionada per a la compatibilitat cap enrere. Igual que sense modificador "". Retorna "1" si la propietat és certa, o "0" si és falsa.
- Propietats dels enters
Una propietat dissenyada per a tenir un valor enter (però, per descomptat, encara retorna una cadena de caràcters numèrics a la plantilla JS). No accepta cap modificador. Utilitzat en les <spinbox> (vegeu a sota)
- Propietats dels nombres reals
Una propietat dissenyada per a tenir un valor de nombre real (però, per descomptat, encara retorna una cadena de caràcters numèrics a la plantilla JS). Utilitzat en les <spinbox> (vegeu a sota)
- Sense modificador ("")
Per a
getValue()/getString()
, això retorna el mateix que "formatted". En canvi, en versions futures serà possible obtenir una representació numèrica.- "formatted"
Retorna el nombre amb format (com a cadena).
- Propietats dels RObject
Una propietat destinada a una selecció d'un o més objectes R. S'utilitza de forma més destacada en «varselectors» i «varslots». Es retornaran els valors següents segons el modificador indicat:
- Sense modificador ("")
De manera predeterminada, la propietat retornarà el nom complet de l'objecte seleccionat. Si se selecciona més d'un objecte, els noms dels objectes se separaran amb salts de línia ("\n").
- "shortname"
Com a dalt, però només retorna els noms curts dels objectes. Per exemple, un objecte dins d'una llista només rebria el nom que té dins de la llista, sense el nom de la llista.
- "label"
Com a dalt, però retorna les etiquetes del RKWard dels objectes (si no hi ha cap etiqueta disponible, aquesta serà la mateixa que el nom curt)
- Propietats de les llistes de cadenes
Aquesta propietat conté una llista de cadenes.
- Sense modificador ("")
Per a
getValue()/getString()
, això retorna totes les cadenes separades per «\n». Qualsevol caràcter «\n» de cada element s'escapa com a literal «\n». No obstant això, l'ús recomanat és obtenir el valor ambgetList()
, en el seu lloc, el qual retornarà una matriu de cadenes.- "joined"
Retorna la llista com una única cadena, amb els elements units amb «\n». En contrast a sense modificador (""), les cadenes individuals _no_ s'escapen.
- Propietats del codi
Una propietat dels connectors que han generat el codi. Això és important pels connectors incrustadors, per tal d'incrustar el codi generat pel connector incrustat en el codi generat pel connector incrustador (nivell superior). Es retornaran els valors següents segons el modificador indicat:
- Sense modificador ("")
Retorna el codi complet, és a dir, les seccions preprocess», «calculate», «printout» i (però no «preview») concatenades en una cadena.
- "preprocess"
Retorna només la secció «preprocess» del codi
- "calculate"
Retorna només la secció «calculate» del codi
- "printout"
Retorna només la secció «printout» del codi
- "preview"
Retorna la secció «preview» del codi