Copyright © Cloud Software Group, Inc. All Rights Reserved

openform_set_recalc()

Enable or disable recalculation of calculated fields and conditional text after an openform_set_field_value() call.

Synopsis

C/C++

long int openform_set_recalc (long int openform_id, long int sal_formsh, long int recalc_on)

VB

Function openform_set_recalc (openform_id As Long, sal_formsh As Long, recalc_on As Long,) As Long

where:

•	openform_id is the identifier of the Open Forms SDK Interface Function module, as returned by openform_initialise().

•	sal_formsh is the SAL form session handle that identifies the work item, as passed to your Open Form application by the calling script. See Creating the Script to Call the Open Forms Application.

•	recalc_on should be 0 (zero) to disable recalculation, or any non-zero value to enable recalculation.

Description

By default, after an openform_set_field_value() call the SAL recalculates any calculated fields and conditional text in the iProcess Form definition for the step.

Calling openform_set_recalc():

•	Switches this recalculation behavior on or off. This can provide improvements in set value performance when the iProcess Form also contains data behind your Open Forms application.

•	Forces the iProcess Form window to update itself using the recalculated data if recalc_on is non-zero.

Returns

One of the following numeric values:

Value	Description
1	Success.
0	Invalid openform_id.
-1	Invalid sal_formsh.
-2	Unexpected error.
-4	np_sal_frm_setlong interface function() not available.

Copyright © Cloud Software Group, Inc. All Rights Reserved