Método IInkAnalyzer::AddStrokesForLanguage

Adiciona dados de traço para vários traços ao IInkAnalyzer e atribui o identificador de cultura especificado aos traços.

Sintaxe

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

Parâmetros

ulStrokeIdsCount [in]

O número de traços a serem adicionados.

plIdofStrokesToAdd [in]

Uma matriz que contém os identificadores de traço.

lStrokesLCID [in]

Um valor que representa o identificador de cultura a ser atribuído aos traços.

ulStrokePacketDescriptionCount [in]

O número de propriedades em cada pacote.

pStrokePacketDescriptionGuids [in]

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

pulPacketDataCountPerStroke [in]

Uma matriz que contém o número de pacotes em cada traço.

plStrokePacketData [in]

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

ppContextNodeStrokeAddedTo [out]

O IContextNode ao qual o analisador de tinta adicionou os traços.

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 os traços a um IContextNode do tipo UnclassifiedInk (consulte Context Node Types). 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 aos traços e adiciona os traços 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á os traços ao novo nó de contexto UnclassifiedInk.

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

Observação

Somente traços com as mesmas descrições de pacote podem ser adicionados em uma única chamada ao Método IInkAnalyzer::AddStrokes.

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

Se o IInkAnalyzer já contiver um traço com o mesmo identificador que um dos traços a serem adicionados, 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::AddStrokeForLanguage

Método IInkAnalyzer::AddStrokes

Método IInkAnalyzer::RemoveStroke

Método IInkAnalyzer::RemoveStrokes

Referência de análise de tinta