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