在VB的属性视图中,还有一个有意思的功能是将属性列在不同的类别,如,外观,行为,数据等等。这种功能是怎么来的,我自己的控件中的自定义的属性是不是也能列在这些类别中,我能不能创建自己的类别呢。
很简单,在你的控件中实现一个接口ICategorizeProperties就可以了,这个接口只有两个方法
HRESULT MapPropertyToCategory(DISPID dispid,PROPCAT* ppropcat);
HRESULT GetCategoryName(PROPCAT propcat,LCID lcid,BSTR* pbstrName);
PROPCAT实际上就是一int,表示某种类别编号
MapPropertyToCategory就是用来设置相应dispid的属性的类别的
GetCategoryName应是用来设置你自定义的类别(编号为propcat)的显示字符串的
看起来似乎挺简单的,可惜的是,这个接口没有定义,COleControl也没有帮我们做任何的工作。幸好,对于添加接口,我们已经有了经验了,前面的文章有过许多例子了。
我们有上一文中的例子tppb
1.在.odl上添加新接口定义
// ICategorizeProperties接口定义
[ uuid(4D07FC10-F931-11CE-B001-00AA006884E5),
helpstring("ICategorizeProperties Interface"),pointer_default (unique) ]
interface ICategorizeProperties : IUnknown
{
typedef [public] int PROPCAT;
const int PROPCAT_Nil = -1;
const int PROPCAT_Misc = -2;
const int PROPCAT_Font = -3;
const int PROPCAT_Position = -4;
const int PROPCAT_Appearance = -5;
const int PROPCAT_Behavior = -6;
const int PROPCAT_Data = -7;
const int PROPCAT_List = -8;
const int PROPCAT_Text = -9;
const int PROPCAT_Scale = -10;
const int PROPCAT_DDE = -11;
HRESULT MapPropertyToCategory(DISPID dispid,BSTR* pbstrName);
};
2.添加嵌套类,作为ICategorizeProperties接口的实现类
a.在tppbctl.h中添加声明
......
DECLARE_EVENT_MAP()
public:
BEGIN_INTERFACE_PART(CategorizeProperties,ICategorizeProperties)
STDMETHOD(MapPropertyToCategory)(DISPID dispid,PROPCAT* ppropcat);
STDMETHOD(GetCategoryName)(PROPCAT propcat,BSTR* pbstrName);
END_INTERFACE_PART(CategorizeProperties)
DECLARE_INTERFACE_MAP()
// Dispatch and event IDs
public:
enum {
//{{AFX_DISP_ID(CTppbCtrl)
dispidWeek = 1L,
dispidParam = 2L,
//}}AFX_DISP_ID
};
......
b.在tppbctl.cpp中添加实现代码
STDMETHODIMP_(ULONG) CTppbCtrl::XCategorizeProperties::AddRef()
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
return (ULONG)pThis->ExternalAddRef();
}
STDMETHODIMP_(ULONG) CTppbCtrl::XCategorizeProperties::Release()
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
return (ULONG)pThis->ExternalRelease();
}
STDMETHODIMP CTppbCtrl::XCategorizeProperties::QueryInterface(REFIID iid,LPVOID* ppvObj)
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
return (HRESULT)pThis->ExternalQueryInterface(&iid,ppvObj);
}
STDMETHODIMP CTppbCtrl::XCategorizeProperties::MapPropertyToCategory(DISPID dispid,PROPCAT* ppropcat)
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
if(dispid == dispidWeek){
*ppropcat = PROPCAT_Data;
return S_OK;
}
else if(dispid == dispidParam){
*ppropcat = 1;
return S_OK;
}
return E_FAIL;
}
STDMETHODIMP CTppbCtrl::XCategorizeProperties::GetCategoryName(PROPCAT propcat,BSTR* pbstrName)
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
if(propcat == 1){
*pbstrName = ::SysAllocString(L"参数");
return S_OK;
}
return E_FAIL;
}
注:这里将Week属性列入了数据类别(PROPCAT_Data)中,将Param属性列入自定义的类别"参数"中,类别编号为1,对于自定义的类别编号,必须大于0
3.将ICategorizeProperties接口添加到控件的接口映射表中
a.在tppbctl.h中添加接口映射声明
public:
BEGIN_INTERFACE_PART(CategorizeProperties,ICategorizeProperties)
STDMETHOD(MapPropertyToCategory)(DISPID dispid,PROPCAT* ppropcat);
STDMETHOD(GetCategoryName)(PROPCAT propcat,BSTR* pbstrName);
END_INTERFACE_PART(CategorizeProperties)
DECLARE_INTERFACE_MAP()
b.在tppbctl.cpp中添加ICategorizeProperties到映射表中
BEGIN_INTERFACE_MAP(CTppbCtrl,COleControl)
INTERFACE_PART(CTppbCtrl,IID_IDispatch,Dispatch)
INTERFACE_PART(CTppbCtrl,DIID__DTppb,IID_ICategorizeProperties,CategorizeProperties)
END_INTERFACE_MAP()
4.现在编译的话,会发现少了很多的定义,需要从.odl中生成相应的接口定义文件,在文件列表中找到tppb.odl,点右键,选择Settings,在Output header file name中输入tppbuuid.h(不存在的任何文件名都可),确定后,再点右键,选择Compile tppb.odl,即生成tppbuuid.h文件了。
5.在tppbctl.h文件中#include "tppbuuid.h"
6.新建一initIIDs.cpp文件,输入代码如下:
#include <ole2.h>
#include <initguid.h>
#include "tppbuuid.h"
在文件列表中,找到initIIDs.cpp,点右键,在C/C++项中,选择Category为Precompiled Headers,并设置为Not using precompiled headers
7.编译,如果链接出现DllMain之类的错误,请移除initIIDs.cpp,然后再加入,并重新设置Precompiled Headers,再编译即可。
8.好了,在VB下测试就可以了
很简单,在你的控件中实现一个接口ICategorizeProperties就可以了,这个接口只有两个方法
HRESULT MapPropertyToCategory(DISPID dispid,PROPCAT* ppropcat);
HRESULT GetCategoryName(PROPCAT propcat,LCID lcid,BSTR* pbstrName);
PROPCAT实际上就是一int,表示某种类别编号
MapPropertyToCategory就是用来设置相应dispid的属性的类别的
GetCategoryName应是用来设置你自定义的类别(编号为propcat)的显示字符串的
看起来似乎挺简单的,可惜的是,这个接口没有定义,COleControl也没有帮我们做任何的工作。幸好,对于添加接口,我们已经有了经验了,前面的文章有过许多例子了。
我们有上一文中的例子tppb
1.在.odl上添加新接口定义
// ICategorizeProperties接口定义
[ uuid(4D07FC10-F931-11CE-B001-00AA006884E5),
helpstring("ICategorizeProperties Interface"),pointer_default (unique) ]
interface ICategorizeProperties : IUnknown
{
typedef [public] int PROPCAT;
const int PROPCAT_Nil = -1;
const int PROPCAT_Misc = -2;
const int PROPCAT_Font = -3;
const int PROPCAT_Position = -4;
const int PROPCAT_Appearance = -5;
const int PROPCAT_Behavior = -6;
const int PROPCAT_Data = -7;
const int PROPCAT_List = -8;
const int PROPCAT_Text = -9;
const int PROPCAT_Scale = -10;
const int PROPCAT_DDE = -11;
HRESULT MapPropertyToCategory(DISPID dispid,BSTR* pbstrName);
};
2.添加嵌套类,作为ICategorizeProperties接口的实现类
a.在tppbctl.h中添加声明
......
DECLARE_EVENT_MAP()
public:
BEGIN_INTERFACE_PART(CategorizeProperties,ICategorizeProperties)
STDMETHOD(MapPropertyToCategory)(DISPID dispid,PROPCAT* ppropcat);
STDMETHOD(GetCategoryName)(PROPCAT propcat,BSTR* pbstrName);
END_INTERFACE_PART(CategorizeProperties)
DECLARE_INTERFACE_MAP()
// Dispatch and event IDs
public:
enum {
//{{AFX_DISP_ID(CTppbCtrl)
dispidWeek = 1L,
dispidParam = 2L,
//}}AFX_DISP_ID
};
......
b.在tppbctl.cpp中添加实现代码
STDMETHODIMP_(ULONG) CTppbCtrl::XCategorizeProperties::AddRef()
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
return (ULONG)pThis->ExternalAddRef();
}
STDMETHODIMP_(ULONG) CTppbCtrl::XCategorizeProperties::Release()
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
return (ULONG)pThis->ExternalRelease();
}
STDMETHODIMP CTppbCtrl::XCategorizeProperties::QueryInterface(REFIID iid,LPVOID* ppvObj)
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
return (HRESULT)pThis->ExternalQueryInterface(&iid,ppvObj);
}
STDMETHODIMP CTppbCtrl::XCategorizeProperties::MapPropertyToCategory(DISPID dispid,PROPCAT* ppropcat)
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
if(dispid == dispidWeek){
*ppropcat = PROPCAT_Data;
return S_OK;
}
else if(dispid == dispidParam){
*ppropcat = 1;
return S_OK;
}
return E_FAIL;
}
STDMETHODIMP CTppbCtrl::XCategorizeProperties::GetCategoryName(PROPCAT propcat,BSTR* pbstrName)
{
METHOD_PROLOGUE_EX_(CTppbCtrl,CategorizeProperties)
if(propcat == 1){
*pbstrName = ::SysAllocString(L"参数");
return S_OK;
}
return E_FAIL;
}
注:这里将Week属性列入了数据类别(PROPCAT_Data)中,将Param属性列入自定义的类别"参数"中,类别编号为1,对于自定义的类别编号,必须大于0
3.将ICategorizeProperties接口添加到控件的接口映射表中
a.在tppbctl.h中添加接口映射声明
public:
BEGIN_INTERFACE_PART(CategorizeProperties,ICategorizeProperties)
STDMETHOD(MapPropertyToCategory)(DISPID dispid,PROPCAT* ppropcat);
STDMETHOD(GetCategoryName)(PROPCAT propcat,BSTR* pbstrName);
END_INTERFACE_PART(CategorizeProperties)
DECLARE_INTERFACE_MAP()
b.在tppbctl.cpp中添加ICategorizeProperties到映射表中
BEGIN_INTERFACE_MAP(CTppbCtrl,COleControl)
INTERFACE_PART(CTppbCtrl,IID_IDispatch,Dispatch)
INTERFACE_PART(CTppbCtrl,DIID__DTppb,IID_ICategorizeProperties,CategorizeProperties)
END_INTERFACE_MAP()
4.现在编译的话,会发现少了很多的定义,需要从.odl中生成相应的接口定义文件,在文件列表中找到tppb.odl,点右键,选择Settings,在Output header file name中输入tppbuuid.h(不存在的任何文件名都可),确定后,再点右键,选择Compile tppb.odl,即生成tppbuuid.h文件了。
5.在tppbctl.h文件中#include "tppbuuid.h"
6.新建一initIIDs.cpp文件,输入代码如下:
#include <ole2.h>
#include <initguid.h>
#include "tppbuuid.h"
在文件列表中,找到initIIDs.cpp,点右键,在C/C++项中,选择Category为Precompiled Headers,并设置为Not using precompiled headers
7.编译,如果链接出现DllMain之类的错误,请移除initIIDs.cpp,然后再加入,并重新设置Precompiled Headers,再编译即可。
8.好了,在VB下测试就可以了