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

Artigo
08/24/2023

Copia a coleção InkStrokes para a Área de Transferência.

Sintaxe

HRESULT ClipboardCopy(
  [in, optional] IInkStrokes         *strokes,
  [in, optional] InkClipboardFormats ClipboardFormats,
  [in, optional] InkClipboardModes   ClipboardModes,
  [out, retval]  IDataObject         **DataObject
);

Parâmetros

[in, optional] strokes

Opcional. Especifica os traços a serem copiados. Se o parâmetro strokes for NULL, o método ClipboardCopy copiará todo o objeto InkDisp . O valor padrão é NULL.

[in, optional] ClipboardFormats

Opcional. Especifica o valor de enumeração InkClipboardFormats do objeto InkDisp . O valor padrão é ICF_Default.

[in, optional] ClipboardModes

Opcional. Especifica o valor de enumeração InkClipboardModes do objeto InkDisp . O valor padrão é ICB_Default.

[out, retval] DataObject

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

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 .
E_INK_MISMATCHED_INK_OBJECT	O parâmetro strokes está associado a um objeto Ink diferente.

Comentários

Esse método copia todas as propriedades do traço, incluindo resultados de reconhecimento. Definir o parâmetro strokes como NULL copia o objeto InkDisp para a Área de Transferência, incluindo a propriedade CustomStrokes, e os resultados de reconhecimento para traços na coleção IInkCustomStrokes do objeto InkDisp são mantidos.

Se uma coleção InkStrokes vazia for passada, o método retornará NULL e o conteúdo da Área de Transferência não será modificado.

ObservaçãoOleInitialize(NULL) deve ser chamado antes que as APIs da área de transferência possam funcionar.

Cuidado Para evitar possíveis vazamentos de memória como resultado do uso do sinalizador ICB_DelayedCopy , você deve chamar o método OleFlushClipboard ou OleSetClipboard . Isso deve ser feito antes que o aplicativo seja encerrado se a última chamada para o método ClipboardCopy tiver usado o sinalizador ICB_DelayedCopy .

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