Método ITextRange::CanPaste (tom.h)

  • Artigo

Determina se um objeto de dados pode ser colado, usando um formato especificado, no intervalo atual.

Sintaxe

HRESULT CanPaste(
  VARIANT *pVar,
  long    Format,
  long    *pValue
);

Parâmetros

pVar

Tipo: VARIANT*

O IDataObject a ser colado. No entanto, o conteúdo da Área de Transferência será verificado para colagem se qualquer um dos seguintes itens for verdadeiro:

  • pVar é nulo
  • pVar-punkVal> é nulo
  • pVar-vt> não é VT_UNKNOWN
  • pVar-punkVal> não retorna um objeto IDataObject quando consultado por um

Format

Tipo: long

Formato da área de transferência usado. Zero representa o melhor formato, que geralmente é RTF, mas CF_UNICODETEXT e outros formatos também são possíveis. O valor padrão é zero.

pValue

Tipo: long*

Um valor tomBool que é tomTrue somente se o objeto de dados identificado por pVar puder ser colado, usando o formato especificado, no intervalo. Esse parâmetro pode ser nulo.

Valor retornado

Tipo: HRESULT

O método retorna os seguintes códigos de erro COM. Para obter mais informações sobre códigos de erro COM, consulte Tratamento de erros em COM.

Código de retorno Descrição
S_OK
 O conteúdo da área de transferência ou IDataObject pode ser colado.
S_FALSE
 O conteúdo da área de transferência ou IDataObject não pode ser colado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho tom.h
DLL Msftedit.dll

Confira também

Conceitual

Copy

ITextRange

Referência

Modelo de objeto de texto