WINCTL :: form

protocol:

function

parameters:

structure containing form (or dialog) template

result:

WINCTL object

description:

ctlfrm   =   form(tmpl)

produce a form 'ctlfrm' from the description 'tmpl' (where tmpl is a structure defining the control frame and embedded controls such as buttons and textboxes)

example:

below is a typical form template

tmpl . type   =   "frame"
tmpl . control_name   =   "value_entry_frame"
tmpl . x   =   372
tmpl . y   =   103
tmpl . width   =   248
tmpl . height   =   247
tmpl . border_type   =   2 | 4
tmpl . border_width   =   3
tmpl . left_follows   =   "none"
tmpl . top_follows   =   "top"
tmpl . right_follows   =   "right"
tmpl . bottom_follows   =   "bottom"
tmpl . control_list   =   array(3)
tmpl . control_list[0] . type   =   "textbox"
tmpl . control_list[0] . control_name   =   "value_entry_textbox"
tmpl . control_list[0] . text   =   val
tmpl . control_list[0] . x   =   425
tmpl . control_list[0] . y   =   120
tmpl . control_list[0] . width   =   220
tmpl . control_list[0] . height   =   29
tmpl . control_list[0] . background_colour   =   26
tmpl . control_list[0] . border_type   =   2
tmpl . control_list[0] . left_follows   =   "left"
tmpl . control_list[0] . right_follows   =   "right"
tmpl . control_list[0] . top_follows   =   "top"
tmpl . control_list[0] . bottom_follows   =   "top"
tmpl . control_list[0] . border_width   =   2
tmpl . control_list[0] . complete_func_name   =   "value_entry_completed"
tmpl . control_list[1] . type   =   "button"
tmpl . control_list[1] . control_name   =   "button_3524"
tmpl . control_list[1] . background_colour   =   26
tmpl . control_list[1] . caption   =   "EDIT"
tmpl . control_list[1] . x   =   440
tmpl . control_list[1] . y   =   161
tmpl . control_list[1] . width   =   65
tmpl . control_list[1] . height   =   25
tmpl . control_list[1] . left_follows   =   "left"
tmpl . control_list[1] . top_follows   =   "top"
tmpl . control_list[1] . right_follows   =   "left"
tmpl . control_list[1] . bottom_follows   =   "top"
tmpl . control_list[1] . pressed_func_name   =   "open_proc_edit_dialog_func"
tmpl . control_list[2] . type   =   "listbox"
tmpl . control_list[2] . control_name   =   "proc_edit_listbox"
tmpl . control_list[2] . x   =   424
tmpl . control_list[2] . y   =   196
tmpl . control_list[2] . width   =   221
tmpl . control_list[2] . height   =   138
tmpl . control_list[2] . left_follows   =   "left"
tmpl . control_list[2] . top_follows   =   "top"
tmpl . control_list[2] . right_follows   =   "right"
tmpl . control_list[2] . bottom_follows   =   "bottom"
tmpl . control_list[2] . background_colour   =   26
tmpl . control_list[2] . option_list   =   build_proc_list()
tmpl . control_list[2] . context . option_list   =   tmp . control_list[2] . option_list
tmpl . control_list[2] . click_func_name   =   "select_proc_to_edit_func"