Метод IInkAnalyzer::AddStrokeToCustomRecognizer

Статья
06/13/2023

Добавляет данные росчерка для одного штриха в пользовательский узел распознавателя.

Синтаксис

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Параметры

ulStrokeId [in]: Идентификатор добавляемого росчерка.
ulStrokePacketDataCount [in]: Количество пакетов в росчерке.
plStrokePacketData [in]: Массив, содержащий данные пакета для росчерка.
ulStrokePacketDescriptionCount [in]: Количество свойств пакета в каждом пакете.
pStrokePacketDescriptionGuids [in]: Массив, содержащий идентификаторы свойств пакета.
pCustomRecognizer [in]: IContextNode типа CustomRecognizer, к которому добавляется росчерк.
ppContextNodeStrokeAddedTo [out]: Объект IContextNode, в который анализатор рукописного ввода добавил росчерк.

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

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

Remarks

Внимание!

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

Если ppContextNodeStrokeAddedTo имеет значение NULL, это означает, что вызывающий объект не заинтересован в возвращаемом значении из метода .

IInkAnalyzer добавляет штрих к IContextNode типа CustomRecognizer (см. раздел Типы узлов контекста). Этот узел входит в коллекцию поднодер корневого узла (см. метод IInkAnalyzer::GetRootNode и метод IContextNode::GetSubNodes ).

IInkAnalyzer назначает идентификатор языка и региональных параметров активного входного потока росчерку и добавляет его в первый узел UnclassifiedInk в узле CustomRecognizer. Если узел UnclassifiedInk не существует, он создается. Если IInkAnalysisRecognizer , связанный с узлом CustomRecognizer , не поддерживает идентификатор языка и региональных параметров, IInkAnalyzer продолжает анализ и создает предупреждение IAnalysisWarning . Это предупреждение имеет значение AnalysisWarningCodeAnalysisWarningCode_LanguageIdNotRespected.

plStrokePacketData содержит данные пакетов для всех точек в росчерке. pStrokePacketDescriptionGuids содержит глобальные уникальные идентификаторы (GUID), которые описывают типы данных пакетов, включенных для каждой точки в каждом штрихе. Полный список доступных свойств пакета см. в разделе Константы PacketPropertyGuids.

Этот метод расширяет область грязное до объединения текущего значения региона и ограничивающего прямоугольника добавленного росчерка.

IInkAnalyzer возвращает HRESULTE_INVALIDARG при следующих обстоятельствах.

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

Требования

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

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

IInkAnalyzer
Типы узлов контекста
Метод IInkAnalyzer::AddStrokesToCustomRecognizer
Метод IInkAnalyzer::CreateCustomRecognizer
Справочник по анализу рукописного ввода

Поделиться через