Property reference
Most of Calcapp’s properties can be set through formulas. As a result, they can take into account values entered by your users and calculated through your fields. Read our guide to learn more.
App
| DeviceType | Returns a text string indicating the type of the device running the app, or a blank value if the device is not known. |
| OperatingSystem | Returns a text string indicating the operating system of the device running the app, or a blank value if the operating system is not known. |
| Reference | Returns a reference to the app object. |
| UserEmailAddress | Returns the email address of the signed-in user, or a blank value if no user is signed in. |
| ZoomLevel | Represents the zoom level of the app, which determines the size of the user interface. |
Button
| BackgroundColor | Represents the background color, which is used to paint the area behind the button text. |
| Enabled | Represents whether a button is enabled. |
| ForegroundColor | Represents the foreground color for buttons. |
| Label | Represents the label of the button. |
| Reference | Returns a reference to the button. |
| Visible | Represents whether a button is visible. |
Date and time field
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| BlankValueColor | Represents the color for blank values of date and time fields. |
| Enabled | Represents whether a field is enabled. |
| FormattedValue | Returns the value of the date and time field, formatted as a text string. |
| InitialValue | Represents the initial value of a date and time field, displayed before the user has entered an explicit value. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| Reference | Returns a reference to the date and time field. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Value | Represents the value of a date and time field. |
| ValueColor | Represents the color for values of date and time fields. |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Download report button
| BackgroundColor | Represents the background color, which is used to paint the area behind the button text. |
| Enabled | Represents whether a button is enabled. |
| Epilogue | Represents the text that appears after field values in an attached file. |
| FileName | Represents the name of the file downloaded through a download report button. |
| ForegroundColor | Represents the foreground color for buttons. |
| IncludedFields | Represents the fields that are included in reports generated by a download report button. |
| Label | Represents the label of the button. |
| Prologue | Represents the text that appears before field values in an attached file. |
| Reference | Returns a reference to the download report button. |
| Visible | Represents whether a button is visible. |
Email report button
| BackgroundColor | Represents the background color, which is used to paint the area behind the button text. |
| BlindCarbonCopy | Represents the blind carbon copy ("BCC") recipients of an email sent through an email report button. |
| Body | Represents the body of an email sent through an email report button. |
| CarbonCopy | Represents the carbon copy ("CC") recipients of an email sent through an email report button. |
| Enabled | Represents whether a button is enabled. |
| Epilogue | Represents the text that appears after field values. |
| FileName | Represents the name of the file that emailed attachments are saved as when an email is sent through an email report button. |
| ForegroundColor | Represents the foreground color for buttons. |
| IncludedFields | Represents the fields that are included in reports generated by an email report button. |
| Label | Represents the label of the button. |
| Prologue | Represents the text that appears before field values. |
| Recipients | Represents the primary recipients of an email sent through an email report button. |
| Reference | Returns a reference to the email report button. |
| ReplyTo | Represents the Reply-To field of an email sent through an email report button. |
| Sender | Represents the Sender field of an email sent through an email report button. |
| SubjectLine | Represents the subject line of an email sent through an email report button. |
| Visible | Represents whether a button is visible. |
Field
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| Enabled | Represents whether a field is enabled. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| Reference | Returns a reference to the field. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Form group
| BackgroundColor | Represents the background color, which is used to paint the areas behind form group elements such as fields and buttons. |
| Label | Represents the label of the form group. |
| LabelColor | Represents the color for labels of form groups. |
| Reference | Returns a reference to the form group. |
| Visible | Represents whether a form group is visible. |
Form screen
| AccentColor | Represents the accent color, which is used in apps to color smaller areas with a well-saturated color. |
| BackdropColor | Represents the backdrop color, which may be used to paint the lowest layer of an app, behind the background of elements such as fields, buttons and navigators. |
| BackgroundColor | Represents the background color, which is used to paint the areas behind elements such as fields, buttons and navigators. |
| BarBackgroundColor | Represents the background color of the navigation bar. |
| BarForegroundColor | Represents the foreground color of the navigation bar, which is used to paint the text and icons of the navigation bar. |
| ButtonForegroundColor | Represents the foreground color for buttons. |
| DarkForegroundColor | Represents the dark foreground color, which is used to paint text and icons on a light background. |
| DividerColor | Represents the divider color, which is used for the separators that appear between elements such as fields, buttons and navigators. |
| FieldBlankValueColor | Represents the color for blank values of fields. |
| FieldLabelColor | Represents the color for labels of fields. |
| FieldValueColor | Represents the color for values of fields. |
| GroupLabelColor | Represents the color for labels of form groups. |
| Label | Represents the label of the screen, which serves as its title. |
| LightForegroundColor | Represents the light foreground color, which is used to paint text and icons on a dark background. |
| MessageBackgroundColor | Represents the background color of all transient messages that appear in an app. |
| NavigatorLabelColor | Represents the color for labels of navigators. |
| NextScreen | Represents the screen that appears when the user moves to the next screen. |
| NextScreenAvailable | Represents whether the screen following the form screen is available. |
| PrimaryColor | Represents the primary color, which often uses a bold hue. |
| Reference | Returns a reference to the form screen. |
| TextBoxTextColor | Represents the color for text that appears in text boxes. |
| WarningColor | Represents the warning color, which is used to paint things like error messages and warning labels, including validation messages of fields. |
List screen
| AccentColor | Represents the accent color, which is used in apps to color smaller areas with a well-saturated color. |
| ActiveNavigator | Returns the navigator that was last activated by the user and is part of this list screen, or a blank value if no navigator has been activated. |
| BackdropColor | Represents the backdrop color, which may be used to paint the lowest layer of an app, behind the background of elements such as fields, buttons and navigators. |
| BackgroundColor | Represents the background color, which is used to paint the areas behind elements such as fields, buttons and navigators. |
| BarBackgroundColor | Represents the background color of the navigation bar. |
| BarForegroundColor | Represents the foreground color of the navigation bar, which is used to paint the text and icons of the navigation bar. |
| ButtonForegroundColor | Represents the foreground color for buttons. |
| DarkForegroundColor | Represents the dark foreground color, which is used to paint text and icons on a light background. |
| DividerColor | Represents the divider color, which is used for the separators that appear between elements such as fields, buttons and navigators. |
| FieldBlankValueColor | Represents the color for blank values of fields. |
| FieldLabelColor | Represents the color for labels of fields. |
| FieldValueColor | Represents the color for values of fields. |
| GroupLabelColor | Represents the color for labels of form groups. |
| Label | Represents the label of the screen, which serves as its title. |
| LightForegroundColor | Represents the light foreground color, which is used to paint text and icons on a dark background. |
| MessageBackgroundColor | Represents the background color of all transient messages that appear in an app. |
| NavigatorLabelColor | Represents the color for labels of navigators. |
| PrimaryColor | Represents the primary color, which often uses a bold hue. |
| Reference | Returns a reference to the list screen. |
| TextBoxTextColor | Represents the color for text that appears in text boxes. |
| WarningColor | Represents the warning color, which is used to paint things like error messages and warning labels, including validation messages of fields. |
Navigator
| BackgroundColor | Represents the background color, which is used to paint the area behind the navigator. |
| Label | Represents the label of the navigator. |
| LabelColor | Represents the color for labels of navigators. |
| NextScreen | Represents the screen that appears when the user activates the navigator. |
| Reference | Returns a reference to the navigator. |
| Visible | Represents whether a navigator is visible. |
Number drop-down field
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| BlankValueColor | Represents the color for blank values of number drop-down fields. |
| Enabled | Represents whether a field is enabled. |
| Index | Returns the position of the selected item in the number drop-down field, starting with 1, or a blank value if no item has been selected. |
| InitialValue | Represents the initial value of a number drop-down field, displayed before the user has entered an explicit value. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| Reference | Returns a reference to the number drop-down field. |
| Size | Returns the number of items that are part of a number drop-down field. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Value | Represents the value of a number drop-down field. |
| ValueColor | Represents the color for values of number drop-down fields. |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Number field
| ActiveTrackColor | Represents the active track color for sliders of number fields. |
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| BlankValueColor | Represents the color for blank values of number fields. |
| Enabled | Represents whether a field is enabled. |
| FormattedValue | Returns the value of the number field, formatted as a text string. |
| InitialValue | Represents the initial value of a number field, displayed before the user has entered an explicit value. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| LeadingUnit | Represents the leading unit of the field. |
| MaximumValue | Represents the maximum value of the number field this property is associated with. |
| MinimumValue | Represents the minimum value of the number field this property is associated with. |
| Reference | Returns a reference to the number field. |
| StepperColor | Represents the color for steppers of number fields. |
| ThumbColor | Represents the thumb color for sliders of number fields. |
| TrackColor | Represents the track color for sliders of number fields. |
| TrailingUnit | Represents the trailing unit of the field. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Value | Represents the value of a number field. |
| ValueColor | Represents the color for values of number fields. |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Reset button
| BackgroundColor | Represents the background color, which is used to paint the area behind the button text. |
| Enabled | Represents whether a button is enabled. |
| ForegroundColor | Represents the foreground color for buttons. |
| IncludedFields | Represents the fields that are reset by a reset button. |
| Label | Represents the label of the button. |
| Reference | Returns a reference to the reset button. |
| Visible | Represents whether a button is visible. |
Screen
| AccentColor | Represents the accent color, which is used in apps to color smaller areas with a well-saturated color. |
| BackdropColor | Represents the backdrop color, which may be used to paint the lowest layer of an app, behind the background of elements such as fields, buttons and navigators. |
| BackgroundColor | Represents the background color, which is used to paint the areas behind elements such as fields, buttons and navigators. |
| BarBackgroundColor | Represents the background color of the navigation bar. |
| BarForegroundColor | Represents the foreground color of the navigation bar, which is used to paint the text and icons of the navigation bar. |
| ButtonForegroundColor | Represents the foreground color for buttons. |
| DarkForegroundColor | Represents the dark foreground color, which is used to paint text and icons on a light background. |
| DividerColor | Represents the divider color, which is used for the separators that appear between elements such as fields, buttons and navigators. |
| FieldBlankValueColor | Represents the color for blank values of fields. |
| FieldLabelColor | Represents the color for labels of fields. |
| FieldValueColor | Represents the color for values of fields. |
| GroupLabelColor | Represents the color for labels of form groups. |
| Label | Represents the label of the screen, which serves as its title. |
| LightForegroundColor | Represents the light foreground color, which is used to paint text and icons on a dark background. |
| MessageBackgroundColor | Represents the background color of all transient messages that appear in an app. |
| NavigatorLabelColor | Represents the color for labels of navigators. |
| PrimaryColor | Represents the primary color, which often uses a bold hue. |
| Reference | Returns a reference to the screen. |
| TextBoxTextColor | Represents the color for text that appears in text boxes. |
| WarningColor | Represents the warning color, which is used to paint things like error messages and warning labels, including validation messages of fields. |
Server relay button
| BackgroundColor | Represents the background color, which is used to paint the area behind the button text. |
| Enabled | Represents whether a button is enabled. |
| ForegroundColor | Represents the foreground color for buttons. |
| IncludedFields | Represents the fields that are sent to a server by a server relay button. |
| Label | Represents the label of the button. |
| Reference | Returns a reference to the server relay button. |
| Visible | Represents whether a button is visible. |
Switch field
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| Enabled | Represents whether a field is enabled. |
| InitialValue | Represents the initial value of a switch field, displayed before the user has entered an explicit value. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| Reference | Returns a reference to the switch field. |
| ThumbColor | Represents the color of the thumb, or handle, of switch fields. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Value | Represents the value of a switch field. |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Text box
| BackgroundColor | Represents the background color, which is used to paint the area behind the text box. |
| LinkColor | Represents the link color of text boxes. |
| QuoteDecorationColor | Represents the color of the decorations associated with quotes of text boxes. |
| Reference | Returns a reference to the text box. |
| TextColor | Represents the text color of text boxes. |
| Visible | Represents whether the text box is visible. |
Text drop-down field
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| BlankValueColor | Represents the color for blank values of text drop-down fields. |
| Enabled | Represents whether a field is enabled. |
| Index | Returns the position of the selected item in the text drop-down field, starting with 1, or a blank value if no item has been selected. |
| InitialValue | Represents the initial value of a text drop-down field, displayed before the user has entered an explicit value. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| Reference | Returns a reference to the text drop-down field. |
| Size | Returns the number of items that are part of a text drop-down field. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Value | Represents the value of a text drop-down field. |
| ValueColor | Represents the color for values of text drop-down fields. |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Text field
| BackgroundColor | Represents the background color, which is used to paint the area behind the field. |
| BlankValueColor | Represents the color for blank values of text fields. |
| Enabled | Represents whether a field is enabled. |
| InitialValue | Represents the initial value of a text field, displayed before the user has entered an explicit value. |
| Label | Represents the label of the field, which is normally shown to the left of the value. |
| LabelColor | Represents the color for field labels. |
| Reference | Returns a reference to the text field. |
| Valid | Represents whether the field is valid. |
| ValidationMessage | Represents the validation message of the field, which is shown when the field is invalid (that is, when the Valid property returns FALSE). |
| Value | Represents the value of a text field. |
| ValueColor | Represents the color for values of text fields. |
| Visible | Represents whether a field is visible. |
| WarningColor | Represents the warning color, which is used to paint things like validation messages of fields. |
Text screen
| AccentColor | Represents the accent color, which is used in apps to color smaller areas with a well-saturated color. |
| BackdropColor | Represents the backdrop color, which may be used to paint the lowest layer of an app, behind the background of elements such as fields, buttons and navigators. |
| BackgroundColor | Represents the background color, which is used to paint the areas behind elements such as fields, buttons and navigators. |
| BarBackgroundColor | Represents the background color of the navigation bar. |
| BarForegroundColor | Represents the foreground color of the navigation bar, which is used to paint the text and icons of the navigation bar. |
| ButtonForegroundColor | Represents the foreground color for buttons. |
| DarkForegroundColor | Represents the dark foreground color, which is used to paint text and icons on a light background. |
| DividerColor | Represents the divider color, which is used for the separators that appear between elements such as fields, buttons and navigators. |
| FieldBlankValueColor | Represents the color for blank values of fields. |
| FieldLabelColor | Represents the color for labels of fields. |
| FieldValueColor | Represents the color for values of fields. |
| GroupLabelColor | Represents the color for labels of form groups. |
| Label | Represents the label of the screen, which serves as its title. |
| LightForegroundColor | Represents the light foreground color, which is used to paint text and icons on a dark background. |
| MessageBackgroundColor | Represents the background color of all transient messages that appear in an app. |
| NavigatorLabelColor | Represents the color for labels of navigators. |
| NextScreen | Represents the screen that appears when the user moves to the next screen. |
| NextScreenAvailable | Represents whether the screen following the text screen is available. |
| PrimaryColor | Represents the primary color, which often uses a bold hue. |
| Reference | Returns a reference to the text screen. |
| TextBoxTextColor | Represents the color for text that appears in text boxes. |
| WarningColor | Represents the warning color, which is used to paint things like error messages and warning labels, including validation messages of fields. |