GetHotspotsHRCRESULT
2.0
Retrieves the
hot spots for a particular symbol.
int GetHotspotsHRCRESULT( HRCRESULT hrcresult,
UINT iSyv, LPPOINT lppt, UINT cPnts )
Parameters
hrcresult
Handle of a
results object.
iSyv
Index of the
symbol in the results object.
lppt
Address of an
array of up to MAXHOTSPOT POINT structures.
cPnts
Actual size
of lppt array in points.
Return Value
If
successful, returns the count of hot spots; otherwise, returns one of the
following negative values:
|
Constant |
Description |
|
HRCR_ERROR |
Invalid
parameter or other error. |
|
HRCR_MEMERR |
Insufficient
memory. |
|
HRCR_UNSUPPORTED |
The
recognizer does not support this function. |
Comments
Any symbol
can have hot spots, but they are usually of interest only for gestures. For
example, if the user writes X for deletion, the center of the X its hotspot points to the item to be deleted. Hot spots are returned in tablet
coordinates. The maximum number of hot spots allowed is provided in the
PENWIN.H constant MAXHOTSPOT. The Microsoft Handwriting Recognizer (GRECO.DLL),
supports this function for gesture symbols only.
If cPnts
is smaller than the actual number of hot spots, only cPnts points are
reported.