Método IInkAnalyzer::AddStrokesToCustomRecognizer
Adiciona dados de traço para vários traços a um nó de reconhecedor personalizado.
Sintaxe
HRESULT AddStrokesToCustomRecognizer(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plStrokeIds,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[in] IContextNode *pCustomRecognizer,
[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.
-
pCustomRecognizer [in]
-
O IContextNode do tipo CustomRecognizer ao qual adicionar 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 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 aos traços e adiciona os traços 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 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::AddStrokesToCustomRecognizer.
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.
O IInkAnalyzer retorna um HRESULT de E_INVALIDARG nas circunstâncias a seguir.
- O IInkAnalyzer já contém um traço com o mesmo identificador que um dos traços a serem adicionados.
- 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 |
|
| DLL |
|