COleClientItem::DoDragDrop

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

更新 : 2007 年 11 月

ドラッグアンドドロップ操作を行います。

DROPEFFECT DoDragDrop(
   LPCRECT lpItemRect,
   CPoint ptOffset,
   BOOL bIncludeLink = FALSE,
   DWORD dwEffects = DROPEFFECT_COPY | DROPEFFECT_MOVE,
   LPCRECT lpRectStartDrag = NULL 
);

パラメータ

lpItemRect
クライアント座標 (ピクセル単位) で、アイテムの画面上の長方形。
ptOffset
ドラッグ時のマウスの位置を示す lpItemRect からのオフセット。
bIncludeLink
リンクデータをクリップボードにコピーする必要がある場合は TRUE。サーバーアプリケーションがリンクをサポートしていない場合は FALSE。
dwEffects
ドラッグ操作で、ドラッグされる対象で許される効果を決定する値。
lpRectStartDrag
ドラッグを実際に開始する位置を定義する四角形へのポインタ。詳細については、「解説」を参照してください。

戻り値

DROPEFFECT 値を返します。この値が DROPEFFECT_MOVE の場合、元のデータは削除されます。

解説

ドラッグアンドドロップ操作はすぐには始まりません。マウスカーソルが lpRectStartDrag で指定された四角形から離れるまで、または指定されたミリ秒数を経過するまで待機します。lpRectStartDrag が NULL のとき、四角形のサイズは 1 ピクセルです。

遅延時間を指定するには、レジストリキーを設定します。遅延時間を変更するには、CWinApp::WriteProfileString または CWinApp::WriteProfileInt を呼び出します。遅延時間が指定されていない場合、既定値の 200 ミリ秒が使用されます。ドラッグ遅延時間は、以下の場所に保存されます。

Windows NT HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\NT\CurrentVersion\IniFileMapping\win.ini\Windows\DragDelay
Windows 3.x WIN.INI ファイルの [Windows] セクション。
Windows 95/98 WIN.INI のキャッシュ。

ドラッグ遅延時間をレジストリまたは .INI ファイルに保存する方法については、Windows SDK の「WriteProfileString」を参照してください。