Category: User Interface

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

Valid Values

WdgType = {30 where FT = “0”, 31 where FT = “1”,

A numeric value ranging from 1 to the maximum available widgets according to the table below:

The callback events an object can raise.

Valid Values

An integer code combining the following values:

Remarks

Only resizable windows can have menus.

Example: If the object has to raise a GotFocus event and a Click event, the WdgCallbacks would contain (2 + 64) = 66.

Provides extra information about the object being used.

Valid Values

A character string, up to 512 characters long either blank or in JSON format.

Remarks

The WdgCSS values for the objects involved present either a blank value or a free-format JSON syntax containing additional information about the object. This extra information may be Data Dictionary fields valid only to the particular object or implemented for future use.

Example

{"icon": "c:/images/zx.ico", "smallincrement":30}

ZIM:X allows JSON data format to be retrieved by the means of the $FindJSON function if the above value would be stored in FFs.WdgCSS:

LIST FFs FORMAT $FindJSON(WdgCSS, "smallincrement")
30

See Also

$FindJSON

The “appearance” of an object.

Valid Values

An integer code combining the following values:

Remarks

Only resizable windows can have menus.

Example: If the window has a caption, is resizable and has a close button, the value would be (1 + 2 + 16384) = 16387.

These numeric constants are in Zim’s data dictionary. They can be used instead of the number value to make your code more readable.

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:

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

Stores initial values for lists. The initial list of values for a combo box or list box are stored in WdgItems.

Valid Values

A 256-character string, containing a list of values separated by semicolons

Remarks

If the length of any item in the list exceed the field’s FieldLen, then that item is truncated.

Leading spaces are stripped from all items.

Example 1

Red;Green;Blue

Example 2

If the semicolon must be used as data, it should be preceded by the escape character ():

period (.);comma (,);semicolon (;)

See Also

FieldLen, FORM SET LIST (Language Reference)

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

For Windows

“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:

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

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:

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