Combo Box Widget Runtime Properties

When you are gathering an end-user selection through a Combo Box widget, the following runtime properties (A property that you only can access at run-time. Runtime properties can be Read/Write or Read only.) are available:

Id: Identifies the widget in the HTML of the web screen or web block.

You can use this runtime property when, for example, developing your JavaScript.

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 value of your check box is valid within the context of your application business logic.

This property is set automatically by the platform when submitting the widget with a Button or Link whose Method property is Navigate.

You can set it to True or False with explicit logic, in a screen action. This allows you to perform further validations, more business oriented, in the server.

Read / Write. Boolean type.

When an input is invalid, that is, when this property is False, it is rendered with the special class Not_Valid. Learn more about this in how widgets are translated into HTML tags.

ValidationMessage: Text message set by you when submitting the widget with a Button or Link whose Method property is Submit or Ajax. This runtime property is empty, when the Valid runtime property is True.

You can set it with explicit logic, in a screen action. This, along with the Valid property, allows you to perform further validations, more business oriented, in the server.

Read / Write. Text type.

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 layout of the validation messages customizing the ValidationMessage style in the style sheet.

Validations always take place on the server side for this widget. See the Validation property in Button Widget Properties and Link Widget Properties.

Widget runtime properties are only available in the scope of the web screen or web block if the widget property Name is not empty.