Método INameSpaceTreeControlDropHandler::OnDragEnter (shobjidl.h)

Chamado em arrastar enter para definir o efeito de arrastar, conforme especificado.

Sintaxe

HRESULT OnDragEnter(
  [in]      IShellItem      *psiOver,
  [in]      IShellItemArray *psiaData,
  [in]      BOOL            fOutsideSource,
  [in]      DWORD           grfKeyState,
  [in, out] DWORD           *pdwEffect
);

Parâmetros

[in] psiOver

Tipo: IShellItem*

Um ponteiro para uma interface IShellItem que representa o item abaixo do cursor do mouse. Opcional.

[in] psiaData

Tipo: IShellItemArray*

Um ponteiro para uma matriz IShellItem que contém os itens que estão sendo arrastados.

[in] fOutsideSource

Tipo: BOOL

Especifica se o arraste foi iniciado fora da área de destino.

[in] grfKeyState

Tipo: DWORD

O estado atual das teclas modificadoras de teclado.

[in, out] pdwEffect

Tipo: DWORD*

Em caso de êxito, contém um ponteiro para o valor do efeito de arrastar.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Falha nesse método bloqueia a operação de arrastar no NSTC (controle de árvore de namespace).

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl.h

Confira também

IDropTarget::D ragEnter

INameSpaceTreeControlDropHandler