IG_REC_UD

Is used to save the User dictionary to a file.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_UD_save( LPCSTR pFilename );

Arguments:

Name	Type	Description
pFilename	LPCSTR	Pointer to the name of the User dictionary file. If it is NULL, the current dictionary name will be used as set by a previous call to the IG_REC_UD_set function.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

	Copy Code
AT_ERRCOUNT ErrCount = 0; ErrCount += IG_REC_UD_set("NEW_USER.DICT", "Section_A"); ErrCount += IG_REC_UD_edit_open(); ErrCount += IG_REC_UD_item_add("Section_B", L"[A-Z]", IG_REC_UD_ITEM_ATTR_REGULAR_EXPRESSION); ErrCount += IG_REC_UD_item_delete("Section_B", L"[A-Z]", IG_REC_UD_ITEM_ATTR_REGULAR_EXPRESSION); ErrCount += IG_REC_UD_save("NEW_USER2.DICT"); ErrCount += IG_REC_UD_edit_close();

Copy Code

AT_ERRCOUNT ErrCount = 0;
ErrCount += IG_REC_UD_set("NEW_USER.DICT", "Section_A");
ErrCount += IG_REC_UD_edit_open();

ErrCount += IG_REC_UD_item_add("Section_B", L"[A-Z]", IG_REC_UD_ITEM_ATTR_REGULAR_EXPRESSION);
ErrCount += IG_REC_UD_item_delete("Section_B", L"[A-Z]", IG_REC_UD_ITEM_ATTR_REGULAR_EXPRESSION);

ErrCount += IG_REC_UD_save("NEW_USER2.DICT");
ErrCount += IG_REC_UD_edit_close();

Remarks:

If the current dictionary was created by the IG_REC_UD_set function called with parameter NULL, the pFilename parameter should specify a real filename, otherwise this function returns with IGE_REC_EXTENDED_ERROR/IGE_REC_EXT_SPL_FOPEN_ERR.
Saving the User dictionary under a different file name does not specify the User dictionary setting automatically. For this a separate IG_REC_UD_set call is necessary.