共用方式為


Setter.Value 屬性

定義

取得或設定要套用至 Setter所指定之屬性的值。

public:
 property Platform::Object ^ Value { Platform::Object ^ get(); void set(Platform::Object ^ value); };
IInspectable Value();

void Value(IInspectable value);
public object Value { get; set; }
var object = setter.value;
setter.value = object;
Public Property Value As Object
<Setter ...>
  <Setter.Value>
    objectValue
  </Setter.Value>
</Setter>
- or -
<Setter Value="attributeValue"/>
-or-
<Setter Value="extensionUsage"/>

屬性值

Object

Platform::Object

IInspectable

要套用至 Setter所指定之屬性的值。

備註

如您在 XAML 語法中所見,有各種不同的方式可以在 XAML 中指定 ValueSetter

  • 做為屬性,使用字串值。 這類字串值可以隱含轉換成屬性特定的類型,例如設定數值、列舉中的具名值,或 (URI) 。
  • 作為在 XAML 物件專案語法中宣告的完整新物件,而物件專案會巢狀在屬性專案使用方式中。
  • 做為在引號內具有 {StaticResource} 標記延伸 用法的屬性。 屬性的實值型別通常會指定適當的語法。 如需 XAML 使用方式的詳細資訊,請參閱 XAML 概觀XAML 語法指南。 您可以針對大部分的 XAML UI 屬性使用屬性語法,以及特別需要屬性元素使用方式或資源參考的 UI 屬性較不常見。 如果這些值是由多個樣式或屬性共用, 則 {StaticResource} 標記延伸 用法甚至適用于字串或數值。

您必須在Setter上同時指定PropertyValue 屬性。 否則會擲回例外狀況, (剖析例外狀況或執行時間錯誤,視 是在 Setter XAML 中建立或是在程式碼中修改) 而定。

如果您使用程式碼存取Setter實例,如果父Style上的IsSealed屬性值為 true ,則無法變更實例的任何屬性值 Setter 。 這也會由個別 Setter 上的IsSealed屬性報告。 當執行時間將樣式套用至 UI 元素並在 UI 中顯示樣式時,系統會將這些屬性 true 設定為 。 嘗試變更密封 Setter 會擲回執行階段錯誤。

樣式及範本

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

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

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

適用於