Freigeben über


SHDoDragDrop-Funktion (shlobj_core.h)

Führt einen Drag-and-Drop-Vorgang aus. Unterstützt die Erstellung von Ziehquellen bei Bedarf sowie das Ziehen von Bildern.

Syntax

SHSTDAPI SHDoDragDrop(
  [in]  HWND        hwnd,
  [in]  IDataObject *pdata,
  [in]  IDropSource *pdsrc,
  [in]  DWORD       dwEffect,
  [out] DWORD       *pdwEffect
);

Parameter

[in] hwnd

Typ: HWND

Das Handle des Fensters, das zum Abrufen des Ziehbilds verwendet wird. Dieser Wert kann NULL sein. Weitere Informationen finden Sie unter Hinweise.

[in] pdata

Typ: IDataObject*

Ein Zeiger auf die IDataObject-Schnittstelle für ein Datenobjekt, das die gezogenen Daten enthält.

[in] pdsrc

Typ: IDropSource*

Ein Zeiger auf eine Implementierung der IDropSource-Schnittstelle , die für die Kommunikation mit der Quelle während des Ziehvorgangs verwendet wird.

Ab Windows Vista erstellt die Shell, wenn dieser Wert NULL ist, ein Drop Source-Objekt für Sie.

[in] dwEffect

Art: DWORD

Die Auswirkungen, die die Quelle beim Ziehen und Ablegen zulässt. Der wichtigste Effekt ist, ob der Drag-and-Drop-Vorgang eine Verschiebung zulässt. Eine Liste der möglichen Werte finden Sie unter DROPEFFECT.

[out] pdwEffect

Typ: DWORD*

Ein Zeiger auf einen Wert, der angibt, wie sich der Drag-and-Drop-Vorgang auf die Quelldaten auswirkte. Der pdwEffect-Parameter wird nur festgelegt, wenn der Vorgang nicht abgebrochen wird. Eine Liste der möglichen Werte finden Sie unter DROPEFFECT.

Rückgabewert

Typ: HRESULT

Diese Funktion unterstützt den Standardrückgabewert E_OUTOFMEMORY sowie die folgenden Werte:

Rückgabecode Beschreibung
DRAGDROP_S_DROP
Der Drag-and-Drop-Vorgang war erfolgreich.
DRAGDROP_S_CANCEL
Der Drag-and-Drop-Vorgang wurde abgebrochen.
E_UNSPEC
Unerwarteter Fehler.

Hinweise

Wenn ab Windows Vista ein Ziehbild noch nicht im Datenobjekt pdtobj gespeichert ist und ein Ziehbild nicht aus dem durch hwnd angegebenen Fenster abgerufen werden kann, stellt die Shell ein generisches Ziehbild bereit. Ein Ziehbild kann entweder nicht aus dem angegebenen Fenster abgerufen werden, weil hwndNULL ist oder das angegebene Fenster die DI_GETDRAGIMAGE Meldung nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (shlobj.h einschließen)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.0 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)