The Drop Down List Object
var ddlMarSta = new TDropdownList();
var layForm = new TFormLayout();
var wndDropdownListSample = createWindow('DropdownList Sample');

ddlMarSta.add(1, 'Single');
ddlMarSta.add(2, 'Engaged');
ddlMarSta.add(3, 'Married');
ddlMarSta.setSelectedFirst();

layForm.add(new TText('Marital Status:'), ddlMarSta);
wndDropdownListSample.add(layForm);
showModal(wndDropdownListSample);

Drop down list constructor takes no paramenters.

Drop Down List Methods and Properties
Method/Property Description
add Adds an item to the drop down list object. Form: add(id, text)
Tip id parameter must be unique, so you may use
TUniqueId.getUniqueId()
clear Clears the list from all items. Example: ddlSample.clear();
disable Disables the drop down list object
enable Enables the drop down list object
getItemsIds Gets list items ids as array. Example:
var ids = ddlMarSta.getItemsIds();
// ids: {1, 2, 3}
getSelectedId Gets selected item id
getText Gets selected item text
isDisabled Returns true if the drop down list object is disables and false if not
remove Removes a specific item from the list by its id. Form: remove(id)
setOnChange Sets an event handler for selected item changed event. Form: setOnChange(eventHandler)
setOnItemOut Sets an event handler for item mouse out event. Form:
setOnItemOut(eventHandler)
setOnItemOver Sets an event handler for item mouse over event. Form:
setOnItemOver(eventHandler)
setSelectedFirst Sets selected the first item in the list
setSelectedId Sets selected the specified item by its id. Form: setSelectedId(id)
setSelectedItem Sets selected the specified item by its text. Form: setSelectedItem(text)