INameSpaceTreeControlDropHandler::OnDragEnter-Methode (shobjidl.h)

Wird bei der Zieheingabe aufgerufen, um den Zieheffekt wie angegeben festzulegen.

Syntax

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

Parameter

[in] psiOver

Typ: IShellItem*

Ein Zeiger auf eine IShellItem-Schnittstelle , die das Element unter dem Mauscursor darstellt. Optional.

[in] psiaData

Typ: IShellItemArray*

Ein Zeiger auf ein IShellItem-Array , das die zu ziehenden Elemente enthält.

[in] fOutsideSource

Typ: BOOL

Gibt an, ob das Ziehen außerhalb des Zielbereichs gestartet wurde.

[in] grfKeyState

Art: DWORD

Der aktuelle Status der Tastaturmodifizierertasten.

[in, out] pdwEffect

Typ: DWORD*

Enthält bei Erfolg einen Zeiger auf den Wert des Zieheffekts.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn diese Methode fehlschlägt, wird der Ziehvorgang im Namespacestruktursteuerelement (NSTC) blockiert.

Anforderungen

Weitere Informationen

IDropTarget::D ragEnter

INameSpaceTreeControlDropHandler