FrameworkElement.SizeChanged 活動
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當 ActualHeight 或 ActualWidth 屬性在 FrameworkElement 上的值改變時,會發生這種情況。
public:
virtual event SizeChangedEventHandler ^ SizeChanged;
// Register
event_token SizeChanged(SizeChangedEventHandler const& handler) const;
// Revoke with event_token
void SizeChanged(event_token const* cookie) const;
// Revoke with event_revoker
FrameworkElement::SizeChanged_revoker SizeChanged(auto_revoke_t, SizeChangedEventHandler const& handler) const;
public event SizeChangedEventHandler SizeChanged;
function onSizeChanged(eventArgs) { /* Your code */ }
frameworkElement.addEventListener("sizechanged", onSizeChanged);
frameworkElement.removeEventListener("sizechanged", onSizeChanged);
- or -
frameworkElement.onsizechanged = onSizeChanged;
Public Custom Event SizeChanged As SizeChangedEventHandler
<frameworkElement SizeChanged="eventhandler"/>
事件類型
備註
SizeChanged當物件的尺寸(實際高度或實際寬度)改變時,即在測量與排列完成後觸發。
SizeChangedEventArgs 事件資料SizeChanged提供兩個屬性:PreviousSize 值,代表配置變更前元素的大小,以及 NewSize 值,代表目前的大小。 要取得高度和寬度資訊,請使用事件處理程序中 SizeVariableArgs 屬性的 Size 結構值的 Height 和 Width。
處理事件 SizeChanged 的一個原因是查看元素的 實際高度 與 實際寬 度的比例是否因新版面而改變。 例如,如果使用者調整了應用程式視窗大小,整體應用程式視圖變成窄視圖,可能會發生這種情況。
SizeChanged 發生在頁面元素的初始佈局階段,當應用程式剛啟用時,因為 UI 元素的 ActualHeight 和 ActualWidth 值在佈局前尚未定義。 它們只在初始佈局時取得數值,因此會發生 SizeChanged 事件。 之後,在應用程式的生命週期內, SizeChanged 如果 ActualHeight 和 ActualWidth 值因其他原因改變,事件仍可再次從元素觸發。 這些包括:
- 就是用程式碼調整該元素的 高度 和 寬度 。
- 修改約束屬性的程式碼(像是 MinHeight 或 MaxHeight 會影響 ActualHeight)。
- 資料綁定值已刷新或新增樣式,影響 FrameworkElement 中任何與版面相關的屬性。
- 用來調整容器尺寸的程式碼,例如作為元素父節點的 面板 或 清單框 。 這通常會觸發佈局傳球。 由於新的版面配置條件,包含的子元素可能擁有更多或更少的空間,這可能導致其中元素產生新的 ActualHeight 和 ActualWidth 。
- 執行時發生的其他變更,即使沒有直接改變 FrameworkElement 的版面屬性,也會改變版面空間。 例如,一個基於資料綁定到項目的清單可能會刷新或更新,這可能導致項目大小、項目控制項、清單檢視等發生變化。 或者支援增量載入的清單檢視可能會抓取更多項目並擴充清單檢視。
- 使用者改變應用程式 視窗 大小(發生 Window.SizeChanged 時),這又會影響頂層頁面的大小,甚至可能 影響 該頁面中使用「自動」配置或
Stretch對齊且未指定尺寸的自適應佈局來源尺寸。 - ApplicationView 或 DisplayInformation 的變更,最終會影響視窗與頁面尺寸,甚至可能影響所有 UI 元素。
不必完全避免呼叫影響當前物件 SizeChanged 配置的其他 API。 例如:設定 高度 或 寬度;呼叫 InvalidateMeasure 或 UpdateLayout;呼叫 ApplyTemplate;任何可能調整子元素大小,從而使父版面無效的操作。 佈局引擎內建邏輯,會在物件再次觸發事件前穩定數值,因此邏輯通常足夠穩健以避免迴圈狀況。 不過,仍然有可能不小心定義大小或渲染迴圈,導致應用程式當機,這通常會拋出像 LayoutCycleException 這類例外,而非真正當機。 如果你的處理器邏輯加上周圍的佈局,無法達到該物件大小的最終結果,就會發生這種情況。
如果物件在父容器中的位置改變但大小不變, SizeChanged 則不會發生。
LayoutUpdated 是類似事件,但 LayoutUpdated 同樣因位置變更而被執行。 而且, LayoutUpdated 發生範圍不會針對特定物件的佈局屬性,而是報告物件所包含的整個視覺樹。
LayoutUpdated 它會告訴你,包含該物件的整體視覺樹中有部分改變了,但物件的配置細節(大小、位置)可能沒有改變。
雖然此事件使用 RoutedEventHandler 相關的代理及 RoutedEventArgs 衍生的類別作為事件資料,但該事件並非真正的路由事件。 它不會從物件樹中冒泡出來。 它只能處理在發起事件的元素(換句話說,就是發送者)。 此事件的 OriginalSource 事件資料總是 null,所以不要嘗試使用 OriginalSource。