PropertyMetadata.Create メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
Create(Object) |
依存関係プロパティの固定既定値を指定して、 PropertyMetadata 値を作成します。 |
Create(CreateDefaultValueCallback) |
PropertyMetadata 値を作成し、依存関係プロパティの既定値を確立するコールバックを指定します。 |
Create(Object, PropertyChangedCallback) |
PropertyMetadata 値を作成し、依存関係プロパティの固定既定値とプロパティ変更コールバックを指定します。 |
Create(CreateDefaultValueCallback, PropertyChangedCallback) |
PropertyMetadata 値を作成し、依存関係プロパティの既定値を確立するコールバックと、プロパティ変更コールバックを指定します。 |
Create(Object)
依存関係プロパティの固定既定値を指定して、 PropertyMetadata 値を作成します。
/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateWithDefaultValue")]
static PropertyMetadata Create(IInspectable const& defaultValue);
[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateWithDefaultValue")]
public static PropertyMetadata Create(object defaultValue);
function create(defaultValue)
Public Shared Function Create (defaultValue As Object) As PropertyMetadata
パラメーター
- defaultValue
-
Object
IInspectable
適用する依存関係プロパティの既定値。
戻り値
新しく作成された依存関係プロパティのメタデータ。
- 属性
こちらもご覧ください
- Create(Object, PropertyChangedCallback)
- Create(CreateDefaultValueCallback)
- Create(CreateDefaultValueCallback, PropertyChangedCallback)
適用対象
Create(CreateDefaultValueCallback)
PropertyMetadata 値を作成し、依存関係プロパティの既定値を確立するコールバックを指定します。
/// [Windows.Foundation.Metadata.Overload("CreateWithFactory")]
static PropertyMetadata Create(CreateDefaultValueCallback const& createDefaultValueCallback);
[Windows.Foundation.Metadata.Overload("CreateWithFactory")]
public static PropertyMetadata Create(CreateDefaultValueCallback createDefaultValueCallback);
function create(createDefaultValueCallback)
Public Shared Function Create (createDefaultValueCallback As CreateDefaultValueCallback) As PropertyMetadata
パラメーター
- createDefaultValueCallback
- CreateDefaultValueCallback
既定のプロパティ値を提供するコールバック メソッドへの参照。
戻り値
新しく作成された依存関係プロパティのメタデータ。
- 属性
例
この例では、カスタム依存関係プロパティ のシナリオで CreateDefaultValueCallback を使用するための擬似コードを示します。 具体的には、DependencyProperty.Register 呼び出しで使用される PropertyMetadata が作成されます (表示されません)。
PropertyMetadata metadata = PropertyMetadata.Create(
new CreateDefaultValueCallback(() =>
{
return new CustomClass() //a DependencyObject
{
CustomProperty1 = "default", //DependencyProperty of type String
CustomProperty2 = -1; //DependencyProperty of type Int32
}
})
注釈
依存関係プロパティの既定値がスレッド バインドである可能性がある場合は、固定定数の既定値の代わりに CreateDefaultValueCallback を使用します。 CreateDefaultValueCallback は、メイン UI スレッド以外のスレッドでプロパティの既定値を取得する必要がある場合に常に、既定値のファクトリになります。
依存関係プロパティの CreateDefaultValueCallback パターンを確立するには、プロパティのメタデータを定義するときに PropertyMetadata コンストラクターを使用する代わりに、静的な Create メソッドのいずれかを使用します。 そのメタデータは Register 呼び 出しに送信されます。 詳しくは、「カスタム依存関係プロパティ」をご覧ください。 プロパティ変更コールバックと同様に、 CreateDefaultValueCallback メソッドは、依存関係プロパティを登録する型の静的メソッドである必要があります。 メソッドをパブリックにする必要はありません。
こちらもご覧ください
- Create(Object)
- Create(Object, PropertyChangedCallback)
- Create(CreateDefaultValueCallback, PropertyChangedCallback)
- カスタム依存関係プロパティ
- 依存関係プロパティの概要
適用対象
Create(Object, PropertyChangedCallback)
PropertyMetadata 値を作成し、依存関係プロパティの固定既定値とプロパティ変更コールバックを指定します。
/// [Windows.Foundation.Metadata.DefaultOverload]
/// [Windows.Foundation.Metadata.Overload("CreateWithDefaultValueAndCallback")]
static PropertyMetadata Create(IInspectable const& defaultValue, PropertyChangedCallback const& propertyChangedCallback);
[Windows.Foundation.Metadata.DefaultOverload]
[Windows.Foundation.Metadata.Overload("CreateWithDefaultValueAndCallback")]
public static PropertyMetadata Create(object defaultValue, PropertyChangedCallback propertyChangedCallback);
function create(defaultValue, propertyChangedCallback)
Public Shared Function Create (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback) As PropertyMetadata
パラメーター
- defaultValue
-
Object
IInspectable
適用する依存関係プロパティの既定値。
- propertyChangedCallback
- PropertyChangedCallback
依存関係プロパティの値が変更されたときにプロパティ システムによって呼び出されるコールバック メソッドへの参照。
戻り値
新しく作成された依存関係プロパティのメタデータ。
- 属性
こちらもご覧ください
- Create(Object)
- Create(CreateDefaultValueCallback)
- Create(CreateDefaultValueCallback, PropertyChangedCallback)
適用対象
Create(CreateDefaultValueCallback, PropertyChangedCallback)
PropertyMetadata 値を作成し、依存関係プロパティの既定値を確立するコールバックと、プロパティ変更コールバックを指定します。
/// [Windows.Foundation.Metadata.Overload("CreateWithFactoryAndCallback")]
static PropertyMetadata Create(CreateDefaultValueCallback const& createDefaultValueCallback, PropertyChangedCallback const& propertyChangedCallback);
[Windows.Foundation.Metadata.Overload("CreateWithFactoryAndCallback")]
public static PropertyMetadata Create(CreateDefaultValueCallback createDefaultValueCallback, PropertyChangedCallback propertyChangedCallback);
function create(createDefaultValueCallback, propertyChangedCallback)
Public Shared Function Create (createDefaultValueCallback As CreateDefaultValueCallback, propertyChangedCallback As PropertyChangedCallback) As PropertyMetadata
パラメーター
- createDefaultValueCallback
- CreateDefaultValueCallback
既定のプロパティ値を提供するコールバック メソッドへの参照。
- propertyChangedCallback
- PropertyChangedCallback
依存関係プロパティの値が変更されたときにプロパティ システムによって呼び出されるコールバック メソッドへの参照。
戻り値
新しく作成された依存関係プロパティのメタデータ。
- 属性
こちらもご覧ください
- Create(Object)
- Create(Object, PropertyChangedCallback)
- Create(CreateDefaultValueCallback)
- カスタム依存関係プロパティ
- 依存関係プロパティの概要