ValidationMessage property
Special value available in formulas:
Item
The field this property is part of, enabling multiple checked items in the app designer to share the same formula and be updated all at once.
Consider the fields Field1 and Field2, which should
only be considered to be valid if their values are
greater than 4. Without using the Item
value, the Valid
property of Field1 would need to use the formula Field1 > 4Field1 > 4 and the Valid
property of Field2 would need to use the formula Field2 > 4Field2 > 4.
Using Item
, both formulas can read Item > 4Item > 4. This is useful
if you have many fields and you want to be able to update their
formulas all at once. To do so, click their check boxes in Calcapp
Creator and make sure that a checked field is selected. Then, when you
update a formula for one checked field, you update all the other
checked fields too, which is a great timesaver.
Use Item
in exactly the same way you'd use the regular
name. Field1.VisibleField1,Visible and Item.VisibleItem,Visible are equivalent, for
instance.
The validation message. It is shown when the field is invalid (that is, when the Valid property returns FALSE).
If this property is not set, it returns the validation message set for this field in Calcapp Creator.
Example
Shows the validation message "Provide at least three characters" if the number of characters entered in TextField1 is less than 3 and the message "Provide at most 20 characters" if the number of characters is greater than 20. The validation message is only shown if the Valid property of the field returns FALSE.
This Valid formula goes well with the ValidationMessage formula above: (LEN(TextField1) >= 3) && (LEN(TextField1) <= 20)(LEN(TextField1) >= 3) && (LEN(TextField1) <= 20)