ColorAnimation.By Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Media.Animation

Ottiene o imposta la quantità totale in base alla quale l'animazione modifica il valore iniziale.

public:
 property IReference<Color> ^ By { IReference<Color> ^ get(); void set(IReference<Color> ^ value); };

IReference<Color> By();

void By(IReference<Color> value);

public System.Nullable<Color> By { get; set; }

var iReference = colorAnimation.by;
colorAnimation.by = iReference;

Public Property By As Nullable(Of Color)

<ColorAnimation By="colorString"/>
-or-
<ColorAnimation By="referenceToColor"/>
- or -
<ColorAnimation>
  <ColorAnimation.By>
    <Color>colorString</Color>
  </ColorAnimation.By>
</ColorAnimation>

Valore della proprietà

IReference<Color>

Nullable<Color>

Quantità totale in base alla quale l'animazione modifica il valore iniziale. Il valore predefinito è Null.

Se si sta programmando usando C# o Visual Basic, il tipo di questa proprietà viene proiettato come Color?( colore nullable).

Esempio

<StackPanel>
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">
            <ColorAnimation Storyboard.TargetName="mySolidColorBrush"
                            Storyboard.TargetProperty="Color" Duration="0:0:4" 
                            By="#0000FF"/>
        </Storyboard>
    </StackPanel.Resources>

    <StackPanel Orientation="Horizontal">
        <Button Content="Animate color" Click="Start_Animation"/>
        <Rectangle Height="100" Width="300" Margin="12,0">
            <Rectangle.Fill>
                <SolidColorBrush x:Name="mySolidColorBrush" Color="#00FF00" />
            </Rectangle.Fill>
        </Rectangle>
    </StackPanel>
</StackPanel>

private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}

Commenti

Quando si usa la proprietà By per animare un colore in base alla quantità specificata, il valore esadecimale della proprietà By viene aggiunto al valore esadecimale del colore iniziale. Se si usano colori denominati, tenere presente che il nome rappresenta solo un valore RGB e tale valore è quello che viene aggiunto.

Ad esempio, se si anima #FF0000 (Rosso) per #0000FF (Blu), il colore finale è #FF00FF (Fucsia). Tuttavia, se si anima #FF00FF (Fucsia) da #0000FF (Blu), il colore finale è ancora #FF00FF (Fucsia).

È possibile impostare la proprietà By stessa o con la proprietà From . Se si impostano entrambe le proprietà By e To , il valore By viene ignorato e l'animazione termina con il valore To.

• Solo: L'animazione viene eseguita dal valore di base della proprietà animata o dal valore di output dell'animazione precedente alla somma di tale valore e al valore specificato dalla proprietà By .
• Da e per: L'animazione passa dal valore specificato dalla proprietà From al valore specificato dalla somma delle proprietà From e By .