<< Click to Display Table of Contents >> Navigation:  OCR Module > Low-Level Functions > OCRp_GetSymbolFromRegion

---

 

OCRp_GetSymbolFromRegion

 

---

 

OCRp_GetSymbolFromRegion returns the requested symbol from the output region. Please note that all elements are case-sensitive:

 

HRESULT OCRp_GetRegionFromRegion(

PXO_Region RegionResults,

DWORD nSymbol,

OCR_SymbolBox *pSymbolBox

);

 

Parameters

 

RegionResults

Specifies the PXO_Region structure that contains the results from which to retrieve the symbol.

 

nSymbol

This parameter is a zero-based index that specifies the symbol number to retrieve. The maximum value is one integer less than the region count that OCRp_SymbolCountFromRegion returns.

 

pSymbolBox

This parameter is a pointer an OCR_SymbolBox variable that will contain the new region results.

 

Please note that symbols are copied into the variable that the pSymbolBox pointer specifies. A call to OCRp_FreePage does not delete their data.

 

Return Values

 

If the function succeeds then the return value is DS_OK.

 

If the function fails then the return value is an error code.

 

---