这里说的是 VB6,如果是调用 .NET 建议改用 C# ,aardio 与 C# 混合开发更方便。
VB6 的开发环境在现代操作系统上安装困难,网上有安装教程可以尝试一下(不一定行)。如果不想麻烦,可以下载一个精简版本 VB6 —— 这个至少能跑起一些基本的简单功能,或者可以安装一个 XP的虚拟机来运行 VB6 完整版。
VB6 运行库至今仍然是各版本 Windows 系统自带的系统组件,所以 VB6 可以生成体积极小的执行文件( VC6 也有这个优势 )。
今天我们一起来玩一下 vb6,先用 VB6 写一个控件,步骤如下:
1、打开VB6,选择新建 ActiveX 控件。
2、在工具条里拖一个 Image 控件到默认的用户控件 UserControl1 上面。
3、双击 UserControl1 切换到代码,添加代码如下:
'声明一个普通变量
Dim TestPropertyValue As Integer
'声明一个事件,在 aardio 中可以响应这个事件,
'注意参数加了ByRef表示传址,在 aardio 中就可以修改这这个参数的值
Public Event OnImageClick(ByRef TestPropertyValue As Integer)
'这是VB6里点了Image图像控件触发的事件
Private Sub Image1_Click()
'触发 COM 控件的事件( 换句话说就是调用 aardio 中的函数 )
RaiseEvent OnImageClick(TestPropertyValue)
End Sub
'窗口调整大小触发这个函数,注意 aardio 控件都是非适应缩放的
Private Sub UserControl_Resize()
Image1.Width = UserControl.Width
Image1.Height = UserControl.Height
End Sub
'定义读属性 TestProperty 的函数,这是带参数的属性
Public Property Get TestProperty(Param As Integer) As Integer
TestProperty = TestPropertyValue Param
End Property
'定义写属性 TestProperty 的函数,带参数属性(参数要跟上面一致)
Public Property Let TestProperty(Param As Integer, ByVal v As Integer)
TestPropertyValue = v - Param
End Property
'定义写属性 Picture 的函数,参数是一个 IDispatch 接口的 COM 对象
Public Property Let Picture(ByVal pic As Variant)
Image1.Picture = pic
End Property
'定义一个名为 Picture 的函数
Public Function Add(ByVal a As Integer, ByVal b As Integer)
Add = a b
End Function
然后在 VB 里点击 IDE 主菜单“文件->生成 *.ocx ” 就可以了。
整体看起来还是非常简单对吧。不过我在 aardio 自带的这个范例里没写注释,因为 VB 使用 ANSI 编码(内部 Unicode 这种文字游戏解决不了实际问题),而现在 ANSI 编码的文件里用中文的话,很多编辑器打开都是乱码,所以我把注释删掉了。
VB 的乱码问题是一个大坑,例如把 ocx 放在简体中文目录下,或者 ocx 本身包含简体中文名,然后在繁体中文系统下打开就会崩溃。
不过没有关系,在 aardio 里我们可以轻松解决这个问题。在 aardio 里加下面的代码加载 VB 控件:
var dll = com.lite.appData("aardio\vb6\Vb6Control.ocx",$"\.vb6\Vb6Control.ocx")
请注意第@2个参数的路径前有一个$字符,这会将 ocx 的二进制数据编译到代码里,发布后就不需要再带一个 ocx 了,VB的 ocx 并不支持内存加载,所以我们用 com.lite.appData() 函数将其自动复制到 %CommonAppData% 目录下,这个路径是全英文的,自动就解决了 VB6 控件遇到 Unicode 路径崩溃的大难题。
另外,其他需要访问文件路径的地方我们用 aardio 来实现,不用 VB6 干这事,这样就可以避免 VB6 踩到这个坑。
我们再看看我们在 aardio 中怎么创建这个控件:
import com.lite;
var dll = com.lite.appData("aardio\vb6\Vb6Control.ocx",$"\.vb6\Vb6Control.ocx")
var vbUserControl = dll.createEmbedEx(winform.static);
非常简单,VB里怎么使用这个控件,在 aardio 里我们就怎么使用。其实我们可以在 dll.createEmbedEx() 的第@2个参数里指定 COM控件的 CLSID,但 VB 这个 CLSID 不好找,很多人是先注册控件再去注册表里查,问题是 VB6现在注册控件会报错失败 —— 不过好在 aardio 可以免注册调用 VB 控件,并且在 aardio 中可以省略 CLSID,aardio 会自己帮你找到正确的 CLSID 。这么贴心 —— 有没有被感动呢?!
上面参数指定的 winform.static 是COM控件宿主窗口(也是COM控件的父窗口),vbUserControl 并不是COM对象,而是 COM对象的容器,vbUserControl._object 才是 COM 对象。
调用 COM 对象的时候需要写 vbUserControl._object.xxxx () 是不是很吃力呢?!其实我们在 aardio 中通常不会这么写,vbUserControl 通常会添加大量的封装函数,通过这些函数再去访问 vbUserControl._object ,这样 vbUserControl 就成为了一个代理对象,这种好处是非常多的,一个最典型的例子就是标准库的 web.form 或者 com.flash。
但如果我们不想去过多的封装,只想直接使用 COM 对象呢?!一个非常简单的方法是这样写:
var comObject = vbUserControl._object
然后使用这个 comObject 就行了,不过能不能不写这句代码呢?!其实也是可以的,这就是我使用 dll.createEmbedEx() 而非 dll.createEmbed() 的原因了,这两个函数作用相同,但带 Ex 后缀的 dll.createEmbedEx() 多了一个功能,他返回的控件容器对象已经自动实现了一个简单的 COM 控件代理 —— 例如上面访问 vbUserControl 对象的成员就会自动转为调用 vbUserControl._object 的成员,等于将COM控件容器与 COM对象合二为一了。
控件容器对象还可以作为默认的事件监听器,记得我们前面 VB 代码中用 RaiseEvent OnImageClick(TestPropertyValue) 触发事件吗?在 aardio 代码中我们可以如下响应这个事件:
//控件容器也是默认的 COM 事件监听器,如下直接指定响应 COM 事件的函数
vbUserControl.OnImageClick = function(value){
winform.edit.print("VB控件里点击了图像,事件参数:" value)
//VB里这个事件的参数声明为 ByRef,所以添加返回值可以修改参数
return 100
}
VB6 里这个事件的参数指定为 ByRef 传址,也就是说参数 value 是一个引用参数,在 aardio 中可以修改他的值,aardio 基于纯函数原则不会直接修改外部参数的值,而是通过增加返回值修改引用参数的值。这个事件函数没有返回值,也只有一个需要输出值的引用参数,所以增加一个返回值就可以了。
这个示例是用 VB 显示图像,我们就不要用 VB 来加载图像了,如果图像路径有中文或 Unicode 字符又不太好,但 aardio 是 UTF8 内核,没有这些问题,所以我们用 com.picture.loadObject( "~\codes\范例程序\D) 图形图像\.gdip.jpg" ) 加载图像再传给 VB, com.pictrue 的函数创建的都是 IPicture 对象,这是与 VB 兼容的,但我们通过 COM 接口不能传原生的 IPicture 过去,我们要用 com.picture.loadObject() 函数,右键点这个函数跳转到定义,看一下源代码你就明白了:
namespace com.picture{
loadObject = function(path){
return ..com.QueryObject( load(path) );
}
}
其实就是调用 com.pictrue.load() 加载图像,再用 com.QueryObject() 转换为 COM 对象( IDispatch 接口 ) ,然后就可以传给 VB了:
//修改VB控件的属性
vbUserControl.Picture = com.picture.loadObject( "~\codes\范例程序\D) 图形图像\.gdip.jpg" )
反正我在繁体系统下测试 VB控件直接加载上面的图像会出问题,但用上面的方法 —— 用 aardio 加载图像再传给 VB6 就完美解决。
至于调用 VB 函数这个很简单:
//调用 VB 函数
var c = vbUserControl.Add(2,3);
VB有一个比较有特色的参数化属性,例如看到这种写法是不是蒙了:
vbUserControl.TestProperty(2) = 123
千万别以为是给函数的返回值赋值,我们把上面的参数化属性赋值转换为 等价的 aardio 代码如下:
//修改VB控件的参数化属性,加上 set 前缀以函数形式调用
vbUserControl.setTestProperty(2,123)
在 aardio 里给属性加上 set 前缀就可以变成一个写属性的函数,当然也就支持多个参数了。同理,加上 get 前缀可以变成一个读属性函数,如下:
/*
带多个参数的属性加上get前缀并以函数形式调用,例如:
*/
var testProperty = vbUserControl.getTestProperty(2);
好吧下面我们看这个范例的完整 aardio 源码,直接复制就可以运行,直接复制就是一个独立的、完整的程序:
import win.ui;
/*DSG{{*/
var winform = win.form(text="免注册嵌入 VB 控件";right=706;bottom=274)
winform.add(
edit={cls="edit";left=356;top=20;right=665;bottom=243;db=1;dl=1;dr=1;dt=1;edge=1;hscroll=1;multiline=1;vscroll=1;z=2};
static={cls="static";text="Static";left=21;top=20;right=330;bottom=243;dl=1;dt=1;transparent=1;z=1}
)
/*}}*/
import com.lite;
var dll = com.lite.appData("aardio\vb6\Vb6Control.ocx"
,$"~\codes\范例程序\2) 调用其他语言\F) VB\.vb6\Vb6Control.ocx");
var vbUserControl = dll.createEmbedEx(winform.static);
//控件容器也是默认的 COM 事件监听器
vbUserControl.OnImageClick = function(value){
winform.edit.print("VB控件里点击了图像,事件参数:" value);
return 100;
}
//修改VB控件的属性
vbUserControl.Picture = com.picture.loadObject( "~\codes\范例程序\D) 图形图像\.gdip.jpg" )
//修改VB控件的参数化属性,加上 set 前缀以函数形式调用
vbUserControl.setTestProperty(2,123)
//带多个参数的属性加上get前缀并以函数形式调用,例如:
var testProperty = vbUserControl.getTestProperty(2);
winform.edit.print("VB 控件 TestProperty(2) 属性:",testProperty);
//调用 VB 函数
var c = vbUserControl.Add(2,3);
winform.edit.print("调用 VB 控件函数返回值:",c);
winform.edit.print("请点击图像试试");
winform.show();
win.loopMessage();
最后不得不佩服一下,这个 VB 控件的体积是:24KB,对比一下现在用 Electron 什么的没写几个功能就几百MB是什么概念,这几百MB里有多少是你真正需要的东西?!不是说这些东西没有用,就像豪华大房车一定是有用的,但你明明骑个自行车能解决的问题,非要每次都开豪华大房车吗?!想想这个道理,就会明白 VB6 的好处在哪里。
图还是要补上的: