“Default” status of a form field. Indicates whether this form field is the default form field in a group (e.g., a group of push buttons).
Valid Values
A 1-character code, as shown in the table below:
Code | Meaning |
N | (DEFAULT) No |
Y | Yes |
Remarks
A single push button may be defined to be the “default” button in a display. If multiple buttons are defined as default, one will be chosen.
The default button in a display will have its border accentuated to denote to the end-user that pressing Enter will “activate” that button.
The name of an application directory (Directories); otherwise, the one application directory in which the associated object may exist.
Valid Values
An 18-character string, containing a valid object name
Remarks
In Directories:
DirName is the name assigned to the directory.
In other Object Dictionary entity sets:
In any entity set, the principal object’s DirName must match the DirName of its owner.
If DirName is left blank, the object may exist in any number of application directories.
In DDDescriptions, DirName is where the object being described may be found.
In DisplayForms, DirName is where the owner-display of the associated form may be found.
See Also
ConstName, DDObjectName, DDOwnerName, DisplayName, DocName, EntName, FieldName, FormName, MenuName, OwnerName, RelName, RoleName, SetName, UserName, VarName
“Valid abbreviations” status of a form field. Indicates whether the entry form field may accept “valid abbreviations” of the values required in the field.
Valid Values
A 1-character code, as shown in the table below:
Code | Meaning |
N | No. Only a full-length entry is acceptable |
Y | Yes. The form field may accept a shorter-than-usual entry provided the entry conforms to the validation rule up to that point |
Remarks
If the ValRule is “Smith|Jones” and VA is N, then only “Smith” or “Jones” is acceptable; the abbreviations “Smi”, “Sm”, “Jon”) are not.
See Also
ValRule, VR
The vertical position of the top edge of the object, expressed in twips.
Valid Values
A non-negative number (longint)
Remarks
In DisplayForms, indicates the vertical position of the top edge of the first occurrence of a repeated form in relation to the display.
In FormFields, indicates the vertical position of the top edge of the form field in relation to the form field’s parent object (form or other form field, or menu or other menu item).
In Menus, indicates the vertical position of the top edge of the menu in relation to the screen. Applies only to menus of the Pop-up class.
In Windows, indicates the vertical position of the top edge of the window. For a pop-up window, this position is relative to the screen; for a clipped window, this position is relative to its parent window’s client area.
It is required when either Row (characters) or WdgRow (twips) must be specified
See Also
Row, WdgClass, WdgCol
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.
The horizontal position of the left edge of the object, expressed in twips.
Required: Either Col (characters) or WdgCol (twips) must be specified
Valid Values
A number (longint)
Remarks
In DisplayForms, indicates the horizontal position of the left edge of the first occurrence of the form in relation to the display.
In FormFields, indicates the horizontal position of the left edge of the form field in relation to its parent object (form field, form, menu).
In Menus, indicates the horizontal position of the left edge of the menu in relation to the window.
In Windows, indicates the horizontal position of the left edge of the window. For a pop-up window, this position is relative to the screen; for a clipped window, this position is relative to its parent window’s client area.
See Also
Col, WdgClass, WdgRow
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
English 
Portuguese