Defines form field and menu item objects.
A form field or a menu item is a user interface object representing one unit of the associated interface object (form or menu).
The FormFields entity set describes the appearance and behavior of individual form fields and menu items. The Forms and Menus entity sets describe the forms and menus themselves.
The following description refers only to form fields; however, all information under "FormFields" refers both to form fields and to menu items.
Many of the form field attributes defined in the FormFields entity set can be altered dynamically while the associated interface object is in use. See the FORM SET, MENU SET, and WINDOW SET commands in your Language Reference for details.
For the procedure to be used in establishing a form field, see "Forms", and for the procedure to be used in establishing a menu item, see "Menus".
Data entered directly into the FormFields entity set is not validated by the software. Erroneous information in the entity set could cause unexpected behavior or more serious problems. To avoid such a situation, it is strongly recommended that the Screen Painter be used to define all user interface objects. In situations where it is more convenient to make global changes to application objects, you may wish to use the CHANGE command. If you choose this method, exercise extreme care to avoid entering invalid data.
|
Attributes |
Description |
|
FormName |
Name of the form (menu) that contains the form field (menu item) |
|
FieldName |
Name of the form field |
|
FNum |
Identification number of the form field |
|
FFSN |
Tabbing sequence number of the form field |
|
Row, Col |
Position of the form field in the form (characters) |
|
Wdth, Hght |
Size of the form field (characters) |
|
FieldLen |
Logical size of the form (maximum data length of the value) |
|
FT |
Class ("type") of form field |
|
DT |
Data type of the value in the form field |
|
PM |
"Protection mode" of the form field |
|
DM |
Display mode of the form field |
|
BC |
Fill (background) color of the form field (pre-defined) |
|
FC |
Pen (foreground) color of the form field (pre-defined) |
|
IT |
Whether form field responds to Lost Focus or Lost Focus Modified events with a callback ("transmit-on-exit" status) |
|
TE |
Whether form field responds to Got Focus events with a callback ("transmit-on-enter" status) |
|
VR |
"Required" status of the form field |
|
SK |
"Autoskip" status of the form field |
|
AC |
"Autoclear" status of the form field |
|
Case |
Case of the characters in the form field's data value |
|
Just |
Justification of the data value in the physical form field |
|
Fill |
Fill character for blank spaces in the physical form field |
|
MinLen |
Minimum length for the value in the form field |
|
AN |
"Allow nulls" status of the form field |
|
CM |
Data"compress" status of a masked form field |
|
VA |
Whether abbreviations are valid in the form field |
|
DataMask |
Mask for displaying the data value in the form field |
|
Default |
Default value of the form field |
|
ValRule |
Validation rule for the value in the form field |
|
HelpMsg |
Help message associated with the form field |
|
ErrorMsg |
Error message associated with the form field |
|
DirName |
Application directory location of field |
|
WdgTag |
Alphanumeric identifier for the form field |
|
WdgID |
Unique identification of the form field |
|
WdgParID |
The unique identification of the parent of this form field |
|
WdgSubClass |
Subclass of form field |
|
WdgStyle |
Style of the form field |
|
WdgRow, WdgCol |
Position of the form field in the form (twips) |
|
WdgWdth, WdgHght |
Size of the form field (twips) |
|
WdgOrientation |
Orientation of the form field |
|
WdgBCRed, WdgBCGreen, WdgBCBlue |
Custom fill (background) color of the form field |
|
WdgFCRed, WdgFCGreen, WdgFCBlue |
Custom pen (foreground) color of the form field |
|
WdgBackground |
An image to be displayed in the background of the form field |
|
WdgBorderStyle |
The type of border the form field has |
|
WdgShadowSize |
The size of the form field's shadow |
|
WdgLabel, WdgLabelPosition |
Label contents and position for the form field |
|
WdgOnImage, WdgOffImage, WdgNullImage |
The image to be used for each of the states of a toggle form field, or for the appearance of an image push button |
|
WdgFont, WdgFontSize |
The font and point size to be used when displaying the value and label of the form field (other font attributes, such as italics, are specified in DM) |
|
WdgPointerStyle |
The appearance of the pointer when positioned over this form field |
|
WdgMultiLine |
Whether a text-entry form field contains multiple lines |
|
WdgAutoSize |
"Autosize" status of the form field |
|
WdgDragIcon |
The icon that represents the form field in a drag operation |
|
WdgOnValue, WdgOffValue, WdgNullValue |
Value of a toggle form field when in its various states |
|
WdgMaxValue, WdgMinValue |
Upper and lower boundaries of a scroll bar form field |
|
WdgLargeIncrement, WdgSmallIncrement |
"Large" and "small" increments for scrolling in a scroll bar form field |
|
WdgZOrder |
"Layer" in which the form field resides |
|
WdgTabStop |
Whether the end-user can navigate to the form field using the keyboard Tab key |
|
WdgAutoSelect |
"Autoselect" status of a form field |
|
WdgScrollBars |
Whether the form field has attached scroll bars |
|
WdgEditOptions |
Editing options in effect for this combo box |
|
WdgNumVisibleLines, WdgNumVisibleCols |
The visible size of a list box when open |
|
WdgIsDefault |
Whether this form field is the default in a group |
|
WdgDragMode |
Whether the form field can be dragged |
|
WdgDropTarget |
Whether the form field can be the target of a drag operation |
|
WdgModified |
Whether form field responds to Modified events with a callback ("transmit-on-modified" status) |
|
WdgClick |
Whether form field responds to Click events with a callback |
|
WdgDblClick |
Whether form field responds to DoubleClick events with a callback |
|
WdgAutoDrop |
Whether this list box form field drops automatically when it gets focus via the keyboard |
|
HMargin, VMargin |
Interior margins of the form field (characters) |
|
WdgHMargin, WdgVMargin |
Interior margins of the form field (twips) |
|
WdgInputMask |
Mask for accepting input into the form field |
|
WdgItems |
Initial values for a list box |
|
ObjectKey |
A unique identifier assigned by the Development Center |