孙鑫MFC笔记教程(18)--ActiveX 控件

基本概念：
容器和服务器程序
容器应用程序时可以嵌入或链接对象的应用程序。Word就是容器应用程序。
服务器应用程序是创建对象并且当对象被双击时，可以被启动的应用程序。Excel就是服务器应用程序。
ActiveX控件不能独立运行，它必须被嵌入容器应用程序中，和容器应用程序一起运行。

---------------------------------------------------------------------------------
编写一个ActiveX 时钟控件
1.利用MFC ActiveX ContrlWizard 新建一个Clock工程
2.在新建的工程中有三个类，其中CClockApp从COleControlModule中派生出来的，COleControlModule(从CWndApp派生而来)
可以将其看作是应用程序类，它的一个实例表示控件程序本身。

CClockCtrl 从COleControl 中派生出来的，
COleControl 从CWnd派生得到，也是一个窗口类，
CClockCtrl 相当于单文档程序的主窗口类或者说view类。
这个类包含重绘用的OnDraw函数，也包含了一些消息映射，包括调度映射。
Dispatch maps调度映射，主要是MFC提供让外部应用程序可以访问控件的属性和方法。
Event maps事件映射，控件向包含它的容器发送事件通知。

CClockPropPage 类由 COlePropertyPage 派生而来：
COlePropertyPage(从CDialog派生而来)

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 }给它关联了一个对话框资源。
接口 (抽象基类) 调用的那个实际是实现子类的复习C++类

运行:regsvr32 /u F:/Projects/Child/Clock/Debug/Clock.ocx(目录) 删除

运行:regsvr32 F:/Projects/Child/Clock/Debug/Clock.ocx(目录) 注册
在工程中，还有两个全局函数：
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）在设计时，可以点击右键为控件添加事件响应。