Info text

The Info text control is used to display text that depends on the values of other controls on the page. Its primary purpose is to explain the consequences of the user's choices and provide supplemental information dynamically, guiding the user based on their interactions with other page elements.

Unlike all other controls, the Info text control will calculate its default value even when the NewEdit page opens in edit mode, and it will never pass its value to the InsertUpdate procedure when the page is saved.

If you need to display information about a chosen value in a single control, do note that both Dropdown and Textbox with autosearch already have built-in support for info text to explain their chosen value.

If you need to display errors or warnings caused by a chosen value, consider using field validation instead.

Choosing the right control:

  1. Uneditable text control:

    • Use this control when you need to display text that the user is not allowed to edit.
    • Ideal for showing locked or read-only information, or when the user lacks permission to modify the content.
  2. Info text control:

    • Use this control when you want to display text that depends on the values of other controls on the page.
    • Use it to explain the consequences of the user's choices based on their interactions with other elements.
  3. Hidden control:

    • Use this control when you need to include values that are not visible to the end user.
    • It allows you to provide data or text that can be referenced by other controls.
Start value: The start value is always computed from the default value specification.
Return value: Nothing
Supported in: NewEdit Multirow

Default value

SQL Call: Default value

Retrieves the default value for the control.

May modify database: No

Resultset: Default value

Table count: repeated exactly once
Row count: exactly one row
Columns
<column with ordinal 1> mandatory string
The default value

Validation

SQL Call: Validation

This call is only made if there is a field validation set for the field info and the field has any content.

Live Validation

Performs field validation when the user leaves the field or one of its dependencies is changed, initial values set by default value and initial values in edit-mode are not validated.

Save Validation

When saving the validation runs server side if the field value has changed. A field value is considered changed if in new mode the value is anything other than NULL. In edit mode it is considered changed if it has a value that was not returned by the GetEditFields procedure.

May modify database: No

Parameters

@Value string
The value of the field, the procedure will not be called if value is NULL.

Resultset: Validation messages (optional)

Table count: repeated zero or one time
Row count: zero or one row
Columns
Error optional string
Error message to display. Blocks the user from saving.
Info optional string
Informative message to display. Does not block saving.
Warning optional string
Warning message to display. Does not block saving.