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

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

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

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

直接上图先：

 

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

 

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

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

Process p = null; 
try 
{
  // Start the process 
  p = System.Diagnostics.Process.Start(this.exeName); 

  // Wait for process to be created and enter idle condition 
  p.WaitForInputIdle(); 

  // Get the main handle
  appWin = p.MainWindowHandle; 
} 
catch (Exception ex) 
{ 
  MessageBox.Show(this, ex.Message, "Error"); 
}

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

// Put it into this form
SetParent(appWin, this.Handle);//this在这里是Panel控件



// Remove border and whatnot
SetWindowLong(appWin, GWL_STYLE, WS_VISIBLE);

// Move the window to overlay it on this window
MoveWindow(appWin, 0, 0, this.Width, this.Height, true);

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

protected override void OnResize(EventArgs e)
{
  if (this.appWin != IntPtr.Zero)
  {
    MoveWindow(appWin, 0, 0, this.Width, this.Height, true);
  }
  base.OnResize (e);
}

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

protected override void OnHandleDestroyed(EventArgs e)
{
  // Stop the application
  if (appWin != IntPtr.Zero)
  {
    // Post a colse message
    PostMessage(appWin, WM_CLOSE, 0, 0);

    // Delay for it to get the message
    System.Threading.Thread.Sleep(1000);

    // Clear internal handle
    appWin = IntPtr.Zero;
  }
  base.OnHandleDestroyed (e);
}

 

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

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

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

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

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

appContainer1.AppFilename = openEXE.FileName;
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

界面是这个样子的：

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

用法很简单，启动这个程序后，它会自动检测鼠标所在位置的窗体信息，显示在窗口中。所以把鼠标放在你想了解的窗体菜单栏上就OK了。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谢谢