IDropTarget_DragOver

ユーザーにターゲットフィードバックを提供し、ドロップの効果を DoDragDrop 関数に伝えることで、ドロップの効果をソースに伝達させる。

IDropTarget_DragOver this, grfKeyState, pt, pdwEffect

this : [comobj] IDropTarget インターフェースの COM オブジェクト変数
grfKeyState : [int] キーボード上の修飾キーの現在の状態。有効な値は MK_CONTROL、MK_SHIFT、MK_ALT、MK_BUTTON、MK_LBUTTON、MK_MBUTTON、MK_RBUTTON のいずれかの組み合わせである。
pt : [int] 現在のカーソル位置をスクリーン座標で含む POINTL 構造体。
pdwEffect : [var] 入力時は DoDragDrop 関数の pdwEffect パラメーターの値へのポインター。戻り時はドロップ操作の結果を示す DROPEFFECT フラグのいずれかを含まなければならない。

(プラグイン / モジュール : com_misc.dll)

解説

ユーザーにターゲットフィードバックを提供し、ドロップの効果を DoDragDrop
関数に伝えることで、ドロップの効果をソースに伝達させる。

[戻り値]
成功時は S_OK を返す。その他の値には以下のものが含まれる。
(以下省略)

[備考]
DragOver を直接呼び出すことはない。DoDragDrop
関数はユーザーが指定したターゲットウィンドウ上でマウスを動かすたびにこのメソッドを呼び出す。ドラッグ&ドロップ操作がキャンセルされた場合、マウスがターゲットウィンドウから出た場合、またはドロップが完了した場合に
DoDragDrop はループを抜ける。IDropTarget::DragOver を実装する際は
IDropTarget::DragEnter
と同様の機能を提供しなければならない。ドロップの効果は、データオブジェクトの形式とメディウムを定義する FORMATETC
と修飾キーの状態を調べて判定しなければならない。マウス位置もドロップの効果を決定するのに使われることがある。以下の修飾キーはドロップの結果に影響する。
(以下省略)

情報

プラグイン / モジュールcom_misc.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の com_misc.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_com_misc_gen2.hs