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