FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si las subpropiedades de la propiedad de dependencia no afectan a la representación del objeto contenedor.
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
Valor de propiedad
true
si los cambios en los valores de la subpropiedad no afectan a la representación si ha cambiado; de lo contrario, false
. De manera predeterminada, es false
.
Excepciones
Los metadatos ya se aplicaron a una operación de propiedad de dependencia, por lo que están sellados y no se pueden establecer sus propiedades.
Comentarios
Esta opción de metadatos es pertinente para las propiedades de dependencia que son tipos de referencia, donde ese tipo tiene valores de propiedad propios. Normalmente, la lógica del sistema de diseño es suponer que cualquier propiedad de dependencia con subpropiedades puede afectar al diseño, ya que comprobar todas las subpropiedades de los cambios es más lento que ejecutar realmente otro pase de representación. Establecer esta opción true
en es útil para optimizar el rendimiento de la implementación del sistema de diseño de nivel de marco de WPF.
Las propiedades de las clases derivadas de PropertyMetadata normalmente se definen en el modelo de objetos como lectura y escritura. Esto es para que se puedan ajustar después de la inicialización de la instancia. Sin embargo, una vez que los metadatos se consuman como parte de una llamada a Register, AddOwnero OverrideMetadata, el sistema de propiedades sellará que la instancia de metadatos y las propiedades que transmiten los detalles de los metadatos ahora se consideran inmutables. Si se intenta establecer esta propiedad después IsSealed de que se encuentra true
en esta instancia de metadatos, se producirá una excepción.
Uso de texto XAML
Los miembros de esta clase no se suelen usar en XAML.