PropertyMetadata Construtores

Definição

Espaço de Nomes:: System.Windows

Assemblagem:: WindowsBase.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da PropertyMetadata classe.

Sobrecargas

Name	Description
PropertyMetadata()	Inicializa uma nova instância da PropertyMetadata classe.
PropertyMetadata(Object)	Inicializa uma nova instância da PropertyMetadata classe 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 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 callbacks.

PropertyMetadata()

Inicializa uma nova instância da PropertyMetadata classe.

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 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 uma propriedade de dependência, normalmente fornecido como um valor de algum tipo específico.

Exceções

ArgumentException

defaultValue não pode ser definido para o valor UnsetValue.

Exemplos

static PropertyMetadata pm;

pm = new PropertyMetadata(Double.NaN);

Observações

O tipo do valor fornecido defaultValue para deve corresponder ou estar relacionado com o tipo especificado no registo original da propriedade de dependência à qual estes metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão dos metadados e o tipo da propriedade de dependência a que está a ser aplicada podem ser difíceis de depurar, porque a incompatibilidade não é detetável durante a compilação (a incompatibilidade gera uma exceção em tempo de execução).

Embora seja o padrão segundo o construtor sem parâmetros, um defaultValue de UnsetValue não pode ser especificado. Tentar fazê-lo levantará 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.PropertyMetadata

Public Sub New (propertyChangedCallback As PropertyChangedCallback)

Parâmetros

propertyChangedCallback: PropertyChangedCallback

Referência a uma implementação handler que deve ser chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade mudar.

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.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 algum tipo específico.

propertyChangedCallback: PropertyChangedCallback

Referência a uma implementação handler que deve ser chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade mudar.

Exceções

ArgumentException

defaultValue não pode ser definido para o valor UnsetValue.

Exemplos

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged)
);

Observações

O tipo do valor fornecido defaultValue deve corresponder ou estar relacionado com o tipo especificado no registo original da propriedade de dependência a que estes metadados serão aplicados. As incompatibilidades entre o tipo de valor padrão dos metadados e o tipo da propriedade de dependência a que está a ser aplicada podem ser difíceis de depurar, porque a incompatibilidade não é detetável durante a compilação (a incompatibilidade gera uma exceção em tempo de execução).

Embora seja o padrão segundo o construtor sem parâmetros, um defaultValue de UnsetValue não pode ser especificado. Tentar fazê-lo levantará 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 callbacks.

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 algum tipo específico.

propertyChangedCallback: PropertyChangedCallback

Referência a uma implementação handler que deve ser chamada pelo sistema de propriedades sempre que o valor efetivo da propriedade mudar.

coerceValueCallback: CoerceValueCallback

Referência a uma implementação handler que deve ser chamada sempre que o sistema de propriedades chama CoerceValue(DependencyProperty) contra esta propriedade.

Exceções

ArgumentException

defaultValue não pode ser definido para o valor UnsetValue.

Exemplos

static PropertyMetadata pm;

pm = new PropertyMetadata(
    Double.NaN,
    new PropertyChangedCallback(OnCurrentReadingChanged),
    new CoerceValueCallback(CoerceCurrentReading)
);

Observações

Se quiseres especificar a CoerceValueCallback mas não um PropertyChangedCallback, podes passar null pelo propertyChangedCallback parâmetro.

Embora seja o padrão segundo o construtor sem parâmetros, um defaultValue de UnsetValue não pode ser especificado. Tentar fazê-lo levantará uma exceção.

Aplica-se a

Comentários

Esta página foi útil?