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 |
|---|---|
|
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 |