語言

FrameworkElement.LayoutUpdated 活動

定義

當視覺樹的配置改變時,會發生在與佈局相關的屬性改變值或其他會刷新佈局的動作時。

// Register
event_token LayoutUpdated(EventHandler<IInspectable> const& handler) const;

// Revoke with event_token
void LayoutUpdated(event_token const* cookie) const;

// Revoke with event_revoker
FrameworkElement::LayoutUpdated_revoker LayoutUpdated(auto_revoke_t, EventHandler<IInspectable> const& handler) const;
public event System.EventHandler<object> LayoutUpdated;
function onLayoutUpdated(eventArgs) { /* Your code */ }
frameworkElement.addEventListener("layoutupdated", onLayoutUpdated);
frameworkElement.removeEventListener("layoutupdated", onLayoutUpdated);
- or -
frameworkElement.onlayoutupdated = onLayoutUpdated;
Public Custom Event LayoutUpdated As EventHandler(Of Object) 
<frameworkElement LayoutUpdated="eventhandler"/>
 

事件類型

備註

LayoutUpdated 是 XAML 載入序列中最後一個物件壽命事件,該事件在控制項準備進行互動前發生。 然而,也可能 LayoutUpdated 在物件生命週期的執行時發生,原因多種多樣:屬性變更、視窗大小調整,或執行時版面設計請求(UpdateLayout 或控制範本變更)。 LayoutUpdated該事件會在所有 SizeChanged 事件發生後觸發。

LayoutUpdated 當處理器所連接的物件不一定改變其下方的視覺樹時,可能會發生。 舉例來說,想像一個版面容器,裡面有兩個子元素共用空間。 如果第一個物件改變了某個屬性,導致必須重新配置,兩個物件都會觸發 LayoutUpdated,因為即使第二個物件本身的子佈局沒有改變,也可能被重新定位。

處理 LayoutUpdated時,不要只依賴 寄件人的 價值。 對於 LayoutUpdated,無論處理器連接在哪裡,發送 者 總是 null。 這是為了防止處理器賦予 發送者任何意義,例如暗示是該特定元素將事件從視覺樹中觸發出來。 LayoutUpdated 表示整體視覺樹中的某個物件發生了變化,而樹中任何特定物件都有處理此事件的選項。 如果你熟悉較低階的渲染 API 設計,可以把 LayoutUpdated 被觸發的現象比喻為物件驅動、保留模式渲染邏輯中設定的「需要重繪」旗標。

因為 LayoutUpdated 在許多情況下都會發生火災,且不一定只針對實際改變的物件,因此考慮是否處理 SizeChanged 事件更適合你的情境。

適用於

另請參閱