Setter.Value 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
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"/>
屬性值
該值適用於 設定者指定的屬性。
備註
如你從 XAML 語法中所見,有多種方式可以指定 XAML Value 中的 Setter :
- 作為屬性,使用字串值。 此類字串值可隱含轉換為屬性特定的類型,用於簡單情況,例如設定數值、列舉中的命名值,或統一資源識別碼(URI)。
- 作為一個全新的物件,它以 XAML 物件元素語法宣告,且物件元素巢狀在屬性元素中使用中。
- 作為一個屬性,在引號中使用了 {StaticResource} 標記擴充功能 。 通常屬性的價值類型決定了哪種語法是合適的。 欲了解更多 XAML 使用資訊,請參閱 XAML 概覽 或 XAML 語法指南。 大多數 XAML UI 屬性都可以用屬性語法,而那些特別需要屬性元素使用或資源參考的 UI 屬性則較少見。 { StaticResource} 標記擴充功能 甚至可以用於字串或數值,且這些值被多個樣式或屬性共享。
你必須在 Setter 上同時指定屬性和Value屬性。 否則會拋出例外(可能是解析例外或執行時錯誤,視該異常 Setter 是用 XAML 建立還是程式碼修改而定)。
如果你用程式碼存取 Setter 實例,若父 Style 上的 IsSealed 屬性值為 true,你就不能更改該實例任何屬性Setter的值。 這也由 Issealed 物業在個人 Setter身上報告。 系統會將這些屬性設定為 true 執行時對 UI 元素套用樣式並在 UI 中顯示。 嘗試更改封 Setter 存會跳出執行時錯誤。
樣式和模板
你可以在 Style 中使用 Setter 來套用任何相依屬性的值。 但在典型 Style的 中,佔據 XAML 標記的主要部分,是 SetterControl 衍生類別的 Template 屬性。
Value對於 Setter a 且 幾乎Property="Template"總是指定為包含 ControlTemplate 物件元素的屬性元素。
當使用 Style 來定義控制範本時,該元素的 StyleTargetType 與 ControlTemplate 元素的 TargetType 應始終使用相同的值。
模板設定器定義了套用該範本的控制實例的基本模板 UI 定義。 它也包含控制項的視覺狀態,以及其他基於狀態的 UI 定義,例如預設主題轉換。 對於像 ListBox 這樣複雜的控制項,預設範本 Style 和其中的 ControlTemplate 可以包含數百行 XAML。 欲了解更多關於控制範本場景中角色 Style 的資訊,請參閱 XAML 控制範本。