select.comp
The Select widget is the simplest of the three available select widgets.
The displayed selection is a result of the specified query.
The selection is buffered which means that the contents of the selection will not change until the form is reloaded.
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. |
Proprietary Parameters
Parameter Name |
Description |
Default Value |
where |
The where statement used in the query for the select options. |
Undefined. |
source |
A .mql filename to be queried for the select options. |
Undefined. |
sep |
A list separator for multiple selections. |
';' |
rows |
Number of rows in the select; If rows > 1 the MULTIPLE is activated. |
1 |
remote |
Query remotely for the select options. |
Undefined. |
list |
With this parameter the widget can display static list without SQL table. The example is in /opt/masonsql/htdocs/data/public/funzioni.mql file. |
Empty. |
id_descr |
Description of the ID field associated to the updated record-set. |
Empty string. |
editwindowparam |
Parameters to be passed to the window.open() call. |
Empty string. |
editmessage |
The message that appears at the bottom of the list to call by clicking on it. |
'***MODIFICA***' |
clone |
Clone the HTML element and accustom its options for the IE. |
Undefined. |
buffer_elements |
|
Undefined. |
buffer |
A buffer name. It is useful when the widget is used repeatedly in the same form (e.g. with TABLE forms). When the buffer is defined all of the selectors are sent empty and then the browser fills them with a contents of the common buffer. |
Undefined. |
See also the
Adding Select Field example.