Informs a recognizer that pen data input has been terminated. A recognizer
must export this function.
int EndPenInputHRC( HRC hrc )
Handle to the HRC
object for the recognizer.
Returns HRCR_OK if successful; otherwise, returns one of the following
||Invalid parameter or other error.
EndPenInputHRC does not instruct the recognizer to complete recognition; an application must
to do that. However, an application that does not use DoDefaultPenInput
must call EndPenInputHRC
when it detects that input has finished. (DoDefaultPenInput
The recognizer can terminate open-ended states and reduce ambiguity in
searches when it knows that no more ink will arrive. For example, the recognizer can
keep various options open for possible delayed strokes that can modify a
tells the recognizer that no more delayed strokes will arrive.
After calling EndPenInputHRC
for an HRC
, an application should cease adding pen input into the HRC
. Some recognizers, such as the Microsoft Handwriting Recognizer (GRECO.DLL),
do not accept late pen input. If the application calls AddPenInputHRC
after having called EndPenInputHRC
for the same HRC
, the Microsoft Handwriting Recognizer returns HRCR_ERROR.
Other recognizers may differ. With such recognizers, a client may continue to
add pen input without error into a recognition context, even after having
. However, doing so is not efficient. In the worst case, the recognizer may be
forced to reprocess all of the pen data from the beginning.
For an example of a normal termination sequence, see the code sample in GetSymbolsHRCRESULT
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages