語言

FrameworkElement.SizeChanged 活動

定義

當 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。

適用於

另請參閱