DragOver

イベントコントロール - DragOver

カーソルがコントロールの上を移動するドラッグアンドドロップ処理中に起動されます。

パラメータ

名前	タイプ	データタイプ	記述
PosX	*Input	整数	カーソルの縦方向の位置(ピクセル)
PosY	*Input	整数	カーソルの横方向の位置(ピクセル)
Source	*Input	PRIM_CTRL	ドラッグ処理が始められたコンポーネントへの参照
Payload	*Input	PRIM_OBJT	ドラッグアンドドロップ処理でデータを引き渡すために使用できるジェネリックのオブジェクト
DragState	*Input	列挙	DragOverEventのドラッグ状態
AcceptDrop	*Both	ブール値	DragOverEventのドロップ許可
DragCursor	*Both	PRIM_CRSR	DragOverEventのドラッグカーソル
ShowDropHilight	*Both	ブール値	DragOverEventのドロップハイライト表示
AggregatedSource	*Input	PRIM_CTRL	ドラッグスタイルがAggregatedの時、ドラッグ処理を開始したコンポーネントへの参照
Origin	*Input	PRIM_CTRL	イベントが最初に起動されたコントロールへの参照
Handled	*Both	ブール値	TRUEに設定して、イベントが親のコントロールに伝達されないようにします。

詳細

DragOver イベントは、マウスをコントロールにドラッグすると発生します。
 
これは、ドラッグアンドドロッププロセスの 2 番目のイベントです。 StartDrag、 DragOver、 DragDrop、 EndDrag などにあたります。
 
DragOver は、マウスがコントロール内を移動する際に繰り返し作動します。
 
Windows エクスプローラなどの外部ドラッグアンドドロップは、 #sys_appln.AllowWindowsDragDrop プロパティと FilePaths オブジェクトを使用して、サポートされています。
 
DragState パラメータには、ドラッグの性質に関する情報が含まれます。

DragState の値

列挙値	説明
Enter	カーソルがコントロールの範囲内に入った
Exit	カーソルがコントロールの範囲を離れた
Hover	カーソルがコントロールの範囲内で静止している
Move	カーソルがコントロールの上を移動している

例

この例では、 CustomerList が DragOver を起動すると、ペイロードがチェックされ、ユーザー定義の Customer データオブジェクトかどうかが確認されます。そうでない場合、ドラッグイベントは続行できません。

Evtroutine Handling(#CustomerList.DragOver) AcceptDrop(#AcceptDrop) Payload(#Payload)
 
   #AcceptDrop := (#Payload *Is #DataCustomer)
 
 Endroutine

参照

すべてのコンポーネントクラス

テクニカルリファレンス

EPC150060 - December 2023