通用型XPCOM模块宏
宏 |
作用 |
NS_IMPL_NSGETMODULE(name, components) |
实现IModule接口 |
NS_IMPL_NSGETMODULE_WITH_CTOR(name, components, ctor) |
同上,但允许指定模块创建时调用一个特定函数 |
NS_IMPL_NSGETMODULE_WITH_DTOR
(name, components, dtor) |
同第一个,但允许指定模块销毁时调用一个特定函数 |
NS_IMPL_NSGETMODULE_WITH_CTOR_DTOR
(name, components, ctor, dtor) |
结合2,3 |
模块实现宏:
nsModuleComponentInfo结构体包含4个域:1)给人读的类名称 2)类ID(CID) 3)契约ID 4)用于给定对象的构造者
static const nsModuleComponentInfo components[] =
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
![](/Images/OutliningIndicators/ExpandedSubBlockStart.gif)
![](/Images/OutliningIndicators/ContractedSubBlock.gif)
{ "Pretty Class Name",
CID,
CONTRACT_ID,
Constructor
},
![](/Images/OutliningIndicators/InBlock.gif)
.
}
![](/Images/OutliningIndicators/None.gif)
工厂宏:
NS_GENERIC_FACTORY_CONSTRUCTOR(ConcreteClass)
常用实现宏
NS_IMPL_ISUPPORTS1(classname, interface1)
NS_IMPL_ISUPPORTSn(classname, interface1, …, interfacen)
![](/Images/OutliningIndicators/None.gif)
声明宏:
class myEnumerator : public nsISimpleEnumerator
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
public:
NS_DECL_ISUPPORTS
NS_DECL_NSISIMPLEENUMERATOR
myEnumerator();
![](/Images/OutliningIndicators/ExpandedSubBlockStart.gif)
virtual ~myEnumerator()
{}
};
![](/Images/OutliningIndicators/None.gif)
NS_IMPL_ISUPPORTSn |
为指定类实现nsISupports,此类有n个接口 |
NS_DECL_ISUPPORTS |
声明ISuppotrs接口的方法,包含mRefCnt |
NS_INIT_ISUPPORTS |
初始化mRefCnt为0 |
NS_GET_IID |
返回给定接口名称的IID |
智能指针
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
nsCOMPtr<nsISupports> value;
object->method(getter_AddRefs(value));
if (!value) return;
![](/Images/OutliningIndicators/InBlock.gif)
![](/Images/dot.gif)
if (NS_FAILED(error))
return;
![](/Images/OutliningIndicators/InBlock.gif)
![](/Images/dot.gif)
}
![](/Images/OutliningIndicators/None.gif)
SomeClass::Get(nsISupports** aResult)
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
if (! aResult)
return NS_ERROR_NULL_POINTER;
nsCOMPtr<nsISupports> value;
object->method(getter_AddRefs(value));
*aResult = value.get();
NS_IF_ADDREF(*aResult);
return NS_OK;
}
![](/Images/OutliningIndicators/None.gif)
示例:
#include "nsIGenericFactory.h"
#define SAMPLE_CID \
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{ 0x777f7150, 0x4a2b, 0x4301, \
![](/Images/OutliningIndicators/ExpandedSubBlockStart.gif)
![](/Images/OutliningIndicators/ContractedSubBlock.gif)
{ 0xad, 0x10, 0x5e, 0xab, 0x25, 0xb3, 0x22, 0xaa}}
class Sample: public nsISupports
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
public:
Sample();
virtual ~Sample();
NS_DECL_ISUPPORTS
};
Sample::Sample()
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
// note: in newer versions of Gecko (1.3 or later)
// you don’t have to do this:
NS_INIT_ISUPPORTS();
}
Sample::~Sample()
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
}
NS_IMPL_ISUPPORTS(Sample, nsISupports);
NS_GENERIC_FACTORY_CONSTRUCTOR(Sample);
![](/Images/OutliningIndicators/None.gif)
static const nsModuleComponentInfo components[] =
![](/Images/OutliningIndicators/ExpandedBlockStart.gif)
![](/Images/OutliningIndicators/ContractedBlock.gif)
{
![](/Images/OutliningIndicators/ExpandedSubBlockStart.gif)
![](/Images/OutliningIndicators/ContractedSubBlock.gif)
{ "Pretty Class Name",
SAMPLE_CID,
"@company.com/sample"
SampleConstructor
}
};
NS_IMPL_NSGETMODULE(nsSampleModule, components)
![](/Images/OutliningIndicators/None.gif)