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
PropertyMetadata() |
Inicializa uma nova instância da classe PropertyMetadata. |
PropertyMetadata(Object) |
Inicializa uma nova instância da classe PropertyMetadata com um valor padrão especificado para a propriedade de dependência à qual estes metadados serão aplicados. |
PropertyMetadata(PropertyChangedCallback) |
Inicializa uma nova instância da classe PropertyMetadata com a referência da implementação PropertyChangedCallback especificada. |
PropertyMetadata(Object, PropertyChangedCallback) |
Inicializa uma nova instância da classe PropertyMetadata com o valor padrão especificado e a referência de implementação PropertyChangedCallback. |
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback) |
Inicializa uma nova instância da classe PropertyMetadata com o valor padrão especificado e retornos de chamadas especificados. |
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 classe PropertyMetadata com um valor padrão especificado para a propriedade de dependência à qual estes metadados serão aplicados.
public:
PropertyMetadata(System::Object ^ defaultValue);
public PropertyMetadata (object defaultValue);
new System.Windows.PropertyMetadata : obj -> System.Windows.PropertyMetadata
Public Sub New (defaultValue As Object)
Parâmetros
- defaultValue
- Object
O valor padrão a especificar para a propriedade de dependência, geralmente fornecido como um valor de um 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 para defaultValue
deve ser correspondente ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. 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, um defaultValue
de UnsetValue não pode ser especificado. Tentar fazer isso gerará uma exceção.
Aplica-se a
PropertyMetadata(PropertyChangedCallback)
Inicializa uma nova instância da classe PropertyMetadata com a referência da implementação PropertyChangedCallback especificada.
public:
PropertyMetadata(System::Windows::PropertyChangedCallback ^ propertyChangedCallback);
public PropertyMetadata (System.Windows.PropertyChangedCallback propertyChangedCallback);
new System.Windows.PropertyMetadata : System.Windows.PropertyChangedCallback -> System.Windows.PropertyMetadata
Public Sub New (propertyChangedCallback As PropertyChangedCallback)
Parâmetros
- propertyChangedCallback
- PropertyChangedCallback
Referência a uma implementação do manipulador que 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 classe PropertyMetadata com o valor padrão especificado e a referência de implementação PropertyChangedCallback.
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.PropertyMetadata
Public 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 um tipo específico.
- propertyChangedCallback
- PropertyChangedCallback
Referência a uma implementação do manipulador que 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. 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, um defaultValue
de UnsetValue não pode ser especificado. Tentar fazer isso gerará uma exceção.
Aplica-se a
PropertyMetadata(Object, PropertyChangedCallback, CoerceValueCallback)
Inicializa uma nova instância da classe PropertyMetadata com o valor padrão especificado e retornos de chamadas especificados.
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.PropertyMetadata
Public 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 um tipo específico.
- propertyChangedCallback
- PropertyChangedCallback
Referência a uma implementação do manipulador que será chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade for alterado.
- coerceValueCallback
- CoerceValueCallback
Uma referência a uma implementação do manipulador que será chamada sempre que o sistema de propriedades chamar CoerceValue(DependencyProperty) nessa 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 para defaultValue
deve ser correspondente ou estar relacionado ao tipo especificado no registro original da propriedade de dependência à qual esses metadados serão aplicados. 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, um defaultValue
de UnsetValue não pode ser especificado. Tentar fazer isso gerará uma exceção.