Дескриптор HRECOCONTEXT
Дескриптор HRECOCONTEXT используется для добавления рукописного ввода в контекст, выполнения распознавания рукописного ввода (синхронно или асинхронно), получения результата распознавания и получения альтернативных вариантов.
Основной причиной наличия дескрипторов контекста распознавателя является различие между входными данными рукописного ввода. Например, можно создать приложение с двумя окнами, при этом пользователь сможет рукописным вводом в любом из окон. Вы не хотите, чтобы рукописные фрагменты первого окна смешивались с рукописным фрагментом второго окна, когда вы просите распознать рукописный ввод одного из окон. В этом приложении создается два контекста распознавателя (по одному для каждого окна) и добавляются штрихи, поступающие в окно 1, в контекст распознавателя 1 и штрихи из окна 2 в контекст распознавателя 2. Чтобы вернуть результаты распознавания, вызовите процесс в контексте распознавателя 1 или контексте распознавателя 2 в зависимости от того, нужны ли результаты для окна 1 или 2.
Дескриптор контекста распознавателя может быть любым. Но обычно это индекс в глобальном массиве структур. Структуры могут содержать все введенные штрихи и все переменные, которые распознаватель использует для конкретного фрагмента рукописного ввода (например, внутренняя структура решетки или текущее состояние распознавания). Одна структура может содержать все сведения, необходимые распознавателям для определенного фрагмента рукописного ввода.
Чтобы получить дескриптор HRECOCONTEXT , вызовите функцию CreateContext .
typedef HANDLE HRECOCONTEXT;
Комментарии
Ниже приведены функции HRECOCONTEXT .
| Функция | Описание |
|---|---|
| AddStroke | Добавляет росчерк рукописного ввода в контекст распознавателя. |
| AdviseInkChange | Не позволяет распознавательу обрабатывать рукописный ввод, так как добавляется или удаляется новый росчерк. |
| CloneContext | Создает контекст распознавателя, содержащий те же параметры, что и исходный. Новый контекст распознавателя не включает результаты рукописного ввода или распознавания исходного. |
| EndInkInput | Указывает, что больше рукописный ввод не будет добавлен в контекст. |
| GetAlternateList | Возвращает список вариантов для лучшей строки результата. |
| GetBestAlternate | Возвращает указатель HRECOALT Handle для оптимального альтернативного результата. |
| GetBestResultString | Возвращает наилучшую строку результата. |
| GetContextPropertyList | Возвращает список свойств, поддерживаемых распознавателями. |
| GetContextPropertyValue | Возвращает указанное значение свойства из контекста распознавателя. |
| GetEnabledUnicodeRanges | Возвращает список диапазонов точек Юникода, включенных в контексте. |
| GetGuide | Возвращает направляющую, используемую для ввода в комплекте или с линией. |
| GetLatticePtr | Возвращает указатель на решетку для текущих результатов. |
| IsStringSupported | Возвращает значение, указывающее, содержится ли в словаре слово, дата, время, число или другой передаваемый текст. |
| Процесс | Выполняет синхронное распознавание рукописного ввода. |
| ResetContext | Удаляет текущий рукописный ввод и результаты распознавания из контекста. |
| SetCACMode | Задает режим автозаполнения символов для распознавания символов или слов. |
| SetContextPropertyValue | Добавляет свойство в контекст распознавателя. Если свойство уже существует, его значение изменяется. |
| SetEnabledUnicodeRanges | Включает один или несколько диапазонов точек Юникода в контексте. |
| SetFactoid | Задает фактоид, который распознаватель использует для ограничения поиска результата. |
| SetFlags | Задает, как распознаватель интерпретирует рукописный ввод и определяет результирующий текст. |
| SetGuide | Задает руководство, используемое для ввода в упаковавку или с линией. |
| SetTextContext | Предоставляет текстовые строки, которые до и после текста, содержащегося в контексте распознавателя. Для распознавателей восточноазиатских символов функция SetTextContext предоставляет символы, а не текстовые строки. |
| SetWordList | Задает список слов для распознаваемого контекста текущего распознавателя. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|