Field FFSN

A user-assigned number that can be used to control the tabbing sequence within a group of form fields.

Valid Values

An integer (0 to 999)

Remarks

If FFSN is set to 0, the software automatically resets it to match the Z-order (WdgZOrder) specified for the form field. Accordingly, if all fields in a form are painted with FFSNs of 0, then the Painter’s structure diagram automatically defines the tab order when WINDOW SET TABORDER BY TABINDEX is in effect. (BY TABINDEX is the default setting for graphic windows.)

See Also

FNum, FSN, WdgZOrder

Field WdgFontSize

Specifies the point size of the font to be used to display text in the object.

Valid Values

An integer (1 to 999)

Remarks

A default value can be specified in the initialization file or environment variable. Consult your Getting Started and Guide to Operations (Windows Version).

This attribute is Meaningful for graphic-class windows only.

If the font size is 0, then the object (form field or window) will inherit its parent’s font size according to the same rules for inheritance for WdgFont.

See Also

DM, WdgClass, WdgFont

Field WdgID

A system defined identification number for a form field.

Valid Values

A number (longint)

Remarks

WdgID and WdgParID are used to create parent-child relationships.  A form field is the child of another form field if its WdgParID matches the other field’s WdgID.

Parent-child relationships are used to define relative positioning, color and font inheritance, and effective protection mode.

If an object’s WdgParID is 0, then its parent object is the form or menu to which it belongs.

See Also

WdgParID

Field ErrorMsg

A customized error message for a form field.

A message that is output if invalid data is entered into the form field. The message appears in any form field of the “user message” class (FT is set to V and DT is set to M) that is available in the current form or display.

Valid Values

A 256-character string

If no message is specified, the null string (“”) is used.

Remarks

If no message is specified, default validation error message is displayed. The default message can be customized using the Language Customizer (ZIMLANG) administrative utility.

See Also

DT, HelpMsg

Field FNum

A user-assigned numeric identifier for the form field.

Valid Values

An integer (0 to 999)

If no number is assigned, 0 is used.

Remarks

FNum can be used in an application program to identify the form field that had focus when control returned to the program. (See $FieldNum, $MenuItemNum, and $MouseFieldNum in the Language Reference.) For form fields with no transmit attributes, FNum is usually left at 0 unless the BY FIELDNUMBER option is to be used to set the tab order (see the WINDOW SET TABORDER command in the Language Reference).

See Also

FormNum, MenuNum, WNum

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 WdgNullValue, WdgOffValue and WdgOnValue

The value of a toggle button or menu item. Specifies the value of a toggle button or menu item in the OFF, ON, or NULL states.

Valid Values

A 256-character string

Remarks

If the toggle object has no ValRule, then WdgOnValue is used to determine whether the object is set “on”. (The object is “on” only if its current value exactly matches the WdgOnValue.)

If “allow nulls” is off (AN = N), then a toggle button may never exist in the null state.

Menu items are not permitted to exist in the null state.

See Also

AN, ValRule

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

en_CAEnglish