Partager via


ColorAnimation.By Propriété

Définition

Obtient ou définit la quantité totale par laquelle l’animation modifie sa valeur de départ.

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>

Valeur de propriété

Quantité totale par laquelle l’animation modifie sa valeur de départ. La valeur par défaut est null.

Si vous programmez à l’aide de C# ou Visual Basic, le type de cette propriété est projeté en tant que Couleur ?( couleur nullable).

Exemples

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

Remarques

Lorsque vous utilisez la propriété By pour animer une couleur selon le montant spécifié, la valeur hexadécimale de la propriété By est ajoutée à la valeur hexadécimale de la couleur de départ. Si vous utilisez des couleurs nommées, n’oubliez pas que le nom représente simplement une valeur rvb , et cette valeur est ce qui est ajouté.

Par exemple, si vous animez #FF0000 (Rouge) par #0000FF (Bleu), la couleur finale est #FF00FF (Fuchsia). Toutefois, si vous animez #FF00FF (Fuchsia) par #0000FF (Bleu), la couleur finale est toujours #FF00FF (Fuchsia).

Vous pouvez définir la propriété By seule ou avec la propriété From . Si vous définissez les propriétés By et To , la valeur By est ignorée et l’animation se termine par la valeur À.

  • Par uniquement : L’animation progresse de la valeur de base de la propriété animée ou de la valeur de sortie d’une animation précédente à la somme de cette valeur et de la valeur spécifiée par la propriété By .
  • De et par : L’animation progresse de la valeur spécifiée par la propriété From à la valeur spécifiée par la somme des propriétés From et By .

S’applique à