UIElement.GetAnimationBaseValue(DependencyProperty) 方法

定義

傳回這個項目上指定屬性的基底屬性值,不管任何執行中的可能動畫值,或停止動畫。Returns the base property value for the specified property on this element, disregarding any possible animated value from a running or stopped animation.

public:
 virtual System::Object ^ GetAnimationBaseValue(System::Windows::DependencyProperty ^ dp);
public object GetAnimationBaseValue (System.Windows.DependencyProperty dp);
abstract member GetAnimationBaseValue : System.Windows.DependencyProperty -> obj
override this.GetAnimationBaseValue : System.Windows.DependencyProperty -> obj
Public Function GetAnimationBaseValue (dp As DependencyProperty) As Object

參數

dp
DependencyProperty

要檢查的相依性屬性。The dependency property to check.

傳回

Object

屬性值,就好像指定的相依性屬性未附加任何動畫。The property value as if no animations are attached to the specified dependency property.

實作

範例

下列範例會執行一個處理常式,該處理常式會報告上動畫屬性的基底值 Width Button ,以及轉換的基底值。The following example implements a handler that reports the base value of an animated Width property on a Button, as well as the base value of a transform.

// Display the base value for Button.Width and RotateTransform.Angle.
private void animatedButton_Clicked(object sender, RoutedEventArgs e)
{
    Button animatedButton = (Button)sender;
    MessageBox.Show("Button width base value: " + 
        animatedButton.GetAnimationBaseValue(Button.WidthProperty)
        + "\nRotateTransform base value: " +
        animatedRotateTransform.GetAnimationBaseValue(RotateTransform.AngleProperty));
}
' Display the base value for Button.Width and RotateTransform.Angle.
Private Sub animatedButton_Clicked(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim animatedButton As Button = CType(sender, Button)
    MessageBox.Show("Button width base value: " & animatedButton.GetAnimationBaseValue(Button.WidthProperty).ToString & vbLf & "RotateTransform base value: " & animatedRotateTransform.GetAnimationBaseValue(RotateTransform.AngleProperty).ToString)
End Sub

備註

如果沒有任何動畫附加至屬性,則傳回 GetAnimationBaseValue 值一律與傳回 GetValue 值相同。If no animations are attached to the property, then the GetAnimationBaseValue return value is always identical to the GetValue return value. 如果有附加動畫,則會忽略所有可能的動畫衍生值(包括 start 和 stop 值),並根據所有其他可能的輸入來決定屬性值。If there are animations attached, then all possible animation derived values including the start and stop values are ignored, and the property value is determined based on all other possible inputs. 如需詳細資訊,請參閱相依性屬性值優先順序For more information, see Dependency Property Value Precedence.

適用於

另請參閱