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. |