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
Drag status of a form field. Indicates whether the associated form field can be dragged.
Valid Values
An integer code, as shown in the table below:
Code | Meaning |
0 | No |
1 | Manual |
2 | Automatic (DEFAULT) |
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
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 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
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
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 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
The number of lines visible in a list box or combo box, or the number of visible lines in a multi-line entry field.
Valid Values
A non-negative integer
Remarks
In a list box or in the list portion of a combo box, indicates how may items are visible at one time.
In a multi-line entry field, indicates how many lines of text are visible at one time.
If WdgNumVisibleLines is 2 or greater, WdgMultiLine must be set to 1.
See Also
WdgItems, WdgMultiLine
A character that is to be used to “fill” blank positions in a (text) form field or the client area of a window when it contains no form or display.
Valid Values
Any single character. If no character is specified, the space character is used.
Remarks
The fill character is not data; it simply delineates the dimensions of a blank or partially-blank object on the screen.
In a field, the fill starts to the right of the last non-blank character (alphanumeric fields), or to the left of any number (numeric fields).
Portuguese 
English