FrameworkPropertyMetadata.AffectsParentArrange Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví hodnotu, která určuje, zda vlastnost závislosti potenciálně ovlivňuje předávání rozložení nadřazeného elementu během operací modulu rozložení rozložení.
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
Hodnota vlastnosti
truepokud vlastnost závislosti, na které tato metadata existuje, může mít vliv na předávání uspořádat speciálně pro jeho nadřazený prvek; v opačném případě . false Výchozí hodnota je false.
Výjimky
Metadata již byla použita na operaci vlastnosti závislosti, takže metadata jsou zapečetěná a vlastnosti metadat nelze nastavit.
Poznámky
FrameworkElement a FrameworkContentElement zahrnout implementaci OnPropertyChanged , která monitoruje efektivní změny hodnot ve všech vlastnostech závislostí, které existují v elementu. V rámci této logiky vlastnosti závislostí, které mění efektivní hodnotu a mají metadata s AffectsParentArrange nastavenou true nastavenou hodnotou, zahájí odložený požadavek na zneplatnění vizuálů pro nadřazený prvek.
Obecně není nutné hlásit změny FrameworkElement vlastnosti nadřazeného prvku pomocí, AffectsParentArrange protože samotný prvek by již měl vlastní AffectsArrange jako true. To obvykle stačí, protože změny v podřízeného prvku obvykle iniciují nadřazené uspořádání, pokud je to vhodné.
AffectsParentArrange někdy se používá pro odvozenou FrameworkContentElement třídu. V tomto případě podřízený prvek nastaví vlastnost, ale odvozená FrameworkContentElement třída neřídí vlastní vykreslování. Vykreslování zpracovává FrameworkElement nadřazený prvek, který slouží jako hostitel obsahu. Například změna hodnoty FixedPage.Left připojené vlastnosti podřízeným elementem zneplatňuje uspořádání nadřazeného objektu, protože umístění podřízené položky v nadřazeném objektu musí být změněno. Proto připojená FixedPage.Left vlastnost má metadata, kde AffectsParentArrange je true. Dalším příkladem je, že Paddingkdyž se tato vlastnost změní, může nadřazený objekt změnit umístění podřízeného objektu v závislosti na dostupném prostoru.
Vzhledem k tomu, že implementace na úrovni architektury WPF (Windows Presentation Foundation) je již zavedená, obvykle nemusíte hledat vlastnosti AffectsParentArrange závislostí, pokud podstatně nenahrazujete nebo upravujete chování rozložení na úrovni architektury WPF (Windows Presentation Foundation).
Vlastní OnPropertyChanged implementace můžou mít podobné chování pro změny vlastností závislostí, kde AffectsParentArrange je true.
Vlastnosti pro všechny odvozené třídy PropertyMetadata jsou obvykle definovány v objektovém modelu jako čtení a zápis. To znamená, že je lze upravit po inicializaci instance. 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é předávají specifika metadat, jsou nyní považovány za neměnné. Při pokusu o nastavení této vlastnosti po IsSealed použití true této instance metadat dojde k výjimce.
Použití textu XAML
Členy této třídy se obvykle nepoužívají v JAZYCE XAML.