ValueColor property

DateTimeField.ValueColor — Color

Special value available in formulas:

Item

DateTimeField

The field 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. Field1.VisibleField1,Visible and Item.VisibleItem,Visible are equivalent, for instance.

The color for values.

If this color is not set, it inherits the field value color from the screen the date and time field is part of.

Refer to the examples for the BackgroundColor property of screens for more information on how to set this property dynamically, enabling it to change with values entered by your users.

Consult our reference material on colors to learn more.

Examples

Color.BlackColor,Black

Sets the value color to black.

COLOR("black")COLOR("black")

Sets the value color to black. The COLOR function can return the same colors as those that can be accessed by writing Color.Color,, followed by the color name. However, any typos in the text string given to COLOR are only flagged as erroneous once your app is run, as opposed to writing Color.Color,, followed by the color name, in which case error are flagged immediately.

COLOR("#000000de")COLOR("#000000de")

Sets the value color to black, with limited transparency. The COLOR function recognizes a variety of formats, including the hex notation also used with CSS (Cascading Style Sheets).