DependencyObject.GetValue(DependencyProperty) Méthode

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

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 de règles de vue d’ensemble des propriétés de dépendance.

GetValue est l’API souhaitée dans la plupart des cas si vous utilisez l’API du 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 priorité de propriété de dépendance agit pour une propriété donnée. Si c’est le cas, vous pouvez utiliser l’une des API suivantes :

  • GetAnimationBaseValue pour obtenir des valeurs qui peuvent actuellement être animées, mais vous souhaitez connaître la valeur 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 storyboarded.
  • ReadLocalValue pour obtenir la valeur locale, qui n’a pas de styles ou 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 agissant n’est peut-être pas encore disponible. Vous n’obtiendrez donc pas la même valeur que celle appliquée au moment de l’exécution. Pour plus d’informations sur la priorité des propriétés de dépendance et d’autres API utilitaires de système de propriétés, consultez la vue d’ensemble des propriétés de dépendance.

S’applique à

Voir aussi