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"/>
属性值
要应用于 Setter 指定的属性的值。
注解
如 XAML 语法所示,可通过多种方式在 XAML 中指定 ValueSetter :
- 作为特性,使用字符串值。 对于简单情况(例如设置数值、枚举中的命名值或统一资源标识符(URI),此类字符串值可以隐式转换为特定于属性的类型。
- 作为在 XAML 对象元素语法中声明的完整新对象,对象元素嵌套在属性元素用法中。
- 作为在引号中具有 {StaticResource} 标记扩展 用法的属性。 通常,属性的值类型决定了哪种语法合适。 有关 XAML 用法的详细信息,请参阅 XAML 概述 或 XAML 语法指南。 可以将属性语法用于大多数 XAML UI 属性,以及特别需要属性元素用法或资源引用的 UI 属性不太常见。 如果这些值由多个样式或属性共享,则 {StaticResource} 标记扩展 用法甚至适用于字符串或数值。
必须在 Setter 上指定属性和Value属性。 否则将引发异常(分析异常或运行时错误,具体取决于是在 Setter XAML 中创建还是代码中修改)。
如果使用代码访问 Setter 实例,则如果父样式上的 IsSealed 属性的值为 true,则无法更改实例的任何属性Setter的值。 此外, IsSealed 属性对个人 Setter也报告了这一点。 当运行时向 UI 元素应用样式并在 UI 中显示样式时,系统将设置这些属性 true 。 尝试更改密封 Setter 的会引发运行时错误。
样式和模板
可以使用 Style 中的 Setter 将值应用于任何依赖属性。 但是,它是Setter控件派生类的 Template 属性,该属性构成典型Style中的大多数 XAML 标记。 for Value a SetterProperty="Template" with 几乎总是被指定为包含 ControlTemplate 对象元素的属性元素。
当样式用于定义控件模板时,元素的 StyleTargetType 及其 Control.Template setter 的 ControlTemplate 元素的 TargetType 应始终使用相同的值。
模板设置器为应用该模板的控件实例定义基本模板 UI 定义。 它还包含控件的视觉状态,以及其他基于状态的 UI 定义,例如默认主题切换。 对于复杂控件(如 ListBox),默认模板 样式 和 ControlTemplate 可以包含数百行 XAML。 有关控制模板化方案中的角色 Style 的详细信息,请参阅 XAML 控件模板。