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