Edit

HRECOGNIZER and HRECOCONTEXT

  • Article

You reference an ink recognizer with an HRECOGNIZER handle and a recognizer context as an HRECOCONTEXT handle.

A recognizer dynamic-link library (DLL) can implement recognizers for more than one language. If so, each language is selected by a CLSID that is passed in when creating the IInkRecognizer object in the application. In addition, a recognizer DLL can create multiple recognizer handles when it is loaded, one or more for each language recognized.

A recognizer context is created to represent the event of recognizing a specific piece of ink. When the context is created, the associated recognizer objects handle is passed to the CreateContext function. This associates the language with the recognizer context.

A recognizer context may represent the recognition of all the ink in the body of an email, the ink of a single field within an application, or a single line of text written in the Tablet PC Input Panel. The volume of ink in a single recognizer context may vary from a single stroke to a whole page or more.

The recognizer context is defined by the settings of:

  • The recognition guide.
  • Any factoids.
  • Any flags.
  • The text context.
  • Any word list.
  • The character Autocomplete mode.

The handle for the recognizer context is passed to all functions that use these settings. Changing a setting changes the recognizer context.

The application may use several contexts to recognize ink from different parts of the screen. An individual context can recognize multiple lines of text. However, an individual context cannot process two paragraphs written side by side, such as multiple columns in a newspaper article.

To recognize new ink, create a new context. As an alternative, use the CloneContext function to make a copy of a context that does not have the ink and results, or the ResetContext function to clear a context of its ink and results. With these approaches, an ink application can reuse a context.

SetGuide Function

GetGuide Function

SetFactoid Function

SetFlags Function

SetEnabledUnicodeRanges Function

GetEnabledUnicodeRanges Function

SetCACMode Function

SetTextContext Function

SetWordList Function