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