Index   Commented   Search   About

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"pics/PENAPI00090001.gifits hotspot pics/PENAPI00090001.gifpoints 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.

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun