Интерфейс IInkAnalyzer
Предоставляет доступ к анализу макета, классификации текста и рисования, а также распознаванию рукописного ввода.
Элементы
Интерфейс IInkAnalyzer наследуется от интерфейса IUnknown . IInkAnalyzer также имеет следующие типы элементов:
Методы
Интерфейс IInkAnalyzer содержит следующие методы.
| Метод | Описание |
|---|---|
| Прервать | Отменяет текущую операцию анализа. |
| AddStroke | Добавляет данные росчерка для одного росчерка в IInkAnalyzer и присваивает штриху идентификатор языка и региональных параметров активного входного потока. |
| AddStrokeForLanguage | Добавляет данные росчерка для одного росчерка в IInkAnalyzer и присваивает росчерку определенный идентификатор языка и региональных параметров. |
| AddStrokes | Добавляет данные росчерка для нескольких штрихов в IInkAnalyzer и назначает штрихам идентификатор языка и региональных параметров активного входного потока. |
| AddStrokesForLanguage | Добавляет данные росчерка для нескольких штрихов в IInkAnalyzer и присваивает штрихам указанный идентификатор языка и региональных параметров. |
| AddStrokesToCustomRecognizer | Добавляет данные росчерка для нескольких штрихов в пользовательский узел распознавателя. |
| AddStrokeToCustomRecognizer | Добавляет данные росчерка для одного росчерка в пользовательский узел распознавателя. |
| Анализ | Выполняет синхронный анализ рукописного ввода. |
| BackgroundAnalyze | Выполняет асинхронный анализ рукописного ввода. |
| ClearStrokeData | Очищает данные пакетов штрихов из IInkAnalyzer. |
| CreateAnalysisHint | Добавляет новый узел указания анализа с бесконечной областью в IInkAnalyzer. |
| CreateContextNodes | Создает объект IContextNodes . |
| CreateCustomRecognizer | Создает новый пользовательский узел распознавателя для IInkAnalyzer. |
| DeleteAnalysisHint | Удаляет подсказку анализа из IInkAnalyzer. |
| FindInkLeafNodes | Извлекает все конечные узлы рукописного ввода. |
| FindInkLeafNodesForStrokes | Извлекает конечные узлы рукописного ввода, содержащие указанные штрихи. |
| FindLeafNodes | Извлекает все конечные узлы. |
| FindNode | Извлекает объект IContextNode для указанного глобально уникального идентификатора (GUID). |
| FindNodesOfType | Извлекает все объекты IContextNode указанного типа. |
| FindNodesOfTypeForStrokes | Извлекает все объекты IContextNode указанного типа, содержащие указанные штрихи. |
| FindNodesOfTypeInSubTree | Извлекает все объекты IContextNode указанного типа, которые являются потомками указанного объекта IContextNode . |
| FindNodesWithCallBack | Извлекает все объекты IContextNode , соответствующие указанным условиям. |
| FindNodesWithCallBackInSubTree | Извлекает все объекты IContextNode , которые соответствуют заданным условиям и являются потомками указанного объекта IContextNode . |
| GetAlternates | Извлекает 10 вариантов анализа для всех рукописных фрагментов, связанных с IInkAnalyzer. |
| GetAlternatesForContextNodes | Извлекает варианты анализа для узлов в указанной коллекции IContextNodes . |
| GetAlternatesForStrokes | Извлекает варианты анализа для штрихов с указанными идентификаторами штрихов. |
| GetAnalysisHints | Извлекает все объекты IContextNode , присоединенные к IInkAnalyzer. |
| GetAnalysisHintsByName | Извлекает все объекты IContextNode , присоединенные к IInkAnalyzer и имеющие указанное имя. |
| GetAnalysisModes | Извлекает флаги, управляющие тем, как IInkAnalyzer выполняет анализ рукописного ввода. |
| GetDirtyRegion | Извлекает область, которая изменилась с момента последней операции анализа. |
| GetInkAnalysisRecognizersByPriority | Извлекает упорядоченную коллекцию объектов IInkAnalysisRecognizer . |
| GetNodesFromTextRange | Извлекает коллекцию объектов IContextNode , относящихся к указанному текстовому диапазону для указанных узлов контекста. |
| GetRecognizedString | Извлекает строку наилучшего результата операции распознавания для всего дерева узлов контекста в IInkAnalyzer. |
| GetRootNode | Извлекает корневой объект IContextNode дерева контекста объекта IInkAnalyzer . |
| GetStrokeLanguageId | Извлекает идентификатор языкового стандарта указанного росчерка. |
| GetStrokeType | Извлекает тип указанного росчерка. |
| GetTextRangeFromNodes | Находит текстовый диапазон в распознанной строке, соответствующий коллекции объектов IContextNode . |
| IsAnalyzing | Возвращает значение, указывающее, выполняет ли IInkAnalyzer анализ рукописного ввода. |
| LoadResults | Загружает сохраненные результаты анализа в IInkAnalyzer. |
| ModifyTopAlternate | Изменяет текущий верхний альтернативный вариант на указанный и очищает тип подтверждения для всех объектов IContextNode , связанных с альтернативным вариантом. |
| ModifyTopAlternateWithConfirmation | Изменяет текущий верхний альтернативный вариант на указанный IAnalysisAlternate. |
| Reconcile | Определяет, какие части результатов анализа были изменены во время фонового анализа рукописного ввода. |
| RemoveStroke | Удаляет указанный штрих из IInkAnalyzer. |
| RemoveStrokes | Удаляет указанные штрихи из IInkAnalyzer. |
| SaveResults | Сохраняет все результаты анализа для IInkAnalyzer. |
| SaveResultsForNodes | Сохраняет результаты анализа для определенной коллекции узлов контекста, связанной с IInkAnalyzer. |
| SaveResultsForStrokes | Сохраняет результаты анализа для указанных штрихов, связанных с IInkAnalyzer. |
| Поиск | Предоставляет поиск нечетких фраз без учета регистра для проанализированных штрихов записи и проанализированных штрихов рисунка с распознаваемыми типами. |
| SearchWithLanguageId | Предоставляет поиск нечетких фраз без учета регистра для проанализированных штрихов записи и проанализированных штрихов рисунка с распознаваемыми типами. |
| SetAnalysisModes | Изменяет флаги, управляющие тем, как IInkAnalyzer выполняет анализ рукописного ввода. |
| SetDirtyRegion | Изменяет область, которая изменилась с момента последней операции анализа. |
| SetHighestPriorityInkAnalysisRecognizer | Перемещает указанный IInkAnalysisRecognizer на первую позицию в списке распознавателей рукописного ввода объекта IInkAnalyzer . |
| SetStrokeLanguageId | Изменяет идентификатор языкового стандарта для указанного штриха. |
| SetStrokesLanguageId | Изменяет идентификатор языкового стандарта для указанных штрихов. |
| SetStrokesType | Изменяет тип указанных штрихов. |
| SetStrokeType | Изменяет тип указанного росчерка. |
| UpdateStrokesData | Обновления данные пакета для указанных штрихов. |
Комментарии
IInkAnalyzer использует данные пакета росчерка для анализа рукописного ввода и не взаимодействует с объектами Класса InkDisp или Коллекции InkStrokes напрямую.
Чтобы добавить или удалить штрихи в IInkAnalyzer для анализа, используйте один из следующих методов.
- Метод IInkAnalyzer::AddStroke
- Метод IInkAnalyzer::AddStrokes
- Метод IInkAnalyzer::RemoveStroke
- Метод IInkAnalyzer::RemoveStrokes
Эти методы обновляют грязное регионе (см. раздел Метод IInkAnalyzer::GetDirtyRegion), который представляет собой область, для которой анализируются штрихи в следующей операции анализа.
Для анализа рукописного ввода используйте метод IInkAnalyzer::Analyze или метод IInkAnalyzer::BackgroundAnalyze . Во время анализа IInkAnalyzer выполняет анализ макета, классификацию штрихов и распознавание рукописного ввода.
Чтобы изменить параметры анализа макета и классификации штрихов, используйте свойство Метод IInkAnalyzer::SetAnalysisModes .
Во время анализа IInkAnalyzer получает ряд событий, включая события, созданные во время фонового анализа. _IAnalysisProxyEvents поддерживает функции прокси-сервера данных IInkAnalyzer. Дополнительные сведения см. в разделе Прокси-сервер данных с анализом рукописного ввода. Чтобы остановить процесс анализа в обработчике событий, вызовите метод IInkAnalyzer::Abort.
Чтобы изменить язык, используемый анализатором рукописного ввода для распознавания рукописного ввода, используйте метод IInkAnalyzer::SetStrokeLanguageId или метод IInkAnalyzer::SetStrokesLanguageId. Чтобы изменить, как анализатор рукописного ввода классифицирует определенные штрихи, используйте метод IInkAnalyzer::SetStrokeType или метод IInkAnalyzer::SetStrokesType.
IInkAnalyzer загружает сведения обо всех установленных распознавателях рукописного ввода. Метод IInkAnalyzer::GetInkAnalysisRecognizersByPriority возвращает коллекцию IInkAnalysisRecognizers, содержащую каждый доступный IInkAnalysisRecognizer. Если несколько распознавателя рукописного ввода поддерживают определенный язык, используйте метод IInkAnalyzer::SetHighestPriorityInkAnalysisRecognizer , чтобы задать, какой распознаватель рукописного ввода обрабатывает штрихи для этого языка.
Использование подсказок анализа может повысить точность распознавания, предоставляя дополнительный контекст анализатору рукописного ввода. Дополнительные сведения о контексте могут помочь анализатору рукописного ввода ограничить количество возможных результатов распознавания. Например, можно сузить область, определив фактоиды и ожидаемые слова или структурируя входные данные в руководство по распознаванию. Дополнительные сведения о предоставлении контекста для анализатора рукописного ввода см. в следующих разделах:
- Метод IInkAnalyzer::CreateAnalysisHint
- Метод IInkAnalyzer::D eleteAnalysisHint
- Метод IInkAnalyzer::GetAnalysisHints
- Метод IInkAnalyzer::GetAnalysisHintsByName
Анализатор рукописного ввода представляет результаты анализа в виде строки или дерева объектов IContextNode . Чтобы получить доступ к распознанной строке, используйте метод IInkAnalyzer::GetRecognizedString. Чтобы получить доступ к корню дерева узлов контекста, используйте метод IInkAnalyzer::GetRootNode. Анализатор рукописного ввода имеет следующие методы для поиска определенных узлов контекста или текста.
- Метод IInkAnalyzer::FindInkLeafNodes
- Метод IInkAnalyzer::FindInkLeafNodesForStrokes
- Метод IInkAnalyzer::FindLeafNodes
- Метод IInkAnalyzer::FindNode
- Метод IInkAnalyzer::FindNodesOfType
- Метод IInkAnalyzer::FindNodesOfTypeForStrokes
- Метод IInkAnalyzer::FindNodesOfTypeInSubTree
- Метод IInkAnalyzer::FindNodesWithCallBack
- Метод IInkAnalyzer::FindNodesWithCallBackInSubTree
Для работы с альтернативными результатами анализа используйте один из следующих методов.
- Метод IInkAnalyzer::GetAlternates
- Метод IInkAnalyzer::GetAlternatesForContextNodes
- Метод IInkAnalyzer::GetAlternatesForStrokes
- Метод IInkAnalyzer::ModifyTopAlternate
- Метод IInkAnalyzer::ModifyTopAlternateWithConfirmation
Чтобы сохранить результаты анализа, используйте один из следующих методов.
- Метод IInkAnalyzer::SaveResults
- Метод IInkAnalyzer::SaveResultsForNodes
- Метод IInkAnalyzer::SaveResultsForStrokes
Чтобы загрузить сохраненные результаты, используйте метод IInkAnalyzer::LoadResults.
Дополнительные сведения об использовании IInkAnalyzer для анализа рукописного ввода см. в разделе Общие сведения об анализе рукописного ввода.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| DLL |
|