Field WdgFont

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

Valid Values

A character string, up to 64 characters in length

Remarks

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

If the named font is not available on the system, the next closest font is substituted.

This attribute is Meaningful for graphic-class windows only.

If the font name is blank, then the object (window or form field) will use the font name of its parent object.  A window without a parent or a window whose parent is the BACKSCREEN will use the default font.  A form field without a parent will inherit the font name of the window it is displayed in.

ExampleFont inheritance when all objects have WdgFont set to “” (the null string):

See Also

DM, WdgClass, WdgFontSize

Field WdgTabStop

Indicates whether Tab navigation stops at this form field.

Valid Values

An integer code, as shown in the table below:

Code

Meaning

0

(DEFAULT) No

1

Yes

 

Remarks

A form field must be both available (or guarded) and a tab stop to acquire focus by Tab/BackTab navigation.

If a frame or option button box is not a tab stop, none of its child objects may acquire focus by Tab/BackTab navigation.

Field WdgBCBlue, WdgBCGreen and WdgBCRed

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

Required: When BC is set to $Null.

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, BC, FC, WdgFCBlue

Field WdgAutoDrop

“Autodrop” status of a drop-down list or combo box. Indicates whether the list portion of a drop-down list or combo box is to drop automatically when the form field acquires focus.

Valid Values

An integer code, as shown in the table below:

Code

Meaning

0

No (the end-user must trigger the drop)

1

Yes (the list drops automatically when the field acquires focus)

 

Field FC

Indicates the foreground color to be used for the object.

Valid Values

A non-negative integer from the color table

Remarks

If the attributes WdgFCBlue, WdgFCGreen, and WdgFCRed are all non-null, they, not FC, will determine the foreground color.

The special color code 0 indicates that the object is to take its foreground color from its parent object. For example, a check box in a frame would take the frame’s foreground color. If the FC setting for the frame is also 0, then the frame takes the window’s foreground color. If the window has no parent, and if its FC setting is also 0, then the window takes its foreground color from the Window Text Color in the MS-Windows control panel.

See Also

Predefined color constants, BC

Field SK

“Autoskip” status of a form field. Indicates whether activating or filling the form field triggers a focus shift.

Valid Values

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

Code

Meaning

N

No. The user must explicitly move focus away from this form field

Y

Yes. The focus automatically skips to “next” form field when this form field is completely full

Field WdgEditOptions

Indicates the special editing options applicable to this combo box.

Valid Values

An integer code, as shown in the table below:

Code

Meaning

0

Default (normal operation)

1

Track prefix (in Combo-box form fields, automatically select the list item that matches the value entered)

2

Mandatory match (in Combo-box form fields, the value in the combo box must match an entry in the associated list)

3

Both Track and Mandatory

4

Autocomplete (If the end-user types a valid prefix of an item in the list, that list item is selected, and the remaining typing is completed automatically)

5

Both Track prefix and Autocomplete

6

Both Mandatory match and Autocomplete

7

All of Track prefix, Mandatory match, and Autocomplete

 

Field WdgAvailable

“Availability” of a non-current window. Indicates whether and how an end-user can interact with a window when it is not the current window.

Valid Values

An integer code, as shown in the table below:

Code

Meaning

1

Protected (no interaction permitted; window cannot acquire focus)

2

Unprotected (unlimited interaction; window can acquire focus)

3

Guarded (interaction in the non-client area only; window cannot acquire focus)

 

Field LoadOrder

Order in which to load data into form instances in a display. Indicates how data is to be loaded into forms that are repeated in a display.

Valid Values

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

Code

Meaning

R

“Row major” order (left-to-right, top-to-bottom–default)

C

“Column-major” order (top-to-bottom, left-to-right)

 

Field RA (RD)

Number and direction of the instances of a form in a display.

RA is the number of repeats left-to-right across the display; RD is the number of repeats top-to-bottom down the display. The total number of instances of a particular form is the product of RA and RD (RA*RD).

For example:

Figure

Valid Values

An integer (1 to 999)

If RA or RD is not specified, 1 is used.

Remarks

When a form is repeated in a display, each instance of the form is assigned a subscript. The subscripts always begin at 1. If LoadOrder is row-major, then subscripts are assigned from left to right and top to bottom; otherwise, they are assigned from top to bottom and left to right.

See Also

LoadOrder, ThisForm (Language Reference)

en_CAEnglish