PropertyMetadata Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa uma nova instância da classe PropertyMetadata.
Sobrecargas
| Nome | Description |
|---|---|
| PropertyMetadata() |
Inicializa uma nova instância da classe PropertyMetadata. |
| PropertyMetadata(Object) |
Inicializa uma nova instância da PropertyMetadata classe com um valor padrão especificado para a propriedade de dependência à qual esses metadados serão aplicados. |
| PropertyMetadata(PropertyChangedCallback) |
Inicializa uma nova instância da PropertyMetadata classe com a referência de implementação especificada PropertyChangedCallback . |
| PropertyMetadata(Object, PropertyChangedCallback) |
Inicializa uma nova instância da PropertyMetadata classe com o valor padrão especificado e PropertyChangedCallback a referência de implementação. |
| PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inicializa uma nova instância da PropertyMetadata classe com o valor padrão especificado e retornos de chamada. |
PropertyMetadata()
Inicializa uma nova instância da classe PropertyMetadata.
public:
PropertyMetadata();public PropertyMetadata();Public Sub New ()Aplica-se a
PropertyMetadata(Object)
Inicializa uma nova instância da PropertyMetadata classe com um valor padrão especificado para a propriedade de dependência à qual esses metadados serão aplicados.
public:
PropertyMetadata(System::Object ^ defaultValue);public PropertyMetadata(object defaultValue);new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadataPublic Sub New (defaultValue As Object)Parâmetros
- defaultValue
- Object
O valor padrão a ser especificado para uma propriedade de dependência, geralmente fornecido como um valor de algum tipo específico.
Exceções
defaultValue não pode ser definido como o valor UnsetValue.
Exemplos
static PropertyMetadata pm;
pm = new PropertyMetadata(Double.NaN);
Comentários
O tipo do valor fornecido defaultValue deve ser correspondente ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ele está sendo aplicado podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação (a incompatibilidade gerará uma exceção em tempo de execução).
Embora seja o padrão de acordo com o construtor sem parâmetros, não é possível especificar umdefaultValue.UnsetValue Tentar fazer isso gerará uma exceção.
Aplica-se a
PropertyMetadata(PropertyChangedCallback)
Inicializa uma nova instância da PropertyMetadata classe com a referência de implementação especificada PropertyChangedCallback .
public:
PropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);public PropertyMetadata(System.Windows.PropertyChangedCallback propertyChangedCallback);new System.Windows.PropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadataPublic Sub New (propertyChangedCallback As PropertyChangedCallback)Parâmetros
- propertyChangedCallback
- PropertyChangedCallback
Referência a uma implementação de manipulador que deve ser chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.
Exemplos
static PropertyMetadata pm;
pm = new PropertyMetadata(new PropertyChangedCallback(OnCurrentReadingChanged));
Aplica-se a
PropertyMetadata(Object, PropertyChangedCallback)
Inicializa uma nova instância da PropertyMetadata classe com o valor padrão especificado e PropertyChangedCallback a referência de implementação.
public:
PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback);public PropertyMetadata(object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback);new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)Parâmetros
- defaultValue
- Object
O valor padrão da propriedade de dependência, geralmente fornecido como um valor de algum tipo específico.
- propertyChangedCallback
- PropertyChangedCallback
Referência a uma implementação de manipulador que deve ser chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.
Exceções
defaultValue não pode ser definido como o valor UnsetValue.
Exemplos
static PropertyMetadata pm;
pm = new PropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged)
);
Comentários
O tipo do valor fornecido defaultValue deve ser correspondente ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ele está sendo aplicado podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação (a incompatibilidade gerará uma exceção em tempo de execução).
Embora seja o padrão de acordo com o construtor sem parâmetros, não é possível especificar umdefaultValue.UnsetValue Tentar fazer isso gerará uma exceção.
Aplica-se a
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
Inicializa uma nova instância da PropertyMetadata classe com o valor padrão especificado e retornos de chamada.
public:
PropertyMetadata(System::Object ^ defaultValue, System::Windows::PropertyChangedCallback ^ propertyChangedCallback, System::Windows::CoerceValueCallback ^ coerceValueCallback);public PropertyMetadata(object defaultValue, System.Windows.PropertyChangedCallback propertyChangedCallback, System.Windows.CoerceValueCallback coerceValueCallback);new System.Windows.PropertyMetadata : obj * System.Windows.PropertyChangedCallback * System.Windows.CoerceValueCallback -> System.Windows.PropertyMetadataPublic Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback, coerceValueCallback As CoerceValueCallback)Parâmetros
- defaultValue
- Object
O valor padrão da propriedade de dependência, geralmente fornecido como um valor de algum tipo específico.
- propertyChangedCallback
- PropertyChangedCallback
Referência a uma implementação de manipulador que deve ser chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.
- coerceValueCallback
- CoerceValueCallback
Referência a uma implementação de manipulador que deve ser chamada sempre que o sistema de propriedades chama CoerceValue(DependencyProperty) essa propriedade.
Exceções
defaultValue não pode ser definido como o valor UnsetValue.
Exemplos
static PropertyMetadata pm;
pm = new PropertyMetadata(
Double.NaN,
new PropertyChangedCallback(OnCurrentReadingChanged),
new CoerceValueCallback(CoerceCurrentReading)
);
Comentários
Se você quiser especificar um CoerceValueCallback , mas não um PropertyChangedCallback, poderá passar null para o propertyChangedCallback parâmetro.
O tipo do valor fornecido defaultValue deve ser correspondente ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão de metadados e o tipo da propriedade de dependência à qual ele está sendo aplicado podem ser difíceis de depurar, pois a incompatibilidade não é detectável durante a compilação (a incompatibilidade gerará uma exceção em tempo de execução).
Embora seja o padrão de acordo com o construtor sem parâmetros, não é possível especificar umdefaultValue.UnsetValue Tentar fazer isso gerará uma exceção.
