CView::OnDragEnter

Chamado pela estrutura quando o mouse entra primeiro a região sem rolagem da janela de destino soltar.

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

Parâmetros

  • pDataObject
    Aponta para o COleDataObject sendo arrastada para a área de soltar do modo de exibição.

  • 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
    Mouse posição corrente 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 do estado corrente de chave indicado por 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 esse objeto de dados.

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

Comentários

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

Substituir esta função para preparar para futuras chamadas para o OnDragOverfunção de membro .Todos os dados necessários do objeto de dados devem ser recuperados neste time para uso posterior no OnDragOver função de membro. O modo de exibição também deve ser atualizado no momento para dar o comentário visual do usuário.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::OnDragOver

CView::OnDrop

CView::OnDropEx

CView::OnDragLeave

COleDropTarget::OnDragEnter

Outros recursos

CView membros