PropertyMetadata.Create 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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)
- Create(Object, PropertyChangedCallback)
- Create(CreateDefaultValueCallback, PropertyChangedCallback)
- 自訂相依性屬性
- 相依性屬性概觀
適用於
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, 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)
- Create(Object, PropertyChangedCallback)
- Create(CreateDefaultValueCallback)
- 自訂相依性屬性
- 相依性屬性概觀
適用於
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
當相依屬性值改變時,屬性系統會呼叫回調方法的參考。
傳回
新建立的相依屬性元資料。
- 屬性
另請參閱
- Create(Object)
- Create(CreateDefaultValueCallback)
- Create(CreateDefaultValueCallback, PropertyChangedCallback)