FrameworkPropertyMetadata.AffectsParentMeasure FrameworkPropertyMetadata.AffectsParentMeasure FrameworkPropertyMetadata.AffectsParentMeasure FrameworkPropertyMetadata.AffectsParentMeasure Property

Definición

Obtiene o establece un valor que indica si una propiedad de dependencia afecta potencialmente al paso de medición del diseño de su elemento principal durante las operaciones del motor de diseño.Gets or sets a value that indicates whether a dependency property potentially affects the measure pass of its parent element's layout during layout engine operations.

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 de propiedad

true si la propiedad de dependencia en la que existen estos metadatos afecta potencialmente al paso de medición, específicamente en su elemento principal; de lo contrario, false. El valor predeterminado es false.true if the dependency property on which this metadata exists potentially affects the measure pass specifically on its parent element; otherwise, false.The default is 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.The metadata has already been applied to a dependency property operation, so that metadata is sealed and properties of the metadata cannot be set.

Comentarios

FrameworkElemente FrameworkContentElement incluyen una implementación de OnPropertyChanged que supervisa los cambios de valor efectivos en todas las propiedades de dependencia que existen en un elemento.FrameworkElement and FrameworkContentElement include an implementation of OnPropertyChanged that monitors effective value changes to all dependency properties that exist on an element. Como parte de esa lógica, las propiedades de dependencia que cambian el valor efectivo y AffectsParentMeasure tienen los true metadatos establecidos en iniciarán una solicitud diferida para invalidar los objetos visuales para el elemento primario.As part of that logic, dependency properties that change effective value and have metadata with AffectsParentMeasure set to true will initiate a deferred request to invalidate the visuals for the parent element. Dado que esta implementación de nivel de marco de WPF ya está en su lugar, normalmente no es necesario buscar las propiedades AffectsParentMeasure de dependencia con, a menos que se reemplace o modifique sustancialmente el comportamiento del diseño de nivel de marco de WPF.Because this WPF framework-level implementation is already in place, you typically do not need to look for dependency properties with AffectsParentMeasure unless you are substantially replacing or modifying the WPF framework-level layout behavior.

Por lo general, no es necesario notificar los cambios FrameworkElement de una propiedad a un elemento AffectsParentMeasure primario mediante, ya que el propio elemento tendría AffectsMeasure también trueel suyo propio.Generally, you do not need to report changes of a FrameworkElement property to a parent element using AffectsParentMeasure because the element itself would already have its own AffectsMeasure as true. Esto suele ser suficiente, ya que los cambios en el elemento secundario generalmente inician un paso de medida primario cuando sea necesario.That is usually sufficient, because changes in the child element generally initiate a parent measure pass when appropriate. AffectsParentMeasurea veces se usa para FrameworkContentElement una clase derivada.AffectsParentMeasure is sometimes used for a FrameworkContentElement derived class. En este caso, el elemento secundario establece una propiedad, pero una FrameworkContentElement clase derivada no controla su propia representación.In this case, the child element sets a property, but a FrameworkContentElement derived class does not control its own rendering. La representación se controla mediante un FrameworkElement elemento primario que actúa como el host de contenido.The rendering is handled by a FrameworkElement parent element that serves as the content host. Por ejemplo, un cambio en el valor de la Paragraph.KeepWithNext propiedad por un elemento secundario invalida la medida del elemento primario, ya que el espaciado relativo de los párrafos puede cambiar y puede aumentar o disminuir el tamaño del host de contenido.For instance, a change to the value of the Paragraph.KeepWithNext property by a child element invalidates measure of the parent, because the relative spacing of paragraphs might change and might increase or decrease the content host size. Por lo tanto Paragraph.KeepWithNext , la propiedad tiene AffectsParentMeasure metadatos donde es true.Therefore, the Paragraph.KeepWithNext property has metadata where AffectsParentMeasure is true.

Los elementos de host de contenido también buscan cambios con frecuencia en AffectsParentMeasure las truepropiedades de dependencia donde es, como parte de la lógica de representación de host de contenido.Content host elements also frequently look for changes in dependency properties where AffectsParentMeasure is true, as part of content host rendering logic. Por ejemplo, el TextBox elemento debe responder a determinados cambios dentro del texto que podrían requerir que se cambie el rectángulo TextBox de selección del mismo.For instance, the TextBox element must respond to certain changes within text that might require that the bounding box of the TextBox itself be changed.

Las OnPropertyChanged implementaciones personalizadas pueden elegir tener un comportamiento similar para los cambios de AffectsParentMeasure propiedad truede dependencia donde es.Custom OnPropertyChanged implementations might choose to have similar behavior for dependency property changes where AffectsParentMeasure is true.

Las propiedades de cualquier clase derivada PropertyMetadata de se definen normalmente en el modelo de objetos como de lectura y escritura.Properties on any derived classes of PropertyMetadata are typically defined in the object model as read-write. Esto es para que se puedan ajustar después de la inicialización de la instancia.This is so they can be adjusted after initialization of the instance. Sin embargo, después de que se consuman los metadatos Registercomo AddOwnerparte de OverrideMetadatauna llamada a, o, el sistema de propiedades sellará esa instancia de metadatos y las propiedades que transmiten los detalles de los metadatos se consideran ahora inmutables.However, after the metadata is consumed as part of a call to Register, AddOwner, or OverrideMetadata, the property system will seal that metadata instance and properties that convey the specifics of the metadata are now considered immutable. Si se IsSealed true intenta establecer esta propiedad después de en esta instancia de metadatos, se producirá una excepción.Attempting to set this property after IsSealed is true on this metadata instance will raise an exception.

Uso de texto XAMLXAML Text Usage

Los miembros de esta clase no se utilizan normalmente XAMLXAMLen.Members of this class are not typically used in XAMLXAML.

Se aplica a

Consulte también: