CView::OnDropEx

Chamado pela estrutura quando o usuário libera um objeto de dados sobre um destino de soltar válidas.

virtual DROPEFFECT OnDropEx(
   COleDataObject* pDataObject,
   DROPEFFECT dropDefault,
   DROPEFFECT dropList,
   CPoint point 
);

Parâmetros

  • pDataObject
    Aponta para o COleDataObject que o destino de soltar é solto.

  • dropDefault
    O efeito que o usuário escolheu para a operação de soltar padrão com base no estado corrente de chave.Pode ser DROPEFFECT_NONE. Soltar efeitos são discutidos na seção comentários.

  • dropList
    Lista os efeitos de soltar fonte de soltura oferece suporte.Valores de efeito de posicionamento podem ser combinados no (OR bit a bit**|**) operação.Soltar efeitos são discutidos na seção comentários.

  • point
    A posição corrente do mouse em relação à área de cliente do modo de exibição.

Valor de retorno

O efeito de soltar que resultou da tentativa de soltar no local especificado por point. Isso deve ser um dos valores indicados por dropEffectList.Soltar efeitos são discutidos na seção comentários.

Comentários

A implementação padrão é não fazer nada e retornar um valor fictício (-1) para indicar que a estrutura deve telefonar o OnDrop manipulador.

Substitua esta função para implementar o efeito de um botão do mouse à direita arrastar e soltar.À direita do botão do mouse arrastar e soltar normalmente exibe um menu de opções quando o botão do mouse à direita é liberado.

A substituir de OnDropEx deve consultar para o botão direito do mouse. Você pode telefonar GetKeyState ou armazenamento o estado de mouse-botão direito do seu OnDragEnter manipulador.

  • Se o botão direito do mouse estiver inoperante, sua substituir deve exibir um menu pop-up que oferece que suporte os efeitos de soltar, fonte de soltura.

    • Examinar dropList para determinar o efeito de soltar, suportado fonte de soltura. Permitir somente essas ações no menu pop-up.

    • Use SetMenuDefaultItem para conjunto a ação padrão com base em dropDefault.

    • Por fim, execute a ação indicada pela seleção do usuário no menu pop-up.

  • Se o botão direito do mouse não está inativo, sua substituir deve processar isso sistema autônomo uma solicitação de soltar padrão.Use o efeito de lista especificado em dropDefault. Como alternativa, a substituir pode retornar o valor fictício (-1) para indicar que OnDrop irá lidar com essa operação de soltar.

Use pDataObject para examinar a COleDataObject para dados da área de transferência formato e os dados descartados no ponto especificado.

Soltar efeitos descrevem a ação associada a uma operação de soltar.Consulte a lista a seguir de soltar efeitos:

  • 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.

Para obter mais informações sobre como definir o comando de menu padrão, consulte SetMenuDefaultItem in the Windows SDK e CMenu::GetSafeHmenu neste volume.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CView

Gráfico de hierarquia

CView::OnDragEnter

CView::OnDragOver

CView::OnDrop

CView::OnDragLeave

COleDropTarget::OnDropEx

Outros recursos

CView membros