Метод IInkAnalyzer::AddStrokeForLanguage
Добавляет данные росчерка для одного росчерка в IInkAnalyzer и присваивает росчерку определенный идентификатор языка и региональных параметров.
Синтаксис
HRESULT AddStrokeForLanguage(
[in] LONG lStrokeId,
[in] LONG lStrokeLCID,
[in] ULONG ulStrokePacketDataCount,
[in] LONG *plStrokePacketData,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Параметры
-
lStrokeId [in]
-
Идентификатор добавляемого росчерка.
-
lStrokeLCID [in]
-
Идентификатор языка и региональных параметров, назначаемого росчерку.
-
ulStrokePacketDataCount [in]
-
Количество пакетов в росчерке.
-
plStrokePacketData [in]
-
Массив, содержащий данные пакета для росчерка.
-
ulStrokePacketDescriptionCount [in]
-
Количество свойств в каждом пакете.
-
pStrokePacketDescriptionGuids [in]
-
Массив, содержащий идентификаторы свойств пакета.
-
ppContextNodeStrokeAddedTo [out]
-
Указатель, значение которого равно указателю IContextNode , который содержит добавленный штрих.
Возвращаемое значение
Описание возвращаемых значений см. в разделе Классы и интерфейсы — анализ рукописного ввода.
Remarks
Внимание!
Чтобы избежать утечки памяти, вызовите метод IUnknown::Release в ppContextNodeStrokeAddedTo , если вам больше не нужно использовать объект .
Если параметр ppContextNodeStrokeAddedTo имеет значение NULL, это означает, что вызывающий объект не заинтересован в возвращаемом значении из метода .
IInkAnalyzer добавляет росчерк к IContextNode типа UnclassifiedInk (см. раздел Типы узлов контекста). Этот узел находится в коллекции поднодер корневого узла (см. статьи Метод IInkAnalyzer::GetRootNode и методы IContextNode::GetSubNodes ).
IInkAnalyzer назначает штриху идентификатор языка lStrokeLCID и добавляет его в первый узел контекста UnclassifiedInk в корневом узле анализатора рукописного ввода, который содержит штрихи с тем же идентификатором языка и региональных параметров. Если у анализатора рукописного ввода нет узла с тем же идентификатором языка и региональных параметров, он создает новый узел контекста UnclassifiedInk под корневым узлом и добавляет росчерк в новый узел контекста UnclassifiedInk.
plStrokePacketData содержит данные пакетов для всех точек в росчерке. pStrokePacketDescriptionGuids содержит глобальные уникальные идентификаторы (GUID), которые описывают типы данных пакетов, включенных для каждой точки росчерка. Полный список доступных свойств пакета см. в разделе Константы PacketPropertyGuids.
Этот метод расширяет область грязное до объединения текущего значения области и ограничивающего прямоугольника добавленного росчерка.
Если IInkAnalyzer уже содержит штрих с тем же идентификатором штриха, IInkAnalyzer возвращает HRESULTE_INVALIDARG.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows XP Tablet PC Edition [только классические приложения] |
Минимальная версия сервера |
Ни одна версия не поддерживается |
Заголовок |
|
DLL |
|