在winform中如何嵌入第三方软件窗体✨

标签：IntPtr 嵌入窗口句柄窗体 SetParent static winform

相关win32api的学习✨

SetParent

[DllImport("user32.dll ", EntryPoint = "SetParent")]
private static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent);   //将外部窗体嵌入程序

语法：

HWND SetParent(
  [in]           HWND hWndChild,
  [in, optional] HWND hWndNewParent
);

参数：

参数名	类型	含义
hWndChild	HWND	子窗口的句柄
hWndNewParent	HWND	新父窗口的句柄。如果此参数为 NULL，桌面窗口将成为新的父窗口。如果此参数 HWND_MESSAGE，则子窗口将成为仅消息窗口。

FindWindow

 [DllImport("user32.dll")]
 public static extern IntPtr FindWindow(string lpszClass, string lpszWindow);      //按照窗体类名或窗体标题查找窗体

作用：检索其类名和窗口名称与指定字符串匹配的顶级窗口的句柄。此函数不搜索子窗口。此函数不执行区分大小写的搜索。

若要从指定的子窗口开始搜索子窗口，请使用 FindWindowEx 函数。

语法：

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

参数：

参数名	类型	含义
lpClassName	LPCTSTR	如果 lpClassName 指向字符串，则指定窗口类名。
lpWindowName	LPCTSTR	窗口名称 (窗口标题) 。如果此参数为 NULL，则所有窗口名称都匹配。

ShowWindow

作用：设置指定窗口的显示状态。

语法：

HWND FindWindowA(
  [in, optional] LPCSTR lpClassName,
  [in, optional] LPCSTR lpWindowName
);

参数：

参数名	类型	含义
hWnd	HWND	窗口的句柄。
nCmdShow	int	控制窗口的显示方式。

nCmdShow不同值与含义：


0	隐藏窗口并激活另一个窗口。
1	激活并显示窗口。如果窗口最小化、最大化或排列，系统会将其还原到其原始大小和位置。应用程序应在首次显示窗口时指定此标志。
2	激活窗口并将其显示为最小化窗口。
3	激活窗口并显示最大化的窗口。
4	以最近的大小和位置显示窗口。
5	激活窗口并以当前大小和位置显示窗口。
6	最小化指定的窗口，并按 Z 顺序激活下一个顶级窗口。
7	将窗口显示为最小化窗口。
8	以当前大小和位置显示窗口。
9	激活并显示窗口。如果窗口最小化、最大化或排列，系统会将其还原到其原始大小和位置。还原最小化窗口时，应用程序应指定此标志。
10	根据启动应用程序的程序传递给 CreateProcess 函数的 STARTUPINFO 结构中指定的SW_值设置显示状态。
11	最小化窗口，即使拥有窗口的线程没有响应。仅当最小化不同线程的窗口时，才应使用此标志。

创建一个静态类✨

为了便于进行相关的操作，创建一个静态类：

  public static class WindowManager
  {
      public static IntPtr intPtr;         //第三方应用窗口的句柄

      /// <summary>
      /// 调整第三方应用窗体大小
      /// </summary>
      public static void ResizeWindow()
      {
          ShowWindow(intPtr, 0);  //先将窗口隐藏
          ShowWindow(intPtr, 3);  //再将窗口最大化，可以让第三方窗口自适应容器的大小
      }

      /// <summary>
      /// 循环查找第三方窗体
      /// </summary>
      /// <returns></returns>
      public static bool FindWindow(string formName)
      {
          for (int i = 0; i < 100; i++)
          {
              //按照窗口标题查找Python窗口
              IntPtr vHandle = FindWindow(null, formName);
              if (vHandle == IntPtr.Zero)
              {
                  Thread.Sleep(100);  //每100ms查找一次，直到找到，最多查找10s
                  continue;
              }
              else      //找到返回True
              {
                  intPtr = vHandle;
                  return true;
              }
          }
          intPtr = IntPtr.Zero;
          return false;
      }


      /// <summary>
      /// 将第三方窗体嵌入到容器内
      /// </summary>
      /// <param name="hWndNewParent">父容器句柄</param>
      /// <param name="windowName">窗体名</param>
      public static void SetParent(IntPtr hWndNewParent, string windowName)
      {
          ShowWindow(intPtr, 0);                 //先将窗体隐藏，防止出现闪烁
          SetParent(intPtr, hWndNewParent);      //将第三方窗体嵌入父容器                    
          Thread.Sleep(100);                      //略加延时
          ShowWindow(intPtr, 3);                 //让第三方窗体在容器中最大化显示
          RemoveWindowTitle(intPtr);             // 去除窗体标题
      }


      /// <summary>
      /// 去除窗体标题
      /// </summary>
      /// <param name="vHandle">窗口句柄</param>
      public static void RemoveWindowTitle(IntPtr vHandle)
      {
          long style = GetWindowLong(vHandle, -16);
          style &= ~0x00C00000;
          SetWindowLong(vHandle, -16, style);
      }


      #region API 需要using System.Runtime.InteropServices;

      [DllImport("user32.dll ", EntryPoint = "SetParent")]
      private static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent);   //将外部窗体嵌入程序

      [DllImport("user32.dll")]
      public static extern IntPtr FindWindow(string lpszClass, string lpszWindow);      //按照窗体类名或窗体标题查找窗体

      [DllImport("user32.dll", EntryPoint = "ShowWindow", CharSet = CharSet.Auto)]
      private static extern int ShowWindow(IntPtr hwnd, int nCmdShow);                  //设置窗体属性

      [DllImport("user32.dll", EntryPoint = "SetWindowLong", CharSet = CharSet.Auto)]
      public static extern IntPtr SetWindowLong(IntPtr hWnd, int nIndex, long dwNewLong);

      [DllImport("user32.dll", EntryPoint = "GetWindowLong", CharSet = CharSet.Auto)]
      public static extern long GetWindowLong(IntPtr hWnd, int nIndex);

      #endregion
  }

首先查看最下方的内容，以

 [DllImport("user32.dll ", EntryPoint = "SetParent")]
 private static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent);

为例进行说明。

这段代码是在C#中使用平台调用（Platform Invoke，或P/Invoke）来调用Windows的user32.dll中的一个函数，名为SetParent。这是一种在.NET中调用本地方法（通常是C或C++编写的）的技术。

[DllImport("user32.dll ", EntryPoint = "SetParent")]：这是一个属性，它告诉.NET运行时你要调用的DLL的名称（在这里是"user32.dll"）和函数的入口点（在这里是"SetParent"）。

private static extern IntPtr SetParent(IntPtr hWndChild, IntPtr hWndNewParent)：这是函数的声明。它告诉.NET运行时函数的签名。在这个例子中，函数名为SetParent，它接受两个IntPtr类型的参数（hWndChild和hWndNewParent），并返回一个IntPtr类型的值。

在C#中，extern关键字用于声明一个方法，该方法在外部实现，通常是在一个DLL中。

在该静态类中定义了一个类型为IntPtr的静态成员intPtr表示第三方应用窗口的句柄。

IntPtr类型介绍

在C#中，IntPtr是一个特殊的数据类型，用于表示指针或句柄。它的大小会根据当前操作系统的位数而变化，32位系统下为4字节，64位系统下为8字节。IntPtr主要用于在托管代码和非托管代码之间传递指针或句柄，以及处理不确定性大小的内存操作。它通常用于与操作系统API进行交互、处理内存分配和操作句柄等场景。

IntPtr类型提供了一种安全的方式来处理指针，因为它是托管代码中的数据类型，受到.NET运行时的管理和保护。通过IntPtr，可以在托管代码中安全地表示非托管资源的地址或句柄，而无需担心内存泄漏或其他不安全的操作。

使用IntPtr类型时，需要谨慎处理，并遵循.NET平台的内存管理规则，以确保代码的稳定性和安全性。通常情况下，IntPtr主要用于与非托管代码进行交互，处理平台特定的资源或操作系统API，同时尽量避免直接使用指针操作，以减少内存管理和安全性方面的问题。

这个静态类还有ResizeWindow、FindWindow、SetParent、RemoveWindowTitle方法，等后面用到了再做解释。

创建一个winform✨

winform的设计如下所示：

启动软件按钮点击事件处理程序：

 private void button2_Click(object sender, EventArgs e)
 {
     Process.Start("程序路径");
 }

嵌入窗体按钮点击事件处理程序：

  private void button1_Click(object sender, EventArgs e)
  {
      Task.Run(() =>
      {               
          if (WindowManager.FindWindow("Sysplorer [演示版]"))
          {
              this.Invoke(new Action(() =>
              {
                  WindowManager.SetParent(panel1.Handle, "Sysplorer [演示版]");  
              }));
          }
          else
          {
              MessageBox.Show("未能查找到窗体");
          }
      });
  }

在这里就会遇到一个问题就是如何确定窗体的标题是什么？

可以使用VS中的Spy++工具。

什么是Spy++

Spy++（Spy++）是Microsoft Visual Studio套件中的一个实用工具，用于Windows平台的应用程序开发和调试。它允许开发人员查看和分析正在运行的Windows应用程序的窗口层次结构、消息流和属性。

Spy++的主要功能包括：

窗口层次结构：Spy++可以显示当前系统上所有可见和隐藏的窗口，并以层次结构的形式展示它们之间的父子关系。这使得开发人员可以快速了解应用程序的界面组织和窗口之间的相互作用。
消息监视：Spy++可以捕获和显示应用程序之间发送和接收的Windows消息。这对于调试和分析应用程序的行为非常有用，特别是在处理用户输入、事件处理和消息传递方面。
属性查看：Spy++允许开发人员查看和修改窗口的属性，如标题、类名、位置、大小、样式等。这对于调试和修改窗口属性以及理解窗口如何与应用程序交互非常有帮助。
窗口捕获：Spy++可以捕获特定窗口的消息，并将其导出为日志文件，以供进一步分析和调试使用。

总之，Spy++是一个强大的工具，可用于Windows平台的应用程序开发和调试，它提供了丰富的功能来帮助开发人员理解和调试复杂的窗口应用程序。

打开之后，如下所示：

可以通过这样查看窗体名：

查找窗体名

得到了关于这个窗体的一些信息，其中红框部分就是窗体标题，如下所示：

找到窗体标题之后，看看WindowManager.FindWindow方法：

 public static bool FindWindow(string formName)
 {
     for (int i = 0; i < 100; i++)
     {
         //按照窗体标题查找窗体
         IntPtr vHandle = FindWindow(null, formName);
         if (vHandle == IntPtr.Zero)
         {
             Thread.Sleep(100);  //每100ms查找一次，直到找到，最多查找10s
             continue;
         }
         else      //找到返回True
         {
             intPtr = vHandle;
             return true;
         }
     }
     intPtr = IntPtr.Zero;
     return false;
 }

再看看 WindowManager.SetParent方法：

  public static void SetParent(IntPtr hWndNewParent, string windowName)
  {
      ShowWindow(intPtr, 0);                 //先将窗体隐藏，防止出现闪烁
      SetParent(intPtr, hWndNewParent);      //将第三方窗体嵌入父容器                    
      Thread.Sleep(100);                      //略加延时
      ShowWindow(intPtr, 3);                 //让第三方窗体在容器中最大化显示
      RemoveWindowTitle(intPtr);             // 去除窗体标题
  }

现在查看一下效果：

查看效果1

但是我们发现嵌入的效果不是很好，而且无法随着窗体的变化而变化，需要再做下修改：

 public Form1()
 {
     InitializeComponent();
     this.Resize += new EventHandler(Form1_Resize);
 }

注册窗体的Resize事件。

事件处理程序：

  private void Form1_Resize(object sender, EventArgs e)
  {
      Task.Run(() =>
      {
          //第三方窗体句柄不为空
          if (WindowManager.intPtr != IntPtr.Zero)
          {
              WindowManager.ResizeWindow();
          }
      });
    
  }

现在再来看一下效果：

查看效果2

总结✨

以上就是在winform中嵌入第三方窗体的一次实践，希望对你有所帮助。

参考✨

1、C#完美将第三方窗体嵌入Panel容器（WPF、Winform）_c#嵌入另一个exe文件到panel控件中,exe打开的子窗口也识别进来-CSDN博客

2、技术文档 | Microsoft Learn

标签：IntPtr,嵌入,窗口,句柄,窗体,SetParent,static,winform
From： https://www.cnblogs.com/mingupupu/p/18058334