ColorAnimation.By Propiedad

Definición

Obtiene o establece la cantidad total por la que la animación cambia su valor inicial.

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>

Valor de propiedad

Cantidad total por la que la animación cambia su valor inicial. El valor predeterminado es null.

Si va a programar con C# o Visual Basic, el tipo de esta propiedad se proyecta como Color?(un color que acepta valores NULL).

Ejemplos

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

Comentarios

Cuando se usa la propiedad By para animar un color por la cantidad especificada, el valor hexadecimal de la propiedad By se agrega al valor hexadecimal del color inicial. Si usa colores con nombre, recuerde que el nombre solo representa un valor rgb y ese valor es lo que se va a agregar.

Por ejemplo, si animas #FF0000 (Rojo) por #0000FF (Azul), el color final es #FF00FF (Fuchsia). Sin embargo, si animas #FF00FF (Fuchsia) por #0000FF (Azul), el color final sigue siendo #FF00FF (Fuchsia).

Puede establecer la propiedad By por sí misma o con la propiedad From . Si establece las propiedades By y To , se omite el valor By y la animación termina con el valor To.

  • Solo por: La animación progresa desde el valor base de la propiedad que se anima o el valor de salida de una animación anterior hasta la suma de ese valor y el valor especificado por la propiedad By .
  • De y por: La animación avanza desde el valor especificado por la propiedad From al valor especificado por la suma de las propiedades From y By .

Se aplica a