Style 類別

參考

定義

命名空間:: Microsoft.UI.Xaml

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

包含可在類型實例之間共用的屬性 setter。 Style通常會在資源集合中宣告，以便共用並用於套用控制項範本和其他樣式。

public ref class Style sealed : DependencyObject

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Setters")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.Activatable(Microsoft.UI.Xaml.IStyleFactory, 65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Style final : DependencyObject

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Setters")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Microsoft.UI.Xaml.IStyleFactory), 65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Style : DependencyObject

Public NotInheritable Class Style
Inherits DependencyObject

<Style .../>
-or-
<Style ...>
  oneOrMoreSetters
</Style>

繼承: Object Platform::Object IInspectable DependencyObject Style

屬性: ContentPropertyAttribute ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

本範例會建立兩種樣式：一個用於 TextBlock ，另一個用於 TextBox。每個樣式都會套用至控制項的兩個實例，以為每個 TextBlock 和 TextBox 建立統一的外觀。此範例會藉由將參考 Style 為{StaticResource} 標記延伸，設定每個控制項的FrameworkElement.Style屬性。此範例也會示範如何從資源字典擷取樣式，並將其套用至程式碼中的控制項。

每個樣式都有多個 Setter 元件。在此 XAML 中，不會顯示 Style.Setters 任何 XAML 屬性專案。這是這個屬性在 XAML 中的一般用法。值 Style.Setters 是隱含的，因為 Setters 是 Style 的 XAML 內容屬性。如需 XAML 語法以及如何讓 XAML 內容語法隱含和省略特定 XAML 元素的詳細資訊，請參閱 XAML 語法指南。

請注意，在 TextBox的樣式中， Margin 屬性會設定為 4，這表示 TextBox 在所有邊都有 4 的邊界。為了補償第二個TextBlock的長度，其長度比第一個 TextBlock 短，因為姓氏取用空間小於名字，則會在第二 TextBox 個上指派「6，4，4，4，4」的值給 Margin 屬性。這會導致第二 TextBox 個邊界與樣式所指定的邊界不同，以便水準對齊第一個 TextBox 。

<StackPanel x:Name="rootPanel">
  <StackPanel.Resources>
    <!--Create a Style for a TextBlock to specify that the
              Foreground equals Navy, FontSize equals 14, and
              VerticalAlignment equals Botton.-->
    <Style TargetType="TextBlock" x:Key="TextBlockStyle">
      <Setter Property="Foreground" Value="Navy"/>
      <Setter Property="FontSize" Value="14"/>
      <Setter Property="VerticalAlignment" Value="Bottom"/>
    </Style>

    <!--Create a Style for a TextBox that specifies that
              the Width is 200, Height is 30, Margin is 4,
              Background is LightBlue, and FontSize is 14.-->
    <Style TargetType="TextBox" x:Key="TextBoxStyle">
      <Setter Property="Width" Value="200"/>
      <Setter Property="Height" Value="30"/>
      <Setter Property="Margin" Value="4"/>
      <Setter Property="FontSize" Value="14"/>
      <Setter Property="Background">
        <Setter.Value>
          <LinearGradientBrush StartPoint="0,0.5" EndPoint="1,0.5">
            <GradientStop Color="White" Offset="0.0"/>
            <GradientStop Color="LightBlue" Offset="0.5"/>
            <GradientStop Color="Navy" Offset="1"/>
          </LinearGradientBrush>
        </Setter.Value>
      </Setter>
    </Style>
  </StackPanel.Resources>

  <!--Apply the TextBlockStyle and TextBoxStyle to each 
      TextBlock and TextBox, respectively.-->
  <StackPanel Orientation="Horizontal">
    <TextBlock Text="First Name:" Style="{StaticResource TextBlockStyle}"/>
    <TextBox Style="{StaticResource TextBoxStyle}"/>
  </StackPanel>
  <StackPanel Orientation="Horizontal">
    <TextBlock Text="Last Name:" Style="{StaticResource TextBlockStyle}"/>
    <TextBox Style="{StaticResource TextBoxStyle}"
             Margin="6,4,4,4"/>
  </StackPanel>
  <StackPanel x:Name="emailAddressPanel" Orientation="Horizontal"/>
</StackPanel>

private void ShowEmailAddressBox()
{
    TextBlock emailAddressLabel = new TextBlock();
    emailAddressLabel.Text = "Email:";
    emailAddressLabel.Style = (Style)rootPanel.Resources["TextBlockStyle"];

    TextBox emailAddressBox = new TextBox();
    emailAddressBox.Style = (Style)rootPanel.Resources["TextBoxStyle"];
    emailAddressBox.Margin = new Thickness(38, 4, 4, 4);

    emailAddressPanel.Children.Add(emailAddressLabel);
    emailAddressPanel.Children.Add(emailAddressBox);
}

此範例會建立兩個樣式專案。 TargetType第一個樣式專案的設定 TextBox 為，而 TargetType 第二個樣式專案的設定為 Button 。然後，這些會套用為控制項和 Button 控制項的 TextBox 隱含樣式。

<StackPanel>
    <StackPanel.Resources>
        <Style TargetType="TextBox">
            <Setter Property="Foreground" Value="Pink" />
            <Setter Property="FontSize" Value="15" />                
        </Style>
        
        <Style TargetType="Button">
            <Setter Property="Foreground" Value="Black" />
            <Setter Property="Background" Value="Yellow" />
        </Style>
    </StackPanel.Resources>
    
    <TextBox Height="30" Width="120" Margin="2" Text="TextBoxStyle" />
    <Button Height="30" Width="100" Margin="2" Content="ButtonStyle" />
</StackPanel>

此範例會 Style 根據 Style 具名BaseStyle 建立名為 InheritedStyle的。 InheritedStyle 繼承 Background 的值 Yellow ， BaseStyle 並加入 Foreground 的值 Red 。

<StackPanel>
    <StackPanel.Resources>
        <Style x:Key="BaseStyle" TargetType="Button">
            <Setter Property="Background" Value="Yellow" />
        </Style>
        <!--Create a Style based on BaseStyle-->
        <Style x:Key="InheritedStyle" TargetType="Button" BasedOn="{StaticResource BaseStyle}">
            <Setter Property="Foreground" Value="Red" />
        </Style>
    </StackPanel.Resources>
    <!--A button with default style-->
    <Button Content="HelloWorld" />
    <!--A button with base style-->
    <Button Content="HelloWorld" Style="{StaticResource BaseStyle}" />
    <!--A button with a style that is inherited from the BaseStyle-->
    <Button Content="HelloWorld" Style="{StaticResource InheritedStyle}" />
</StackPanel>

備註

Style基本上是套用至具有這類屬性之特定類型的一或多個實例的屬性設定集合。 Style包含一或多個Setter物件的集合。每個 Setter 都有屬性和值。 Property是套用樣式之專案的屬性名稱。 Value是套用至屬性的值。

若要套用 Style ，目標物件必須是 DependencyObject。每個Setter所參考的屬性都必須是相依性屬性。

當您建立 Style 時，必須設定TargetType屬性。否則，會擲回例外狀況。

如果您在中 Style 設定相同屬性的值，也直接在元素上設定值，則專案上設定的值會直接優先。如需詳細資訊，請參閱相依性屬性概觀，特別是一節。

將樣式定義為 XAML 資源

Style幾乎一律在 XAML 中定義為ResourceDictionary中的資源。

Style針對只由相同 XAML 頁面中定義之其他 UI 專案使用的，如果您根項目是Page) ，您通常會在FrameworkElement.Resources集合中定義 Style (Page.Resources 。
Style針對應用程式中多個頁面使用的，您通常會在Application.Resources集合中定義 Style。或者，您可能有個別的 XAML 檔案，可供您納入 Application.Resources 的應用程式作為 MergedDictionaries 值。
大部分的 UI 元素都有Windows 執行階段所定義的預設樣式。在名為 generic.xaml的設計協助程式 XAML 檔案中，可以看到預設樣式的複本，這在技術上不是應用程式的資源檔，雖然其結構類似。當您編輯工具所啟用的樣式複本時，您可以將此檔案的離散部分複製到應用程式的 XAML 中，但是當您進行這類複本時，它必須包含在其中一個 Resources 集合中，或透過 MergedDictionaries間接存取。在這些情況下，覆寫預設值的已修改 XAML 會包含在您的應用程式中。

Style ResourceDictionary中定義的元素不需要有x：Key 屬性或x：Name 屬性，這通常是 XAML 資源的需求。以這種方式定義的， Style 會使用其 TargetType 屬性值作為隱含索引鍵，並稱為隱含樣式。

如需如何使用 XAML 資源字典的詳細資訊，請參閱 ResourceDictionary 和 XAML 資源參考。

樣式及範本

您可以使用中的 StyleSetter，將值套用至任何相依性屬性。但它是 SetterControl衍生類別的Template屬性，其構成一般 Style 中大部分的 XAML 標記。的 Property="Template"ValueSetter 幾乎一律指定為包含ControlTemplate物件元素的屬性專案。

Style當用來定義控制項範本時，元素的 StyleTargetType及其Control.Template setter 的ControlTemplate元素TargetType應該一律使用相同的值。

Template setter 會定義套用該範本之控制項實例的基本範本 UI 定義。它也包含控制項的視覺狀態，以及其他以狀態為基礎的 UI 定義，例如預設主題轉換。對於 ListBox之類的複雜控制項，內的預設範本 Style 和 ControlTemplate 可以有數百行的 XAML。如需控制項範本化案例中角色 Style 的詳細資訊，請參閱 XAML 控制項範本。

控制項的範本通常包含視覺狀態，以變更控制項的外觀以回應邏輯狀態。例如，當按鈕從範本套用新的視覺狀態時，按鈕可以有不同的視覺效果外觀，而所有外觀變更都可以來自 XAML 而非程式碼。如需視覺狀態如何運作以及如何修改或定義自訂控制項狀態的詳細資訊，請參閱 XAML 控制項範本。

樣式和執行時間行為

您可以變更在執行時間由設定 Style 的個別屬性值，而新的值會覆寫 Setters 值。例如，即使這個屬性已由樣式設定，您也可以在執行時間設定 Template 屬性。

您可以在執行時間調整的屬性 Style ，但只有在該樣式尚未套用至任何專案時，且只存在作為未隱含使用的資源。例如，您可以將setter 新增至 Setters中具有x：Key 屬性之資源中的樣式集合，但 XAML 中沒有參考該樣式的{StaticResource} 標記延伸值。不過，只要參考 Style 並用於載入物件的值， Style 就應該視為密封。您可以檢查 IsSealed 屬性 Style 的值，以偵測密封狀態。 true如果是，則樣式會密封，而且您無法修改其任何屬性或內的 Setter子值。當參考的物件引發其 Loaded事件時 Style ，也可以偵測到樣式已使用且密封的時間點。

BasedOn 樣式

您可以根據應用程式所定義的現有樣式，或根據Windows 執行階段控制項的預設樣式來建置新的樣式。您可以使用 BasedOn 屬性來執行此動作。這可減少 XAML 中的重複，並讓您更輕鬆地管理資源。每個樣式只支援一種 BasedOn 樣式。如需詳細資訊，請參閱 BasedOn 或設定控制項的樣式。

隱含樣式

您可以定義樣式， Style 讓相同 TargetType的所有物件隱含使用，而不需要這類物件的每個實例特別參考 Style 做為 FrameworkElement.Style 值。 <Style>在沒有x：Key 屬性的ResourceDictionary中宣告資源時，x：Key值會使用屬性的值 TargetType 。如果您以隱含方式設定樣式，則樣式只會套用至完全符合 TargetType 且不會套用至衍生自 TargetType 值的專案。例如，如果您以隱含方式為應用程式中的所有 ToggleButton 控制項建立樣式，而且您的應用程式具有 ToggleButton和 CheckBox 控制項， CheckBox (衍生自 ToggleButton) ，則「ToggleButton」隱含樣式只會套用至 ToggleButton 控制項。

XAML 語法注意事項

Setters 是的 Style XAML 內容屬性，因此您可以使用隱含集合語法，例如 <Style><Setter .../><Setter .../></Style> 。

例如， Style 在程式碼中使用類別 (呼叫建構函式，並逐一建置 Setter 值) 非常罕見。樣式用於範本，而且範本應在 XAML 載入時使用，因此程式碼中建立的任何 Style 建立通常太晚，無法套用至 UI 中的控制項。

建構函式

Style()	初始化 Style 類別的新實例，沒有初始 TargetType 和空的 Setters 集合。
Style(TypeName)	使用指定的初始TargetType和空的 Setters集合，初始化Style類別的新實例。

屬性

BasedOn	取得或設定做為目前樣式之基礎的已定義樣式。
Dispatcher	一律會在 `null` Windows 應用程式 SDK應用程式中傳回。請改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	`DispatcherQueue`取得與這個物件相關聯的。 `DispatcherQueue`表示即使程式碼是由非 UI 執行緒起始，也可以存取 `DependencyObject` UI 執行緒上的。 (繼承來源 DependencyObject)
IsSealed	取得值，這個值表示樣式是否為唯讀而無法加以變更。
Setters	取得 Setter 物件的集合。
TargetType	取得或設定樣式預定的型別。 `TargetType` 如果沒有指定資源索引鍵，則可以用來宣告隱含樣式資源。

方法

ClearValue(DependencyProperty)	清除相依性屬性的本機值。 (繼承來源 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	傳回針對相依性屬性所建立的任何基底值，如果動畫未使用中，則會套用。 (繼承來源 DependencyObject)
GetValue(DependencyProperty)	從 DependencyObject傳回相依性屬性的目前有效值。 (繼承來源 DependencyObject)
ReadLocalValue(DependencyProperty)	如果已設定本機值，則傳回相依性屬性的本機值。 (繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊通知函式，以接聽此DependencyObject實例上特定DependencyProperty的變更。 (繼承來源 DependencyObject)
Seal()	鎖定樣式，以便無法變更Setters集合中的TargetType屬性或任何Setter。
SetValue(DependencyProperty, Object)	在 DependencyObject上設定相依性屬性的本機值。 (繼承來源 DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。 (繼承來源 DependencyObject)

適用於

共用方式為

Style 類別

定義

範例

備註

將樣式定義為 XAML 資源

樣式及範本

樣式和執行時間行為

BasedOn 樣式

隱含樣式

XAML 語法注意事項

建構函式

屬性

方法

適用於

另請參閱

意見反應

其他資源

共用方式為

Style 類別

定義

範例

備註

將 樣式 定義為 XAML 資源

樣式及範本

樣式和執行時間行為

BasedOn 樣式

隱含樣式

XAML 語法注意事項

建構函式

屬性

方法

適用於

另請參閱

意見反應

其他資源

將樣式定義為 XAML 資源