#include "ltdoc2.h"
L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2CreateSettingsCollection(hDoc, nParentSid, pnNewSid)
L_HDOC2 hDoc; |
handle to the OCR document |
L_INT nParentSid; |
parent setting collection ID |
L_INT * pnNewSid; |
address of the variable to be updated |
Creates a new Settings Collection.
Parameter |
Description |
hDoc |
Handle to the OCR document. This handle is obtained by calling the L_Doc2StartUp function. |
nParentSid |
The parent setting collection. If it is -1 the new collection will contain the settings with their default values. If it is the ID of an already existing collection the values will be copied from it. |
pnNewSid |
Address of variable to be updated with new created setting collection ID. |
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
A Settings Collection is a container holding the values of all settings for all modules of the engine. Before calling any functions after starting up the engine, it is necessary to create a settings collection and activate it.
After creating a settings collection, activate it by calling the L_Doc2SetActiveSettingsCollection function. When the settings collection is no longer needed, delete it by calling the L_Doc2DeleteSettingsCollection function.
Required DLLs and Libraries
LTDOC2 For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Functions: |
L_Doc2StartUp, L_Doc2ShutDown, L_Doc2DeleteSettingsCollection, L_Doc2SetActiveSettingsCollection |
Topics: |
For an example, refer to L_Doc2StartUp.