ColorAnimation.By Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Media.Animation

Получает или задает общее значение, с помощью которого изменяется начальное значение анимации.

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>

Значение свойства

IReference<Color>

Nullable<Color>

Общее значение, с помощью которого изменяется начальное значение анимации. Значение по умолчанию — NULL.

При программировании на C# или Visual Basic тип этого свойства проецируется как Color?( цвет, допускающий значение NULL).

Примеры

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

Комментарии

При использовании свойства By для анимации цвета на указанную величину шестнадцатеричное значение свойства By добавляется к шестнадцатеричным значениям начального цвета. Если вы используете именованные цвета, помните, что имя просто представляет rgb-значение , и это значение добавляется.

Например, если анимировать #FF0000 (красный) по #0000FF (синий), окончательный цвет будет #FF00FF (Fuchsia). Однако если анимировать #FF00FF (Fuchsia) по #0000FF (синий), окончательный цвет по-прежнему #FF00FF (Fuchsia).

Свойство By можно задать самостоятельно или с помощью свойства From . Если задать свойства By и To , значение By игнорируется, а анимация заканчивается значением To.

• Только по: Анимация переходит от базового значения анимируемого свойства или выходного значения предыдущей анимации к сумме этого значения и значению, заданному свойством By .
• From and By: Анимация переходит от значения, указанного свойством From , к значению, заданному суммой свойств From и By .