基本概念:
容器和服务器程序
容器应用程序时可以嵌入或链接对象的应用程序。Word就是容器应用程序。
服务器应用程序是创建对象并且当对象被双击时,可以被启动的应用程序。Excel就是服务器应用程序。
ActiveX控件不能独立运行,它必须被嵌入容器应用程序中,和容器应用程序一起运行。
---------------------------------------------------------------------------------
编写一个ActiveX 时钟控件
1.利用MFC ActiveX ContrlWizard 新建一个Clock工程
2.在新建的工程中有三个类,其中CClockApp从COleControlModule中派生出来的,
可以将其看作是应用程序类,它的一个实例表示控件程序本身。
COleControl 从CWnd派生得到,也是一个窗口类,
CClockCtrl 相当于单文档程序的主窗口类。
这个类包含重绘用的OnDraw函数,也包含了一些消息映射,包括调度映射。
Dispatch maps调度映射,主要是MFC提供让外部应用程序可以访问控件的属性和方法。
Event maps事件映射,控件向包含它的容器发送事件通知。
CClockPropPage 类由 COlePropertyPage 派生而来:
COlePropertyPage
The COlePropertyPage class is used to display the properties of a custom control in a graphical interface, similar to a dialog box. 被用来显示一个自定义控件的属性,类似于一个对话框。
它是对话框类,于是 enum { IDD = IDD_PROPPAGE_CLOCK }给它关联了一个对话框资源。
在工程中,还有两个全局函数:
STDAPI DllRegisterServer(void)
将控件信息写入注册表中
STDAPI DllUnregisterServer(void)
卸载注册信息。
3.在三个类之上,还有类似小勺的图标Dclock,_DClockEvents,它们表示接口。
接口是外部程序和控件进行通信的协议,可以把接口看作是函数的集合,
外部程序通过接口提供的方法,去访问控件的属性和方法。
也可以将接口看作抽象基类,接口中所定义的所有函数都是纯虚函数,
这些函数的实现都是在CClockCtrl类中实现,
MFC通过底层的封装使CClockCtrl类继承Dclock接口。
所以调用接口,事实上调用的是CClockCtrl类中的函数。
由于封装,底层的通信细节我们看不到,如果对这个感兴趣,可以看一些COM编程的资料。
4.如果些时编译一下工程,会生成一个Clock.ocx文件,它就是ActiveX控件的文件。
要用控件的时候,只需要把这个文件传递给对方。
注意:ActiveX控件不能单独使用,必须嵌入到一个窗口当中一直运行。
当我们用VB添加控件时,发现了我们刚才编译的控件,但是VB怎么知道我们新建的控件的位置呢?
我们发现编译时,输出窗口的最后一行 “Registering ActiveX Control...”
说明编译时会注册控件。
事实上编译之后,VC会调用regsvr32 注册控件,并将信息写入到注册表中,
VB在加载ActiveX控件时,会从注册表中搜寻相关的ActiveX控件信息。
注意:ActiveX控件在使用之前都需要注册。
如果想卸载控件,可以在“运行”中输入命令:
“regsvr32 /u 控件文件完整路径名”
事实上是调用工程中全局函数DllUnregisterServer来完成卸载的。
如果想再次注册控件,可以在“运行”中输入下面命令:
“regsvr32 控件文件完整路径名”
事实上是调用工程中全局函数DllRegisterServer来完成注册的。
5.下面实现在控件上输出当时系统时间。
可以在OnDraw函数中完成这个功能。
这样就能做出一个静态的时间控件,如果我们想使控件实时显示时间,
需要添加两个消息响应函数 WM_CREATE,WM_TIMER.要使时间可以每秒更新,
我们先在CClockCtrl 类中添加 WM_CREATE 消息处理,在其响应函数OnCreate()中
设置一个计时器:SetTimer(1,1000,NULL);
接着增加一个WM_TIMER消息响应处理,在OnTimer中写上
Invalidate(); 使窗口发生重绘。
也可以调用InvalidateControl()强制控件重绘自身。
6.在VB测试中发现,其他很多控件可以修改控件的背景色、前景色和字体颜色,而我们还不行。
ActiveX控件有四种属性:
Stock:为每个控件提供的标准属性,如字体或颜色。
Ambient:围绕控件的环境属性——已被置入容器的属性。
这些属性不能被修改,但控件可以使用它们调整自己的属性。
Extended:这些是由容器处理的属性,一般包括大小和在屏幕上的位置。
Custom:由控件开发者添加的属性。
7.这时在VB测试中,我们的控件也可以修改控件的背景色和前景色了,但是设置完以后没有效果,
因为还要OnDraw函数中自己编写代码来完成这些改变。
要得到控件标准属性,要通过一些函数来完成,如COleControl::GetForeColor 得到前景色
COleControl::GetBackColor得到背景色,不过要注意的是它们得到的是OLE_COLOR 的
颜色,还需要通过TranslateColor 方法转换成COLORREF
8.控件一般都会有属性页,当我们右键点击控件时会弹出这个属性页方便对控件属性的设置,
我们的控件已经有一个属性页,通过CClockPropPage类来实现的,显示的面容是对话框资源的内容,
下面修改控件属性页:
属性页之所以可以在窗口中看得到,是因为在ClockCtl.cpp中的
BEGIN_PROPPAGEIDS(CClockCtrl, 1)与END_PROPPAGEIDS(CClockCtrl)之间
调用了 PROPPAGEID(CClockPropPage::guid),其中的guid表示全局唯一标识符,
它是一个128位的整数,用来唯一地标识一个组件或者一个接口。
我们可以用PROPPAGEID宏增加属性页。
增加颜色属性页
首先在BEGIN_PROPPAGEIDS(CClockCtrl, 1)与END_PROPPAGEIDS(CClockCtrl)之间添加代码 PROPPAGEID(CLSID_CColorPropPage)来添加属性页。
CLSID_CColorPropPage属性表单是控件自身提供的,
我们添加之后不用作任何处理,就可以使用,效果如下:
注意:
BEGIN_PROPPAGEIDS(CClockCtrl, 2)中的数字2表示有多少个属性页代码要显示,
如果增加了属性页数字一定要加1,不然如果没有修改或修改错误,会产生不可预料错误。
9.增加一个自定义属性也是通过MFC ClassWizard来完成,与第6步增加前景色与背景色的步骤相同。
1)下面增加设置时间间隔的属性,用这个属性来控件时间刷新频率:
属性添加成功以后,在_DClock接口中增加了Interval属性,同时在CClockCtrl类中增加了一个
成员变量m_interval和OnIntervalChanged()方法(当外部属性修改之后就会调用这个方法)。
而且它们都在调度映射当中:
2)在CClockCtrl::OnIntervalChanged()中添加属性处理程序代码
10.使增加的自定义属性在属性表单中设置
在对话框资源中添加一个编辑框,再为这个编辑框关联一个变量
注意,我们在为编辑框关联一个变量m_updateInterval的同时也关联了一个属性是,
这样我们不需要增加代码就能把控件和自定义属性相关联。
在void CClockPropPage::DoDataExchange(CDataExchange* pDX)中会生成下面代码:
这样,我们就可以在属性页里面设置时间间隔了。
11.为控件添加一个方法:
为控件增加函数,MFC ClassWizard-->Automation-->Add Method
Class Name要选择CClockCtrl
输入函数名,之后就可以在CClockCtrl类中找到了
方法添加成功以后,在_DClock接口中增加了Hello方法,同时在CClockCtrl类中增加了Hello方法。
接下来,我们可以在CClockCtrl类中增加了Hello方法添加自己的代码就可以了。
12.为控件添加一个标准事件
我们选择MFC ClassWizard-->ActiveX Events--->Add Event
事件添加成功以后,会在_DClockEvents中增加一个事件Click,DClockEvents接口是源接口,
控件将用这个接口发送通知事件,它不是控件本身实现的接口,这个接口是通过容器来实现的
13.增加一个自定义事件:当秒数为0时,发出一个NewMinute事件。
1)增加一个自定义事件的过程与增加一个标准事件的步骤相同,
也可以这样添加在事件接口_DClockEvents上点击右键,选择增加事件,
效果一样,都会弹出Add Event对话框。
事件添加成功以后,会在_DClockEvents中增加一个事件NewMinute事件,
同时在在CClockCtrl类中增加了void FireNewMinute(),也就是在控件内部可以调用
FireNewMinute()向容器发送事件通知,而这个函数内部会调用接口的void NewMinute()
向容器发出事件通知。
2)在OnDraw()方法添加代码
if(0 == time.GetSecond())FireNewMinute();
使当秒数为0时,向容器发出一个NewMinute事件通知。
标准消息不需要另外写代码向容器发出事件通知,VC在底层代码内部实现了这个过程。
14.将我们自定义的控件属性在修改之后永久保存下来,
用户打开程序之后,控件的属性都是使用原先保存的值。
需要在void CClockCtrl::DoPropExchange(CPropExchange* pPX)加入如下代码
PX_Short(pPX,"Interval",m_interval,1000);
之后再在程序中OnCreate()方法中将SetTimer(1,1000,NULL);
修改代码为 SetTimer(1,m_interval,NULL);
15.在属性页中修改自定义控件属性的时候,通知容器做相应的调整,
从而使容器属性列表中实时地显示我们对属性所作的修改。
在void CClockCtrl::OnIntervalChanged() 中加入如下代码:
BoundPropertyChanged(0x1); //通知容器调度ID为1的属性发生了改变
16.前面都是让控件在容器设计时改变控件属性,
如果希望用户在设计模式时时钟控件停止运行,而在用户模式下时间会跳动,
在控件内部可以通过AmbientUserMode()方法得到当前控件是处于设计状态还是运行状态。
在void CClockCtrl::OnTimer(UINT nIDEvent)下修改代码如下:
if(AmbientUserMode()) InvalidateControl();
17.编写完控件以后,我们可以选择Win32 Release方式进行编译,生成发行版ActiveX控件。
在开发的时候通常是以Win32 Debug模式下编译的,这种模式下开发有助于我们开发过程的产生的错误,例如非法内存访问错误;还可以帮助我们调试程序,跟踪程序进而排查错误。但是在调试模式下生成的文件比较大,因为在文件中包含了调试的信息。
而当我们开发完成后,在Release模式下进行编译时,VC编译器会在代码生成上、执行速度上做一些优化,同时生成的可执行程序或控件文件会比较小。
-------------------------------------------------------------------
在VC中编写一个客户端调用 ActiveX控件:
1.新建一个基于MFC对话框的ClockTest 工程项目
2.点击右键,选择“插入ActiveX控件”,然后在弹出的对话框中选择刚才我们创建的控件。
也可以通过菜单的方式增加控件:
“工程”->增加到工程->Componets and Controls
选择已注册控件"Registered ActiveX Contrlos",找到我们自己控件,再按下插入。
通过这种方式插入ActiveX控件时,会在工程中自动生成一个类CCock,其基类为CWnd。
这个类是一个封装类,封装了对ActiveX控件进行访问的一些操作。
同时在VC的工具箱上面也增加一个时钟控件,可以直接将一个时钟控件拖放到窗体上。
3.用第二种方法插入的控件,除了将控件手动插入到窗体以外,我们也可以通过代码动态生成一个控件。
1)CClockTestDlg增加一个成员变量:CClock m_clock;
2)在CClockTestDlg的头文件中包含一个clock.h
3)接下来就要以在一个按钮的单击事件中增加创建控件的代码:
4)在设计时,可以点击右键为控件添加事件响应。