Método IInkAnalyzer::AddStrokeForLanguage

Adiciona dados de traço para um único traço ao IInkAnalyzer e atribui um identificador de cultura específico ao traço.

Sintaxe

HRESULT AddStrokeForLanguage(
  [in]  LONG         lStrokeId,
  [in]  LONG         lStrokeLCID,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parâmetros

lStrokeId [in]

O identificador do traço a ser adicionado.

lStrokeLCID [in]

O identificador de cultura a ser atribuído ao traço.

ulStrokePacketDataCount [in]

O número de pacotes no traço.

plStrokePacketData [in]

Uma matriz que contém os dados do pacote para o traço.

ulStrokePacketDescriptionCount [in]

O número de propriedades em cada pacote.

pStrokePacketDescriptionGuids [in]

Uma matriz que contém os identificadores de propriedade do pacote.

ppContextNodeStrokeAddedTo [out]

Um ponteiro cujo valor é definido como o ponteiro do IContextNode que contém o traço recém-adicionado.

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e interfaces – Análise de tinta.

Comentários

Cuidado

Para evitar uma perda de memória, chame IUnknown::Release em ppContextNodeStrokeAddedTo quando não precisar mais usar o objeto .

Quando ppContextNodeStrokeAddedTo é NULL, ele indica que o chamador não está interessado no valor retornado do método .

O IInkAnalyzer adiciona o traço a um IContextNode do tipo UnclassifiedInk (consulte Tipos de nó de contexto). Esse nó está na coleção de subnós do nó raiz (consulte Método IInkAnalyzer::GetRootNode e métodos IContextNode::GetSubNodes ).

O IInkAnalyzer atribui o identificador de cultura lStrokeLCID ao traço e adiciona o traço ao primeiro nó de contexto UnclassifiedInk sob o nó raiz do analisador de tinta que contém traços com o mesmo identificador de cultura. Se o analisador de tinta não tiver um nó com o mesmo identificador de cultura, ele criará um novo nó de contexto UnclassifiedInk em seu nó raiz e adicionará o traço ao novo nó de contexto UnclassifiedInk.

plStrokePacketData contém dados de pacote para todos os pontos no traço. pStrokePacketDescriptionGuids contém os GUIDs (identificadores globalmente exclusivos) que descrevem os tipos de dados de pacote incluídos para cada ponto no traço. Para obter uma lista completa das propriedades de pacote disponíveis, consulte Constantes PacketPropertyGuids.

Esse método expande a região sujo para a união do valor atual da região e a caixa delimitadora do traço adicionado.

Se o IInkAnalyzer já contiver um traço com o mesmo identificador de traço, o IInkAnalyzer retornará um HRESULT de E_INVALIDARG.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Cabeçalho	IACom.h (também requer IACom_i.c)
DLL	IACom.dll

Confira também

IInkAnalyzer

Método IInkAnalyzer::AddStroke

Método IInkAnalyzer::AddStrokes

Método IInkAnalyzer::AddStrokesForLanguage

Método IInkAnalyzer::RemoveStroke

Método IInkAnalyzer::RemoveStrokes

Referência de análise de tinta