FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define um valor que indica se as subpropriedades da propriedade de dependência não afetam a renderização do objeto contentor.

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 da propriedade

Boolean

true se as alterações nos valores de sub-propriedade não afetarem a renderização se alteradas; caso contrário, false. O padrão é false.

Exceções

InvalidOperationException

Os metadados já foram aplicados à operação de propriedade de dependência, portanto os metadados estão selados e as propriedades dos metadados não podem ser definidas.

Comentários

Essa opção de metadados é pertinente para propriedades de dependência que são tipos de referência, em que esse tipo tem valores de propriedade próprios. Normalmente, a lógica do sistema de layout é supor que qualquer propriedade de dependência com sub-propriedades potencialmente afetará o layout, pois verificar todas as sub-propriedades para alterações é mais demorado do que realmente executar outro passe de renderização. Definir essa opção true é útil para otimizar o desempenho da implementação do sistema de layout no nível da estrutura do WPF.

As propriedades de PropertyMetadata classes derivadas normalmente são definidas no modelo de objeto como leitura-gravação. Isso ocorre para que eles possam ser ajustados após a inicialização da instância. No entanto, depois que os metadados forem consumidos como parte de uma chamada para Register, AddOwnerou OverrideMetadata, o sistema de propriedades selará essa instância de metadados e as propriedades que transmitem as especificidades dos metadados agora são consideradas imutáveis. Tentar definir essa propriedade depois IsSealed de estar true nessa instância de metadados gerará uma exceção.

Uso de texto XAML

Os membros dessa classe normalmente não são usados no XAML.

Confira também

• Freezable