ColorAnimation Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Media.Animation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Animiert den Wert einer Color-Eigenschaft zwischen zwei Zielwerten mithilfe einer linearen Interpolation über eine angegebene Dauer.

public ref class ColorAnimation sealed : Timeline

/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ColorAnimation final : Timeline

[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ColorAnimation : Timeline

Public NotInheritable Class ColorAnimation
Inherits Timeline

<ColorAnimation .../>

Vererbung: Object Platform::Object IInspectable DependencyObject Timeline ColorAnimation

Attribute: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie colorAnimation verwenden, um die Hintergrundfarbe eines StackPanel zu animieren.

<StackPanel x:Name="myStackPanel" Background="Red"
  Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">

      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="myStackPanel" 
        Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"
        From="Red" To="Blue" Duration="0:0:4"/>

    </Storyboard>
  </StackPanel.Resources>
</StackPanel>

<StackPanel x:Name="myStackPanel" Background="Red"
Loaded="Start_Animation">
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">

            <ColorAnimationUsingKeyFrames Storyboard.TargetName="myStackPanel" 
      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)">
                
                <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates
                a smooth, linear animation between values. -->
                <LinearColorKeyFrame Value="Blue" KeyTime="00:00:02" />

                <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a 
                sudden jump between values. -->
                <DiscreteColorKeyFrame Value="Yellow" KeyTime="00:00:2.5" />

                <!-- In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame 
                creates a variable transition between values depending on the KeySpline property. In this example,
                the animation starts off slow but toward the end of the time segment, it speeds up exponentially.-->
                <SplineColorKeyFrame Value="Green" KeyTime="00:00:4.5" KeySpline="0.6,0.0 0.9,0.00" />

            </ColorAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
</StackPanel>

<StackPanel Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">
      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
        Storyboard.TargetProperty="Color" From="Red" To="Blue" Duration="0:0:4"/>
    </Storyboard>
  </StackPanel.Resources>

  <StackPanel.Background>
    <SolidColorBrush x:Name="mySolidColorBrush" Color="Red" />
  </StackPanel.Background>

</StackPanel>

// Start the animation when the object loads.
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)"

Alternativ können Sie den SolidColorBrush explizit erstellen, ihn benennen und seine Color-Eigenschaft direkt als Ziel verwenden. Das folgende Beispiel zeigt, wie sie dieselbe Animation wie die vorherige animation erstellen, mit der Ausnahme, dass sie direkte Eigenschaftenadressierung verwendet.

<StackPanel Loaded="Start_Animation">
  <StackPanel.Resources>
    <Storyboard x:Name="colorStoryboard">
      <!-- Animate the background color of the canvas from red to green
        over 4 seconds. -->
      <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
        Storyboard.TargetProperty="Color" From="Red" To="Blue" Duration="0:0:4"/>
    </Storyboard>
  </StackPanel.Resources>

  <StackPanel.Background>
    <SolidColorBrush x:Name="mySolidColorBrush" Color="Red" />
  </StackPanel.Background>

</StackPanel>

// Start the animation when the object loads.
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

Hinweise

Verwenden Sie ColorAnimation, um den Eigenschaftswert einer Abhängigkeitseigenschaft vom Typ Color zu animieren.

Lineare Interpolation für eine Farbe bedeutet, dass jeder der ARGB-Werte als Byte behandelt wird und die Interpolation einfach eine mathematische Operation ist. Die besten Ergebnisse erzielen Sie aus der Farbinterpolation, wenn mindestens eine der RGB-Komponenten im Anfangs- und Endwert gleich oder nahe am gleichen ist.

In der Regel müssen Sie indirekte Eigenschaftenadressierung verwenden, um eine Untereigenschaft eines anderen Objekts als Ziel zu verwenden, bei dem es sich um den Wert einer Eigenschaft auf dem Ziel handelt. Dies liegt daran, dass nur sehr wenige Eigenschaften, die Farbinformationen in UI-Elementen anzeigen, tatsächlich vom Typ Color sind. Die meisten sind anstelle des Typs Brush. Um ColorAnimation für Ui-Elemente zu verwenden, zielen Sie in der Regel auf die Color-Eigenschaft eines SolidColorBrush ab, bei dem es sich um den Untereigenschaftswert handelt. Die Syntax dafür wird im XAML-Beispiel im Abschnitt "Beispiele" gezeigt. Weitere Informationen zu indirekten Eigenschaftenzielen und anderen Konzepten für Storyboardanimationen finden Sie unter Storyboardanimationen oder Eigenschaftenpfadsyntax.

Für eine ColorAnimation ist in der Regel mindestens eine der Eigenschaften From, By oder To festgelegt, aber nie alle drei.

Nur von: Die Animation wird von dem durch die From-Eigenschaft angegebenen Wert zum Basiswert der animierten Eigenschaft fortgesetzt.
Von und nach: Die Animation wird von dem wert fortgesetzt, der von der From-Eigenschaft angegeben wird, und dem Wert, der von der To-Eigenschaft angegeben wird.
Von und nach: Die Animation wird von dem von der From-Eigenschaft angegebenen Wert zu dem Wert fortgesetzt, der durch die Summe der Eigenschaften From und By angegeben wird.
Nur für: Die Animation wird vom Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation zu dem von der To-Eigenschaft angegebenen Wert fortgesetzt.
Nur durch: Die Animation wird vom Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation zur Summe dieses Werts und des durch die By-Eigenschaft angegebenen Werts fortgesetzt.

Die Eigenschaften From, By und To einer ColorAnimation sind nicht unbedingt eine Farbe. Stattdessen ist dies ein Nullable-Wert für Color. Der Standardwert für diese ist NULL, nicht eine nicht initialisierte Struktur. Dieser NULL-Wert ist, wie das Animationssystem unterscheidet, dass Sie keinen speziellen Wert festgelegt haben. Visual C++-Komponentenerweiterungen (C++/CX) verfügen nicht über einen Nullable-Typ und nutzen stattdessen IReference.

Konstruktoren

ColorAnimation()

Initialisiert eine neue instance der ColorAnimation-Klasse.

Eigenschaften

AutoReverse	Ruft einen Wert ab, der angibt, ob die Zeitachse nach einem vollständigen Durchgang vorwärts in umgekehrter Reihenfolge abspielt. (Geerbt von Timeline)
BeginTime	Ruft den Zeitpunkt ab, zu dem diese Zeitachse beginnen soll, oder legt diese fest. (Geerbt von Timeline)
By	Ruft den Gesamtbetrag ab, um den die Animation ihren Startwert ändert, oder legt diesen fest.
ByProperty	Identifiziert die By-Abhängigkeitseigenschaft.
Dispatcher	Gibt immer in einer Windows App SDK-App zurück`null`. Verwenden Sie stattdessen DispatcherQueue . (Geerbt von DependencyObject)
DispatcherQueue	Ruft den `DispatcherQueue` ab, dem dieses Objekt zugeordnet ist. Stellt `DispatcherQueue` eine Funktion dar, die auf den `DependencyObject` im UI-Thread zugreifen kann, auch wenn der Code von einem Nicht-UI-Thread initiiert wird. (Geerbt von DependencyObject)
Duration	Ruft die Zeitdauer ab, für die diese Zeitachse wiedergegeben wird, ohne Wiederholungen, oder legt diese fest. (Geerbt von Timeline)
EasingFunction	Ruft die auf diese Animation angewendete Beschleunigungsfunktion ab oder legt sie fest.
EasingFunctionProperty	Gibt die EasingFunction-Abhängigkeitseigenschaft an.
EnableDependentAnimation	Ruft einen Wert ab, der angibt, ob animierte Eigenschaften, die als abhängige Animationen gelten, diese Animationsdeklaration verwenden dürfen, oder legt diesen fest.
EnableDependentAnimationProperty	Identifiziert die EnableDependentAnimation-Abhängigkeitseigenschaft .
FillBehavior	Ruft einen Wert ab, der angibt, wie sich die Animation verhält, nachdem sie das Ende ihres aktiven Zeitraums erreicht hat, oder legt diesen fest. (Geerbt von Timeline)
From	Ruft den Anfangswert der Animation ab oder legt ihn fest.
FromProperty	Identifiziert die From-Abhängigkeitseigenschaft.
RepeatBehavior	Ruft das Wiederholungsverhalten dieser Zeitachse ab oder legt es fest. (Geerbt von Timeline)
SpeedRatio	Ruft die Rate relativ zum übergeordneten Element ab, zu dem für diese Zeitachse ein Fortschritt erfolgt, oder legt diese fest. (Geerbt von Timeline)
To	Ruft den Endwert der Animation ab oder legt ihn fest.
ToProperty	Identifiziert die To-Abhängigkeitseigenschaft.

Methoden

ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Abhängigkeitseigenschaft. (Geerbt von DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Gibt einen beliebigen Basiswert zurück, der für eine Abhängigkeitseigenschaft eingerichtet wurde, der in Fällen gilt, in denen eine Animation nicht aktiv ist. (Geerbt von DependencyObject)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft aus einem DependencyObject zurück. (Geerbt von DependencyObject)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn ein lokaler Wert festgelegt ist. (Geerbt von DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registriert eine Benachrichtigungsfunktion zum Lauschen auf Änderungen an einer bestimmten DependencyProperty für dieses DependencyObject-instance. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft für ein DependencyObject fest. (Geerbt von DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Bricht eine Änderungsbenachrichtigung ab, die zuvor durch Aufrufen von RegisterPropertyChangedCallback registriert wurde. (Geerbt von DependencyObject)

Ereignisse

Completed

Tritt auf, wenn die Wiedergabe des Storyboard-Objekts abgeschlossen wurde.

(Geerbt von Timeline)

Gilt für:

Freigeben über