ReplaceFormDefScannerSettings() As Integer

Application object (Manager)

Replaces the scanner settings of the current form definition with the scanner settings that are currently specified in the Manager. This can be useful when you switch scanners or when you import form definitions to a new version of FORMS.

See example.

Scenario

New scanner functionality is usually controlled by INI file settings before being added to the FORMS GUI. After the new functionality is added to the GUI, the INI file settings no longer have any effect, and default settings in the new GUI take effect when you import form definitions to the new version of FORMS. Problems occur when the default setting in the new GUI is different from the setting previously taken from the INI file.

The best way to remedy this problem is by using Edit ð Replace image in FORMS. However, the procedure is time-consuming when there are many form definitions to be changed, and in such cases ReplaceFormDefScannerSettings can be useful.

Return value

Returns 0 if the operation is successful or – 1 if no form definition is selected.

Warning
Only for advanced users. This method is very risky. Changes that affect the image quality can ruin identification and/or interpretation. Not all scanner settings can be changed using this method. Some settings that can be changed should not be changed using this method. Never use this method to change DPI or paper size. Never use this method to convert a one-sided form definition to a two-sided one, or vise versa. Use extreme care when you use this method, and always test the affected form definition before going into production. Recommended alternative s : Select Edit ð Replace image in FORMS ReScanFormDef

Warning

Only for advanced users. This method is very risky.

Changes that affect the image quality can ruin identification and/or interpretation.
Not all scanner settings can be changed using this method.
Some settings that can be changed should not be changed using this method. Never use this method to change DPI or paper size. Never use this method to convert a one-sided form definition to a two-sided one, or vise versa.

Use extreme care when you use this method, and always test the affected form definition before going into production.

Recommended alternative s :

Select Edit ð Replace image in FORMS
ReScanFormDef

Example

Example of another way of doing the same thing, using SaveScannerSettings

Methods for the Application object for use with the Manager