A user-assigned number that can be used to control the tabbing sequence within a group of form fields.
Valid Values
An integer (0 to 999)
Remarks
If FFSN is set to 0, the software automatically resets it to match the Z-order (WdgZOrder) specified for the form field. Accordingly, if all fields in a form are painted with FFSNs of 0, then the Painter’s structure diagram automatically defines the tab order when WINDOW SET TABORDER BY TABINDEX is in effect. (BY TABINDEX is the default setting for graphic windows.)
See Also
FNum, FSN, WdgZOrder
Specifies the point size of the font to be used to display text in the object.
Valid Values
An integer (1 to 999)
Remarks
A default value can be specified in the initialization file or environment variable. Consult your Getting Started and Guide to Operations (Windows Version).
This attribute is Meaningful for graphic-class windows only.
If the font size is 0, then the object (form field or window) will inherit its parent’s font size according to the same rules for inheritance for WdgFont.
See Also
DM, WdgClass, WdgFont
A system defined identification number for a form field.
Valid Values
A number (longint)
Remarks
WdgID and WdgParID are used to create parent-child relationships. A form field is the child of another form field if its WdgParID matches the other field’s WdgID.
Parent-child relationships are used to define relative positioning, color and font inheritance, and effective protection mode.
If an object’s WdgParID is 0, then its parent object is the form or menu to which it belongs.
See Also
WdgParID
A customized error message for a form field.
A message that is output if invalid data is entered into the form field. The message appears in any form field of the “user message” class (FT is set to V and DT is set to M) that is available in the current form or display.
Valid Values
A 256-character string
If no message is specified, the null string (“”) is used.
Remarks
If no message is specified, default validation error message is displayed. The default message can be customized using the Language Customizer (ZIMLANG) administrative utility.
See Also
DT, HelpMsg
Indicates the orientation of a scroll bar form field.
Valid Values
An integer code, as shown in the table below:
Code | Meaning |
1 | Vertical |
2 | Horizontal |
A user-assigned numeric identifier for the form field.
Valid Values
An integer (0 to 999)
If no number is assigned, 0 is used.
Remarks
FNum can be used in an application program to identify the form field that had focus when control returned to the program. (See $FieldNum, $MenuItemNum, and $MouseFieldNum in the Language Reference.) For form fields with no transmit attributes, FNum is usually left at 0 unless the BY FIELDNUMBER option is to be used to set the tab order (see the WINDOW SET TABORDER command in the Language Reference).
See Also
FormNum, MenuNum, WNum
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) |
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
“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 |
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