IDragSourceHelper

Shell によって公開され、Shell のドラッグアンドドロップ操作中に表示される画像をアプリケーションが指定できるようにします。

このインターフェイスは Shell のドラッグイメージマネージャーによって公開されます。アプリケーションが実装するものではありません。

Shell のドラッグアンドドロップ操作中に表示される画像を指定するには、このインターフェイスを使用します。IDragSourceHelper、IDropTargetHelper、IInitializeWithWindow の各インターフェイスは、IDropTarget インターフェイスがカスタムのドラッグイメージを使用できるよう、ドラッグイメージマネージャーオブジェクトによって公開されます。これらのインターフェイスを使用するには、クラス識別子 (CLSID) に CLSID_DragDropHelper を指定して CoCreateInstance を呼び出し、インプロセスサーバーのドラッグイメージマネージャーオブジェクトを作成する必要があります。インターフェイスポインターは標準的な Component Object Model (COM) の手順を用いて取得します。

IDragSourceHelper インターフェイスは、ドラッグイメージとして使用するビットマップを指定する方法を次の 2 通り提供します。

• ウィンドウを持つコントロールは、そのウィンドウに対して DI_GETDRAGIMAGE ウィンドウメッセージを登録し、IDragSourceHelper::InitializeFromWindow でドラッグイメージマネージャーを初期化できます。DI_GETDRAGIMAGE メッセージを受信すると、ハンドラーはメッセージの lParam 値として渡された SHDRAGIMAGE 構造体にドラッグイメージのビットマップ情報を格納します。
• ウィンドウを持たないコントロールは、IDragSourceHelper::InitializeFromBitmap でドラッグイメージマネージャーを初期化できます。このメソッドを使うと、アプリケーションは単にビットマップを指定するだけで済みます。

ウィンドウを持たないコントロール用にドラッグイメージマネージャーを初期化します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

InitializeFromBitmap はアルファ値の計算時に常に RGB 乗算処理を行うため、アルファブレンディングを事前乗算していないビットマップを常に渡してください。事前乗算済みのアルファブレンディングを持つビットマップを渡してもエラーにはなりませんが、このメソッドは再度乗算を行うため、結果のアルファ値が二重になります。

ウィンドウを持つコントロール用にドラッグイメージマネージャーを初期化します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

DI_GETDRAGIMAGE メッセージを使用すると、カスタムコントロールからドラッグイメージを取得できます。このメッセージは Shlobj.h で定義されており、RegisterWindowMessage で登録する必要があります。hwnd で指定したウィンドウが DI_GETDRAGIMAGE メッセージを受け取ると、lParam 値には SHDRAGIMAGE 構造体へのポインターが格納されます。ハンドラーはこの構造体にドラッグイメージのビットマップ情報を格納する必要があります。