PropertyMetadata 构造函数

定义

命名空间:

Microsoft.UI.Xaml

重载

PropertyMetadata(Object)	使用属性默认值初始化 PropertyMetadata 类的新实例。
PropertyMetadata(Object, PropertyChangedCallback)	使用属性默认值和回调引用初始化 PropertyMetadata 类的新实例。

PropertyMetadata(Object)

使用属性默认值初始化 PropertyMetadata 类的新实例。

public:
 PropertyMetadata(Platform::Object ^ defaultValue);

 PropertyMetadata(IInspectable const& defaultValue);

public PropertyMetadata(object defaultValue);

function PropertyMetadata(defaultValue)

Public Sub New (defaultValue As Object)

参数

defaultValue

Object

Platform::Object

IInspectable

应用此 PropertyMetadata 的属性的默认值。

PropertyMetadata(Object, PropertyChangedCallback)

使用属性默认值和回调引用初始化 PropertyMetadata 类的新实例。

public:
 PropertyMetadata(Platform::Object ^ defaultValue, PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata(object defaultValue, PropertyChangedCallback propertyChangedCallback);

function PropertyMetadata(defaultValue, propertyChangedCallback)

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

参数

defaultValue

Object

Platform::Object

应用此 PropertyMetadata 的属性的默认值。

propertyChangedCallback

PropertyChangedCallback

对回调的引用，用于调用属性更改行为。

示例

此示例演示此构造函数的用法。 OnLabelChanged 引用 PropertyChangedCallback 的委托实现， (未) 显示。 若要查看将此示例置于上下文中的更多代码，请参阅 自定义依赖属性。

public static readonly DependencyProperty LabelProperty = DependencyProperty.Register(
  "Label",
  typeof(String),
  typeof(ImageWithLabelControl),
  new PropertyMetadata(null,new PropertyChangedCallback(OnLabelChanged))
);

DependencyProperty^ ImageWithLabelControl::_LabelProperty = 
    DependencyProperty::Register("Label", 
    Platform::String::typeid,
    ImageWithLabelControl::typeid, 
    ref new PropertyMetadata(nullptr,
      ref new PropertyChangedCallback(&ImageWithLabelControl::OnLabelChanged))
    );

注解

如果要建立具有属性更改的回调方法但不具有默认值的 PropertyMetadata 实例，请为 defaultValue传递 null 。

如果为 defaultValue传递值，请确保该值的类型通过 propertyTypeRegister 调用对依赖属性定义中的类型有效。 如果已创建注册参数和元数据之间的类型不匹配，则问题只会间接地显现出来。 尝试实例化具有此依赖项属性值的类型时，将收到运行时错误，并且不会收到任何设计时或编译时警告或错误。

另请参阅

• PropertyMetadata(Object)
• Register(String, TypeName, TypeName, PropertyMetadata)
• 自定义依赖属性