FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recebe ou define um valor que indica se as subpropriedades da propriedade de dependência não afetam a renderização do objeto que o contém.
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };public bool SubPropertiesDoNotAffectRender { get; set; }member this.SubPropertiesDoNotAffectRender : bool with get, setPublic Property SubPropertiesDoNotAffectRender As BooleanValor de Propriedade
true se as alterações nos valores das subpropriedades não afetarem a renderização se alteradas; caso contrário, false. A predefinição é false.
Exceções
Os metadados já foram aplicados a uma operação de propriedade de dependência, pelo que os metadados ficam selados e as propriedades dos metadados não podem ser definidas.
Observações
Esta opção de metadados é pertinente para propriedades de dependência que são tipos de referência, onde esse tipo tem valores próprios. Normalmente, a lógica do sistema de layout assume que qualquer propriedade de dependência com subpropriedades pode afetar o layout, porque verificar todas as subpropriedades para alterações é mais demorado do que executar outra passagem de renderização. Definir esta opção para true é útil para otimizar o desempenho da implementação do sistema de layout ao nível da framework WPF.
As propriedades nas classes derivadas de PropertyMetadata são tipicamente definidas no modelo de objetos como leitura-escrita. Isto serve para que possam ser ajustados após a inicialização da instância. No entanto, uma vez que os metadados sejam consumidos como parte de uma chamada para Register, AddOwner, ou OverrideMetadata, o sistema de propriedades selará essa instância de metadados e as propriedades que transmitem os detalhes dos metadados são agora consideradas imutáveis. Tentar definir esta propriedade depois IsSealed de estar true nesta instância de metadados irá gerar uma exceção.
Utilização de Texto XAML
Os membros desta classe normalmente não são usados em XAML.