Body property
Special value available in formulas:
Item
The button 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. Button1.VisibleButton1,Visible and Item.VisibleItem,Visible are equivalent, for
instance.
The body of an alert window, displayed below the title.
If this property is not set, an empty body is used.
Entering formulas in the inspector
If you use the inspector to enter a value for this property, you can
incorporate formulas by enclosing them within {{
and
}}
markers.
Behind the scenes, Calcapp converts an inspector value with formulas to a single traditional formula. You can view this formula, or edit it directly, by selecting the Body property from the drop-down menu next to the formula bar.
The examples on this page use traditional formulas, where text strings and
other values are joined together using & and line breaks are produced
using NEWLINE. To
enter them in the inspector, be sure to enclose them within {{
and }}
markers. Alternatively, enter them in the formula bar.
Refer to the documentation for the Body property for a complex example on how to produce a text string incorporating field values using a formula.
Examples
Sets the alert window body to "The result is ," joined together with the value of the Result text field and a period.
This formula is associated with the OnPress property of a formula button, and causes an alert window to be displayed with the body Alert body and the title Alert title.
This formula is associated with the OnPress property of a
formula button, and causes a report to be opened containing all fields of
the app. If the report cannot be opened, an alert window is displayed
with the title Couldn't open report and the body
Reason: , joined together with the error message (available
through the Error
value given to the OnError
parameter to the AWAIT function).
This formula is associated with the OnPress property of a formula button, and enables a user to enter a value. When the value has been entered, an alert window is displayed with the entered value.