PropertyMetadata.Create 方法

定義

命名空間:

Windows.UI.Xaml

多載

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

要套用的相依性屬性預設值。

傳回

PropertyMetadata

新建立的相依性屬性中繼資料。

屬性

DefaultOverloadAttribute OverloadAttribute

另請參閱

• 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

提供預設屬性值之回呼方法的參考。

傳回

PropertyMetadata

新建立的相依性屬性中繼資料。

屬性

OverloadAttribute

範例

此範例示範在自訂相依性屬性案例中使用 CreateDefaultValueCallback 的虛擬程式碼。 具體而言，這會建立 PropertyMetadata 以用於 DependencyProperty.Register 呼叫 (未顯示) 。

PropertyMetadata metadata = PropertyMetadata.Create(
    new CreateDefaultValueCallback(() =>
    {
        return new CustomClass() //a DependencyObject
        {
            CustomProperty1 = "default", //DependencyProperty of type String 
            CustomProperty2 = -1; //DependencyProperty of type Int32
        }
    })

備註

在相依性屬性的預設值可能是執行緒系結的情況下，請使用 CreateDefaultValueCallback ，而不是固定的常數預設值。 每當需要取得主要 UI 執行緒以外的執行緒上屬性的預設值時， CreateDefaultValueCallback 就會變成預設值的處理站。

若要建立相依性屬性的 CreateDefaultValueCallback 模式，請在定義屬性的中繼資料時，使用其中一個靜態 Create 方法，而不是使用 PropertyMetadata 建構函式。 該中繼資料會提交至 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

當相依性屬性值變更時，由屬性系統叫用的回呼方法參考。

傳回

PropertyMetadata

新建立的相依性屬性中繼資料。

屬性

DefaultOverloadAttribute OverloadAttribute

另請參閱

• 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

當相依性屬性值變更時，由屬性系統叫用的回呼方法參考。

傳回

PropertyMetadata

新建立的相依性屬性中繼資料。

屬性

OverloadAttribute

另請參閱

• Create(Object)
• Create(Object, PropertyChangedCallback)
• Create(CreateDefaultValueCallback)
• 自訂相依性屬性
• 相依性屬性概觀