FrameworkPropertyMetadata Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata.
Sobrecargas
| FrameworkPropertyMetadata() |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata. |
| FrameworkPropertyMetadata(Object) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado especificado. |
| FrameworkPropertyMetadata(PropertyChangedCallback) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con la devolución de llamada de PropertyChangedCallback especificada. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las opciones de metadatos de nivel de marco. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y la devolución de llamada de PropertyChangedCallback especificada. |
| FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con las devoluciones de llamada de especificadas. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado, las opciones de metadatos de nivel de marco y la devolución de llamada de PropertyChangedCallback especificada. |
| FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las devoluciones de llamada especificadas. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado, las opciones de metadatos de nivel de marco y las devoluciones de llamada especificadas. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las opciones de metadatos de marco, las devoluciones de llamada especificadas y un valor de tipo booleano que se pueden usar para evitar la animación de la propiedad. |
| FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger) |
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las opciones de metadatos de marco, las devoluciones de llamada especificadas y un valor de tipo booleano que se pueden usar para evitar la animación de la propiedad; así como el valor predeterminado de un desencadenador de actualización de enlace de datos. |
FrameworkPropertyMetadata()
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata.
public:
FrameworkPropertyMetadata();public FrameworkPropertyMetadata ();Public Sub New ()Comentarios
Esta firma inicializa todos los valores de en sus valores predeterminados de FrameworkPropertyMetadata propiedad.
DefaultValue será nully las distintas FrameworkPropertyMetadata propiedades booleanas serán false.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado especificado.
public:
FrameworkPropertyMetadata(System::Object ^ defaultValue);public FrameworkPropertyMetadata (object defaultValue);new System.Windows.FrameworkPropertyMetadata : obj -> System.Windows.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como valor de un tipo específico.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(Double.NaN);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
Consulte también
Se aplica a
FrameworkPropertyMetadata(PropertyChangedCallback)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con la devolución de llamada de PropertyChangedCallback especificada.
public:
FrameworkPropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);public FrameworkPropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);new System.Windows.FrameworkPropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.FrameworkPropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback)Parámetros
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));
Se aplica a
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las opciones de metadatos de nivel de marco.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como valor de un tipo específico.
Marcadores de la opción de metadatos (una combinación de valores de FrameworkPropertyMetadataOptions). Estas opciones especifican características de la propiedad de dependencia que interactúan con sistemas como el de diseño o el de enlace de datos.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault)
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
Los valores marcados como marcas establecidas en el flags parámetro establecerán el valor booleano de FrameworkPropertyMetadata las propiedades que coinciden con el nombre de esa FrameworkPropertyMetadataOptions marca en true. Posteriormente, puede cambiar los valores de las propiedades de los metadatos, siempre y cuando los metadatos aún no se hayan aplicado a una operación específica del sistema de propiedades.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object, PropertyChangedCallback)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y la devolución de llamada de PropertyChangedCallback especificada.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como valor de un tipo específico.
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged)
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
Consulte también
Se aplica a
FrameworkPropertyMetadata(PropertyChangedCallback, CoerceValueCallback)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con las devoluciones de llamada de especificadas.
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.FrameworkPropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parámetros
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
- coerceValueCallback
- CoerceValueCallback
Se llamará a una referencia a una implementación del controlador siempre que el sistema de propiedades llame a CoerceValue(DependencyProperty) para esta propiedad de dependencia.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Comentarios
Esta implementación llama a un inicializador base y, a continuación, agrega mediante el coerceValueCallback establecimiento de la propiedad en la instancia base.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado, las opciones de metadatos de nivel de marco y la devolución de llamada de PropertyChangedCallback especificada.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como valor de un tipo específico.
Marcadores de la opción de metadatos (una combinación de valores de FrameworkPropertyMetadataOptions). Estas opciones especifican características de la propiedad de dependencia que interactúan con sistemas como el de diseño o el de enlace de datos.
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged)
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
Los valores marcados como marcas establecidas en el flags parámetro establecerán el valor booleano de FrameworkPropertyMetadata las propiedades que coinciden con el nombre de esa FrameworkPropertyMetadataOptions marca en true. Todavía puede cambiar los valores de las propiedades en los metadatos, siempre y cuando los metadatos aún no se hayan aplicado a una operación específica del sistema de propiedades.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las devoluciones de llamada especificadas.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como un tipo específico.
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
- coerceValueCallback
- CoerceValueCallback
Referencia a una implementación del controlador a la que se llamará siempre que el sistema de propiedades llame a CoerceValue(DependencyProperty) para esta propiedad de dependencia.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado, las opciones de metadatos de nivel de marco y las devoluciones de llamada especificadas.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como un tipo específico.
Marcadores de la opción de metadatos (una combinación de valores de FrameworkPropertyMetadataOptions). Estas opciones especifican características de la propiedad de dependencia que interactúan con sistemas como el de diseño o el de enlace de datos.
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
- coerceValueCallback
- CoerceValueCallback
Referencia a una implementación del controlador a la que se llamará siempre que el sistema de propiedades llame a CoerceValue(DependencyProperty) en esta propiedad.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
Los valores marcados como marcas establecidas en el flags parámetro establecerán el valor booleano de FrameworkPropertyMetadata las propiedades que coinciden con el nombre de esa FrameworkPropertyMetadataOptions marca en true. Todavía puede cambiar los valores de las propiedades en los metadatos, siempre y cuando los metadatos aún no se hayan aplicado a una operación específica del sistema de propiedades.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las opciones de metadatos de marco, las devoluciones de llamada especificadas y un valor de tipo booleano que se pueden usar para evitar la animación de la propiedad.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como un tipo específico.
Marcadores de la opción de metadatos (una combinación de valores de FrameworkPropertyMetadataOptions). Estas opciones especifican características de la propiedad de dependencia que interactúan con sistemas como el de diseño o el de enlace de datos.
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
- coerceValueCallback
- CoerceValueCallback
Referencia a una implementación del controlador a la que se llamará siempre que el sistema de propiedades llame a CoerceValue(DependencyProperty) en esta propiedad de dependencia.
- isAnimationProhibited
- Boolean
Es true para evitar que el sistema de propiedades anime la propiedad a la que se aplican los metadatos. Tales propiedades producirán una excepción en tiempo de ejecución que se origina desde el sistema de propiedades si se intentan su animación. Es false para permitir animar la propiedad. De manera predeterminada, es false.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
En el ejemplo siguiente se llama a esta firma de constructor:
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading),
true //Animation prohibited
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
El isAnimationProhibited parámetro establece el valor inicial de la IsAnimationProhibited propiedad declarada por la clase base UIPropertyMetadata inmediata.
Los valores marcados como marcas establecidas en el flags parámetro establecerán el valor booleano de FrameworkPropertyMetadata las propiedades que coinciden con el nombre de esa FrameworkPropertyMetadataOptions marca en true. Todavía puede cambiar los valores de las propiedades en los metadatos, siempre y cuando los metadatos aún no se hayan aplicado a una operación específica del sistema de propiedades.
Consulte también
Se aplica a
FrameworkPropertyMetadata(Object, FrameworkPropertyMetadataOptions, PropertyChangedCallback, CoerceValueCallback, Boolean, UpdateSourceTrigger)
Inicializa una nueva instancia de la clase FrameworkPropertyMetadata con el valor predeterminado proporcionado y las opciones de metadatos de marco, las devoluciones de llamada especificadas y un valor de tipo booleano que se pueden usar para evitar la animación de la propiedad; así como el valor predeterminado de un desencadenador de actualización de enlace de datos.
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.FrameworkPropertyMetadataPublic Sub New (defaultValue As Object, flags As FrameworkPropertyMetadataOptions, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback, isAnimationProhibited As Boolean, defaultUpdateSourceTrigger As UpdateSourceTrigger)Parámetros
- defaultValue
- Object
Valor predeterminado de la propiedad de dependencia, proporcionado normalmente como un tipo específico.
Marcadores de la opción de metadatos (una combinación de valores de FrameworkPropertyMetadataOptions). Estas opciones especifican características de la propiedad de dependencia que interactúan con sistemas como el de diseño o el de enlace de datos.
- propertyChangedCallback
- PropertyChangedCallback
Referencia a una implementación de controlador a la que llamará el sistema de propiedades cada vez que cambie el valor real de la propiedad.
- coerceValueCallback
- CoerceValueCallback
Referencia a una implementación del controlador a la que se llamará siempre que el sistema de propiedades llame a CoerceValue(DependencyProperty) en esta propiedad.
- isAnimationProhibited
- Boolean
Es true para evitar que el sistema de propiedades anime la propiedad a la que se aplican los metadatos. Tales propiedades producirán una excepción en tiempo de ejecución que se origina desde el sistema de propiedades si se intentan su animación. De manera predeterminada, es false.
- defaultUpdateSourceTrigger
- UpdateSourceTrigger
UpdateSourceTrigger que se va a usar cuando se aplican enlaces para esta propiedad que tiene su conjunto de UpdateSourceTrigger establecido en Default.
Excepciones
El valor de defaultValue está establecido en UnsetValue.
Ejemplos
static FrameworkPropertyMetadata fpm;
fpm = new FrameworkPropertyMetadata(
Double.NaN,
(FrameworkPropertyMetadataOptions.AffectsRender |
FrameworkPropertyMetadataOptions.BindsTwoWayByDefault),
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading),
true //Animation prohibited
, UpdateSourceTrigger.PropertyChanged
);
Comentarios
El tipo del valor proporcionado para defaultValue debe coincidir o estar relacionado con el tipo especificado en el registro original de la propiedad de dependencia a la que se aplicarán estos metadatos. Los errores de coincidencia entre el tipo de valor predeterminado de metadatos y el tipo de la propiedad de dependencia a la que se está aplicando pueden ser difíciles de depurar, ya que la falta de coincidencia no se puede detectar durante la compilación. El sistema de propiedades no evalúa el valor efectivo de una propiedad hasta el tiempo de ejecución, por lo que el resultado de un error de coincidencia de tipo o tipo de propiedad predeterminado es un error en tiempo de ejecución.
El valor UnsetValue tiene un significado especial en el sistema de propiedades y no se puede usar como valor predeterminado de la propiedad de dependencia.
El isAnimationProhibited parámetro establece el valor inicial de la IsAnimationProhibited propiedad declarada por la clase base UIPropertyMetadata inmediata.
Para obtener más información sobre el comportamiento del origen de actualización para los enlaces, consulte Información general sobre el enlace de datos.
Los valores marcados como marcas establecidas en el flags parámetro establecerán el valor booleano de FrameworkPropertyMetadata las propiedades que coinciden con el nombre de esa FrameworkPropertyMetadataOptions marca en true. Todavía puede cambiar los valores de las propiedades en los metadatos, siempre y cuando los metadatos aún no se hayan aplicado a una operación específica del sistema de propiedades.
