Compartilhar via

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

  • Artigo

Determina se uma operação de arrastar e soltar deve ser continuada, cancelada ou concluída. Não chame este método diretamente. A função OLE DoDragDrop chama esse método durante uma operação de arrastar e soltar.

Sintaxe

HRESULT QueryContinueDrag(
  [in] BOOL  fEscapePressed,
  [in] DWORD grfKeyState
);

Parâmetros

[in] fEscapePressed

Indica se a tecla Esc foi pressionada desde a chamada anterior para QueryContinueDrag ou para DoDragDrop se esta for a primeira chamada para QueryContinueDrag. Um valor TRUE indica que o usuário final pressionou a tecla de escape; um valor FALSE indica que ele não foi pressionado.

[in] grfKeyState

O estado atual das teclas modificadoras de teclado no teclado. Os valores possíveis podem ser uma combinação de qualquer um dos sinalizadores MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON e MK_RBUTTON.

Valor retornado

Esse método pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 A operação de arrastar deve continuar. Esse resultado ocorrerá se nenhum erro for detectado, o botão do mouse que inicia a operação de arrastar e soltar não tiver sido liberado e a tecla Esc não tiver sido detectada.
DRAGDROP_S_DROP
 A operação de soltar deve ocorrer concluindo a operação de arrastar. Esse resultado ocorrerá se grfKeyState indicar que a chave que iniciou a operação de arrastar e soltar foi liberada.
DRAGDROP_S_CANCEL
 A operação de arrastar deve ser cancelada sem que nenhuma operação de soltar ocorra. Esse resultado ocorrerá se fEscapePressed for TRUE, indicando que a tecla Esc foi pressionada.

Comentários

A função DoDragDrop chama QueryContinueDrag sempre que detecta uma alteração no estado do botão do teclado ou do mouse durante uma operação de arrastar e soltar. QueryContinueDrag deve determinar se a operação de arrastar e soltar deve ser continuada, cancelada ou concluída com base no conteúdo dos parâmetros grfKeyState e fEscapePressed.

Requisitos

   
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