Метод IInkAnalyzer::CreateAnalysisHint

Добавляет новый узел указания анализа с бесконечной областью в IInkAnalyzer.

Синтаксис

HRESULT CreateAnalysisHint(
  [out] IContextNode **ppAnalysisHint
);

Параметры

ppAnalysisHint [out]

Новый узел указания анализа.

Возвращаемое значение

Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.

Remarks

Внимание!

Чтобы избежать утечки памяти, вызовите метод IUnknown::Release в ppAnalysisHint , если вам больше не нужно использовать объект .

Чтобы предоставить дополнительные сведения о контексте для IInkAnalyzer, можно добавить подсказки анализа в анализатор рукописного ввода. Указания анализа могут повысить точность распознавания. Например, можно добавить фактоиды и направляющие сведения для полей в приложении формы.

Этот метод создает новый IContextNode с типом узла контекста AnalysisHint (см. раздел IContextNode::GetType) и добавляет новое указание в качестве поднода корневого узла объекта IInkAnalyzer (см. раздел Метод IContextNode::GetSubNodes и IInkAnalyzer::GetRootNode).

Чтобы добавить сведения о контексте в подсказку, используйте IContextNode::AddPropertyData с параметром pPropertyDataId , равным одной из констант свойств подсказки анализа .

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

Добавление указания анализа не помечает область указания для повторного анализа. Чтобы пометить область в указании для повторного анализа, используйте метод IInkAnalyzer::SetDirtyRegion, чтобы задать для области грязное объединение текущей области грязное и области указания анализа.

При использовании подсказок для приложения формы приложение не должно смешивать текстовый контекст с рукописным вводом в формах. Это означает, например, что имена текстовых полей не должны создаваться в дереве анализа. Подсказки предназначены для связывания рукописного ввода с областями на страницах; любой текстовый контекст мешает этой связи рукописного ввода с подсказкой. Операция анализа может объединить рукописный и текстовый контекст в одной области записи, что предотвратит связывание рукописного ввода с областью указания.

Дополнительные сведения об анализе рукописного ввода см. в статье Общие сведения об анализе рукописного ввода.

Требования

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

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

IInkAnalyzer

IContextNode::AddPropertyData

Метод IInkAnalyzer::D eleteAnalysisHint

Метод IInkAnalyzer::GetAnalysisHints

Метод IInkAnalyzer::GetAnalysisHintsByName

Свойства подсказки анализа

Справочник по анализу рукописного ввода