UIElement.Drop 事件
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。
public:
virtual event DragEventHandler ^ Drop;// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler Drop;function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;Public Custom Event Drop As DragEventHandler <uiElement Drop="eventhandler"/>
事件類型
備註
若要 Drop 發生並叫用處理程式，UIElement上屬於置放目標且拖放動作來源上的AllowDrop值必須是 true 。
典型的處理常式會檢查DragEventArgs事件資料的Data值。
您可以呼叫StartDragAsync方法，在任何UIElement上起始拖放動作。 一旦起始動作，只要AllowDroptrue 位於該專案上，應用程式中的任何 UIElement 專案都可以是置放目標，而拖放動作所傳遞的任何元素都可以處理DragEnter、DragLeave或DragOver。
Drop 是路由事件。 元素必須具有 AllowDroptrue 才能成為 Drop 事件來源。 如果允許事件反升至父元素，因為它未處理，則 如果 AllowDrop 位於 true 父元素上，則可以處理父元素上的事件。 不是處理常式物件或置放目標之路由中的中繼元素不需要AllowDrop。 true 如需路由事件概念的詳細資訊，請參閱 事件和路由事件概觀。
對於觸控動作、拖放動作，以及觸控動作所造成的互動特定或操作事件，元素必須可見點擊測試，才能成為事件來源，並引發與動作相關聯的事件。 UIElement.Visibility 必須是 Visible。 衍生類型的其他屬性也會影響點擊測試可見度，例如 IsEnabled。 如需詳細資訊，請參閱事件與路由事件概觀。
Drop 支援將事件處理常式附加至將叫用的路由的能力，即使事件的事件資料標示為 Handled 也一樣。 請參閱 AddHandler。
特定Windows 執行階段控制項可能有事件的類別型處理 Drop 。 如果是，控制項的邏輯可能具有 OnDrop方法的覆寫。 一般而言，事件會標示為類別處理常式處理，而且 Drop 事件不會由該控制項上的任何使用者程式碼處理常式處理而引發。 如需詳細資訊，請參閱事件與路由事件概觀。
與事件發生無關，某些控制項可能會使用 DragItemThemeAnimation 之類的主題動畫，以視覺化方式向使用者指出拖曳行為。