Метод IInkAnalyzer::AddStrokes
Добавляет данные росчерка для нескольких штрихов в 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 [только классические приложения] |
| Минимальная версия сервера |
Ни одна версия не поддерживается |
| Заголовок |
|
| DLL |
|