DependencyProperty Třída

Reference

Definice

Obor názvů:: System.Windows

Sestavení:: WindowsBase.dll

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í.

Představuje vlastnost, která 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=3.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")]
public sealed class DependencyProperty

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

[<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 v 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í vazby dat naleznete v tématu Postupy: Vytvoření vazby vlastností dvou ovládacích prvků.
Vlastnost lze nastavit pomocí dynamického odkazu na 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 najdete v tématu Přehled animací.
Vlastnost může hlásit, když byla změněna předchozí hodnota vlastnosti a hodnota vlastnosti může být vynucena. 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í znovu rozložil vizuály pro prvek.
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 funkce 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 o typu, který definuje připojenou vlastnost. V 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ávislostí. 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čka (.), pak DependencyProperty.Name. ownerType předponou oboru názvů XML může být také uvedena předpona oboru názvů XML. Toto použití je specifické pro opožděné styly a šablony, kde vlastník vlastnosti závislosti musí být zadán pro parsování 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 předponou oboru názvů XML může být také uvedena předpona oboru názvů XML.

Pole

UnsetValue

Určuje statickou hodnotu, která je používána systémem vlastností WPF namísto null označení, že vlastnost existuje, ale nemá její hodnotu nastavenou systémem vlastností.

Vlastnosti

DefaultMetadata	Získá výchozí metadata vlastnosti závislosti.
GlobalIndex	Získá interně vygenerovanou hodnotu, která jedinečně identifikuje závislost vlastnost.
Name	Získá název vlastnosti závislosti.
OwnerType	Získá typ objektu, který zaregistroval závislost vlastnost systému vlastností, nebo přidat sám jako vlastník vlastnosti.
PropertyType	Získá typ, který vlastnost závislost používá pro jeho hodnotu.
ReadOnly	Získá hodnotu, která označ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

AddOwner(Type)	Přidá další typ jako vlastníka vlastnosti závislosti, která již byla zaregistrována.
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ávislost, protože bude existovat u zadaného typu vlastníka.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Vrátí kód hash pro tento DependencyProperty.
GetMetadata(DependencyObject)	Vrátí metadata této vlastnosti závislosti, protože existuje v zadané instanci objektu.
GetMetadata(DependencyObjectType)	Vrátí metadata této vlastnosti závislosti, protože existuje u zadaného typu.
GetMetadata(Type)	Vrátí metadata této vlastnosti závislosti, protože existuje u zadaného existujícího typu.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
IsValidType(Object)	Určuje, zda je zadaná hodnota přijatelná pro typ vlastnosti této závislosti, jak je zaškrtnuto proti typu vlastnosti zadané v původní registraci vlastnosti závislostí.
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.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
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ávislost, protože byla zděděna ze základních 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. Pokud se chcete vyhnout vyvolání výjimky, musíte předat DependencyPropertyKey vlastnost závislosti jen pro čtení.
Register(String, Type, Type)	Zaregistruje vlastnost závislosti se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.
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, 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.
RegisterAttached(String, Type, Type)	Zaregistruje připojenou vlastnost se zadaným názvem vlastnosti, typem vlastnosti a typem vlastníka.
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, 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.
RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)	Zaregistruje připojenou vlastnost jen pro čtení se zadaným typem vlastnosti, typem vlastníka a metadaty vlastností.
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í.
RegisterReadOnly(String, Type, Type, PropertyMetadata)	Zaregistruje vlastnost závislostí 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í.
ToString()	Vrátí řetězcovou reprezentaci vlastnosti závislosti.

Platí pro