Drop

ドラッグ/ドロップによる転送操作中に、データがターゲット上にドロップされたときに発生するイベント。DataTransferSourceSet および「ドラッグアンドドロップ」を参照してください。

説明

このイベントは、転送されたデータを見て、このターゲットに適切な DropResult は何かを判断することにより処理されます。

これは通常、このイベントに対するハンドラの中で、Drop.accept-drop を呼び出すことにより行われます。

あるいは、Drop.dss を見て、DataTransferSource.signal-dropped を呼び出した後に GuiManager.report-drag-drop-effect を呼び出すことによっても処理できます。

新しい Drop オブジェクトを作成します。

1 つのデータソースのこのターゲット上へのドロップを処理する、指定されたプロシージャの呼び出しを、DragOver.dss 内のデータに対して繰り返します。

プログラミング注意事項

このメソッドは、Drop イベントハンドラから呼び出されます。

accept-drop-proc: 1 つのデータオブジェクトのドロップを扱う、指定されたプロシージャ。このプロシージャは、パラメータを参照してドロップを適切に処理するよう作成する必要があります。

パラメータ：

ドロップされたデータ。
ポインタの X 座標と Y 座標。
データソースにより指定された DragEffect。

このプロシージャは、実際のドロップで発生するアクションを指定する DropResult を返す必要があります。

たとえば、ターゲットが "copy" で String を受け取る場合、プロシージャは次のようになります。

{on e:Drop do
    {e.accept-drop
        {proc {a:any, x:Distance, y:Distance, effect:#DragEffect}:DropResult
            {if {effect.has-effect "copy"} then
                {return
                    {DropResultMove
                        action={proc {}:void
                                   {output "Dropping: ", a}
                               }}}
             else
                {return {DropResultNone}}
            }
        }
    }
}

例

「ドラッグアンドドロップ」を参照してください。

この Event のスタティックイベントハンドラを起動します。

target: この Event を処理する GuiEventTarget。

プログラミング注意事項

このメソッドは、この Event のスタティックイベントハンドラを呼び出すときに、GuiEventTarget.handle-event によって呼び出されます。このメソッドは、適切なスタティックイベントハンドラがすべて呼び出された後に返します。

オーバーライド

このメソッドは、それ自身のスタティックイベントハンドラに関連付けられた Event のすべてのサブクラスでオーバーライドされます。E クラスで定義されたオーバーライドメソッドは、次のテンプレートに従う必要があります。

{method protected {fire-methods target:GuiEventTarget}:void
    {target.on-E self}
    {super.fire-methods target}
}

ここで、on-E は E クラスに関連付けられたスタティックイベントハンドラ名です。fire-methods 内のメソッド呼び出しは、Curl 言語のスタティックイベントハンドラ呼び出し順位の規則 (最も用途の特定されたものから最も一般的な用途のもの) に従って順序付ける必要があります。