Field WdgHMargin

Horizontal margin of an object. The left and right margins of the object, expressed in twips.

Valid Values

A number (longint)

Remarks

Indicates the width of the interior unusable space from the left and right edges of the rectangle occupied by the object.  For DisplayForms objects, this refers to the form object identified by the DisplayForms entry.

WdgHMargin is set to 0 if both HMargin (character columns) and WdgHMargin (twips) are $Null.

See Also

HMargin, VMargin, WdgVMargin

Field WdgWdth

The horizontal dimension (width) of the object, expressed in twips.

Valid Values

A non-negative number (longint)

Remarks

In Displays, indicates the overall width of the display.

In FormFields, indicates the visual width of the field.

In Forms, indicates the overall width of the form.

In Windows, indicates the width of the window, including its non-client area.

It is required when either Wdth (character rows) or WdgWdth (twips) must be specified.

See Also

WdgHght, Wdth

Field WdgNumVisibleLines

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

Field WdgHght

The vertical dimension (height) of the object, expressed in twips.

Valid Values

A number (longint)

Remarks

In Displays, indicates the overall height of the display.

In FormFields, indicates the visual height of the field.

In Forms, indicates the overall height of the form.

In Windows, indicates the height of the window, including its non-client area.

It is required when either Hght (character rows) or WdgHght (twips) must be specified

See Also

Hght

Field Fill

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

Field WdgLargeIncrement

A scroll bar increment. Specifies the amount of movement along the scroll bar when the scale on either side of the thumb is clicked.

Valid Values

A non-negative number (longint) (DEFAULT = 10)

Remarks

The usable scrolling range of a scroll bar is from -32,768 to 32,767. A WdgLargeIncrement outside this range will produce unpredictable results.

See Also

WdgMaxValue, WdgMinValue, WdgSmallIncrement

Field ObjectKey

A unique identifier assigned by the Development Center.

Valid Values

A 25-character string (DEFAULT = $Null)

Remarks

ObjectKey is a unique identifier assigned by the Zim Development Center if the Object Manager (ZOM) has been enabled. End-users should not modify its value. Refer to the Development Center documentation for more information.

ObjectKey has a defined ListWidth of -1 and is not normally displayed.

Field FormName

The name assigned to a form (Forms); or, the name of a form used in a display (DisplayForms); or, the form to which a particular form field belongs (FormFields).

Valid Values

An 18-character string, containing a valid object name

See Also

ConstName, DDObjectName, DDOwnerName, DirName, DisplayName, DocName, EntName, FieldName, MenuName, OwnerName, RelName, RoleName, SetName, UserName, VarName

Field FieldLen

Indicates the maximum length (in characters) of the form field’s data value.

Valid Values

An integer (1 to 32000)

Remarks

If the FieldLen exceeds the visual space available for displaying data in this form field (see Wdth, Hght, WdgWdth, and WdgHght), then the data can be scrolled through the visual space.

See Also

Hght, WdgHght, WdgWdth, Wdth

Field FFSN

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

pt_BRPortuguese