StartDrag

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

StartDragはマウスをドラッグした時に実行されます。

パラメータ

名前	タイプ	データタイプ	記述
Source	*Input	PRIM_CTRL	ドラッグ処理を開始したコンポーネントへの参照
Payload	*Both	PRIM_OBJT	ドラッグアンドドロップ処理でデータを引き渡すために使用できるジェネリックのオブジェクト
Continue	*Both	ブール値	FALSEに設定して、ドラッグアンドドロップ処理を停止
DragList	*Both	PRIM_DGLT	ドラッグ時カーソルやイメージの変更に使用されたドラッグリストのインスタンスを提供
AggregatedSource	*Input	PRIM_CTRL	ドラッグスタイルがAggregatedの時、ドラッグ処理を開始したコンポーネントへの参照
Origin	*Input	PRIM_CTRL	イベントが最初に起動されたコントロールへの参照
Handled	*Both	ブール値	TRUEに設定して、イベントが親のコントロールに伝達されないようにします。

詳細

StartDrag イベントは、ドラッグアンドドロップ処理が開始されると発生します。
 
これは、ドラッグアンドドロッププロセスの １ 番目のイベントです。 それは、 StartDrag、DragOver、 DragDrop および EndDrag になります。
 
StartDrag は、汎用ペイロードオブジェクト移入したり、 DragList パラメーターを介してドラッグカーソルを設定するために使用されるどのような情報も設定したりするために使われています。
 
StartDrag は、ドラッグされているコントロールに DragStyle プロパティが Automatic または Aggregated の場合にのみ起動します。
 
Payload パラメーターは、ドラッグされているデータの性質に関する情報を格納できる汎用的な領域を提供します。ペイロード・インスタンスは、4回のドラッグ・アンド・ドロップ・イベントごとに使用可能になります。

例

この例では、 customerlist がドラッグされています。Customer データオブジェクトは、リストアイテムの RelatedReference として格納され、これがペイロードとして使用されます。

Evtroutine Handling(#CustomerList.StartDrag) Payload(#Payload)
 
   #Payload <= #CustomerList.FocusItem.RelatedReference
 
 Endroutine

参照

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

テクニカルリファレンス

EPC150060 - December 2023