ATL属性包(PropertyBag)

ATL下如何添加属性包

 

属性包: ActiveX增加对插件属性的支持后, 使其能在网页中通过OBJECT属性, 在控件初始化前将参数传入.

 

A. 在类中加入继承 public IPersistPropertyBagImpl<CXXX>, 并添加响应的接口映射, 如下;

 

BEGIN_COM_MAP(CXXX) ... COM_INTERFACE_ENTRY(IPersistPropertyBag) ... END_COM_MAP()

B. 为Composite控件接口添加属性. 在WorkSpace中, 右击接口名, 选择"Add property"后, 在property中分别添入参数类型(BSTR)和属性名(Name)即可.

BEGIN_PROP_MAP(CXXX) PROP_DATA_ENTRY("_cx", m_sizeExtent.cx, VT_UI4) PROP_DATA_ENTRY("_cy", m_sizeExtent.cy, VT_UI4) // Example entries // PROP_ENTRY("Property Description", dispid, clsid) // PROP_PAGE(CLSID_StockColorPage) // 6 -> dispid,dispid为接口属性的id PROP_ENTRY("Name", 6, CLSID_NULL) END_PROP_MAP()

*你可以通过双击接口,在接口定义中看到dispid.如下:id(6)

... [propget, id(6), helpstring("property Name")] HRESULT Name([out, retval] BSTR *pVal); [propput, id(6), helpstring("property Name")] HRESULT Name([in] BSTR newVal); ...

C.  定义一个成员变量,用来存放传入的参数.CComBSTR m_bstrValue;在你定义的属性中,(加入如下黑体的行)用以保存传进来的参数值.

STDMETHODIMP CVMShow::get_Name(BSTR *pVal) { *pVal = m_bstrValue.Copy(); return S_OK; } STDMETHODIMP CVMShow::put_Name(BSTR newVal) { m_bstrValue= newVal; return S_OK; }

D. 网页的交互为,如果控件有窗口的话.(这些交互在ActiveX对话框的初始化前就进行了)
<object id='AtlComId' classid='XXXXXX'> <param name='Name' value='hqulyc'> </object>

 

注: 对于Simple Object的ATL在加入属性包接口和接口映射后,需要定义一个共有的成员变量:bool m_bRequiresSave; m_bRequiresSave=false;