FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Property

Definition

Ruft einen Wert ab, der angibt, ob Untereigenschaften der Abhängigkeitseigenschaft keine Auswirkungen auf das Rendering des Containerobjekts haben, oder legt ihn fest.Gets or sets a value that indicates whether sub-properties of the dependency property do not affect the rendering of the containing object.

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

Eigenschaftswert

true, wenn sich Änderungen an untergeordneten Eigenschaftswerten nicht auf das Rendern auswirken, andernfalls false.true if changes to sub-property values do not affect rendering if changed; otherwise, false. Die Standardeinstellung ist false.The default is false.

Ausnahmen

Die Metadaten wurden bereits auf einen Vorgang der Abhängigkeitseigenschaft angewendet, sodass Metadaten versiegelt sind und keine Eigenschaften für Metadaten festgelegt werden können.The metadata has already been applied to a dependency property operation, so that metadata is sealed and properties of the metadata cannot be set.

Hinweise

Diese Metadatenoption ist für Abhängigkeits Eigenschaften relevant, bei denen es sich um Verweis Typen handelt, bei denen dieser Typ eigene Eigenschaftswerte aufweist.This metadata option is pertinent for dependency properties that are reference types, where that type has property values of its own. In der Regel ist die layoutsystemlogik davon auszugehen, dass sich jede Abhängigkeits Eigenschaft mit untergeordneten Eigenschaften möglicherweise auf das Layout auswirkt, da das Überprüfen aller unter Eigenschaften auf Änderungen zeitaufwändiger ist, als ein anderer renderdurchlauf tatsächlich ausgeführt wird.Typically, the layout system logic is to assume that any dependency property with sub-properties potentially will affect layout, because checking all sub-properties for changes is more time consuming than actually running another render pass. Wenn diese Option auf true festgelegt wird, ist es hilfreich, die Leistung der WPF-frameworklayoutsystemimplementierung zu optimieren.Setting this option to true is useful for optimizing performance of the WPF framework level layout system implementation.

Eigenschaften für abgeleitete Klassen PropertyMetadata von werden in der Regel im Objektmodell als Lese-/Schreibzugriff definiert.Properties on derived classes of PropertyMetadata are typically defined in the object model as read-write. So können Sie nach der Initialisierung der-Instanz angepasst werden.This is so they can be adjusted after initialization of the instance. Sobald die Metadaten jedoch im Rahmen eines Aufrufes Registervon, AddOwneroder OverrideMetadataverwendet werden, versiegelt das Eigenschaften System, dass die Metadateninstanz und die Eigenschaften, die die Besonderheiten der Metadaten vermitteln, jetzt als unveränderlich angesehen werden.However, once 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. Wenn Sie versuchen, diese Eigenschaft IsSealed fest true zulegen, nachdem auf dieser Metadateninstanz ist, wird eine Ausnahme ausgelöst.Attempting to set this property after IsSealed is true on this metadata instance will raise an exception.

Verwendung von XAML-TextXAML Text Usage

Member dieser Klasse werden in der Regel nicht in XAMLXAMLverwendet.Members of this class are not typically used in XAMLXAML.

Gilt für:

Siehe auch