divselect.comp
The DivSelect widget is the most sophisticated of the three available select widgets. Its intended for showing more complex drop-down lists.
It has many attributes that can be configured. The widget is not buffered similarly to the HtmlSelect widget.
Input Parameters:
Common Parameters
Parameters common to
select.comp,
htmlselect.comp and
divselect.comp widgets:
Parameter Name |
Description |
Default Value |
id |
Select Component's ID. |
Undefined. |
description |
Tooltip. |
Empty string. |
value |
Which <option> to select by default after the list has loaded (only works if the list is static or loaded in the form). |
Undefined. |
empty |
A first option is left empty and has value of empty . |
Undefined. |
empty_descr |
The empty option displays empty_descr . |
Empty string. |
edit |
A link to object that allows editing of the select list. |
Undefined. |
bgcolor |
Value of the background-color . |
Undefined. |
width |
Width in pixels of the select field. |
80 |
readonly |
If readonly is enabled and user clicks on the select element the alert pops ups saying 'Il campo non è modificabile' . |
Undefined. |
DivSelect Parameters
Parameter Name |
Description |
Default Value |
from |
A .mql filename to be queried for the select options. |
Undefined. |
buttons |
A list of additional buttons. |
Empty list. |
insert_parameters |
A list that indicates which fields in a new record will be modified. |
Empty list. |
insert_copyfields |
A list that indicates which fields in a new record will be only copied by the filter. |
Empty list. |
cols |
Array representing widths of columns. |
(280) |
empty_button |
Description displayed in the 'select empty field' button. |
Undefined. |
insert_descr |
Description of the 'new record' input button (undefined when the button is not displayed). |
Undefined. |
disp_template |
Evaluation function to define the description (the parameters are available with P [n]). For example: q{P[0]+' '+P[1]} |
Undefined. |
Detail_height |
Height of the detail window. |
600 |
icon |
Icon to use. |
'find' |
Detail_from |
If defined each record has additional button to call a separate form displaying the record's details; See also the description for the Detail_from parameter. |
Undefined. |
cache_params |
Not implemented. |
Undefined. |
rows |
Number of lines to be displayed in the selection. |
20 |
query_param |
Optional parameter to be added to the query for the select options. |
Empty string. |
orderby |
The order by statement used in the query for the select options. |
Empty string. |
where |
The where statement used in the query for the select options. |
Empty string. |
Detail_width |
Width of the detail window. |
800 |
Examples
See the
Adding Select Field example.
See also the
Using DivSelect Field example.