Description
The list object has been added to the Form Designer with the 09.03h release. It can be used to allow the form user to choose one or more options from the specific list (see the common “BrowseQuery” property).
Object properties
In addition to the common properties, it’s important to underline the presence of the BrowseQuery property.
NOTE: the chosen options will be inserted in the database separated by chr(13) characters.
A the moment of the display, a couple of buttons will appear. They are used to add/remove one or more options.
Object events
- ChangeEvent – fired when one or more elements change inside the list. It can be used to
- change other form fields on the basis of the list values
- check the validity of the list values
Click here to read more about events.
Server-side properties (VB.NET/C#)
Enabled As Boolean– ifFalse, the list object can’t be edited (it will become grey-shadowed).Visible As Boolean– ifTrue, the list object will be visible by the user.
Server-side methods (VB.NET/C#)
GetItems() As DBArray– returns a DBArray object containing all the selectable elements of the list.GetSelectedItems() As DBArray– returns a DBArray object containing only the selected elements of the list.HasItem(ByVal item As String) As Boolean– checks if the specified elements appears as selectable in the list.SetItems(items As DBArray)– sets the DBArray elements as selectable elements in the list.SetSelectedItems(ByVal items As DBArray)– sets the DBArray elements as selected elements in the list.
Client-side methods (Javascript)
show()– shows the object.hide()– hides the object.