DependencyObject.GetValue(DependencyProperty) Methode

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück.

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

Parameter

dp
DependencyProperty

Der DependencyProperty-Bezeichner der Eigenschaft, für die der Wert abgerufen werden soll.

Gibt zurück

Object

Platform::Object

IInspectable

Gibt den aktuellen effektiven Wert zurück.

Hinweise

GetValue ruft den aktuellen effektiven Wert einer Abhängigkeitseigenschaft ab. Der aktuelle effektive Wert wird mithilfe von Regeln der Abhängigkeitseigenschaftenübersicht bestimmt.

GetValue ist die gewünschte API in den meisten Fällen, wenn Sie die Eigenschaftensystem-API zum Abrufen von Eigenschaftswerten verwenden. Manchmal sollten Sie jedoch andere Werte untersuchen, um zu sehen, wie die Rangfolge der Abhängigkeitseigenschaft für eine bestimmte Eigenschaft fungiert. In diesem Szenario können Sie eine der folgenden APIs verwenden:

  • GetAnimationBaseValue zum Abrufen von Werten, die derzeit animiert werden können, aber Sie möchten den Wert kennen, bevor die Animation ausgeführt wurde. Beachten Sie, dass Animationen mit holdEnd-Verhalten möglicherweise nicht denselben Wert aufweisen. Weitere Informationen zum HoldEnd-Konzept finden Sie unter Storyboardanimationen.
  • ReadLocalValue zum Abrufen des lokalen Werts, auf den keine Stile oder Vorlagen oder Animationen angewendet wurden. Bindungen werden als lokale Werte gezählt, aber je nachdem, wann Sie ReadLocalValue aufrufen, ist der handelnde Bindungskontext möglicherweise noch nicht verfügbar, sodass Sie nicht denselben Wert erhalten, der zur Laufzeit angewendet würde. Weitere Informationen zur Rangfolge von Abhängigkeitseigenschaften und zur anderen Hilfsprogramm-API des Eigenschaftensystems finden Sie in der Übersicht über Abhängigkeitseigenschaften.

Gilt für:

Weitere Informationen