Share via

Método IRichEditOleCallback::QueryAcceptData (richole.h)

  • Artigo

Durante uma operação de colagem ou um evento de arrastar, determina se os dados colados ou arrastados devem ser aceitos.

Sintaxe

HRESULT QueryAcceptData(
  LPDATAOBJECT lpdataobj,
  CLIPFORMAT   *lpcfFormat,
  DWORD        reco,
  BOOL         fReally,
  HGLOBAL      hMetaPict
);

Parâmetros

lpdataobj

Tipo: LPDATAOBJECT

O objeto de dados que está sendo colado ou arrastado.

lpcfFormat

Tipo: CLIPFORMAT*

O formato da área de transferência que será usado para a operação de colar ou soltar. Se o valor apontado por lpcfFormat for zero, o melhor formato disponível será usado. Se o retorno de chamada alterar o valor apontado por lpcfFormat, o controle de edição avançada usará apenas esse formato e a operação falhará se o formato não estiver disponível.

reco

Tipo: DWORD

Um sinalizador de operação da área de transferência, que pode ser um desses valores.

Valor Significado
RECO_DROP
 Operação de soltar (arrastar e soltar).
RECO_PASTE
 Cole da área de transferência.

fReally

Tipo: BOOL

Indica se o drag-drop está realmente acontecendo ou se é apenas uma consulta. Um valor diferente de zero indica que a colagem ou a queda está realmente acontecendo. Um valor zero indica que a operação é apenas uma consulta, como para EM_CANPASTE.

hMetaPict

Tipo: HGLOBAL

Manipule para um metarquivo que contém a exibição de ícone de um objeto se DVASPECT_ICON estiver sendo imposta a um objeto por uma operação especial de colagem.

Retornar valor

Tipo: HRESULT

Retornará S_OK se houver êxito. Consulte Observações.

Comentários

Em caso de falha, o controle de edição avançada recusa os dados e encerra a operação. Caso contrário, o controle verifica os próprios dados em busca de formatos aceitáveis. Um código de êxito diferente de S_OK significa que o retorno de chamada verificou os dados em si (se fReally for FALSE) ou importou os dados em si (se fReally for TRUE). Se o aplicativo retornar um código de êxito diferente de S_OK, o controle não marcar o estado somente leitura do controle de edição.

Requisitos

Requisito Valor
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 richole.h
DLL Msftedit.dll

Confira também

Iricheditolecallback