DependencyProperty クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
スタイル設定、データ バインディング、アニメーション、および継承などの方法によって設定できるプロパティを表します。
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
- 継承
-
DependencyProperty
- 属性
注釈
A はDependencyProperty、Windows Presentation Foundation (WPF) で次の機能をサポートします。
プロパティはスタイルで設定できます。 詳しくは、「 スタイルとテンプレート」をご覧ください。
プロパティは、データ バインディングを使用して設定できます。 データ バインディングの依存関係プロパティの詳細については、「 方法: 2 つのコントロールのプロパティをバインドする」を参照してください。
プロパティは、動的リソース参照を使用して設定できます。 詳細については、「XAML リソース」を参照してください。
このプロパティは、要素ツリー内の親要素から値を自動的に継承できます。 詳細については、「プロパティ値の継承」を参照してください。
プロパティはアニメーション化できます。 詳しくは、「 アニメーションの概要」をご覧ください。
プロパティは、プロパティの以前の値が変更され、プロパティ値を強制化できる場合に報告できます。 詳しくは、「依存関係プロパティのコールバックと検証」を参照してください。
プロパティは、プロパティ値の変更に要素のビジュアルを再計算するためにレイアウト システムが必要かどうかなどの情報を WPF に報告します。
このプロパティは、WPF Designer for Visual Studio でサポートを受けます。 たとえば、[プロパティ ] ウィンドウで プロパティを編集できます。
依存関係プロパティの詳細については、「 依存関係プロパティの概要」を参照してください。 カスタム型のプロパティで上記の一覧の機能をサポートする場合は、依存関係プロパティを作成する必要があります。 カスタム依存関係プロパティを作成する方法については、「 カスタム依存関係プロパティ」を参照してください。
添付プロパティは、添付プロパティを定義する型に情報を報告するオブジェクトを有効にするプロパティです。 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.Name. ownerType
の前に XML 名前空間プレフィックスを付けることもできます。 この使用法は、遅延バインディングのスタイルとテンプレートに固有です。依存関係プロパティの所有者は、まだ不明であるため TargetType
、コンテキストを解析するために指定する必要があります。 詳しくは、「 スタイルとテンプレート」をご覧ください。
attachedPropertyOwnerType
. attachedPropertyName
添付プロパティの所有者、ドット (.)、添付プロパティ名を指定する文字列。 attachedPropertyOwnerType
の前に XML 名前空間プレフィックスを付けることもできます。
フィールド
UnsetValue |
プロパティが存在することを示すのではなく |
プロパティ
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() |
依存関係プロパティの文字列表現を返します。 |