Index   Commented   Search   About

REC_ Recognition Functions

The REC_ constants specify return values from the GetPenHwEventData and GetPenHwData functions. They are also returned from the obsolete functions Recognize, RecognizeData, and ProcessWriting, and as the wParam value of the WM_RCRESULT message. Return values less than REC_DEBUG are provided for debugging purposes only and represent abnormal termination.

Constant
Description
REC_OK
This result message to be followed by other results before Recognize terminates. This is a valid wParam value for WM_RCRESULT, but it can never be the return value for Recognize.
REC_ABORT
Recognition stopped by a call to EndPenCollection with this value. The lpPnt data is not valid.
REC_BADHPENDATA
Returned if HPENDATA cannot be locked or has an invalid header. This value is also returned if HPENDATA has no data in it or if the data is in an incorrect scale or compressed.
REC_BUFFERTOOSMALL
Returned by GetPenHwEventData.
REC_BUSY
Returned if another task is currently performing recognition.
REC_DONE
Returned by RecognizeData upon normal completion.
REC_NA
Function not available.
REC_NOINPUT
Returned by RecognizeData if the buffer contains no data, or returned by Recognize if recognition ended before any data was collected. For example, a pen-down stroke may have occurred outside the bounding rectangle before any data was collected.
REC_NOTABLET
Tablet not physically present.
REC_OOM
Out-of-memory error.
REC_OVERFLOW
Data overflow during execution of the call.
REC_POINTEREVENT
Returned if the user makes contact with the tablet surface and lifts the pen before the pen tip travels a short distance. This value is also returned if the user does a press-and-hold action; that is, the pen makes contact with the tablet and remains in that position for a short period of time.
REC_POINTEREVENT informs the application it should begin selection actions rather than inking or recognition. If REC_POINTEREVENT is returned, no WM_RCRESULT message is generated and no ink is displayed.
REC_TERMBOUND
Recognition ended because of a hit test outside the bounding rectangle. The pntEnd member of RCRESULT is filled with the point causing the stop.
REC_TERMEX
Recognition ended because of a hit test inside the exclusion rectangle. The pntEnd member of RCRESULT is filled with the point causing the stop.
REC_TERMOEM
Values greater than or equal to 512 reserved for recognizer-specific termination reasons.
REC_TERMPENUP
Recognition ended on pen up. ThepntEnd member of RCRESULT is filled with the pen-up point that terminated recognition.
REC_TERMRANGE
Recognition ended because the pen left the proximity range.
REC_TERMTIMEOUT
Recognition ended on time-out. (The pen was up con-tinuously for a given amount of time.)

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