Метод IContextNode::Confirm

Изменяет тип подтверждения, который определяет, что объект IInkAnalyzer может изменять относительно IContextNode.

Синтаксис

HRESULT Confirm(
  [in] ConfirmationType confirmedType
);

Параметры

confirmedType [in]

Тип подтверждения, применяемый к узлу.

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

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

Комментарии

Используйте этот метод, чтобы конечный пользователь мог убедиться, что IInkAnalyzer правильно проанализировал штрихи. После вызова IContextNode::ConfirmIInkAnalyzer не будет изменять объекты IContextNode для этих штрихов во время последующего анализа.

Используйте IContextNode::Confirm , если пользователь подтвердил результаты анализа и не хочет, чтобы IInkAnalyzer изменял IContextNode во время последующего анализа. Например, если пользователь записывает слово "to", а затем приложение вызывает метод IInkAnalyzer::Analyze, анализатор рукописного ввода создает узел InkWord со значением "to". Если пользователь добавляет "me" после "to" в качестве одного слова, а приложение снова вызывает метод IInkAnalyzer::Analyze , анализатор рукописного ввода может удалить предыдущий узел InkWord и создать новый узел InkWord со значением tome. Однако если после первого вызова метода IInkAnalyzer::Analyze приложение вызывает IContextNode::Confirm на узле InkWord для "to" со значением NodeTypeAndPropertiesподтверждения, прежде чем пользователь добавит "me", то при вызове метода IInkAnalyzer::Analyze анализатор рукописного ввода не удаляет и не изменяет узел "на". Вместо этого анализатор рукописного ввода может распознавать два узла InkWord для "to" и "me".

IContextNode может только подтвердить объекты типа InkWord и InkDrawing (см. раздел Типы узлов контекста). IContextNode::Confirm возвращает E_INVALIDARG , если узел не является конечным.

Метод IInkAnalyzer::RemoveStroke и метод IInkAnalyzer::RemoveStrokes отменяют подтверждение любого узла, с которого удаляются данные обводки.

IContextNode::SetStrokes, IInkAnalyzer::SetStrokesType и IInkAnalyzer::SetStrokeType возвращают CORE_E_INVALIDOPERATION , если объект IContextNode уже подтвержден.

IContextNode::ReparentStrokeByIdToNode возвращает ошибку при подтверждении исходного или конечного узла.

Требования

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

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

IContextNode

IContextNode::IsConfirmed

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