SHDoDragDrop-Funktion (shlobj_core.h)

Artikel
03/06/2024

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)

Freigeben über