Label property

EmailReportButton.Label — Text

Special value available in formulas:

Item

EmailReportButton

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 label. If this property is not set, it returns the label set for this button in Calcapp Creator.

Example

"Send email" & IF(!Field1.Valid, " ⚠️")"Send email" & IF(!Field1,Valid; " ⚠️")

Sets the button label to "Send email" if Field1 is valid (by consulting its Valid property). If Field1 is not valid, the button label is set to "Send email ⚠️" (with a warning triangle). You can also consider disabling the button if Field1 is invalid using the Enabled property, or making it invisible using the Visible property.