“Autoclear” status of a form field. Indicates whether existing data is automatically cleared from a form field when new data is entered.
Valid Values
A 1-character code, as shown in the table below:
Remarks
AC defaults to N, except for text-entry form fields with an N (numeric) data type (DT), which force an autoclear status of Y.
If AC is set to Y, the text will be selected when the end-user enters the field. Typing new text will replace the selected text. Typing Delete or Backspace will erase the text. Pressing an arrow key will deselect the text.
See Also
DT
Effect of a mouse double-click in a form field. Indicates whether a DoubleClick event is to be returned to the application program when a mouse double-click occurs in this form field.
Valid Values
A 1-character code, as shown in the table below:
Code | Meaning |
N | (DEFAULT) No |
Y | Yes |
Indicates how the form field responds to a GotFocus event (“transmit-on-enter” status).
Valid Values
A 1-character code, as shown in the table below:
Code | Meaning |
N | No response except to visually indicate GotFocus (DEFAULT) |
Y | Control returns to the application program every time the form field gets focus |
“Allow nulls” status of a form field. Indicates the value to be taken by the form field when it contains no data.
Valid Values
A 1-character code, as shown in the table below:
CODE | MEANING |
Y | When no data is entered, the field is $Null (valueless) |
N | When no data is entered, the field takes the value zero (0) if its data type (DT) is numeric or date, or the null string (“”) if its data type is alphanumeric |
Remarks
When AN is set to N, the end-user can set a toggle button to the null state.
See Also
DT
A user-defined symbol that identifies an object involved in a user interface event.
Valid Values
A character string, up to 18 characters long
Remarks
When a user interface event occurs, the WdgTag values for the objects involved are assigned to special system variables (Event.EventTag, Event.FieldTag, Event.MenuItemTag). This information identifies the objects involved in the event. The application program can then translate events into the desired action.
WdgTag defaults to the name of the object.
Indicates whether a text-entry form field consists of one line or multiple lines.
Valid Values
An integer code, as shown in the table below:
Code | Meaning |
0 | One line |
1 | Multiple lines |
See Also
WdgNumVisibleLines
Compress status of a form field. Indicates how the data mask associated with the form field is to be treated.
Valid Values
A 1-character code, as shown in the table below:
Code | Meaning |
Y | The data mask literals are not included in the value of the form field |
N | The data mask literals form part of the value of the form field |
Remarks
Form fields with data types (DT) of numeric and date force a compress status of Y.
See Also
DataMask, DT, WdgInputMask
The masking pattern used when data is input into the entry field.
Valid Values
A 256-character string, defining an input mask for the field.
Remarks
The input mask is applied only when the form field is available (unprotected) and has focus.
When the field loses focus, the input mask disappears; if a display mask (DataMask ) is available, that mask is then applied.
For a more detailed explanation of mask patterns and their relation to data types, see Masking.
See Also
DataMask
Specifies the name of an image file to be used as an icon for the form field during drag operations.
Valid Values
A character string, up to 64 characters
The value of a toggle button or menu item. Specifies the value of a toggle button or menu item in the OFF, ON, or NULL states.
Valid Values
A 256-character string
Remarks
If the toggle object has no ValRule, then WdgOnValue is used to determine whether the object is set “on”. (The object is “on” only if its current value exactly matches the WdgOnValue.)
If “allow nulls” is off (AN = N), then a toggle button may never exist in the null state.
Menu items are not permitted to exist in the null state.
See Also
AN, ValRule
English 
Portuguese