C#自定义控件：WinForm将其它应用程序窗体嵌入自己内部

比眉伴天荒 2022-07-15 08:52 349阅读 0赞

http://www.cnblogs.com/bitzhuwei/archive/2012/05/24/SmileWei\_EmbeddedApp.html

大家可以到（[https://github.com/bitzhuwei/AppContainer][https_github.com_bitzhuwei_AppContainer]）找到最新的源码下载。

这是最近在做的一个项目中提到的需求，把一个现有的窗体应用程序界面嵌入到自己开发的窗体中来，看起来就像自己开发的一样（实际上……跟自己开发的还是有一点点区别的，就是内嵌程序和宿主程序的窗口激活状态问题）。

在codeproject找到了一篇相关的文章（[http://www.codeproject.com/Articles/9123/Hosting-EXE-Applications-in-a-WinForm-project][http_www.codeproject.com_Articles_9123_Hosting-EXE-Applications-in-a-WinForm-project]），虽然可用，但是很不方便，于是重新设计编写了一个类库，用一个控件完成内嵌其它应用程序的功能。

直接上图先：

[![嵌入QQ影音][QQ]][QQ_QQ] [![嵌入Windows Live Writer][Windows Live Writer]][Windows Live Writer_Windows Live Writer]

[![嵌入photoshop][photoshop]][photoshop_photoshop] [![嵌入Adobe Reader][Adobe Reader]][Adobe Reader_Adobe Reader]

从打开Adobe Reader那张图片可以看出来所谓的“内嵌程序和宿主程序的窗口激活状态问题”。当内嵌程序窗口激活时，表面上将其包裹起来的宿主窗口却处于非激活的状态。想隐藏这一点的话，把窗口的FormBorderStyle属性设为None吧，然后自己在窗口上画关闭、最大化、最小化按钮好了。

原作者的实现思路更能暴露本质，所以这里用原作者的代码段解释一下实现过程。

1、启动要嵌入的应用程序进程

![复制代码][copycode.gif]

1 Process p = null; 
     2 try 
     3 {
     4   // Start the process 
     5   p = System.Diagnostics.Process.Start(this.exeName); 
     6 
     7   // Wait for process to be created and enter idle condition 
     8   p.WaitForInputIdle(); 
     9 
    10   // Get the main handle
    11   appWin = p.MainWindowHandle; 
    12 } 
    13 catch (Exception ex) 
    14 { 
    15   MessageBox.Show(this, ex.Message, "Error"); 
    16 }

![复制代码][copycode.gif]

2、调用Windows API将启动的应用程序窗口嵌入自定义的控件（作者用的是Panel控件）

![复制代码][copycode.gif]

1 // Put it into this form
    2 SetParent(appWin, this.Handle);//this在这里是Panel控件 
    3 
    4 // Remove border and whatnot
    5 SetWindowLong(appWin, GWL_STYLE, WS_VISIBLE);
    6 
    7 // Move the window to overlay it on this window
    8 MoveWindow(appWin, 0, 0, this.Width, this.Height, true);

![复制代码][copycode.gif]

3、设置被嵌入的窗体大小随宿主窗体改变

![复制代码][copycode.gif]

1 protected override void OnResize(EventArgs e)
    2 {
    3   if (this.appWin != IntPtr.Zero)
    4   {
    5     MoveWindow(appWin, 0, 0, this.Width, this.Height, true);
    6   }
    7   base.OnResize (e);
    8 }

![复制代码][copycode.gif]

4、设置被嵌入的窗体应用程序在宿主程序关闭时也关闭

![复制代码][copycode.gif]

1 protected override void OnHandleDestroyed(EventArgs e)
     2 {
     3   // Stop the application
     4   if (appWin != IntPtr.Zero)
     5   {
     6     // Post a colse message
     7     PostMessage(appWin, WM_CLOSE, 0, 0);
     8 
     9     // Delay for it to get the message
    10     System.Threading.Thread.Sleep(1000);
    11 
    12     // Clear internal handle
    13     appWin = IntPtr.Zero;
    14   }
    15   base.OnHandleDestroyed (e);
    16 }

![复制代码][copycode.gif]

原作者的代码实际用起来是很不方便的，具体大家试试就知道，不细说了（反正我只学了学上面的步骤，也不用他的库）。

本人开发了一个比较实用的控件，使用起来也很简单，只需三步。

首先，在窗体应用程序项目中引用类库SmileWei.EmbeddedApp。

[![在窗体应用程序项目中引用类库SmileWei.EmbeddedApp][SmileWei.EmbeddedApp]][SmileWei.EmbeddedApp_SmileWei.EmbeddedApp]

然后，在宿主窗体上拖一个AppContainer控件，摆放好位置。（如果工具箱里没有AppContainer，就F6生成解决方案一下，然后再看就有了。）

[![在宿主窗体上拖一个AppContainer控件，摆放好位置][AppContainer]][AppContainer_AppContainer]

最后，告诉AppContainer控件，要嵌入的应用程序(\*.exe文件）的绝对路径（本人以使用OpenFileDialog为例），命令AppContainer控件启动之。

1 appContainer1.AppFilename = openEXE.FileName;
    2 appContainer1.Start();

这个AppContainer控件有什么好处呢？

1、原作者想到的Resize和随宿主程序关闭而关闭的问题，AppContainer都实现了。

2、AppContainer指定要嵌入的应用程序和启动是分开的，这样更灵活，开发过程中也不会看到如下的情况了：开发的时候原作者的控件就“情不自禁”地把内嵌程序加载进来了。

[![开发的时候原作者的控件就“情不自禁”地把内嵌程序加载进来了][201205242025308751.png]][201205242025308751.png 1]

3、AppContainer防范了各种可能出错的情形，例如禁止自己嵌入自己（死循环）、内嵌Console程序时提示不能嵌入、参数为null或无效的检验等。

4、其它。例如，AppContainer里面不会使用Thread.Sleep(1000);这样低端的句子来保证程序正确地嵌入（而且对于类似photoshop这样启动很慢的程序也保证不了），而是通过Application.Ilde事件实现了在被嵌程序加载完毕后才将其窗体嵌入的技巧。

当然，有些应用程序是不能这么自动化地嵌入进来的。因为程序启动窗体和主窗体句柄不一样，AppContainer无法获得主窗体句柄，所以无法自动嵌入。

为了解决这个问题，我在宿主窗体的状态栏上设置了“句柄嵌入”标签，点击“句柄嵌入”，你可以填入想嵌入的应用程序主窗体句柄，然后宿主窗体就可以嵌入它了。

[![我在宿主窗体的状态栏上设置了“句柄嵌入”标签，点击“句柄嵌入”，你可以填入想嵌入的应用程序主窗体句柄，然后宿主窗体就可以嵌入它了][201205242025344974.png]][201205242025344974.png 1]

然后有同学就问了，我怎么知道想要嵌入的窗体句柄是多少啊？方法很多啦，我这里也提供一个自己制作的小程序，大家可以在这里下载：[WindowDetective(窗口侦探)0.20.rar][WindowDetective_0.20.rar]

界面是这个样子的：

[![我的WindowDetective界面是这个样子的][WindowDetective]][WindowDetective_WindowDetective]

里面“句柄：\{1903014\}”那一行就给出了本人正在用的Windows Live Writer的主窗体句柄。

用法很简单，启动这个程序后，它会自动检测鼠标所在位置的窗体信息，显示在窗口中。所以把鼠标放在你想了解的窗体菜单栏上就OK了。QQ TM版也可以这样嵌进来滴。（QQ嵌不进来，不知道腾讯在搞什么）

[![QQ TM版也可以这样嵌进来][QQ TM]][QQ TM_QQ TM]

大家还可以试试把QQ对话框嵌进来，很好玩哦~

[![大家还可以试试把QQ对话框嵌进来，很好玩哦~][QQ 1]][QQ_QQ 1]

我的源代码都给出了明确的注释，类型、变量名也都规范易懂，在此不再多做解释了，有疑问请留言吧O(∩\_∩)O

本文所有源代码、可执行程序均可在下面列出的链接中下载到。

示例宿主程序及类库源代码：[SmileWei.EmbeddedApp.rar][]

窗口侦探（用于查看窗口句柄）：[WindowDetective(窗口侦探)0.20.rar][WindowDetective_0.20.rar]

2015-05-04

大家可以到（[https://github.com/bitzhuwei/AppContainer][https_github.com_bitzhuwei_AppContainer]）找到最新的源码下载。

我添加了各种FormBorderStyle的示例App，用于演示这个属性对嵌入的影响。

转载请注明出处，[http://www.cnblogs.com/bitzhuwei/archive/2012/05/24/SmileWei\_EmbeddedApp.html][http_www.cnblogs.com_bitzhuwei_archive_2012_05_24_SmileWei_EmbeddedApp.html]O(∩\_∩)O谢谢

[https_github.com_bitzhuwei_AppContainer]: https://github.com/bitzhuwei/AppContainer
[http_www.codeproject.com_Articles_9123_Hosting-EXE-Applications-in-a-WinForm-project]: http://www.codeproject.com/Articles/9123/Hosting-EXE-Applications-in-a-WinForm-project
[QQ]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205241831247863.png
[QQ_QQ]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205241831233469.png
[Windows Live Writer]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205241831258287.png
[Windows Live Writer_Windows Live Writer]: /images/20220715/400b0b2056204d788132d25016344687.png
[photoshop]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205241831279169.png
[photoshop_photoshop]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/20120524183127630.png
[Adobe Reader]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205241831288513.png
[Adobe Reader_Adobe Reader]: /images/20220715/f50f58e7356c457c974bac23a74bfd9d.png
[copycode.gif]: /images/20220715/efe5e731964a4b9f8d4a4e555381a0f0.png
[SmileWei.EmbeddedApp]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205241831298447.png
[SmileWei.EmbeddedApp_SmileWei.EmbeddedApp]: /images/20220715/00220cbeb64343f6a403736f71f899ec.png
[AppContainer]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/20120524202527717.png
[AppContainer_AppContainer]: /images/20220715/60f49a9e28674adcbfb1164add0e26f6.png
[201205242025308751.png]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205242025308751.png
[201205242025308751.png 1]: /images/20220715/136b0872f2624527a1a58f564d55b785.png
[201205242025344974.png]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205242025344974.png
[201205242025344974.png 1]: /images/20220715/2bb6f04217784f74bf5fe3cfe6fbdd46.png
[WindowDetective_0.20.rar]: http://files.cnblogs.com/bitzhuwei/WindowDetective%28%E7%AA%97%E5%8F%A3%E4%BE%A6%E6%8E%A2%290.20.rar
[WindowDetective]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205242025362584.png
[WindowDetective_WindowDetective]: /images/20220715/117d049ffc52490695c5d075d0f55add.png
[QQ TM]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/20120524202537533.png
[QQ TM_QQ TM]: /images/20220715/77a2c152343e4855bc9266d44fe58248.png
[QQ 1]: http://images.cnblogs.com/cnblogs_com/bitzhuwei/201205/201205242025384545.png
[QQ_QQ 1]: /images/20220715/afea1614e3f14b05a1d7b139b9ff3160.png
[SmileWei.EmbeddedApp.rar]: http://files.cnblogs.com/files/bitzhuwei/SmileWei.EmbeddedApp20150201.rar
[http_www.cnblogs.com_bitzhuwei_archive_2012_05_24_SmileWei_EmbeddedApp.html]: http://www.cnblogs.com/bitzhuwei/archive/2012/05/24/SmileWei_EmbeddedApp.html