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