C#利用Win32 API将外部程序嵌入WinForms面板

纸上星河

发布时间：2026-10-15 | 2人浏览过

原创

在Windows桌面应用开发中，有时需要将第三方程序的界面集成到自己的应用中。本文演示如何利用C#结合Win32 API（主要是SetParent和SetWindowLong），将一个外部进程的主窗体“嵌入”到当前WinForms应用的Panel容器中，实现类似插件或子窗口的效果。

核心原理与准备

该方法的核心逻辑是：Process.Start启动目标程序并将其初始窗口隐藏，随后通过SetParent修改目标窗口的父句柄为当前容器的Handle，并使用SetWindowLong移除原有的边框和标题栏样式，最后通过事件绑定保持尺寸同步。

第1步：封装窗体嵌入类InsertWindow

为了复用代码，我们将所有相关的API声明、常量和逻辑封装在一个静态类中。该类负责启动进程、接管窗口句柄以及处理生命周期。

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

namespace System.Windows.Forms
{
  public class InsertWindow
  {
    private Panel pan = null;
    private Process m_innerProcess = null;

    // Win32 API 声明
    [DllImport("user32.dll")]
    static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent);

    [DllImport("user32.dll")]static extern Int32 GetWindowLong(IntPtr hWnd, Int32 nIndex);

    [DllImport("user32.dll")]static extern Int32 SetWindowLong(IntPtr hWnd, Int32 nIndex, Int32 dwNewLong);

    [DllImport("user32.dll")]static extern Int32 SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, Int32 X, Int32 Y, Int32 cx, Int32 cy, UInt32 uFlags);

    // 常量定义
    const Int32 GWL_STYLE = -16;
    const Int32 WS_BORDER = 0x00800000L;
    const Int32 WS_THICKFRAME = 0x00040000L;
    const Int32 SWP_NOZORDER = 0x0004;
    const Int32 SWP_FRAMECHANGED = 0x0020;

    public InsertWindow(Panel pW, string appname)
    {
      this.pan = pW;
      pane();          // 初始化容器属性
      LoadEvent(appname); // 加载并嵌入应用
    }

    ~InsertWindow()
    {
      if (m_innerProcess != null)
      {
        m_innerProcess.CloseMainWindow();
        m_innerProcess.Dispose();
      }
    }

    private void pane()
    {
      panel1.Anchor = AnchorStyles.Left | AnchorStyles.Top | AnchorStyles.Right | AnchorStyles.Bottom;
      panel1.Resize += new EventHandler(panel1_Resize);
    }

    private void panel1_Resize(object sender, EventArgs e)
    {
      if (m_innerProcess == null) return;
      IntPtr innerWnd = m_innerProcess.MainWindowHandle;
      if (innerWnd == IntPtr.Zero) return;
      // 随容器大小调整嵌入窗口
      SetWindowPos(innerWnd, IntPtr.Zero, 0, 0,
        panel1.ClientSize.Width, panel1.ClientSize.Height,
        SWP_NOZORDER);
    }

    private void LoadEvent(string appFile)
    {
      // 1. 启动进程，隐藏窗口
      m_innerProcess = Process.Start(appFile);
      if (m_innerProcess == null) throw new Exception("无法启动进程");
      
      // 等待进程完全初始化
      m_innerProcess.WaitForInputIdle();
      IntPtr innerWnd = m_innerProcess.MainWindowHandle;
      if (innerWnd == IntPtr.Zero) return;

      // 2. 改变父窗口
      SetParent(innerWnd, panel1.Handle);

      // 3. 去除边框和标题栏
      Int32 wndStyle = GetWindowLong(innerWnd, GWL_STYLE);
      wndStyle &= ~WS_BORDER;
      wndStyle &= ~WS_THICKFRAME;
      SetWindowLong(innerWnd, GWL_STYLE, wndStyle);

      // 4. 刷新窗口样式
      SetWindowPos(innerWnd, IntPtr.Zero, 0, 0, 0, 0,
        SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_FRAMECHANGED);

      // 5. 触发一次初始尺寸同步
      panel1_Resize(null, null);
    }

    public Panel panel1 { get; set; }
  }
}

第2步：在主窗体中调用嵌入类

在标准的WinForms项目中，创建一个Panel控件用于承载外部程序，并在Load事件中实例化InsertWindow类即可。以下示例使用系统自带的“写字板”（Wordpad）作为测试目标。

using System;
using System.Windows.Forms;

namespace DemoEmbedApp
{
  public partial class Form1 : Form
  {
    private Panel panel1;

    public Form1()
    {
      InitializeComponent();
      this.panel1 = new Panel();
      this.panel1.Dock = DockStyle.Fill;
      this.Controls.Add(this.panel1);
      
      // 绑定加载事件
      this.Load += Form1_Load;
    }

    private void Form1_Load(object sender, EventArgs e)
    {
      // 指定要嵌入的应用程序路径
      const string appFile = @"C:\Program Files\Windows NT\Accessories\wordpad.exe";
      
      // 执行嵌入操作
      try
      {
        InsertWindow insertwin = new InsertWindow(panel1, appFile);
      }
      catch (Exception ex)
      {
        MessageBox.Show($"嵌入失败: {ex.Message}");
      }
    }
  }
}