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

イメージのドラッグを開始します。

構文

HRESULT BeginDrag(
  [in] int iTrack,
  [in] int dxHotspot,
  [in] int dyHotspot
);

パラメーター

[in] iTrack

型: int

ドラッグするイメージのインデックスを含む int 型の値。

[in] dxHotspot

型: int

画像の左上隅を基準としたドラッグ位置の x 成分を含む int 型の値。

[in] dyHotspot

型: int

画像の左上隅を基準としたドラッグ位置の y 成分を含む int 型の値。

戻り値

型: HRESULT

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

注釈

IImageList::BeginDrag は、ドラッグに使用される一時的なイメージ リストを作成します。 後続 のWM_MOUSEMOVE メッセージに応答して、 IImageList::D ragMove を使用してドラッグ イメージを移動できます。 ドラッグ操作を終了するには、 IImageList::EndDrag を使用します。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	commoncontrols.h
[DLL]	Comctl32.dll (バージョン 6.0 以降)