使用 com.CreateEmbed 函数在窗体上嵌入可视化控件。
参考: 事件触发接口
容器对象 = com.CreateEmbed( 容器对象,窗口或控件对象,progId)
容器对象 = com.CreateEmbed( 容器对象,窗口或控件对象,comObject)
容器对象 = 窗口或控件对象.createEmbed(progId,容器对象)
容器对象 = 窗口或控件对象.createEmbed(comObject,容器对象)
所有窗体或控件都象都提供了 createEmbed 函数。一般不会调用 com.CreateEmbed 而是调用窗体或控件的 createEmbed 函数。窗体或控件的 createEmbed 函数提供了更完善的功能。
此函数的作用是创建 COM 控件并将 COM 控件嵌入到指定的窗口或控件对象。
容器对象的作用是接管 COM 对象。
容器对象可通过添加成员函数响应 COM对象 事件。
容器对象的另一个主要作用是充当访问 COM 对象的中间代理对象。通常使用 util.metaProperty 为容器对象添加属性元表，属性元表可拦截属性、函数调用并调用实际的 COM 控件。
容器对象包含以下成员：
容器对象._object
指向真正的 COM 控件对象。
在 aardio 中,下划线开始的成员是只读的不可修改，同时也是在提醒你这是隐藏的对象。如果不是清楚的了解这些对象的作用，不应当去使用这些成员对象。在开发环境中,智能提示默认不会提示下划线开始的成员,而是试图隐藏它们，只有你输入下划线以后，这些隐藏的成员才会出现在自动提示列表中。
容器对象._form
指向 COM 控件的容器窗口。
容器对象._host
COM 控件 OLE 宿主对象。提供部分 OLE 接口函数，一般没必要直接使用这个对象。
host.close() = 关闭对象 _host._adjust() = 自动调整控件窗口大小 _host.tranacc(MSG消息对象) = 解析快捷键,如果是快捷键返回真值 _host.doObjectVerb( _OLEIVERB_ ) = 执行指定的动词命令
我们可以直接使用 var comObject = 容器对象._object 获得 COM 控件对象，然后直接操作 comObject 。
但是通常我们需要容器对象，这是因为：
如果我们需要上面的好处，又不希望为 COM 对象写一个库做一些封装的操作，可以改用下面的 com.createEmbedEx 函数。com.createEmbedEx 会将容器对象创建为默认的代理表并可以直接访问 COM 对象。
容器对象 = com.createEmbedEx( 容器对象,窗口或控件对象,progId)
容器对象 = com.createEmbedEx( 容器对象,窗口或控件对象,comObject)
容器对象 = 窗口或控件对象.createEmbedEx(progId,容器对象)
容器对象 = 窗口或控件对象.createEmbedEx(comObject,容器对象)
所有参数的用法与返回的容器对象与 com.createEmbed 相同。
所有窗体或控件都象都提供了 createEmbedEx 函数。一般不会调用 com.createEmbedEx 而是调用窗体或控件的 createEmbedEx 函数。窗体或控件的 createEmbedEx 函数提供了更完善的功能。
此函数的主要作用与 createEmbed 一样用于创建 COM 控件并将 COM 控件嵌入到指定的窗口或控件对象。但是 createEmbed 返回的宿主对象需要我们自己添加元表或属性元表去封装到 COM 控件的操作。
createEmbedEx 函数返回的容器对象已自动添加元表并成为了 COM 对象的 代理表，可通过容器对象的成员代理访问 COM 对象成员。也可以通过指定容器对象的成员函数响应 COM 对象事件。
容器对象的 event 成员为 COM 对象默认的事件监听器。如果在容器对象上添加成员回调函数则会默认写入到 event 事件表。
下面是一个嵌入 COM 控件的完整示例：
import win.ui;
/*DSG{{*/
var winform = win.form(text="嵌入 COM 控件";right=759;bottom=469)
winform.add(
lbStatus={cls="static";left=25;top=435;right=725;bottom=460;db=1;dl=1;dr=1;transparent=1;z=2};
static={cls="static";text="Static";left=11;top=8;right=744;bottom=426;db=1;dl=1;dr=1;dt=1;transparent=1;z=1}
)
/*}}*/
//嵌入 COM 控件，宿主窗口这里指定为 winform.static
var embedObject= winform.static.createEmbedEx("Shell.Explorer.2");
//这下定义事件回调函数就省事了( 因为 embedObject 是默认的 COM 事件监听器)
embedObject.StatusTextChange = function(text) {
winform.lbStatus.text = text;
}
//通过控件容器调用 COM 对象打开指定的网页
embedObject.Navigate("about:test");
winform.show();
win.loopMessage();
在上面的示例中，当我们调用：
embedObject.Navigate("about:test");
实际上会自动转换为调用：
embedObject._object.Navigate("about:test")
embedObject 已封装为了 COM 控件代理对象，访问 embedObject 的成员会自动转为调用 embedObject._object （真正的 COM 控件对象）。
代码 var embedObject= winform.static.createEmbedEx("Shell.Explorer.2") 执行了以下操作：
容器对象 embedObject 通常用于实现 COM 代理对象，用于拦截、封装对 embedObject._object 的操作。 winform.static.createEmbedEx() 函数会将容器对象创建为 COM 对象与 COM 事件表的代理对象，接管对 COM 控件以及事件表的访问。
如果希望自定义代理层更精细地封装 COM 接口，请改用 winform.static.createEmbed() 函数创建控件（函数名字后面少了 Ex ）。winform.static.createEmbed() 函数不会创建默认代理。
可在标准库 win.ui.ctrl.metaProperty 内可以查看这 createEmbed，createEmbedEx 函数的源码。
要注意 COM 控件对象本身并不能直接添加事件，例如下面的代码是错误的：
embedObject._object.StatusTextChange = function(text) {}
无论是 winform.static.createEmbedEx() 还是 winform.static.createEmbed() 返回的对象都可以通过容器对象添加事件，正确写法是：
embedObject.StatusTextChange = function(text) {}