Setting Context with the SetInputScope APIs

Setting Context with the SetInputScope APIs

Description of how to use the SetInputScope APIs within your application.

The Context Tagging tool provides an option for applications that have already been released. The recommended programmatic technique for setting contexts in an application that is not ink-enabled is to use the SetInputScope APIs to associate context with the fields in the application.

The Microsoft® Windows® XP Tablet PC Edition Development Kit 1.7 is the first version of Microsoft® Windows® to offer the SetInputScope APIs. Future updates to other versions of Microsoft Windows will also provide support for these APIs. The header files containing definitions for these APIs are not currently available in an SDK. You must create them manually based on the information provided in the syntax blocks in the reference topics for the APIs. For more details about using the SetInputScope APIs, see SetInputScope API Reference.

The SetInputScope APIs are the recommended way to set context for controls and applications that are not ink-enabled.

Common Input Scopes

Using the SetInputScope APIs and the defined set of common input scopes described in the InputScope enumeration, you can improve the recognition accuracy of the Microsoft handwriting recognizers.

Note: The following recognizers currently support using the common input scopes with the SetInputScope API:
  • English (United States)
  • English (United Kingdom)
  • German
  • French
Microsoft is evaluating whether support for the common input scopes for recognizers of East Asian languages is to be released in a future version of Windows XP Tablet PC Edition.