Data Field Options

Field Display Options Action When Option is ON
CLEARONKEY The field is cleared if the first keystroke entered in the field is a printable character. If the cursor keys a

re first used to position the cursor for a correction, the field contents are not erased.

INITIALBLANKS When the data form is displayed, blanks are displayed in the field, regardless of the value of the data variable. Protected characters specified in the field picture are still displayed in the field.
LFTADJUST Field contents are adjusted flush left upon exiting the field.
NOECHO Entered characters are echoed to the video screen with the "noecho" character ( by default an '*'). If the "noecho" character is not a printable character, nothing is echoed to the screen. This option is useful for defining password fields.

User Interface Options Action When Option is ON
FLDAUTOSELECT Used with field selection characters. Toggle ON to have checkboxes and Boolean toggle fields automatically toggle their value when the field is entered via the selection character. If ON for pushbutton fields, the pushbutton is automatically selected and the pushbutton action function is automatically executed.
RTADJUST Field contents are adjusted flush right upon exiting the field.
THSEPARATOR The field is redisplayed with the thousands separator (by default a comma) when leaving the field. Upon entering the field, the thousands separator is removed when the first keystroke is entered.
FILL If the user starts entering characters in the field, the user must type a character in every position in that field. The user may choose not to enter anything in the field. (See the MUSTFILL option if you want to require that the user fill the field.)
INSERTINIT Insert mode is automatically enabled when the user moves into the field.
MUSTFILL All positions in the field must be filled before exit is allowed. The user must enter something in this field. This option combines REQUIRED and FILL.
PROTECTED The user can move into and out of the field, but cannot change the field contents. Use this option to display data that you don't want altered. You can initially protect fields and later unprotect them, if desired. (See the SKIP option if you do not want the user to move into the field.)
REQUIRED The user must type at least one printable character in the field before exiting the field.

Data Conversion Options Action When Option is ON
REQ_AT_EXIT Similar to REQUIRED, except that field is checked before exiting the form; user is not trapped in the field. Do not use on a NOVAL_BLANK field or a SKIP field.
RTENTRY The physical cursor is locked in the right-most field position. As characters are entered, they are pushed to the left.
RTJUSTIFY Combines the options of RTENTRY, CLEARONKEY, and RTADJUST.
SKIP The user is not able to move into the field. Do not use on a REQ_AT_EXIT field.
FLDALTERED ON state sets field altered flag for that field; used to control when field validation occurs.
BLANKONZERO Numeric field will be blank if the value is zero.
NOVAL_BLANK Validation will be skipped while on dataform if field is blank. If exiting the form, validation will occur. Do not use on a REQ_AT_EXIT field.
CHKTRUNCATE During system field validation, the field entry is checked to see if truncation will occur during data conversion (decimal and floating point fields only).
FORCECONVERT When the user leaves the field, the contents of the field are converted and placed in the underlying data variable.
PICSKIP The protected characters are deleted from the field string before it is converted and placed in the data variable. Upon initial display, the protected characters in the picture string are placed in the field and then the converted value is displayed.
TRAILBLANKS Trailing blanks in the field are retained in the string when it is placed in the data variable. This option only makes sense for string fields.


Home Contents Previous Next