FormFields

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.

Establishing a Form Field or Menu Item

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".

Warning

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.

Fields of the FormFields Entity Set

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