Método IContextNode::ReparentStrokeByIdToNode

  • Artigo

Move dados de traço desse IContextNode para o IContextNode especificado.

Sintaxe

HRESULT ReparentStrokeByIdToNode(
  [in] LONG         lStrokeId,
  [in] IContextNode *pContextNodeDestination
);

Parâmetros

lStrokeId [in]

O identificador do traço a ser movido.

pContextNodeDestination [in]

O objeto IContextNode para o qual mover os dados de traço.

Valor retornado

Para obter uma descrição dos valores retornados, consulte Classes e Interfaces – Análise de Tinta.

Comentários

O objeto IContextNode especificado deve ser um dos seguintes tipos das constantes Tipos de Nó de Contexto : InkWord, InkDrawing, InkBullet ou UnclassifiedInk. Tentar mover um traço para qualquer outro tipo de objeto IContextNode resulta em um valor retornado de E_INVALIDARG.

Esse método pode ser chamado de qualquer objeto IContextNode , incluindo objetos IContextNode de folha não à tinta. O traço especificado deve ser referenciado por um dos descendentes desse objeto IContextNode ou E_INVALIDARG é retornado.

Se esse IContextNode ou o IContextNode em pContextNodeDestination for confirmado, E_INVALIDARG será retornado (consulte IContextNode::IsConfirmed).

O analisador de tinta não exclui nós de contexto vazios de sua árvore de resultados em resposta a esse método.

  • Um nó folha de tinta que não faz referência a nenhum dado de traço é um nó vazio.
  • Um nó de contêiner que não faz referência a nenhum nó filho é um nó vazio.

Um nó vazio gera erros se estiver na árvore durante uma operação de análise de tinta. Para remover um nó da árvore do analisador de tinta, chame o método IContextNode::D eleteSubNode do nó pai (consulte IContextNode::GetParentNode).

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

IContextNode

IContextNode::SetStrokes

Referência de análise de tinta