DependencyProperty Třída

Definice

Představuje vlastnost, která se dá nastavit pomocí metod, jako jsou styly, 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
DependencyProperty
Atributy

Poznámky

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

  • Vlastnost lze nastavit ve stylu. Další informace najdete v tématu Styling a Templating.

  • 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í 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 vyměněna. Další informace najdete v tématu Zpětné volání vlastností závislostí a ověřování.

  • Vlastnost hlásí informace WPF, například zda změna hodnoty vlastnosti by měla vyžadovat, aby systém rozložení znovu zkompiluje 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 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. 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. Pokud chcete nastavit připojenou vlastnost v XAML, použijte vlastnost ownerType. syntaxe propertyName . 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í oborů 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řed předponou oboru názvů XML. Toto použití platí zejména pro pozdní styly a šablony, kde musí být vlastník vlastnosti závislosti zadán pro parsování kontextu, protože TargetType ještě není známý. Další informace najdete v tématu Styling a Templating.

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řed předponou 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 DependencyPropertykód .

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

Viz také