DependencyProperty クラス

定義

スタイル設定、データ バインディング、アニメーション、および継承などの方法によって設定できるプロパティを表します。

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=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")>]
type DependencyProperty = class
[<System.ComponentModel.TypeConverter("System.Windows.Markup.DependencyPropertyConverter, PresentationFramework, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, Custom=null")>]
type DependencyProperty = class
Public NotInheritable Class DependencyProperty
継承
DependencyProperty
属性

注釈

DependencyProperty Windows Presentation Foundation (WPF) の次の機能をサポートしています。

  • プロパティは、スタイルで設定できます。 詳しくは、「 スタイルとテンプレート」をご覧ください。

  • プロパティは、データバインディングを使用して設定できます。 データバインディングの依存関係プロパティの詳細については、「 方法: 2 つのコントロールのプロパティをバインドする」を参照してください。

  • プロパティは、動的リソース参照を使用して設定できます。 詳細については、「XAML リソース」を参照してください。

  • プロパティは、要素ツリー内の親要素から自動的に値を継承できます。 詳細については、「プロパティ値の継承」を参照してください。

  • プロパティはアニメーション化できます。 詳しくは、「 アニメーションの概要」をご覧ください。

  • プロパティは、プロパティの前の値が変更されたときに報告でき、プロパティ値を強制的に変更できます。 詳しくは、「依存関係プロパティのコールバックと検証」を参照してください。

  • プロパティは、プロパティ値の変更によって、レイアウトシステムが要素のビジュアルを再構成する必要があるかどうかなどの情報を WPF に報告します。

  • プロパティは、Visual Studio の WPF デザイナーでサポートを受け取ります。 たとえば、プロパティは [ プロパティ ] ウィンドウで編集できます。

依存関係プロパティの詳細については、「 依存関係プロパティの概要」を参照してください。 カスタム型のプロパティで前の一覧の機能をサポートするには、依存関係プロパティを作成する必要があります。 カスタム依存関係プロパティを作成する方法については、「 カスタム依存関係プロパティ」を参照してください。

添付プロパティは、任意のオブジェクトが添付プロパティを定義する型に情報を報告できるようにするプロパティです。 WPF では、から継承されるすべての型は、 DependencyObject プロパティを定義する型から継承するかどうかに関係なく、添付プロパティを使用できます。 添付プロパティは、XAML 言語の機能です。 XAML で添付プロパティを設定するには、 ownerType を使用します。propertyName 構文。 添付プロパティの例としては、 DockPanel.Dock プロパティがあります。 すべての型で使用できるプロパティを作成する場合は DependencyObject 、添付プロパティを作成する必要があります。 添付プロパティの作成方法など、添付プロパティの詳細については、「 添付プロパティの概要」を参照してください。

XAML 属性の使用方法

<object property="dependencyPropertyName"/>  

- または -

<object property="ownerType.dependencyPropertyName"/>  

- または -

<object property="attachedPropertyOwnerType.attachedPropertyName"/>  

XAML 値

dependencyPropertyName
DependencyProperty.Name目的の依存関係プロパティのを指定する文字列。 このプロパティが既定の XML 名前空間にない場合は、前に XML 名前空間プレフィックスを付けることができます (詳細については、「 WPF xaml の Xaml 名前空間と名前空間のマッピング」を参照してください)。

ownerType.dependencyPropertyName
依存関係プロパティの所有者の種類、ドット (.)、およびを指定する文字列 DependencyProperty.NameownerType の前に XML 名前空間プレフィックスを付けることもできます。 この使用方法は、遅延バインディングされたスタイルとテンプレートに固有のものであり、がまだ知られていないため、コンテキストを解析するために依存関係プロパティの所有者を指定する必要があり TargetType ます。 詳しくは、「 スタイルとテンプレート」をご覧ください。

attachedPropertyOwnerType . attachedPropertyName
添付プロパティの所有者、ドット (.)、添付プロパティ名を指定する文字列。 attachedPropertyOwnerType の前に XML 名前空間プレフィックスを付けることもできます。

フィールド

UnsetValue

プロパティが存在することを示すのではなく、WPF プロパティシステムによって使用される静的な値を指定します。この値は、 null プロパティシステムによって設定されていません。

プロパティ

DefaultMetadata

依存関係プロパティの既定のメタデータを取得します。

GlobalIndex

依存関係プロパティを一意に識別する内部的に生成された値を取得します。

Name

依存関係プロパティの名前を取得します。

OwnerType

依存関係プロパティをプロパティ システムに登録したオブジェクト、または自身をプロパティの所有者として追加したオブジェクトの型を取得します。

PropertyType

依存関係プロパティの値の型を取得します。

ReadOnly

この DependencyProperty インスタンスによって識別される依存関係プロパティが読み取り専用の依存関係プロパティかどうかを示す値を取得します。

ValidateValueCallback

依存関係プロパティの値検証コールバックを取得します。

メソッド

AddOwner(Type)

登録済みの依存関係プロパティの所有者として、別の型を追加します。

AddOwner(Type, PropertyMetadata)

既に登録済みの依存関係プロパティの所有者として別の型を追加します。その際、提供される所有者の型に存在する依存関係プロパティに依存関係プロパティのメタデータを提供します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

この DependencyProperty のハッシュ コードを返します。

GetMetadata(DependencyObject)

この依存関係プロパティのメタデータが指定したオブジェクト インスタンスに存在する場合に、このメタデータを返します。

GetMetadata(DependencyObjectType)

指定した型に存在する場合の、この依存関係プロパティのメタデータを返します。

GetMetadata(Type)

指定した既存の型に存在する場合の、この依存関係プロパティのメタデータを返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
IsValidType(Object)

指定した値がこの依存関係プロパティの型で受け入れ可能かどうかを、依存関係プロパティの最初の登録で指定されたプロパティの型と照合することによって判断します。

IsValidValue(Object)

指定した値がプロパティの型で受け入れ可能かどうかを基本型チェックによって判断します。さらに、その型の有効値の範囲内にこの値があるかどうかを判断することもあります。

MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OverrideMetadata(Type, PropertyMetadata)

指定した型のインスタンスに存在する場合の代替メタデータをこの依存関係プロパティに提供し、基本型から継承されたときにこの依存関係プロパティに存在していたメタデータをオーバーライドします。

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

指定した型のインスタンスに存在する場合に代替メタデータを読み取り専用の依存関係プロパティに提供し、依存関係プロパティの最初の登録時に指定したメタデータをオーバーライドします。 例外の発生を防ぐために、読み取り専用の依存関係プロパティに DependencyPropertyKey を渡す必要があります。

Register(String, Type, Type)

プロパティ名、プロパティ型、所有者型を指定して、依存関係プロパティを登録します。

Register(String, Type, Type, PropertyMetadata)

プロパティ名、プロパティの型、所有者の型、プロパティ メタデータを指定して、依存関係プロパティを登録します。

Register(String, Type, Type, PropertyMetadata, ValidateValueCallback)

プロパティ名、プロパティ型、所有者型、プロパティ メタデータ、およびプロパティの値検証コールバックを指定して、依存関係プロパティを登録します。

RegisterAttached(String, Type, Type)

プロパティ名、プロパティ型、および所有者型を指定して、添付プロパティを登録します。

RegisterAttached(String, Type, Type, PropertyMetadata)

プロパティ名、プロパティの型、所有者の型、およびプロパティ メタデータを指定して、アタッチされるプロパティを登録します。

RegisterAttached(String, Type, Type, PropertyMetadata, ValidateValueCallback)

プロパティ型、所有者型、プロパティ メタデータ、および値の検証コールバックを指定して、添付プロパティを登録します。

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata)

プロパティ型、所有者型、およびプロパティ メタデータを指定して、読み取り専用の添付プロパティを登録します。

RegisterAttachedReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

プロパティ型、所有者型、プロパティ メタデータ、および検証コールバックを指定して、読み取り専用の添付プロパティを登録します。

RegisterReadOnly(String, Type, Type, PropertyMetadata)

プロパティ型、所有者型、プロパティ メタデータを指定して、読み取り専用の依存関係プロパティを登録します。

RegisterReadOnly(String, Type, Type, PropertyMetadata, ValidateValueCallback)

プロパティ型、所有者型、プロパティ メタデータ、および検証コールバックを指定して、読み取り専用の依存関係プロパティを登録します。

ToString()

依存関係プロパティの文字列表現を返します。

適用対象

こちらもご覧ください