FrameworkPropertyMetadata Constructeurs

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata.

Surcharges

Nom	Description
FrameworkPropertyMetadata()	Initialise une nouvelle instance de la classe FrameworkPropertyMetadata.
FrameworkPropertyMetadata(Object)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec la valeur par défaut spécifiée.
FrameworkPropertyMetadata(PropertyChangedCallback)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec le rappel spécifié PropertyChangedCallback .
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)	Initialise une nouvelle instance de la classe avec la valeur par défaut fournie et les options de métadonnées au niveau de l’infrastructure FrameworkPropertyMetadata .
FrameworkPropertyMetadata(Object, PropertyChangedCallback)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec la valeur par défaut fournie et le rappel spécifié PropertyChangedCallback .
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec les rappels spécifiés.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)	Initialise une nouvelle instance de la classe avec les options de métadonnées de l’infrastructure FrameworkPropertyMetadata et de valeur par défaut fournies, ainsi que le rappel spécifié PropertyChangedCallback .
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec la valeur par défaut fournie et les rappels spécifiés.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)	Initialise une nouvelle instance de la classe avec les options de métadonnées de l’infrastructure FrameworkPropertyMetadata et de valeur par défaut fournies, ainsi que les rappels spécifiés.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec les options de métadonnées d’infrastructure et de valeur par défaut 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é.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)	Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec les options de métadonnées d’infrastructure et de valeur par défaut 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.

FrameworkPropertyMetadata()

Initialise une nouvelle instance de la classe FrameworkPropertyMetadata.

public:
 FrameworkPropertyMetadata();

public FrameworkPropertyMetadata();

Public Sub New ()

Remarques

Cette signature initialise toutes les valeurs de FrameworkPropertyMetadata leur propriété par défaut. DefaultValue sera null, et les différentes FrameworkPropertyMetadata propriétés booléennes seront false.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(Object)

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec la valeur par défaut spécifiée.

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, généralement fournie comme valeur d’un type spécifique.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(Double.NaN);

Remarques

Le type de la valeur fournie defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(PropertyChangedCallback)

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec le rappel spécifié PropertyChangedCallback .

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 à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

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

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Initialise une nouvelle instance de la classe avec la valeur par défaut fournie et les options de métadonnées au niveau de l’infrastructure 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)

Paramètres

defaultValue

Object

Valeur par défaut de la propriété de dépendance, généralement fournie comme valeur d’un type spécifique.

flags

FrameworkPropertyMetadataOptions

Indicateurs d’option de métadonnées (combinaison de FrameworkPropertyMetadataOptions valeurs). Ces options spécifient des caractéristiques de la propriété de dépendance qui interagissent avec des systèmes tels que la disposition ou la liaison de données.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

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

Remarques

Le type de la valeur fournie defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Les valeurs marquées comme indicateurs définis dans le flags paramètre définissent la valeur booléenne des FrameworkPropertyMetadata propriétés qui correspondent au nom truede cet FrameworkPropertyMetadataOptions indicateur . Vous pouvez ensuite modifier les valeurs des propriétés dans les métadonnées, tant que les métadonnées n’ont pas encore été appliquées à une opération de système de propriétés spécifique.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec la valeur par défaut fournie et le rappel spécifié PropertyChangedCallback .

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, généralement fournie comme valeur d’un type spécifique.

propertyChangedCallback

PropertyChangedCallback

Référence à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

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

Remarques

Le type de la valeur fournie defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec les rappels spécifiés.

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 à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

coerceValueCallback

CoerceValueCallback

Une référence à une implémentation de gestionnaire est appelée chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) cette propriété de dépendance.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

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

Remarques

Cette implémentation appelle un initialiseur de base, puis ajoute la coerceValueCallback propriété en définissant la propriété sur l’instance de base.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Initialise une nouvelle instance de la classe avec les options de métadonnées de l’infrastructure FrameworkPropertyMetadata et de valeur par défaut fournies, ainsi que le rappel spécifié PropertyChangedCallback .

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, généralement fournie comme valeur d’un type spécifique.

flags

FrameworkPropertyMetadataOptions

Indicateurs d’option de métadonnées (combinaison de FrameworkPropertyMetadataOptions valeurs). Ces options spécifient des caractéristiques de la propriété de dépendance qui interagissent avec des systèmes tels que la disposition ou la liaison de données.

propertyChangedCallback

PropertyChangedCallback

Référence à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

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

Remarques

Le type de la valeur fournie defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Les valeurs marquées comme indicateurs définis dans le flags paramètre définissent la valeur booléenne des FrameworkPropertyMetadata propriétés qui correspondent au nom truede cet FrameworkPropertyMetadataOptions indicateur . Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, tant que les métadonnées n’ont pas encore été appliquées à une opération de système de propriétés spécifique.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec la valeur par défaut fournie et les rappels spécifiés.

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, généralement fournie en tant que type spécifique.

propertyChangedCallback

PropertyChangedCallback

Référence à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

coerceValueCallback

CoerceValueCallback

Référence à une implémentation de gestionnaire qui sera appelée chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) cette propriété de dépendance.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

static FrameworkPropertyMetadata fpm;

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

Remarques

Le type de la valeur fournie defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Voir aussi

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Initialise une nouvelle instance de la classe avec les options de métadonnées de l’infrastructure FrameworkPropertyMetadata et de valeur par défaut fournies, ainsi que les rappels spécifiés.

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, généralement fournie en tant que type spécifique.

flags

FrameworkPropertyMetadataOptions

Indicateurs d’option de métadonnées (combinaison de FrameworkPropertyMetadataOptions valeurs). Ces options spécifient des caractéristiques de la propriété de dépendance qui interagissent avec des systèmes tels que la disposition ou la liaison de données.

propertyChangedCallback

PropertyChangedCallback

Référence à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

coerceValueCallback

CoerceValueCallback

Référence à une implémentation de gestionnaire qui sera appelée chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) sur cette propriété.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

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 defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Les valeurs marquées comme indicateurs définis dans le flags paramètre définissent la valeur booléenne des FrameworkPropertyMetadata propriétés qui correspondent au nom truede cet FrameworkPropertyMetadataOptions indicateur . Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, tant que les métadonnées n’ont pas encore été appliquées à une opération de système de propriétés spécifique.

Voir aussi

• PropertyMetadata

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

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec les options de métadonnées d’infrastructure et de valeur par défaut 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é.

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, généralement fournie en tant que type spécifique.

flags

FrameworkPropertyMetadataOptions

Indicateurs d’option de métadonnées (combinaison de FrameworkPropertyMetadataOptions valeurs). Ces options spécifient des caractéristiques de la propriété de dépendance qui interagissent avec des systèmes tels que la disposition ou la liaison de données.

propertyChangedCallback

PropertyChangedCallback

Référence à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

coerceValueCallback

CoerceValueCallback

Référence à une implémentation de 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.

isAnimationProhibited

Boolean

true pour empêcher le système de propriétés d’animer la propriété à laquelle ces métadonnées sont appliquées. Ces propriétés déclenchent une exception d’exécution provenant du système de propriétés si des animations sont tentées. false pour autoriser l’animation de la propriété. La valeur par défaut est false.

Exceptions

ArgumentException

defaultValue est défini sur UnsetValue.

Exemples

L’exemple suivant appelle cette signature de constructeur :

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 defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Le isAnimationProhibited paramètre définit la valeur initiale de la IsAnimationProhibited propriété déclarée par la classe de base UIPropertyMetadata immédiate.

Les valeurs marquées comme indicateurs définis dans le flags paramètre définissent la valeur booléenne des FrameworkPropertyMetadata propriétés qui correspondent au nom truede cet FrameworkPropertyMetadataOptions indicateur . Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, tant que les métadonnées n’ont pas encore été appliquées à une opération de système de propriétés spécifique.

Voir aussi

• PropertyMetadata

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

Initialise une nouvelle instance de la FrameworkPropertyMetadata classe avec les options de métadonnées d’infrastructure et de valeur par défaut 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.

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, généralement fournie en tant que type spécifique.

flags

FrameworkPropertyMetadataOptions

Indicateurs d’option de métadonnées (combinaison de FrameworkPropertyMetadataOptions valeurs). Ces options spécifient des caractéristiques de la propriété de dépendance qui interagissent avec des systèmes tels que la disposition ou la liaison de données.

propertyChangedCallback

PropertyChangedCallback

Référence à une implémentation de gestionnaire que le système de propriétés appelle chaque fois que la valeur effective de la propriété change.

coerceValueCallback

CoerceValueCallback

Référence à une implémentation de gestionnaire qui sera appelée chaque fois que le système de propriétés appelle CoerceValue(DependencyProperty) sur cette propriété.

isAnimationProhibited

Boolean

true pour empêcher le système de propriétés d’animer la propriété à laquelle ces métadonnées sont appliquées. Ces propriétés déclenchent une exception d’exécution provenant du système de propriétés si des animations sont tentées. La valeur par défaut est false.

defaultUpdateSourceTrigger

UpdateSourceTrigger

À UpdateSourceTrigger utiliser lorsque des liaisons pour cette propriété sont appliquées dont la UpdateSourceTrigger valeur est définie Default.

Exceptions

ArgumentException

defaultValue est défini sur 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 defaultValue doit correspondre ou être lié au type spécifié dans l’inscription d’origine de la propriété de dépendance à laquelle ces métadonnées seront appliquées. 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 elle est appliquée peuvent être difficiles à déboguer, car la non-correspondance n’est pas détectable pendant la 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/type de propriété par défaut est une erreur d’exécution.

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 propriété de dépendance.

Le isAnimationProhibited paramètre définit la valeur initiale de la IsAnimationProhibited propriété déclarée par la classe de base UIPropertyMetadata immédiate.

Pour plus d’informations sur le comportement de la source de mise à jour pour les liaisons, consultez Vue d’ensemble de la liaison de données.

Les valeurs marquées comme indicateurs définis dans le flags paramètre définissent la valeur booléenne des FrameworkPropertyMetadata propriétés qui correspondent au nom truede cet FrameworkPropertyMetadataOptions indicateur . Vous pouvez toujours modifier les valeurs des propriétés dans les métadonnées, tant que les métadonnées n’ont pas encore été appliquées à une opération de système de propriétés spécifique.

Voir aussi

• PropertyMetadata