Método IInkAnalyzer::AddStrokes

Adiciona dados de traço para vários traços ao IInkAnalyzer e atribui o identificador de cultura do thread de entrada ativo aos traços.

Sintaxe

HRESULT AddStrokes(
  [in]  ULONG        ulStrokeIdsCount,
  [in]  LONG         *plStrokeIds,
  [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.

plStrokeIds [in]

Uma matriz que contém os identificadores de 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.

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 um vazamento de memória, chame IUnknown::Release em ppContextNodeStrokeAddedTo quando você 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 Tipos de Nó de Contexto). Esse nó está na coleção de subnodos do nó raiz (consulte Método IInkAnalyzer::GetRootNode e métodos IContextNode::GetSubNodes ).

O IInkAnalyzer atribui o identificador de cultura do thread de entrada ativo 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 sob 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, confira 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::AddStrokesForLanguage

Método IInkAnalyzer::RemoveStroke

Método IInkAnalyzer::RemoveStrokes

Referência de análise de tinta