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. |
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. |
edit |
A link to object that allows editing of the select list. |
Undefined. |
bgcolor |
Value of the background-color . |
Undefined. |
readonly |
If readonly is enabled and user clicks on the select element the alert pops ups saying 'Il campo non è modificabile' . |
Undefined. |
description |
Tooltip. |
Empty string. |
empty_descr |
The empty option displays empty_descr . |
Empty string. |
width |
Width in pixels of the select field. |
80 |
Proprietary Parameters
Parameter Name |
Description |
Default Value |
source |
A .mql filename to be queried for the select options. |
Undefined. |
where |
The where statement used in the query for the select options. |
Undefined. |
remote |
Query remotely for the select options. |
Undefined. |
buffer_elements |
|
Undefined. |
clone |
Clone the HTML element and accustom its options for the IE. |
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. |
rows |
Number of rows in the select; If rows > 1 the MULTIPLE is activated. |
1 |
editmessage |
The message that appears at the bottom of the list to call by clicking on it. |
'***MODIFICA***' |
editwindowparam |
Parameters to be passed to the window.open() call. |
Empty string. |
sep |
A list separator for multiple selections. |
';' |
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. |
See also the
Adding Select Field example.