DependencyProperty Třída

Definice

Obor názvů:

System.Windows

Sestavení:

WindowsBase.dll

Představuje vlastnost, kterou lze nastavit prostřednictvím metod, jako jsou styling, datové vazby, animace a dědičnost.

public ref class DependencyProperty sealed

[System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")]
public sealed class DependencyProperty

[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class

Public NotInheritable Class DependencyProperty

Dědičnost

Object

DependencyProperty

Atributy

TypeConverterAttribute

Poznámky

A DependencyProperty podporuje následující funkce ve Windows Presentation Foundation (WPF):

• Vlastnost lze nastavit ve stylu. Další informace naleznete v tématu Styling a Šablonování.

• Vlastnost lze nastavit prostřednictvím datové vazby. Další informace o vlastnostech závislostí datové vazby naleznete v tématu Postupy: Vytvoření vazby vlastností dvou ovládacích prvků.

• Vlastnost lze nastavit pomocí odkazu na dynamický prostředek. Další informace najdete v tématu Prostředky XAML.

• Vlastnost může dědit jeho hodnotu automaticky z nadřazeného prvku ve stromu elementu. Další informace naleznete v tématu Dědičnost hodnot vlastností.

• Vlastnost může být animovaná. Další informace naleznete v tématu Přehled animace.

• Vlastnost může hlásit, když byla změněna předchozí hodnota vlastnosti a hodnota vlastnosti může být vyřazena. Další informace naleznete v tématu Zpětné volání vlastností závislostí a ověření.

• Vlastnost hlásí informace WPF, například zda změna hodnoty vlastnosti by měla vyžadovat, aby systém rozložení rekompose vizuály pro prvek.

• Tato vlastnost obdrží podporu v návrháři WPF pro Visual Studio. Vlastnost lze například upravit v okně Vlastnosti .

Další informace o vlastnostech závislostí najdete v tématu Přehled vlastností závislostí. Pokud chcete, aby vlastnosti vlastních typů podporovaly možnosti v předchozím seznamu, měli byste vytvořit vlastnost závislosti. Informace o vytváření vlastních vlastností závislostí najdete v tématu Vlastní vlastnosti závislostí.

Připojená vlastnost je vlastnost, která umožňuje libovolnému objektu hlásit informace typu, který definuje připojenou vlastnost. Ve WPF může jakýkoli typ, který dědí z DependencyObject , použít připojenou vlastnost bez ohledu na to, zda typ dědí z typu, který definuje vlastnost. Připojená vlastnost je funkce jazyka XAML. Chcete-li nastavit připojenou vlastnost v XAML, použijte ownerType. propertyName syntaxe. Příkladem připojené vlastnosti je DockPanel.Dock vlastnost. Pokud chcete vytvořit vlastnost, kterou lze použít pro všechny DependencyObject typy, měli byste vytvořit připojenou vlastnost. Další informace o připojených vlastnostech, včetně postupu jejich vytvoření, najdete v tématu Přehled připojených vlastností.

Použití atributu XAML

<object property="dependencyPropertyName"/>

-nebo-

<object property="ownerType.dependencyPropertyName"/>

-nebo-

<object property="attachedPropertyOwnerType.attachedPropertyName"/>

Hodnoty XAML

dependencyPropertyName Řetězec, který určuje DependencyProperty.Name požadovanou vlastnost závislosti. Před tím může předcházet předpona oboru názvů XML, pokud tato vlastnost není ve výchozím oboru názvů XML (podrobnosti najdete v tématu Obory názvů XAML a mapování oboru názvů pro WPF XAML.)

ownerType. dependencyPropertyName Řetězec, který určuje typ vlastníka vlastnosti závislosti, tečku (.), pak DependencyProperty.Name. ownerType může předcházet také předpona oboru názvů XML. Toto použití je specifické pro styly a šablony s pozdní vazbou, kde musí být vlastník vlastnosti závislosti určen pro analýzu kontextu, protože TargetType dosud není známý. Další informace naleznete v tématu Styling a Šablonování.

attachedPropertyOwnerType .attachedPropertyName Řetězec, který určuje vlastníka připojené vlastnosti, tečku (.), pak název připojené vlastnosti. attachedPropertyOwnerType může předcházet také předpona oboru názvů XML.

Pole

Name	Description
UnsetValue	Určuje statickou hodnotu, kterou používá systém vlastností WPF, nikoli null k označení, že vlastnost existuje, ale nemá její hodnotu nastavenou systémem vlastností.

Vlastnosti

Name	Description
DefaultMetadata	Získá výchozí metadata vlastnosti závislosti.
GlobalIndex	Získá interně vygenerovanou hodnotu, která jedinečně identifikuje vlastnost závislosti.
Name	Získá název vlastnosti závislosti.
OwnerType	Získá typ objektu, který zaregistroval vlastnost závislosti v systému vlastností, nebo sám jako vlastník vlastnosti.
PropertyType	Získá typ, který vlastnost závislosti používá pro jeho hodnotu.
ReadOnly	Získá hodnotu, která určuje, zda závislost vlastnost identifikovaná touto DependencyProperty instancí je závislost jen pro čtení vlastnost.
ValidateValueCallback	Získá zpětná volání ověření hodnoty pro vlastnost závislosti.

Metody

Name	Description
AddOwner(Type, PropertyMetadata)	Přidá další typ jako vlastníka vlastnosti závislosti, která již byla zaregistrována a poskytuje metadata vlastností závislostí pro vlastnost závislosti, protože bude existovat u zadaného typu vlastníka.
AddOwner(Type)	Přidá další typ jako vlastníka vlastnosti závislosti, která již byla zaregistrována.
GetHashCode()	Vrátí kód hash pro tento DependencyPropertykód .
GetMetadata(DependencyObject)	Vrátí metadata pro tuto vlastnost závislosti, protože existuje v zadané instanci objektu.
GetMetadata(DependencyObjectType)	Vrátí metadata pro tuto vlastnost závislosti, protože existuje v zadaném typu.
GetMetadata(Type)	Vrátí metadata pro tuto vlastnost závislosti, protože existuje u zadaného existujícího typu.
IsValidType(Object)	Určuje, zda je zadaná hodnota pro typ této vlastnosti závislosti přijatelná, jak je zaškrtnuto proti typu vlastnosti zadané v původní registraci vlastnosti závislosti.
IsValidValue(Object)	Určuje, zda je zadaná hodnota přijata pro typ vlastnosti prostřednictvím základní kontroly typů, a také pokud je v povoleném rozsahu hodnot pro daný typ.
OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)	Poskytuje alternativní metadata pro vlastnost závislostí jen pro čtení, pokud je přítomna na instancích zadaného typu, přepsání metadat, která byla zadána v počáteční registraci vlastnosti závislosti. Aby se zabránilo vyvolání výjimky, musíte předat DependencyPropertyKey vlastnost závislosti jen pro čtení.
OverrideMetadata(Type, PropertyMetadata)	Určuje alternativní metadata pro tuto vlastnost závislosti, pokud je přítomna na instancích zadaného typu, přepsání metadat, která existovala pro vlastnost závislosti, protože byla zděděna ze základních typů.
Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření hodnoty pro vlastnost.
Register(String, Type, Type, PropertyMetadata)	Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka a metadaty vlastností.
Register(String, Type, Type)	Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.
RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Zaregistruje připojenou vlastnost se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětném voláním ověření hodnoty pro vlastnost.
RegisterAttached(String, Type, Type, PropertyMetadata)	Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti, typem vlastníka a metadaty vlastností.
RegisterAttached(String, Type, Type)	Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Zaregistruje připojenou vlastnost jen pro čtení se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)	Zaregistruje připojenou vlastnost jen pro čtení se zadaným typem vlastnosti, typem vlastníka a metadaty vlastností.
RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)	Zaregistruje vlastnost závislostí jen pro čtení se zadaným typem vlastnosti, typem vlastníka, metadaty vlastností a zpětným voláním ověření.
RegisterReadOnly(String, Type, Type, PropertyMetadata)	Zaregistruje vlastnost závislostí jen pro čtení se zadaným typem vlastnosti, typem vlastníka a metadaty vlastností.
ToString()	Vrátí řetězcovou reprezentaci vlastnosti závislosti.

Viz také

• DependencyObject
• DependencyPropertyHelper