FrameworkPropertyMetadataOptions Enumeração

Definição

Especifica os tipos de comportamento de propriedade de nível de estrutura que pertencem a uma determinada propriedade de dependência no sistema de propriedade do WPF (Windows Presentation Foundation).Specifies the types of framework-level property behavior that pertain to a particular dependency property in the Windows Presentation Foundation (WPF) property system.

Esta enumeração tem um atributo <a href="https://docs.microsoft.com/en-us/dotnet/api/system.flagsattribute">FlagsAttribute</a> que permite uma combinação bit a bit dos valores membros dela.

public enum class FrameworkPropertyMetadataOptions
[System.Flags]
public enum FrameworkPropertyMetadataOptions
type FrameworkPropertyMetadataOptions = 
Public Enum FrameworkPropertyMetadataOptions
Herança
FrameworkPropertyMetadataOptions
Atributos

Campos

AffectsArrange 2

A passagem de organização da composição de layout é afetada pelas alterações de valor nessa propriedade de dependência.The arrange pass of layout composition is affected by value changes to this dependency property.

AffectsMeasure 1

A passagem de medida das composições de layout é afetada pelas alterações de valor nessa propriedade de dependência.The measure pass of layout compositions is affected by value changes to this dependency property.

AffectsParentArrange 8

A passagem de organização no elemento pai é afetada pelas alterações de valor nessa propriedade de dependência.The arrange pass on the parent element is affected by value changes to this dependency property.

AffectsParentMeasure 4

A passagem de medida no elemento pai é afetada pelas alterações de valor nessa propriedade de dependência.The measure pass on the parent element is affected by value changes to this dependency property.

AffectsRender 16

Algum aspecto da composição de renderização ou layout (diferente da de medida ou organização) é afetado pelas alterações de valor nessa propriedade de dependência.Some aspect of rendering or layout composition (other than measure or arrange) is affected by value changes to this dependency property.

BindsTwoWayByDefault 256

O BindingMode padrão para associações de dados nessa propriedade de dependência é TwoWay.The BindingMode for data bindings on this dependency property defaults to TwoWay.

Inherits 32

Os valores dessa propriedade de dependência são herdados por elementos filhos.The values of this dependency property are inherited by child elements.

Journal 1024

Os valores dessa propriedade de dependência devem ser salvos ou restaurados por processos de registro em diário ou ao navegar por URIs (Uniform Resource Identifiers).The values of this dependency property should be saved or restored by journaling processes, or when navigating by Uniform resource identifiers (URIs).

None 0

Se nenhuma opção for especificada, a propriedade de dependência usará o comportamento padrão do sistema de propriedade WPF.No options are specified; the dependency property uses the default behavior of the WPF property system.

NotDataBindable 128

Não é permitida a vinculação de dados para essa propriedade de dependência.Data binding to this dependency property is not allowed.

OverridesInheritanceBehavior 64

Os valores dessa propriedade de dependência abrangem árvores separadas para fins de herança de valor da propriedade.The values of this dependency property span separated trees for purposes of property value inheritance.

SubPropertiesDoNotAffectRender 2048

As subpropriedades no valor dessa propriedade de dependência não afetam os aspectos de renderização.The subproperties on the value of this dependency property do not affect any aspect of rendering.

Exemplos

O exemplo a seguir chama o Construtor FrameworkPropertyMetadata e define várias opções usando valores da enumeração FrameworkPropertyMetadataOptions:The following example calls the FrameworkPropertyMetadata constructor and sets several options by using values from the FrameworkPropertyMetadataOptions enumeration:

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Comentários

Use essa enumeração quando você construir uma instância de FrameworkPropertyMetadata e desejar especificar uma ou mais configurações de opção de metadados no nível de estrutura.Use this enumeration when you construct a FrameworkPropertyMetadata instance, and you want to specify one or more the framework-level metadata option settings.

Você não usa mais essa enumeração após a chamada de construtor.You no longer use this enumeration after the constructor call. Em vez disso, consulte a opção de metadados específica que foi definida durante o registro, verificando o true ou false valor de uma propriedade específica de um FrameworkPropertyMetadataexistente.Instead, query the particular metadata option that was set during registration by checking the true or false value of a specific property of an existing FrameworkPropertyMetadata. Esses nomes de propriedade correspondem à FrameworkPropertyMetadataOptions valores de enumeração, exceto para não DataBind, que é IsNotDataBindable na FrameworkPropertyMetadataconcluída.These property names match the FrameworkPropertyMetadataOptions enumeration values except for NotDataBindable, which is IsNotDataBindable on the finished FrameworkPropertyMetadata.

A opção Journal especifica apenas a intenção a ser registrada no diário.The Journal option only specifies the intention to be journaled. O registro em log real pode ou não ser resolvido por serviços de registro em diário, como os que estão presentes no aplicativo do Visualizador do WPF.The actual journaling may or may not be addressed by journaling services such as those that are present in the WPF viewer application. Em particular, o registro em diário tem algumas limitações conhecidas se a árvore de elementos foi construída por meio de código em vez de XAML.In particular, journaling has some known limitations if the element tree was constructed through code rather than XAML. Para obter detalhes, consulte visão geral de navegação.For details, see Navigation Overview.

Observação

Embora a herança de valor de propriedade pareça funcionar para propriedades de dependência não anexadas, o comportamento de herança para uma propriedade não anexada por certos limites de elemento na árvore de tempo de execução é indefinido.Although property value inheritance might appear to work for nonattached dependency properties, the inheritance behavior for a nonattached property through certain element boundaries in the runtime tree is undefined. Sempre use o método DependencyProperty.RegisterAttached para registrar Propriedades onde você especifica FrameworkPropertyMetadata.Inherits nos metadados.Always use the DependencyProperty.RegisterAttached method to register properties where you specify FrameworkPropertyMetadata.Inherits in the metadata.

Aplica-se a