ImageGear for C and C++ on Windows v19.3 - Updated
IG_REC_UD_state_get
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > User Dictionary Functions > IG_REC_UD_state_get

Inquires information about any type of change in the User dictionary, like adding or deleting UDitems.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_UD_state_get(
   LPAT_BOOL pChanged
);

Arguments:

Name Type Description
pChanged LPAT_BOOL Address of a variable to get the modified flag.

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;
BOOL bStateChanged = FALSE;

ErrCount += IG_REC_UD_set(NULL, NULL);
ErrCount += IG_REC_UD_edit_open();

ErrCount += IG_REC_UD_item_add("Section_B", L"New_Item", 0);
ErrCount += IG_REC_UD_state_get(&bStateChanged);

ErrCount += IG_REC_UD_edit_close();

Remarks:

If the returned pChanged value is TRUE, then the User dictionary has been modified since the last IG_REC_UD_save saving action or since opening the dictionary with the IG_REC_UD_edit_open call.