IDragSourceHelper::InitializeFromWindow-Methode (shobjidl_core.h)

  • Artikel

Initialisiert den Drag-Image-Manager für ein Steuerelement mit einem Fenster.

Syntax

HRESULT InitializeFromWindow(
  [in] HWND        hwnd,
  [in] POINT       *ppt,
  [in] IDataObject *pDataObject
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das Fenster, das die DI_GETDRAGIMAGE-Nachricht empfängt. Dieser Wert kann NULL sein.

[in] ppt

Typ: POINT*

Ein Zeiger auf eine POINT-Struktur , die die Position des Cursors im Ziehbild angibt. Die -Struktur sollte den Offset von der oberen linken Ecke des Bilds an die Position des Cursors enthalten. Dieser Wert kann NULL sein.

[in] pDataObject

Typ: IDataObject*

Ein Zeiger auf die IDataObject-Schnittstelle des Datenobjekts.

Rückgabewert

Typ: HRESULT

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

Hinweise

Mit der meldung DI_GETDRAGIMAGE können Sie ein Bild aus einem benutzerdefinierten Steuerelement ziehen. Es ist in Shlobj.h definiert und muss bei RegisterWindowMessage registriert werden. Wenn das von hwnd angegebene Fenster die DI_GETDRAGIMAGE Meldung empfängt, enthält der lParam-Wert einen Zeiger auf eine SHDRAGIMAGE-Struktur . Der Handler sollte die Struktur mit den Bitmapinformationen zum Ziehen des Bilds füllen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IDragSourceHelper