COM 组件设计与应用18属性包Word下载.docx

COM 组件设计与应用18属性包Word下载.docx

《COM 组件设计与应用18属性包Word下载.docx》由会员分享，可在线阅读，更多相关《COM 组件设计与应用18属性包Word下载.docx（11页珍藏版）》请在冰豆网上搜索。

paramname="

_ExtentX"

value="

9393"

_ExtentY"

4974"

_Version"

393216"

ForeColor"

0"

MaxSelCount"

7"

MonthColumns"

1"

CurrentDate"

38632"

MaxDate"

2958465"

MinDate"

-53688"

/object>

以文本方式保存组件属性，比较直观、容易修改，上面HTML示例中的<

属性名"

值"

就很清晰。

下面开始介绍如何在组件中实现IPersistPropertyBag接口。

二、组件的实现

（1）vc6.0开发步骤

1、建立一个工作空间（WorkSpace）。

2、在这个工作空间中，建立ATL工程，示例程序工程为Simple18。

3、增加ATL对象类，默认全部选项。

示例程序中的ATL对象短名称是Property。

4、增加一些属性。

在以前的章回中，我们只介绍了增加接口函数的方法，由于今天是首次增加接口属性，所以稍微细致一些。

步骤是，在ClassView卡片中选择接口（IProperty）后，执行鼠标右键菜单"

AddProperty..."

5、增加BSTR类型的接口属性str，同样的方式，再增加一个long型的接口属性interger。

在示例程序中，这两个属性其实只为演示，并没有实际的意义。

6、接口中的属性，多数情况下会对应对象内部的一个成员变量，因此我们现在要添加成员变量。

选择对象类名，执行鼠标右键菜单"

AddMemberVariable...."

7、添加两个成员变量，一个是CComBSTRm_str对应于接口属性str；

另一个是longm_integer对应于接口属性integer。

（2）开发步骤

1、建立一个空白解决方案。

2、在解决方案中，新增ATL项目。

示例程序中项目名称叫Simple18，注意不要选择“属性化编程”方式。

3、添加ATL类。

选择“ATL的简单对象”。

默认全部选项。

示例程序中ATL类短名称为Property，类名称为CMyProperty。

（注1）

4、增加一些属性。

步骤是，在类视图卡片中选择接口（IProperty）后，执行鼠标右键菜单"

添加属性..."

添加变量...."

（3）实现代码

　　至此，我们组件的框架已经完成，下面该完成函数函数的实现了：

STDMETHODIMPCxxx:

:

get_str（BSTR*pVal）

{

*pVal=m_str.Copy（）;

returnS_OK;

}

put_str（BSTRnewVal）

m_str=newVal;

get_integer（LONG*pVal）

*pVal=m_integer;

put_integer（LONGnewVal）

m_integer=newVal;

没有什么复杂的，就是实现str、integer两个属性值的设置和读取功能。

（4）添加IPersistPropertyBag接口

　　还记得我们在上回书中如何添加IPersistStreamInit的吗？

添加IPersistPropertyBag的方法也一样，但这次我们换一个方式，即我们不从IPersistPropertyBag派生，而是从IPersistPropertyBagImpl<

派生。

在ATL中，系统帮我们已经完成了很多接口的默认实现，我们只要从IxxxImpl<

派生，然后再添加一些必要的映射和变量，就可以了。

这样显然要比自己去实现接口的所有函数要简单许多了。

其实，如果你明白了本回IPersistPropertyBagImpl<

派生的方法后，你完全可以修改前回书中的实现方法，从IPersistStreamInit派生改进为从IPersistStreamInitImpl<

classATL_NO_VTABLECxxx:

publicCComObjectRootEx<

...>

publicCComCoClass<

publicIDispatchImpl<

publicIPersistPropertyBagImpl<

Cxxx>

//手工添加派生类

.........

BEGIN_COM_MAP（Cxxx）

.........

COM_INTERFACE_ENTRY（IPersistPropertyBag）//手工添加接口表

END_COM_MAP（）

//手工添加属性映射表，这是IPersistXXXImpl所必须的。

//将来你在写ActiveX的时候，ATL向导会帮我们添加属性映射表

BEGIN_PROP_MAP（Cxxx）

//参数：

"

属性名称"

接口属性序号（见IDL文件）,属性页对话窗

PROP_ENTRY（"

str"

1,CLSID_NULL）

integer"

2,CLSID_NULL）

END_PROP_MAP（）

public:

//这个成员变量，是IPersistXXXImpl所必须的

boolm_bRequiresSave;

//表示属性数据是否已经改变而需要保存

};

　　我们只要手工添加以上内容，而不用自己写任何IPersistPropertyBag接口的函数，多简单呀！

天空出彩霞呀，地上开红花呀......会唱这只歌的同学请举手，每个人奖励vckbase的专家分500！

三、调用者的实现

　　我们在阅读MSDN关于IPersistPropertyBag接口函数的时候，你会发现还需要一个接口IPropertyBag与之配合才能实现属性包功能。

而IPropertyBag则需要我们在调用者（容器）中来实现该接口。

它们之间的关系如下：

　前面几回书中，我们已经学会了从IUnknown派生类，也学会了从IDispatch派生类，也学会了从ICallBack派生类......同样，这回我们要从IPropertyBag派生了。

在示例程序中，我们添加了一个类CPropertyBag:

publicIPropertyBag，同时重载了所有的虚函数。

STDMETHODIMPCPropertyBag:

QueryInterface（conststruct_GUID&

iid,void**ppv）

*ppv=this;

ULONG__stdcallCPropertyBag:

AddRef（void）

{return1;

}//做个假的就可以，因为反正这个对象在程序结束前是不会退出的

Release（void）

{return0;

Read（LPCOLESTRpszPropName,VARIANT*pVar,IErrorLog*pErrorLog）

//根据pszPropName指定的属性名称，你要提供该属性的值。

//而值的数据类型已经在pVal->

vt中指定了。

if（如果能提供指定的数据）returnS_OK;

elsereturnE_FAIL;

Write（LPCOLESTRpszPropName,VARIANT*pVar）

//根据psaPropName指定的属性名称和pVar提供的值

//你保存到文本中去吧。

　　以上是调用者（容器）程序的关键部分，其它的管理和协调部分，读者去阅读示例程序代码。

编译注册组件，并运行调用者示例程序，显示如下：

　　在编辑窗口中你可以随便指定str和interger的值，然后“启动组件”，那么你设定的属性值就会在启动组件的同时，通过IPersistPropertyBag接口设置到组件中（还原了持续性的环境）。

而后，你就可以在下面的Property分组操作中，“设置/读取”组件的属性了。

当“关闭组件”的时候，程序通过调用IPersistPropertyBag接口函数，又重新取得组件的属性名称和值保存到编辑窗的文本中了。

四、小结

　　理解了本回属性包接口的功能，你就能体会出IE是如何装载ActiveX（注2）控件并设置控件的状态了。

注1：

在中，由于系统已经有CProperty类，所以这里我们改换名称为CMyProperty。

注2：

通过十八回的学习，我们已经了解组件的一些常用接口，为我们学习ActiveX的组件编程打下了基础。

下回书，我们就开始学习ActiveX。