When you are gathering an end-user selection through a Combo Box widget, the following runtime properties are available:
Id: Identifies the widget in the HTML of the web screen or web block.
Read only. Text type.
SpecialListValue: In this widget you can present a Special List of options. If the user selects one of these special options, the corresponding value is gathered in this property. If the user selects an option that is not part of the Special List, this property is not used.
Read / Write. Text type.
Integer values are also accepted. They are converted to Text.
This runtime property has the same purpose as the widget property Special Variable. However, if you set the Special Variable property, even if there is not a value assigned to it, the SpecialListValue runtime property is ignored.
SpecialListValue is only available due to backwards compatibility, therefore you should avoid using it. Use the Special Variable property instead. Besides, if you are gathering data with a Combo Box widget inside a List Records or a Table Records, this runtime property does not even work!
Valid: Indicates whether the data the end-user typed is valid.
When inputs are submitted, the platform automatically performs two validations: If the input is mandatory, checks if the end-user filled it. It also checks if the data submitted by the end-user complies with the data type of the variable associated with the input.
If any of these two validations fails, the widget Valid property is set to False.
To implement your own server-side validations, simply assign this runtime property. In the render stage, the HTML of widgets that have the Valid runtime property set to False, is set with the Not_Valid class. Learn how to Validate End-User Inputs.
Read / Write. Boolean type.
ValidationMessage: Text message displayed next to the widget that explains why the input is not valid. If the Valid runtime property of a widget is set to True, the ValidationMessage is set with an empty string. If it is set to False, the ValidationMessage is set with a Default Validation Message.
When implementing your own server-side validations, assign a text to this runtime property, to explain the reason for the input being invalid.
The ValidationMessage is rendered in HTML as a <span class="ValidationMessage"> element following the HTML <input> element. See how widgets are translated into HTML tags. You can change the look and feel of the validation messages by customizing the ValidationMessage style in the style sheet.
Read / Write. Text type.
About Runtime Properties | About Combo Box Widget | Combo Box Widget Properties | Button Widget Properties | Link Widget Properties | Widgets and HTML Tags