DependencyObject.GetValue(DependencyProperty) Méthode

Définition

Espace de noms:

Windows.UI.Xaml

Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un 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

Paramètres

dp

DependencyProperty

Identificateur DependencyProperty de la propriété pour laquelle récupérer la valeur.

Retours

Object

Platform::Object

IInspectable

Retourne la valeur effective actuelle.

Remarques

GetValue obtient la valeur effective actuelle d’une propriété de dépendance. La valeur effective actuelle est déterminée à l’aide des règles de vue d’ensemble des propriétés de dépendance.

GetValue est l’API que vous souhaitez dans la plupart des cas si vous utilisez l’API de système de propriétés pour obtenir des valeurs de propriété. Toutefois, vous pouvez parfois examiner d’autres valeurs pour voir comment la précédence de la propriété de dépendance agit pour une propriété donnée. Si c’est le cas, vous pouvez utiliser l’une de ces API :

• GetAnimationBaseValue pour obtenir des valeurs qui peuvent être animées, mais que vous souhaitez connaître avant l’exécution de l’animation. Notez que les animations avec le comportement HoldEnd peuvent ne pas avoir cette même valeur. Pour plus d’informations sur le concept HoldEnd, consultez Animations storyboard.
• ReadLocalValue pour obtenir la valeur locale, qui n’a pas de styles, de modèles ou d’animations appliqués. Les liaisons comptent comme valeurs locales, mais selon le moment où vous appelez ReadLocalValue, le contexte de liaison actif n’est peut-être pas encore disponible. Vous n’obtiendrez donc pas la même valeur que celle qui serait appliquée au moment de l’exécution. Pour plus d’informations sur la précédence des propriétés de dépendance et d’autres API utilitaires de système de propriétés, consultez Vue d’ensemble des propriétés de dépendance.

Voir aussi

• SetValue(DependencyProperty, Object)
• Propriétés de dépendance personnalisées
• Vue d’ensemble des propriétés de dépendance