UIElement.Drop イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
入力システムがこの要素をドロップ先とするドロップ イベントを報告したときに発生します。
public:
virtual event DragEventHandler ^ Drop;// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler Drop;function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;Public Custom Event Drop As DragEventHandler <uiElement Drop="eventhandler"/>
イベントの種類
注釈
Drop を実行し、ハンドラーを呼び出すには、ドロップ ターゲットである UIElement の AllowDrop の値と、ドラッグ ドロップ アクション ソースの AllowDrop の値が true である必要があります。
一般的なハンドラーは、DragEventArgs イベント データから Data 値をチェックします。
StartDragAsync メソッドを呼び出すことで、任意の UIElement でドラッグ ドロップ アクションを開始できます。 アクションが開始されると、アプリ内のすべての UIElement がその要素に 対して AllowDrop が true である限り、ドロップ ターゲットになる可能性があり、ドラッグ ドロップ アクションが渡す要素は DragEnter、 DragLeave 、または DragOver を処理できます。
Drop はルーティング イベントです。 Drop イベント ソースにするには、 要素に AllowDrop が true である必要があります。 イベントが未処理であるために親要素にバブルアップすることが許可されている場合は、親要素で AllowDrop が true の 場合、親要素のイベントを処理できます。 ハンドラー オブジェクトまたはドロップ ターゲットではないルート内の中間要素では、 AllowDrop を true にする必要はありません。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ アクション、ドラッグ ドロップ アクション、およびタッチ アクションの結果である対話式操作固有または操作イベントの場合、イベント ソースとしてアクションに関連付けられたイベントを発生させるには、要素をヒット テストで表示する必要があります。 UIElement.Visibility はVisible である必要があります。 派生型の他のプロパティも、 IsEnabled などのヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
Drop では、イベントのイベント データが Handled とマークされている場合でも、呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。 「 AddHandler」を参照してください。
特定のWindows ランタイム コントロールには、Drop イベントのクラスベースの処理が含まれる場合があります。 その場合、コントロールのロジックには、 OnDrop メソッドのオーバーライドが含まれている可能性があります。 通常、イベントはクラス ハンドラーによって処理済みとしてマークされ、Drop イベントは、そのコントロールのユーザー コード ハンドラーによって処理するために発生しません。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
イベント発生とは無関係に、一部のコントロールでは DragItemThemeAnimation などのテーマ アニメーションを使用して、ユーザーへのドラッグ動作を視覚的に示す場合があります。
Windows 8/Windows 8.1 Windows 10より前のバージョンでは、ドラッグ ドロップの概念のWindows ランタイム実装では、特定のコントロールと入力アクションのみがドラッグ ドロップ アクションを開始できます。 Ui 要素がドラッグ ドロップ アクションを開始できるようにする StartDragAsync メソッドまたは一般化された DoDragDrop メソッドはありません。 アプリのドラッグ ドロップ アクションのメインソースは、GridView などのリストの項目をドラッグする場合です。