Cicode Programming Reference > Cicode Function Categories > Form Functions Introduction > FormGetInst

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:

String data.

Return Value

The data (as a string).

Related Functions

FormSetInst, FormCurr, FormGetCurrInst

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