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 |
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. |
editmessage |
The message that appears at the bottom of the list to call by clicking on it. |
'***MODIFICA***' |
where |
The where statement used in the query for the select options. |
Undefined. |
remote |
Query remotely for the select options. |
Undefined. |
editwindowparam |
Parameters to be passed to the window.open() call. |
Empty string. |
rows |
Number of rows in the select; If rows > 1 the MULTIPLE is activated. |
1 |
id_descr |
Description of the ID field associated to the updated record-set. |
Empty string. |
clone |
Clone the HTML element and accustom its options for the IE. |
Undefined. |
sep |
A list separator for multiple selections. |
';' |
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. |
source |
A .mql filename to be queried for the select options. |
Undefined. |
buffer_elements |
|
Undefined. |
See also the
Adding Select Field example.