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 イベント データのデータ値を確認します。
StartDragAsync メソッドを呼び出すことで、任意の UIElement に対してドラッグ アンド ドロップ アクションを開始できます。 アクションが開始されると、その要素に AllowDrop がtrueされている限り、アプリ内の任意のUIElementがドロップ ターゲットになる可能性があり、ドラッグ ドロップ アクションが渡す要素は DragEnter、DragLeave、または DragOver を処理できます。
Drop はルーティング イベントです。 要素がDropイベント ソースにするには、AllowDrop をtrueする必要があります。 イベントがハンドルされないために親要素にバブル アップすることが許可されている場合、 AllowDrop が親要素に true されている場合は、親要素のイベントを処理できます。 ハンドラー オブジェクトまたはドロップ ターゲットではないルート内の中間要素は、 AllowDrop を trueする必要はありません。 ルーティング イベントの概念の詳細については、「 イベントとルーティング イベントの概要」を参照してください。
タッチ アクション、ドラッグ ドロップ アクション、およびタッチ アクションの結果となる操作固有のイベントや操作イベントの場合、イベント ソースとしてアクションに関連付けられているイベントを起動するには、要素をヒット テストで表示する必要があります。 UIElement.Visibility は Visible である必要があります。 派生型の他のプロパティも、 IsEnabled などのヒット テストの可視性に影響します。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
Drop では、イベントのイベント データが Handled とマークされている場合でも呼び出されるルートにイベント ハンドラーをアタッチする機能がサポートされています。
AddHandler を参照してください。
特定のWindows ランタイム コントロールには、Drop イベントに対するクラスベースの処理が含まれる場合があります。 その場合、コントロールのロジックには、 OnDrop メソッドのオーバーライドが含まれている可能性があります。 通常、イベントはクラス ハンドラーによって処理済みとしてマークされ、 Drop イベントは、そのコントロールのユーザー コード ハンドラーによる処理のために発生しません。 詳しくは、「イベントとルーティング イベントの概要」をご覧ください。
イベントの発生とは無関係に、一部のコントロールでは DragItemThemeAnimation などのテーマ アニメーションを使用して、ユーザーへのドラッグ動作を視覚的に示すことができます。