Share via


CView::OnDragEnter

Chiamato dal framework quando il mouse viene portato all'area non di scorrimento della finestra di destinazione di rilascio.

virtual DROPEFFECT OnDragEnter(
   COleDataObject* pDataObject,
   DWORD dwKeyState,
   CPoint point 
);

Parametri

  • pDataObject
    Punta a COleDataObject trascinato nell'area di destinazione della visualizzazione.

  • dwKeyState
    Contiene lo stato dei tasti di modifica.Questa è una combinazione di un numero qualsiasi delle seguenti operazioni: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTONe MK_RBUTTON.

  • point
    La posizione corrente del mouse all'area client della visualizzazione.

Valore restituito

Un valore da DROPEFFECT ha il tipo enumerato, che indica il tipo di trascinamento che viene verificato se l'utente rilasciasse l'oggetto in questa posizione.Il tipo di trascinamento in genere dipende dallo stato del tasto corrente visualizzata da dwKeyState.Un mapping standard di keystates i valori DROPEFFECT è:

  • DROPEFFECT_NONE l'oggetto dati non può essere rilasciato in questa finestra.

  • DROPEFFECT_LINK per MK_CONTROL | MK_SHIFT crea un collegamento tra l'oggetto e il server.

  • DROPEFFECT_COPY per MK_CONTROL crea una copia dell'oggetto rilasciato.

  • DROPEFFECT_MOVE per MK_ALT crea una copia dell'oggetto rilasciato ed elimina l'oggetto originale.Si tratta in genere l'effetto di rilascio predefinito, quando la visualizzazione può accettare questo oggetto dati.

Per ulteriori informazioni, vedere l'esempio OCLIENTdi concetti avanzati MFC.

Note

L'implementazione predefinita prevede di non eseguire alcuna operazione e restituire DROPEFFECT_NONE.

Eseguire l'override di questa funzione per preparare le chiamate successive alla funzione membro OnDragOver.Tutti i dati richiesti dall'oggetto dati devono essere recuperati nel tempo per un utilizzo successivo nella funzione membro OnDragOver.La visualizzazione deve essere aggiornata attualmenteutente feedback visivo.Per ulteriori informazioni, vedere l'articolo Trascinamento della selezione: Implementare una destinazione di rilascio.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe di modello CView

Grafico della gerarchia

CView::OnDragOver

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragEnter