ColorAnimation.By Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 .