UIElement.DragOver 事件

定義

在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。

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上起始拖放動作。 啟動動作之後,只要該元素上的AllowDrop為 true,應用程式中的任何UIElement都可能是置放目標。 拖放動作通過的任何元素都可以處理 DragEnterDragLeave 或 DragOver

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

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

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

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

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

Windows 8/Windows 8.1在Windows 10之前,拖放概念的Windows 執行階段實作只允許某些控制項和輸入動作起始拖放動作。 沒有任何 StartDragAsync 或一般化的 DoDragDrop 方法可允許任何 UI 元素起始拖放動作。 應用程式中拖放動作的主要來源是當您拖曳清單的專案,例如 GridView時。

適用於

另請參閱