Microsoft.UI.Xaml 命名空間

提供 Windows UI 程式庫（WinUI）的一般框架 API。

類別

名稱	Description
AdaptiveTrigger	代表一種宣告式規則，根據視窗屬性套用視覺狀態。
Application	代表目前的應用程式及其可用服務。
ApplicationInitializationCallbackParams	代表一個用於傳遞自訂初始化序列資訊的物件。 (已淘汰)
BindingFailedEventArgs	提供 DebugSettings.BindingFailed 事件的事件資料。
BringIntoViewOptions	代表當元素進入視野時可套用的選項。
BringIntoViewRequestedEventArgs	提供 UIElement.BringIntoViewRequested 事件的資料。
BrushTransition	當元素的筆刷改變時，提供動畫過渡行為。 目前僅限於物件間 SolidColorBrush 的變更。
ColorPaletteResources	代表一個專門的資源字典，包含 XAML 元素所使用的色彩資源。
CornerRadiusHelper	提供處理 角半徑 值的基本工具方法。 C# 程式碼應該改用 CornerRadius 的方法。
DataContextChangedEventArgs	提供 DataContextChanged 事件的資料。
DataTemplate	描述資料物件的視覺結構。 對於範本中顯示資料值的特定元素，請使用資料綁定。
DataTemplateKey	代表 DataTemplate 類別的資源金鑰。
DebugSettings	宣告應用程式在除錯環境中執行時的某些行為
DependencyObject	代表參與依賴屬性系統的物件。
DependencyObjectCollection	實作一個實用的集合類別，可包含 DependencyObject 項目。
DependencyProperty	代表一個在依賴屬性系統中註冊的相依屬性。 相依屬性提供值表達式、資料綁定、動畫及屬性變更通知的支援。 欲了解更多 DependencyProperty 值如何作為相依屬性的識別碼，請參閱 Dependency properties 概述。
DependencyPropertyChangedEventArgs	提供 PropertyChangedCallback 實作的資料，當相依屬性值改變時會被呼叫。 同時也提供 Control.IsEnabledChanged 事件及其他使用 DependencyPropertyChangedEventHandler 代理的事件資料。
DispatcherTimer	提供一個計時器，整合於調 度器 佇列中，並以指定時間間隔及優先順序處理。
DragEventArgs	提供拖放事件的資料。
DragOperationDeferral	讓你能非同步拖放目標應用程式的內容。
DragStartingEventArgs	提供 DragStarting 事件的事件資料。
DragUI	提供拖放操作開始時被拖曳資料的視覺化表示。
DragUIOverride	提供拖放操作中資料被拖曳的視覺表示，包括來自投放目標的反饋。
DropCompletedEventArgs	提供 DropCompleted 事件的事件資料。
DurationHelper	提供處理 持續時間 值的基本實用方法。 C# 程式碼應該改用 Duration 的方法。
EffectiveViewportChangedEventArgs	提供 FrameworkElement.EffectiveViewportChanged 事件的資料。
ElementFactoryGetArgs	代表呼叫 IElementFactoryGetElement 方法實作時可使用的選用參數。
ElementFactoryRecycleArgs	代表呼叫 IElementFactoryRecycleElement 方法實作時可選使用的參數。
ElementSoundPlayer	代表 XAML 控制音色的播放器。
EventTrigger	代表一個觸發器，根據事件執行一組動作（動畫分鏡圖）。 不常用。 請參閱備註。
ExceptionRoutedEventArgs	提供由非同步操作（如 ImageFailed）以事件形式提出的例外事件資料。
FrameworkElement	提供 Windows 執行階段 UI 物件的基底元素類別。 FrameworkElement 定義了支援 UI 互動及自動版面系統的共通 API。 FrameworkElement 同時定義與資料綁定相關的 API、定義與檢視物件樹，以及追蹤物件壽命。
FrameworkTemplate	建立一個元素樹。 FrameworkTemplate 是一個針對具有特定範本行為的類別的基底類別，包括 ControlTemplate 和 DataTemplate。
FrameworkView	代表應用程式的使用者介面視窗。
FrameworkViewSource	建立檢視，特別是 FrameworkView 實例。 這是基礎建設，在大多數應用程式情境下不需要存取。
GridLengthHelper	提供輔助方法以評估或設定 網格長度 值。 C# 程式碼應該改用 GridLength 的方法。
LaunchActivatedEventArgs	提供 Application.OnLaunched 活動的活動資訊。
MediaFailedRoutedEventArgs	提供 MediaElement.MediaFailed 事件的事件資料。
PointHelper	提供輔助方法以設定 點 數值。 C# 程式碼應該使用 Point 的方法。
PropertyMetadata	定義依賴屬性的行為面向，包括其註冊條件。 關於如何 PropertyMetadata 用於相依屬性的更多資訊，請參見 「自訂相依屬性」。
PropertyPath	實作一種資料結構，描述一個屬性為一條路徑，位於另一個屬性之下，或是某個擁有型別之下。 屬性路徑用於物件綁定資料。
RectHelper	提供輔助方法以評估或設定 Rect 值。 C# 程式碼應該使用 Rect 的成員。
ResourceDictionary	定義一個儲存庫，存放你的應用程式所使用的 XAML 資源，例如樣式。 你可以在 XAML 中定義資源，然後使用 {StaticResource} 標記擴充功能 和 {ThemeResource} 標記擴充功能在 XAML 中取得它們。 你也可以用程式碼存取資源，但這比較少見。
ResourceManagerRequestedEventArgs	提供活動資料 Application.ResourceManagerRequested 。
RoutedEvent	代表一個路由事件到 Windows 執行階段 事件系統。
RoutedEventArgs	包含與路由事件相關的狀態資訊與事件資料。
ScalarTransition	當元素的不透明度或旋轉屬性改變時，提供動畫轉換行為。
Setter	以 Style 或 VisualState 對屬性套用值。
SetterBase	表示值 setter 的基類。
SetterBaseCollection	代表一組繼承自 SetterBase 的物件。
SizeChangedEventArgs	提供與 FrameworkElement.SizeChanged 事件相關的資料。
SizeHelper	提供輔助方法以評估或設定 大小 值。 C# 程式碼應該使用 Size 的成員。
StateTrigger	代表一個條件性地套用視覺狀態的觸發器。
StateTriggerBase	代表狀態觸發器的基底類別。
Style	包含可在某類型實例間共享的屬性設定器。 A Style 通常在資源集合中宣告，以便分享並用於套用控制範本及其他樣式。
StyleTypedPropertyAttribute	代表一個屬性，該屬性套用到類別定義中，並決定屬於 Style 類型的屬性的 TargetTypes。
TargetPropertyPath	代表指向目標元素屬性的路徑。
TemplatePartAttribute	表示套用至類別定義的屬性，以識別用於範本化的具名元件類型。
TemplateVisualStateAttribute	指定控制項可以處於特定狀態，且控制項的 ControlTemplate 中預期有 VisualState。
ThicknessHelper	提供輔助方法以評估或設定 厚度 值。 C# 程式碼應該使用 Thickness 的成員。
TriggerAction	作為 BeginStoryboard 的基礎類別。 不常用。 請參閱備註。
TriggerActionCollection	代表一組 BeginStoryboard 物件。
TriggerBase	作為 EventTrigger 的基底類別。 不常用。 請參閱備註。
TriggerCollection	代表一組 EventTrigger 物件。
UIElement	UIElement 是大多數Windows 執行階段 UI物件的基底類別，這些物件具有視覺外觀，並能將基本輸入納入應用程式的使用者介面。
UIElementWeakCollection	代表一組弱參考的 UIElement 物件。
UnhandledExceptionEventArgs	提供 UnhandledException 事件的資料。
Vector3Transition	當元素的平移或縮放屬性改變時，提供動畫轉換行為。
VisualState	代表 UI 元素在特定狀態下的視覺呈現。 視覺狀態會使用 Setters 或 Storyboard 來設定頁面或控制範本中的 UI 屬性，並定義 。VisualState
VisualStateChangedEventArgs	提供 CurrentStateChanging 與 CurrentStateChanged 事件的資料。
VisualStateGroup	包含互斥的 VisualState 物件與 VisualTransition 物件，用於從一個狀態切換到另一個狀態。
VisualStateManager	管理視覺狀態及控制項視覺狀態間轉換的邏輯。 同時也提供了附加屬性支援， VisualStateManager.VisualStateGroups這是你如何在 XAML 中定義控制範本的視覺狀態。
VisualTransition	代表當控制從一種視覺狀態轉換到另一種視覺狀態時所發生的視覺行為。
Window	代表當前 應用程式的視窗。
WindowActivatedEventArgs	包含 Microsoft 回傳的視窗啟動狀態資訊。UI。Xaml.Window.Activated 事件。
WindowEventArgs	包含 Window.Closed 事件回傳的視窗狀態資訊。
WindowSizeChangedEventArgs	包含 Window.SizeChanged 事件回傳的視窗大小狀態資訊。
WindowVisibilityChangedEventArgs	包含 Window.VisibilityChanged 事件回傳的視窗可見性狀態資訊。
XamlIsland	定義一個物件，使應用程式能夠承載 XAML 內容的片段。
XamlResourceReferenceFailedEventArgs	提供活動資料 DebugSettings.XamlResourceReferenceFailed 。
XamlRoot	代表一棵 XAML 內容樹狀結構，以及它所托管的上下文資訊。
XamlRootChangedEventArgs	提供 XamlRoot.Changed 事件的資料。

結構

名稱	Description
CornerRadius	描述圓角的特性，例如可應用於 邊框。
Duration	代表時間 軸 活躍的時間長度，或更一般地表示同時支持兩個特殊值 Automatic 和 Forever的時間長度。
GridLength	代表一種明確支援 星形 （*）大小與 自動 大小的控制邏輯測量。
Thickness	描述矩形周圍框架的粗細。 四個 雙重 值分別描述矩形的 左、 上、 右、 下 四側。

介面

名稱	Description
IDataTemplateExtension	定義了資料範本分階段渲染的輔助方法。
IElementFactory	支援建立與回收 UIElement 物件。
IXamlServiceProvider	定義了一種取回服務物件的機制;也就是說，提供其他物件自訂支援的物件。

列舉

名稱	Description
ApplicationHighContrastAdjustment	定義常數，指定框架在啟用高對比主題時是否自動調整應用程式的視覺屬性。
ApplicationRequiresPointerMode	Important 不要使用。 ApplicationRequiresPointerMode 在 Windows 應用程式 SDK 中不被支援。 規範非指標裝置（如鍵盤或遊戲控制器）的互動體驗。
ApplicationTheme	宣告應用程式的主題偏好。
AutomationTextAttributesEnum	定義了識別Microsoft 使用者介面自動化文字範圍的文字屬性的常數。
DispatcherShutdownMode	定義了指定應用程式如何關閉的常數。
DurationType	宣告一個 持續時間 是否有 自動 或 永久的特殊值，或其組件中是否有有效資訊 TimeSpan 。
ElementHighContrastAdjustment	定義常數，指定框架在啟用高對比主題時是否自動調整元素的視覺屬性。
ElementSoundKind	定義了指定 ElementSoundPlayer.Play 方法所播放聲音的常數。
ElementSoundMode	定義常數，指定控制器偏好是否播放聲音。
ElementSoundPlayerState	定義了指定 XAML 控制項是否播放聲音的常數。
ElementSpatialAudioMode	定義常數，指示空間聲音是開啟、關閉或自動處理。
ElementTheme	指定一個應用於應用程式 UI 中個別 UIElement 部分的 UI 主題。
FlowDirection	定義了指定文字與使用者介面元素內容流向的常數。
FocusState	描述元素如何獲得焦點。
FocusVisualKind	指定用於在鍵盤或遊戲控制器操作時，用來標示 UI 元素並聚焦的視覺回饋。
FontCapitals	描述字體大寫字母風格值。 大寫 附有屬性。
FontEastAsianLanguage	提供一種機制，用於選擇特定東亞書寫系統或語言中字型特定版本的字形。
FontEastAsianWidths	提供選擇不同寬度字形的機制。
FontFraction	描述 Typography.Fraction attached 屬性的分數樣式值。
FontNumeralAlignment	描述 Typography.NumeralAlignment 附加屬性的數字對齊值。
FontNumeralStyle	描述 Typography.NumeralStyle 附加屬性的數字樣式值。
FontVariants	描述 Typography.Variants 附加屬性的字型變體值。
GridUnitType	描述 GridLength 物件所持有的值類型。
HorizontalAlignment	指出相對於父元素配置位置的水平軸上應該顯示專案的位置。
LayoutCycleDebugBreakLevel	定義常數，指定當佈局週期即將崩潰時，應觸發除錯器斷點的層級。
LayoutCycleTracingLevel	定義常數，指定是否將版面週期追蹤資訊寫入原生除錯器，以及記錄的細節層級。
LineStackingStrategy	描述每條線決定線盒的機制。
OpticalMarginAlignment	規定在對齊文字容器邊界時，如何處理每字元排版中的側承值。
TextAlignment	指定文字是居中、左對齊還是右對齊。
TextLineBounds	影響線框高度的計算方式
TextReadingOrder	為房產提供價值 TextReadingOrder 。
TextTrimming	描述當文字溢出其包含方塊的邊緣時，文字會如何修剪。
TextWrapping	指定文字在抵達容器邊緣時是否會展開換行。
Vector3TransitionComponents	定義了在 Vector3Transition 動畫中要動畫哪些軸的常數。
VerticalAlignment	描述子專案如何垂直放置或延展在父系的配置位置內。
Visibility	指定項目的顯示狀態。
WindowActivationState	指定在 視窗上觸發啟動事件的理由。

委派

名稱	Description
ApplicationInitializationCallback	代表初始化序列中應呼叫的回調。
BindingFailedEventHandler	代表將處理 DebugSettings.BindingFailed 事件的方法。
CreateDefaultValueCallback	代表可作為 PropertyMetadata 建構子一部分調用的方法，以延遲相依屬性預設值的定義。
DependencyPropertyChangedCallback	代表當屬性值變更時，針對 RegisterPropertyChangedCallback 技術註冊的屬性變更通知所呼叫的回調。
DependencyPropertyChangedEventHandler	代表當特定 DependencyObject 實作變更 DependencyProperty 時，會處理事件的方法。
DragEventHandler	代表處理 UIElement 中 DragEnter、DragLeave、DragOver 與 Drop 事件的方法。
EnteredBackgroundEventHandler	Application.EnteredBackground 事件的處理器。
ExceptionRoutedEventHandler	代表會處理報告異常的特定事件的方法。 這些例外通常來自非同步操作。
LeavingBackgroundEventHandler	Application.LeavingBackground 事件的處理者。
PropertyChangedCallback	表示相依性屬性的有效屬性值變更時所叫用的回呼。
RoutedEventHandler	代表處理路由事件的方法。
SizeChangedEventHandler	代表處理 SizeChanged 事件的方法。
SuspendingEventHandler	應用程式暫停事件的處理者。
UnhandledExceptionEventHandler	代表將處理 UnhandledException 事件的方法。
VisualStateChangedEventHandler	代表將處理 CurrentStateChanging 與 CurrentStateChanged 事件的方法。

範例

打開 WinUI 3 圖庫應用程式，看看控制項的運作

WinUI 3 Gallery 應用程式包含大部分 WinUI 3 控制項、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub 上取得原始程式碼。