FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示依赖属性的子属性是否影响包含对象的呈现。
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };
public bool SubPropertiesDoNotAffectRender { get; set; }
member this.SubPropertiesDoNotAffectRender : bool with get, set
Public Property SubPropertiesDoNotAffectRender As Boolean
属性值
如果更改后,对子属性值的更改不影响呈现,则为 true
;否则为 false
。 默认值为 false
。
例外
已对依赖属性操作应用了元数据,因此元数据已密封,且无法设置其属性。
注解
此元数据选项与引用类型的依赖属性相关,其中该类型具有自己的属性值。 通常,布局系统逻辑假设任何具有子属性的依赖属性都可能会影响布局,因为检查所有子属性是否有更改比实际运行另一个呈现通道更耗时。 将此选项设置为 true
有助于优化 WPF 框架级别布局系统实现的性能。
的派生类 PropertyMetadata 的属性通常在对象模型中定义为读写。 这样就可以在实例初始化后调整它们。 但是,一旦元数据作为对 Register、 或 OverrideMetadata的调用的一部分使用,AddOwner属性系统将密封该元数据实例和传达元数据细节的属性现在被视为不可变。 尝试在此元数据实例上的 之后IsSealedtrue
设置此属性将引发异常。
XAML 文本用法
此类的成员通常不在 XAML 中使用。