FrameworkPropertyMetadata Constructeurs

Définition

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata.Initializes a new instance of the FrameworkPropertyMetadata class.

Surcharges

FrameworkPropertyMetadata()

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata.Initializes a new instance of the FrameworkPropertyMetadata class.

FrameworkPropertyMetadata(Object)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut spécifiée.Initializes a new instance of the FrameworkPropertyMetadata class with the specified default value.

FrameworkPropertyMetadata(PropertyChangedCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec le rappel PropertyChangedCallback spécifié.Initializes a new instance of the FrameworkPropertyMetadata class with the specified PropertyChangedCallback callback.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework-level metadata options.

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut fournie et le rappel PropertyChangedCallback spécifié.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and specified PropertyChangedCallback callback.

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec les rappels spécifiés.Initializes a new instance of the FrameworkPropertyMetadata class with the specified callbacks.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, et le rappel PropertyChangedCallback spécifié.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, and specified PropertyChangedCallback callback.

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut fournie et les rappels spécifiés.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and specified callbacks.

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, et les rappels spécifiés.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, and specified callbacks.

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

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, les rappels spécifiés et une valeur booléenne qui peut être utilisée pour empêcher l'animation de la propriété.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, specified callbacks, and a Boolean that can be used to prevent animation of the property.

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

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, les rappels spécifiés, une valeur booléenne qui peut être utilisée pour empêcher l'animation de la propriété, et un déclencheur de mise à jour de liaison de données par défaut.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, specified callbacks, a Boolean that can be used to prevent animation of the property, and a data-binding update trigger default.

FrameworkPropertyMetadata()

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata.Initializes a new instance of the FrameworkPropertyMetadata class.

public:
 FrameworkPropertyMetadata();
public FrameworkPropertyMetadata ();
Public Sub New ()

Remarques

Cette signature Initialise toutes les valeurs de FrameworkPropertyMetadata à leurs valeurs par défaut de propriété.This signature initializes all values of FrameworkPropertyMetadata to their property defaults. DefaultValue sera nullet les différentes FrameworkPropertyMetadata propriétés booléennes seront false.DefaultValue will be null, and the various FrameworkPropertyMetadata Boolean properties will be false.

Voir aussi

FrameworkPropertyMetadata(Object)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut spécifiée.Initializes a new instance of the FrameworkPropertyMetadata class with the specified default value.

public:
 FrameworkPropertyMetadata(System::Object ^ defaultValue);
public FrameworkPropertyMetadata (object defaultValue);
new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadata
Public Sub New (defaultValue As Object)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.The default value of the dependency property, usually provided as a value of a specific type.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Voir aussi

FrameworkPropertyMetadata(PropertyChangedCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec le rappel PropertyChangedCallback spécifié.Initializes a new instance of the FrameworkPropertyMetadata class with the specified PropertyChangedCallback callback.

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)

Paramètres

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework-level metadata options.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.The default value of the dependency property, usually provided as a value of a specific type.

flags
FrameworkPropertyMetadataOptions

Indicateurs d'option de métadonnées (combinaison des valeurs FrameworkPropertyMetadataOptions).The metadata option flags (a combination of FrameworkPropertyMetadataOptions values). Ces options spécifient les caractéristiques de la propriété de dépendance qui interagissent avec les systèmes tels qu'une présentation ou une liaison de données.These options specify characteristics of the dependency property that interact with systems such as layout or data binding.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Les valeurs marquées comme indicateurs Set dans le paramètre flags définissent la valeur booléenne des propriétés FrameworkPropertyMetadata qui correspondent au nom de l’indicateur de FrameworkPropertyMetadataOptions à true.Values marked as set flags in the flags parameter will set the Boolean value of FrameworkPropertyMetadata properties that match that FrameworkPropertyMetadataOptions flag's name to true. Vous pouvez ensuite modifier les valeurs des propriétés dans les métadonnées, à condition que les métadonnées n’aient pas encore été appliquées à une opération de système de propriétés spécifique.You can subsequently change the values of the properties in the metadata, as long as the metadata has not yet been applied to a specific property system operation.

Voir aussi

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut fournie et le rappel PropertyChangedCallback spécifié.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and specified PropertyChangedCallback callback.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.The default value of the dependency property, usually provided as a value of a specific type.

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Voir aussi

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec les rappels spécifiés.Initializes a new instance of the FrameworkPropertyMetadata class with the specified callbacks.

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)

Paramètres

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

coerceValueCallback
CoerceValueCallback

Une référence à l'implémentation d'un gestionnaire sera appelée à chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) pour cette propriété de dépendance.A reference to a handler implementation will be called whenever the property system calls CoerceValue(DependencyProperty) for this dependency property.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Cette implémentation appelle un initialiseur de base, puis ajoute le coerceValueCallback en définissant la propriété sur l’instance de base.This implementation calls a base initializer and then adds the coerceValueCallback by setting the property on the base instance.

Voir aussi

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, et le rappel PropertyChangedCallback spécifié.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, and specified PropertyChangedCallback callback.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme valeur d'un type spécifique.The default value of the dependency property, usually provided as a value of a specific type.

flags
FrameworkPropertyMetadataOptions

Indicateurs d'option de métadonnées (combinaison des valeurs FrameworkPropertyMetadataOptions).The metadata option flags (a combination of FrameworkPropertyMetadataOptions values). Ces options spécifient les caractéristiques de la propriété de dépendance qui interagissent avec les systèmes tels qu'une présentation ou une liaison de données.These options specify characteristics of the dependency property that interact with systems such as layout or data binding.

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Les valeurs marquées comme indicateurs Set dans le paramètre flags définissent la valeur booléenne des propriétés FrameworkPropertyMetadata qui correspondent au nom de l’indicateur de FrameworkPropertyMetadataOptions à true.Values marked as set flags in the flags parameter will set the Boolean value of FrameworkPropertyMetadata properties that match that FrameworkPropertyMetadataOptions flag's name to true. Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, à condition que les métadonnées n’aient pas encore été appliquées à une opération de système de propriétés spécifique.You can still change the values of the properties in the metadata, as long as the metadata has not yet been applied to a specific property system operation.

Voir aussi

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut fournie et les rappels spécifiés.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and specified callbacks.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme un type spécifique.The default value of the dependency property, usually provided as a specific type.

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

coerceValueCallback
CoerceValueCallback

Référence à l'implémentation d'un gestionnaire qui sera appelée à chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) pour cette propriété de dépendance.A reference to a handler implementation that will be called whenever the property system calls CoerceValue(DependencyProperty) for this dependency property.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Voir aussi

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, et les rappels spécifiés.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, and specified callbacks.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme un type spécifique.The default value of the dependency property, usually provided as a specific type.

flags
FrameworkPropertyMetadataOptions

Indicateurs d'option de métadonnées (combinaison des valeurs FrameworkPropertyMetadataOptions).The metadata option flags (a combination of FrameworkPropertyMetadataOptions values). Ces options spécifient les caractéristiques de la propriété de dépendance qui interagissent avec les systèmes tels qu'une présentation ou une liaison de données.These options specify characteristics of the dependency property that interact with systems such as layout or data binding.

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

coerceValueCallback
CoerceValueCallback

Référence à l'implémentation d'un gestionnaire qui sera appelée à chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) à l'aide de cette propriété.A reference to a handler implementation that will be called whenever the property system calls CoerceValue(DependencyProperty) against this property.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Les valeurs marquées comme indicateurs Set dans le paramètre flags définissent la valeur booléenne des propriétés FrameworkPropertyMetadata qui correspondent au nom de l’indicateur de FrameworkPropertyMetadataOptions à true.Values marked as set flags in the flags parameter will set the Boolean value of FrameworkPropertyMetadata properties that match that FrameworkPropertyMetadataOptions flag's name to true. Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, à condition que les métadonnées n’aient pas encore été appliquées à une opération de système de propriétés spécifique.You can still change the values of the properties in the metadata, as long as the metadata has not yet been applied to a specific property system operation.

Voir aussi

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

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, les rappels spécifiés et une valeur booléenne qui peut être utilisée pour empêcher l'animation de la propriété.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, specified callbacks, and a Boolean that can be used to prevent animation of the property.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme un type spécifique.The default value of the dependency property, usually provided as a specific type.

flags
FrameworkPropertyMetadataOptions

Indicateurs d'option de métadonnées (combinaison des valeurs FrameworkPropertyMetadataOptions).The metadata option flags (a combination of FrameworkPropertyMetadataOptions values). Ces options spécifient les caractéristiques de la propriété de dépendance qui interagissent avec les systèmes tels qu'une présentation ou une liaison de données.These options specify characteristics of the dependency property that interact with systems such as layout or data binding.

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

coerceValueCallback
CoerceValueCallback

Référence à l'implémentation d'un gestionnaire qui sera appelée à chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) sur cette propriété de dépendance.A reference to a handler implementation that will be called whenever the property system calls CoerceValue(DependencyProperty) on this dependency property.

isAnimationProhibited
Boolean

true pour éviter que le système de propriétés anime la propriété à laquelle ces métadonnées sont appliquées.true to prevent the property system from animating the property that this metadata is applied to. De telles propriétés déclenchent une exception runtime qui provient du système de propriétés si des tentatives d'animation ont lieu.Such properties will raise a run-time exception originating from the property system if animations of them are attempted. false pour autoriser l'animation de la propriété.false to permit animating the property. Par défaut, il s’agit de false.The default is false.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :The following example calls this constructor signature:

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Le paramètre isAnimationProhibited définit la valeur initiale de la propriété IsAnimationProhibited déclarée par la classe de UIPropertyMetadata de base immédiate.The isAnimationProhibited parameter sets the initial value of the IsAnimationProhibited property declared by the immediate base UIPropertyMetadata class.

Les valeurs marquées comme indicateurs Set dans le paramètre flags définissent la valeur booléenne des propriétés FrameworkPropertyMetadata qui correspondent au nom de l’indicateur de FrameworkPropertyMetadataOptions à true.Values marked as set flags in the flags parameter will set the Boolean value of FrameworkPropertyMetadata properties that match that FrameworkPropertyMetadataOptions flag's name to true. Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, à condition que les métadonnées n’aient pas encore été appliquées à une opération de système de propriétés spécifique.You can still change the values of the properties in the metadata, as long as the metadata has not yet been applied to a specific property system operation.

Voir aussi

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

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata avec la valeur par défaut et les options de métadonnées au niveau de l'infrastructure fournies, les rappels spécifiés, une valeur booléenne qui peut être utilisée pour empêcher l'animation de la propriété, et un déclencheur de mise à jour de liaison de données par défaut.Initializes a new instance of the FrameworkPropertyMetadata class with the provided default value and framework metadata options, specified callbacks, a Boolean that can be used to prevent animation of the property, and a data-binding update trigger default.

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)

Paramètres

defaultValue
Object

Valeur par défaut de la propriété de dépendance, habituellement fournie comme un type spécifique.The default value of the dependency property, usually provided as a specific type.

flags
FrameworkPropertyMetadataOptions

Indicateurs d'option de métadonnées (combinaison des valeurs FrameworkPropertyMetadataOptions).The metadata option flags (a combination of FrameworkPropertyMetadataOptions values). Ces options spécifient les caractéristiques de la propriété de dépendance qui interagissent avec les systèmes tels qu'une présentation ou une liaison de données.These options specify characteristics of the dependency property that interact with systems such as layout or data binding.

propertyChangedCallback
PropertyChangedCallback

Référence à l'implémentation d'un gestionnaire que le système de propriétés appelle à chaque fois que la valeur effective de la propriété change.A reference to a handler implementation that the property system will call whenever the effective value of the property changes.

coerceValueCallback
CoerceValueCallback

Référence à l'implémentation d'un gestionnaire qui sera appelée à chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) à l'aide de cette propriété.A reference to a handler implementation that will be called whenever the property system calls CoerceValue(DependencyProperty) against this property.

isAnimationProhibited
Boolean

true pour éviter que le système de propriétés anime la propriété à laquelle ces métadonnées sont appliquées.true to prevent the property system from animating the property that this metadata is applied to. De telles propriétés déclenchent une exception runtime qui provient du système de propriétés si des tentatives d'animation ont lieu.Such properties will raise a run-time exception originating from the property system if animations of them are attempted. Par défaut, il s’agit de false.The default is false.

defaultUpdateSourceTrigger
UpdateSourceTrigger

UpdateSourceTrigger à utiliser lorsque les liaisons pour cette propriété sont appliquées et dont la valeur de leur UpdateSourceTrigger est Default.The UpdateSourceTrigger to use when bindings for this property are applied that have their UpdateSourceTrigger set to Default.

Exceptions

defaultValue est défini sur UnsetValue.defaultValue is set to UnsetValue.

Exemples

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

Remarques

Le type de la valeur fournie pour defaultValue doit correspondre ou être associé au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées.The type of the value provided for defaultValue must match or be related to the type specified in the original registration of the dependency property that this metadata will be applied to. Les incompatibilités entre le type de valeur par défaut des métadonnées et le type de la propriété de dépendance à laquelle il est appliqué peuvent être difficiles à déboguer, car l’incompatibilité ne peut pas être détectée pendant la compilation.Mismatches between metadata default value type and the type of the dependency property it is being applied to can be difficult to debug, because the mismatch is not detectable during compilation. Le système de propriétés n’évalue pas la valeur effective d’une propriété jusqu’au moment de l’exécution. par conséquent, le résultat d’une incompatibilité de type valeur/propriété par défaut est une erreur au moment de l’exécution.The property system does not evaluate the effective value of a property until run time, so the result of a default value type/property type mismatch is a run-time error.

La valeur UnsetValue a une signification particulière dans le système de propriétés et ne peut pas être utilisée comme valeur par défaut de la propriété de dépendance.The value UnsetValue has special meaning in the property system, and cannot be used as a dependency property default value.

Le paramètre isAnimationProhibited définit la valeur initiale de la propriété IsAnimationProhibited déclarée par la classe de UIPropertyMetadata de base immédiate.The isAnimationProhibited parameter sets the initial value of the IsAnimationProhibited property declared by the immediate base UIPropertyMetadata class.

Pour plus d’informations sur le comportement de la source de mise à jour pour les liaisons, consultez vue d’ensemblede la liaison de données.For more information about the update source behavior for bindings, see Data Binding Overview.

Les valeurs marquées comme indicateurs Set dans le paramètre flags définissent la valeur booléenne des propriétés FrameworkPropertyMetadata qui correspondent au nom de l’indicateur de FrameworkPropertyMetadataOptions à true.Values marked as set flags in the flags parameter will set the Boolean value of FrameworkPropertyMetadata properties that match that FrameworkPropertyMetadataOptions flag's name to true. Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, à condition que les métadonnées n’aient pas encore été appliquées à une opération de système de propriétés spécifique.You can still change the values of the properties in the metadata, as long as the metadata has not yet been applied to a specific property system operation.

Voir aussi

S’applique à