Метод 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 [только классические приложения]
Минимальная версия сервера
 Ни одна версия не поддерживается
Заголовок
IACom.h (также требуется IACom_i.c)
DLL
IACom.dll

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

IInkAnalyzer

Метод IInkAnalyzer::AddStroke

Метод IInkAnalyzer::AddStrokes

Метод IInkAnalyzer::AddStrokesForLanguage

Метод IInkAnalyzer::RemoveStroke

Метод IInkAnalyzer::RemoveStrokes

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