C#悬浮窗置顶失效如何解决？

Question

在使用C#开发桌面应用时，常通过设置窗体的 `TopMost = true` 实现悬浮窗置顶效果。然而，在某些场景下（如其他全屏程序或系统窗口激活时），悬浮窗会失去置顶状态，导致被遮挡。该问题多见于Windows 10/11系统中资源管理器、游戏或全屏应用抢占前台时，系统强制降权非活动窗口的层级。如何在不频繁轮询 `TopMost` 属性的前提下，稳定维持C#悬浮窗的置顶有效性，成为开发者面临的典型技术难题。

Answer 1

1. 问题背景与现象分析

在使用C#开发桌面应用时，常通过设置窗体的 TopMost = true 实现悬浮窗置顶效果。然而，在Windows 10/11系统中，当资源管理器重启、全屏游戏启动或某些系统级窗口（如锁屏、通知中心）激活时，该属性会失效，导致原本置顶的悬浮窗被遮挡。

这种现象的本质是Windows对“非活动”或“低权限”窗口的层级管理机制。系统出于用户体验和安全考虑，强制降低非前台窗口的Z-order优先级，即使其 TopMost 属性为 true，也无法突破此限制。

开发者若仅依赖简单的属性设置，将难以应对复杂多变的窗口焦点切换场景。

2. 常见错误解决方案对比

方案	实现方式	优点	缺点	适用场景
轮询 TopMost	Timer 每500ms重设 TopMost=true	实现简单	CPU占用高，响应滞后	临时调试
Focus 强制获取	调用 Focus() 或 Activate()	即时生效	干扰用户操作，易被系统拦截	交互型工具
Owner 设置为空	Form.Owner = null	减少依赖影响	无法解决系统降权	通用优化
双窗体互保	两个窗体交替置顶	规避单点失效	逻辑复杂，资源浪费	高可用需求
Hook 窗口消息	WH_CBT Hook 创建/激活事件	精准响应系统变化	需P/Invoke，稳定性要求高	专业级产品

3. 核心技术原理剖析

• Windows窗口层级由Z-order决定，TopMost 对应 HWND_TOPMOST 标志位
• 系统全屏应用可通过 SetWindowPos 强制插入顶层，覆盖 TopMost 窗口
• .NET的 Form.TopMost 是对Win32 API的封装，不具备持续监听能力
• WM_WINDOWPOSCHANGING / WM_WINDOWPOSCHANGED 消息可反映位置与层级变动
• CBT Hook（Computer-Based Training Hook）能拦截窗口创建、激活等关键事件
• UIPI（User Interface Privilege Isolation）可能阻止低完整性进程修改高权限窗口
• 某些游戏使用独占模式（Exclusive Fullscreen），绕过常规窗口管理
• 任务栏刷新或Explorer崩溃会导致Shell重新布局，影响所有TopMost窗口
• 多显示器环境下，不同屏幕的活动状态可能触发层级重排
• 现代Windows引入了“专注助手”、“游戏模式”等特性，主动压制后台窗口行为

4. 推荐解决方案：基于Win32 Hook的智能恢复机制

避免轮询的关键在于“事件驱动”。我们可以通过安装全局CBT Hook，监听窗口激活变化事件，在检测到自身被压栈时立即重置置顶状态。

using System;
using System.Runtime.InteropServices;
using System.Windows.Forms;

public class SmartTopmostManager : Form
{
    private const int HCBT_ACTIVATE = 5;
    private IntPtr hHook = IntPtr.Zero;

    [DllImport("user32.dll")]
    private static extern IntPtr SetWindowsHookEx(int idHook, HookProc lpfn, IntPtr hMod, uint dwThreadId);

    [DllImport("user32.dll")]
    private static extern bool UnhookWindowsHookEx(IntPtr hhk);

    [DllImport("user32.dll")]
    private static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam);

    [DllImport("kernel32.dll")]
    private static extern IntPtr GetModuleHandle(string lpModuleName);

    private delegate IntPtr HookProc(int nCode, IntPtr wParam, IntPtr lParam);

    protected override void OnHandleCreated(EventArgs e)
    {
        base.OnHandleCreated(e);
        StartHook();
    }

    protected override void OnHandleDestroyed(EventArgs e)
    {
        StopHook();
        base.OnHandleDestroyed(e);
    }

    private void StartHook()
    {
        using (var currentProcess = System.Diagnostics.Process.GetCurrentProcess())
        using (var module = currentProcess.MainModule)
        {
            var hModule = GetModuleHandle(module.ModuleName);
            hHook = SetWindowsHookEx(13/*WH_CBT*/, CbtHookProc, hModule, (uint)currentProcess.Id);
        }
    }

    private void StopHook()
    {
        if (hHook != IntPtr.Zero)
        {
            UnhookWindowsHookEx(hHook);
            hHook = IntPtr.Zero;
        }
    }

    private IntPtr CbtHookProc(int code, IntPtr wParam, IntPtr lParam)
    {
        if (code == HCBT_ACTIVATE && wParam != this.Handle)
        {
            // 当前窗口即将失去焦点，检查是否仍需保持TopMost
            if (this.InvokeRequired)
                this.Invoke(new Action(() => this.TopMost = true));
            else
                this.TopMost = true;
        }
        return CallNextHookEx(hHook, code, wParam, lParam);
    }
}

5. 高级优化策略与架构设计

1. 结合 Application.Idle 事件延迟更新UI状态，减少频繁重绘
2. 使用 ChangeWindowMessageFilterEx 处理跨进程消息过滤（适用于Win7+）
3. 监控 SystemEvents.DisplaySettingsChanged 和 SessionSwitch 事件
4. 在多实例环境中使用Mutex + 共享内存同步TopMost状态
5. 启用Aero Peek兼容性设置：注册表调整DWM相关策略
6. 利用WPF的 WindowStyle=None + AllowsTransparency=True 提升渲染自由度
7. 集成Windows Game Bar检测逻辑，动态调整行为策略
8. 添加日志追踪模块，记录每次层级变更的时间戳与调用栈
9. 支持配置文件定义“白名单”全屏程序，允许临时让出顶层
10. 采用插件化设计，便于扩展对特定应用（如Steam、Discord）的行为适配

6. 系统级兼容性处理流程图

graph TD
    A[窗体初始化] --> B{是否支持TopMost?}
    B -- 是 --> C[设置TopMost=true]
    B -- 否 --> D[降级为Normal模式提示]
    C --> E[安装WH_CBT Hook]
    E --> F[监听HCBT_ACTIVATE事件]
    F --> G{接收到激活消息?}
    G -- 是 --> H[判断目标窗口是否为全屏/系统窗口]
    H --> I{是否威胁当前置顶状态?}
    I -- 是 --> J[延时100ms后重置TopMost]
    I -- 否 --> K[维持原状态]
    J --> L[触发Accessibility事件告知用户]
    K --> M[继续监听]
    L --> M
    M --> F