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

Copia o IDataObject da Área de Transferência para o objeto InkDisp .

Sintaxe

HRESULT ClipboardPaste(
  [in, optional] long        x,
  [in, optional] long        y,
  [in, optional] IDataObject *DataObject,
  [out, retval]  IInkStrokes **Strokes
);

Parâmetros

[in, optional] x

Opcional. Especifica a coordenada x a ser colada em coordenadas de espaço à tinta . O valor padrão é 0.

[in, optional] y

Opcional. Especifica a coordenada y a ser colada em coordenadas de espaço à tinta. O valor padrão é 0.

[in, optional] DataObject

Opcional. Especifica o IDataObject a ser usado. Para colar da Área de Transferência, defina como NULL. O valor padrão é NULL.

[out, retval] Strokes

Quando este método retorna, contém um ponteiro para a coleção InkStrokes no objeto InkDisp .

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .

Comentários

Um erro será retornado se ocorrer um erro inesperado ao acessar a Área de Transferência. Se nenhum erro ocorrer, mas a Área de Transferência não contiver um formato que possa ser colado em tinta - isf (formato serializado por tinta) ou um objeto de tinta de texto (tInk) -, NULL será retornado e nenhuma exceção será gerada. Para obter mais informações sobre a área de transferência, consulte Área de transferência na entidade MSDN<type="reg"/>

Requisitos

   
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

Iinkdisp

Classe InkDisp

Coleção InkStrokes