The masking pattern used to display the form field's data value.

Valid Values

The applicable masking pattern characters depend on the data type (DT) of the form field (e.g., non-digit, alphanumeric, numeric, and date)


Currently, DataMask is used only for entry fields.

In text-class windows, the DataMask acts as both a display and an input mask.

In graphic windows, the DataMask acts solely as a display mask.

The data entered by the end-user should conform to the data type assigned to the form field (e.g., if the field is date, the entry is a number of the form YYYYMMDD). When the form field loses focus, the data is formatted according to the DataMask.

For a more detailed explanation of mask patterns and their relation to data types, see Masking.

Behavior of the DataMask attribute in Text and Graphich Windows

Display-Masked Form Fields in Text-Class Windows

Display-masked form fields are shown with the display mask in place only when:

At all other times, the display mask is suppressed.

If an unprotected numeric form field has a display mask consisting entirely of floating $s or Zs, the appearance of the mask in an empty form field varies depending on the AN (allow nulls) attribute as follows:

Masking Pattern Nulls Allowed (AN="Y") Nulls Not Allowed (AN="N")
ZZZ.ZZ (field fill characters) 0
$$$.$$ (field fill characters) $0

Display-Masked Form Fields in Graphic Windows

A display-masked form field is shown with its mask in place whenever:

See Also

AN, CM, DT, FieldLen, WdgInputMask