PropertyMetadata Construtores

Definição

Namespace:

Microsoft.UI.Xaml

Sobrecargas

PropertyMetadata(Object)	Inicializa uma nova instância da classe PropertyMetadata, usando um valor padrão de propriedade.
PropertyMetadata(Object, PropertyChangedCallback)	Inicializa uma nova instância da classe PropertyMetadata, usando um valor padrão de propriedade e uma referência de retorno de chamada.

PropertyMetadata(Object)

Inicializa uma nova instância da classe PropertyMetadata, usando um valor padrão de propriedade.

public:
 PropertyMetadata(Platform::Object ^ defaultValue);

 PropertyMetadata(IInspectable const& defaultValue);

public PropertyMetadata(object defaultValue);

function PropertyMetadata(defaultValue)

Public Sub New (defaultValue As Object)

Parâmetros

defaultValue

Object

Platform::Object

IInspectable

Um valor padrão para a propriedade em que esse PropertyMetadata é aplicado.

PropertyMetadata(Object, PropertyChangedCallback)

Inicializa uma nova instância da classe PropertyMetadata, usando um valor padrão de propriedade e uma referência de retorno de chamada.

public:
 PropertyMetadata(Platform::Object ^ defaultValue, PropertyChangedCallback ^ propertyChangedCallback);

public PropertyMetadata(object defaultValue, PropertyChangedCallback propertyChangedCallback);

function PropertyMetadata(defaultValue, propertyChangedCallback)

Public Sub New (defaultValue As Object, propertyChangedCallback As PropertyChangedCallback)

Parâmetros

defaultValue

Object

Platform::Object

Um valor padrão para a propriedade em que esse PropertyMetadata é aplicado.

propertyChangedCallback

PropertyChangedCallback

Uma referência ao retorno de chamada para chamar o comportamento alterado da propriedade.

Exemplos

Este exemplo mostra o uso desse construtor. OnLabelChanged refere-se a uma implementação de delegado para um PropertyChangedCallback (não mostrado). Para ver mais código que coloca este exemplo em contexto, consulte Propriedades de dependência personalizadas.

public static readonly DependencyProperty LabelProperty = DependencyProperty.Register(
  "Label",
  typeof(String),
  typeof(ImageWithLabelControl),
  new PropertyMetadata(null,new PropertyChangedCallback(OnLabelChanged))
);

DependencyProperty^ ImageWithLabelControl::_LabelProperty = 
    DependencyProperty::Register("Label", 
    Platform::String::typeid,
    ImageWithLabelControl::typeid, 
    ref new PropertyMetadata(nullptr,
      ref new PropertyChangedCallback(&ImageWithLabelControl::OnLabelChanged))
    );

Comentários

Se você quiser estabelecer uma instância PropertyMetadata que tenha um método de retorno de chamada alterado pela propriedade, mas não um valor padrão, passe null para defaultValue.

Se você passar um valor para defaultValue, verifique se o tipo desse valor é válido para o tipo de propertyType da definição da propriedade de dependência por meio da chamada Registrar. Se você tiver criado uma incompatibilidade de tipo entre o parâmetro de registro e os metadados, o problema só se manifesta indiretamente. Você receberá erros de runtime ao tentar criar uma instância de um tipo que tenha esse valor de propriedade de dependência, você não receberá nenhum aviso ou erro em tempo de design ou de tempo de compilação.

Confira também

• PropertyMetadata(Object)
• Register(String, TypeName, TypeName, PropertyMetadata)
• propriedades de dependência personalizadas