Compartilhar via


Método IInkDisp::Clone (msinkaut.h)

Cria um objeto InkDisp duplicado.

Sintaxe

HRESULT Clone(
  [out, retval] IInkDisp **NewInk
);

Parâmetros

[out, retval] NewInk

Quando esse método retorna, contém um ponteiro para o objeto InkDisp recém-criado.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_OUTOFMEMORY
Não é possível alocar memória para concluir a operação.
E_FAIL
Ocorreu um erro não especificado.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
REGDB_CLASSNOTREG
O objeto InkDisp não foi registrado.
E_UNEXPECTED
Parâmetro ou tipo de propriedade inesperado.

Comentários

O método Clone é definido para os objetos InkDisp, InkDrawingAttributes e InkRecognizerContext . O método Clone retorna uma cópia exata do objeto original.

Na maioria dos cenários, o objeto duplicado é uma cópia exata do objeto original, mas não existe nenhuma relação entre os dois objetos. Consulte a seção de comentários deste tópico para obter detalhes sobre exceções a isso.

Objeto InkDisp: o único cenário em que o objeto InkDisp duplicado não é uma cópia exata do objeto original é quando um objeto inkDisp sujo é clonado. Nesse caso, a propriedade Dirty do objeto InkDisp duplicada é FALSE. Todas as outras propriedades do objeto InkDisp clonado são cópias exatas.

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
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

Propriedade Dirty

Iinkdisp

Classe InkDisp

Método ModifyDrawingAttributes