DependencyObject.GetValue(DependencyProperty) Método

Definição

Namespace:

Windows.UI.Xaml

Retorna o valor efetivo atual de uma propriedade de dependência de um DependencyObject.

public:
 virtual Platform::Object ^ GetValue(DependencyProperty ^ dp) = GetValue;

IInspectable GetValue(DependencyProperty const& dp);

public object GetValue(DependencyProperty dp);

function getValue(dp)

Public Function GetValue (dp As DependencyProperty) As Object

Parâmetros

dp

DependencyProperty

O identificador DependencyProperty da propriedade para a qual recuperar o valor.

Retornos

Object

Platform::Object

IInspectable

Retorna o valor efetivo atual.

Comentários

GetValue obtém o valor efetivo atual de uma propriedade de dependência. O valor efetivo atual é determinado usando regras de visão geral das propriedades de dependência.

GetValue é a API desejada na maioria dos casos se você estiver usando a API do sistema de propriedades para obter valores de propriedade. Mas, às vezes, talvez você queira examinar outros valores para ver como a precedência da propriedade de dependência está agindo para uma determinada propriedade. Nesse caso, você pode usar uma destas API:

• GetAnimationBaseValue para obter valores que podem ser animados no momento, mas você deseja saber o valor antes da animação ser executada. Observe que animações com o comportamento HoldEnd podem não ter esse mesmo valor. Para obter mais informações sobre o conceito HoldEnd , consulte Animações storyboarded.
• ReadLocalValue para obter o valor local, que não tem estilos, modelos ou animações aplicados. As associações contam como valores locais, mas, dependendo de quando você chama ReadLocalValue, o contexto de associação de ação pode ainda não estar disponível, portanto, você não obterá o mesmo valor que seria aplicado em tempo de execução. Para obter mais informações sobre precedência de propriedade de dependência e outra API do utilitário do sistema de propriedades, consulte Visão geral das propriedades de dependência.

Confira também

• SetValue(DependencyProperty, Object)
• Propriedades de dependência personalizadas
• Visão geral das propriedades de dependência