WPF自定义ToggleButton后台如何让Background的ColorAnimationUsingKeyFrames生效

错误点汇总 #

1. 依赖属性笔误：初始代码中BlinkingDuration的setter错误将值写入BlinkingProperty，导致参数修改完全不生效，还会意外修改闪烁开关状态。
2. 冻结Brush无法应用动画：Style中设置的默认Background是XAML静态声明的SolidColorBrush，WPF会自动冻结这类Brush以优化性能，冻结后的Freezable类型对象无法应用任何动画，这是硬编码动画也不生效的核心原因。
3. 动画挂载对象不合理：直接将动画挂载到Background实例上，后续如果触发器修改了Background属性（替换整个Brush实例），旧实例上的动画会直接失效，无法达到动画覆盖触发器值的预期。
4. 参数更新后未重启动画：原逻辑中OnAnimationParametersChanged仅更新动画实例，若动画已经在运行，不会自动应用新参数，需要停止旧动画再重启新动画。

修复方案 #

1. 修复依赖属性笔误

修正BlinkingDuration的setter逻辑：

public Duration BlinkingDuration
{
    get => (Duration)GetValue(BlinkingDurationProperty);
    // 原错误代码为SetValue(BlinkingProperty, value)，修改为以下内容
    set => SetValue(BlinkingDurationProperty, value);
}

2. 调整动画逻辑兼容冻结Brush

修改StartAnimation方法，先确保当前背景Brush是未冻结的可写实例，再挂载动画：

private void StartAnimation()
{
    // 先停止已有动画避免冲突
    StopAnimation();
    
    // 校验参数合法性
    if (BlinkAnimationColorBrush == null || InitialAnimationColorBrush == null || BlinkingDuration == default)
        return;

    m_BackgroundAnimation = new ColorAnimationUsingKeyFrames
    {
        Duration = BlinkingDuration,
        RepeatBehavior = RepeatBehavior.Forever,
        FillBehavior = FillBehavior.HoldEnd, // 动画运行期间保持最后一帧值
        AutoReverse = true,
        KeyFrames = new ColorKeyFrameCollection
        {
            new DiscreteColorKeyFrame(InitialAnimationColorBrush.Color, KeyTime.FromPercent(0.0)),
            new DiscreteColorKeyFrame(BlinkAnimationColorBrush.Color, KeyTime.FromPercent(1.0))
        }
    };

    // 若当前背景是冻结Brush/非纯色Brush，先替换为未冻结的纯色Brush
    if (Background is not SolidColorBrush || Background.IsFrozen)
    {
        Background = new SolidColorBrush(InitialAnimationColorBrush.Color);
    }

    // 挂载动画
    Background.BeginAnimation(SolidColorBrush.ColorProperty, m_BackgroundAnimation);
}

3. 参数更新后自动重启动画

修改OnAnimationParametersChanged回调，闪烁状态下参数更新后自动重启动画应用新配置：

private static void OnAnimationParametersChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    if (!(d is CommandAndActivationButton c)) { return; }

    if (c.BlinkAnimationColorBrush == null ||
        c.InitialAnimationColorBrush == null ||
        c.BlinkingDuration == default) { return; }

    c.m_BackgroundAnimation = new ColorAnimationUsingKeyFrames
    {
        Duration = c.BlinkingDuration,
        RepeatBehavior = RepeatBehavior.Forever,
        FillBehavior = FillBehavior.HoldEnd,
        AutoReverse = true,
        KeyFrames = new ColorKeyFrameCollection
        {
            new DiscreteColorKeyFrame(c.InitialAnimationColorBrush.Color, KeyTime.FromPercent(0.0)),
            new DiscreteColorKeyFrame(c.BlinkAnimationColorBrush.Color, KeyTime.FromPercent(1.0))
        }
    };

    // 正在闪烁时直接重启动画应用新参数
    if (c.Blinking)
    {
        c.StartAnimation();
    }
}

WPF依赖属性优先级中动画优先级高于样式触发器、模板触发器，只要动画处于运行状态，触发器修改的Background值会被自动覆盖，符合你的预期效果。

内容的提问来源于stack exchange，提问作者Astralius