Indicates whether Tab navigation stops at this form field.
An integer code, as shown in the table below:
Code | Meaning |
0 | (DEFAULT) No |
1 | Yes |
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.
Specifies the name of the font to be used to display text in the object.
A character string, up to 64 characters in length
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.
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):
DM, WdgClass, WdgFontSize
“Valid abbreviations” status of a form field. Indicates whether the entry form field may accept “valid abbreviations” of the values required in the field.
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 |
If the ValRule is “Smith|Jones” and VA is N, then only “Smith” or “Jones” is acceptable; the abbreviations “Smi”, “Sm”, “Jon”) are not.
ValRule, VR
“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).
A 1-character code, as shown in the table below:
Code | Meaning |
N | (DEFAULT) No |
Y | Yes |
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 data type of the form field’s value.
A 1-character code, as shown in the table below:
Code | Meaning |
A | Alphanumeric (letters, digits, punctuation) |
D | Date (digits in accordance with the mask specified for the form field (e.g., MM/DD/YY)) |
M | Message |
N | Numeric (digits, decimal point, plus and minus signs) |
T | Non-digit (any characters except digits) |
DataMask, WdgInputMask
Effect of a mouse click in a form field. Indicates whether a Click event is to be returned to the application program when a mouse click occurs in this form field.
A 1-character code, as shown in the table below:
Code | Meaning |
N | (DEFAULT) No |
Y | Yes |
A click can occur if the form field is available or guarded. If the field is guarded, the event occurs as soon as the left mouse button is pressed. If the field is available, the left mouse button must be pressed and released without producing some other action (e.g., text selection in an entry field).
FT, PM
The label that is to be attached to this form field, or the text that is to appear in a window’s caption.
A character string (up to 256 characters for FormFields; up to 64 characters for Windows)
For FormFields
The location of the label varies with the class and subclass of the form field, and the WdgLabelPosition.
To designate a character in the label as the mnemonic accelerator for the form field or menu item, place an ampersand immediately preceding the desired character (e.g., &Quit). The character appears underscored in the label. When the form field is used in a display, pressing the mnemonic accelerator (in combination with Alt/Extended Char/Compose) causes the object’s acceleration action to occur.
For Windows
If WdgCaption is set to 0 (no), WdgLabel is ignored.
If WdgLabel is left blank, it defaults to the null string (“”).
This attribute is Meaningful for graphic-class windows only.
FT, WdgCaption, WdgClass, WdgLabelPosition, WdgSubClass
Response of a form field to a change in value (Modified) event. Indicates how the form field responds to a change in value (Modified) event.
A 1-character code, as shown in the table below:
Code | Meaning |
N | (DEFAULT) No notification |
Y | Control returns to the application program if the form field is modified |
If WdgModified is set to Y, then FORM INPUT will transmit any time the end-user changes the value of the form field (for entry fields, this occurs for every press of a key that is not simply cursor motion).
If WdgModified is trapped, then LostFocusModified events (IT = Y) will never occur.
IT
“Autoselect” status of a form field. Indicates whether the content of a form field is automatically “selected” when the form field acquires focus. (For text-entry form fields, WdgAutoSelect and AC (autoclear) are the same.)
An integer code, as shown in the table below:
Code | Meaning |
0 | No |
1 | Yes |
WdgAutoSelect is not respected when the focus shift into the field occurs as the result of a mouse button press. The reason is that pressing the left mouse button starts a “pending” operation (i.e., selection in entry fields, “arming” in check boxes), and the user’s intent is not clear until the button is released and the mouse position checked.
AC
Indicates whether the form field is available to the end-user.
A 1-character code, as shown in the table below:
Code | Meaning |
U | Unprotected (the form field is available) |
G | Guarded (the form field is not available, but it can have focus) |
P | Protected (the form field is not available and cannot have focus) |
V | Unavailable (the form field is not available, cannot have focus, and has a “disabled” appearance–typically grayed) |
Form fields of the “label” and “graphic” classes are always protected; other form field classes may be unprotected, guarded, protected, or unavailable.
For a description of how availability is inherited, consult the User’s Guide.
FT
Portuguese 
English