FrameworkPropertyMetadata Costruttori

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Inizializza una nuova istanza della classe FrameworkPropertyMetadata.

Overload

Nome	Descrizione
FrameworkPropertyMetadata()	Inizializza una nuova istanza della classe FrameworkPropertyMetadata.
FrameworkPropertyMetadata(Object)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato.
FrameworkPropertyMetadata(PropertyChangedCallback)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il callback specificato PropertyChangedCallback .
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati a livello di framework.
FrameworkPropertyMetadata(Object, PropertyChangedCallback)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e il callback specificato PropertyChangedCallback .
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con i callback specificati.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito e le opzioni dei metadati del framework specificati e il callback specificato PropertyChangedCallback .
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e i callback specificati.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati del framework e i callback specificati.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati del framework, i callback specificati e un valore Boolean che può essere usato per impedire l'animazione della proprietà.
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)	Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati del framework, i callback specificati, un valore booleano che può essere usato per impedire l'animazione della proprietà e un trigger di aggiornamento del data binding predefinito.

FrameworkPropertyMetadata()

Inizializza una nuova istanza della classe FrameworkPropertyMetadata.

public:
 FrameworkPropertyMetadata();

public FrameworkPropertyMetadata();

Public Sub New ()

Commenti

Questa firma inizializza tutti i valori di per le impostazioni predefinite della FrameworkPropertyMetadata proprietà. DefaultValue sarà nulle le varie FrameworkPropertyMetadata proprietà booleane saranno false.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(Object)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato.

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

public FrameworkPropertyMetadata(object defaultValue);

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

Public Sub New (defaultValue As Object)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

fpm = new FrameworkPropertyMetadata(Double.NaN);

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(PropertyChangedCallback)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il callback specificato 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)

Parametri

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati a livello di framework.

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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

flags

FrameworkPropertyMetadataOptions

Flag di opzione dei metadati (combinazione di FrameworkPropertyMetadataOptions valori). Queste opzioni specificano le caratteristiche della proprietà di dipendenza che interagiscono con sistemi quali layout o data binding.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

I valori contrassegnati come flag impostati nel flags parametro impostano il valore booleano delle FrameworkPropertyMetadata proprietà che corrispondono FrameworkPropertyMetadataOptions al nome del flag su true. Successivamente, è possibile modificare i valori delle proprietà nei metadati, purché i metadati non siano ancora stati applicati a un'operazione specifica del sistema di proprietà.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(Object, PropertyChangedCallback)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e il callback specificato 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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con i callback specificati.

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)

Parametri

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

coerceValueCallback

CoerceValueCallback

Verrà chiamato un riferimento a un'implementazione del gestore ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) questa proprietà di dipendenza.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Questa implementazione chiama un inizializzatore di base e quindi aggiunge coerceValueCallback impostando la proprietà sull'istanza di base.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito e le opzioni dei metadati del framework specificati e il callback specificato 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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come valore di un tipo specifico.

flags

FrameworkPropertyMetadataOptions

Flag di opzione dei metadati (combinazione di FrameworkPropertyMetadataOptions valori). Queste opzioni specificano le caratteristiche della proprietà di dipendenza che interagiscono con sistemi quali layout o data binding.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

I valori contrassegnati come flag impostati nel flags parametro impostano il valore booleano delle FrameworkPropertyMetadata proprietà che corrispondono FrameworkPropertyMetadataOptions al nome del flag su true. È comunque possibile modificare i valori delle proprietà nei metadati, purché i metadati non siano ancora stati applicati a un'operazione specifica del sistema di proprietà.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e i callback specificati.

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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come tipo specifico.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

coerceValueCallback

CoerceValueCallback

Riferimento a un'implementazione del gestore che verrà chiamata ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) questa proprietà di dipendenza.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

Vedi anche

• PropertyMetadata

FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati del framework e i callback specificati.

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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come tipo specifico.

flags

FrameworkPropertyMetadataOptions

Flag di opzione dei metadati (combinazione di FrameworkPropertyMetadataOptions valori). Queste opzioni specificano le caratteristiche della proprietà di dipendenza che interagiscono con sistemi quali layout o data binding.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

coerceValueCallback

CoerceValueCallback

Riferimento a un'implementazione del gestore che verrà chiamata ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) questa proprietà.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

I valori contrassegnati come flag impostati nel flags parametro impostano il valore booleano delle FrameworkPropertyMetadata proprietà che corrispondono FrameworkPropertyMetadataOptions al nome del flag su true. È comunque possibile modificare i valori delle proprietà nei metadati, purché i metadati non siano ancora stati applicati a un'operazione specifica del sistema di proprietà.

Vedi anche

• PropertyMetadata

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

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati del framework, i callback specificati e un valore Boolean che può essere usato per impedire l'animazione della proprietà.

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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come tipo specifico.

flags

FrameworkPropertyMetadataOptions

Flag di opzione dei metadati (combinazione di FrameworkPropertyMetadataOptions valori). Queste opzioni specificano le caratteristiche della proprietà di dipendenza che interagiscono con sistemi quali layout o data binding.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

coerceValueCallback

CoerceValueCallback

Riferimento a un'implementazione del gestore che verrà chiamata ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) questa proprietà di dipendenza.

isAnimationProhibited

Boolean

true per impedire al sistema di proprietà di animare la proprietà a cui vengono applicati questi metadati. Tali proprietà genereranno un'eccezione di runtime originata dal sistema di proprietà se vengono tentate animazioni di tali proprietà. false per consentire l'animazione della proprietà. Il valore predefinito è false.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

L'esempio seguente chiama questa firma del costruttore:

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

Il isAnimationProhibited parametro imposta il valore iniziale della IsAnimationProhibited proprietà dichiarata dalla classe base UIPropertyMetadata immediata.

I valori contrassegnati come flag impostati nel flags parametro impostano il valore booleano delle FrameworkPropertyMetadata proprietà che corrispondono FrameworkPropertyMetadataOptions al nome del flag su true. È comunque possibile modificare i valori delle proprietà nei metadati, purché i metadati non siano ancora stati applicati a un'operazione specifica del sistema di proprietà.

Vedi anche

• PropertyMetadata

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

Inizializza una nuova istanza della FrameworkPropertyMetadata classe con il valore predefinito specificato e le opzioni dei metadati del framework, i callback specificati, un valore booleano che può essere usato per impedire l'animazione della proprietà e un trigger di aggiornamento del data binding predefinito.

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)

Parametri

defaultValue

Object

Valore predefinito della proprietà di dipendenza, in genere fornito come tipo specifico.

flags

FrameworkPropertyMetadataOptions

Flag di opzione dei metadati (combinazione di FrameworkPropertyMetadataOptions valori). Queste opzioni specificano le caratteristiche della proprietà di dipendenza che interagiscono con sistemi quali layout o data binding.

propertyChangedCallback

PropertyChangedCallback

Riferimento a un'implementazione del gestore che il sistema di proprietà chiamerà ogni volta che cambia il valore effettivo della proprietà.

coerceValueCallback

CoerceValueCallback

Riferimento a un'implementazione del gestore che verrà chiamata ogni volta che il sistema di proprietà chiama CoerceValue(DependencyProperty) questa proprietà.

isAnimationProhibited

Boolean

true per impedire al sistema di proprietà di animare la proprietà a cui vengono applicati questi metadati. Tali proprietà genereranno un'eccezione di runtime originata dal sistema di proprietà se vengono tentate animazioni di tali proprietà. Il valore predefinito è false.

defaultUpdateSourceTrigger

UpdateSourceTrigger

Oggetto UpdateSourceTrigger da utilizzare quando le associazioni per questa proprietà vengono applicate con il relativo UpdateSourceTrigger valore impostato su Default.

Eccezioni

ArgumentException

defaultValue è impostato su UnsetValue.

Esempio

static FrameworkPropertyMetadata fpm;

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

Commenti

Il tipo del valore specificato per defaultValue deve corrispondere o essere correlato al tipo specificato nella registrazione originale della proprietà di dipendenza a cui verranno applicati i metadati. Le mancate corrispondenze tra il tipo di valore predefinito dei metadati e il tipo della proprietà di dipendenza a cui viene applicato può essere difficile eseguire il debug, perché la mancata corrispondenza non è rilevabile durante la compilazione. Il sistema di proprietà non valuta il valore effettivo di una proprietà fino alla fase di esecuzione, pertanto il risultato di una mancata corrispondenza del tipo di valore/proprietà predefinito è un errore di run-time.

Il valore UnsetValue ha un significato speciale nel sistema di proprietà e non può essere usato come valore predefinito della proprietà di dipendenza.

Il isAnimationProhibited parametro imposta il valore iniziale della IsAnimationProhibited proprietà dichiarata dalla classe base UIPropertyMetadata immediata.

Per altre informazioni sul comportamento dell'origine degli aggiornamenti per le associazioni, vedere Panoramica del data binding.

I valori contrassegnati come flag impostati nel flags parametro impostano il valore booleano delle FrameworkPropertyMetadata proprietà che corrispondono FrameworkPropertyMetadataOptions al nome del flag su true. È comunque possibile modificare i valori delle proprietà nei metadati, purché i metadati non siano ancora stati applicati a un'operazione specifica del sistema di proprietà.

Vedi anche

• PropertyMetadata