Expander 類別

定義

命名空間:

Microsoft.UI.Xaml.Controls

表示顯示標頭且具有可折迭本文的控制項，可顯示內容。

本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class Expander : ContentControl

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class Expander : ContentControl

Public Class Expander
Inherits ContentControl

繼承

ContentControl

Expander

屬性

MarshalingBehaviorAttribute ThreadingAttribute ContractVersionAttribute

範例

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 Expander。

開啟 WinUI 2 資源庫應用程式，並查看展開器運作情形。

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

備註

提示

如需詳細資訊、設計指引和程式碼範例，請參閱 展開器概觀。

當顯示空間有限時，使用 來 Expander 專注于最重要的內容。 控制項 Expander 可讓您顯示或隱藏與一律可見之主要內容相關的較不重要內容。 標頭中包含的專案一律會顯示。 使用者可以透過與標頭互動，展開並折迭顯示次要內容的內容區域。 當內容區域展開時，它會以這種方式推送其他 UI 元素;它不會重迭其他 UI。 Expander可以向上或向下展開。

Header和 Content 區域都可以包含任何內容，從簡單的文字到複雜的 UI 版面配置。

控制項樣式和範本

您可以修改預設 的 Style 和 ControlTemplate ，讓控制項具有唯一的外觀。 如需修改控制項樣式和範本的相關資訊，請參閱 XAML 樣式。 定義控制面板的預設樣式、範本和資源會包含在 檔案中 generic.xaml 。 為了設計目的， generic.xaml 會與 WinUI (Microsoft.UI.Xaml) NuGet 套件一起安裝。 根據預設，此位置為 \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml。 不同版本 WinUI 的樣式和資源可能會有不同的值。

XAML 也包含可用來修改不同視覺狀態中控制項色彩的資源，而不需修改控制項範本。 建議您修改這些資源來設定 背景 和 前景等屬性。 如需詳細資訊，請參閱XAML 樣式一文的輕量樣式一節。

建構函式

Expander()

初始化 Expander 類別的新實例。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

屬性

ExpandDirection	取得或設定值，這個值表示內容區域展開的方向。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
ExpandDirectionProperty	識別 ExpandDirection 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Header	取得或設定 展開工具標頭中顯示的 XAML 內容。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HeaderProperty	識別 Header 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HeaderTemplate	取得或設定 Expander.Header的資料範本。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HeaderTemplateProperty	識別 HeaderTemplate 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HeaderTemplateSelector	取得或設定自訂 DataTemplateSelector 邏輯類別的參考，這個類別會傳回要套用至 標頭的範本。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
HeaderTemplateSelectorProperty	識別 HeaderTemplateSelector 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
IsExpanded	取得或設定值，這個值表示是否顯示 Expander 的內容區域。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
IsExpandedProperty	識別 IsExpanded 相依性屬性。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
TemplateSettings	取得 物件，這個物件提供計算值，可在定義Expander的範本時參考為TemplatedParent來源。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

事件

Collapsed	當 展開器 的內容區域隱藏時發生。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。
Expanding	發生于 展開器 的內容區域開始顯示時。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (，請參閱Windows 應用程式 SDK命名空間) 。

另請參閱

• 展開工具概觀