Field FormNum

A user-assigned numeric identifier for the form within a display.

Valid Values

An integer (0 to 999)

If no number is assigned, 0 is used.

Remarks

FormNum can be used in an application program to identify the form that had focus when control returned to the program. (See $FormNum, and $MouseFormNum in the Language Reference.)

See Also

FNum, MenuNum, WNum

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 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 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 WdgVMargin

Vertical margin of an object. The top and bottom margins of the object, expressed in twips.

Valid Values

A non-negative number (longint)

Remarks

Indicates the unusable space immediately below the top edge and immediately above the bottom edge of the rectangle occupied by the object.  For DisplayForms objects, this refers to the form object identified by the DisplayForms entry.

WdgVMargin is set to 0 if both VMargin (character rows) and WdgVMargin (twips) are $Null.

See Also

HMargin, VMargin, WdgHMargin

Field FSN

The form’s sequence number in a display. A user-assigned number that can be used to control the tabbing sequence within the forms of a display.

Valid Values

An integer (0 to 999).

Remarks

If FSN is set to 0, the software automatically resets it to match the Z-order (WdgZOrder) specified for the form.  Accordingly, if all forms in a display are painted with FSNs 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-class windows.)

See Also

FFSN, FormNum, WdgZOrder

Field WdgZOrder

Layer position of an object. When two objects overlap, WdgZOrder specifies the order in which they are “layered”. The object with the higher or highest number is on “top”.

Valid Values

An integer

Remarks

The Structure Chart of the Screen Painter displays the relative Z-order of all objects in the form or display.

The Z-order of an object can be changed by dragging the object from its current position in the structure to a new position and releasing it.

FObjects closer to the bottom of the Structure Chart are displayed on top of objects closer to the top of the Chart.

Field WdgTag

A user-defined symbol that identifies an object involved in a user interface event.

Valid Values

A character string, up to 18 characters long

Remarks

When a user interface event occurs, the WdgTag values for the objects involved are assigned to special system variables (Event.EventTag, Event.FieldTag, Event.MenuItemTag). This information identifies the objects involved in the event.  The application program can then translate events into the desired action.

WdgTag defaults to the name of the object.

Field DocName

The name assigned to a document.

Valid Values

An 18-character string, containing a valid object name

See Also

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

en_CAEnglish