COleServerItem::DoDragDrop

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

更新 : 2007 年 11 月

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

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

パラメータ

lpRectItem
アイテムの画面上での長方形。クライアント領域からの相対位置をピクセル単位で表します。
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」を参照してください。