FormGetInst

Extracts the data associated with a field (set by the FormSetInst() function). You would normally use this function in a field callback function. It allows single callback functions to know that the form and field are associated.

Syntax

FormGetInst(hForm, hField, iData, sData)

hForm:

The form handle, returned from the FormNew() function. The form handle identifies the table where all data on the associated form is stored.

hField:

The field handle of the field currently selected.

iData:

Integer data.

sData:

Variable containing string data.

Return Value

The data (as a string).

Related Functions

FormSetInst, FormCurr, FormGetCurrInst, FormNew

Example

INT
FUNCTION GetNextRec()

INT hDev,hForm,hField;
STRING Str;
! Get field data, for example, the hDev value.
..
FormCurr(hForm,hField);
FormGetInst(hForm,hField,hDev,Str);
DevNext(hDev);
! Display new record in form.
..
RETURN 0;

END

See Also

Form Functions