Интерфейс IInkRecognitionResult (msinkaut.h)

  • Статья

Представляет результат распознавания. Результаты распознавания рукописного ввода возвращаются в объекте IInkRecognitionResult .

Наследование

Интерфейс IInkRecognitionResult наследуется от интерфейса IUnknown . IInkRecognitionResult также имеет следующие типы элементов:

Методы

Интерфейс IInkRecognitionResult содержит следующие методы.

 
IInkRecognitionResult::get_Strokes

Возвращает коллекцию штрихов, содержащихся в объекте или используемых для создания объекта. (IInkRecognitionResult.get_Strokes)
IInkRecognitionResult::get_TopAlternate

Возвращает верхнюю альтернативу результата распознавания. (IInkRecognitionResult.get_TopAlternate)
IInkRecognitionResult::get_TopConfidence

Возвращает верхнюю альтернативу результата распознавания. (IInkRecognitionResult.get_TopConfidence)
IInkRecognitionResult::get_TopString

Возвращает текст результата для свойства TopAlternate.
IInkRecognitionResult::ModifyTopAlternate

Изменяет верхний вариант результата распознавания с помощью указанного альтернативного.
IInkRecognitionResult::SetResultOnStrokes

Назначает результаты распознавания росчеркам, которые использовались для создания результатов.

Комментарии

Объекты IInkRecognitionAlternate или альтернативные варианты создаются на основе результата. Лучшим или верхним вариантом является тот, который используется по умолчанию в результатах. Однако можно использовать методы объекта IInkRecognitionResult , чтобы указать, какие варианты следует использовать в результате.

Производительность системы может снизиться, если результаты распознавания автоматически назначаются каждой коллекции штрихов. Поэтому по умолчанию результаты не присоединяются к коллекции штрихов. Чтобы назначить результаты коллекции штрихов, необходимо вызвать метод SetResultOnStrokes .

Единственный способ сохранить результаты распознавания — вызвать SetResultOnStrokes , а затем добавить эту коллекцию штрихов в коллекцию CustomStrokes в объекте InkDisp .

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

Если вы определите класс, реализующий этот интерфейс, новый класс не будет правильно взаимодействовать с интерфейсами API приложений планшетного компьютера.

Примечание Различные распознаватели рукописного ввода, поставляемые корпорацией Майкрософт на латинских и восточноазиатских языках, иногда могут выдавать значение Юникода 0xFFFF в качестве результата распознавания. Это происходит, когда распознаватель не может сопоставить фрагмент рукописного ввода с любым допустимым символом. Кодовая точка 0xFFFF допустима в кодировке UCS-2, но не разрешена в UTF-8. Приложение, которое преобразует результаты распознавания в UTF-8, должно заменить 0xFFFF на другую кодовую точку, например 0xFFFD.
 

Требования

Требование Значение
Минимальная версия клиента Windows XP Tablet PC Edition [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header msinkaut.h

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

Свойство CustomStrokes [класс InkDisp]

Интерфейс IInkCustomStrokes

Интерфейс IInkRecognizer

Класс InkDisp

Класс InkRecognizerContext

Коллекция InkStrokes