PropertyMetadata Construtores

Definição

Namespace:

System.Windows

Assembly:

WindowsBase.dll

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 ()

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

ArgumentException

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.

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));

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

ArgumentException

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.

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

ArgumentException

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.