FrameworkPropertyMetadata.AffectsParentMeasure Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define um valor que indica se uma propriedade de dependência potencialmente afeta a passagem de medida do layout do respectivo elemento pai durante operações de mecanismo de layout.

public:
 property bool AffectsParentMeasure { bool get(); void set(bool value); };

public bool AffectsParentMeasure { get; set; }

member this.AffectsParentMeasure : bool with get, set

Public Property AffectsParentMeasure As Boolean

Valor da propriedade

Boolean

true se a propriedade de dependência na qual esses metadados existem potencialmente afetar a medida passar especificamente em seu elemento pai; 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

FrameworkElement e FrameworkContentElement incluem uma implementação de OnPropertyChanged que monitora alterações de valor efetivas em todas as propriedades de dependência que existem em um elemento . Como parte dessa lógica, as propriedades de dependência que alteram o valor efetivo e têm metadados com AffectsParentMeasure definido como true iniciarão uma solicitação adiada para invalidar os visuais do elemento pai. Como essa implementação no nível da estrutura do WPF já está em vigor, normalmente você não precisa procurar propriedades de dependência com AffectsParentMeasure , a menos que você esteja substituindo ou modificando substancialmente o comportamento de layout no nível da estrutura do WPF.

Em geral, você não precisa relatar alterações de uma FrameworkElement propriedade para um elemento pai usando AffectsParentMeasure porque o elemento em si já teria o seu próprio AffectsMeasure como true. Isso geralmente é suficiente, pois as alterações no elemento filho geralmente iniciam uma medida pai aprovada quando apropriado. AffectsParentMeasure às vezes é usado para uma FrameworkContentElement classe derivada. Nesse caso, o elemento filho define uma propriedade, mas uma FrameworkContentElement classe derivada não controla sua própria renderização. A renderização é tratada por um FrameworkElement elemento pai que serve como o host de conteúdo. Por exemplo, uma alteração no valor da Paragraph.KeepWithNext propriedade por um elemento filho invalida a medida do pai, pois o espaçamento relativo dos parágrafos pode mudar e pode aumentar ou diminuir o tamanho do host de conteúdo. Portanto, a Paragraph.KeepWithNext propriedade tem metadados em que AffectsParentMeasure é true.

Os elementos do host de conteúdo também frequentemente procuram alterações nas propriedades de dependência em que AffectsParentMeasure é true, como parte da lógica de renderização do host de conteúdo. Por exemplo, o TextBox elemento deve responder a determinadas alterações no texto que podem exigir que a caixa delimitadora do TextBox próprio seja alterada.

Implementações personalizadas OnPropertyChanged podem optar por ter um comportamento semelhante para alterações de propriedade de dependência em que AffectsParentMeasure é true.

As propriedades em qualquer classe derivada de PropertyMetadata normalmente são definidas no modelo de objeto como leitura-gravação. Isso é 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 em XAML.

Confira também

• FrameworkPropertyMetadataOptions