IncludePersistentFields 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.
Whether persistent fields are reset, in addition to all fields which are not persistent. A persistent field retains its value between usage sessions.
In Calcapp Creator, the option is labeled Remember value in the inspector.
Examples
Makes a reset button reset persistent fields only if ResetPersistentFieldsSwitchField is toggled to its "on" position.
This formula is associated with the OnPress property of a formula button, and causes all persistent fields of the app to be reset, but only the persistent fields. FILTER is used to process all fields of the app, as returned by the App.Fields property. FILTER only returns persistent fields, as it accesses the Persistent property to determine if the field should be included. Finally, this array of persistent fields is passed to the RESET function, which resets the given fields.