Класс 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 [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| Библиотека |
|
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по