CView:: OnDropEx

virtual DROPEFFECT OnDropEx ( COleDataObject * pDataObject, DROPEFFECT dropDefault, DROPEFFECT limpem, CPoint ponto );

Valor de retorno

O efeito de soltar que resultou da tentativa de soltar no local especificado por ponto. Isso deve ser um dos valores indicados pela dropEffectList. Efeitos de soltar são discutidos na seção Comentários.

Parâmetros

pDataObject

Aponta para o COleDataObject que é Descartado para o destino de soltar.

dropDefault

O efeito que o usuário escolheu para a operação de soltar padrão baseada no estado chave atual. Pode ser DROPEFFECT_NONE. Efeitos de soltar são discutidos na seção Comentários.

limpem

Uma lista de efeitos de soltar que ofereça suporte a origem de soltar. Soltar efeito valores podem ser combinados com o bit a bit ou operação (|). Efeitos de soltar são discutidos na seção Comentários.

ponto

A posição atual do mouse relativo à área de cliente do Exibir.

Observações

Chamado pela estrutura quando o usuário libera um objeto de dados sobre um destino de soltar válidos. A implementação padrão é para não fazer nada e retornar um valor fictício (-1) para indicar que o quadro deve chamar o manipulador de OnDrop.

Substituir esta função para implementar o efeito de um direito do mouse-botão arrastar e soltar. Direito do mouse-botão arrastar e soltar normalmente exibe um menu de opções quando o botão do mouse direito é liberado.

Sua Substituir de OnDropEx deve consultar para o botão do mouse direito. Você pode chamar GetKeyState ou armazenar o estado do botão direito do mouse do seu manipulador de OnDragEnter.

• Se o direito do mouse-botão para baixo, a substituir deve exibir um menu pop-up que oferece que os efeitos de soltar suportam pela origem de soltar.
  • Examine dropList para determinar os efeitos de soltar suportados pela origem de soltar. Permitir somente essas ações no menu pop-up.
    
    
  • Uso SetMenuDefaultItem para definir a ação padrão com base em dropDefault.
    
    
  • Finalmente, execute a ação indicada pela seleção do usuário no menu pop-up.
• Se não houver o direito do mouse-botão para baixo, a substituir deve tratar isso como um pedido de soltar padrão. Use o Soltar efeito especificado em dropDefault. Alternativamente, sua Substituir pode retornar o valor fictício (-1) para indicar que OnDrop tratará esta operação de soltar.

Use pDataObject para examinar o COleDataObject para Formatarar de dados de área de transferência e dados ignorados no ponto especificado.

Efeitos de soltar descrevem a ação associada a uma operação de soltar. Consulte a seguinte lista de efeitos de soltar:

• DROPEFFECT_&NONEnbsp;  Uma gota não seria permitida.
  
  
• DROPEFFECT_COPY   Uma operação copiar deve ser executada.
  
  
• DROPEFFECT_MOVE   Um mover operação deve ser executada.
  
  
• DROPEFFECT_LI&NKnbsp;  Seria estabelecido um link de dados ignorados para os dados originais.
  
  
• DROPEFFECT_SCROLL   Indica que uma operação de rolagSobre arrastar está prestes a ocorrer ou está ocorrendo de destino.

Para obter mais informações sobre como definir o comando de menu padrão, consulte SetMenuDefaultItem na documentação do Win32 e CMenu::GetSafeHmenu neste volume.

Visão geral de CView |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CView::OnDragEnter, CView::OnDragOver, CView::OnDrop, CView::OnDragLeave, COleDropTarget:: OnDropEx