|
ProcessHRC
- 0
Gives a recognizer sufficient time for intermediate processing of pen input. A
recognizer must export this function.
int ProcessHRC( HRC hrc, DWORD dwTimeMax )
Parameters
hrc
Handle to the HRC object for the recognizer.
dwTimeMax
The maximum time in milliseconds that the recognizer should process before
returning from this call. This parameter can also be one of the following time-out
codes:
Constant
| Description
| PH_MIN
| The recognizer should take only a very small amount of time to process the
input, typically 50 milliseconds.
| PH_DEFAULT
| The recognizer should take a moderate amount of time to process the input,
typically 200 milliseconds.
| PH_MAX
| The recognizer should take as much time as required to complete recognition.
|
Return Value
If there are no errors, returns one of the following values:
Constant
| Description
| HRCR_OK
| Processing is successful.
| HRCR_INCOMPLETE
| The recognizer is still processing the current batch of input.
| HRCR_GESTURE
| The recognizer has recognized a possible gesture.
This can be returned before the recognition process
is complete. If the processing completes, HRCR_COMPLETE is always returned,
even for gestures.
| HRCR_COMPLETE
| The recognizer completed processing and does not expect any more input.
|
To indicate an error, ProcessHRC returns one of the following negative values:
Constant
| Description
| HRCR_ERROR
| Invalid parameter or other error.
| HRCR_MEMERR
| Insufficient memory.
|
Comments
ProcessHRC returns if the time specified by dwTimeMax elapses before recognition is complete.
In an operating environment that does not use threads, this function allows an
application to provide some time for the recognizer to process input. By
checking the return value, the application is able to monitor the progress,
specifically whether a gesture is a recognition candidate. If the function returns
HRCR_GESTURE, the application can call GetResultsHRC to determine whether the gesture should be acted on immediately.
Typically, the return value is HRCR_OK if the current batch of ink input has
been processed by the recognizer, and HRCR_INCOMPLETE if the recognizer has not
yet finished processing.
If ProcessHRC is called with PH_MAX, recognition is complete only if EndPenInputHRC has been called to notify the recognizer that no more results are expected.
The return value in this case is HRCR_COMPLETE, and the application is free to
get and display final results. If the application supplies further input at this
point, it has the effect of canceling the EndPenInputHRC call, although this procedure is not recommended for reasons of efficiency.
However, PH_MAX may result in poorer performance, since further processing in
the system is blocked until ProcessHRC returns. Instead, the application can call ProcessHRC in an idle loop or a separate thread, calling it repeatedly with smaller time
allotments until the function returns HRCR_COMPLETE. Note that if a separate
thread is used to finish processing, the main thread can call this function with
PH_MIN from time to time to determine if processing has finished (that is,
checking for the HRCR_COMPLETE return value).
The first time that ProcessHRC is called for a particular recognition context, functions that set its state
cannot be used for the remainder of that context's existence. The following
functions return an error if they are called before ProcessHRC returns HRCR_COMPLETE:
See Also
EndPenInputHRC, GetResultsHRC
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
