Alterator/form

Материал из ALT Linux Wiki

Модуль (alterator lookout form)

Адресация полей

Каждое поле адресуется по значению атрибута name. Метка поля должна иметь имя, совпадающее с именем соответствующего ей поля.

Пример: 

(label text "Field name" name "field")(edit name "field" value "Field value")

Исключение - в качестве поля выступает виджет label. В этом случае метки с тем значением атрибута name быть не должно.

Пример: 

(label name "field" value "Field label") ;; Ошибка!!!
(label name "field" value "Static field")

Функции доступа к значениям полей

  • (form-value name) - получить значение поля с именем name
  • (form-value-list) - получить полный список имён полей и их значений в формате plist.

Функции модификации значений полей

  • (form-update-value name value) - изменить значение поля с именем name на значение value.
  • (form-update-value-list namelist data) - заполнить поля с именами перечисленными в списке namelist согласно значениям data возвращённым командой woo-read-first
  • (form-update-enum name data) - заполнить поле с именем name типа enum списком значений data, возвращённым командой woo-list

Другие функции

  • (form-bind name event proc) - привязать вызов процедуры proc в случае возникновения события event в виджете с именем name. Допустимые события: "click","change".
  • (form-replace url . url-args) - перенаправить на страницу по адресу url и передать аргументы url-args
  • (form-popup url . url-args) - вызвать страницу по адресу url как popup и передать аргументы url-args