ColorAnimation Classe

Definizione

public ref class ColorAnimation sealed : Timeline

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ColorAnimation final : Timeline

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

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

Public NotInheritable Class ColorAnimation
Inherits Timeline

<ColorAnimation .../>

Ereditarietà

Object Platform::Object IInspectable DependencyObject Timeline ColorAnimation

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Esempio

L'esempio seguente mostra come usare ColorAnimation per animare il colore di sfondo di un oggetto StackPanel.

<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();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

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

In alternativa, è possibile creare in modo esplicito SolidColorBrush, denominarlo e specificare direttamente la relativa proprietà Color . L'esempio seguente mostra come creare la stessa animazione di quella precedente, ad eccezione del fatto che usa la destinazione della proprietà diretta.

<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();
}

' Start the animation when the object loads
Private Sub Start_Animation(ByVal sender As Object, ByVal e As EventArgs)
    colorStoryboard.Begin()
End Sub

Commenti

Usare ColorAnimation per animare il valore della proprietà di qualsiasi proprietà di dipendenza di tipo Color.

L'interpolazione lineare per un colore indica che ognuno dei valori ARGB viene considerato come un byte e l'interpolazione è semplicemente un'operazione matematica. Si ottengono risultati ottimali dall'interpolazione dei colori se almeno uno dei componenti RGB è uguale o vicino allo stesso valore sia nel valore iniziale che nel valore finale.

In genere è necessario usare la destinazione della proprietà indiretta per definire come destinazione una sottoproprietà di un altro oggetto che rappresenta il valore di una proprietà nella destinazione. Ciò è dovuto al fatto che pochissime proprietà che visualizzano informazioni sul colore negli elementi dell'interfaccia utente sono effettivamente di tipo Color. La maggior parte è invece di tipo Brush. Per usare ColorAnimation negli elementi dell'interfaccia utente, in genere la destinazione è la proprietà Color di un oggetto SolidColorBrush che rappresenta il valore della sottoproprietà. La sintassi per questa operazione è illustrata nell'esempio XAML nella sezione "Esempi". Per altre info sulla destinazione delle proprietà indirette e su altri concetti relativi all'animazione con storyboard, vedi Animazioni con storyboard o sintassi property-path.

Un ColorAnimation ha in genere almeno una delle proprietà From, By o To impostate, ma non tutte e tre.

• Solo da: L'animazione passa dal valore specificato dalla proprietà From al valore di base della proprietà animata.
• Da e a: L'animazione passa dal valore specificato dalla proprietà From al valore specificato dalla proprietà To .
• Da e per: L'animazione passa dal valore specificato dalla proprietà From al valore specificato dalla somma delle proprietà From e By .
• Solo per: L'animazione procede dal valore di base della proprietà animata o dal valore di output di un'animazione precedente al valore specificato dalla proprietà To .
• Solo per: L'animazione passa dal valore di base della proprietà animata o dal valore di output di un'animazione precedente alla somma di tale valore e al valore specificato dalla proprietà By .

Le proprietà From, By e To di colorAnimation non sono strettamente color. Si tratta invece di un valore Nullable per Color. Il valore predefinito per questi valori è Null, non una struttura non inizializzata. Questo valore Null è il modo in cui il sistema di animazione distingue che non è stato impostato in modo specifico un valore. Non esiste il tipo Nullable delle estensioni del componente Visual C++ (C++/CX) e al suo posto si usa il tipo IReference.

Costruttori

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• Timeline
• SolidColorBrush
• LinearGradientBrush
• Color
• Colors
• Animazioni con storyboard
• Esempio di animazione XAML