Metodo IDropSource::GiveFeedback (oleidl.h)
Consente a un'applicazione di origine di fornire commenti e suggerimenti visivi all'utente finale durante un'operazione di trascinamento fornendo alla funzione DoDragDrop un valore di enumerazione che specifica l'effetto visivo.
Sintassi
HRESULT GiveFeedback(
[in] DWORD dwEffect
);
Parametri
[in] dwEffect
Il valore DROPEFFECT restituito dalla chiamata più recente a IDropTarget::D ragEnter, IDropTarget::DragOver o IDropTarget::D ragLeave.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Altri valori possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
Indica il completamento corretto del metodo e richiede a OLE di aggiornare il cursore usando i cursori predefiniti forniti da OLE. |
Commenti
Quando l'applicazione rileva che l'utente ha avviato un'operazione di trascinamento e rilascio, deve chiamare la funzione DoDragDrop . DoDragDrop entra in un ciclo, chiamando IDropTarget::D ragEnter quando il mouse entra prima in una finestra di destinazione di rilascio, IDropTarget::D ragOver quando il mouse cambia la sua posizione all'interno della finestra di destinazione e IDropTarget::D ragLeave quando il mouse lascia la finestra di destinazione.
Per ogni chiamata a IDropTarget::D ragEnter o IDropTarget::D ragOver, DoDragDrop chiama IDropSource::GiveFeedback, passandolo il valore DROPEFFECT restituito dalla chiamata di destinazione di rilascio.
DoDragDrop chiama IDropTarget::D ragLeave quando il mouse ha lasciato la finestra di destinazione. DoDragDrop chiama quindi IDropSource::GiveFeedback e passa il valore di DROPEFFECT_NONE nel parametro dwEffect.
Il parametro dwEffect può includere DROPEFFECT_SCROLL, che indica che l'origine deve inserire la variazione di scorrimento di trascinamento del puntatore appropriato.
Note per gli implementatori
Questa funzione viene chiamata spesso durante il ciclo DoDragDrop , in modo da ottenere vantaggi per le prestazioni se si ottimizza l'implementazione il più possibile.IDropSource::GiveFeedback è responsabile della modifica della forma del cursore o della modifica dell'origine evidenziata in base al valore del parametro dwEffect . Se si usano i cursori predefiniti, è possibile restituire DRAGDROP_S_USEDEFAULTCURSORS, che causa l'aggiornamento del cursore da parte di OLE, usando le impostazioni predefinite.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | oleidl.h |