COleDropTarget::OnDragOver

Artigo
08/25/2010

Chamado pela estrutura quando o cursor é arrastado sobre a janela.

virtual DROPEFFECT OnDragOver(
   CWnd* pWnd,
   COleDataObject* pDataObject,
   DWORD dwKeyState,
   CPoint point 
);

Parâmetros

pWnd
Aponta para a janela que o cursor está sobre.
pDataObject
Aponta para o objeto de dados que contém os dados sejam descartados.
dwKeyState
Contém o estado de teclas modificadoras.Isso é uma combinação de qualquer número das seguintes opções: MK_CONTROL, MK_SHIFT, MK_ALT, MK_LBUTTON, MK_MBUTTON, and MK_RBUTTON.
point
Contém o local corrente do cursor nas coordenadas do cliente.

Valor de retorno

O efeito resultar se uma operação de soltar foram tentada no local especificado por point. Ele pode ser um ou mais dos seguintes procedimentos:

DROPEFFECT_NONE Uma operação de soltar não teria permissão.
DROPEFFECT_COPY Uma operação de cópia seria realizada.
DROPEFFECT_MOVE Seria realizada uma operação de movimentação.
DROPEFFECT_LINK Seria possível estabelecer um link de dados ignorados para os dados originais.
DROPEFFECT_SCROLL Indica que uma operação arrastar e rolar está prestes a ocorrer ou se está ocorrendo no destino.

Comentários

Esta função deve ser substituída para permitir operações de soltar ocorrer na janela.A implementação padrão dessa função chama CView::OnDragOver, que retorna DROPEFFECT_NONE Por padrão. Porque esta função é chamada com freqüência durante uma operação de do tipo arrastar e soltar, deve ser otimizada sistema autônomo muito sistema autônomo possíveis.

Para obter mais informações, consulte IDropTarget::DragOver in the Windows SDK.

Exemplo

DROPEFFECT COleContainerView::OnDragOver(COleDataObject* pDataObject, 
   DWORD dwKeyState, CPoint point)
{
   UNREFERENCED_PARAMETER(pDataObject);
   UNREFERENCED_PARAMETER(point);

   DROPEFFECT de = DROPEFFECT_NONE;
   //Determine the type of operation
   if((dwKeyState & MK_SHIFT) && (dwKeyState & MK_CONTROL))
      de = DROPEFFECT_LINK;
   else if(dwKeyState &  MK_CONTROL)
      de = DROPEFFECT_COPY;
   else if(dwKeyState & MK_SHIFT)
      de = DROPEFFECT_MOVE;
   return de;
}