SeparateScreens property

OpenReportButton.SeparateScreens — Logical

Special value available in formulas:

Item

OpenReportButton

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 field values belonging to different screens are separated from one another in the report.

This property has no effect if only fields from a single screen are included in a report (which is determined by the FieldInclusion and IncludedFields properties).

The IncludeScreenLabels property determines if screen labels are included in reports. It only has an effect if this property returns TRUE.

If this property is not set, TRUE is assumed.

Sample reports

Without separated screens

Field1 1
Field2 2
Field3 3

With separated screens and screen labels

Screen1
Field1 1
 
Screen2
Field2 2
Field3 3

With separated screens and no screen labels

Field1 1
 
Field2 2
Field3 3

Examples

SeparateScreensSwitchFieldSeparateScreensSwitchField

Makes an open report button separate field values belonging to different screens only if SeparateScreensSwitchField is toggled to its "on" position.

OPENREPORT({ App }, SeparateScreens: SeparateScreensSwitchField)OPENREPORT({ App }; SeparateScreens: SeparateScreensSwitchField)

This formula is associated with the OnPress property of a formula button, and causes a report to be opened when the button is pressed. All fields of the app are considered, courtesy of the { App }{ App } parameter. The field values belonging to different screens are separated from one another only if SeparateScreensSwitchField is toggled to its "on" position.