FrameworkPropertyMetadata 构造函数

定义

命名空间:: System.Windows

程序集:: PresentationFramework.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

名称	说明
FrameworkPropertyMetadata()	初始化 FrameworkPropertyMetadata 类的新实例。
FrameworkPropertyMetadata(Object)	使用指定的默认值初始化类的新实例 FrameworkPropertyMetadata 。
FrameworkPropertyMetadata(PropertyChangedCallback)	使用指定的PropertyChangedCallback回调初始化类的新实例FrameworkPropertyMetadata。
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)	使用提供的默认值和框架级元数据选项初始化类的新实例 FrameworkPropertyMetadata 。
FrameworkPropertyMetadata(Object, PropertyChangedCallback)	使用提供的默认值和指定的PropertyChangedCallback回调初始化类的新实例FrameworkPropertyMetadata。
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)	使用指定的回调初始化类的新实例 FrameworkPropertyMetadata 。
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)	使用提供的默认值和框架元数据选项以及指定的PropertyChangedCallback回调初始化类的新实例FrameworkPropertyMetadata。
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	使用提供的默认值和指定的回调初始化类的新实例 FrameworkPropertyMetadata 。
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)	使用提供的默认值和框架元数据选项以及指定的回调初始化类的新实例 FrameworkPropertyMetadata 。
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)	使用提供的默认值和框架元数据选项、指定的回调以及可用于防止属性动画的布尔值初始化类的新实例 FrameworkPropertyMetadata 。
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)	使用提供的默认值和框架元数据选项、指定的回调、可用于防止属性动画的布尔值和数据绑定更新触发器默认值初始化类的新实例 FrameworkPropertyMetadata 。

FrameworkPropertyMetadata()

初始化 FrameworkPropertyMetadata 类的新实例。

public:
 FrameworkPropertyMetadata();

public FrameworkPropertyMetadata();

Public Sub New ()

注解

此签名将初始化其属性默认值的所有值 FrameworkPropertyMetadata 。 DefaultValue 将是 null，并且各种 FrameworkPropertyMetadata 布尔属性为 false。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object)

使用指定的默认值初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue);

public FrameworkPropertyMetadata(object defaultValue);

new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object)

参数

defaultValue: Object

依赖属性的默认值，通常作为特定类型的值提供。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(Double.NaN);

注解

提供 defaultValue 的值的类型必须与此元数据将应用于的依赖属性的原始注册中指定的类型匹配或相关。元数据默认值类型和要应用到的依赖属性的类型不匹配可能难以调试，因为在编译期间无法检测到不匹配。属性系统在运行时之前不会评估属性的有效值，因此默认值类型/属性类型不匹配的结果是运行时错误。

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(PropertyChangedCallback)

使用指定的PropertyChangedCallback回调初始化类的新实例FrameworkPropertyMetadata。

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public FrameworkPropertyMetadata(System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback)

参数

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));

适用于

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

使用提供的默认值和框架级元数据选项初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)

参数

defaultValue: Object

依赖属性的默认值，通常作为特定类型的值提供。

flags: FrameworkPropertyMetadataOptions

元数据选项标志（值的组合 FrameworkPropertyMetadataOptions ）。这些选项指定与布局或数据绑定等系统交互的依赖属性的特征。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

参数中flags标记为设置标志的值将设置与该FrameworkPropertyMetadataOptions标志名称true匹配的属性的布尔值FrameworkPropertyMetadata。随后，只要元数据尚未应用于特定的属性系统操作，就可以更改元数据的值。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

使用提供的默认值和指定的PropertyChangedCallback回调初始化类的新实例FrameworkPropertyMetadata。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata

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

参数

defaultValue: Object

依赖属性的默认值，通常作为特定类型的值提供。

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

使用指定的回调初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public FrameworkPropertyMetadata(System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

参数

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

coerceValueCallback: CoerceValueCallback

每当属性系统调用此依赖属性时，都会调用 CoerceValue(DependencyProperty) 对处理程序实现的引用。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

注解

此实现调用基本初始值设定项，然后通过在基实例上设置属性来添加 coerceValueCallback 该属性。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

使用提供的默认值和框架元数据选项以及指定的PropertyChangedCallback回调初始化类的新实例FrameworkPropertyMetadata。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadata

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

参数

defaultValue: Object

依赖属性的默认值，通常作为特定类型的值提供。

flags: FrameworkPropertyMetadataOptions

元数据选项标志（值的组合 FrameworkPropertyMetadataOptions ）。这些选项指定与布局或数据绑定等系统交互的依赖属性的特征。

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

参数中flags标记为设置标志的值将设置与该FrameworkPropertyMetadataOptions标志名称true匹配的属性的布尔值FrameworkPropertyMetadata。只要元数据尚未应用于特定的属性系统操作，仍可以更改元数据的值。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

使用提供的默认值和指定的回调初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata

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

参数

defaultValue: Object

依赖项属性的默认值，通常作为特定类型提供。

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

coerceValueCallback: CoerceValueCallback

对处理程序实现的引用，每当属性系统调用 CoerceValue(DependencyProperty) 此依赖属性时都会调用该实现。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

使用提供的默认值和框架元数据选项以及指定的回调初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)

参数

defaultValue: Object

依赖项属性的默认值，通常作为特定类型提供。

flags: FrameworkPropertyMetadataOptions

元数据选项标志（值的组合 FrameworkPropertyMetadataOptions ）。这些选项指定与布局或数据绑定等系统交互的依赖属性的特征。

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

coerceValueCallback: CoerceValueCallback

对处理程序实现的引用，每当对此属性调用属性系统 CoerceValue(DependencyProperty) 时，都会调用该实现。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)

使用提供的默认值和框架元数据选项、指定的回调以及可用于防止属性动画的布尔值初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)

参数

defaultValue: Object

依赖项属性的默认值，通常作为特定类型提供。

flags: FrameworkPropertyMetadataOptions

元数据选项标志（值的组合 FrameworkPropertyMetadataOptions ）。这些选项指定与布局或数据绑定等系统交互的依赖属性的特征。

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

coerceValueCallback: CoerceValueCallback

对处理程序实现的引用，每当属性系统调用此依赖属性时，都会调用 CoerceValue(DependencyProperty) 该实现。

isAnimationProhibited: Boolean

true 以防止属性系统对应用此元数据的属性进行动画处理。如果尝试了这些属性的动画，则此类属性将引发源自属性系统的运行时异常。 false 允许对属性进行动画处理。默认值为 false。

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

以下示例调用此构造函数签名：

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

该isAnimationProhibited参数设置由直接基UIPropertyMetadata类声明的属性的初始值IsAnimationProhibited。

另请参阅

PropertyMetadata

适用于

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)

使用提供的默认值和框架元数据选项、指定的回调、可用于防止属性动画的布尔值和数据绑定更新触发器默认值初始化类的新实例 FrameworkPropertyMetadata 。

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue, System::Windows::FrameworkPropertyMetadataOptions flags, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback, bool isAnimationProhibited, System::Windows::Data::UpdateSourceTrigger defaultUpdateSourceTrigger);

public FrameworkPropertyMetadata(object defaultValue, System.Windows.FrameworkPropertyMetadataOptions flags, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback, bool isAnimationProhibited, System.Windows.Data.UpdateSourceTrigger defaultUpdateSourceTrigger);

new System.Windows.FrameworkPropertyMetadata : obj * System.Windows.FrameworkPropertyMetadataOptions * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback * bool * System.Windows.Data.UpdateSourceTrigger -> System.Windows.FrameworkPropertyMetadata

Public Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean, defaultUpdateSourceTrigger As UpdateSourceTrigger)

参数

defaultValue: Object

依赖项属性的默认值，通常作为特定类型提供。

flags: FrameworkPropertyMetadataOptions

元数据选项标志（值的组合 FrameworkPropertyMetadataOptions ）。这些选项指定与布局或数据绑定等系统交互的依赖属性的特征。

propertyChangedCallback: PropertyChangedCallback

对属性系统每当属性的有效值发生更改时将调用的处理程序实现的引用。

coerceValueCallback: CoerceValueCallback

对处理程序实现的引用，每当对此属性调用属性系统 CoerceValue(DependencyProperty) 时，都会调用该实现。

isAnimationProhibited: Boolean

true 以防止属性系统对应用此元数据的属性进行动画处理。如果尝试了这些属性的动画，则此类属性将引发源自属性系统的运行时异常。默认值为 false。

defaultUpdateSourceTrigger: UpdateSourceTrigger

UpdateSourceTrigger将此属性的绑定应用于其UpdateSourceTrigger设置为 Default..

例外

ArgumentException

将 defaultValue 设置为 UnsetValue。

示例

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(
    Double.NaN,
    (FrameworkPropertyMetadataOptions.AffectsRender |
      FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading),
    true //Animation prohibited
    , UpdateSourceTrigger.PropertyChanged
);

注解

该值 UnsetValue 在属性系统中具有特殊含义，不能用作依赖属性默认值。

该isAnimationProhibited参数设置由直接基UIPropertyMetadata类声明的属性的初始值IsAnimationProhibited。

有关绑定的更新源行为的详细信息，请参阅数据绑定概述。

另请参阅

PropertyMetadata

适用于

反馈

此页面是否有帮助？