CImageList::BeginDrag

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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

BOOL BeginDrag(
   int nImage,
   CPoint ptHotSpot 
);

パラメータ

nImage
ドラッグするイメージの 0 から始まるインデックス。
ptHotSpot
ドラッグが開始される位置 (通常はカーソル位置) の座標。座標はイメージの左上隅からの相対です。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ドラッグに使う一時的なイメージリストを作成します。イメージは、指定されたイメージとマスクを現在のカーソルと組み合わせたものです。これに続く WM_MOUSEMOVE メッセージに応答して、DragMove メンバ関数を呼び出し、ドラッグイメージを移動できます。ドラッグ操作を終了するには、EndDrag メンバ関数を使います。

使用例

void CImageListDlg::OnLButtonDown(UINT nFlags, CPoint point)
{
   // Initialize the drag image (usually called from WM_LBUTTONDOWN).
   m_myImageList.BeginDrag(0, CPoint(0, 0));
   m_myImageList.DragEnter(this, point);

   CDialog::OnLButtonDown(nFlags, point);
}