InitializeComboBox event
The InitializeComboBox event is fired when a field is defined as a combo box that is filled by script.
In this event all possible combinations for the value / description pairs must be created as separated string of all items so that the for an existing value needed description is available for displaying. This event can be omitted for scripted combo boxes not using descriptions.
ValidationForm_InitializeComboBox( _
ByVal FieldName As String, _
ByRef ComboboxItems As String _
)
- FieldName
-
Name of the field that is defined as a combo box.
- ComboboxItems
-
String containing a separated list of the items displayed in the combo box. By default a semicolon is used as separator for values, a pipe as separator for descriptions, different separators can be configured in the validation form layout designer.
If you restrict a combo box then it is necessary to implement the ValidationForm_InitializeCombobox script event. Restricting a combo box is like adding a traditional validation rule where only restricted values are displayed in the list, based on some configured validation rule criteria. When implementing the ValidationForm_InitializeCombobox event you need to add all of the possible values that you expect and you also need to configure your extraction so that only these values are displayed.