Case conversion status of a form field. Indicates how alphabetic characters typed into the form field are to be treated.
Valid Values
A 1-character code, as shown in the table below:
Code | Meaning |
M | Mixed case (characters will appear exactly as entered) |
U | Upper case (characters will be converted to upper case) |
L | Lower case (characters will be converted to lower case) |
Foreground color (custom). “Blends” a custom foreground color for the object, indicating the quantity of blue, green, and red to be used in the custom color.
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,
“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
The name assigned to a display (Displays); or, the name of the display in which a particular form appears (DisplayForms).
Valid Values
An 18-character string, containing a valid object name
See Also
ConstName, DDObjectName, DDOwnerName, DirName, DocName, EntName, FieldName, FormName, MenuName, OwnerName, RelName, RoleName, SetName, UserName, VarName
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
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
“Drop target” status of a form field. Indicates whether a form field can have a dragged form field dropped on it.
Valid Values
An integer code, as shown in the table below:
Code | Meaning |
N | (DEFAULT) No |
Y | Yes |