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

Permite a una aplicación de origen proporcionar comentarios visuales al usuario final durante una operación de arrastrar y colocar proporcionando la función DoDragDrop con un valor de enumeración que especifica el efecto visual.

Sintaxis

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

Parámetros

[in] dwEffect

Valor DROPEFFECT devuelto por la llamada más reciente a IDropTarget::D ragEnter, IDropTarget::D ragOver o IDropTarget::D ragLeave.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros valores posibles incluyen lo siguiente.

Código devuelto	Descripción
DRAGDROP_S_USEDEFAULTCURSORS	Indica la finalización correcta del método y solicita a OLE que actualice el cursor mediante los cursores predeterminados proporcionados por OLE.

Comentarios

Cuando la aplicación detecta que el usuario ha iniciado una operación de arrastrar y colocar, debe llamar a la función DoDragDrop . DoDragDrop entra en un bucle, llamando a IDropTarget::D ragEnter cuando el mouse entra por primera vez en una ventana de destino de colocación, IDropTarget::D ragOver cuando el mouse cambia su posición dentro de la ventana de destino y IDropTarget::D ragLeave cuando el mouse sale de la ventana de destino.

Para cada llamada a IDropTarget::D ragEnter o IDropTarget::D ragOver, DoDragDrop llama a IDropSource::GiveFeedback, pasando el valor DROPEFFECT devuelto desde la llamada de destino de colocación.

DoDragDrop llama a IDropTarget::D ragLeave cuando el mouse ha dejado la ventana de destino. A continuación, DoDragDrop llama a IDropSource::GiveFeedback y pasa el valor de DROPEFFECT_NONE en el parámetro dwEffect .

El parámetro dwEffect puede incluir DROPEFFECT_SCROLL, lo que indica que el origen debe colocar la variación de desplazamiento de arrastre del puntero adecuado.

Notas para los implementadores

Esta función se llama con frecuencia durante el bucle DoDragDrop , por lo que puede obtener ventajas de rendimiento si optimiza la implementación tanto como sea posible.

IDropSource::GiveFeedback es responsable de cambiar la forma del cursor o de cambiar el origen resaltado en función del valor del parámetro dwEffect . Si usa cursores predeterminados, puede devolver DRAGDROP_S_USEDEFAULTCURSORS, lo que hace que OLE actualice el cursor automáticamente con sus valores predeterminados.

Requisitos

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

IDropTarget