override

When used with the calculate object, the override property indicates whether the field allows overrides to occur and disables or enables calculations. When used with the value object, the override property indicates whether a calculation override has occurred.

When there is no accompanying calculate object, this property has no effect and the user can enter a value in the field.

Syntax

Reference_Syntax.override = "error | ignore | disabled | warning"

Values

Type

Values

String

  • error

  • ignore

  • disabled

  • warning

  • Dismiss indicates that the user wants to use the calculated value.

  • Override indicates that the user understands the message, but chooses to override the calculated value.

The calculation is enabled and the user cannot override the calculated value. If the user tries to override the calculated value, the processing application displays an error message. To avoid the need for error messages, form designers can define these fields as read-only.

This is the default override value if the calculate object is included in the container object.

  • ignore

  • disabled

  • warning

  • Dismiss indicates that the user wants to use the calculated value.

  • Override indicates that the user understands the message, but chooses to override the calculated value.

The calculated value is supplied as a default. If the user overrides the value, the processing application allows the override to occur without displaying any warning message to the user.

This is the default override value if the calculate object is omitted from the container.

  • disabled

  • warning

  • Dismiss indicates that the user wants to use the calculated value.

  • Override indicates that the user understands the message, but chooses to override the calculated value.

The calculation is disabled. In an interactive context, the user can enter data in the field. The effect of this override value is independent of user action. The disabled value allows an event script to dynamically enable or disable a calculate object.

  • warning

  • Dismiss indicates that the user wants to use the calculated value.

  • Override indicates that the user understands the message, but chooses to override the calculated value.

The calculation is enabled and the calculated value is recommended over user-input values. If the user overrides the calculated value, the processing application displays a warning message. The message informs the user that the form object should use a calculated value and provides the user with two choices:

  • Dismiss indicates that the user wants to use the calculated value.

  • Override indicates that the user understands the message, but chooses to override the calculated value.

The application does not issue any warnings or prompts on subsequent focus gains by the same object.

Applies to

Model

Object

Form Model

calculate

value

Version

XFA 2.1

Examples

JavaScript

TextField1.calculate.override = "disabled";

FormCalc

TextField1.calculate.override = "disabled"

    // Ethnio survey code removed