Método IInkAnalyzer::AddStroke
Adiciona dados de traço para um único traço ao IInkAnalyzer e atribui o identificador de cultura do thread de entrada ativo ao traço.
Sintaxe
HRESULT AddStroke(
[in] LONG lStrokeId,
[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.
-
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.
-
ppContextNodeStrokeAddedTo [out]
-
Um ponteiro para o IContextNode ao qual o IInkAnalyzer 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 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 o traço 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 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 sob 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, confira 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 |
|
| DLL |
|