Field WdgEditOptions

Indicates the special editing options applicable to this combo box.

Valid Values

An integer code, as shown in the table below:

Code

Meaning

0

Default (normal operation)

1

Track prefix (in Combo-box form fields, automatically select the list item that matches the value entered)

2

Mandatory match (in Combo-box form fields, the value in the combo box must match an entry in the associated list)

3

Both Track and Mandatory

4

Autocomplete (If the end-user types a valid prefix of an item in the list, that list item is selected, and the remaining typing is completed automatically)

5

Both Track prefix and Autocomplete

6

Both Mandatory match and Autocomplete

7

All of Track prefix, Mandatory match, and Autocomplete

 

Field WdgLabelPosition

The position of the label for this form field. The location of the label varies with the class and subclass of the form field (e.g., a push button’s label appears on the button); the label’s position within the assigned location is set by this attribute.

Valid Values

An integer code, as shown in the table below:

Code

Meaning

1

Top

2

Top right

3

Right

4

Bottom right

5

Bottom

6

Bottom left

7

Left

8

Top left

9

Centered

 

Field DM

The “display mode” of an object. Indicates the display attributes to be used for an object.

Valid Values

A 6-character string, containing one or more codes as shown in the table below:

Code

Meaning

N

Normal intensity

I

Invisible

R

Reverse video

S

Suppress data

H

High intensity

L

Italic

U

Underlined

T

Strikethrough

B

Blink

X

Inherit font attributes

Remarks

Meaningful combinations of display attributes are acceptable. Your terminal may not accept certain combinations.

The attributes S, L, and T are not applicable to windows.

See Also

WdgFont, WdgFontSize

Field WdgScrollBars

Indicates whether a form field or a window has attached scroll bars.

Valid Values

An integer code, as shown in the tables that follow.

For FormFields

Code

Meaning

0

None (DEFAULT)

1

Horizontal

2

Vertical

3

Both

For Windows

Code

Meaning

1

Yes (the window can have scroll bars) (DEFAULT)

2

No (the window may not have scroll bars)

Field VR

“Value required” status of a form field. Indicates whether a value is required in this form field.

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

I

Immediate. This form field must be completed before focus can move elsewhere in the form

N

No. This form field need not be completed before control can return to the application program

Y

Yes. This form field must be completed before control can return to the application program on callback or scrolling events; on other events, control returns, but an incomplete required field is noted in Event system variables

Remarks

If the VR of a form field is I, and an accelerator key is pressed before the form field is assigned a valid value, an error message appears and focus returns to the form field.

If a form field has an IT setting of A and a VR setting of I, the VR setting takes precedence: the form field must be assigned a value before an event can cause a callback to the application program.

See Also

ValRule, VA

 

Field IT

Indicates how the form field responds to a LostFocus event (“transmit-on-exit” status).

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

N

(DEFAULT) No response

Y

Control returns to the application program if the form field was modified between the GotFocus and LostFocus events (LostFocusModified)

A

Control always returns to the application program on a LostFocus event

X

Control returns to the application program both on a LostFocusModified and a LostFocus event. (LostFocusModified takes precedence.)

Remarks

The value in the form field must meet the associated validation rule and minimum length requirement before control can revert to the application program on a LostFocus event.

See Also

MinLen, ValRule

Field FT

A code indicating the “class” (field type) of the associated form field.

Valid Values

A code stored as a single character value, as shown in the table below:

CodeMeaning
ATabPage
BPushButton
CComboBox
DDivider
EOLE Object
FFrame
GGraphic
HCamera
IPicture
JCalendar
KSignature
LListBox
MMenu Item
NTabControl
OOptionBox
PLabel
QListView
RGridControl
SScrollBar
TToggleButton
UUserMessage
VEntryField
WTreeView
XTreeView Node
YBarCode
ZProgressBar

Field PM

Indicates whether the form field is available to the end-user.

Valid Values

A 1-character code, as shown in the table below:

Code

Meaning

U

Unprotected (the form field is available)

G

Guarded (the form field is not available, but it can have focus)

P

Protected (the form field is not available and cannot have focus)

V

Unavailable (the form field is not available, cannot have focus, and has a “disabled” appearance–typically grayed)

Remarks

Form fields of the “label” and “graphic” classes are always protected; other form field classes may be unprotected, guarded, protected, or unavailable.

For a description of how availability is inherited, consult the User’s Guide.

See Also

FT

Field WdgParID

The identification number for the form field’s parent object.

Valid Values

A number (longint) (DEFAULT =  0)

Remarks

If WdgParID is 0, the form field’s parent is considered to be the form to which it belongs.

If WdgParID is non-zero, its parent is another form field in the form.

See Also

WdgID

pt_BRPortuguese