FrameworkPropertyMetadata.AffectsParentArrange FrameworkPropertyMetadata.AffectsParentArrange FrameworkPropertyMetadata.AffectsParentArrange FrameworkPropertyMetadata.AffectsParentArrange Property

Definición

Obtiene o establece un valor que indica si una propiedad de dependencia afecta potencialmente al paso de organizació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 arrange pass of its parent element's layout during layout engine operations.

public:
 property bool AffectsParentArrange { bool get(); void set(bool value); };
public bool AffectsParentArrange { get; set; }
member this.AffectsParentArrange : bool with get, set
Public Property AffectsParentArrange As Boolean

Valor de propiedad

true si la propiedad de dependencia en la que existen estos metadatos afecta potencialmente al paso de organización, específicamente en su elemento principal; de lo contrario, false.true if the dependency property on which this metadata exists potentially affects the arrange pass specifically on its parent element; otherwise, false. De manera predeterminada, es 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

FrameworkElement y FrameworkContentElement incluyen una implementación de OnPropertyChanged que supervisa los cambios de valor efectivo 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 en vigor, valor y tienen los metadatos con AffectsParentArrange establecido en true iniciará una solicitud diferida para invalidar los elementos visuales del elemento primario.As part of that logic, dependency properties that change effective value and have metadata with AffectsParentArrange set to true will initiate a deferred request to invalidate the visuals for the parent element.

Por lo general, no es necesario para notificar los cambios de un FrameworkElement propiedad a un elemento primario mediante AffectsParentArrange porque el propio elemento ya tendría su propia AffectsArrange como true.Generally, you do not need to report changes of a FrameworkElement property to a parent element using AffectsParentArrange because the element itself would already have its own AffectsArrange as true. Que generalmente es suficiente, ya que generalmente se inician los cambios en el elemento secundario primario organizar cuando corresponda.That is usually sufficient, because changes in the child element generally initiate a parent arrange when appropriate. AffectsParentArrange a veces se usa para un FrameworkContentElement clase derivada.AffectsParentArrange is sometimes used for a FrameworkContentElement derived class. En este caso, los conjuntos de elementos secundarios una propiedad, pero un 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 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 FixedPage.Left propiedad adjunta un elemento secundario invalida organizar del elemento primario, ya que se debe cambiar la posición del elemento secundario en el elemento primario.For instance, a change to the value of the FixedPage.Left attached property by a child element invalidates arrange of the parent, because the position of the child in the parent must be changed. Por lo tanto, el FixedPage.Left propiedad adjunta tiene metadatos donde AffectsParentArrange es true.Therefore, the FixedPage.Left attached property has metadata where AffectsParentArrange is true. Otro ejemplo es Padding; cuando se cambia esta propiedad, el elemento primario puede cambiar la posición del elemento secundario, según el espacio disponible.Another example is Padding; when this property changes, the parent might change the positioning of the child, depending on available space.

Dado que esta implementación de nivel de marco WPF ya está en su lugar, normalmente no es necesario buscar las propiedades de dependencia con AffectsParentArrange a menos que esencialmente va a reemplazar o modificar el comportamiento de diseño de nivel de marco WPF.Because this WPF framework-level implementation is already in place, you typically do not need to look for dependency properties with AffectsParentArrange unless you are substantially replacing or modifying the WPF framework-level layout behavior.

Custom OnPropertyChanged implementaciones pueden optar por tener un comportamiento similar para los cambios de propiedad de dependencia donde AffectsParentArrange es true.Custom OnPropertyChanged implementations might choose to have similar behavior for dependency property changes where AffectsParentArrange is true.

Las propiedades en cualquier las clases derivan de PropertyMetadata normalmente se definen en el modelo de objetos de lectura y escritura.Properties on any derived classes of PropertyMetadata are typically defined in the object model as read-write. Esto es por lo que se pueden 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 los metadatos se consumen como parte de una llamada a Register, AddOwner, o OverrideMetadata, el sistema de propiedades sellar esa instancia de metadatos y propiedades que contienen los detalles de los metadatos se consideran 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. Se intentó establecer esta propiedad después de IsSealed es true en los metadatos de esta instancia genera 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 usan normalmente en XAMLXAML.Members of this class are not typically used in XAMLXAML.

Se aplica a

Consulte también: