Прочитать на английском

Поделиться через


Класс InkRecognizerContext

Позволяет выполнять распознавание рукописного ввода, получать результат распознавания и получать альтернативные варианты. InkRecognizerContext позволяет различным распознавателям, установленным в системе, использовать распознавание рукописного ввода для соответствующей обработки входных данных.

InkRecognizerContext имеет следующие типы элементов:

События

Класс InkRecognizerContext содержит эти события.

Событие Описание
Распознавание Происходит, когда InkRecognizerContext создает результаты из метода BackgroundRecognize.
RecognitionWithAlternates Происходит, когда InkRecognizerContext создает результаты после вызова метода BackgroundRecognizeWithAlternates .

Интерфейсы

Класс InkRecognizerContext определяет эти интерфейсы.

Интерфейс Описание
IInkRecognizerContext Этот объект реализует COM-интерфейс IInkRecognizerContext .

Методы

Класс InkRecognizerContext содержит следующие методы.

Метод Описание
BackgroundRecognize Указывает, что распознаватель должен распознавать связанные штрихи и запускать событие Распознавания после завершения распознавания.
BackgroundRecognizeWithAlternates Указывает, что распознаватель должен распознавать связанные штрихи и запускать событие RecognitionWithAlternates после завершения распознавания.
Clone Создает дубликат InkRecognizerContext.
EndInkInput Завершает ввод рукописного ввода в InkRecognizerContext.
IsStringSupported Указывает, содержит ли системный словарь, пользовательский словарь или список слов указанную строку.
Recognize Выполняет распознавание в коллекции InkStrokes и возвращает результаты распознавания.
StopBackgroundRecognition Завершает распознавание фона, запущенное вызовом BackgroundRecognize или BackgroundRecognizeWithAlternates.

Свойства

Класс InkRecognizerContext имеет эти свойства.

Свойство Тип доступа Описание
CharacterAutoCompletion
Чтение/запись
Возвращает или задает режим автозаполнения символов, который определяет, когда распознаются символы или слова.
Фактоид
Чтение/запись
Возвращает или задает строковое имя factoid, используемого объектом InkRecognizerContext .
Руководство
Чтение/запись
Возвращает или задает inkRecognizerGuide , используемый для ввода рукописного ввода.
ПрефиксText
Чтение/запись
Возвращает или задает символы перед коллекцией InkStrokes в объекте InkRecognizerContext .
RecognitionFlags
Чтение/запись
Возвращает или задает флаги, указывающие, как распознаватель интерпретирует рукописный ввод и определяет результируемую строку.
Распознаватель
Чтение/запись
Возвращает или задает объект IInkRecognizer , используемый объектом InkRecognizerContext .
Strokes
Чтение/запись
Возвращает или задает коллекцию InkStrokes, связанную с объектом InkRecognizerContext .
SuffixText
Чтение/запись
Возвращает или задает символы, которые поступают после коллекции InkStrokes в объекте InkRecognizerContext .
Wordlist
Чтение/запись
Возвращает или задает объект InkWordList , используемый для улучшения результатов распознавания.

Комментарии

Этот объект можно создать, вызвав метод CoCreateInstance в C++.

Существует два типа распознавания: фоновый (асинхронный) или передний план (синхронный). Распознавание фона запускается вызовом методов BackgroundRecognize или BackgroundRecognizeWithAlternates , происходит в фоновом потоке и передает результаты приложению через механизм событий. Распознавание переднего плана не возвращается до завершения всего распознавания, что делает результаты распознавания доступными для вызывающего потока без прослушивания события распознавания.

Рукописный ввод обрабатывается непрерывно в фоновом режиме. Если IInkStrokeDisp добавляется в коллекцию InkStrokes , на которую ссылается InkRecognizerContext , то IInkStrokeDisp распознается немедленно. Дополнительные сведения см. в примечаниях в разделе о методе EndInkInput .

Все распознавание происходит через контекст распознавателя. Контекст определяет параметры для одного сеанса распознавания. Он получает рукописный ввод, который необходимо распознать, и определяет ограничения на входные данные рукописного ввода и выходные данные распознавания. Ограничения, которые можно задать для контекста, включают используемый язык, словарь и грамматику.

Примечание

Установка свойств, отличных от свойств Strokes или CharacterAutoCompletion , выполняется успешно, только если коллекция InkStrokes имеет значение NULL. Перед присоединением коллекции InkStrokes к InkRecognizerContext необходимо задать другие свойства либо задать для коллекции InkStrokes значение NULL , а затем задать другие свойства. Если для коллекции InkStrokes задано значение NULL , а затем заданы другие свойства, может потребоваться повторно подключить коллекцию InkStrokes. Это связано с тем, что распознавание начинается сразу после назначения InkStrokes inkRecognizerContext. При вызове метода Recognize [InkRecognizeContext Class] или BackgroundRecognize результаты вызова могут быть уже доступны.

Чтобы повысить производительность приложения, удалите объект InkRecognizerContext , когда он больше не нужен.

Требования

Требование Значение
Минимальная версия клиента
Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера
Ни одна версия не поддерживается
Заголовок
Msinkaut.h (также требуется Msinkaut_i.c)
Библиотека
InkObj.dll

См. также раздел

Интерфейс IInkRecognizer

Коллекция InkStrokes