WPF附加属性实现控件自动隐藏求助：ShowTime配置与功能失效

看起来你已经找对了方向——用附加属性来实现通用的自动隐藏功能，但确实踩了几个常见的WPF附加属性坑。我来帮你一步步解决这两个问题：

问题一：添加ShowTime附加属性 #

要给附加属性类添加ShowTime参数，你只需要再注册一个附加属性即可，和VisibilityListener的写法一致。我们可以把它定义为double类型，表示自动隐藏的秒数，和你之前自定义控件的用法保持一致：

public class AutoHideExtension
{
    // 原VisibilityListener属性，先留着后面修正
    public static readonly DependencyProperty VisibilityListenerProperty = 
        DependencyProperty.RegisterAttached(
            "VisibilityListener", 
            typeof(bool), 
            typeof(AutoHideExtension), 
            new PropertyMetadata(false, VisibilityChanged));

    // 新增ShowTime附加属性
    public static readonly DependencyProperty ShowTimeProperty = 
        DependencyProperty.RegisterAttached(
            "ShowTime", 
            typeof(double), 
            typeof(AutoHideExtension), 
            new PropertyMetadata(3.0)); // 默认3秒，和你之前的示例一致

    // ShowTime的Get/Set方法
    public static double GetShowTime(DependencyObject obj)
    {
        return (double)obj.GetValue(ShowTimeProperty);
    }

    public static void SetShowTime(DependencyObject obj, double value)
    {
        obj.SetValue(ShowTimeProperty, value);
    }

    // 原VisibilityListener的Get/Set方法（后面要修正）
    public static bool GetVisibilityListener(DependencyObject obj)
    {
        return (bool)obj.GetValue(VisibilityListenerProperty);
    }

    public static void SetVisibilityListener(DependencyObject obj, bool value)
    {
        obj.SetValue(VisibilityListenerProperty, value);
    }

    // 后面是修正后的VisibilityChanged方法
}

问题二：修复功能失效的核心问题 #

你的功能失效主要有几个关键错误，我逐一给你修正：

1. Get/Set方法类型不匹配：原来的VisibilityListener属性是bool类型，但你写的Get方法返回double，Set方法参数也是double，这会导致WPF无法正确绑定或设置这个属性，VisibilityChanged回调根本不会触发。
2. 未正确获取ShowTime值：原来的代码里直接用ShowTime变量，但这个变量不存在，需要通过附加属性的Get方法从目标控件上获取。
3. 逻辑判断错误：原来的代码里判断!IsLoaded，但IsLoaded没有指定对象，应该是element.IsLoaded；而且逻辑应该是当VisibilityListener变为true时才启动计时器，同时要确保控件当前是可见的。
4. 计时器重复创建问题：如果VisibilityListener多次变化，会创建多个计时器，需要先停止之前的计时器再创建新的。

修正后的完整AutoHideExtension代码 #

using System.Windows;
using System.Windows.Threading;
using System.Collections.Generic;

public class AutoHideExtension
{
    // 用于存储每个控件对应的计时器，避免重复创建与内存泄漏
    private static readonly Dictionary<DependencyObject, DispatcherTimer> _timerCache = new();

    public static readonly DependencyProperty VisibilityListenerProperty = 
        DependencyProperty.RegisterAttached(
            "VisibilityListener", 
            typeof(bool), 
            typeof(AutoHideExtension), 
            new PropertyMetadata(false, VisibilityChanged));

    public static readonly DependencyProperty ShowTimeProperty = 
        DependencyProperty.RegisterAttached(
            "ShowTime", 
            typeof(double), 
            typeof(AutoHideExtension), 
            new PropertyMetadata(3.0));

    public static bool GetVisibilityListener(DependencyObject obj)
    {
        return (bool)obj.GetValue(VisibilityListenerProperty);
    }

    public static void SetVisibilityListener(DependencyObject obj, bool value)
    {
        obj.SetValue(VisibilityListenerProperty, value);
    }

    public static double GetShowTime(DependencyObject obj)
    {
        return (double)obj.GetValue(ShowTimeProperty);
    }

    public static void SetShowTime(DependencyObject obj, double value)
    {
        obj.SetValue(ShowTimeProperty, value);
    }

    private static void VisibilityChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
    {
        if (d is not FrameworkElement element)
            return;

        // 先停止之前的计时器（如果存在）
        if (_timerCache.TryGetValue(element, out var existingTimer))
        {
            existingTimer.Stop();
            _timerCache.Remove(element);
        }

        var isTriggered = (bool)e.NewValue;
        if (!isTriggered)
            return;

        // 如果控件还没加载，等Loaded事件触发后再处理
        if (!element.IsLoaded)
        {
            void OnLoaded(object s, RoutedEventArgs args)
            {
                element.Loaded -= OnLoaded;
                StartAutoHideTimer(element);
            }
            element.Loaded += OnLoaded;
            return;
        }

        // 控件已加载且触发条件满足，启动计时器
        StartAutoHideTimer(element);
    }

    private static void StartAutoHideTimer(FrameworkElement element)
    {
        // 获取ShowTime值，转换为TimeSpan
        var showTimeSeconds = GetShowTime(element);
        var interval = TimeSpan.FromSeconds(showTimeSeconds);

        var timer = new DispatcherTimer(DispatcherPriority.Background)
        {
            Interval = interval
        };

        timer.Tick += (sender, args) =>
        {
            element.Visibility = Visibility.Collapsed;
            timer.Stop();
            _timerCache.Remove(element);
        };

        _timerCache[element] = timer;
        timer.Start();
    }
}

用法示例 #

现在你可以给任意控件添加自动隐藏功能了，比如：

<TextBlock Text="TextToHide" 
           helpers:AutoHideExtension.VisibilityListener="{Binding ChangesSavedEnabled}"
           helpers:AutoHideExtension.ShowTime="3"/>

<!-- 其他控件也可以复用 -->
<Button Content="AutoHide Button"
        helpers:AutoHideExtension.VisibilityListener="{Binding ButtonShowEnabled}"
        helpers:AutoHideExtension.ShowTime="5"/>

额外说明：我加了一个_timerCache字典来管理每个控件的计时器，避免多次触发时创建多个计时器导致控件提前隐藏或者重复执行隐藏逻辑，同时在计时器触发后清理缓存，避免内存泄漏。

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