Field Case

Case conversion status of a form field. Indicates how alphabetic characters typed into the form field are to be treated.

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

M

Mixed case (characters will appear exactly as entered)

U

Upper case (characters will be converted to upper case)

L

Lower case (characters will be converted to lower case)

 

Field WdgFCBlue, WdgFCGreen and WdgFCRed

Foreground color (custom). “Blends” a custom foreground color for the object, indicating the quantity of blue, green, and red to be used in the custom color.

Valid Values

An integer (0 to 255)

Remarks

In most windowing environments, a “palette” is typically available from which a color choice can be made. Depending on your system, the palette may have as few as 16, or as many as 16 million, colors.

When you specify a custom RGB (red, green, blue) color, Zim looks for the closest-matching color already in use. As a result, the match may not be exact.

See Also

Predefined color constants,

Field AC

“Autoclear” status of a form field. Indicates whether existing data is automatically cleared from a form field when new data is entered.

Valid Values

A 1-character code, as shown in the table below:

CODEMEANING
YThe field is to be cleared automatically when the end-user begins to modify it for the first time
NExisting data in the field remains when the end-user begins to modify the field

Remarks

AC defaults to N, except for text-entry form fields with an N (numeric) data type (DT), which force an autoclear status of Y.

If AC is set to Y, the text will be selected when the end-user enters the field. Typing new text will replace the selected text. Typing Delete or Backspace will erase the text. Pressing an arrow key will deselect the text.

See Also

DT

Field DisplayName

The name assigned to a display (Displays); or, the name of the display in which a particular form appears (DisplayForms).

Valid Values

An 18-character string, containing a valid object name

See Also

ConstName, DDObjectName, DDOwnerName, DirName, DocName, EntName, FieldName, FormName, MenuName, OwnerName, RelName, RoleName, SetName, UserName, VarName

Field TE

Indicates how the form field responds to a GotFocus event (“transmit-on-enter” status).

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

N

No response except to visually indicate GotFocus (DEFAULT)

Y

Control returns to the application program every time the form field gets focus

 

Field AN

“Allow nulls” status of a form field. Indicates the value to be taken by the form field when it contains no data.

Valid Values

A 1-character code, as shown in the table below:

CODE

MEANING

Y

When no data is entered, the field is $Null (valueless)

N

When no data is entered, the field takes the value zero (0) if its data type (DT) is numeric or date, or the null string (“”) if its data type is alphanumeric

Remarks

When AN is set to N, the end-user can set a toggle button to the null state.

See Also

DT

Field CM

Compress status of a form field. Indicates how the data mask associated with the form field is to be treated.

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

Y

The data mask literals are not included in the value of the form field

N

The data mask literals form part of the value of the form field

Remarks

Form fields with data types (DT) of numeric and date force a compress status of Y.

See Also

DataMask, DT, WdgInputMask

Field WdgInputMask

The masking pattern used when data is input into the entry field.

Valid Values

A 256-character string, defining an input mask for the field.

Remarks

The input mask is applied only when the form field is available (unprotected) and has focus.

When the field loses focus, the input mask disappears; if a display mask (DataMask ) is available, that mask is then applied.

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

See Also

DataMask

pt_BRPortuguese