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
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.
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
“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) |
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
“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 |
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 |
“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) |
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) |
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)