Freigeben über


ColorAnimation.By Eigenschaft

Definition

Ruft den Gesamtbetrag ab, um den die Animation ihren Startwert ändert, oder legt diesen fest.

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>

Eigenschaftswert

Der Gesamtbetrag, um den die Animation ihren Startwert ändert. Der Standardwert ist NULL.

Wenn Sie mit C# oder Visual Basic programmieren, wird der Typ dieser Eigenschaft als Farbe projiziert ?(eine Nullable Color).

Beispiele

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

Hinweise

Wenn Sie die By-Eigenschaft verwenden, um eine Farbe um den angegebenen Betrag zu animieren, wird der Hexadezimalwert der By-Eigenschaft dem Hexadezimalwert der Startfarbe hinzugefügt. Wenn Sie benannte Farben verwenden, denken Sie daran, dass der Name nur einen RGB-Wert darstellt, und dieser Wert wird hinzugefügt.

Wenn Sie beispielsweise #FF0000 (Rot) durch #0000FF (Blau) animieren, lautet die endgültige Farbe #FF00FF (Fuchsia). Wenn Sie jedoch #FF00FF (Fuchsia) durch #0000FF (Blau) animieren, ist die endgültige Farbe noch #FF00FF (Fuchsia).

Sie können die By-Eigenschaft selbst oder mit der From-Eigenschaft festlegen. Wenn Sie sowohl die Eigenschaften By als auch To festlegen, wird der By-Wert ignoriert, und die Animation endet mit dem Wert To.

  • Nur durch: Die Animation wird vom Basiswert der animierten Eigenschaft oder dem Ausgabewert einer vorherigen Animation zur Summe dieses Werts und des durch die By-Eigenschaft angegebenen Werts fortgesetzt.
  • Von und nach: Die Animation wird von dem von der From-Eigenschaft angegebenen Wert zu dem Wert fortgesetzt, der durch die Summe der Eigenschaften From und By angegeben wird.

Gilt für: