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

  • Artículo

Determina si se debe continuar, cancelar o completar una operación de arrastrar y colocar. No se llama a este método directamente. La función OLE DoDragDrop llama a este método durante una operación de arrastrar y colocar.

Sintaxis

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

Parámetros

[in] fEscapePressed

Indica si la tecla Esc se ha presionado desde la llamada anterior a QueryContinueDrag o a DoDragDrop si esta es la primera llamada a QueryContinueDrag. Un valor TRUE indica que el usuario final ha presionado la tecla de escape; un valor FALSE indica que no se ha presionado.

[in] grfKeyState

Estado actual de las teclas modificadoras de teclado en el teclado. Los valores posibles pueden ser una combinación de cualquiera de las marcas MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON y MK_RBUTTON.

Valor devuelto

Este método puede devolver los siguientes valores.

Código devuelto Descripción
S_OK
 La operación de arrastre debe continuar. Este resultado se produce si no se detectan errores, no se ha liberado el botón del mouse que inicia la operación de arrastrar y colocar y no se ha detectado la tecla Esc.
DRAGDROP_S_DROP
 La operación de colocación debe realizarse completando la operación de arrastre. Este resultado se produce si grfKeyState indica que se ha liberado la clave que inició la operación de arrastrar y colocar.
DRAGDROP_S_CANCEL
 La operación de arrastrar debe cancelarse sin que se produzca ninguna operación de colocación. Este resultado se produce si fEscapePressed es TRUE, lo que indica que se ha presionado la tecla Esc.

Comentarios

La función DoDragDrop llama a QueryContinueDrag cada vez que detecta un cambio en el estado del teclado o del botón del mouse durante una operación de arrastrar y colocar. QueryContinueDrag debe determinar si la operación de arrastrar y colocar debe continuarse, cancelarse o completarse en función del contenido de los parámetros grfKeyState y fEscapePressed.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleidl.h

Consulte también

DoDragDrop

IDropSource