語言

Setter.Property 屬性

定義

命名空間:
Microsoft.UI.Xaml
編輯

取得或設定該屬性以套用該 值 。

public:
 property DependencyProperty ^ Property { DependencyProperty ^ get(); void set(DependencyProperty ^ value); };
DependencyProperty Property();

void Property(DependencyProperty value);
public DependencyProperty Property { get; set; }
var dependencyProperty = setter.property;
setter.property = dependencyProperty;
Public Property Property As DependencyProperty
<Setter Property="propertyName"/>

屬性值

DependencyProperty

一個將套用價值的相依屬性。 預設是 null。

範例

此範例展示了如何在 TextBlock 元素的樣式中使用 Setter 語句。

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

    <!-- Apply the TextBlockStyle to 2 different TextBlocks. -->
    <TextBlock Style="{StaticResource TextBlockStyle}" Text=”Hello”/>
    <TextBlock Style="{StaticResource TextBlockStyle}" Text=”World”/>
</StackPanel>

你也可以在附加財產價值上套用設定者，方法是在 AttachedPropertyProvider 中指定附加物件名稱。PropertyName 表格。 例如，若要使用 Setter 來處理附加屬性 Canvas.Left，請使用 This XAML。

<Setter Property="Canvas.Left" Value="100"/>

備註

你必須在 Setter 上同時指定 PropertyValue 屬性。 否則會拋出例外（可能是解析例外或執行時錯誤，視 Setter 是用 XAML 建立還是程式碼修改而定）。

如果你用程式碼存取 Setter 實例，若父 Style 上的 IsSealed 屬性值為 true，你就無法更改 Setter 實例的任何屬性值。 這也由 Issealled 的個別 二傳犬報告。 系統會將這些屬性設定為 true 執行時對 UI 元素套用樣式並在 UI 中顯示。 嘗試更換密封的 二傳手 會跳出執行時錯誤。

你可以用 Setter 來為附帶的物件做樣式。 在此情況下，依賴屬性名稱是 XAML 中的限定名稱，同時也指定附加屬性的定義型別。 例如， <Setter Property="AutomationProperties.LiveSetting" Value="Polite" /> 可以用來設定 AutomationProperties.LiveSetting 附帶屬性值，適用於樣式中任何控制項或 UI 元素。

Note

XAML 解析器也接受包含限定類別的相依屬性名稱。 例如，解析器會將「Button.Background」或「Control.Background」解讀為按鈕樣式中對 Background 屬性的參考。 不過不一定要依車種排位，可能會造成混淆的加價。 如果你從其他平台遷移 XAML，可能會遇到或使用符合條件的屬性名稱使用。

辨識依賴性質

如前所述，只有當該屬性是相依屬性時，才能用 Setter 透過風格調整屬性。 有套用樣式的 UI 屬性幾乎總是由 Windows 執行階段 實作為相依屬性，而非 UI 元素相依屬性的可設定屬性相當罕見。 如果你想驗證 Windows 執行階段 屬性是否為相依屬性，請檢查成員清單中原始定義該屬性的型別。 如果某屬性實際上是相依屬性，則該相依屬性識別碼也會存在於該類別上，且該識別碼與該屬性本身名稱相同，但加上 了「屬性」 後綴。 這個依賴屬性識別碼是一個靜態的唯讀屬性，在某些依賴屬性情境中透過程式碼非常有用。 例如，你可以在程式碼中使用這樣的識別碼值來調整現有的 Setter.Property 值，只要父樣式還沒封存。

使用設定器來處理自訂屬性

如果你想支援樣式，應該將該屬性宣告為相依屬性，還有其他情境如資料綁定或動畫。 如果你這麼做，你的自訂屬性也支援 在任何有TargetType 參考你自訂類型的樣式上做樣式。 欲了解更多資訊，請參閱 自訂相依屬性 或 目標類型。

適用於