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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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 properties

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.