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

时间：2024-03-07 20:20:56

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

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

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

直接上图先：

 嵌入QQ影音 嵌入Windows Live Writer

嵌入photoshop 嵌入Adobe Reader

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

 

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

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

 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 }

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

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);

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

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 }

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

 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 }

 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

界面是这个样子的：

我的WindowDetective界面是这个样子的

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

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

QQ TM版也可以这样嵌进来

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

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

 

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

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

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

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

2015-05-04

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

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


转载请注明出处，http://www.cnblogs.com/bitzhuwei/archive/2012/05/24/SmileWei_EmbeddedApp.htmlO(∩_∩)O谢谢

相关文章