ДовідникЗміст
- Типи властивостей/Модифікатори
- Елементи загального призначення, які можна використовувати у будь-якому файлі XML (
.xml,.rkh,.pluginmap) - Елементи, які буде використано у описі XML додатка.
- Властивості елементів додатка
- Вбудовувані додатки, які є частиною офіційного пакунка RKWard
- Елементи, які можна використовувати у файлах
.pluginmap - Елементи, які можна використовувати у файлах довідки .rkh
- Функції для керування логікою графічного інтерфейсу за допомогою скриптів
У деяких фрагмента цього вступу ми згадували «властивості» елементів графічного інтерфейсу або інших елементів. Фактично, існує декілька різних типів властивостей. Зазвичай, перейматися цим непотрібно, оскільки ви можете скористатися простим здоровим глуздом для з’єднування між собою властивостей. Втім, на внутрішньому рівні використовуються різні типи властивостей. Це має значення, коли ми отримуємо певні особливі значення у шаблоні JS. У інструкціях getString ("id")/getBoolean ("id")/getList ("id") ви також можете вказати якийсь із так званих «модифікаторів» ось так: getString ("id.модифікатор"). Цей модифікатор впливатиме на спосіб виведення значення. Ознайомтеся зі списком властивостей та ідентифікаторами, які можна використовувати з цими властивостями:
- Рядкові властивості
Найпростіший тип властивості, використовується для зберігання текстового фрагмента. Модифікатори:
- Без модифікатора ("")
Рядок, яким його визначено або встановлено.
- quoted
Рядок у форматі з лапками (придатний для передавання R як символу).
- Булеві властивості
Властивості, які можуть мати значення «on» («увімкнено») або «off» («вимкнено»), «true» («так») або «false» («ні»). Наприклад, властивості, створені теґами <convert>, також властивість, що супроводжує <checkbox> (див. нижче). Відповідно до вказаного модифікатора, буде повернуто такі значення:
- Без модифікатора ("")
Типово властивість повертає значення 1, якщо має значення true, і 0, якщо має значення false. Рекомендованим способом отримання булевих значень є використання
getBoolean(). Зауважте, щоgetString()поверне рядок «0», якщо властивість матиме значення false. Такий рядок вважатиметься у JS значенням true, а не false.- "labeled"
Повертає рядок «true» якщо має значення «так», і «false», якщо має значення «ні», або будь-які вказані програмістом нетипові рядки (типово використовується у <checkbox>).
- "true"
Повертає рядок, так, наче властивість мала істинне значення, навіть якщо вона його не має
- "false"
Повертає рядок, так, наче властивість не мала істинного значення, навіть якщо вона його має
- "not"
Повертає обернене булеве значення властивості, протилежне до поточного (тобто «ні», якщо «так», і «так», якщо «ні»)
- "numeric"
Застарілий, зберігається для зворотної сумісності. Те саме, що і модифікатор "". Повертає «1», якщо властивість має значення «так» (true), і «0», якщо властивість має значення «ні» (false).
- Цілочисельні властивості
Властивість, яку створення для зберігання цілих значень (але, звичайно ж, вона повертатиме шаблону JS рядок із символів запису чисел). Вона не приймає будь-яких модифікаторів. Використовується у елементах <spinbox> (див. нижче).
- Властивості, які мають дійсні значення
Властивість, яку створення для зберігання дійсних значень (але, звичайно ж, вона повертатиме шаблону JS рядок із символів запису чисел). Використовується у елементах <spinbox> (див. нижче).
- Без модифікатора ("")
Для функцій
getValue() / getString()повертає те саме, що і «formatted». У майбутніх версіях можна буде отримати числове представлення.- "formatted"
Повертає форматоване число (як рядок).
- Властивості RObject
Властивість, створена для вибору одного або декількох об’єктів R. Найчастіше використовується у varselector-ах та varslot-ах. Повернуто буде такі значення, відповідно до вказаного модифікатора:
- Без модифікатора ("")
Типово властивість повертає повну назву вибраного об’єкта. Якщо вибрано декілька об’єктів, назви об’єктів буде відокремлено символами розриву рядка ("\n").
- "shortname"
Подібно до попереднього, але повертає лише скорочені назви об’єктів. Наприклад, для об’єкта у списку буде повернуто його назву всередині списку, без назви списку.
- "label"
Подібно до попереднього, але повертає мітки RKWard об’єктів (якщо мітки немає, повертає те саме, що і shortname)
- Властивості зі значеннями, які є списками рядків
Ця властивість містить список рядків.
- Без модифікатора ("")
Для
getValue()/getString(). Повертає усі рядки, відокремлені «\n». Усі символи «\n» у окремому записі буде екрановано як літерал «\n». Втім, рекомендованим способом отримання списків є функціяgetList(), яка повертає масив рядків.- "joined"
Повертає список як єдиний рядок, пункти списку буде відокремлено у такому рядку символами «\n». На відміну від використання без модифікатора (""), вміст окремих рядків не екрануватиметься.
- Властивості коду
Властивість, яку мають додатки, які створюють код R. Важлива для додатків, до яких вбудовуються інші додатки, власне для вбудовування коду, створеного вбудованим додатком до коду, який створено основним додатком (додатком верхнього рівня). Повертає такі значення, залежно від вказаного модифікатора:
- Без модифікатора ("")
Повертає код повністю, тобто розділи «preprocess», «calculate», «printout» (але не «preview»), з’єднані у один рядок.
- "preprocess"
Повертає лише розділ preprocess коду
- "calculate"
Повертає лише розділ calculate коду
- "printout"
Повертає лише розділ printout коду
- "preview"
Повертає розділ preview коду