Метод IInkAnalyzer::AddStrokes

Статья
06/13/2023

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

Синтаксис

HRESULT AddStrokes(
  [in]  ULONG        ulStrokeIdsCount,
  [in]  LONG         *plStrokeIds,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  ULONG        *pulPacketDataCountPerStroke,
  [in]  LONG         *plStrokePacketData,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Параметры

ulStrokeIdsCount [in]: Количество добавляемых росчерков.
plStrokeIds [in]: Массив, содержащий идентификаторы росчерка.
ulStrokePacketDescriptionCount [in]: Количество свойств в каждом пакете.
pStrokePacketDescriptionGuids [in]: Массив, содержащий идентификаторы свойств пакета.
pulPacketDataCountPerStroke [in]: Массив, содержащий количество пакетов в каждом росчерке.
plStrokePacketData [in]: Массив, содержащий данные пакета для штрихов.
ppContextNodeStrokeAddedTo [out]: IContextNode, в который анализатор рукописного ввода добавил штрихи.

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

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

Remarks

Внимание!

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

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

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

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

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

Примечание

В одном вызове метода IInkAnalyzer::AddStrokes можно добавить только штрихи с одинаковыми описаниями пакетов.

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

Если IInkAnalyzer уже содержит штрих с тем же идентификатором, что и один из добавляемых штрихов, IInkAnalyzer возвращает HRESULTE_INVALIDARG.

Требования

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

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

IInkAnalyzer
Метод IInkAnalyzer::AddStroke
Метод IInkAnalyzer::AddStrokeForLanguage
Метод IInkAnalyzer::AddStrokesForLanguage
Метод IInkAnalyzer::RemoveStroke
Метод IInkAnalyzer::RemoveStrokes
Справочник по анализу рукописного ввода