Value property

TextDropDownField.Value — Text

Special value available in formulas:

Item

TextDropDownField

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 value of the field. If no formula is associated with this property, the text drop-down field is an input field that users use to enter and edit values. If a formula is associated with this property, the text drop-down field is an output field that displays a calculated value derived through the formula.

If a text drop-down field is used as an output field, it behaves as a regular text field, but only calculated text strings that are present as options are displayed.

Referencing text drop-down field values from formulas

When referencing a text drop-down field value from a formula, there is no need to write .Value,Value after the field name if a text string is sought. These formulas are equivalent:

"test" & TextDropDownField1"test" & TextDropDownField1
"test" & TextDropDownField1.Value"test" & TextDropDownField1,Value

Above, & is looking to join two text strings together. As TextDropDownField1 can return a text string through its Value property, .Value,Value is implied.

Examples

TextDropDownField1 & "test"TextDropDownField1 & "test"

Returns a text string consisting of the value of TextDropDownField1 joined together with "test".

TextDropDownField1.Value & "test"TextDropDownField1,Value & "test"

Returns a text string consisting of the value of TextDropDownField1 joined together with "test". Writing out the Value property in formulas (by writing TextDropDownField1.ValueTextDropDownField1,Value) is rarely necessary.