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