A code indicating the “class” (field type) of the associated form field.
A code stored as a single character value, as shown in the table below:
| Code | Meaning |
|---|---|
| A | TabPage |
| B | PushButton |
| C | ComboBox |
| D | Divider |
| E | OLE Object |
| F | Frame |
| G | Graphic |
| H | Camera |
| I | Picture |
| J | Calendar |
| K | Signature |
| L | ListBox |
| M | Menu Item |
| N | TabControl |
| O | OptionBox |
| P | Label |
| Q | ListView |
| R | GridControl |
| S | ScrollBar |
| T | ToggleButton |
| U | UserMessage |
| V | EntryField |
| W | TreeView |
| X | TreeView Node |
| Y | BarCode |
| Z | ProgressBar |
“Justification” status of a form field. Indicates how the data in the form field is aligned in the visual space.
A 1-character code, as shown in the table below:
Code | Meaning |
N | No justification (data is displayed as entered) |
L | Left justification (leading spaces are stripped from the data) |
R | Right justification (trailing spaces are stripped from the data) |
C | Centered (leading and trailing spaces are adjusted to center the data in the form field) |
W | Wrap (words are automatically wrapped and left-justified in form fields that visually occupy two or more rows) |
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
“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
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
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
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 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
“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.
“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
English 
Portuguese