UIElement.DragEnter 事件

定義

命名空間:

Microsoft.UI.Xaml

當輸入系統報告基礎拖曳事件，並將這個專案當做目標時發生。

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"/>

事件類型

DragEventHandler

備註

DragEnter若要發生事件，目前UIElement和事件來源上的AllowDrop值必須是 true 。 否則，請考慮使用 PointerEntered。

您可以藉由呼叫StartDragAsync方法，在任何UIElement上起始拖放動作。 一旦起始動作，只要AllowDrop位於 true 該元素上， UIElement 應用程式中的任何專案都可能會是置放目標。 拖放動作通過的任何元素都可以處理 DragEnter、DragLeave 或 DragOver。

DragEnter 是路由事件。 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。

對於觸控動作、拖放動作，以及觸控動作結果的互動特定或操作事件，元素必須是可見的點擊測試，才能成為事件來源，並引發與動作相關聯的事件。 UIElement.Visibility 必須是 可見的。 衍生型別的其他屬性也會影響點擊測試可見度，例如 IsEnabled。 如需詳細資訊，請參閱事件與路由事件概觀。

DragEnter 支援將事件處理常式附加至將叫用的路由的能力，即使事件的事件資料標示為 Handled也一樣。 請參閱 AddHandler。

特定Windows 執行階段控制項可能會有 DragEnter 事件的類別型處理。 如果是，控制項可能具有 OnDragEnter方法的覆寫。 一般而言，事件會標示為由類別處理常式處理，而且 DragEnter 該控制項上的任何使用者程式碼處理常式都不會引發 事件來處理。 如需詳細資訊，請參閱事件與路由事件概觀。

與事件發生無關，某些控制項可能會使用 DragItemThemeAnimation 等主題動畫，以視覺方式向使用者指出拖曳行為。

另請參閱

• DragEventArgs
• DragOver
• AllowDrop
• 事件與路由事件概觀
• 拖放範例 (UWP)