WPF混合WinForms应用单实例激活：如何切换激活当前窗口？

核心问题分析 #

Process.MainWindowHandle仅返回进程创建的第一个窗口句柄，后续切换的窗口不会更新该属性，因此依赖它无法激活用户当前正在使用的窗口。必须自行维护当前激活窗口的句柄，并通过进程间通信让二次启动的实例触发已有实例的窗口激活逻辑。

具体实现步骤 #

1. 单实例检测：用Mutex实现可靠校验 #

启动时创建全局命名互斥体，创建失败则说明已有实例运行：

const string UniqueMutexName = "YourCompany_YourAppUniqueId_Mutex";
bool isNewInstance;
using var mutex = new Mutex(true, UniqueMutexName, out isNewInstance);

if (!isNewInstance)
{
    // 触发已有实例激活窗口，随后退出当前实例
    TriggerActiveInstanceToBringWindowToFront();
    Environment.Exit(0);
}

2. 维护当前激活窗口句柄 #

在应用内创建静态全局变量存储当前激活窗口的句柄，分别在WinForms和WPF窗口的激活事件中更新：

• WinForms窗口：

  private void Form_Activated(object sender, EventArgs e)
  {
      AppGlobal.ActiveWindowHandle = ((Form)sender).Handle;
  }
  

• WPF窗口：

  private void Window_Activated(object sender, EventArgs e)
  {
      var window = (Window)sender;
      AppGlobal.ActiveWindowHandle = new WindowInteropHelper(window).Handle;
  }
  

  自定义静态类AppGlobal：

  public static class AppGlobal
  {
      public static IntPtr ActiveWindowHandle { get; set; } = IntPtr.Zero;
  }
  

3. 进程间通信：触发已有实例激活窗口 #

推荐用Windows消息实现轻量IPC：

• 二次启动的实例发送自定义消息给已有实例：

  [DllImport("user32.dll", SetLastError = true)]
  static extern IntPtr FindWindow(string lpClassName, string lpWindowName);
  
  [DllImport("user32.dll", CharSet = CharSet.Auto)]
  static extern bool SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);
  
  const uint WM_CUSTOM_ACTIVATE = 0x0400 + 100; // 自定义消息ID
  
  void TriggerActiveInstanceToBringWindowToFront()
  {
      // 找到已有实例的任意窗口（比如初始登录窗口）
      IntPtr mainHandle = FindWindow(null, "YourAppMainWindowTitle");
      if (mainHandle != IntPtr.Zero)
      {
          SendMessage(mainHandle, WM_CUSTOM_ACTIVATE, IntPtr.Zero, IntPtr.Zero);
      }
  }
  

• 已有实例的窗口注册消息处理，收到消息后激活当前窗口：

  [DllImport("user32.dll")]
  [return: MarshalAs(UnmanagedType.Bool)]
  static extern bool SetForegroundWindow(IntPtr hWnd);
  
  [DllImport("user32.dll")]
  static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
  
  [DllImport("user32.dll")]
  [return: MarshalAs(UnmanagedType.Bool)]
  static extern bool IsIconic(IntPtr hWnd);
  
  const int SW_RESTORE = 9;
  
  // WinForms窗口重写WndProc
  protected override void WndProc(ref Message m)
  {
      if (m.Msg == WM_CUSTOM_ACTIVATE)
      {
          if (AppGlobal.ActiveWindowHandle != IntPtr.Zero)
          {
              if (IsIconic(AppGlobal.ActiveWindowHandle))
              {
                  ShowWindow(AppGlobal.ActiveWindowHandle, SW_RESTORE);
              }
              SetForegroundWindow(AppGlobal.ActiveWindowHandle);
          }
      }
      base.WndProc(ref m);
  }
  
  // WPF窗口注册消息处理
  private void Window_Loaded(object sender, RoutedEventArgs e)
  {
      var helper = new WindowInteropHelper(this);
      HwndSource source = HwndSource.FromHwnd(helper.Handle);
      source.AddHook(WndProc);
  }
  
  private IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
  {
      if (msg == WM_CUSTOM_ACTIVATE)
      {
          if (AppGlobal.ActiveWindowHandle != IntPtr.Zero)
          {
              if (IsIconic(AppGlobal.ActiveWindowHandle))
              {
                  ShowWindow(AppGlobal.ActiveWindowHandle, SW_RESTORE);
              }
              SetForegroundWindow(AppGlobal.ActiveWindowHandle);
          }
          handled = true;
      }
      return IntPtr.Zero;
  }
  

关于运行时变更MainWindowHandle #

无需修改Process.MainWindowHandle（该属性只读且缓存，无法动态更新），只需维护自定义的AppGlobal.ActiveWindowHandle即可，每次窗口激活时自动更新，确保始终指向用户当前使用的窗口。

简化替代方案：使用WindowsFormsApplicationBase #

如果不想手动实现IPC和Mutex，可借助Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase（支持WinForms与WPF混合场景）：

1. 安装Microsoft.VisualBasic NuGet包
2. 创建继承类并配置单实例：

   public class SingleInstanceApp : WindowsFormsApplicationBase
   {
       public SingleInstanceApp()
       {
           IsSingleInstance = true;
       }
   
       protected override void OnCreateMainForm()
       {
           // 启动初始窗口（WinForms或包装后的WPF窗口）
           MainForm = new YourLoginForm();
           // WPF窗口需包装：MainForm = new System.Windows.Forms.Integration.ElementHost { Child = new YourWpfLoginWindow() };
       }
   
       protected override void OnStartupNextInstance(StartupNextInstanceEventArgs eventArgs)
       {
           base.OnStartupNextInstance(eventArgs);
           // 激活当前窗口
           if (AppGlobal.ActiveWindowHandle != IntPtr.Zero)
           {
               if (IsIconic(AppGlobal.ActiveWindowHandle))
               {
                   ShowWindow(AppGlobal.ActiveWindowHandle, SW_RESTORE);
               }
               SetForegroundWindow(AppGlobal.ActiveWindowHandle);
           }
       }
   }
   

3. 在Program.cs中启动：

   [STAThread]
   static void Main()
   {
       Application.EnableVisualStyles();
       Application.SetCompatibleTextRenderingDefault(false);
       new SingleInstanceApp().Run(Environment.GetCommandLineArgs());
   }
   

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