FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender Vlastnost

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Získá nebo nastaví hodnotu, která označuje, zda dílčí vlastnosti vlastnosti závislosti nemají vliv na vykreslování obsahující objekt.

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

Hodnota vlastnosti

Boolean

truepokud změny hodnot dílčí vlastnosti nemají vliv na vykreslení v případě změny; v opačném případě . false Výchozí formát je false.

Výjimky

InvalidOperationException

Metadata již byla použita pro operaci vlastnosti závislosti, takže metadata jsou zapečetěna a vlastnosti metadat nelze nastavit.

Poznámky

Tato možnost metadat je relevantní pro vlastnosti závislostí, které jsou odkazovými typy, kde tento typ má vlastní hodnoty vlastností. Systémová logika rozložení obvykle předpokládá, že rozložení ovlivní libovolná vlastnost závislosti s dílčími vlastnostmi, protože kontrola změn ve všech dílčích vlastnostech je časově náročnější než spuštění jiného průchodu vykreslování. Nastavení této možnosti na true hodnotu je užitečné pro optimalizaci výkonu implementace systému rozložení na úrovni architektury WPF.

Vlastnosti odvozených tříd třídy PropertyMetadata jsou obvykle definovány v objektovém modelu jako pro čtení i zápis. Je to proto, aby bylo možné je po inicializaci instance upravit. Jakmile se však metadata spotřebují jako součást volání Register, AddOwnernebo OverrideMetadata, systém vlastností zapečetí, že instance metadat a vlastnosti, které vyjadřují specifika metadat, jsou nyní považovány za neměnné. Pokus o nastavení této vlastnosti po IsSealed je true na této instanci metadat vyvolá výjimku.

Použití textu XAML

Členy této třídy se obvykle nepoužívají v jazyce XAML.

Viz také

• Freezable