Compartilhar via


CView::OnDragOver

Chamado pela estrutura durante uma operação de arrastar quando o mouse é movido sobre a janela de destino de soltar.

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

Parâmetros

  • pDataObject
    Aponta para o COleDataObject sendo arrastado sobre o local de destino.

  • 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
    A posição corrente do mouse em relação à área de cliente do modo de exibição.

Valor de retorno

Um valor a partir de DROPEFFECT tipo enumerado, que indica o tipo de soltar que ocorreria se o usuário cancelado o objeto nesta posição. O tipo de soltar geralmente depende o estado corrente de chave conforme indicado pelo dwKeyState. Um mapeamento padrão do keystates para DROPEFFECT valores é:

  • DROPEFFECT_NONE   Não é possível descartar o objeto de dados nessa janela.

  • DROPEFFECT_LINK para MK_CONTROL | MK_SHIFT   Cria um vínculo entre o objeto e seu servidor.

  • DROPEFFECT_COPY para MK_CONTROL   Cria uma cópia do objeto descartada.

  • DROPEFFECT_MOVE para MK_ALT   Cria uma cópia do objeto ignorado e exclua o objeto original.Isso é normalmente o efeito de soltar padrão, quando o modo de exibição pode aceitar o objeto de dados.

Para obter mais informações, consulte o exemplo de conceitos avançados do MFC OCLIENT.

Comentários

A implementação padrão é não fazer nada e retornar DROPEFFECT_NONE.

Substitua esta função para dar o comentário visual do usuário durante a operação de arrastar.sistema autônomo essa função é chamada continuamente, qualquer código contido dentro dele deve ser otimizado tanto quanto possível.Para obter mais informações, consulte o artigo Arrastar e soltar: Implementando um destino de soltar.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CView

Gráfico de hierarquia

CView::OnDragEnter

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragOver

Outros recursos

CView membros