語言

PropertyMetadata.Create 方法

定義

多載

名稱 Description
Create(CreateDefaultValueCallback)

建立一個 PropertyMetadata 值,指定一個回調,建立相依屬性的預設值。

Create(Object)

建立一個 PropertyMetadata 值,指定相依屬性的固定預設值。

Create(CreateDefaultValueCallback, PropertyChangedCallback)

建立一個 PropertyMetadata 值,指定一個回調,建立相依屬性的預設值,以及一個屬性變更後的回調。

Create(Object, PropertyChangedCallback)

建立一個 PropertyMetadata 值,指定依賴屬性的固定預設值,以及一個屬性變更後的回調。

Create(CreateDefaultValueCallback)

建立一個 PropertyMetadata 值,指定一個回調,建立相依屬性的預設值。

[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 的偽程式碼。 具體來說,這會建立 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)

建立一個 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(CreateDefaultValueCallback, PropertyChangedCallback)

建立一個 PropertyMetadata 值,指定一個回調,建立相依屬性的預設值,以及一個屬性變更後的回調。

[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, PropertyChangedCallback)

建立一個 PropertyMetadata 值,指定依賴屬性的固定預設值,以及一個屬性變更後的回調。

[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

相依屬性的預設值將適用。

propertyChangedCallback
PropertyChangedCallback

當相依屬性值改變時,屬性系統會呼叫回調方法的參考。

傳回

新建立的相依屬性元資料。

屬性

另請參閱

適用於