Método IInkAnalyzer::AddStrokeToCustomRecognizer

Adiciona dados de traço para um único traço a um nó de reconhecedor personalizado.

Sintaxe

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parâmetros

ulStrokeId [in]

O identificador do traço a ser adicionado.

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 de pacote em cada pacote.

pStrokePacketDescriptionGuids [in]

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

pCustomRecognizer [in]

O IContextNode do tipo CustomRecognizer ao qual adicionar o traço.

ppContextNodeStrokeAddedTo [out]

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

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 no ppContextNodeStrokeAddedTo quando você não precisar mais usar o objeto.

Quando ppContextNodeStrokeAddedTo é NULL, 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 CustomRecognizer (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 ao traço e adiciona o traço ao primeiro nó UnclassifiedInk no nó CustomRecognizer . Se nenhum nó UnclassifiedInk existir, ele será criado. Se o IInkAnalysisRecognizer associado ao nó CustomRecognizer não oferecer suporte ao identificador de cultura, o IInkAnalyzer continuará analisando e gerará um aviso IAnalysisWarning . Esse aviso tem um valor AnalysisWarningCode de AnalysisWarningCode_LanguageIdNotRespected.

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 em cada traço. Para obter uma lista completa das propriedades de pacote disponíveis, consulte PacketPropertyGuids Constants.

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

O IInkAnalyzer retorna um HRESULT de E_INVALIDARG sob as seguintes circunstâncias.

  • O IInkAnalyzer já contém um traço com o mesmo identificador que o traço a ser adicionado.
  • O parâmetro pCustomRecognizer contém um nó de reconhecedor personalizado associado a um objeto IInkAnalyzer diferente.
  • O parâmetro pCustomRecognizer contém um IContextNode que não é do tipo CustomRecognizer.

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

Tipos de nó de contexto

Método IInkAnalyzer::AddStrokesToCustomRecognizer

Método IInkAnalyzer::CreateCustomRecognizer

Referência de análise de tinta