Field HelpMsg

A customized help message for a form field.

A message that is output whenever the form field gets focus. The message appears in any form field of the “user message” class (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.

Field WdgParID

The identification number for the form field’s parent object.

Valid Values

A number (longint) (DEFAULT =  0)

Remarks

If WdgParID is 0, the form field’s parent is considered to be the form to which it belongs.

If WdgParID is non-zero, its parent is another form field in the form.

See Also

WdgID

Field FieldLen

Indicates the maximum length (in characters) of the form field’s data value.

Valid Values

An integer (1 to 32000)

Remarks

If the FieldLen exceeds the visual space available for displaying data in this form field (see Wdth, Hght, WdgWdth, and WdgHght), then the data can be scrolled through the visual space.

See Also

Hght, WdgHght, WdgWdth, Wdth

Field WdgLargeIncrement

A scroll bar increment. Specifies the amount of movement along the scroll bar when the scale on either side of the thumb is clicked.

Valid Values

A non-negative number (longint) (DEFAULT = 10)

Remarks

The usable scrolling range of a scroll bar is from -32,768 to 32,767. A WdgLargeIncrement outside this range will produce unpredictable results.

See Also

WdgMaxValue, WdgMinValue, WdgSmallIncrement

Field Fill

A character that is to be used to “fill” blank positions in a (text) form field or the client area of a window when it contains no form or display.

Valid Values

Any single character. If no character is specified, the space character is used.

Remarks

The fill character is not data; it simply delineates the dimensions of a blank or partially-blank object on the screen.

In a field, the fill starts to the right of the last non-blank character (alphanumeric fields), or to the left of any number (numeric fields).

Field WdgNumVisibleLines

The number of lines visible in a list box or combo box, or the number of visible lines in a multi-line entry field.

Valid Values

A non-negative integer

Remarks

In a list box or in the list portion of a combo box, indicates how may items are visible at one time.

In a multi-line entry field, indicates how many lines of text are visible at one time.

If WdgNumVisibleLines is 2 or greater, WdgMultiLine must be set to 1.

See Also

WdgItems, WdgMultiLine

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

en_CAEnglish