ColorAnimation.By Eigenschaft

Referenz

Definition

Namespace:: Windows.UI.Xaml.Media.Animation

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

IReference<Color>

Nullable<Color>

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:

Freigeben über