Método IDropSource::GiveFeedback (oleidl.h)

Permite que um aplicativo de origem forneça comentários visuais ao usuário final durante uma operação de arrastar e soltar fornecendo à função DoDragDrop um valor de enumeração que especifica o efeito visual.

Sintaxe

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

Parâmetros

[in] dwEffect

O valor DROPEFFECT retornado pela chamada mais recente para IDropTarget::D ragEnter, IDropTarget::D ragOver ou IDropTarget::D ragLeave.

Retornar valor

Esse método retorna S_OK com êxito. Outros valores possíveis incluem o seguinte.

Código de retorno	Descrição
DRAGDROP_S_USEDEFAULTCURSORS	Indica a conclusão bem-sucedida do método e solicita que o OLE atualize o cursor usando os cursores padrão fornecidos por OLE.

Comentários

Quando o aplicativo detecta que o usuário iniciou uma operação de arrastar e soltar, ele deve chamar a função DoDragDrop . DoDragDrop entra em um loop, chamando IDropTarget::D ragEnter quando o mouse entra pela primeira vez em uma janela de destino de soltar, IDropTarget::D ragOver quando o mouse altera sua posição dentro da janela de destino e IDropTarget::D ragLeave quando o mouse sai da janela de destino.

Para cada chamada para IDropTarget::D ragEnter ou IDropTarget::D ragOver, DoDragDrop chama IDropSource::GiveFeedback, passando-lhe o valor DROPEFFECT retornado da chamada de destino de soltar.

DoDragDrop chama IDropTarget::D ragLeave quando o mouse deixou a janela de destino. Em seguida, DoDragDrop chama IDropSource::GiveFeedback e passa o valor DROPEFFECT_NONE no parâmetro dwEffect .

O parâmetro dwEffect pode incluir DROPEFFECT_SCROLL, indicando que a origem deve colocar a variação de rolagem de arrastar do ponteiro apropriado.

Anotações aos implementadores

Essa função é chamada com frequência durante o loop DoDragDrop , para que você possa obter vantagens de desempenho se otimizar a implementação o máximo possível.

IDropSource::GiveFeedback é responsável por alterar a forma do cursor ou por alterar a origem realçada com base no valor do parâmetro dwEffect . Se você estiver usando cursores padrão, poderá retornar DRAGDROP_S_USEDEFAULTCURSORS, o que faz com que o OLE atualize o cursor para você, usando seus padrões.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	oleidl.h

Confira também

Dodragdrop

IDropSource

Idroptarget