コントロール - StartDragイベント
StartDragはマウスをドラッグした時に実行されます
コントロール (PRIM_CTRL) のメンバ
パラメータ
名前 | タイプ | データタイプ | 記述 |
|---|---|---|---|
Source | *Input | ドラッグ処理を開始したコンポーネントへの参照 | |
Payload | *Both | ドラッグアンドドロップ処理でデータを引き渡すために使用できるジェネリックのオブジェクト | |
Continue | *Both | ブール値 | FALSEに設定して、ドラッグアンドドロップ処理を停止 |
DragList | *Both | ドラッグ時カーソルやイメージの変更に使用されたドラッグリストのインスタンスを提供 | |
AggregatedSource | *Input | ドラッグスタイルがAggregatedの時、ドラッグ処理を開始したコンポーネントへの参照 | |
Origin | *Input | イベントが最初に起動されたコントロールへの参照 | |
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