?name s_fieldName

Handle to this field within a form. To reference it, use:

formHandle->hiFieldSym

?prompt t_fieldPrompt

String specifying the prompt for the field. To reference it, use:

formHandle->hiFieldSym->prompt

?value x_currentValue

Initial and current value of this field. To reference it, use:

formHandle->hiFieldSym->value

?acceptNil g_acceptNil

Accepts nil as a value. If there is no value entered for the field on the form, results in the SKILL value being set to nil. Setting a field value to nil using the CIW results in the field on the form to be blank.

?help g_fieldHelp

A string or symbol used to reference help. If not specified, s_fieldName is used. This argument is currently not used.

?defValue x_defaultValue

Default value of the field. This value is equal to the initial entry in currentValue if defaultValue is not specified. To reference the default value, use:

formHandle->hiFieldSym->defValue

?font t_font

A font argument is accepted but not supported at this time.

?callback g_callback

Callback of string, symbol, or function object type that is executed whent the value of a field changes. The callback is called when the field has lost focus (when the cursor leaves the form, the user tabs to another field, and so forth) or the user selects any button in the form.

If the callback is of string type, you can specify one or more SKILL functions or even multiple SKILL statements that should be executed when the value of the field changes.

?modifyCallback g_modifyCallback

Do not use the g_modifyCallback argument with this field because it may not work as expected. Use this argument only with string fields.

SKILL function to be executed whenever any change is made in the text field, for example, by typing or pasting. The modify callback is called when a change is detected in the field but before the change is displayed.

The modify callback function is passed the following arguments:

s_fieldName t_latestTextValue g_sourceOfChange

where s_fieldName is the symbol of the field in which the change was made, t_latestTextValue is the latest text value of the field, and g_sourceOfChange is t or nil where t indicates that the change was made programmatically (by changing the value of the field) and nil indicates that the change was made by a user action.

The modify callback function should return the following:

t | nil | value

If the modify callback function returns t, the changes made to the field are allowed and are displayed as they are entered. If the function returns nil, the changes made to the field are not allowed and are not displayed—the original value of the field is retained. If the function returns some other value, it must be an integer. This value replaces the current value of the field.

?focusInCallback g_focusInCallback

SKILL function to be run whenever the field comes into focus. You provide this function.

?format t_fieldFormat

String that can control the display of the value on the form. It is similar to printf.

Acceptable format characters are those allowed by the C programming language.

?range l_fieldRange

A list containing the minimum and maximum integer values. For example, the list (0 10), also specified as 0:10, represents the range of integers from 0-10 inclusive. To specify an unbounded upper range, use either nil or the string "infinity" as the second value. To specify an unbounded lower range, use either nil or the string "-infinity" as the first value.

?editable g_editable

Enables the field for editing.

?enabled g_enabled

Specifies whether the fields in the layout are enabled. The default value is t.

?invisible g_invisible

Specifies whether the layout and the fields within are invisible. The default value is nil.

?nextField g_nextField

Symbol or string indicating the next field to bring into focus when the Tab key is pressed. If you specify nil or do not specify this argument, the Tab traversal order is determined by the tabOrderIsAddOrder argument of hiCreateAppForm or hiCreateScrollRegion. If the tabOrderIsAddOrder argument is not set or if its value is nil, the default traversal order is based on the form layout —left-to-right and top-to-bottom— beginning with the field at the top-left corner of the form.

r_fieldHandle

Handle to the integer field.