IImageList::GetDragImage メソッド (commoncontrols.h)

ドラッグイメージに使用される一時的なイメージリストを取得します。また、現在のドラッグ位置と、その位置を基準とするドラッグ画像のオフセットも、この関数で取得されます。

構文

HRESULT GetDragImage(
  [out] POINT  *ppt,
  [out] POINT  *pptHotspot,
  [out] REFIID riid,
  [out] void   **ppv
);

[out] ppt

種類: POINT*

現在のドラッグ位置を受け取る POINT 構造体へのポインター。 NULL を指定できます。

[out] pptHotspot

種類: POINT*

ドラッグ位置に対するドラッグイメージのオフセットを受け取る POINT 構造体へのポインター。 NULL を指定できます。

[out] riid

型: REFIID

イメージリストの IID。

[out] ppv

種類: PVOID*

成功した場合はイメージリストのインターフェイスへのポインターのアドレス。それ以外の場合は NULL 。

型: HRESULT

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

IImageList::EndDrag が呼び出されると、一時イメージリストが破棄されます。ドラッグ操作を開始するには、 IImageList::BeginDrag を使用します。

IImageList::GetDragImage を使用するには、マニフェスト Comctl32.dll バージョン 6 を指定します。マニフェストの詳細については、「ビジュアルスタイルの有効化」を参照してください。