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 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 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 WdgDblClick

Effect of a mouse double-click in a form field. Indicates whether a DoubleClick event is to be returned to the application program when a mouse double-click occurs in this form field.

Valid Values

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

Code

Meaning

N

(DEFAULT) No

Y

Yes

 

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 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 MenuName

The name assigned to a menu.

Valid Values

An 18-character string, containing a valid object name

See Also

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

Field MenuNum

A user-assigned numeric identifier for the menu.

Valid Values

An integer (0 to 999)

If no number is assigned, 0 is used.

Remarks

MenuNum can be used in an application program to identify the menu that had focus when control returned to the program. (See $MenuNum, and $MenuItemNum in the Language Reference.)

See Also

FNum, FormNum, WNum

en_CAEnglish